ListTagResources - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Consulta as tags vinculadas a uma instância do Cloud Enterprise Network (CEN).

Descrição da operação

Ao chamar a operação ListTagResources, você deve especificar pelo menos um dos parâmetros de solicitação ResourceId.N e Tag.N.Key:

Se você especificar apenas ResourceId.N, as tags vinculadas à instância CEN especificada serão consultadas.
Se você especificar apenas Tag.N.Key, todas as instâncias CEN que possuem a chave de tag especificada vinculada serão consultadas.
Se você especificar tanto ResourceId.N quanto Tag.N.Key, as tags especificadas vinculadas à instância CEN especificada serão consultadas.
- Certifique-se de que os valores de ResourceId.N e Tag.N.Key correspondam entre si. Caso contrário, um resultado vazio será retornado.
- Se você especificar várias chaves de tag, as chaves de tag serão avaliadas usando o operador lógico AND.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cen:ListTagResources

get

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceType	string	Sim	O tipo de recurso. Valores válidos: Cen: Instância CEN. BandwidthPackage: Instância de pacote de largura de banda. TransitRouter: Instância de roteador de trânsito. TransitRouterVpcAttachment: Instância de conexão VPC. TransitRouterVbrAttachment: Instância de conexão VBR. TransitRouterPeerAttachment: Instância de conexão inter-regional. TransitRouterVpnAttachment: Instância de conexão VPN. TransitRouterRouteTable: Instância de tabela de rotas. Flowlog: Instância de log de fluxo. TransitRouterMulticastDomain: Instância de domínio multicast.	cen.
NextToken	string	Não	Especifica se existe um token de próxima consulta. Valores válidos: Se esta for a primeira consulta ou não existir uma próxima consulta, você não precisa especificar este parâmetro. Se existir uma próxima consulta, defina o valor como o valor NextToken retornado pela chamada de API anterior.	FFmyTO70tTpLG6I3FmYAXGKPd****
PageSize	integer	Não	O número de entradas por página para uma consulta paginada. Valores válidos: 1 a 50. Valor padrão: 10.	10
ResourceId	array	Não	O ID da instância CEN. Você pode especificar até 20 IDs de instância CEN por vez.	cen-8z69wtwqel33lq****
	string	Não	O ID da instância CEN. Você pode especificar até 20 IDs de instância CEN por vez.	cen-8z69wtwqel33lq****
Tag	array<object>	Não	As informações de tag da instância CEN. Você pode consultar até 20 tags por vez.
	object	Não	As informações de tag da instância CEN. Você pode consultar até 20 tags por vez.
Key	string	Não	A chave da tag. Uma chave de tag pode conter até 64 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Você pode especificar até 20 chaves de tag por vez.	test.
Value	string	Não	O valor da tag. Um valor de tag pode conter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Você pode especificar até 20 valores de tag por vez.	Bp
RegionId	string	Não	O ID da região da instância do recurso. Este parâmetro não é obrigatório quando o tipo de recurso é Cen ou BandwidthPackage. Este parâmetro é obrigatório para todos os outros tipos de recursos.	cn-hangzhou.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
NextToken	string	Indica se existe um token de próxima consulta. Valores válidos: Se NextToken estiver vazio, não existe uma próxima consulta. Se NextToken for retornado, o valor indica o token para a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	O ID da solicitação.	165B5C86-2033-5954-A89D-4CD83BA06C85
TagResources	object
TagResource	array<object>	A lista de recursos e tags.
	object
ResourceType	string	O tipo de recurso. Valores válidos: Cen: uma instância CEN. BandwidthPackage: um plano de largura de banda. TransitRouter: um transit router. TransitRouterVpcAttachment: uma conexão VPC. TransitRouterVbrAttachment: uma conexão VBR. TransitRouterPeerAttachment: uma conexão inter-região. TransitRouterVpnAttachment: uma conexão VPN. TransitRouterRouteTable: uma tabela de rotas. Flowlog: um flow log. TransitRouterMulticastDomain: um domínio multicast.	CEN
TagValue	string	O valor da tag.	Bp
ResourceId	string	O ID da instância CEN.	cen-8z69wtwqel33lq****
TagKey	string	A chave da tag.	test

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "165B5C86-2033-5954-A89D-4CD83BA06C85",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "CEN",
        "TagValue": "Bp",
        "ResourceId": "cen-8z69wtwqel33lq****",
        "TagKey": "test"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidTagKey	The tag keys are not valid.	O valor da chave da tag é inválido.
400	InvalidTagValue	The tag values are not valid.	O valor da tag é inválido.
400	MissingParam	%s
400	InvalidInstanceType.NotFound	The instance type is not found	O tipo de instância especificado no parâmetro não existe.
400	InvalidInstanceIds.NotFound	The instanceIds are not found	A instância especificada no parâmetro não existe.
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	A chave da tag não pode ser operada.
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	O número de tags atingiu o limite superior.
400	InvalidTagScope.NotFound	The tag scope is not found	O escopo da tag é inválido.
400	Forbidden.NotAllowedCategary	The System tag is not valid	As tags do sistema não podem ser configuradas.
400	SizeLimitExceeded.ResourceIdNum	The ResourceIds parameter's number is exceed , Valid : 20
400	BothEmpty.TagsAndResources	Both of Tags and ResourceIds is empty.	Tags e ResourceIds estão vazios.
400	IllegalParam.NextToken	The parameter NextToken is invalid.	O NextToken especificado na solicitação é inválido.
400	IllegalParam.Region	The specified region is invalid.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem permissão para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.