Upload
others
View
2
Download
0
Embed Size (px)
Citation preview
ニフクラ オブジェクトストレージ
API リファレンス
富士通クラウドテクノロジーズ株式会社
2018年 03月 28日(第 1.4版)
オブジェクトストレージ APIリファレンス はじめに
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 2 富士通クラウドテクノロジーズ株式会社
はじめに
■ マニュアルの目的
このマニュアルは、以下を目的として制作されています。
・ オブジェクトストレージAPIのリファレンスを提供する。
・ 各APIについての処理概要やパラメーターの内容など、サンプルコードでは補完できない情報を提供する。
■ マニュアルの利用者
・ オブジェクトストレージAPIを使用して、データのバックアップとして利用される方
・ オブジェクトストレージAPIを使用して、システム構築・アプリケーションの開発を行う方
■ 前提知識
このマニュアルは、以下の知識を持つ方を対象として制作されています。
・ XMLに関する知識(「W3 Schools XML Tutorial」参照)
W3 Schools XML Tutorial http://www.w3schools.com/xml/default.asp
・ REST通信に関する知識
・ プログラミングに関する知識
・ Hmacハッシュ方式に関する知識
■ マニュアルの構成
このマニュアルは、以下の情報で構成されています。
構成 内容
はじめに このマニュアルに関する情報、マニュアルを利用する際に必要となる前提条件、マニュアルの目次
を示します。
API認証方式について APIの認証ロジック、リクエスト時の付加情報を示します。
API リファレンス 「バケット」、「オブジェクト」、「その他」の3分野に分けて、APIを解説します。
それぞれのAPIについて、処理概要、リクエストパラメーター、レスポンス、リクエストサンプル、応答
サンプルを示します。
付録 エラーコード・制限事項等を掲載します。
■ 関連情報
・ オブジェクトストレージ
https://cloud.nifty.com/service/obj_storage.htm
・ オブジェクトストレージ API
https://cloud.nifty.com/api/obj_storage/
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 3 富士通クラウドテクノロジーズ株式会社
認証方式
RESTでリクエストを行う場合、リクエスト毎に以下の認証ヘッダーを付加する必要があります。
(アクセス権限設定によっては、認証ヘッダーを付加する必要はありません。)
■ バージョン 3
GET / HTTP/1.1
Host: jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS ${AccessKeyId}:${Sigunature}
項目名 説明 必須 サンプル値
AccessKeyId コントロールパネルより取得した AccessKey ○
Signature 認証文字列
※生成ロジックは後述
○
Signature(認証文字列)生成ロジック
Signature = Base64( HMAC-SHA1 ( SecretAccessKey, UTF-8-Encoding( StringToSign ) ) )
StringToSign = HTTP リクエストメソッド + ¥n
HTTP リクエストヘッダー文字列(*) + ¥n
URLエンコードしたパス部分 + リクエストパラメーター文字列
(*)リクエストヘッダー文字列生成について:
1. リクエストヘッダーキーをUTF-8の自然順序でソートする。
2. リクエストヘッダー値を(“¥n”)で連結する
・ リクエストヘッダーキーが “Content-MD5”、“Content-Type”、“Date” の場合、値を連結する。
・ リクエストヘッダーキーの接頭文字が、 “x-amz-”の場合、ヘッダーキー+“:”+ヘッダー値を連結する。
例:Get Service
GET / HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
GET¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/
例:Put Bucket
PUT / HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
PUT¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/
例:Get Bucket
GET / HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
GET¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/
例:Delete Bucket
DELETE / HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
DELETE¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 4 富士通クラウドテクノロジーズ株式会社
例:Put Object
PUT /sample.txt HTTP1.1
Content-MD5: 62cff0140e0931c345c25795689032ca
Content-Type: text/plan
Date: Wed, 29 Jun 2016 12:00:00 GMT
x-amz-acl:private
x-amz-meta-alphabet:abcdefghijklmnopqrstuvwxyz
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Content-length: 138
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
PUT¥n
62cff0140e0931c345c25795689032ca¥n
text/plan¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
x-amz-acl:private¥n
x-amz-meta-alphabet:abcdefghijklmnopqrstuvwxyz¥n
/my-first-bucket/sample.txt
例:Get Object
GET/sample.txt HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
GET¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/sample.txt
例:Delete Object
DELETE /sample.txt HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
DELETE¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/sample.txt
例:Put Object acl
PUT /sample.txt?acl HTTP1.1
Content-Type: text/plan
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Content-length: 961
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
PUT¥n
¥n
text/plan¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/sample.txt?acl
例:Get Object acl
GET /sample.txt?acl HTTP1.1
Content-Type: application/octet-stream
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
StringToSign =
GET¥n
¥n
application/octet-stream¥n
Wed, 29 Jun 2016 12:00:00 GMT¥n
/my-first-bucket/sample.txt?acl
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 5 富士通クラウドテクノロジーズ株式会社
■ バージョン 4
GET / HTTP/1.1
Host: jp-east-2.os.cloud.nifty.com
Date: Mon, 03 July 2017 00:00:00 GMT
Authorization: AWS4-HMAC-SHA256
Credential=${AccessKeyId}/${RequestDate}/${Region}/s3/aws4_request,
SignedHeaders=${SignedHeaders},
Signature=${Sigunature}
項目名 説明 必須 サンプル値
AccessKeyId コントロールパネルより取得したアクセスキー ○
RequestDate リクエスト日 yyyymmdd 形式 ○ 20170724
Region リージョン ○ jp-east-2
SignedHeaders 署名ヘッダー ※生成ロジックは後述 ○ host,x-amz-date
Signature 認証文字列
※生成ロジックは後述
○
Signature(認証文字列)生成ロジック
Signature = Hex( HMAC-SHA256 ( SigningKey, StringToSign ))
StringToSign = “AWS4-HMAC-SHA256¥n” +
“${TimeStamp}¥n” +
“${CredentialScope}¥n” +
Hex(SHA256Hash(CanonicalRequest))
CredenatialScope = “${RequestDate}/${Regions}/s3/aws4_request”
CanonicalRequest = “${HTTPMethod}¥n” +
“${CanonicalURI}¥n” +
“${CanoncalQueryString}¥n” +
“${CanonicalHeaders}¥n” +
“${SignedHeaders}¥n” +
“${HashedPayload}”
HashedPayload = Hex(SHA256Hash(${Payload})
SigningKey = HMAC-SHA256(
HMAC-SHA256(
HMAC-SHA256(
HMAC-SHA256("AWS4"+"${SecretAccessKey}", "${RequestDate}"), "${Region}"
), "s3"
), "aws4_request"
)
項目名 説明 必須 サンプル値
TimeStamp ISO8601形式でフォーマットされたリクエスト時間 ○ 20170724T0000000Z
HTTPMethod 利用するHTTP メソッド ○ “GET”,“PUT”,“DELETE”等
CanonicalURI URLエンコードしたパス部分 クエリ文字列は除く ○ /sample.txt
CanonicalQueryString クエリ文字列に含まれる各パラメーターについて、パ
ラメーター名と値をそれぞれURLエンコードしたもの
を”=”で繋げて、パラメーター名で辞書順にソートし
て”¥n”で結合したもの
○ acl=
CanonicalHeaders ヘッダーに含まれる各パラメーターについて、ヘッダ
ー名と値をそれぞれ小文字に変換したものを”:”で繋
げて、パラメーター名で辞書順にソートして”¥n”で結
合したもの
host ヘッダーは必須
Content-Type ヘッダーと ”x-amz-“ で始まるヘッダー
がリクエストに含まれる場合は必須
○ host:my-first-bucket.jp-east-
2.os.cloud.nifty.com¥n
x-amz-
date:20170724T000000Z¥n
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 6 富士通クラウドテクノロジーズ株式会社
SignedHeaders CanonicalHeaders に含まれるヘッダーパラメーターの
ヘッダー名を辞書順にソートし、”;”で繋げたもの ○ host;x-amz-date
Payload リクエストボディーの値
PUT リクエストの場合は PUTするファイルやチャン
ク、ACL分など
GETの場合は空文字
○
SecretAccessKey コントロールパネルより取得したシークレットキー ○
例:Get Service
GET / HTTP1.1
x-amz-date: 20170724T000000Z
Host: jp-east-2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
GET¥n
/¥n
¥n
host:jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/jp-east-2/s3/aws4_request¥n
c04e4c3209d21bb444cdbf3595bea89a3469613b48ca3f8dfb8ced1c88b4b651
例:Put Bucket
PUT / HTTP1.1
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
PUT¥n
/¥n
¥n
host:my-first-bucket2.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
4459d9515dd2c529209caa33376e5dfc398425393e6dad1a4d122566579c3abb
例:Get Bucket
GET / HTTP1.1
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
GET¥n
/¥n
¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
7df254b7970a77c2e626d4d08710ba785dee70242bb57e50aaa8aa1b750b1d04
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 7 富士通クラウドテクノロジーズ株式会社
例:Delete Bucket
DELETE / HTTP1.1
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
DELETE¥n
/¥n
¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
8be98872cc6e745f0ebf075eeafa10c91a13b66daedba2a6f1474b6514bc8e74
例:Put Object
PUT /sample.txt HTTP1.1
x-amz-date: 20170724T000000Z
x-amz-acl:private
x-amz-meta-
alphabet:abcdefghijklmnopqrstuvwxyz
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
Content-length: 138
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
PUT¥n
/sample.txt¥n
¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
bca0f8d25bcca8ba60df399f84b0e9e85c25dd5dc11cb826c50ae561008872ae
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
77a70e3e2c4e0ab1a919a8508c8306dc9f4df2e56952b2bc82d0f279d6dada54
例:Get Object
GET/sample.txt HTTP1.1
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
GET¥n
/sample.txt¥n
¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
c6a2222893599353161c31aa8705586c641766624048201e1381a89e4405e5c6
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 8 富士通クラウドテクノロジーズ株式会社
例:Delete Object
DELETE /sample.txt HTTP1.1
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
DELETE¥n
/sample.txt¥n
¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
b3aa4438cd01be87f47d54fef44274516a031d4a2d43859f43f65b20d02fe52c
例:Put Object acl
PUT /sample.txt?acl HTTP1.1
Content-Type: text/plan
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
Content-length: 961
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
PUT¥n
/sample.txt¥n
acl=¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
382a0af7309dfe0a4db460e2ebb205447ae14e4de4217b710180cd050e5befd4
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
8f363bf33583292ffbc1c8ab1eb5691d5c345e538fbe2fcb930267b5411c34a5
例:Get Object acl
GET /sample.txt?acl HTTP1.1
Content-Type: application/octet-stream
x-amz-date: 20170724T000000Z
Host: my-first-bucket.jp-east-
2.os.cloud.nifty.com
User-Agent: Nifty Cloud Service Java Client
Authorization: <Authorization String>
CanonicalRequest=
GET¥n
/sample.txt¥n
acl=¥n
host:my-first-bucket.jp-east-2.os.cloud.nifty.com¥n
x-amz-date:20170724T000000Z¥n
¥n
host;x-amz-date¥n
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
StringToSign=
AWS4-HMAC-SHA256¥n
20170724T000000Z¥n
20170724/east-1/s3/aws4_request¥n
a282cea2acaef821beabc9fc4f583dafa1140c9622bfc66172435cea169ffdd2
■ 認証方式
オブジェクトストレージは、リクエストと同じ方法でリクエストから Signatureを生成し、認証ヘッダー指定された値と文
字列比較を行います。
文字列が一致し、認証文字列が正しいと判定した場合、指定されたAPIの処理を実行します。
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 9 富士通クラウドテクノロジーズ株式会社
■ エンドポイント
オブジェクトストレージで利用可能なエンドポイントを以下に記述します。
jp-east-2.os.cloud.nifty.com
jp-west-1.os.cloud.nifty.com
■ バーチャルホスト形式
バケットとオブジェクトを指定する場合、以下のようにリクエスト先をバーチャルホスト形式で指定します。
https://<バケット名>.jp-east-2.os.cloud.nifty.com/<オブジェクト名>
リクエストサンプル
GET /sample.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: date
Authorization: <Authorization String>
■ リリースノート
リリース日 APIバージョン リリース内容
2016-06-29 1.0 初版提供
・ バケット操作
List Buckets, Get Bucket Info (HEAD), Create Bucket, Delete Bucket, List Object,
Put Bucket acl, Get Bucket acl, Put Bucket versioning, Get Bucket versioning,
Get Bucket Object versions, Get Bucket location
・ オブジェクト操作
Put Object, Get Object, Delete Object, Put Object acl, Get Object acl, Head Object,
Put Object - Copy, Initiate Multipart, Upload, Upload part, Complete Multipart Upload,
Abort Multipart Upload, List Parts
2017-05-15 1.1 社名変更に伴う対応
・ フッター部の Copyright 及び社名を富士通クラウドテクノロジーズに変更
2017-11-17 1.2 ブランド名変更
ニフティクラウド → ニフクラ
2018-02-26 1.3 v1.3 へのアップデート
・ バケット操作の追加
Put Bucket cors, Get Bucket cors, Delete Bucket cors
・ オブジェクト操作
Options objectの追加
Delete MultipleObjects の追加
・ その他
シグネチャ v4 認証追加
サービス仕様変更
バケット毎のオブジェクト格納数を設定
リクエスト数の制限値を設定
その他修正
Get Bucket の max-keys パラメーター利用方法の明示
ACL の XML ID フィールド指定方法の修正
共通エラーレスポンスステータスを追加
命名規則項を制限事項に変更
2018-03-28 1.4 オブジェクトストレージ 西リージョンエンドポイント追記
オブジェクトストレージ APIリファレンス 認証方式
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 10 富士通クラウドテクノロジーズ株式会社
■ 目 次
はじめに .................................................................................................................................................. 2
認証方式 ................................................................................................................................................. 3
1 バケット操作 ................................................................................................................. 11
Get Service .......................................................................................................................................... 11
Head Bucket ........................................................................................................................................ 13
Put Bucket ............................................................................................................................................ 14
Delete Bucket ...................................................................................................................................... 15
Get Bucket ........................................................................................................................................... 16
Put Bucket acl ...................................................................................................................................... 20
Get Bucket acl ..................................................................................................................................... 23
Put Bucket versioning ......................................................................................................................... 25
Get Bucket versioning ......................................................................................................................... 26
Get Bucket Object versions ............................................................................................................... 27
Get Bucket location ............................................................................................................................. 31
Put Bucket cors ................................................................................................................................... 32
Get Bucket cors ................................................................................................................................... 34
Delete Bucket cors .............................................................................................................................. 36
2 オブジェクト操作 .......................................................................................................... 37
Put Object ............................................................................................................................................. 37
Get Object ............................................................................................................................................ 39
Delete Object ....................................................................................................................................... 41
Delete Multiple Objects ....................................................................................................................... 42
Put Object acl ....................................................................................................................................... 46
Get Object acl ...................................................................................................................................... 50
Head Object ......................................................................................................................................... 53
Options Object ..................................................................................................................................... 55
Put Object - Copy ................................................................................................................................ 57
Initiate Multipart Upload ...................................................................................................................... 60
Upload part ........................................................................................................................................... 62
Complete Multipart Upload................................................................................................................. 63
Abort Multipart Upload ........................................................................................................................ 65
List Parts ............................................................................................................................................... 66
List Multipart Uploads ......................................................................................................................... 69
付 録............................................................................................................................ 73
制限事項 ............................................................................................................................................... 73
ACL ....................................................................................................................................................... 74
共通エラーレスポンスステータス ........................................................................................................ 75
オブジェクトストレージ APIリファレンス Get Service
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 11 富士通クラウドテクノロジーズ株式会社
1 バケット操作
Get Service
■ 処理概要
所有しているすべてのバケット情報を取得します。
■ 指定するパラメーター
必要なパラメーターはありません。
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
ListAllMyBucketsResult ListAllMyBucketsResultレスポンス
Type : Container
Ancestor : None
Children : Owner, Buckets
Owner Ownerレスポンス
Type : Container
Ancestor : ListAllMyBucketsResult
Children : ID, DisplayName
ID オーナーID
Type : xsd:string
Ancestor : Owner
Children : なし
ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : Owner
Children : なし
ABC12345
Buckets Bucketsレスポンス
Type : xsd: Container
Ancestor : ListAllMyBucketsResult
Children : Bucket
Bucket Bucketレスポンス
Type : Container
Ancestor : ListAllMyBucketsResult.Buckets
Children : Name, CreationDate
Name バケット名
Type : xsd:string
Ancestor : ListAllMyBucketsResult.Buckets.Bucket
Children : なし
オブジェクトストレージ APIリファレンス Get Service
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 12 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
CreationDate バケット作成日時
Type : NullableAttributeValueType
Ancestor : ListAllMyBucketsResult.Buckets.Bucket
Children : なし
2016-06-29T00:00:00.000Z
■ リクエストサンプル
GET / HTTP/1.1
Host: jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:LojUVNwgIpZWNaDmEFUXGaKXXYs=
■ 応答サンプル
<ListAllMyBucketsResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<Buckets>
<Bucket>
<Name>my-first-bucket</Name>
<CreationDate>2016-06-29T00:00:00.000Z</CreationDate>
</Bucket>
<Bucket>
<Name>sample-bucket</Name>
<CreationDate>2016-06-29T01:00:00.000Z</CreationDate>
</Bucket>
</Buckets>
</ListAllMyBucketsResult>
オブジェクトストレージ APIリファレンス Head Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 13 富士通クラウドテクノロジーズ株式会社
Head Bucket
■ 処理概要
指定したバケットが存在するか、操作権限があるかを知ることが出来ます。
レスポンスコードが 200 の場合はバケットが存在して操作権限があること、404の場合にはバケットが存在しないこと、403の場合は
操作権限が無いことをそれぞれ示します。
■ 指定するパラメーター
必要なパラメーターはありません。
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答ヘッダー
応答ヘッダーはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
HEAD / 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:LojUVNwgIpZWNaDmEFUXGaKXXYs=
オブジェクトストレージ APIリファレンス Put Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 14 富士通クラウドテクノロジーズ株式会社
Put Bucket
■ 処理概要
バケットを作成します。
バケット作成者はバケットオーナーとして扱われます。
作成できるバケット上限は、20バケットです。
※バケットの命名規則は、「付録 命名規則」を参照ください。
■ 指定するパラメーター
必要なパラメーターはありません。
■ 指定するヘッダー
ヘッダー 説明 必須 サンプル値
x-amz-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
■ 指定するボディ
指定するボディはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
PUT / HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:LojUVNwgIpZWNaDmEFUXGaKXXYs=
x-amz-acl: private
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 7ac0ffe6-4f2d-3fbd-a534-66726512f358
Location: my-first-bucket
Content-Length: 0
オブジェクトストレージ APIリファレンス Delete Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 15 富士通クラウドテクノロジーズ株式会社
Delete Bucket
■ 処理概要
指定したバケットを削除します。
バケットオーナーのみ削除することが可能です。
また、バケット内にオブジェクトが存在している場合、削除することができません。バケット内に保存されているオブジェクトをすべて
削除する必要があります。
■ バージョン管理
バケットにバージョニング設定がされている場合、バケットを削除するにはすべての versionIdに紐づくオブジェクトを削除する必要
があります。
■ 指定するパラメーター
必要なパラメーターはありません。
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
DELETE / 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:LojUVNwgIpZWNaDmEFUXGaKXXYs=
■ 応答サンプル
HTTP/1.1 204 No Content
x-amz-request-id: 3fee7a37-d5aa-37bf-a62e-449331aa0952
オブジェクトストレージ APIリファレンス Get Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 16 富士通クラウドテクノロジーズ株式会社
Get Bucket
■ 処理概要
バケット内に保存されたオブジェクト情報を取得します。
リクエストパラメーターにより、取得条件を指定することができます。
取得にはバケットの読み込み権限が必要となります。
1リクエストで取得できるオブジェクト数は、1000オブジェクトとなります。1000オブジェクト以上存在する場合は、各リクエストパラメ
ーターを指定してください。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
delimiter 区切り文字列
Type : String
%2F (/ スラッシュ)
marker 開始文字列
指定した文字列からアルファベット順でリストを表示し
ます。
Type : String
max-keys 最大一覧表示数
Type : Int
Default : 1000
1000以下のみ指定可能
prefix 前方一致文字列
Type : String
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
ListBucketResult ListBucketResultレスポンス
Type : Container
Ancestor : なし
Children : Name, Prefix,Marker,MaxKeys, IsTruncated,Contents
Name バケット名
Type : xsd:string
Ancestor : ListBucketResult
Children : なし
Marker 指定した開始文字列
Type : xsd:string
Ancestor : ListBucketResult
Children : なし
MaxKeys 指定した最大一覧表示数
Type : xsd:int
Ancestor : ListBucketResult
Children : なし
オブジェクトストレージ APIリファレンス Get Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 17 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Prefix 指定した前方一致文字列
Type : xsd:string
Ancestor : ListBucketResult
Children : なし
IsTruncated 全結果取得フラグ
リクエスト件数がすべて返却できたかどうか
Type : xsd:boolean
Ancestor : ListBucketResult
Children : なし
true(返却できていない)
false(返却できている)
NextMarker 次リクエスト検索キー
(max-key件数で返しきれなかった場合、次リクエスト時のmarker
に指定すべきオブジェクト検索キー)
delimiter の指定が必須
Type : xsdstring
Ancestor : ListVersionsResult
Children : なし
Contents Contentsレスポンス
Type : Container
Ancestor : ListBucketResult
Children : ETag,Key, LastModified, Size, StorageClass, Owner
ETag オブジェクト ETag
Type : xsd:string
Ancestor : ListBucketResult.Contents
Children : なし
Key オブジェクト名
Type : xsd:string
Ancestor : ListBucketResult.Contents
Children : なし
LastModified 最終更新日時
Type : xsd:date
Ancestor : ListBucketResult.Contents
Children : なし
Size オブジェクトサイズ
Type : xsd:int
Ancestor : ListBucketResult.Contents
Children : なし
StorageClass ストレージ分類
Type : xsd:string
Ancestor : ListBucketResult.Contents
Children : なし
STANDARD
Owner Ownerレスポンス
Type : Container
Ancestor : ListBucketResult.Contents
Children : なし
ID オーナーID
Type : xsd:string
Ancestor : ListBucketResult.Contents.Owner
Children : なし
ABC12345
オブジェクトストレージ APIリファレンス Get Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 18 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
DisplayName オーナー名
Type : xsd:string
Ancestor : ListBucketResult.Contents.Owner
Children : なし
ABC12345
オブジェクトストレージ APIリファレンス Get Bucket
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 19 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル
GET /?delimiter=%2F 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:l+yOSNiZjp587YJsms9KoNHMcrU=
■ 応答サンプル
<ListBucketResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Name>my-first-bucket</Name>
<Prefix/>
<Marker/>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>sample.txt</Key>
<LastModified>2016-06-29T00:00:00.000Z</LastModified>
<StorageClass>STANDARD</StorageClass>
<Size>138</Size>
<ETag>"62cff0140e0931c345c25795689032ca"</ETag>
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
</Contents>
<Contents>
<Key>test.txt</Key>
<LastModified>2016-06-29T00:00:00.000Z </LastModified>
<StorageClass>STANDARD</StorageClass>
<Size>298</Size>
<ETag>"d41d8cd98f00b204e9800998ecf8457e"</ETag>
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
</Contents>
</ListBucketResult>
オブジェクトストレージ APIリファレンス Put Bucket acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 20 富士通クラウドテクノロジーズ株式会社
Put Bucket acl
■ 処理概要
指定したバケットに対して、アクセス権限を設定します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
acl ACL リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
フィールド 説明 サンプル値
AccessControlPolicy AccessControlPolicy リクエスト
Type : Container
Ancestor : なし
Children : Owner,AccessControlList
Owner Owner リクエスト
Type : Container
Ancestor : AccessControlPolicy
Children : ID,DisplayName
ID オーナーID
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
AccessControlList AccessControlList リクエスト
Type : Container
Ancestor : AccessControlPolicy
Children : Grant
Grant Grant リクエスト
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : Grantee
Grantee Grantee リクエスト
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : ID,DisplayName
Permission アクセス権限
FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP
Type : xsd:string
Ancestor : AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
オブジェクトストレージ APIリファレンス Put Bucket acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 21 富士通クラウドテクノロジーズ株式会社
■ Grantee
設定対象ユーザーと指定は以下となります。
特定ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>Owner ID</ID>
<DisplayName>Owner DisplayName(Owner ID)</DisplayName>
</Grantee>
認証ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
未認証ユーザー
<Grantee xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AllUsers</URI>
</Grantee>
ログ配信グループ(LogDelivery)
<Grantee xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/jp-east-2.os.cloud/LogDelivery</URI>
</Grantee>
■ 応答フィールド
応答フィールドはありません。
オブジェクトストレージ APIリファレンス Put Bucket acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 22 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル
PUT /?acl= 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:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 961
Content-Type: text/plain
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
<Permission>WRITE</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AllUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 5c57c566-3c27-3d2d-b266-67229e4fe22e
Content-Length: 0
オブジェクトストレージ APIリファレンス Get Bucket acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 23 富士通クラウドテクノロジーズ株式会社
Get Bucket acl
■ 処理概要
指定したバケットのアクセス権限情報を取得します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
acl ACL リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
フィールド 説明 サンプル値
AccessControlPolicy AccessControlPolicyレスポンス
Type : Container
Ancestor : なし
Children : Owner,AccessControlList
Owner Ownerレスポンス
Type : Container
Ancestor : AccessControlPolicy
Children : ID,DisplayName
ID オーナーID
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
AccessControlList AccessControlListレスポンス
Type : Container
Ancestor : AccessControlPolicy
Children : Grant
Grant Grantレスポンス
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : Grantee
Grantee Granteeレスポンス
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : ID,DisplayName
オブジェクトストレージ APIリファレンス Get Bucket acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 24 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Permission アクセス権限
FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP
Type : xsd:string
Ancestor : AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
■ リクエストサンプル
GET /?acl= 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:jUgOMOxiuSXIn1MX6NPlpASWsAk=
■ 応答サンプル
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Grantee><Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
オブジェクトストレージ APIリファレンス Put Bucket versioning
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 25 富士通クラウドテクノロジーズ株式会社
Put Bucket versioning
■ 処理概要
指定したバケットにバージョニングを設定します。
デフォルトではOffになっており、一度 Suspended 又は Enabled に設定するとOffにする事はできません。
バケットオーナーのみ設定することが可能です。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versioning versioning リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
フィールド 説明 サンプル値
VersioningConfiguration VersioningConfiguration リクエスト
Type : Container
Ancestor : なし
Children : Status
Status バージョニング設定
Type : xsd:string
Valid Values : Suspended | Enabled
Ancestor : VersioningConfiguration
Suspended (中断)
Enabled (有効)
■ 応答フィールド 応答フィールドはありません。
■ リクエストサンプル
PUT /?versioning HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
Content-Type: text/plain
Content-Length: 124
<VersioningConfiguration xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Status>Enabled</Status>
</VersioningConfiguration>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 236A8905248E5A01
Content-Length: 0
オブジェクトストレージ APIリファレンス Get Bucket versioning
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 26 富士通クラウドテクノロジーズ株式会社
Get Bucket versioning
■ 処理概要
バケットのバージョニング設定状態を取得します。
バージョニング設定には以下のステータスがあります。
有効 (Enabled)
中断 (Suspended)
未設定 (Off) ※バケット作成後、一度も Enabled/Suspendedいずれの設定も行っていない場合
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versioning versioning リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
VersioningConfiguration VersioningConfigurationレスポンス
Type : Container
Ancestor : なし
Children : すべての elements
Status バージョニング設定
Type : xsd:string
Ancestor : VersioningConfiguration
Children : なし
Enabled (有効)
Suspended (中断)
空 (未設定)
■ リクエストサンプル
GET /?versioning HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
Content-Type: text/plain
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 236A8905248E5A01
<VersioningConfiguration xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Status>Enabled</Status>
</VersioningConfiguration>
オブジェクトストレージ APIリファレンス Get Bucket Object versions
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 27 富士通クラウドテクノロジーズ株式会社
Get Bucket Object versions
■ 処理概要
バケット内に保存されたオブジェクトのバージョン情報を取得します。
リクエストパラメーターにより、取得条件を指定することができます。
取得にはバケットの読み込み権限が必要となります。
1リクエストで取得できるオブジェクト数は、1000オブジェクトとなります。1000オブジェクト以上存在する場合は、各リクエストパラメ
ーターを指定してください。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versions versions リクエスト
値 : なし
○
delimiter 区切り文字列
Type : String
%2F
key-marker 開始文字列
指定した文字列からアルファベット順でリストを表示します。
Type : String
max-keys 最大一覧表示数
Type : Int
Default : 1000
prefix 前方一致文字列
Type : String
version-id-marker 開始オブジェクトバージョン ID
Type : String
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答ヘッダー
応答ヘッダーはありません。
■ 応答フィールド
フィールド 説明 サンプル値
ListVersionsResult ListVersionsResultレスポンス
Type : Container
Ancestor : なし
Children : すべての elements
Name バケット名
Type : xsd:string
Ancestor : ListVersionsResult
Children : なし
オブジェクトストレージ APIリファレンス Get Bucket Object versions
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 28 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Prefix 指定した前方一致文字列
Type : xsdstring
Ancestor : ListVersionsResult
Children : なし
KeyMarker 指定した開始文字列
Type : xsdstring
Ancestor : ListVersionsResult.version
Children : なし
VersionIdMarker 指定した開始オブジェクトバージョン ID
type : xsdstring
Ancestor : ListVersionsResult
Children : なし
MaxKeys 指定した最大一覧表示数
type : xsdstring
Default : 1000
Ancestor : ListVersionsResult
Children : なし
IsTruncated 全結果取得フラグ
リクエスト件数がすべて返却できたかどうか
Type : xsd:boolean
Ancestor : ListVersionsResult
Children : なし
true(取得できていない)
false(取得できている)
NextKeyMarker 次リクエスト検索キー
(max-key件数で返しきれなかった場合に、次リクエストのmarkerに
指定すべきオブジェクト検索キー)
delimiter指定必須
Type : xsdstring
Ancestor : ListVersionsResult
Children : なし
NextVersionIdMarker 次リクエスト検索バージョン ID
(max-key件数で返しきれなかった場合に、次リクエストの version-id-
markerに指定すべきオブジェクトのバージョン ID)
Type : int
Ancestor : ListVersionsResult
Children : なし
DeleteMarker DeleteMarkerレスポンス
(オブジェクトがすでに削除されている場合)
Type : Container
Ancestor : ListVersionsResult
Children : key,VersionId,IsLatest,LastModified,Owner
Version Versionレスポンス
Type : Container
Ancestor : ListVersionsResult
Children :Key,VersionId,IsLatest,LastModified,ETag,Size,StorageClass
,Owner
Key オブジェクト名
Type : xsdstring
Ancestor : ListVersionsResult.version |
ListVersionsResult.DeleteMarker
Children : なし
オブジェクトストレージ APIリファレンス Get Bucket Object versions
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 29 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
VersionId オブジェクトバージョン id
Type : xsdstring
Ancestor : ListVersionsResult.version |
ListVersionsResult.DeleteMarker
Children : なし
IsLatest オブジェクト最新情報
Type : xsd:boolean
Ancestor : ListVersionsResult.Version
Children : なし
true(最新オブジェクト)
false(最新ではない)
LastModified 最終更新時間
Type : xsddate
Ancestor : ListVersionsResult.version |
ListVersionsResult.DeleteMarker
Children : なし
StorageClass ストレージ分類
(STANDARD固定)
Ancestor : ListVersionsResult.version
Children : なし
STANDARD
Size オブジェクトサイズ
Type : xsdint
Ancestor : ListVersionsResult.version
Children : なし
ETag オブジェクト ETag
Type : xsd:string
Ancestor : ListVersionsResult.Version
Children : なし
Owner Ownerレスポンス
Type : xsdstring
Ancestor : ListVersionsResult.version |
ListVersionsResult.DeleteMarker
Children : DisplayName,ID
ID オーナーID
Type : xsd:string
Ancestor : ListVersionsResult.Version.Owner |
ListVersionsResult.DeleteMarker.Owner
Children : なし
ABC12345
DisplayName オーナー名
Type : xsdstring
Ancestor : ListVersionsResult.version.Owner |
ListVersionsResult.DeleteMarker.Owner
Children : なし
ABC12345
■ リクエストサンプル
GET /?versions HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=
オブジェクトストレージ APIリファレンス Get Bucket Object versions
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 30 富士通クラウドテクノロジーズ株式会社
■ 応答サンプル
<ListVersionsResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/”>
<Name>my-first-bucket</Name>
<Prefix></Prefix>
<KeyMarker></KeyMarker>
<VersionIdMarker></VersionIdMarker>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Version>
<Key>backup.log</Key>
<VersionId>998668733986120</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2012-02-23T06:01:50.000Z</LastModified>
<ETag>"53f2f2d09a820e40af127ae8b745d7f7"</ETag>
<Size>250019</Size>
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
<Version>
<Key>backup.log</Key>
<VersionId>998668733986121</VersionId>
<IsLatest>false</IsLatest>
<LastModified>2012-02-23T06:01:40.000Z</LastModified>
<ETag>"701f59131868a0523e6d5ae25dd2a967"</ETag>
<Size>242177</Size>
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
<Version>
<Key>backup.log</Key>
<VersionId>998668733986122</VersionId>
<IsLatest>false</IsLatest>
<LastModified>2012-02-23T06:01:30.000Z</LastModified>
<ETag>"64ea72818b8ffa26f8aa30f5b8fed7ba"</ETag>
<Size>44889</Size>
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
</ListVersionsResult>
オブジェクトストレージ APIリファレンス Get Bucket location
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 31 富士通クラウドテクノロジーズ株式会社
Get Bucket location
■ 処理概要
指定したバケットの地域(リージョン)を取得します。
※取得した地域で、エンドポイント(リクエスト先)が異なります。「認証ヘッダーと認証方式 エンドポイント」を参照ください。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
location location リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
指定するボディはありません。
■ 応答ヘッダー
応答ヘッダーはありません。
■ 応答フィールド
フィールド 説明 サンプル値
LocationConstraint LocationConstraintレスポンス
Type : xsd:string
Ancestor : なし
Children : なし
jp-east-2
■ リクエストサンプル
GET /?location HTTP/1.1
Host: my-first-w-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
Content-length: 136
<?xml version=”1.0” encoding=”UTF-8”?>
<LocationConstraint xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
jp-east-2</LocationConstraint>
オブジェクトストレージ APIリファレンス Put Bucket cors
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 32 富士通クラウドテクノロジーズ株式会社
Put Bucket cors
■ 処理概要
指定したバケットの CORSに関する設定を行います。既に設定がなされている場合は更新処理として動作します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
cors cors リクエスト
値 : なし
○
■ 指定するヘッダー
パラメーター 説明 必須 サンプル値
Content-MD5 BASE64エンコード済みのMD5のハッシュ値
Type : String
○ fbc7766efe84e4e57bcea84cafd6fcc2
(空文字の base64エンコード済みMD5ハッシュ値)
■ 指定するボディ
フィールド 説明 必須 サンプル値
CORSConfiguration CORSConfiguration リクエスト
Type : Container
Ancestor : なし
Children : CORSRule,
○
CORSRule CORSRule リクエスト
Type : Container
Ancestor : CORSConfiguration
Children : AllowedOrigin, AllowedMethod, AllowedHeader,
MaxAgeSeconds, ExposeHeader, ID.
○
ID ID 設定の中からルールを探す際に役立つユニークな値
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
AllowedOrigin 許可オリジン
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
○ http://www.example.com
AllowedMethod 許可メソッド
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
○ PUT
AllowedHeader 許可ヘッダー
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
*
MaxAgeSeconds リソースの preflight OPTIONS リクエストのキャッシュ時間
Type : Integer
Ancestor : CORSConfiguration. CORSRule
Children : なし
ExposeHeader クライアントに提供するレスポンスヘッダー
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
ETag, x-amz-request-id
オブジェクトストレージ APIリファレンス Put Bucket cors
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 33 富士通クラウドテクノロジーズ株式会社
■ 応答ヘッダー
応答ヘッダーはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
PUT /?cors HTTP/1.1
Host: my-first-w-bucket.jp-east-2.os.cloud.nifty.com
Date: Mon, 03 July 2017 00:00:00 GMT
Content-MD5: Rcq+X40UAJxtQ7vbybZ42w==
Authorization: <Authorization String>
Content-Length: 506
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>http://www.example.com</AllowedOrigin>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSec>
<ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
</CORSRule>
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
Content-length: 0
Date: Mon, 03 July 2017 00:00:00 GMT
オブジェクトストレージ APIリファレンス Get Bucket cors
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 34 富士通クラウドテクノロジーズ株式会社
Get Bucket cors
■ 処理概要
指定したバケットの CORSに関する設定を取得します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
cors cors リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
指定するボディはありません。
■ 応答ヘッダー
応答ヘッダーはありません。
■ 応答フィールド
フィールド 説明 サンプル値
CORSConfiguration CORSConfiguration リクエスト
Type : Container
Ancestor : なし
Children : CORSRule,
CORSRule CORSRule リクエスト
Type : Container
Ancestor : CORSConfiguration
Children : AllowedOrigin, AllowedMethod, AllowedHeader,
MaxAgeSeconds, ExposeHeader, ID.
ID ID 設定の中からルールを探す際に役立つユニークな値
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
AllowedOrigin 許可オリジン
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
http://www.example.com
AllowedMethod 許可メソッド
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
PUT
AllowedHeader 許可ヘッダー
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
*
オブジェクトストレージ APIリファレンス Get Bucket cors
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 35 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
MaxAgeSeconds リソースの preflight OPTIONS リクエストのキャッシュ時間
Type : Integer
Ancestor : CORSConfiguration. CORSRule
Children : なし
ExposeHeader クライアントに提供するレスポンスヘッダー
Type : String
Ancestor : CORSConfiguration. CORSRule
Children : なし
ETag, x-amz-request-id
■ リクエストサンプル
GET /?cors HTTP/1.1
Host: my-first-w-bucket.jp-east-2.os.cloud.nifty.com
Date: Mon, 03 July 2017 00:00:00 GMT
Authorization: <Authorization String>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
Content-length: 136
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedMethod>GET</AllowedMethod>
<AllowedOrigin>*</AllowedOrigin>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
オブジェクトストレージ APIリファレンス Delete Bucket cors
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 36 富士通クラウドテクノロジーズ株式会社
Delete Bucket cors
■ 処理概要
指定したバケットの CORSに関する設定を削除します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
cors cors リクエスト
値 : なし
○
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
指定するボディはありません。
■ 応答ヘッダー
応答ヘッダーはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
DELETE /?cors HTTP/1.1
Host: my-first-w-bucket.jp-east-2.os.cloud.nifty.com
Date: Mon, 03 July 2017 00:00:00 GMT
Authorization: <Authorization String>
■ 応答サンプル
HTTP/1.1 204 No Content
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
Date: Mon, 03 July 2017 00:00:00 GMT
オブジェクトストレージ APIリファレンス Put Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 37 富士通クラウドテクノロジーズ株式会社
2 オブジェクト操作
Put Object
■ 処理概要
バケット内にオブジェクトを作成します。
リクエストヘッダーに Content-MD5を指定した場合、ネットワーク転送などによりデータが破損していないかどうか確認を行います。
作成できるオブジェクトサイズは、2GB未満です。
※2GB以上のファイルをアップロードする場合は、マルチアップロード機能をご利用ください。
■ バージョン管理
バケットのバージョニング設定により、作成されるオブジェクトは以下の通りとなります。
■ 指定するパラメーター 必要なパラメーターはありません。
■ 指定するヘッダー
ヘッダー 説明 必須 サンプル値
Content-Length オブジェクトサイズ
Type : Int
○
Content-Type MIMEタイプ
Type : String
Content-MD5 オブジェクトのMD5ダイジェスト
Type : String
x-amz-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
x-amz-meta- オブジェクトのメタデータ
Type : String
■ 指定するボディ
オブジェクトデータ
■ 応答ヘッダー
ヘッダー 説明 必須 サンプル値
x-amz-version-id オブジェクトのバージョン ID
Type : Int
999122348912293847
■ 応答フィールド
応答フィールドはありません。
バージョニング設定 オブジェクトの状態
Enabled 新規作成 (既存の同一名オブジェクトはバージョン管理されます)
Suspended 上書き更新 (すでにバージョン管理されているオブジェクトは現状のまま)
設定なし 上書き更新
オブジェクトストレージ APIリファレンス Put Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 38 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル
PUT /sample.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 138
Content-MD5: 62cff0140e0931c345c25795689032ca
Content-Type: application/octet-stream
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
<Object Data>
■ 応答サンプル (バージョニング設定なし)
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
ETag: 62cff0140e0931c345c25795689032ca
■ 応答サンプル (バージョニング設定あり)
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
x-amz-version-id: 999122348912293847
ETag: 62cff0140e0931c345c25795689032ca
オブジェクトストレージ APIリファレンス Get Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 39 富士通クラウドテクノロジーズ株式会社
Get Object
■ 処理概要
指定したオブジェクトを取得します。
■ バージョン管理
特定のバージョンのオブジェクトを取得するには versionIdを指定します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versionId オブジェクトのバージョン ID
Type : int
999122348912293847
■ 指定するヘッダー
ヘッダー 説明 必須 サンプル値
Range オブジェクト範囲
Type : String
bytes 0-69/138
if-modified-since 指定した時刻以降に更新されたオブジェクトを抽出
Type : Timestamp
if-unmodified-since 指定した時刻以降に更新されていないオブジェクトを
抽出
Type : Timestamp
if-match 指定した ETagにマッチするオブジェクトを抽出
Type : String
if-none-match 指定した ETagにマッチしないオブジェクトを抽出
Type : String
■ 指定するボディ
必要なボディはありません。
■ 応答ヘッダー
ヘッダー 説明 必須 サンプル値
ETag オブジェクト ETagj
Type : String
Last-Modified 最新更新時間
Type : Date
Wed, 29 Jun 2016 12:00:00
GMT
x-amz-meta- メタデータ
Type : String
x-amz-version-id- バージョンID
Type : int
999122348912293847
■ 応答フィールド
オブジェクトデータ
オブジェクトストレージ APIリファレンス Get Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 40 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定なし)
GET /sample.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 0A49CE4060975EAC
Date: Wed, 29 Jun 2016 12:00:00 GMT
Last-Modified: Wed, 29 Jun 2016 12:00:00 GMT
ETag: 62cff0140e0931c345c25795689032ca
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
Content-Length: 138
<Object Data>
■ リクエストサンプル (versionId指定あり)
GET /sample.txt?versionId=999122348912293847 HTTP/1.1
Authorization: AWS 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=
Date: Wed, 29 Jun 2016 12:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
■ 応答サンプル
HTTP/1.0 200 OK
Date: Wed, 29 Jun 2016 12:00:00 GMT
x-amz-request-id: 380cdf6d-f47f-33fe-aa7b-962878e8d53d
x-amz-version-id: 999122348912293847
ETag: 42776c373aa8b2188a9487de5d4b9494
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
Content-Length: 138
Last-Modified: Wed, 25 Jul 2012 12:00:00 GMT
<Object Data>
オブジェクトストレージ APIリファレンス Delete Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 41 富士通クラウドテクノロジーズ株式会社
Delete Object
■ 処理概要
指定したオブジェクトを削除します。
■ バージョン管理
特定のバージョンのオブジェクトを削除するには versionIdを指定します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versionId オブジェクトのバージョン ID
Type : int
999122348912293847
■ 指定するヘッダー
指定するヘッダーはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル (versionId指定なし)
DELETE /sample.txt 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:+o4vgswyoIOkWpopqhXJRzUD4EQ=
■ 応答サンプル
HTTP/1.1 204 No Content
x-amz-request-id: 33a3999d-b011-37d2-8a5e-2a750c2287df
■ リクエストサンプル (versionId指定あり)
DELETE /sample.txt?versionId=999122348912293847 HTTP/1.1
Authorization: AWS 07cbb45fc128390123f4:+o4vgswyoIOkWpopqhXJRzUD4EQ=
Date: Wed, 29 Jun 2016 00:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
■ 応答サンプル
HTTP/1.0 204 No Content
x-amz-request-id: 09a570c4-79ce-38ce-ad74-a85d9ae3b477
x-amz-version-id: 999122348912293847
オブジェクトストレージ APIリファレンス Delete Multiple Objects
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 42 富士通クラウドテクノロジーズ株式会社
Delete Multiple Objects
■ 処理概要
1回のリクエストで複数のオブジェクトを削除します。
■ バージョン管理
特定のバージョンのオブジェクトを削除するにはバージョン IDを指定します。
■ 指定するパラメーター
パラメーター 説明 必須
delete 複数オブジェクト削除の識別パラメータ
Type : なし
○
■ 指定するヘッダー
パラメーター 説明 必須
Content-MD5 Base64 エンコードしたリクエストペイロードの 128biy MD5ハッシュ値
Type : String
○
Content-Length リクエストペイロードの長さ
Type : String
○
■ 指定するボディ
フィールド 説明 必須
Delete Delete リクエストコンテナ
Type : Container
Ancestor : なし
Children : Quiet, Object
○
Quiet 無言モードを有効にする要素。標準で無効。
Type : Boolean
Ancestor : AccessControlPolicy
Children : なし
Default : false
Object Object要素コンテナ
Type : Container
Ancestor : Delete
Children : Key, VersionId
○
Key 削除するオブジェクトのキー
Type : String
Ancestor : Object
Children : なし
○
VersionId 削除するオブジェクトのバージョン ID
Type : String
Ancestor : Object
Children : なし
オブジェクトストレージ APIリファレンス Delete Multiple Objects
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 43 富士通クラウドテクノロジーズ株式会社
■ 応答フィールド
フィールド 説明
DeleteResult レスポンスコンテナ
Type : Container
Ancestor : なし
Children : Deleted, Error
Deleted 削除に成功したオブジェクトのコンテナ
Type : Container
Ancestor : DeleteResult
Children : Key, VersionId
Key 削除するオブジェクトのキー
Type : String
Ancestor : Deleted, or Error
Children : なし
VersionId 削除するオブジェクトのバージョン ID
Type : String
Ancestor : Deleted, or Error
Children : なし
DeleteMarker バージョニングが有効又は停止状態のオブジェクトに対する DeleteMarker の作
成又は削除の成功
Type : Boolean
Ancestor : Deleted
Children : なし
DeleteMarkerVersionId 作成/削除に成功したDeleteMarkerのバージョン ID
Type : String
Ancestor : Deleted
Children : なし
Error 削除に失敗したオブジェクトのコンテナ
Type : Container
Ancestor : DeleteResultr
Children : Key, VersionId, Code, Message
Code 削除失敗のステータスコード
Type : String
Ancestor :Error
Children : なし
Message エラーの詳細
Type : String
Ancestor : Error
Children : なし
オブジェクトストレージ APIリファレンス Delete Multiple Objects
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 44 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定なし)
POST /?delete= HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Content-MD5: ysiBzLdqO0j5teuCvSwhXw==
Content-Length: 171
Authorization: AWS 07cbb45fc128390123f4:+o4vgswyoIOkWpopqhXJRzUD4EQ=
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Object>
<Key>object1</Key>
</Object>
<Object>
<Key>object3</Key>
</Object>
<Object>
<Key>object5</Key>
</Object>
</Delete>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 33a3999d-b011-37d2-8a5e-2a750c2287df
Content-Length: 226
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Deleted>
<Key>object1</Key>
</Deleted>
<Deleted>
<Key>object3</Key>
</Deleted>
<Deleted>
<Key>object5</Key>
</Deleted>
</DeleteResult>
オブジェクトストレージ APIリファレンス Delete Multiple Objects
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 45 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定あり)
POST /?delete= HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Content-MD5: wMVoboys8VldzyDBgKFpDA==
Content-Length: 242
Authorization: AWS 07cbb45fc128390123f4:+o4vgswyoIOkWpopqhXJRzUD4EQ=
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Object>
<VersionId>xDGL9F4rCvRWtde5gbOQEtJvjuk.OrU</VersionId>
<Key>object6</Key>
</Object>
<Object>
<VersionId>Gjn24E2Nx0Dir3GBoRrGKbkOGPnYR</VersionId>
<Key>object8</Key>
</Object>
</Delete>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 33a3999d-b011-37d2-8a5e-2a750c2287df
Content-Length: 295
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Deleted>
<Key>object6</Key>
<VersionId>xDGL9F4rCvRWtde5gbOQEtJvjuk.OrU</VersionId>
</Deleted>
<Deleted>
<Key>object8</Key>
<VersionId>Gjn24E2Nx0Dir3GBoRrGKbkOGPnYR</VersionId>
</Deleted>
</DeleteResult>
オブジェクトストレージ APIリファレンス Put Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 46 富士通クラウドテクノロジーズ株式会社
Put Object acl
■ 処理概要
指定したオブジェクトに対して、アクセス権限を設定します。
■ バージョン管理
特定のバージョンに ACLを設定するには versionIdを指定します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
acl ACL リクエスト
値 : なし
○
versionId オブジェクトのバージョン ID
Type : int
999122348912293847
■ 指定するヘッダー
パラメーター 説明 必須 サンプル値
x-amz-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
■ 指定するボディ
フィールド 説明 サンプル値
AccessControlPolicy AccessControlPolicy リクエスト
Type : Container
Ancestor : なし
Children : Owner,AccessControlList
Owner Owner リクエスト
Type : Container
Ancestor : AccessControlPolicy
Children : ID,DisplayName
ID オーナーID
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
AccessControlList AccessControlList リクエスト
Type : Container
Ancestor : AccessControlPolicy
Children : Grant
オブジェクトストレージ APIリファレンス Put Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 47 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Grant Grant リクエスト
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : Grantee
Grantee Grantee リクエスト
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : ID,DisplayName
Permission アクセス権限
FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP
Type : xsd:string
Ancestor : AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
■ Grantee
設定対象ユーザーと指定は以下となります。
特定ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>Owner ID</ID>
<DisplayName>Owner DisplayName(Owner ID)</DisplayName>
</Grantee>
認証ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
未認証ユーザー
<Grantee xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AllUsers</URI>
</Grantee>
■ 応答フィールド
応答フィールドはありません。
オブジェクトストレージ APIリファレンス Put Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 48 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定なし)
PUT /sample.txt?acl 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:wW2I1mKrZhXwIGLBnGSgQ0XbACo=
Content-Length: 961
Content-Type: text/plain
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
<Permission>WRITE</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AllUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a
Content-Length: 0
オブジェクトストレージ APIリファレンス Put Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 49 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定あり)
PUT /sample.txt?acl&versionId=999122348912293847 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:wW2I1mKrZhXwIGLBnGSgQ0XbACo=
Content-Length: 961
Content-Type: text/plain
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
<Permission>WRITE</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.nifty.com/groups/global/AllUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a
x-amz-version-id: 999122348912293847
Content-Length: 0
オブジェクトストレージ APIリファレンス Get Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 50 富士通クラウドテクノロジーズ株式会社
Get Object acl
■ 処理概要
指定したオブジェクトのアクセス権限情報を取得します。
■ バージョン管理
特定のバージョンの ACLを取得するには versionIdを指定します
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
acl ACL リクエスト
値 : なし
○
versionId オブジェクトのバージョン ID
Type : int
999122348912293847
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
AccessControlPolicy AccessControlPolicyレスポンス
Type : Container
Ancestor : なし
Children : Owner,AccessControlList
Owner Ownerレスポンス
Type : Container
Ancestor : AccessControlPolicy
Children : ID,DisplayName
ID オーナーID
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : AccessControlPolicy.Owner |
AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
AccessControlList AccessControlListレスポンス
Type : Container
Ancestor : AccessControlPolicy
Children : Grant
オブジェクトストレージ APIリファレンス Get Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 51 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Grant Grantレスポンス
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : Grantee
Grantee Granteeレスポンス
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : ID,DisplayName
Permission アクセス権限
FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP
Type : xsd:string
Ancestor : AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
■ リクエストサンプル (versionId指定なし)
GET /sample.txt?acl 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:DqvngOELb9qE8e1fv8dKpH7b2fM=
■ 応答サンプル
HTTP/1.0 200 OK
Date: Wed, 29 Jun 2016 12:00:00 GMT
x-amz-request-id: c73be9cc-358d-3b50-b186-522a26da2ab9
Content-Length: 439
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Grantee><Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
オブジェクトストレージ APIリファレンス Get Object acl
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 52 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定あり)
GET /sample.txt?acl&versionId=999122348912293847 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:DqvngOELb9qE8e1fv8dKpH7b2fM=
■ 応答サンプル
HTTP/1.0 200 OK
Date: Wed, 29 Jun 2016 12:00:00 GMT
x-amz-request-id: c73be9cc-358d-3b50-b186-522a26da2ab9
x-amz-version-id: 999122348912293847
Content-Length: 439
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Grantee><Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
オブジェクトストレージ APIリファレンス Head Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 53 富士通クラウドテクノロジーズ株式会社
Head Object
■ 処理概要
指定したオブジェクトのヘッダー情報を取得します。
■ バージョン管理
特定のバージョンのヘッダー情報を取得するには versionIdを指定します
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versionId オブジェクトのバージョン ID
Type : int
999122348912293847
■ 指定するヘッダー
指定するヘッダーはありません。
■ 応答ヘッダー
ヘッダー 説明 必須 サンプル値
ETag オブジェクト ETag
Type : String
Last-Modified 最新更新時間
Type : Date
Wed, 29 Jun 2016 12:00:00
GMT
x-amz-meta- オブジェクトのメタデータ
Type : String
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル (versionId指定なし)
HEAD /sample.txt 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:yfKTKaeGW4LHJ0EWe8lIwFS5frM=
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 0A49CE4060975EAC
Date: Wed, 29 Jun 2016 12:00:00 GMT
Last-Modified: Wed, 29 Jun 2016 12:00:00 GMT
ETag: 62cff0140e0931c345c25795689032ca
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
Content-Length: 138
オブジェクトストレージ APIリファレンス Head Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 54 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル (versionId指定あり)
HEAD /sample.txt?versionId=999122348912293847 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:yfKTKaeGW4LHJ0EWe8lIwFS5frM=
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 0A49CE4060975EAC
x-amz-version-id: 999122348912293847
Date: Wed, 29 Jun 2016 12:00:00 GMT
Last-Modified: Wed, 29 Jun 2016 12:00:00 GMT
ETag: 62cff0140e0931c345c25795689032ca
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
Content-Length: 138
オブジェクトストレージ APIリファレンス Options Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 55 富士通クラウドテクノロジーズ株式会社
Options Object
■ 処理概要
対象のオブジェクトがリクエストに対応した CORSを許可しているかどうか確認します。
■ 指定するパラメーター
必要なパラメーターはありません。プリフライトリクエストの後に実行するリクエストにパラメーターが必要であれば、このリクエストに含
める必要があります。
■ 指定するヘッダー
フィールド 説明 必須 サンプル値
Origin オリジンのURL
Type : xsd:string
Default : None
○
http://www.example.com
Access-Control-Request-Method リクエストで利用するHTTP メソッド
Type : xsd:string
Default : None
○ GET
Access-Control-Request-Headers リクエストで利用するヘッダーの
カンマ区切りリスト
Type : xsd:string
Default : None
x-amz-server-side-encryption
■ 指定するボディ
指定するボディはありません。
■ 応答ヘッダー
フィールド 説明 サンプル値
Access-Control-Allow-
Origin
リクエストで指定したOriginサーバーのURL
指定したOriginサーバーが許可されていない場合には
このヘッダーは返却されない
Type : String
http://www.exapmle.com
Access-Control-Max-Age リクエストの結果がキャッシュされる時間(秒)
Type : String
1500
Access-Control-Allow-
Methods
リクエストで指定した Access-Control-Request-Methods
許可されていないメソッドを指定した場合はこのヘッダーは
返却されない
Type : String
GET
Access-Control-Allow-
Headers
リクエストで指定した Access-Control-Request-Headers
いくつかのヘッダーが許可されていない場合、そのヘッダーはレス
ポンスに含まれない
Type : String
x-amz-server-side-encryption
Access-Control-Expose-
Headers
実際のリクエストに対してレスポンスされるヘッダーのカンマ区切り
リスト
Type : String
Etag
■ 応答フィールド
応答フィールドはありません。
オブジェクトストレージ APIリファレンス Options Object
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 56 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル
OPTIONS /sample.txt HTTP/1.1
Host: my-first-w-bucket.jp-east-2.os.cloud.nifty.com
Date: Mon, 03 July 2017 00:00:00 GMT
Origin: http://www.example.com
Access-Control-Request-Method: GET
Access-Control-Request-Headers: x-amz-server-side-encryption,x-amz-hogehoge
Authorization: <Authorization String>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
Content-Length: 0
Access-Control-Allow-Headers: x-amz-server-side-encryption
Access-Control-Expose-Headers: ETag
Access-Control-Max-Age: 1500
Date: Tue, 06 Jun 2017 06:02:48 GMT
Access-Control-Allow-Origin: http://www.example.com
Access-Control-Allow-Methods: GET
オブジェクトストレージ APIリファレンス Put Object - Copy
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 57 富士通クラウドテクノロジーズ株式会社
Put Object - Copy
■ 処理概要
指定したオブジェクトを任意のバケットにコピーします。
アクセス権限はコピー元オブジェクト、コピー先バケットの権限に依存します。
以下の場合のみコピー可能となります。
コピー元オブジェクトに対し、読み込み権限がある
コピー先バケットに対し、書き込み権限がある
x-amz-metadata-directiveヘッダーに REPLACEを指定した場合、コピー元オブジェクトに登録されていたメタデータは引き継がれ
ず、x-amz-meta-ヘッダーで指定したメタデータのみが登録されます。
REPLACEを指定し、x-amz-meta-ヘッダーを指定しなかった場合、メタデータは何も登録されません。
サイズの大きいオブジェクトをコピーする場合、処理に時間がかかることがあります。その間にタイムアウトなどで接続が切断されて
しまった場合、応答を受け取ることができませんので、ご注意ください。
■ バージョン管理
コピー先バケットにバージョニング設定がされている場合、コピー先オブジェクトはバージョン管理されます。
また、コピー元バケットがバージョニング設定されている場合、コピー元オブジェクトの versionIdを指定することで特定バー
ジョンのコピーが行えます。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
versionId オブジェクトのバージョン ID
Type : int
999122348912293847
■ 指定するヘッダー
パラメーター 説明 必須 サンプル値
x-amz-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
x-amz-copy-source コピー元オブジェクトのロケーション
Type : String
○ /bucket/sample.txt
x-amz-metadata-directive メタデータのコピー方式
コピーするか、設定したメタデータで置き換えるかを
指定
Type : String
Default : COPY
値 : COPY | REPLACE
x-amz-meta- オブジェクトのメタデータ
x-amz-metadata-directiveに REPLACEを指定した場
合のみ有効です。
Type : String
オブジェクトストレージ APIリファレンス Put Object - Copy
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 58 富士通クラウドテクノロジーズ株式会社
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
CopyObjectResult CopyObjectResultレスポンス
Type : Container
Ancestor : なし
Children : ETag, LastModified,
ETag オブジェクト ETag
Type : xsdstring
Ancestor : CopyObjectResult
Children : なし
LastModified 最新更新時間
Type : xsddate
Ancestor : CopyObjectResult
Children : なし
2012-01-17T00:00:00.245Z
■ リクエストサンプル (コピー元オブジェクトの versionId指定なし)
PUT /sample-copy.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-copy-source: /my-first-bucket/sample.txt
x-amz-metadata-directive: REPLACE
Authorization: AWS 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 0
Content-Type: application/x-form-urlencoded; charset=utf-8
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
■ リクエストサンプル (コピー元オブジェクトの versionId指定あり)
PUT /sample-copy.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-acl: private
x-amz-copy-source: /my-first-bucket/sample.txt?versionId=999122348912293847
x-amz-metadata-directive: REPLACE
Authorization: AWS 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 0
Content-Type: application/x-form-urlencoded; charset=utf-8
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
オブジェクトストレージ APIリファレンス Put Object - Copy
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 59 富士通クラウドテクノロジーズ株式会社
■ 応答サンプル
HTTP/1.0 200 OK
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-request-id: 025c3b8d-934a-38f3-ae0f-1ab2d417b514
x-amz-copy-source-version-id: 999122348912293847
Content-Type: application/xml;charset=UTF-8
Content-Length: 185
<CopyObjectResult>
<LastModified>2016-06-29T00:00:00.245Z</LastModified>
<ETag>"6984c2483f45718ba145956e46018834"</ETag>
</CopyObjectResult>
オブジェクトストレージ APIリファレンス Initiate Multipart Upload
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 60 富士通クラウドテクノロジーズ株式会社
Initiate Multipart Upload
■ 処理概要
マルチアップロードの初期化を行います。
マルチアップロード IDがレスポンスとして返却されます。
マルチアップロードの各リクエストを実行する際に、返却されたマルチアップロード IDを指定します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
uploads マルチアップロードリクエスト
値 : なし
○
■ 指定するヘッダー
ヘッダー 説明 必須 サンプル値
Content-Type MIMEタイプ
Type : String
x-amz-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
x-amz-meta- メタデータ
Type : String
■ 指定するボディ
指定するボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
InitiateMultipartUploadResult InitiateMultipartUploadResultレスポンス
Type : Container
Ancestor : なし
Children : Bucket, Key, UploadId
Bucket バケット名
Type : xsd:string
Ancestor : InitiateMultipartUploadResult
Children : なし
Key オブジェクト名
Type : xsd:string
Ancestor : InitiateMultipartUploadResult
Children : なし
UploadId アップロード ID
Type : xsd:string
Ancestor : InitiateMultipartUploadResult
Children : なし
オブジェクトストレージ APIリファレンス Initiate Multipart Upload
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 61 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル
POST /multiupload.txt?uploads 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:XOyKwveYgHTC9gnErjK0CGbOwjc=
■ 応答サンプル
<InitiateMultipartUploadResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Bucket>my-first-bucket</Bucket>
<Key>multiupload.txt</Key>
<UploadId>uEGlWLAqlSA5h+nOCaWZ44wiESTAhGEzIhaemyCE13wM3lfEGRNEHBZSuN</UploadId>
</InitiateMultipartUploadResult>
オブジェクトストレージ APIリファレンス Upload part
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 62 富士通クラウドテクノロジーズ株式会社
Upload part
■ 処理概要
マルチアップロードの分割データを保存します。
初期化リクエストにより取得したマルチアップロード IDを指定し、リクエストを実行します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
partNumber 分割番号
Type : Int
○
uploadId マルチアップロード ID
Type : String
○ uEGlWLAqlSA5h+nOCaWZ
44wiESTAhGEzIhaemyCE
13wM3lfEGRNEHBZSuN
■ 指定するヘッダー
ヘッダー 説明 必須 サンプル値
Content-Length 分割データサイズ
Type : String
Content-MD5 分割データのMD5ダイジェスト
Type : String
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
PUT /multiupload.txt?uploadId=uEGlWLAqlSA5h+nOCaWZ44wiESTAhGEzIhaemyCE13wM3lfEGRNEHBZSuN
&partNumber=1
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:4YBcRkQTSIbWA/0UQ89WAn0sByg=
Content-Length: 55085782
<Part Data>
■ 応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 5fff018c-52a6-30da-ab83-e4cd82ba0814
ETag: bf22794161d55270a3d71167e8a0a9fa
Content-Length: 0
オブジェクトストレージ APIリファレンス Complete Multipart Upload
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 63 富士通クラウドテクノロジーズ株式会社
Complete Multipart Upload
■ 処理概要
マルチアップロードの完了を行います。
マルチアップロード IDで関連づけられた分割データを結合します。
すべての分割データをアップロードした後、各分割データの分割番号と ETagをリストにしてリクエストを実行します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
uploadId マルチアップロード ID
Type : String
○ uEGlWLAqlSA5h+nOCaWZ
44wiESTAhGEzIhaemyCE
13wM3lfEGRNEHBZSuN
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
フィールド 説明 サンプル値
CompleteMultipartUpload CompleteMultipartUpload リクエスト
Type : Container
Ancestor : なし
Children : Part
Part CompleteMultipartUpload リクエスト
Type : Container
Ancestor : CompleteMultipartUpload
Children : PartNumber, ETag
PartNumber 分割番号
Type : xsd:int
Ancestor : CompleteMultipartUpload
Children : なし
ETag 分割データのMD5ダイジェスト
Type : xsd:string
Ancestor : CompleteMultipartUpload
Children : なし
■ 応答フィールド
フィールド 説明 サンプル値
CompleteMultipartUploadResult CompleteMultipartUploadResultレスポンス
Type : Container
Ancestor : なし
Children : requestId, return
Location オブジェクトURI
Type : xsd:string
Ancestor : CompleteMultipartUploadResult
Children : なし
オブジェクトストレージ APIリファレンス Complete Multipart Upload
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 64 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Bucket バケット名
Type : xsd:string
Ancestor : CompleteMultipartUploadResult
Children : なし
Key オブジェクト名
Type : xsd:string
Ancestor : CompleteMultipartUploadResult
Children : なし
ETag オブジェクト ETag
Type : xsd:string
Ancestor : CompleteMultipartUploadResult
Children : なし
■ リクエストサンプル
POST /multipart.txt?uploadId=uEGlWLAqlSA5h+nOCaWZ44wiESTAhGEzIhaemyCE13wM3lfEGRNEHBZSuN
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:tI9K7/3UMg4AF/g1AGjcAIr5dLQ=
Content-Length: 471
Content-Type: text/plain
<CompleteMultipartUpload>
<Part>
<PartNumber>1</PartNumber>
<ETag>1f2d6c7ece3ed586af312fe1a23db358</ETag>
</Part>
<Part>
<PartNumber>2</PartNumber>
<ETag>66bceb9c17dad05ca8bd34ac723bb505</ETag>
</Part>
<Part>
<PartNumber>3</PartNumber>
<ETag>bf22794161d55270a3d71167e8a0a9fa</ETag>
</Part>
<Part>
<PartNumber>4</PartNumber>
<ETag>78f5a9e90ab191d5ffe0a4d3e0f1fbec</ETag>
</Part>
<Part>
<PartNumber>5</PartNumber>
<ETag>1a9c3b7fd2ead663b3fa6c969c61a735</ETag>
</Part>
</CompleteMultipartUpload>
■ 応答サンプル
<CompleteMultipartUploadResult xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Location>my-first-bucket/multiupload.txt</Location>
<Bucket>my-first-bucket</Bucket>
<Key>multiupload.txt</Key>
<ETag>"62cff0140e0931c345c25795689032ca"</ETag>
</CompleteMultipartUploadResult>
オブジェクトストレージ APIリファレンス Abort Multipart Upload
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 65 富士通クラウドテクノロジーズ株式会社
Abort Multipart Upload
■ 処理概要
マルチアップロードの破棄を行います。
マルチアップロード IDで関連づけられたすべての分割データを破棄します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
uploadId マルチアップロード ID
Type : String
○ uEGlWLAqlSA5h+nOCaWZ
44wiESTAhGEzIhaemyCE
13wM3lfEGRNEHBZSuN
■ 指定するヘッダー
必要なヘッダーはありません。
■ 応答フィールド
応答フィールドはありません。
■ リクエストサンプル
DELETE /multipart.txt?uploadId=uEGlWLAqlSA5h+nOCaWZ44wiESTAhGEzIhaemyCE13wM3lfEGRNEHBZSuN
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
Content-Length: 0
オブジェクトストレージ APIリファレンス List Parts
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 66 富士通クラウドテクノロジーズ株式会社
List Parts
■ 処理概要
マルチアップロード IDに紐づく分割データ一覧を取得します。
分割ファイルのアップロード状況を確認できます。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
uploadId マルチアップロード ID
Type : String
○ uEGlWLAqlSA5h+nOCaWZ
44wiESTAhGEzIhaemyCE
13wM3lfEGRNEHBZSuN
max-parts 最大一覧表示数
Type : Int
Default : 1000
part-number-marker 検索開始パーツ番号
Type : Int
Default : なし
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
ListPartsResult listPartsレスポンス
Type : Container
Ancestor : なし
Children : Bucket,Key,UploadId,Initiator,Owner,StorageClass
PartNumberMarker,NextPartNumberMarker,MaxParts,
IsTruncated,Part
Bucket バケット名
Type : xsd:string
Ancestor : ListPartsResult
Children : なし
Key オブジェクト名
Type : xsd:string
Ancestor : ListPartsResult
Children : なし
UploadId アップロード ID
Type : xsd:string
Ancestor : ListPartsResult
Children : なし
オブジェクトストレージ APIリファレンス List Parts
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 67 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
Initiator Initiatorレスポンス
Type : Container
Ancestor : ListPartsResult
Children : ID,DsiplayName
Owner Ownerレスポンス
Type : Container
Ancestor : ListPartsResult
Children : ID,DisplayName
ID オーナーID
Type : xsd:string
Ancestor : Initiator | Owner
Children : なし
DisplayName オーナー名
Type : xsd:string
Ancestor : Initiator | Owner
Children : なし
StorageClass ストレージ分類
(STANDARD固定)
Ancestor : ListPartsResult
Children : なし
PartsNumberMaker 次回一覧検索パーツ番号
Type : xsd:int
Ancestor : ListPartsResult
Children : なし
isTruncated 全結果取得フラグ
リクエスト件数がすべて返却できたかどうか
Type : xsd:boolean
Ancestor : ListPartsResult
Children : なし
true(返却できていない)
false(返却できている)
Part Partレスポンス
Type : Container
Ancestor : ListPartsResult
Children : PartNumber,LastModified,ETag,Size
PartNumber 分割データパーツ番号
Type : xsd:int
Ancestor : Part
Children : なし
LastModified 最終更新日時
Type : xsd:date
Ancestor : Part
Children : なし
ETag オブジェクト ETag
Type : xsd:string
Ancestor : Part
Children : なし
Size
分割データサイズ
Type : xsd:int
Ancestor : Part
Children : なし
オブジェクトストレージ APIリファレンス List Parts
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 68 富士通クラウドテクノロジーズ株式会社
■ リクエストサンプル
GET /multipart.txt?max-parts=1000&&part-number-marker=1001
uploadId=uEGlWLAqlSA5h+nOCaWZ44wiESTAhGEzIhaemyCE13wM3lfEGRNEHBZSuN HTTP/1.1
Authorization: AWS 00c8a23f7940bfaa4861:WtZXExA16K2fFxbQ8r5RCRb6Pc4=
Date: Wed, 29 Jun 2016 00:00:00 GMT
Host: my-first-bucket.jp-east-2.os.cloud.nifty.com
■ 応答サンプル
HTTP/1.0 200 OK
Date: Wed, 29 Jun 2016 00:00:00 GMT
x-amz-request-id: 47f6bbcb-b3ba-3a04-b16b-27a977f5ea16
Content-Length: 636
<ListPartsResult>
<Bucket>my-first-bucket/Bucket>
<Key> multipart.txt</Key>
<UploadId>uEGlWLAqlSA5h+nOCaWZ44wiESTAhGEzIhaemyCE13wM3lfEGRNEHBZSuN</UploadId>
<Initiator>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Initiator>
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<PartNumberMarker>2499</PartNumberMarker>
<IsTruncated>false</IsTruncated>
<Part>
<PartNumber>2500</PartNumber>
<LastModified>2012-03-05T06:22:19.431Z</LastModified>
<ETag>"3b98e2dffc6cb06a89dcb0d5c60a0206"</ETag>
<Size>2</Size>
</Part>
</ListPartsResult>
オブジェクトストレージ APIリファレンス List Multipart Uploads
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 69 富士通クラウドテクノロジーズ株式会社
List Multipart Uploads
■ 処理概要
進行中のマルチパートアップロードを取得します。
■ 指定するパラメーター
パラメーター 説明 必須 サンプル値
delimiter 区切り文字列
Type : String
%2F (/ スラッシュ)
max-uploads 最大一覧表示数
Type : Int
Default : 1000
key-marker 検索開始キー
Type : Int
Default : なし
prefix 前方一致文字列
Type : String
upload-id-marker upload-idの開始位置を指定
key-markerが一致したら有効
Type : String
■ 指定するヘッダー
必要なヘッダーはありません。
■ 指定するボディ
必要なボディはありません。
■ 応答フィールド
フィールド 説明 サンプル値
ListMultipartUploadsResult listPartsレスポンス
Type : Container
Ancestor : なし
Children : Bucket,Key,UploadId,Initiator,Owner,StorageClass
PartNumberMarker,NextPartNumberMarker,MaxParts,
IsTruncated,Part
Bucket バケット名
Type : xsd:string
Ancestor : ListPartsResult
KeyMarker 指定した開始文字列
Type : xsdstring
Ancestor : ListMultipartUploadsResult.
UploadIdMarker 指定した開始アップロード ID
Type : xsd:string
Ancestor : ListPartsResult
オブジェクトストレージ APIリファレンス List Multipart Uploads
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 70 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
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
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 71 富士通クラウドテクノロジーズ株式会社
フィールド 説明 サンプル値
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
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 72 富士通クラウドテクノロジーズ株式会社
<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リファレンス 制限事項
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 73 富士通クラウドテクノロジーズ株式会社
付 録
制限事項
■ バケット格納オブジェクト数
各バケットに格納可能なオブジェクト数は下記の通りです。
20,000,000 オブジェクト / バケット
■ バケット名命名規則
バケット名は以下の規則に準拠する必要があります。
文字数は 3文字から 63文字以内
利用文字は 小文字英数字、ピリオド(.)、ハイフン(-)
始まりの文字が英数字
末尾の文字がハイフン(-)でない
ピリオド(.)が連続しない
ピリオド(.)とハイフン(-)が連続しない
IPアドレス形式でない
■ オブジェクト名命名規則
オブジェクト名は以下の規則に準拠する必要があります。
オブジェクト名をURLエンコードし、リクエストする必要があります。
■ リクエスト数推奨値
APIのリクエスト頻度の推奨値は下記の通りです。
50 リクエスト / 秒
推奨値を超えた場合、エラー応答(503 Slow Down)を返す場合があります。
オブジェクトストレージ APIリファレンス ACL
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 74 富士通クラウドテクノロジーズ株式会社
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リファレンス 共通エラーレスポンスステータス
Copyright (c) FUJITSU CLOUD TECHNOLOGIES LIMITED All Rights
Reserved. 75 富士通クラウドテクノロジーズ株式会社
共通エラーレスポンスステータス
HTTP
ステータスコード
REST API
エラーコード 原因
400 InvalidArgument 不正な引数の指定。
400 InvalidDigest 不正なダイジェストの指定。
400 BadDigest 指定された Content-MD5値の不整合。
400 InvalidBucketName 不正なバケット名の指定。
400 InvalidObjectName 不正なオブジェクト名の指定。
400 UnresolvableGrantByEmailAddress 存在しない emailアドレスの指定。
400 InvalidPart 不正なパーツの指定。
400 InvalidPartOrder パーツの順番が不正です。
400 RequestTimeout リクエストタイムアウト。
400 EntityTooLarge オブジェクトのサイズ上限値違反。
400 Bad Request
リクエストが誤っているか、リクエストが
途中で切断された可能性があります。
時間を置いたリトライで解消する場合が
あります。
403 AccessDenied アクセス拒否。
403 UserSuspended このユーザーは現在利用できません。
403 RequestTimeTooSkewed リクエストの時刻がサーバーの時刻から離
れすぎています。
403 SignatureDoesNotMatch Signatureの値がリクエストの内容と合致し
ません。
404 NoSuchKey 存在しないオブジェクトの指定。
404 NoSuchBucket 存在しないバケットの指定。
404 NoSuchUpload
存在しないアップロード ID の指定。
アップロード ID が誤っているか、マルチア
ップロードが完了もしくは中断された可
能性があります。
405 MethodNotAllowed 許可されていない操作。
408 RequestTimeout リクエストがタイムアウトしました。
409 BucketAlreadyExists 要求されたバケット名の利用不可。すでに
指定されたバケット名は存在しています。
409 BucketNotEmpty オブジェクトが存在するバケットの削除不
可。
411 MissingContentLength Content-Length の未指定。
412 PreconditionFailed 指定された条件に一致するものがありま
せん。
416 InvalidRange 不正な Range 付きリクエストの指定。
422 UnprocessableEntity 処理できないエンティティ。
500 InternalError 内部エラー。
時間を置いてリトライしてください。
502 Bad Gateway 内部エラー。
時間を置いてリトライしてください。
503 Service Unavailable 内部エラー。
時間を置いてリトライしてください。
503 Slow Down アクセス過多。
アクセス頻度を減らしてください。