TagResources - - Centro de documentación de Alibaba Cloud

Cree etiquetas y las agrega a los recursos especificados de Resource Orchestration Service (ROS).

Este tema proporciona un ejemplo sobre cómo crear una etiqueta y agregarla a un recurso en una pila. En este ejemplo, el ID del recurso es 7fee80e1-8c48-4c2f-8300-0f6dc40b****, la clave de la etiqueta es FinanceDept y el valor de la etiqueta es FinanceJoshua.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor 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 distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	TagResources	La operación que desea ejecutar. Establezca el valor en TagResources.
RegionId	String	Sí	cn-hangzhou	El ID de región de la etiqueta. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
ResourceType	String	Sí	stack	El tipo de recurso al que desea agregar la etiqueta. Valores válidos: stack: pila stackgroup: grupo de pilas template: plantilla templatescratch: escenario
ResourceId.N	String	Sí	7fee80e1-8c48-4c2f-8300-0f6dc40b****	El ID del recurso N. Especifique hasta 50 ID de recursos. Nota Si establece el parámetro ResourceType en stackgroup, use el nombre del grupo de pilas como ID del recurso.
Tag.N.Key	String	Sí	FinanceDept	La clave de la etiqueta N que desea agregar al recurso. Especifique hasta 20 claves de etiquetas. La clave de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. Tampoco puede comenzar con `aliyun` o `acs:`.
Tag.N.Value	String	Sí	FinanceJoshua	El valor de la etiqueta N que desea agregar al recurso. Especifique hasta 20 valores de etiquetas. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. Tampoco puede comenzar con `aliyun` o `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
RequestId	String	C46FF5A8-C5F0-4024-8262-B16B639225A0	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://ros.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=7fee80e1-8c48-4c2f-8300-0f6dc40b****
&ResourceType=stack
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<TagResourcesResponse>
        <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</TagResourcesResponse>

Formato JSON

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

{
  "RequestId" : "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

Códigos de error

Para ver la 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	InvalidParameter	The specified parameter ResourceType is invalid, {reason}.	Se devuelve este mensaje de error porque el parámetro ResourceType especificado no es válido. reason indica la causa del error.
400	InvalidParameter	The specified parameter ResourceIds is invalid, {reason}.	Se devuelve este mensaje de error porque los ID de recursos especificados no existen o su validación terminó con errores. reason indica la causa del error.
400	InvalidParameter	The specified parameter Tags is invalid, {reason}.	Se devuelve este mensaje de error 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.	Se devuelve este mensaje de error porque la clave de etiqueta especificada ya existe. Especifique una clave de etiqueta única.