Todos os produtos
Search
Central de documentação

Object Storage Service:Consultar as tags de um objeto usando o OSS SDK for Python 2.0

Última atualização: Jul 03, 2026

Consulte as tags de um objeto com o OSS SDK for Python 2.0.

Observações de uso

  • O código de exemplo deste tópico usa a região China (Hangzhou) (cn-hangzhou) e um endpoint público. Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno. Para obter mais informações sobre regiões e endpoints compatíveis, consulte Regiões e endpoints.

  • As tags de objetos são pares chave-valor. Para obter mais informações, consulte Adicionar tags a objetos.

  • Para consultar a operação de API usada para obter tags de objetos, consulte GetObjectTagging.

  • A permissão oss:GetObjectTagging é obrigatória para consultar tags de objetos. Para obter mais informações, consulte Conceder permissões personalizadas a um usuário RAM.

Definição do método

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

Parâmetros da solicitação

Parâmetro

Tipo

Descrição

request

GetObjectTaggingRequest

Os parâmetros da solicitação. Para obter mais informações, consulte GetObjectTaggingRequest

Valores de retorno

Tipo

Descrição

GetObjectTaggingResult

O valor retornado. Para obter mais informações, consulte GetObjectTaggingResult

Para obter a definição completa do método, consulte get_object_tagging.

Código de exemplo

O código a seguir consulta as tags de um objeto específico em um 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()

Referência