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

Consulta as tags adicionadas a um ou mais recursos do Global Accelerator (GA).

Observações de uso

Especifique ResourceId.N ou Tag.N, composto por Tag.N.Key e Tag.N.Value, na solicitação para definir o objeto a ser consultado.
Tag.Né uma tag de recurso formada por um par chave-valor. Se você especificar apenas Tag.N.Key, todos os valores de tag associados à chave especificada serão retornados. Caso especifique somente Tag.N.Value, o sistema retornará uma mensagem de erro.
Ao utilizar Tag.N e ResourceId.N simultaneamente para filtragem, o parâmetro ResourceId.N deve corresponder a todos os pares chave-valor indicados.
Se múltiplos pares chave-valor forem definidos, a resposta incluirá os recursos que contenham esses conjuntos.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	ListTagResources	A operação a ser executada. Defina o valor como ListTagResources.
RegionId	String	Yes	cn-hangzhou	O ID da região onde a instância GA está implantada. Defina o valor como cn-hangzhou.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota Se este parâmetro não for definido, o sistema definirá ClientToken com o valor de RequestId. O valor de RequestId pode variar para cada solicitação de API.
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	O token usado para a próxima consulta. Valores válidos: Ignore este parâmetro se esta for sua primeira e única consulta. Caso seja necessária uma nova consulta, defina o valor como o NextToken retornado na última chamada à operação ListTagResources.
ResourceType	String	Yes	accelerator	O tipo de recurso cujas informações de tag você deseja consultar. Valores válidos: accelerator: uma instância GA padrão. basicaccelerator: uma instância GA básica. bandwidthpackage: um plano de largura de banda. acl: uma lista de controle de acesso (ACL).
ResourceId.N	String	No	ga-bp149u6o36qt1as9b****	O ID do recurso cujas informações de tag você deseja consultar. Se ResourceType estiver definido como accelerator, defina o valor de ResourceId como o ID de uma instância GA padrão. Quando ResourceType for basicaccelerator, utilize o ID de uma instância GA básica no campo ResourceId. Para ResourceType igual a bandwidthpackage, insira o ID de um plano de largura de banda em ResourceId. Se ResourceType tiver o valor acl, especifique o ID de uma ACL como ResourceId. É possível inserir até 50 IDs de recursos.
Tag.N.Key	String	No	KeyTest	A chave da tag do recurso. A chave da tag não pode ser uma string vazia. Pode ter no máximo 64 caracteres e não deve conter `http://` ou `https://`. Também não pode começar com `aliyun` ou `acs:`. Você pode especificar até 20 chaves de tag.
Tag.N.Value	String	No	valueTest	O valor da tag do recurso. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `acs:` ou `aliyun`. Além disso, não deve conter `http://` ou `https://`. É permitido especificar até 20 valores de tag.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	O ID da solicitação.
TotalCount	Integer	1	O número de entradas retornadas.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	O token usado para a próxima consulta. Valores válidos: A ausência de NextToken indica que não existem resultados adicionais. Se NextToken for retornado, seu valor corresponde ao token para a próxima consulta.
TagResources	Array of TagResource		As informações sobre os recursos aos quais as tags foram adicionadas.
TagResource
ResourceType	String	accelerator	O tipo do recurso. accelerator: uma instância GA padrão. basicaccelerator: uma instância GA básica. bandwidthpackage: um plano de largura de banda. acl: uma ACL.
TagValue	String	KeyTest	O valor da tag.
ResourceId	String	ga-bp149u6o36qt1as9b****	O ID do recurso.
TagKey	String	valueTest	A chave da tag.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListTagResources
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&ResourceType=accelerator
&ResourceId=["ga-bp149u6o36qt1as9b****"]
&Tag=[{"Key":"KeyTest","Value":"valueTest"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <TotalCount>1</TotalCount>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <TagResources>
        <ResourceType>accelerator</ResourceType>
        <TagValue>KeyTest</TagValue>
        <ResourceId>ga-bp149u6o36qt1as9b****</ResourceId>
        <TagKey>valueTest</TagKey>
    </TagResources>
</ListTagResourcesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "TotalCount" : 1,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TagResources" : [ {
    "ResourceType" : "accelerator",
    "TagValue" : "KeyTest",
    "ResourceId" : "ga-bp149u6o36qt1as9b****",
    "TagKey" : "valueTest"
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.