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.
UpdateThemePermissions
Actualiza los permisos de recursos para un tema. Los permisos se aplican a la acción para conceder o revocar permisos, por ejemplo"quicksight:DescribeTheme"
.
Los permisos de tema se aplican en las agrupaciones. Las agrupaciones válidas incluyen lo siguiente para los tres niveles de permisos, que son de usuario, propietario o sin permisos:
-
Usuario
-
"quicksight:DescribeTheme"
-
"quicksight:DescribeThemeAlias"
-
"quicksight:ListThemeAliases"
-
"quicksight:ListThemeVersions"
-
-
Propietario
-
"quicksight:DescribeTheme"
-
"quicksight:DescribeThemeAlias"
-
"quicksight:ListThemeAliases"
-
"quicksight:ListThemeVersions"
-
"quicksight:DeleteTheme"
-
"quicksight:UpdateTheme"
-
"quicksight:CreateThemeAlias"
-
"quicksight:DeleteThemeAlias"
-
"quicksight:UpdateThemeAlias"
-
"quicksight:UpdateThemePermissions"
-
"quicksight:DescribeThemePermissions"
-
-
Para no especificar ningún permiso, omita la lista de permisos.
Sintaxis de la solicitud
PUT /accounts/AwsAccountId
/themes/ThemeId
/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 laAWScuenta que está utilizando el tema.
Restitciones de longitud Longitud fija de 12.
Patrón:
^[0-9]{12}$
Obligatorio: Sí
- ThemeId
-
El ID del tema.
Restitciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+
Obligatorio: Sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- GrantPermissions
-
Una lista de los permisos de recursos que se van a conceder para el tema.
Type: Matriz deResourcePermissionobjects
Miembros de la matriz: Número máximo de 100 elementos.
Obligatorio: No
- RevokePermissions
-
Una lista de permisos de recursos que se van a revocar del tema.
Type: Matriz deResourcePermissionobjects
Miembros de la matriz: Número máximo de 100 elementos.
Obligatorio: No
Sintaxis de la respuesta
HTTP/1.1 Status
Content-type: application/json
{
"Permissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"RequestId": "string",
"ThemeArn": "string",
"ThemeId": "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.
- Permissions
-
La lista resultante de permisos de recursos para el tema.
Type: Matriz deResourcePermissionobjects
Miembros de la 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
- ThemeArn
-
Nombre de recurso de Amazon (ARN) del tema.
Type: Cadena
- ThemeId
-
El ID del tema.
Type: Cadena
Restitciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+
Errores
Para obtener información sobre los errores que son comunes a todas las acciones, consulteErrores comunes.
- AccessDeniedException
-
No tiene permiso de acceso a este elemento. 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 está utilizando las claves de acceso correctas 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
- 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
- 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 tiene las ediciones actuales de 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: