Put Object Tagging

オブジェクトにタグ情報を付与します。タグ情報は上書きされます。

APIエンドポイント

リージョン	APIエンドポイント
西日本リージョン3の場合	https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI

PUT

/{bucket}/{object}?tagging

HTTPステータスコード

正常時：200

エラー時：400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503

リクエストパラメータの説明

名前	In	Type	デフォルト値 /必須指定	Description
Bucket	path	string	必須	バケット名
Object	path	string	必須	オブジェクト名
versionId	query	string	任意	バージョンID バージョニング設定が有効なバケット内の特定バージョンのオブジェクトを指定する場合は必須
x-amz-content-sha256	header	string	必須	ペイロード全体の計算されたSHA256チェックサム
x-amz-date	header	string	必須	リクエスト側で生成した現在日時
Authorization	header	string	必須	リクエスト認証に用いる文字列
Content-Length	header	string	必須	リクエストボディのバイト数
Content-MD5	header	string	任意	リクエストボディのMD5ハッシュ値をbase64エンコードした文字列
Tagging	body	container	必須	TagSet要素とTag要素のコンテナ
TagSet	body	container	必須	タグを格納するコンテナ
Tag	body	container	任意	タグ情報を格納するコンテナ
Value	body	string	任意	タグの値(最大10個)
Key	body	string	任意	タグ名(最大10個)

レスポンスヘッダーの説明

名前	Type	Description
Date	string	トランザクションが実行された日時
Content-Length	string	レスポンスボディのバイト数
Connection	string	持続接続の状態を表示します。
x-amz-request-id	string	このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。
x-amz-id-2	string	このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。
x-ntap-sg-trace-id	string	このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。
x-amz-version-id	string	オブジェクトのバージョン
X-Fcx-Endpoint-Request	string	APIエンドポイントとしてリクエストを受け付けたことを示す番号

リクエスト例１

リクエストヘッダー

PUT /general-bucket/object_data_1?tagging HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190604T061646Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-3/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=ecec0212b510e74dce35f76ca715758b7f620843aaf0f8c68ae968ed9032c24c
Content-Length: 115
Content-Type: application/x-www-form-urlencoded

リクエストボディ

<Tagging>
  <TagSet>
    <Tag>
      <Value>Object1-value</Value>
      <Key>Object-1</Key>
    </Tag>
    <Tag>
      <Value>Object2-value</Value>
      <Key>Object-2</Key>
    </Tag>
  </TagSet>
</Tagging>

レスポンス例１

HTTP/1.1 200 OK
Date: Tue, 04 Jun 2019 06:16:46 GMT
Content-Length: 0
Connection: keep-alive
x-amz-request-id: 746377448
x-amz-id-2: 12174498
x-ntap-sg-trace-id: 720c76952c415e65
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-28853-844076-1_200

リクエスト例２（versionIdを指定する場合）

リクエストヘッダー

PUT /general-bucket2/object_data_1?tagging=&versionId=MjYwRTU5QzAtRjBGNi0xMUVCLTkzRTAtN0UyNTAwQzVDRjUx HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.management.jp-east-3.local
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20210805T074728Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20210805/us-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=d733f62bbcfafc5bf9b5068f3f739d05fb447c08cf691a6921b4064f36a5482d
Content-Length: 115
Content-Type: application/x-www-form-urlencoded

リクエストボディ

<Tagging>
  <TagSet>
    <Tag>
      <Value>Object1-value</Value>
      <Key>Object-1</Key>
    </Tag>
    <Tag>
      <Value>Object2-value</Value>
      <Key>Object-2</Key>
    </Tag>
  </TagSet>
</Tagging>

レスポンス例２（versionIdを指定する場合）

HTTP/1.1 200 OK
Date: Thu, 05 Aug 2021 07:47:28 GMT
Content-Length: 0
Connection: keep-alive
x-amz-request-id: 1628149648846081
x-amz-id-2: 12861004
x-amz-version-id: MjYwRTU5QzAtRjBGNi0xMUVCLTkzRTAtN0UyNTAwQzVDRjUx
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-28125-21007400-1_200