TagResource -

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

TagResource

Asigna una o varias etiquetas (pares clave-valor) al recurso QuickSight especificado.

Las etiquetas pueden ayudar a organizar y clasificar los recursos. También puede utilizarlas para lograr permisos de usuario, concediendo a un usuario permiso para acceder o cambiar sólo recursos con determinados valores de etiqueta. Puede utilizarTagResourcecon un recurso que ya tiene etiquetas. Si especifica una nueva clave de etiqueta para el recurso, esta etiqueta se anexa a la lista de etiquetas asociadas al recurso. Si especifica una clave de etiqueta que ya está asociada al recurso, el nuevo valor de etiqueta que especifique reemplaza el valor anterior de esa etiqueta.

Puede asociar hasta 50 etiquetas a un recurso. QuickSight admite el etiquetado del conjunto de datos, el origen de datos, el panel y la plantilla.

El etiquetado para QuickSight funciona de manera similar al etiquetado para otros servicios de AWS, excepto lo siguiente:

  • No puede utilizar etiquetas para realizar un seguimiento de los costes de AWS para QuickSight. Esta restricción se debe a que los costos de QuickSight se basan en los usuarios y la capacidad de SPICE, que no son recursos identificables.

  • QuickSight no admite actualmente el Editor de etiquetas para Resource Groups de AWS.

Sintaxis de la solicitud

POST /resources/ResourceArn/tags HTTP/1.1 Content-type: application/json { "Tags": [ { "Key": "string", "Value": "string" } ] }

Parámetros de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

ResourceArn

El nombre de recurso de Amazon (ARN) del recurso que desea etiquetar.

: obligatorio Sí

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

Etiquetas

Contiene un mapa de los pares clave-valor para la etiqueta o etiquetas de recurso asignadas al recurso.

Tipo: Array deTagobjects

Miembros de Array Número mínimo de 1 elemento. Número máximo de 200 elementos.

: obligatorio Sí

Sintaxis de la respuesta

HTTP/1.1 Status Content-type: application/json { "RequestId": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve la respuesta HTTP siguiente.

Estado

El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

RequestId

ID de solicitud de AWS de esta operación.

Tipo: Cadena

Errors

Para obtener información sobre errores que son comunes a todas las acciones, consulteErrores comunes.

AccessDeniedException

No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta tiene permiso para utilizar el servicio de Amazon QuickSight, que las políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.

Código de estado HTTP: 401

InternalFailureException

Se produjo un error interno.

Código de estado HTTP: 500

InvalidParameterValueException

Uno o más parámetros tienen un valor que no es válido.

Código de estado HTTP: 400

LimitExceededException

Se superó un límite.

Código de estado HTTP: 409

ResourceNotFoundException

No se encuentran uno o varios recursos.

Código de estado HTTP: 404

ThrottlingException

El acceso está limitado.

Código de estado HTTP: 429

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: