Acciones, recursos y claves de condición para Amazon Kendra

PDF

Amazon Kendra (prefijo de servicio: kendra) proporciona las siguientes claves de contexto de condición, acciones y recursos específicas del servicio para usarlas en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Acciones definidas por Amazon Kendra

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
AssociateEntitiesToExperience	Otorga permiso para colocar el mapeo de entidades principales en el índice	Escritura	experience*
			index*
AssociatePersonasToEntities	Define los permisos específicos de los usuarios o grupos en su fuente de identidad de AWS SSO con acceso a su experiencia de Amazon Kendra	Escritura	experience*
			index*
BatchDeleteDocument	Concede permiso para documento de eliminación por lotes	Escritura	index*
BatchDeleteFeaturedResultsSet	Concede permiso para eliminar un conjunto de resultados destacados	Escritura	featured-results-set*
			index*
BatchGetDocumentStatus	Otorga permiso para obtener el estado del documento por lotes	Lectura	index*
BatchPutDocument	Otorga permiso para documento de inserción por lotes	Escritura	index*
ClearQuerySuggestions	Otorga permiso para borrar las sugerencias de un índice determinado generadas hasta el momento	Escritura	index*
CreateAccessControlConfiguration	Concede permiso para crear una configuración del control de acceso	Escritura	index*
CreateDataSource	Concede permiso para crear un origen de datos	Escritura	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateExperience	Crea una experiencia de Amazon Kendra, como una aplicación de búsqueda	Escritura	index*
CreateFaq	Otorga permiso para crear una pregunta frecuente	Escritura	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateFeaturedResultsSet	Concede permiso para crear un conjunto de resultados destacados	Escritura	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	Otorga permiso para crear un índice	Escritura		aws:RequestTag/${TagKey} aws:TagKeys
CreateQuerySuggestionsBlockList	Otorga permiso para crear un QuerySuggestions BlockList	Escritura	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateThesaurus	Otorga permiso para crear un diccionario	Escritura	index*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAccessControlConfiguration	Concede permiso para eliminar una configuración del control de acceso	Escritura	access-control-configuration*
			index*
DeleteDataSource	Concede permiso para eliminar un origen de datos	Escritura	data-source*
			index*
DeleteExperience	Elimina la experiencia de Amazon Kendra, como una aplicación de búsqueda	Escritura	experience*
			index*
DeleteFaq	Otorga permiso para eliminar una pregunta frecuente	Escritura	faq*
			index*
DeleteIndex	Otorga permiso para eliminar un índice	Escritura	index*
DeletePrincipalMapping	Otorga permiso para eliminar el mapeo principal del índice	Escritura	index*
			data-source
DeleteQuerySuggestionsBlockList	Otorga permiso para eliminar un QuerySuggestions BlockList	Escritura	index*
			query-suggestions-block-list*
DeleteThesaurus	Otorga permiso para eliminar un diccionario	Escritura	index*
			thesaurus*
DescribeAccessControlConfiguration	Concede permiso para describir una configuración del control de acceso	Lectura	access-control-configuration*
			index*
DescribeDataSource	Concede permiso para describir un origen de datos	Lectura	data-source*
			index*
DescribeExperience	Obtiene información sobre la experiencia de Amazon Kendra, como una aplicación de búsqueda	Lectura	experience*
			index*
DescribeFaq	Otorga permiso para describir una pregunta frecuente	Lectura	faq*
			index*
DescribeFeaturedResultsSet	Concede permiso para describir un conjunto de resultados destacados	Lectura	featured-results-set*
			index*
DescribeIndex	Otorga permiso para describir un índice	Lectura	index*
DescribePrincipalMapping	Otorga permiso para describir el mapeo de entidades principales del índice	Lectura	index*
			data-source
DescribeQuerySuggestionsBlockList	Otorga permiso para describir un QuerySuggestions BlockList	Lectura	index*
			query-suggestions-block-list*
DescribeQuerySuggestionsConfig	Otorga permiso para describir la configuración de sugerencias de consulta para un índice	Lectura	index*
DescribeThesaurus	Otorga permiso para describir un diccionario	Lectura	index*
			thesaurus*
DisassociateEntitiesFromExperience	Impide que los usuarios o grupos de su fuente de identidad de AWS SSO accedan a su experiencia de Amazon Kendra	Escritura	experience*
			index*
DisassociatePersonasFromEntities	Elimina los permisos específicos de los usuarios o grupos de tu fuente de identidad de AWS SSO con acceso a tu experiencia con Amazon Kendra	Escritura	experience*
			index*
GetQuerySuggestions	Otorga permiso para obtener sugerencias para un prefijo de consulta	Lectura	index*
GetSnapshots	Recupera los datos de las métricas de búsqueda	Lectura	index*
ListAccessControlConfigurations	Concede permiso para enumerar la configuración del control de acceso	Enumeración	index*
ListDataSourceSyncJobs	Concede permiso para obtener el historial de trabajos de sincronización de orígenes de datos	Enumeración	data-source*
			index*
ListDataSources	Otorga permiso para enumerar los orígenes de datos	Enumeración	index*
ListEntityPersonas	Muestra los permisos específicos de los usuarios y grupos con acceso a la experiencia de Amazon Kendra	Enumeración	experience*
			index*
ListExperienceEntities	Muestra los usuarios o grupos de su fuente de identidad de AWS SSO a los que se les ha concedido acceso a su experiencia de Amazon Kendra	Enumeración	experience*
			index*
ListExperiences	Muestra una lista de una o más experiencias de Amazon Kendra. Puede crear una experiencia de Amazon Kendra como una aplicación de búsqueda	Enumeración	index*
ListFaqs	Otorga permiso para enumerar las preguntas frecuentes	Enumeración	index*
ListFeaturedResultsSets	Concede permiso para enumerar los conjuntos de resultados destacados	Enumeración	index*
ListGroupsOlderThanOrderingId	Otorga permiso para enumerar los grupos que son más antiguos que un ID de pedido	Enumeración	index*
			data-source
ListIndices	Otorga permiso para enumerar los índices	Enumeración
ListQuerySuggestionsBlockLists	Otorga permiso para incluir los QuerySuggestions BlockLists	Enumeración	index*
ListTagsForResource	Concede permiso para enumerar las etiquetas de un recurso	Lectura	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
ListThesauri	Otorga permiso para enumerar los diccionarios	Enumeración	index*
PutPrincipalMapping	Otorga permiso para colocar el mapero de principales en el índice	Escritura	index*
			data-source
Query	Otorga permiso para consultar los documentos y las preguntas frecuentes	Lectura	index*
Retrieve	Concede permiso para recuperar contenido relevante de un índice	Lectura	index*
StartDataSourceSyncJob	Otorga permiso para iniciar el trabajo de sincronización de orígenes de datos	Escritura	data-source*
			index*
StopDataSourceSyncJob	Otorga permiso para detener el trabajo de sincronización de orígenes de datos	Escritura	data-source*
			index*
SubmitFeedback	Otorga permiso para enviar comentarios sobre los resultados de una consulta	Escritura	index*
TagResource	Concede permiso para etiquetar un recurso con pares de valores de clave dados	Etiquetado	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede permiso para eliminar de un recurso la etiqueta con la clave dada	Etiquetado	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
				aws:TagKeys
UpdateAccessControlConfiguration	Concede permiso para actualizar una configuración del control de acceso	Escritura	access-control-configuration*
			index*
UpdateDataSource	Concede permiso para actualizar un origen de datos	Escritura	data-source*
			index*
UpdateExperience	Actualiza su experiencia de Amazon Kendra, como una aplicación de búsqueda	Escritura	index*
UpdateFeaturedResultsSet	Concede permiso para actualizar un conjunto de resultados destacados	Escritura	featured-results-set*
			index*
UpdateIndex	Otorga permiso para actualizar un índice	Escritura	index*
UpdateQuerySuggestionsBlockList	Otorga permiso para actualizar un QuerySuggestions BlockList	Escritura	index*
			query-suggestions-block-list*
UpdateQuerySuggestionsConfig	Otorga permiso para actualizar la configuración de sugerencias de consulta para un índice	Escritura	index*
UpdateThesaurus	Otorga permiso para actualizar un diccionario	Escritura	index*
			thesaurus*

Tipos de recursos definidos por Amazon Kendra

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
index	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}	aws:ResourceTag/${TagKey}
data-source	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/data-source/${DataSourceId}	aws:ResourceTag/${TagKey}
faq	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/faq/${FaqId}	aws:ResourceTag/${TagKey}
experience	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/experience/${ExperienceId}
thesaurus	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/thesaurus/${ThesaurusId}	aws:ResourceTag/${TagKey}
query-suggestions-block-list	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/query-suggestions-block-list/${QuerySuggestionsBlockListId}	aws:ResourceTag/${TagKey}
featured-results-set	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/featured-results-set/${FeaturedResultsSetId}	aws:ResourceTag/${TagKey}
access-control-configuration	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/access-control-configuration/${AccessControlConfigurationId}

Claves de condición para Amazon Kendra

Amazon Kendra define las siguientes claves de condiciones que se pueden utilizar en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso por las etiquetas que se pasan en la solicitud	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por las etiquetas asociadas al recurso	Cadena
aws:TagKeys	Filtra el acceso por las claves de etiquetas que se pasan en la solicitud	ArrayOfString