Comment configurer des tags pour un objet à l'aide du SDK OSS pour Python 2.0 - Object Storage Service

Object Storage Service (OSS) vous permet de configurer des tags pour classifier vos données. Cette rubrique explique comment configurer des tags pour les objets avec le SDK OSS pour Python 2.0.

Notes d'utilisation

L'exemple de code de cette rubrique utilise l'ID de région cn-hangzhou correspondant à la région Chine (Hangzhou). Par défaut, l'accès aux ressources d'un bucket s'effectue via un endpoint public. Pour accéder aux ressources du bucket depuis d'autres services Alibaba Cloud de la même région, utilisez un endpoint interne. Pour plus d'informations sur les régions et endpoints pris en charge, consultez Régions et endpoints.
La configuration des tags nécessite l'autorisation oss:PutObjectTagging. Pour plus d'informations, consultez Accorder une politique personnalisée.

Syntaxe

put_object_tagging(request: PutObjectTaggingRequest, **kwargs) → PutObjectTaggingResult

Paramètres de la requête

Paramètre

Type

Description

request

PutObjectTaggingRequest

Requête pour l'opération PutObjectTagging. Pour connaître les paramètres de la requête, consultez PutObjectTaggingRequest.

Paramètres de la réponse

Type

Description

PutObjectTaggingResult

Valeur de retour. Pour plus de détails, consultez PutObjectTaggingResult.

Consultez put_object_tagging pour la définition complète de la configuration des tags.

Exemple

Voici un exemple de code pour configurer les tags d'un objet spécifique dans un bucket :

import argparse
import alibabacloud_oss_v2 as oss

# Create a command-line parameter parser and define the parameters.
parser = argparse.ArgumentParser(description="put object tagging sample")
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--key', help='The name of the object.', required=True)
parser.add_argument('--tag_key', help='The name of the tag key.', required=True)
parser.add_argument('--tag_value', help='The name of the tag value.', required=True)

def main():
    # Parse the command-line parameters.
    args = parser.parse_args()

    # Load access credentials from environment variables.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configuration of the SDK.
    cfg = oss.config.load_default()
    # Specify the credential provider.
    cfg.credentials_provider = credentials_provider
    # Specify the region.
    cfg.region = args.region
    # Specify the endpoint if one is provided.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Create an OSS client.
    client = oss.Client(cfg)

    # Specify a tag.
    # Add more oss.Tag objects in the following format if you need to configure multiple tags.
    # tags = [oss.Tag(key=args.tag_key, value=args.tag_value), oss.Tag(key=args.tag_key2, value=args.tag_value2)]

    tags = [oss.Tag(
        key=args.tag_key,
        value=args.tag_value,
    )]

    # Configure the tags for the object.
    result = client.put_object_tagging(oss.PutObjectTaggingRequest(
        bucket=args.bucket,
        key=args.key,
        tagging=oss.Tagging(
            tag_set=oss.TagSet(
                tags=tags,
            ),
        ),
    ))

    # Print the response.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' version id: {result.version_id},'
    )

if __name__ == "__main__":
    main()

Référence

Pour consulter l'exemple de code complet de configuration des tags d'un objet, rendez-vous sur put_object_tagging.py.