この操作を呼び出して、オブジェクトのタグを照会できます。
バージョン管理
既定では、GetObjectTaggingを呼び出してオブジェクトのタグを照会すると、オブジェクトの現在のバージョンのタグのみが返されます。 リクエストでversionIdパラメーターを指定して、指定したバージョンのオブジェクトのタグを照会できます。 オブジェクトの現在のバージョンが削除マーカーである場合、OSSは404 Not Foundを返します。
リクエストの構造
GET /objectname? タグ付け
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: 3月20日水2019 02:02:36GMT
権限付与: SignatureValue
リクエストヘッダー
GetObjectTaggingリクエストには、共通のリクエストヘッダーのみが含まれます。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
GetObjectTagging要求に対する応答には、共通の応答ヘッダーのみが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 説明 |
タギング | Container | タグのコレクションを格納するために使用されるコンテナー。 子ノード: TagSet |
タグセット | Container | タグのコレクション。 親ノード: タグ付け 子ノード: タグ |
タグ | Container | タグのコレクション。 親ノード: TagSet 子ノード: キーと値 |
Key | String | オブジェクトタグのキー。 親ノード: タグ 子ノード: なし |
値 | String | オブジェクトタグの値。 親ノード: タグ 子ノード: なし |
例
- バージョン管理されていないバケット内のオブジェクトのタグを照会します。
この例では、objectnameという名前のオブジェクトは、bucketnameという名前の未バージョンのバケットに格納されます。 GetObjectTagging要求は、objectnameの {A: 1} および {b:2} タグを照会するために送信される。 オブジェクトのタグが取得された後、200 OKが返されます。
GET /objectname? タグ付けのサンプルリクエストホスト: BucketName.oss-cn-hangzhou.aliyuncs.com 日付: 3月20日水2019 02:02:36GMT 承認: OSS qn6qrrqxo2oawuk53otf ****:kZoYNv66bsmc10 + dcGKw5x2P ****
200のサンプル応答(OK) content-length: 209 server: AliyunOSS x-oss-request-id: 5C919F38461FB4282600 **** 日付: 3月20日水2019 02:02:32GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <タグ付け> <TagSet> <タグ> <キー> a</キー> <値> 1</値> </Tag> <タグ> <キー> b</キー> <値> 2</値> </タグ> </タグセット> </タグ付け>
- バージョン管理されたバケット内のオブジェクトのタグを照会します。
この例では、objectnameという名前のオブジェクトがbucketnameという名前のバージョン付きバケットに格納されます。 GetObjectTaggingリクエストは、objectnameの指定されたバージョンの {age:18} タグを照会するために送信されます。 オブジェクトの指定されたバージョンのタグが取得されると、200 OKが返されます。
サンプルリクエストのGET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0 **** ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com 日付: 6月24日水2020 08:50:28 GMT 権限付与: OSS ************:********************
200のサンプル応答(OK) content-length: 161 server: AliyunOSS x-oss-request-id: 5EF313D44506783438F3 **** 日付: 6月24日水2020 08:50:28 GMT content-type: application/xml x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0 **** <?xml version="1.0" encoding="UTF-8"?> <タグ付け> <TagSet> <タグ> <キー> 年齢 </キー> <値> 18</値> </タグ> </タグセット> </タグ付け>
SDK
次のプログラミング言語のOSS SDKを使用して、GetObjectTaggingを呼び出すことができます。
エラーコード
エラーコード | HTTPステータスコード | 説明 |
FileAlreadyExists | 409 | タグ設定を照会するオブジェクトが、階層名前空間機能が有効になっているバケット内のディレクトリである場合に返されるエラーメッセージ。 |