Object Storage Service:オブジェクトタグの照会

使用上の注意

• このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

• このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

• オブジェクトのタグを照会するには、oss:GetObjectTagging権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

オブジェクトのタグの照会

タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっていない場合は、要件に基づいてオブジェクトのタグを照会できます。 タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、OSSはデフォルトでオブジェクトの現在のバージョンのタグを返します。

次のサンプルコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトのタグを照会する方法の例を示しています。

# -*-コーディング: utf-8 -*-

oss2のインポート
oss2.modelsからインポートタグ付け、TaggingRule
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# オブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 例: exampledir/exampleobject.txt。 
object_name = 'exampledir/exampleobject.txt'

# オブジェクトのタグを照会します。 
result = bucket.get_object_tagging(object_name)

# オブジェクトのタグを表示します。 
結果のキーに対してtag_set.tagging_rule:
    print('tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key])) 

オブジェクトの指定されたバージョンのタグを照会する

タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、オブジェクトのバージョンIDを指定して、指定したバージョンのオブジェクトのタグを照会できます。

次のサンプルコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトの指定されたバージョンのタグを照会する方法の例を示しています。

# -*-コーディング: utf-8 -*-

oss2のインポート
oss2.modelsからインポートタグ付け
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# オブジェクトのフルパスを指定します。 バケット名をフルパスに含めないでください。 例: exampledir/exampleobject.txt。 
object_name = 'exampledir/exampleobject.txt'
# オブジェクトのバージョンIDを指定します。 例: CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm **** 。 
version_id = 'CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm ****'

params = dict()
params['versionId'] = version_id

result = bucket.get_object_tagging(object_name, params=params)
プリント (結果) 

参考資料

• オブジェクトのタグのクエリに使用される完全なサンプルコードについては、GitHubをご覧ください。

• オブジェクトのオブジェクトタグを照会するために呼び出すAPI操作の詳細については、「GetObjectTagging」をご参照ください。