リポジトリメータリングアーカイブのクリア

クラスター内に存在するアーカイブされたリポジトリメータリング情報を削除します。

リクエスト

DELETE /_nodes/<node_id>/_repositories_metering/<max_version_to_clear>

前提条件

  • Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するには、monitorまたはmanage クラスター権限が必要です。

説明

このAPIを使用して、クラスター内のアーカイブされたリポジトリメータリング情報をクリアできます。

パスパラメータ

  • <node_id>
  • （オプション、文字列）返される情報を制限するために使用されるノードIDまたは名前のカンマ区切りリスト。
  • <max_version_to_clear>
  • （long）アーカイブからクリアされる最大archive_versionを指定します。

すべてのノード選択オプションはこちらで説明されています。

レスポンスボディ

削除されたアーカイブされたリポジトリメータリング情報を返します。

  • _nodes
  • （オブジェクト）リクエストによって選択されたノードの数に関する統計を含みます。 
    1. -   `````total
    • （整数）リクエストによって選択されたノードの合計数。
    • successful
    • （整数）リクエストに成功して応答したノードの数。
    • failed
    • （整数）リクエストを拒否したか、応答しなかったノードの数。この値が0でない場合、拒否または失敗の理由がレスポンスに含まれます。
  • cluster_name
  • （文字列）クラスターの名前。クラスター名設定に基づいています。
  • nodes
  • （オブジェクト）リクエストによって選択されたノードのリポジトリメータリング情報を含みます。 
    1. -   `````<node_id>
    • （配列）ノードのリポジトリメータリング情報の配列。 
      1. -   `````repository_name
      • （文字列）リポジトリ名。
      • repository_type
      • （文字列）リポジトリタイプ。
      • repository_location
      • （オブジェクト）リポジトリ内の一意の場所を表します。
        repository_locationのリポジトリタイプAzureのプロパティ
      • base_path
      • （文字列）リポジトリがデータを保存するコンテナ内のパス。
      • container
      • （文字列）コンテナ名。
        repository_locationのリポジトリタイプGCPのプロパティ
      • base_path
      • （文字列）リポジトリがデータを保存するバケット内のパス。
      • bucket
      • （文字列）バケット名。
        repository_locationのリポジトリタイプS3のプロパティ
      • base_path
      • （文字列）リポジトリがデータを保存するバケット内のパス。
      • bucket
      • （文字列）バケット名。
      • repository_ephemeral_id
      • （文字列）リポジトリが更新されるたびに変わる識別子。
      • repository_started_at
      • （long）リポジトリが作成または更新された時間。 Unix Epochからのミリ秒で記録されます。
      • repository_stopped_at
      • （オプション、long）リポジトリが削除または更新された時間。 Unix Epochからのミリ秒で記録されます。
      • archived
      • （Boolean）このオブジェクトがアーカイブされているかどうかを示すフラグ。リポジトリが閉じられたり更新されたりすると、リポジトリメータリング情報はアーカイブされ、一定期間保持されます。これにより、以前のリポジトリインスタンスのリポジトリメータリング情報を取得できます。
      • cluster_version
      • （オプション、long）このオブジェクトがアーカイブされたときのクラスター状態バージョン。このフィールドは、観測されたバージョンまでのすべてのアーカイブされたメトリクスを削除するための論理タイムスタンプとして使用できます。このフィールドは、アーカイブされたリポジトリメータリング情報オブジェクトにのみ存在します。このフィールドの主な目的は、リポジトリメータリング情報の削除中に発生する可能性のある競合状態を回避することです。つまり、まだ観測していないアーカイブされたリポジトリメータリング情報を削除することです。
      • request_counts
      • （オブジェクト）リポジトリに対して行われたリクエストの数をリクエストタイプ別にグループ化したオブジェクト。
        request_countsのリポジトリタイプAzureのプロパティ
      • GetBlobProperties
      • （long）Get Blob Propertiesリクエストの数。
      • GetBlob
      • （long）Get Blobリクエストの数。
      • ListBlobs
      • （long）List Blobsリクエストの数。
      • PutBlob
      • （long）Put Blobリクエストの数。
      • PutBlock
      • （long）Put Blockの数。
      • PutBlockList
      • （long）Put Block Listリクエストの数。
        Azureストレージの料金。
        request_countsのリポジトリタイプGCPのプロパティ
      • GetObject
      • （long）get objectリクエストの数。
      • ListObjects
      • （long）list objectsリクエストの数。
      • InsertObject
      • （long）insert objectリクエストの数、simple、multipart、およびresumableアップロードを含みます。再開可能なアップロードは、単一のオブジェクトを挿入するために複数のHTTPリクエストを実行できますが、請求は個別の操作として行われるため、単一のリクエストと見なされます。
        Google Cloudストレージの料金。
        request_countsのリポジトリタイプS3のプロパティ
      • GetObject
      • （long）GetObjectリクエストの数。
      • ListObjects
      • （long）ListObjectsリクエストの数。
      • PutObject
      • （long）PutObjectリクエストの数。
      • PutMultipartObject
      • （long）Multipartリクエストの数、CreateMultipartUpload、UploadPart、およびCompleteMultipartUploadリクエストを含みます。
        Amazon Web Services Simple Storage Serviceの料金。