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
Para obter o código de exemplo completo, consulte get_object_tagging.py.