TagResources - - Centro de documentación de Alibaba Cloud

Crea y agrega etiquetas a los recursos especificados de Elastic Compute Service (ECS).

Notas de uso

Antes de agregar etiquetas a un recurso, Alibaba Cloud comprueba la cantidad de etiquetas existentes en dicho recurso. Si se alcanza el número máximo de etiquetas, se devuelve un mensaje de error. Para obtener más información, consulte la sección "Límites de etiquetas" en Limits.

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í	TagResources	La operación que desea ejecutar. Establezca el valor en TagResources.
RegionId	String	Sí	cn-hangzhou	ID de región del recurso. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
ResourceType	String	Sí	instance	Tipo de recurso. Valores válidos: instance: instancia de ECS disk: disco snapshot: instantánea image: imagen securitygroup: security group volume: volumen de almacenamiento eni: interfaz de red elástica (ENI) ddh: host dedicado ddhcluster: clúster de hosts dedicados keypair: key pair SSH launchtemplate: plantilla de lanzamiento reservedinstance: reserved instance snapshotpolicy: política de instantáneas automáticas elasticityassurance: garantía de elasticidad capacityreservation: reserva de capacidad command: comando de Cloud Assistant invocation: resultado de ejecución de comando de Cloud Assistant o resultado de entrega de archivo activation: código de activación para la instancia administrada de Cloud Assistant managedinstance: instancia administrada de Cloud Assistant
ResourceId.N	String	Sí	r-XXX	ID del recurso N. Valores válidos de N: 1 a 50.
Tag.N.Key	String	Sí	TestKey	Clave de la etiqueta N que se agregará al recurso. Valores válidos de N: 1 a 20. La clave no puede ser una cadena vacía, tener más de 128 caracteres ni contener `http://` o `https://`. Tampoco puede comenzar con `acs:` ni `aliyun`.
Tag.N.Value	String	Sí	TestValue	Valor de la etiqueta N que se agregará al recurso. Valores válidos de N: 1 a 20. El valor puede ser una cadena vacía, tener hasta 128 caracteres y no debe contener `http://` ni `https://`. Tampoco puede comenzar con `acs:`.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=i-bp1j6qtvdm8w0z1o0****
&ResourceId.2=i-bp1j6qtvdm8w0z1oP****
&ResourceType=instance
&Tag.1.Key=TestKey
&<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

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clave de la etiqueta ya existe. Las claves de las etiquetas deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key no válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value no válido.
400	OperationDenied.QuotaExceed	The quota of tags on resource is beyond permitted range.	Se superó el número máximo de etiquetas.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Los parámetros Tag.N.Key y Tag.N.Value especificados no se corresponden entre sí.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Se superó el número máximo de etiquetas.
400	Invalid.Scope	The specified scope is invalid.	Valor de Scope no válido.
403	PermissionDenied.TagOwnerUid	The specified operator not have permission to set TagOwnerUid value.	No tiene autorización para especificar el parámetro TagOwnerUid.
403	PermissionDenied.Scope	The specified operator not have permission to set Scope value.	No tiene autorización para especificar el parámetro Scope.
403	InvalidResourceId.NotSupported	The specified ResourceId does not support tagging.	El recurso especificado no admite etiquetado.
403	NoPermission.Tag	The operator is not permission for the tag.	No tiene autorización para gestionar la etiqueta.
403	QuotaExceed.Tags	%s	Se superó el número máximo de etiquetas. %s es una variable. Se devuelve dinámicamente un mensaje de error según las condiciones de la llamada.
404	InvalidRegionId.NotFound	%s	El ID de región especificado no existe.
404	MissingParameter.ResourceType	The parameter - ResourceType should not be null.	El parámetro ResourceType es obligatorio.
404	InvalidResourceId.NotFound	The specified ResourceIds are not found in our records.	El recurso especificado no existe. Compruebe si el parámetro ResourceId es correcto.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	No se encontró el tipo de recurso especificado.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	El ID de región especificado no existe.
500	ServiceUnavailable	The service is unavailable, please try again later.	El servicio no está available temporalmente. Inténtelo de nuevo más tarde.

Para ver la lista de códigos de error, consulte Códigos de error del servicio.