TagResources - - Centro de documentación de Alibaba Cloud

Crea etiquetas y las agrega a los recursos.

Notas de uso

Las etiquetas se usan para clasificar instancias. Cada etiqueta consta de una clave y un valor. Tenga en cuenta los siguientes límites al usar etiquetas:

Las claves de las etiquetas agregadas a la misma instancia deben ser únicas.
No es posible crear etiquetas sin agregarlas a instancias. Todas las etiquetas deben asociarse a instancias.
La información de las etiquetas no se comparte entre regiones.

Por ejemplo, en la región China (Shanghai) no se pueden consultar las etiquetas creadas en la región China (Hangzhou).
Las virtual private clouds (VPC), tablas de rutas, vSwitches y direcciones IP elásticas (EIP) que pertenecen a la misma cuenta de Alibaba Cloud y están desplegadas en la misma región comparten información de etiquetas entre sí.

Por ejemplo, si agregó una etiqueta a una VPC, dicha etiqueta estará disponible para los vSwitches, tablas de rutas y EIP que pertenezcan a la misma cuenta y estén desplegados en la misma región donde se creó la VPC. Seleccione esta etiqueta desde la página de edición sin necesidad de introducirla nuevamente. Modifique la clave y el valor de una etiqueta, o bien quite una etiqueta de una instancia. Al eliminar una instancia, también se eliminan todas las etiquetas asociadas a ella.
Se pueden agregar hasta 20 etiquetas por instancia. Antes de agregar una etiqueta, el sistema comprueba automáticamente la cantidad de etiquetas existentes. Si se alcanza el número máximo de etiquetas, se devuelve un mensaje de error.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda 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
ResourceType	String	Sí	VPC	El tipo de recurso. Valores válidos: VPC: una VPC VSWITCH: un vSwitch ROUTETABLE: una tabla de rutas EIP: una EIP VpnGateway: una puerta de enlace VPN NATGATEWAY: una puerta de enlace NAT COMMONBANDWIDTHPACKAGE: un plan de ancho de banda de EIP
RegionId	String	Sí	cn-hangzhou	El ID de región del recurso. Llame a la operación DescribeRegions para consultar la lista más reciente de regiones.
Action	String	Sí	TagResources	La operación que desea ejecutar. Establezca el valor en TagResources.
ResourceId.N	String	Sí	vpc-bp16qjewdsunr41m1****	El ID del recurso. Se pueden especificar hasta 20 ID.
Tag.N.Key	String	No	FinanceDept	La clave de la etiqueta que se agrega al recurso. Se pueden especificar hasta 20 claves de etiqueta. El valor de la etiqueta no puede ser una cadena vacía. La clave no puede exceder los 64 caracteres de longitud y puede contener dígitos, puntos (.), guiones bajos (_) y guiones (-). Debe comenzar con una letra, pero no puede iniciar con `aliyun` ni con `acs:`. Tampoco puede contener `http://` o `https://`.
Tag.N.Value	String	No	FinanceJoshua	El valor de la etiqueta que se agrega al recurso. Se pueden especificar hasta 20 valores de etiqueta. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta no puede exceder los 128 caracteres de longitud y puede contener dígitos, puntos (.), guiones bajos (_) y guiones (-). La clave debe comenzar con una letra, pero no puede iniciar con `aliyun` ni con `acs:`. Tampoco puede contener `http://` o `https://`.

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)://[Endpoint]/?ResourceType=VPC
&RegionId=cn-hangzhou
&Action=TagResources
&ResourceId=["vpc-bp16qjewdsunr41m1****"]
&Tag=[{"Key":"FinanceDept","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

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidTagKey	The tag keys are not valid.	El mensaje de error devuelto porque el índice de la etiqueta no es válido.
400	InvalidTagValue	The tag values are not valid.	El mensaje de error devuelto porque el valor de la etiqueta no es válido.
400	InvalidInstanceType.NotFound	The instance type is not found	El mensaje de error devuelto porque no se encontró el tipo de instancia.
400	InvalidInstanceIds.NotFound	The instanceIds are not found	El mensaje de error devuelto porque no se encontró el ID de la instancia.
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	El mensaje de error devuelto porque no tiene permisos para configurar el parámetro TagKeys.
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	El mensaje de error devuelto porque se alcanzó la cuota.
400	InvalidTagScope.NotFound	The tag scope is not found	El mensaje de error devuelto porque el ámbito del recurso no es válido.
400	Forbidden.TagKey.Duplicated	The specified tag key already exists.	El mensaje de error devuelto porque la clave de la etiqueta ya existe.
400	SizeLimitExceeded.TagNum	The maximum number of tags is exceeded.	El mensaje de error devuelto porque el número de etiquetas especificado supera el límite superior.
400	SizeLimitExceeded.ResourceId	The maximum number of resource IDs is exceeded.	El mensaje de error devuelto porque el número de ID de resource group especificado supera el límite superior.
400	MissingParameter.TagValue	The input parameter TagValue that is mandatory for processing this request is not supplied.	El mensaje de error devuelto porque no se estableció el parámetro TagValue.
400	MissingParameter.TagKey	The input parameter TagKey that is mandatory for processing this request is not supplied.	El mensaje de error devuelto porque no se estableció el parámetro TagKey.
403	Forbidden	User not authorized to operate on the specified resource.	El mensaje de error devuelto porque no está autorizado para realizar la operación en el recurso especificado. Obtenga los permisos necesarios e inténtelo de nuevo.

Para obtener una lista de códigos de error, visite el Centro de errores de API.