マルチパートアップロードのリスト (GET multipart-uploads) - Amazon Glacier
説明リクエストレスポンス例関連するセクション

このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。

アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「Amazon Glacier ストレージクラス」を参照してください。

Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は Amazon S3 Glacier ストレージクラス AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンスを使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

マルチパートアップロードのリスト (GET multipart-uploads)

説明

このマルチパートアップロードオペレーションでは、指定されたボールトの進行中のマルチパートアップロードのリストを表示します。進行中のマルチパートアップロードとは、マルチパートアップロードの開始 (POST multipart-uploads) リクエストによって開始されているものの、まだ完了または中止されていないマルチパートアップロードです。マルチパートアップロードのリストのレスポンスで返されるリストの順序は保証されていません。

マルチパートアップロードのリストオペレーションでは、ページ分割をサポートしています。このオペレーションによってレスポンスに返されるマルチパートアップロードは、デフォルトで最大 50 個です。レスポンス本文の marker フィールドに、リストの続きを表示するためのマーカーが含まれているかどうかを常に確認する必要があります。項目がそれ以上存在しない場合、 marker フィールドは null です。

marker が null でない場合に、マルチパートアップロードの次のセットを取得するには、前のマルチパートアップロードのリストのリクエストの結果として Amazon Glacier が返したマーカー値を marker リクエストパラメータに設定して、別のマルチパートアップロードのリストのリクエストを送信します。

このオペレーションと パートのリスト (GET uploadID) オペレーションの違いに注意してください。マルチパートアップロードのリストオペレーションでは、ボールトのすべてのマルチパートアップロードのリストを表示します。パートのリストオペレーションでは、アップロード ID によって識別される特定のマルチパートアップロードのパートが返されます。

マルチパートアップロードの詳細については、「パート単位での大きなアーカイブのアップロード (マルチパートアップロード)」を参照してください。

リクエスト

構文

マルチパートアップロードのリストを表示するには、ボールトの GET サブリソースの URI に multipart-uploads リクエストを送信します。オプションで marker パラメータと limit パラメータを指定できます。

GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

注記

-AccountIdvalueAWS アカウントボールトを所有するアカウントの ID。AWS アカウント ID、または Amazon Glacier がリクエストの署名に使用した認証情報に関連する AWS アカウント ID を使用している場合はオプションで '-' (ハイフン) のどちらかを指定できます。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。

リクエストパラメータ

名前 説明 必須
limit

レスポンス本文に返されるアップロードの最大数を指定します。指定しない場合、アップロードのリストオペレーションでは、最大で 50 個のアップロードが返されます。

タイプ: 文字列

制約: 最小の整数値は 1 です。最大の整数値は 50 です。

 なし
marker

ページ分割に使用する不透明な文字列。marker には、アップロードのリストを開始するアップロードを指定します。marker 値は、前回のアップロードのリストのレスポンスから取得します。前回のアップロードのリストのリクエストで開始された結果のページ分割を継続する場合のみ、marker を指定する必要があります。

タイプ: 文字列

制約: なし

 なし

リクエストヘッダー

この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」を参照してください。

リクエスト本文

この操作にリクエストボディはありません。

レスポンス

構文

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "Marker": String,
  "UploadsList" : [ 
    {
      "ArchiveDescription": String,
      "CreationDate": String,
      "MultipartUploadId": String,
      "PartSizeInBytes": Number,
      "VaultARN": String
    }, 
   ...
  ]
}

レスポンスヘッダー

この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」を参照してください。

レスポンス本文

レスポンス本文には次の JSON フィールドが含まれています。

ArchiveDescription

マルチパートアップロードの開始リクエストに指定されたアーカイブの説明。マルチパートアップロードの開始オペレーションでアーカイブの説明が指定されていなければ、このフィールドは null です。

タイプ: 文字列

CreationDate

マルチパートアップロードが開始された UTC 時間。

型: 文字列 たとえば、ISO 8601 の日付形式の文字列表現。2013-03-20T17:03:43.221Z。

Marker

結果のページ分割をどこから継続するかを表す不透明な文字列。リストに含まれるアップロードをさらに取得するには、マルチパートアップロードのリストの新規リクエストで marker を使用します。アップロードがそれ以上存在しない場合、この値は null です。

タイプ: 文字列

PartSizeInBytes

マルチパートアップロードの開始 (POST multipart-uploads) リクエストで指定されたパートサイズ。これは、アップロードのすべてのパートのサイズです。ただし、最後のパートは、このサイズより小さくなる場合があります。

タイプ: 数値

MultipartUploadId

マルチパートアップロードの ID。

タイプ: 文字列

UploadsList

マルチパートアップロードのオブジェクトに関するメタデータのリスト。ArchiveDescription、CreationDate、MultipartUploadId、PartSizeInBytes、VaultARN など、対応するアップロードの名前と値のペアのセットを含むリスト内の各項目。

型: 配列

VaultARN

アーカイブを含むボールトの Amazon リソースネーム（ARN）。

タイプ: 文字列

エラー

Amazon Glacier の例外とエラーメッセージについては、「エラーレスポンス」を参照してください。

例

例: すべてのマルチパートアップロードのリスト

次の例では、ボールトの進行中のすべてのマルチパートアップロードのリストを表示します。この例では、指定されたボールトの GET サブリソースの URI に対する HTTP multipart-uploads リクエストを示しています。リクエストでは、marker および limit パラメータが指定されていないため、最大 1,000 個の進行中のマルチパートアップロードが返されます。

リクエストの例

GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

レスポンスの例

レスポンスとして、Amazon Glacier により、指定されたボールトの進行中のすべてのマルチパートアップロードのリストが返されます。marker フィールドは null です。これは、これ以上表示するアップロードがないことを示しています。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 1054
      
{
  "Marker": null, 
  "UploadsList": [ 
    {
      "ArchiveDescription": "archive 1",
      "CreationDate": "2012-03-19T23:20:59.130Z",
      "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }, 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    },
    {
      "ArchiveDescription": "archive 3",
      "CreationDate": "2012-03-20T17:03:43.221Z",
      "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    } 
  ]
}

例: マルチパートアップロードの部分的なリスト

以下の例は、ページ分割を使用して結果の取得数を制限する方法を示しています。この例では、指定されたボールトの GET サブリソースの URI に対する HTTP multipart-uploads リクエストを示しています。この例では、limit パラメータが 1 に設定されています。そのため、リストに返されるアップロードは 1 つのみで、marker パラメータには返されたリストが開始するマルチパートアップロード ID が示されます。

リクエストの例

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

レスポンスの例

レスポンスとして、Amazon Glacier により、指定されたボールトの進行中のマルチパートアップロードのリストが 2 つまで返されます。指定されたマーカーから開始し、2 つの結果が返されます。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 470

{
  "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
  "UploadsList" : [ 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }
  ]
}