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.
UpdateAnalysisPermissions
Actualiza los permisos de lectura y escritura de un análisis.
Sintaxis de la solicitud
PUT /accounts/AwsAccountId/analyses/AnalysisId/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.
- AnalysisId
-
El ID del análisis cuyos permisos está actualizando. El ID forma parte de la URL de análisis.
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+Obligatorio: Sí
- AwsAccountId
-
El ID de laAWScuenta que contiene el análisis cuyos permisos está actualizando. Debe utilizar laAWScuenta en la que se encuentra el análisis.
Limitaciones de longitud Longitud fija de 12.
Patrón:
^[0-9]{12}$Obligatorio: Sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- GrantPermissions
-
Una estructura que describe los permisos para agregar y la entidad principal a la que se deben agregar.
Type: Matriz deResourcePermissionobjects
Miembros de matriz: Número máximo de 100 elementos.
Obligatorio: No
- RevokePermissions
-
Estructura que describe los permisos que se van a eliminar y la entidad principal de la que se van a eliminar.
Type: Matriz deResourcePermissionobjects
Miembros de matriz: Número máximo de 100 elementos.
Obligatorio: No
Sintaxis de la respuesta
HTTP/1.1 Status
Content-type: application/json
{
"AnalysisArn": "string",
"AnalysisId": "string",
"Permissions": [
{
"Actions": [ "string" ],
"Principal": "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.
- AnalysisArn
-
El nombre de recurso de Amazon (ARN) del análisis que ha actualizado.
Type: Cadena
- AnalysisId
-
El ID del análisis para el que ha actualizado los permisos para.
Type: Cadena
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+ - Permissions
-
Estructura que describe los principales y los permisos de nivel de recursos en un análisis.
Type: Matriz deResourcePermissionobjects
Miembros de matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.
- RequestId
-
LaAWSID de solicitud para esta operación.
Type: Cadena
Errores
Para obtener información sobre los errores que son comunes a todas las acciones, consulteErrores comunes.
- 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 encuentran uno o varios recursos.
Código de estado HTTP: 404
- ThrottlingException
-
El acceso está limitado.
Código de estado HTTP: 429
- UnsupportedUserEditionException
-
Este error indica que está llamando a una operación en Amazon QuickSighten la que la edición no incluye soporte para esa operación. Amazon Amazon QuickSight en la actualidad, Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.
Código de estado HTTP: 403
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:
