Cree y agregue una etiqueta - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación TagResources para crear etiquetas y agregarlas a las instancias.

Si cuenta con un gran número de instancias, puede crear varias etiquetas y asignarlas a dichas instancias. Posteriormente, podrá filtrar estas instancias por etiqueta.

Una etiqueta se compone de una clave y un valor. Cada clave debe ser única dentro de una región para una cuenta de Alibaba Cloud. Distintas claves pueden asociarse al mismo valor.
Si la etiqueta que especifique no existe, se crea automáticamente y se agrega a la instancia indicada.
Si la clave de la etiqueta especificada coincide con la de una etiqueta existente, la nueva etiqueta sobrescribe a la anterior.
Puede agregar hasta 20 etiquetas a una instancia.
Puede agregar etiquetas a un máximo de 50 instancias en cada llamada.

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 diferentes 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 como TagResources.
RegionId	String	Sí	cn-hangzhou	El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista más reciente de regiones.
ResourceType	String	Sí	INSTANCE	El tipo de recurso. Establezca el valor como INSTANCE.
ResourceId.N	String	Sí	rm-uf6wjk5xxxxxxx	Los ID de las instancias. Puede agregar etiquetas a N instancias simultáneamente. Valores válidos de N: 1 a 50.
Tag.N.Key	String	Sí	testkey1	La clave de la etiqueta que desea agregar a la instancia. Puede crear N claves de etiqueta a la vez. Valores válidos de N: 1 a 20. El valor de este parámetro no puede ser una cadena vacía.
Tag.N.Value	String	No	testvalue1	El valor de etiqueta asociado a la clave especificada. Puede crear N valores de etiqueta simultáneamente. Valores válidos de N: 1 a 20. Este parámetro admite cadenas vacías.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	224DB9F7-3100-4899-AB9C-C938BCCB43E7	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<TagResourcesResponse>
<RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>

Formato JSON

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

{
  "RequestId" : "224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	NumberExceed.Tags	The maximum number of Tags is exceeded. The maximum value is 20.	Mensaje de error devuelto porque el número de etiquetas creadas supera el límite superior. Puede crear hasta 20 etiquetas por instancia.
400	MissingParameter	The parameter - Tags should not be null	Mensaje de error devuelto porque no se especificó el parámetro Tag.N.Key.
400	InvalidTagKey.Malformed	The Tag.N.Key parameter is blank	Mensaje de error devuelto porque el valor del parámetro Tag.N.Key es una cadena vacía.
400	InvalidTagValue.Malformed	The Tag.N.Value parameter is blank	Mensaje de error devuelto porque el valor del parámetro Tag.N.Value está vacío.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Mensaje de error devuelto porque el parámetro Tag.N.Key contiene una clave duplicada.
400	OperationDenied.QuotaExceed	The maximum number of Tags is exceeded.	Mensaje de error devuelto porque el número de etiquetas creadas excede el límite superior.
400	NumberExceed.ResourceIds	The maximum number of ResourceIds is exceeded. The maximum value is 50.	Mensaje de error devuelto porque el número de ID de instancia supera el límite superior. Puede especificar hasta 50 ID de instancia.
400	InvalidTagKey.Malformed	The operator is not permission for the system tag	Mensaje de error devuelto porque no tiene permiso para realizar operaciones en etiquetas del sistema.
400	Request.NotFound	The requested resource is not available.	Mensaje de error devuelto porque el recurso solicitado no está disponible.
400	InvalidTagValue.Malformed	The Tag.N.Value parameter is invalid.	Mensaje de error devuelto porque el valor del parámetro Tag.N.Value no es válido.

Para consultar la lista de códigos de error, visite el Centro de errores de API.