この操作を呼び出して、指定されたオブジェクトのタグを削除できます。
バージョン管理
デフォルトでは、DeleteObjectTagging を呼び出してオブジェクトのタグを削除すると、オブジェクトの現在のバージョンのタグが削除されます。 リクエストで versionId パラメーターを指定して、オブジェクトの特定のバージョンのタグを削除できます。 オブジェクトの現在のバージョンが削除マーカーの場合、OSS は 404 Not Found を返します。
権限
デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールは、デフォルトでは権限を持ちません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを使用して操作権限を付与する必要があります。
API | アクション | 定義 |
DeleteObjectTagging | oss:DeleteObjectTagging | オブジェクトのタグを削除します。 |
oss:DeleteObjectVersionTagging | オブジェクトの特定のバージョンのタグを削除します。 |
リクエスト構造
DELETE /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValueリクエストヘッダー
DeleteObjectTagging リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
DeleteObjectTagging リクエストへのレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
バージョン管理されていないバケット内のオブジェクトのタグを削除します。
この例では、objectname という名前のオブジェクトが、bucketname という名前のバージョン管理されていないバケットに格納されています。 DeleteObjectTagging リクエストが送信され、objectname のすべてのタグが削除されます。
リクエストの例
DELETE /objectname?tagging Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Tue, 09 Apr 2019 03:00:33 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eレスポンスの例
204 (No Content) content-length: 0 server: AliyunOSS x-oss-request-id: 5CAC0AD16D0232E2051B**** date: Tue, 09 Apr 2019 03:00:33 GMTバージョン管理されたバケット内のオブジェクトのタグを削除します。
この例では、objectname という名前のオブジェクトが、bucketname という名前のバージョン管理されたバケットに格納されています。 DeleteObjectTagging リクエストが送信され、objectname の特定のバージョンのすべてのタグが削除されます。
リクエストの例
DELETE /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0**** Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Wed, 24 Jun 2020 09:01:09 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eレスポンスの例
204 (No Content) content-length: 0 server: AliyunOSS x-oss-request-id: 5EF3165525D95C3338E8**** date: Wed, 24 Jun 2020 09:01:09 GMT x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
OSS SDK
次のプログラミング言語の OSS SDK を使用して、DeleteObjectTagging を呼び出すことができます。
ossutil
詳細については、「delete-object-tagging」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
FileAlreadyExists | 409 | 削除対象のタグを持つオブジェクトが、階層型名前空間機能が有効になっているバケット内のディレクトリであるために返されるエラーメッセージです。 |