本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/object-storage-service/api/PutObjectTagging.htmへ移行しました。 今後は新ページをご参照ください。

PutObjectTagging

処理概要

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

リクエストURL

PUT /{Bucket}/{Object}?tagging

指定するパラメーター

ヘッダーパラメーター
パラメーター 説明 必須
x-amz-content-sha256 string ペイロード全体の計算されたSHA256チェックサム
x-amz-date string リクエスト側で生成した現在日時
Authorization string リクエスト認証に用いる文字列
Content-Length string リクエストボディのバイト数
Content-MD5 string リクエストボディのMD5ハッシュ値をbase64エンコードした文字列
パスパラメーター
パラメーター 説明 必須
Bucket string バケット名
Object string オブジェクト名
クエリパラメーター
パラメーター 説明 必須
versionId string

バージョンID
バージョニング設定が有効なバケット内の特定バージョンのオブジェクトを指定する場合は必須


リクエストボディ
パラメーター 説明 必須
Tagging structure TagSet要素とTag要素のコンテナ
TagSet structure タグを格納するコンテナ
Tag structure タグ情報を格納するコンテナ
Value string タグの値(最大10個)
Key string タグ名(最大10個)

応答フィールド

レスポンスヘッダー
フィールド (項目) 説明
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エンドポイントとしてリクエストを受け付けたことを示す番号

リクエストサンプル

リクエスト例1
    PUT /general-bucket/object_data_1?tagging HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190604T061646Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-1/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>

  
リクエスト例2(versionIdを指定する場合)
    PUT /general-bucket2/object_data_1?tagging=&versionId=MjYwRTU5QzAtRjBGNi0xMUVCLTkzRTAtN0UyNTAwQzVDRjUx HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-west-2.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20210805T074728Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20210805/jp-west-2/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>

  

応答サンプル

レスポンス例1
    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-1.local-28853-844076-1_200

  
レスポンス例2(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-west-2.local-28125-21007400-1_200

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上