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

Consulta as tags associadas 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, o sistema consulta as tags associadas à instância CEN especificada.
Se você especificar apenas Tag.N.Key, o sistema consulta todas as instâncias CEN associadas à chave de tag especificada.
Se você especificar tanto ResourceId.N quanto Tag.N.Key, o sistema consulta as tags que correspondem à chave de tag especificada e estão associadas à instância CEN especificada.
- A instância CEN especificada deve estar associada à chave de tag especificada. Caso contrário, um resultado vazio será retornado.
- Se você especificar várias chaves de tag, a relação entre as chaves de tag é 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: 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
NextToken	string	Não	O token usado para a próxima consulta. Valores válidos: Se esta for sua primeira consulta ou se nenhuma próxima consulta será enviada, você não precisa especificar este parâmetro. Se uma consulta subsequente será enviada, defina o valor como o valor NextToken retornado da última chamada de API.	FFmyTO70tTpLG6I3FmYAXGKPd****
PageSize	integer	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 1 a 50. Valor padrão: 10.	10
ResourceId	array	Não	O ID da instância CEN. Você pode inserir no máximo 20 IDs de instâncias CEN.	cen-8z69wtwqel33lq****
	string	Não	O ID da instância CEN. Você pode inserir no máximo 20 IDs de instâncias CEN.	cen-8z69wtwqel33lq****
Tag	array<object>	Não	As tags da instância CEN. Você pode consultar no máximo 20 tags.
	object	Não	As tags da instância CEN. Você pode consultar no máximo 20 tags.
Key	string	Não	A chave da tag. A chave da tag pode ter até 64 caracteres. Não pode começar com `aliyun` ou `acs:`, e não pode conter `http://` ou `https://`. Você pode inserir no máximo 20 chaves de tag.	test
Value	string	Não	O valor da tag. O valor da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:`, e não pode conter `http://` ou `https://`. Você pode inserir no máximo 20 valores de tag.	Bp
RegionId	string	Não	O ID da região onde o recurso está implantado. Este parâmetro não é obrigatório para os tipos de recurso Cen e BandwidthPackage. É obrigatório para todos os outros tipos de recurso.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
NextToken	string	O token usado para a próxima consulta. Valores válidos: Se NextToken estiver vazio, nenhuma próxima consulta será enviada. Se um valor for retornado para NextToken, o valor é o token usado para a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	O ID da solicitação.	165B5C86-2033-5954-A89D-4CD83BA06C85
TagResources	object
TagResource	array<object>	Uma lista de recursos e suas tags.
	object
ResourceType	string	The resource type. Valid values: Cen: a CEN instance. BandwidthPackage: a bandwidth plan. TransitRouter: a transit router. TransitRouterVpcAttachment: a VPC connection. TransitRouterVbrAttachment: a VBR connection. TransitRouterPeerAttachment: an inter-region connection. TransitRouterVpnAttachment: a VPN connection. TransitRouterRouteTable: a route table. Flowlog: a flow log. TransitRouterMulticastDomain: a multicast domain.	CEN
TagValue	string	The tag value.	Bp
ResourceId	string	The ID of the CEN instance.	cen-8z69wtwqel33lq****
TagKey	string	The tag key.	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.	The error message returned because the specified tag key is invalid.
400	InvalidTagValue	The tag values are not valid.	The error message returned because the specified tag value is invalid.
400	MissingParam	%s
400	InvalidInstanceType.NotFound	The instance type is not found	The error message returned because the specified instance type does not exist.
400	InvalidInstanceIds.NotFound	The instanceIds are not found	The error message returned because the specified instance does not exist.
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	The error message returned because you cannot manage the specified tag key.
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	The error message returned because the number of tags has reached the upper limit.
400	InvalidTagScope.NotFound	The tag scope is not found	The error message returned because the specified tag scope is invalid.
400	Forbidden.NotAllowedCategary	The System tag is not valid	The error message returned because you cannot configure system tags.
400	SizeLimitExceeded.ResourceIdNum	The ResourceIds parameter's number is exceed , Valid : 20
400	BothEmpty.TagsAndResources	Both of Tags and ResourceIds is empty.	The error message returned because the Tags and ResourceIds parameters are not set.
400	IllegalParam.NextToken	The parameter NextToken is invalid.	The error message returned because the NextToken parameter is set to an invalid value. Check the value and try again.
400	IllegalParam.Region	The specified region is invalid.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.