TagResources - ApsaraMQ for RocketMQ - Centro de documentación de Alibaba Cloud

Descripción de la operación

Nota

Las operaciones de API proporcionadas por Alibaba Cloud se utilizan para administrar y consultar recursos de los servicios de Alibaba Cloud. Se recomienda integrar estas operaciones de API únicamente en sistemas de administración. No utilice estas operaciones de API en el sistema principal de servicios de mensajería. De lo contrario, pueden producirse riesgos en el sistema.

Puede llamar a esta operación para adjuntar etiquetas a un recurso. Puede utilizar etiquetas para clasificar recursos en ApsaraMQ for RocketMQ. Esto le ayuda a agregar y buscar recursos de manera eficiente.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

mq:TagResources

update

*All Resource

*

Ninguna

mq:QueryInstanceBaseInfo

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	No	El ID de la instancia de ApsaraMQ for RocketMQ que contiene el recurso al que desea adjuntar etiquetas. Nota Este parámetro es obligatorio cuando adjunta etiquetas a un tema o a un grupo.	MQ_INST_188077086902****_BXSuW61e
ResourceType	string	Sí	El tipo de recurso al que desea adjuntar etiquetas. Valores válidos: INSTANCE TOPIC GROUP	TOPIC
Tag	array<object>	Sí	Las etiquetas que desea adjuntar al recurso.
	object	No
Key	string	Sí	La clave de la etiqueta. Si configura este parámetro, también debe configurar el parámetro Value.**** El valor de este parámetro no puede ser una cadena vacía. Una clave de etiqueta debe tener entre 1 y 128 caracteres de longitud y no puede contener `http://` ni `https://`. Una clave de etiqueta no puede comenzar con `acs:` ni `aliyun`.	FinanceDept
Value	string	Sí	El valor de la etiqueta que desea adjuntar al recurso. Si configura este parámetro, también debe configurar el parámetro Key.**** El valor de este parámetro puede ser una cadena vacía. Un valor de etiqueta debe tener entre 1 y 128 caracteres de longitud y no puede contener `http://` ni `https://`. Un valor de etiqueta no puede comenzar con `acs:` ni `aliyun`.	FinanceJoshua
ResourceId	array	Sí	Los ID de los recursos.	TopicA
	string	No	El ID del recurso al que desea adjuntar una etiqueta. Si el recurso es una instancia de ApsaraMQ for RocketMQ, especifique el ID de la instancia. Si el recurso es un tema, especifique el nombre del tema. Si el recurso es un grupo, especifique el ID del grupo.	TopicA

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud. Este parámetro es un parámetro común. Cada solicitud tiene un ID único. Puede utilizar el ID para solucionar problemas.	301D2CBE-66F8-403D-AEC0-82582478****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "301D2CBE-66F8-403D-AEC0-82582478****"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.