すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ライフサイクル管理にオブジェクトタグを使用する

最終更新日:Feb 26, 2024

プレフィックスまたはタグを指定したオブジェクトのライフサイクルルールを設定できます。 プレフィックスとタグの組み合わせをライフサイクルルールの条件として指定することもできます。

説明

タグ条件を設定した場合、ルールはタグキーと値の条件を満たすオブジェクトにのみ適用されます。 プレフィックスと複数のオブジェクトタグがルールで設定されている場合、ルールはプレフィックスとオブジェクトタグの条件に一致するオブジェクトにのみ適用されます。

使用上の注意

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

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

ライフサイクルルールでのタグの指定

次のコードは、ライフサイクルルールでタグを指定する方法の例を示しています。

# -*-コーディング: utf-8 -*-
oss2のインポート
datetimeのインポート
oss2.modelsインポートから (LifecycleExpiration, LifecycleRule, 
                        BucketLifecycle、AbortMultipartUpload、 
                        TaggingRule、Tagging、StorageTransition)
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')

# オブジェクトが最後に変更されてから3日後に期限切れになるように指定します。 
# オブジェクトに一致する有効期限ルールの名前とプレフィックスを指定します。 
rule1 = LifecycleRule('rule1', 'tests/',
                      # 有効期限ルールを有効にします。 
                      status=LifecycleRule.ENABLED,
                      # オブジェクトが最後に変更されてから3日後に期限切れになるように指定します。 
                      expiration=LifecycleExpiration(days=3)

# オブジェクトが指定された日付より前に最後に変更されたことを指定します。 
# オブジェクトに一致する有効期限ルールの名前とプレフィックスを指定します。 
rule2 = LifecycleRule('rule2', 'logging-',
                      # 有効期限ルールを無効にします。 
                      status=LifecycleRule.DISABLED,
                      # オブジェクトが指定された日付より前に最後に変更されたことを指定します。 
                      expiration=LifecycleExpiration(created_before_date=datetime.date(2018, 12, 12)))

# パーツが最後に変更されてから3日後に期限切れになるように指定します。 
rule3 = LifecycleRule('rule3', 'tests1/',
                      status=LifecycleRule.ENABLED,
                      abort_multipart_upload=AbortMultipartUpload(days=3))

# 指定された日付より前に最後に変更されたパーツの有効期限を指定します。 
rule4 = LifecycleRule('rule4', 'logging1-',
                      status=LifecycleRule.DISABLED,
                      abort_multipart_upload = AbortMultipartUpload(created_before_date=datetime.date(2018、12、12)))

# オブジェクトに一致するようにタグを設定します。 
tagging_rule = TaggingRule()
tagging_rule.add('key1', 'value1')
tagging_rule.add('key2', 'value2')
tagging=タグ付け (tagging_rule)

# オブジェクトのストレージクラスを変換するルールを設定します。 オブジェクトが最後に変更されてから365日後に、オブジェクトのストレージクラスをアーカイブに変換するように指定します。  
オブジェクトに一致する# タグはルール5で指定されます。 このルールは、key1=value1およびkey2=value2のタグ条件に一致するオブジェクトにのみ適用されます。 
rule5 = LifecycleRule('rule5' 、'logging2-'、
                      status=LifecycleRule.ENABLED,
                      storage_transitions=[StorageTransition(days=365、storage_class=oss2.BUCKET_STORAGE_CLASS_ARCHIVE)] 、
                      tagging = tagging)

lifecycle = BucketLifecycle([rule1, rule2, rule3, rule4, rule5])

bucket.put_bucket_lifecycle (ライフサイクル) 

ライフサイクルルールで設定されたタグのクエリ

次のコードは、ライフサイクルルールで設定されたタグをクエリする方法の例を示しています。

# -*-コーディング: utf-8 -*-
oss2のインポート
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')

# ライフサイクルルールを照会します。 
lifecycle = bucket.get_bucket_lifecycle()

lifecycle.ru lesのルールの場合:
    # 部品の有効期限ルールを照会します。 
    rule.abort_multipart_uploadがNoneではない場合:
        print('id={0}, prefix={1}, tagging={2}, status={3}, days={4}, created_before_date={5}'
                . 形式 (rule.id、rule.prefix、rule.tagging、rule.status、
                    rule.abort_multipart_upload.days,
                    rule.abort_multipart_upload.created_before_date))

    # オブジェクトの有効期限ルールを照会します。 
    rule.expirationがNoneではない場合:
        print('id={0}, prefix={1}, tagging={2}, status={3}, days={4}, created_before_date={5}'
                . 形式 (rule.id、rule.prefix、rule.tagging、rule.status、
                    rule.expiration.days,
                    rule.expiration.created_before_date))
    # オブジェクトのストレージクラスを変換するルールを照会します。 
    if len(rule.storage_transitions) > 0: 
        storage_trans_info = ''
        rule内のstorage_ruleの場合、storage_transitions:
            storage_trans_info += 'days={0}, created_before_date={1}, storage_class={2} **** '.
                storage_rule.days, storage_rule.created_before_date, storage_rule.storage_class)

        print('id={0}, prefix={1}, tagging={2}, status={3 },, StorageTransition={4}')
                . 形式 (rule.id、rule.prefix、rule.tagging、rule.status、storage_trans_info) 

参考資料

  • ライフサイクルルールの管理に使用される完全なサンプルコードについては、『GitHub』をご参照ください。

  • ライフサイクルルールを設定するために呼び出すことができるAPI操作の詳細については、「PutBucketLifecycle」をご参照ください。

  • ライフサイクルルールを照会するために呼び出すAPI操作の詳細については、「GetBucketLifecycle」をご参照ください。