ListTagResources - Key Management Service: Central de Documentação do Alibaba Cloud

Lista as tags vinculadas a uma chave ou a um segredo.

Descrição da operação

Para mais informações sobre a política de acesso necessária para que um usuário RAM ou uma função RAM chame esta operação, consulte Resource Access Management.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do recurso. Nota Chame DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NextToken	string	Não	O token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Nota Se nem todos os resultados forem retornados, o valor NextToken será incluído na resposta. Por padrão, 200 linhas são retornadas por página. Para recuperar a próxima página, defina este parâmetro com o valor NextToken da resposta anterior.	caeba0bbb2be03f84eb48b699f0a4883
ResourceType	string	Sim	O tipo de recurso cujas tags você deseja consultar. Valores válidos: key secret	key
ResourceId	array	Não	Uma lista de IDs de recursos para os quais você deseja consultar tags. Você pode inserir no máximo 50 IDs de recursos. Insira múltiplos IDs de recursos no formato `["ResourceId. 1","ResourceId. 2",...]`.
	string	Não	Os IDs de recursos para os quais você deseja consultar tags. Você pode inserir no máximo 50 IDs de recursos. Insira múltiplos IDs de recursos no formato `["ResourceId. 1","ResourceId. 2",...]`.	key-hzz62f1cb66fa42qo****
Tag	array<object>	Não	Uma lista de tags que você deseja consultar. Valores válidos de N: 1 a 20.
	object	Não
Key	string	Não	A chave da tag. Uma tag consiste em um par chave-valor. Você pode inserir até 20 tags. Insira múltiplas tags no formato `[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..]`. Nota A chave não pode começar com aliyun ou acs:.	disk-encryption
Value	string	Não	O valor da tag. Uma tag consiste em um par chave-valor. Você pode inserir até 20 tags. Insira múltiplas tags no formato `[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..]`.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NextToken	string	Um token de paginação. Pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Se NextToken estiver vazio ("NextToken": ""), não existe próxima página. Se NextToken não estiver vazio, a próxima consulta é necessária, e o valor é o token usado para iniciar a próxima consulta.	e71d8a535bd9cc11
RequestId	string	O ID da solicitação.	00827261-20B7-4562-83F2-4DF39876A45A
TagResources	object
TagResource	array<object>	Uma lista de tags.
	object
ResourceType	string	The type of the resource.	key
TagValue	string	The value of the tag.	true
ResourceId	string	The resource ID.	key-hzz62f1cb66fa42qo****
TagKey	string	The key of the tag.	disk-encryption

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "e71d8a535bd9cc11",
  "RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "key",
        "TagValue": "true",
        "ResourceId": "key-hzz62f1cb66fa42qo****",
        "TagKey": "disk-encryption"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	Duplicate.TagKey	The specified tagKey is duplicate.
404	InvalidAccessKeyId.NotFound	The Access Key ID provided does not exist in our records.
404	InvalidResourceId.NotFound	The specified ResourceId is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.