オブジェクトストレージ API リファレンス List Multipart Uploads
オブジェクトストレージ API リファレンス List Multipart Uploads
フィールド 説明 サンプル値
NextKeyMarker 次リクエスト検索キー
（max-key件数で返しきれなかった場合に、次リクエストの
markerに指定すべきオブジェクト検索キー）
delimiter指定必須 Type : xsdstring
Ancestor : ListMultipartUploadsResult NextUploadIdMarker 次リクエスト検索アップロードID
（max-key件数で返しきれなかった場合に、次リクエストの upload-id-markerに指定すべきアップロードID）
Type : xsdstring
Ancestor : ListMultipartUploadsResult
MaxUploads 指定した最大一覧表示数
type : xsdstring Default : 1000
Ancestor : ListMultipartUploadsResult
isTruncated 全結果取得フラグ
リクエスト件数がすべて返却できたかどうか Type : xsd:boolean
Ancestor : ListMultipartUploadsResult
Upload Upload レスポンス
Type : Container
Ancestor : ListMultipartUploadsResult
Children : Key, UploadId, InitiatorOwner, StorageClass, Initiated
Key オブジェクトのキー
Type : Integer Ancestor : Upload
UploadId アップロードID
Type : Integer Ancestor : Upload
Initiator Initiatorレスポンス
Type : Container Ancestor : Upload
Children : ID,DsiplayName
Owner Ownerレスポンス
Type : Container Ancestor : Upload
Children : ID,DisplayName
ID オーナーID
Type : xsd:string
Ancestor : Initiator | Owner
DisplayName オーナー名
Type : xsd:string
Ancestor : Initiator | Owner
StorageClass ストレージ分類
（STANDARD固定）
Type : xsd:string Ancestor : ListPartsResult
Initiated マルチパートアップロードが Initiate された日時
Type : Data Ancestor : Upload
オブジェクトストレージ API リファレンス List Multipart Uploads
フィールド 説明 サンプル値
ListMultipartUploadsResult.Prefix 指定された prefix Type : xsd:string
Ancestor : ListMultipartUploadsResult
Delimiter 指定された delimiter
Type : xsd:string
Ancestor : ListMultipartUploadsResult
CommonPrefixes 子要素 Prefix に、デリミタで区切られた Prefix パラメーターに 指定可能な文字列を返す
Type : Container Ancestor : Upload
CommonPrefixes.Prefix Prefix パラメーターに指定可能な文字列 Type : xsd:string
Ancestor : CommonPrefixes
■ リクエストサンプル
GET /?uploads&max-uploads=3 HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4: PN7jNipuKQDJG6wKsR+DWJLAH0g=
■ 応答サンプル
HTTP/1.1 204 OK
x-amz-request-id: 438ac7ef-fb1e-37b8-b802-083cb0df67e9 Date: Wed, 29 Jun 2016 12:00:00 GMT
Content-Length: 1330 Connection: keep-alive
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>my-first-bucket</Bucket>
<KeyMarker></KeyMarker>
<UploadIdMarker></UploadIdMarker>
<NextKeyMarker>my-movie.m2ts</NextKeyMarker>
<NextUploadIdMarker>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</NextUploadIdMarker>
<MaxUploads>3</MaxUploads>
<IsTruncated>true</IsTruncated>
<Upload>
<Key>my-divisor</Key>
<UploadId>XMgbGlrZSBlbHZpbmcncyBub3QgaGF2aW5nIG11Y2ggbHVjaw</UploadId>
<Initiator>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>ABC12345</DisplayName>
</Initiator>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:48:33.000Z</Initiated>
</Upload>
<Upload>
<Key>my-movie.m2ts</Key>
<UploadId>VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
オブジェクトストレージ API リファレンス List Multipart Uploads
<Initiator>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>ABC12345</DisplayName>
</Initiator>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:48:33.000Z</Initiated>
</Upload>
<Upload>
<Key>my-movie.m2ts</Key>
<UploadId>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</UploadId>
<Initiator>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>ABC12345</DisplayName>
</Initiator>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:49:33.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>
オブジェクトストレージ API リファレンス 制限事項
付 録
制限事項
■ バケット格納オブジェクト数
各バケットに格納可能なオブジェクト数は下記の通りです。
20,000,000 オブジェクト / バケット
■ バケット名命名規則
バケット名は以下の規則に準拠する必要があります。
文字数は3文字から63文字以内
利用文字は 小文字英数字、ピリオド（.）、ハイフン(-)
始まりの文字が英数字
末尾の文字がハイフン(-)でない
ピリオド(.)が連続しない
ピリオド(.)とハイフン(-)が連続しない
IPアドレス形式でない
■ オブジェクト名命名規則
オブジェクト名は以下の規則に準拠する必要があります。
オブジェクト名をURLエンコードし、リクエストする必要があります。
■ リクエスト数推奨値
APIのリクエスト頻度の推奨値は下記の通りです。
50 リクエスト / 秒
推奨値を超えた場合、エラー応答（503 Slow Down）を返す場合があります。
オブジェクトストレージ API リファレンス ACL
ACL
■ 権限
バケット・オブジェクト操作について、以下の権限を設定することが可能です。
項目名 説明
FULL_CONTROL すべて
WRITE 書き込み、削除
READ 読み込み
WRITE_ACP 権限書き込み
READ_ACP 権限読み込み
■ 対象ユーザー
各権限は、以下のユーザー（グループ）を対象に設定することが可能です。
ユーザー名 説明
特定ユーザー オブジェクトストレージを利用している特定ユーザー
（認証ヘッダーからリクエストの正当性が確認された特定ユーザー）
認証ユーザー オブジェクトストレージを利用している全ユーザー（グループ）
（認証ヘッダーからリクエストの正当性が確認されたユーザー）
未認証ユーザー 認証ヘッダーの未指定などで、リクエストの正当性が確認できないユーザー（グループ）
■ Canned ACL
バケット・オブジェクトについて、以下のようなアクセス権限の設定が可能です。
Canned ACL 説明
private オーナーに対し、FULL_CONTROLを設定
public-read オーナーに対し、FULL_CONTROLを設定
すべてのユーザーに対し、READを設定
authenticated-read オーナーに対し、FULL_CONTROLを設定
認証ユーザーに対し、READを設定
オブジェクトストレージ API リファレンス 共通エラーレスポンスステータス