Consulta de etiquetas de un objeto (OSS SDK para Python 2.0) - Object Storage Service

Consulte las etiquetas de un objeto mediante OSS SDK para Python 2.0.

Notas de uso

El código de ejemplo de este tema utiliza la región China (Hangzhou) (cn-hangzhou) y un endpoint público. Para acceder a OSS desde otros servicios de Alibaba Cloud en la misma región, utilice un endpoint interno. Para obtener más información sobre las regiones y endpoints compatibles, consulte Regions and endpoints.
Las etiquetas de los objetos son pares clave-valor. Para obtener más información, consulte Tag objects.
Para conocer la operación de API utilizada para consultar etiquetas de objetos, consulte GetObjectTagging.
Para consultar las etiquetas de un objeto, debe contar con el permiso oss:GetObjectTagging. Para obtener más información, consulte Grant custom permissions to a RAM user.

Definición del método

get_object_tagging(request: GetObjectTaggingRequest, **kwargs) → GetObjectTaggingResult

Parámetros de solicitud

Parámetro	Tipo	Descripción
request	GetObjectTaggingRequest	Los parámetros de la solicitud. Para obtener más información, consulte GetObjectTaggingRequest

Valores de retorno

Tipo	Descripción
GetObjectTaggingResult	El valor de retorno. Para obtener más información, consulte GetObjectTaggingResult

Para ver la definición completa del método, consulte get_object_tagging.

Código de ejemplo

A continuación se muestra un código que consulta las etiquetas de un objeto específico dentro de un bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Create a command-line argument parser to process parameters passed in by users from the command line.
parser = argparse.ArgumentParser(description="get object tagging sample")

# Add required and optional command-line arguments.
# --region: The region where the OSS bucket is located.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
# --bucket: The name of the bucket.
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
# --endpoint: An optional parameter that specifies the domain name used to access OSS.
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
# --key: The key of the object (file) in OSS.
parser.add_argument('--key', help='The name of the object.', required=True)

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

    # Load the required authentication credentials for OSS from environment variables.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Create a configuration object using the default configurations provided by the SDK.
    cfg = oss.config.load_default()

    # Set the credential provider to the previously created object.
    cfg.credentials_provider = credentials_provider

    # Set the region for the OSS client based on user input.
    cfg.region = args.region

    # If the user provides a custom endpoint, update the configuration.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Create an OSS client instance using the preceding configurations.
    client = oss.Client(cfg)

    # Query the tag of the specified object.
    result = client.get_object_tagging(oss.GetObjectTaggingRequest(
        bucket=args.bucket,
        key=args.key,
    ))

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

    # If tags exist, traverse and print the key-value pair of each tag.
    if result.tag_set.tags:
        for o in result.tag_set.tags:
            print(f'tags key: {o.key}, tags value: {o.value}')

# Call the main function when this script is run.
if __name__ == "__main__":
    main()

Referencia

Para consultar el código de ejemplo completo, revise get_object_tagging.py.