ListTagResources - - Centro de documentación de Alibaba Cloud

Consulta las etiquetas agregadas a uno o varios recursos de Global Accelerator (GA).

Notas de uso

Especifique ResourceId.N o Tag.N, que consta de Tag.N.Key y Tag.N.Value, en la solicitud para definir el objeto que desea consultar.
Tag.N es una etiqueta de recurso compuesta por un par clave-valor. Si solo especifica Tag.N.Key, se devuelven todos los valores de etiqueta asociados a la clave indicada. Si solo especifica Tag.N.Value, se devuelve un mensaje de error.
Si utiliza Tag.N y ResourceId.N para filtrar etiquetas,ResourceId.N debe coincidir con todos los pares clave-valor especificados.
Si especifica varios pares clave-valor, se devuelven los recursos que contienen dichos pares.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListTagResources	La operación que desea ejecutar. Establezca el valor en ListTagResources.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde se despliega la instancia de GA. Establezca el valor en cn-hangzhou.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre distintas solicitudes. El token solo puede contener caracteres ASCII. Nota Si no establece este parámetro, el sistema asigna a ClientToken el valor de RequestId. El valor de RequestId puede ser diferente para cada solicitud de API.
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	El token que se usa para la siguiente consulta. Valores válidos: Si esta es su primera y única consulta, ignore este parámetro. Si va a realizar otra consulta, establezca el valor en el NextToken devuelto en la última llamada a la operación ListTagResources.
ResourceType	String	Sí	accelerator	El tipo de recurso cuya información de etiquetas desea consultar. Valores válidos: accelerator: una instancia estándar de GA. basicaccelerator: una instancia básica de GA. bandwidthpackage: un plan de ancho de banda. acl: una lista de control de acceso (ACL).
ResourceId.N	String	No	ga-bp149u6o36qt1as9b****	El ID del recurso cuya información de etiquetas desea consultar. Si ResourceType está establecido en accelerator, asigne a ResourceId el ID de una instancia estándar de GA. Si ResourceType está establecido en basicaccelerator, asigne a ResourceId el ID de una instancia básica de GA. Si ResourceType está establecido en bandwidthpackage, asigne a ResourceId el ID de un plan de ancho de banda. Si ResourceType está establecido en acl, asigne a ResourceId el ID de una ACL. Puede introducir hasta 50 ID de recursos.
Tag.N.Key	String	No	KeyTest	La clave de la etiqueta del recurso. La clave no puede ser una cadena vacía. Su longitud máxima es de 64 caracteres y no puede contener `http://` ni `https://`. No puede comenzar con `aliyun` ni con `acs:`. Puede especificar hasta 20 claves de etiqueta.
Tag.N.Value	String	No	valueTest	El valor de la etiqueta del recurso. El valor puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con `acs:` ni con `aliyun`. Tampoco puede contener `http://` ni `https://`. Puede especificar hasta 20 valores de etiqueta.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	El ID de la solicitud.
TotalCount	Integer	1	El número de entradas devueltas.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	El token que se usa para la siguiente consulta. Valores válidos: Si no se devuelve NextToken, significa que no hay más resultados. Si se devuelve NextToken, el valor corresponde al token para la siguiente consulta.
TagResources	Array of TagResource		La información sobre los recursos etiquetados.
TagResource
ResourceType	String	accelerator	El tipo de recurso. accelerator: una instancia estándar de GA. basicaccelerator: una instancia básica de GA. bandwidthpackage: un plan de ancho de banda. acl: una ACL.
TagValue	String	KeyTest	El valor de la etiqueta.
ResourceId	String	ga-bp149u6o36qt1as9b****	El ID del recurso.
TagKey	String	valueTest	La clave de la etiqueta.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.