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.
DeletePrincipalMapping
Elimina un grupo para que todos los usuarios y subgrupos que pertenecen al grupo ya no puedan acceder a los documentos que solo están disponibles para ese grupo.
Por ejemplo, después de eliminar el grupo «Pasantes de verano», todos los becarios que pertenecían a ese grupo ya no verán los documentos exclusivos para pasantes en sus resultados de búsqueda.
Si desea eliminar o reemplazar usuarios o subgrupos de un grupo, debe utilizar laPutPrincipalMapping operación. Por ejemplo, si un usuario del grupo «Ingeniería» deja el equipo de ingeniería y otro usuario ocupa su lugar, al llamar se proporciona una lista actualizada de los usuarios o subgrupos que pertenecen al grupo «Ingeniería»PutPrincipalMapping. Puede actualizar su lista interna de usuarios o subgrupos e introducir esta lista cuando llamePutPrincipalMapping.
DeletePrincipalMappingactualmente no se admite en la regiónAWS GovCloud (EE. UU.).
Sintaxis de la solicitud
{
"DataSourceId": "string",
"GroupId": "string",
"IndexId": "string",
"OrderingId": number
}Parámetros de solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- DataSourceId
-
El identificador de la fuente de datos.
Un grupo puede estar vinculado a varias fuentes de datos. Puede eliminar un grupo para que no pueda acceder a los documentos de una fuente de datos determinada. Por ejemplo, los grupos «Investigación», «Ingeniería» y «Ventas y marketing» están todos vinculados a los documentos de la empresa almacenados en las fuentes de datos Confluence y Salesforce. Desea eliminar los grupos de «Investigación» e «Ingeniería» de Salesforce para que estos grupos no puedan acceder a los documentos relacionados con los clientes almacenados en Salesforce. Solo «Ventas y marketing» debe acceder a los documentos de la fuente de datos de Salesforce.
Tipo: String
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100. caracteres.
Patrón:
[a-zA-Z0-9][a-zA-Z0-9_-]*Obligatorio: no
- GroupId
-
El identificador del grupo que recomendamos eliminar.
Tipo: String
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.
Patrón:
^\P{C}*$Obligatorio: sí
- IndexId
-
El identificador del índice del que recomendamos eliminar un grupo de.
Tipo: String
Limitaciones de longitud: longitud fija de 36.
Patrón:
[a-zA-Z0-9][a-zA-Z0-9-]*Obligatorio: sí
- OrderingId
-
El identificador de marca de tiempo que especifique para garantizar que Amazon Kendra no anule la última
DELETEacción con las acciones anteriores. El identificador numérico más alto, que es el identificador del pedido, es la última acción que desea procesar y aplicar además de otras acciones con números de ID más bajos. Esto evita que las acciones anteriores con números de identificación más bajos puedan anular la acción más reciente.El identificador de pedido puede ser la hora en Unix de la última actualización que realizó en la lista de miembros de un grupo. A continuación, deberá proporcionar esta lista cuando llame
PutPrincipalMapping. Esto garantiza que laDELETEacción que realices para ese grupo actualizado con la lista de miembros más reciente no se sobrescriba conDELETElas acciones anteriores del mismo grupo que aún no se han procesado.El identificador de pedido predeterminado es la hora actual de Unix en milisegundos desde que Amazon Kendra recibió la acción.
Tipo: largo
Rango válido: valor mínimo de 0. Valor máximo de 32535158400000.
Obligatorio: no
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción. Asegúrese de contar con las políticas de permisos y las cuentas de usuario necesarias e inténtelo de nuevo.
Código de estado HTTP: 400
- ConflictException
-
Se ha producido un conflicto con la solicitud. Corrija cualquier incoherencia con sus recursos e inténtelo de nuevo.
Código de estado HTTP: 400
- InternalServerException
-
Se ha producido un problema con el servidor interno utilizado para el servicio Amazon Kendra. Espera unos minutos e inténtalo de nuevo o ponte en contacto con el servicio de Support
para obtener ayuda. Código de estado HTTP: 500
- ResourceNotFoundException
-
El recurso que quieres usar no existe. Compruebe que ha proporcionado el recurso correcto e inténtelo de nuevo.
Código de estado HTTP: 400
- ThrottlingException
-
La solicitud se denegó debido a una limitación controlada. Reduzca el número de solicitudes e inténtelo de nuevo.
Código de estado HTTP: 400
- ValidationException
-
La entrada no satisface las limitaciones que especifica Amazon Kendra de. Introduzca la entrada correcta e inténtelo de nuevo.
Código de estado HTTP: 400
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:
