DeletePrincipalMapping - Amazon Kendra

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 pasantes que pertenecían a ese grupo ya no ven documentos exclusivos para pasantes en sus resultados de búsqueda.

Si desea eliminar o reemplazar usuarios o subgrupos de un grupo, debe usar laPutPrincipalMapping. Por ejemplo, si un usuario del grupo «Ingeniería» deja el equipo de ingeniería y otro usuario ocupa su lugar, debe proporcionar una lista actualizada de usuarios o subgrupos que pertenecen al grupo «Ingeniería» al llamarPutPrincipalMapping. Puede actualizar su lista interna de usuarios o subgrupos e introducir esta lista al llamarPutPrincipalMapping.

DeletePrincipalMappingno se admite actualmente enAWS GovCloud (EE.UU. Oeste).

Sintaxis de la solicitud

{ "DataSourceId": "string", "GroupId": "string", "IndexId": "string", "OrderingId": number }

Parámetros de solicitud

Para obtener información sobre parámetros que son comunes a todas opciones, consulteParámetros comunes.

La solicitud acepta los siguientes datos en formato JSON.

DataSourceId

Identificador de la fuente de datos de la que desea eliminar un grupo.

Un grupo puede estar vinculado a varias fuentes de datos. Puede eliminar el acceso de un grupo 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.

Type: Cadena

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

Identificador del grupo que desea eliminar.

Type: Cadena

Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 1024 caracteres.

Patrón: ^\P{C}*$

Obligatorio: Sí

IndexId

Identificador del índice del que desea eliminar un grupo.

Type: Cadena

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 el últimoDELETEacción con acciones anteriores. El número de identificación más alto, que es el número de pedido, es la acción más reciente que desea procesar y aplicar, además de otras acciones con números de identificación más bajos. Esto evita que las acciones anteriores con números de ID más bajos anulen la última acción.

El identificador de pedido puede ser la hora de UNIX de la última actualización que realizó en la lista de miembros de un grupo. A continuación, debe proporcionar esta lista al llamarPutPrincipalMapping. Esto asegura queDELETEla acción para ese grupo actualizado con la lista de miembros más reciente no se sobrescribe con la anteriorDELETEacciones para el mismo grupo que aún no se han procesado.

El identificador de pedido predeterminado es el tiempo UNIX actual en milisegundos durante el que Amazon Kendra recibió la acción.

Type: 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 errores que son comunes a todas opciones, consulteErrores comunes.

AccessDeniedException

Código de estado HTTP: 400

ConflictException

Código de estado HTTP: 400

InternalServerException

Código de estado HTTP: 500

ResourceNotFoundException

Código de estado HTTP: 400

ThrottlingException

Código de estado HTTP: 400

ValidationException

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: