ListTagResources - - Centro de documentación de Alibaba Cloud

Consulta las etiquetas agregadas a uno o más recursos de Resource Orchestration Service (ROS).

Descripción

Para especificar el objeto de consulta, debe indicar el parámetro ResourceId.N o Tag.N en la solicitud. Tag.N se compone de Tag.N.Key y Tag.N.Value.
Si especifica los parámetros Tag.N y ResourceId.N, se devuelven los recursos de ROS que coinciden con ambos parámetros.

Este tema proporciona un ejemplo sobre cómo consultar las etiquetas agregadas a un recurso en una pila. En este ejemplo, el ID del recurso es 6bc589b5-9c02-4944-8fc3-f3624234****. La pila está desplegada en la región China (Hangzhou).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de muestra 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 región de la etiqueta. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ResourceType	String	Sí	stack	El tipo de recurso. Valores válidos: stack: pila stackgroup: grupo de pilas template: plantilla templatescratch: escenario
NextToken	String	No	caeba0bbb2be03f84eb48b699f0*****	El token que determina el punto de inicio de la siguiente consulta.
ResourceId.N	String	No	6bc589b5-9c02-4944-8fc3-f3624234****	El ID del recurso N. Puede especificar hasta 50 ID de recursos. Nota Si establece el parámetro ResourceType en stackgroup, debe usar el nombre del grupo de pilas como ID de recurso.
Tag.N.Key	String	No	FinanceDept	La clave de la etiqueta N agregada al recurso. Puede especificar hasta 20 claves de etiqueta. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener una longitud máxima de 128 caracteres y no puede contener `http://` ni `https://`. La clave de etiqueta no puede comenzar con `aliyun` ni `acs:`.
Tag.N.Value	String	No	FinanceJoshua	El valor de la etiqueta N agregada al recurso. Puede especificar hasta 20 valores de etiqueta. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener una longitud máxima de 128 caracteres y no puede contener `http://` ni `https://`. El valor de etiqueta no puede comenzar con `aliyun` ni `acs:`.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
NextToken	String	caeba0bbb2be03f84eb48b699f0*	El token que se utiliza para iniciar la siguiente consulta.
RequestId	String	C429473A-5C66-4661-B5F8-4F900CD4330A	El ID de la solicitud.
TagResources	Array of TagResource		La información sobre las etiquetas agregadas al recurso.
ResourceType	String	stack	El tipo de recurso.
TagValue	String	TayValue1	El valor de etiqueta del recurso.
ResourceId	String	c754d2a4-28f1-46df-b557-9586173a****	El ID del recurso.
TagKey	String	TagKey1	La clave de etiqueta del recurso.

Ejemplos

Solicitudes de muestra

http(s)://ros.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=stack
&ResourceId.N=6bc589b5-9c02-4944-8fc3-f3624234****
&<Common request parameters>

Respuestas exitosas de muestra

Formato XML

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

<ListTagResourcesResponse>
	<RequestId>FFBB9725-261D-4321-B627-C98304200065</RequestId>
	<NextToken></NextToken>
	<TagResources>
		<ResourceId>c754d2a4-28f1-46df-b557-9586173a****</ResourceId>
		<TagKey>TagKey1</TagKey>
		<ResourceType>stack</ResourceType>
		<TagValue>TayValue1</TagValue>
	</TagResources>
</ListTagResourcesResponse>

Formato JSON

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

{
  "RequestId" : "FFBB9725-261D-4321-B627-C98304200065",
  "NextToken" : "",
  "TagResources" : [ {
    "ResourceId" : "c754d2a4-28f1-46df-b557-9586173a****",
    "TagKey" : "TagKey1",
    "ResourceType" : "stack",
    "TagValue" : "TayValue1"
  } ]
}

Códigos de error

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

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	One of the input parameters ResourceIds,Tags should be specified.	Mensaje de error devuelto porque no se especificaron los parámetros ResourceId.N y Tag.N. Especifique como mínimo uno de los parámetros.
400	InvalidParameter	The specified parameter ResourceType is invalid, {reason}.	Mensaje de error devuelto porque el parámetro ResourceType especificado no es válido. reason indica la causa del error.
400	InvalidParameter	The specified parameter Tags is invalid, {reason}.	Mensaje de error devuelto porque el parámetro Tag.N especificado no es válido. reason indica la causa del error.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Mensaje de error devuelto porque la clave de etiqueta especificada ya existe. Especifique una clave de etiqueta única.