要件に基づいて、オブジェクトの不要なタグを削除できます。 タグを削除するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、object Storage Service (OSS) はデフォルトでオブジェクトの現在のバージョンのタグを削除します。 指定したバージョンのオブジェクトのタグを削除するには、オブジェクトのバージョンIDを指定する必要があります。
使用上の注意
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョン、エンドポイント、オープンポート」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。
オブジェクトのタグを削除するには、
oss:DeleteObjectTagging
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
オブジェクトのタグを削除する
タグを削除するオブジェクトを格納するバケットのバージョン管理が有効になっていない場合は、要件に基づいてオブジェクトのタグを削除できます。 タグを削除するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、OSSはデフォルトでオブジェクトの現在のバージョンのタグを削除します。
次のコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトのタグを削除する方法の例を示しています。
# -*- coding: utf-8 -*-
import oss2
from oss2.models import Tagging, TaggingRule
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the ID of the region that maps to the endpoint. Example: cn-hangzhou. This parameter is required if you use the signature algorithm V4.
region = "cn-hangzhou"
# Specify the name of the bucket.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# Specify the full path of the object. Do not include the bucket name in the full path. Example: exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'
# Delete the tags of the object.
result = bucket.delete_object_tagging(object_name)
print('http response status: ', result.status)
オブジェクトの特定のバージョンのタグを削除する
タグを削除するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、オブジェクトのバージョンIDを指定することで、指定したバージョンのオブジェクトのタグを削除できます。
次のコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトの指定されたバージョンのタグを削除する方法の例を示しています。
バージョンIDの取得方法の詳細については、「オブジェクトのリスト」をご参照ください。
# -*- coding: utf-8 -*-
import oss2
from oss2.models import Tagging
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the ID of the region that maps to the endpoint. Example: cn-hangzhou. This parameter is required if you use the signature algorithm V4.
region = "cn-hangzhou"
# Specify the name of the bucket.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# Specify the full path of the object. Do not include the bucket name in the full path. Example: exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'
# Specify the version ID of the object.
version_id = 'CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm****'
params = dict()
params['versionId'] = version_id
bucket.delete_object_tagging(object_name, params=params)
関連ドキュメント
オブジェクトのタグを削除するために使用される完全なサンプルコードについては、GitHubをご覧ください。
オブジェクトのタグを削除するために呼び出すAPI操作の詳細については、「DeleteObjectTagging」をご参照ください。