本文へジャンプします。

ニフクラ ユーザーガイド

GetObjectTagging

処理概要

オブジェクトのタグ情報を表示します。

リクエストURL

GET /{Bucket}/{Object}?tagging

指定するパラメーター

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

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


応答フィールド

レスポンスヘッダー
フィールド (項目) 説明
Date string トランザクションが実行された日時
Content-Type string オブジェクトのMIME Typeの種類
Content-Length string レスポンスボディのバイト数
Connection string 持続接続の状態を表示します。
x-amz-request-id string

このリクエストに付与されるID
トラブルについて問い合わせる際に利用されます。


x-amz-id-2 string

このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。


x-amz-version-id string オブジェクトのバージョン
x-ntap-sg-trace-id string

このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。


X-Fcx-Endpoint-Request string APIエンドポイントとしてリクエストを受け付けたことを示す番号
レスポンスボディ
フィールド (項目) 説明
Tagging structure TagSet要素のコンテナ
TagSet structure タグを格納するコンテナ
Tag structure タグ情報を格納するコンテナ
Key string タグの名前
Value string タグの値

リクエストサンプル

リクエスト例1
    GET /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:20190604T061707Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=e1fbcd0c628768256119c0fb36afa73994ddc9b5f1718a11c2bf297756d1d549

  
リクエスト例2(versionIdを指定する場合)
    GET /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:20210805T074751Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20210805/jp-west-2/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=169ead706dd39fd2225cd6a4b79a01a104cdf788c1fdecd75b2724da09a43dac

  

応答サンプル

レスポンス例1
    HTTP/1.1 200 OK
Date: Tue, 04 Jun 2019 06:17:07 GMT
Content-Type: application/xml
Content-Length: 201
Connection: keep-alive
x-amz-request-id: 2785941644
x-amz-id-2: 12174498
x-ntap-sg-trace-id: d8db074c360debe5
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-1.local-28849-844259-1_200

<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <TagSet>
    <Tag>
      <Key>Object-1-key</Key>
      <Value>Object-1-value</Value>
    </Tag>
    <Tag>
      <Key>Object-2-key</Key>
      <Value>Object-2-value</Value>
    </Tag>
  </TagSet>
</Tagging>

  
レスポンス例2(versionIdを指定する場合)
    HTTP/1.1 200 OK
Date: Thu, 05 Aug 2021 07:47:51 GMT
Content-Type: application/xml
Content-Length: 201
Connection: keep-alive
x-amz-request-id: 1628149671539779
x-amz-id-2: 12000889
x-amz-version-id: MjYwRTU5QzAtRjBGNi0xMUVCLTkzRTAtN0UyNTAwQzVDRjUx
X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.management.jp-west-2.local-25423-10417584-1_200

<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <TagSet>
    <Tag>
      <Key>Object-1-key</Key>
      <Value>Object-1-value</Value>
    </Tag>
    <Tag>
      <Key>Object-2-key</Key>
      <Value>Object-2-value</Value>
    </Tag>
  </TagSet>
</Tagging>

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

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