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.
UpdateDataSetPermissions
Actualiza los permisos de un conjunto de datos.
El recurso de permisos esarn:aws:quicksight:region:aws-account-id:dataset/data-set-id.
Sintaxis de la solicitud
POST /accounts/AwsAccountId/data-sets/DataSetId/permissions HTTP/1.1
Content-type: application/json
{
"GrantPermissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"RevokePermissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
]
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AwsAccountId
-
El ID de la cuenta de AWS.
Límites de longitud: Longitud fija de 12.
Patrón:
^[0-9]{12}$Obligatorio: Sí
- DataSetId
-
ID del conjunto de datos cuyos permisos desea actualizar. Este ID es único porRegión de AWSpara cada)AWSaccount.
Obligatorio: Sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- GrantPermissions
-
Los permisos de recurso que desea conceder al conjunto de datos.
Type: Matriz deResourcePermissionobjects
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.
Obligatorio: No
- RevokePermissions
-
Los permisos de recurso que desea revocar del conjunto de datos.
Type: Matriz deResourcePermissionobjects
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.
Obligatorio: No
Sintaxis de la respuesta
HTTP/1.1 Status
Content-type: application/json
{
"DataSetArn": "string",
"DataSetId": "string",
"RequestId": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.
- Status
-
El estado HTTP de la solicitud.
El servicio devuelve los datos siguientes en formato JSON.
- DataSetArn
-
El nombre de recurso de Amazon (ARN) del conjunto de datos.
Type: Cadena
- DataSetId
-
ID del conjunto de datos cuyos permisos desea actualizar. Este ID es único porRegión de AWSpara cada)AWSaccount.
Type: Cadena
- RequestId
-
LaAWSID de solicitud de esta operación.
Type: Cadena
Errores
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 esté autorizada para usar Amazon QuickSight , que sus políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.
Código de estado HTTP: 401
- ConflictException
-
La actualización o eliminación de un recurso puede provocar un estado incoherente.
Código de estado HTTP: 409
- 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
- ResourceNotFoundException
-
No se encontraron uno o varios recursos.
Código de estado HTTP: 404
- ThrottlingException
-
El acceso está limitado.
Código de estado HTTP: 429
Ejemplos
Ejemplo
Este ejemplo ilustra un uso de UpdateDataSetPermissions.
Solicitud de muestra
POST /accounts/{AwsAccountId}/data-sets/{DataSetId}/permissions HTTP/1.1
Content-type: application/jsonVé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:
