# Acciones, recursos y claves de condición para AWS Búsqueda de Backup
<a name="list_backupsearch"></a>

AWS Backup Search (prefijo de servicio:`backup-search`) proporciona las siguientes operaciones, recursos, acciones y claves de condición específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:
+ Obtenga información para [configurar este servicio](https://docs.aws.amazon.com/aws-backup/latest/devguide/).
+ Vea una [lista de las operaciones de API disponibles para este servicio](https://docs.aws.amazon.com/aws-backup/latest/devguide/).
+ Obtenga información sobre cómo proteger este servicio y sus recursos [mediante las políticas de permisos de IAM](https://docs.aws.amazon.com/aws-backup/latest/devguide/security-considerations.html#authentication).
+ Consulte la referencia de [autorización de servicio programática de este servicio](https://servicereference.us-east-1.amazonaws.com/v1/backup-search/backup-search.json).

**Topics**
+ [Las operaciones de la API se definen mediante AWS Búsqueda de Backup](#list_backupsearch-operations)
+ [Acciones definidas por AWS Búsqueda de Backup](#list_backupsearch-actions-as-permissions)
+ [Tipos de recursos definidos por AWS Búsqueda de Backup](#list_backupsearch-resources-for-iam-policies)
+ [Claves de condición para AWS Búsqueda de Backup](#list_backupsearch-policy-keys)

## Las operaciones de la API se definen mediante AWS Búsqueda de Backup
<a name="list_backupsearch-operations"></a>

En la siguiente tabla, se asignan las operaciones de la API a las acciones de IAM que autorizan. Solo se muestran las claves de condición que tienen valores estáticos para la API y la acción determinadas; para ver el conjunto completo de claves de condición que admite cada acción, consulte la [tabla de acciones](#list_backupsearch-actions-as-permissions).




- **   GetSearchJob  **
  - **Acción de IAM:**  [búsqueda de respaldo: GetSearchJob](#list_backupsearch-action-GetSearchJob) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   GetSearchResultExportJob  **
  - **Acción de IAM:**  [búsqueda de copias de seguridad: GetSearchResultExportJob](#list_backupsearch-action-GetSearchResultExportJob) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   ListSearchJobBackups  **
  - **Acción de IAM:**  [búsqueda de copias de seguridad: ListSearchJobBackups](#list_backupsearch-action-ListSearchJobBackups) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   ListSearchJobResults  **
  - **Acción de IAM:**  [búsqueda de copias de seguridad: ListSearchJobResults](#list_backupsearch-action-ListSearchJobResults) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   ListSearchJobs  **
  - **Acción de IAM:**  [búsqueda de copias de seguridad: ListSearchJobs](#list_backupsearch-action-ListSearchJobs) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Enumeración

- **   ListSearchResultExportJobs  **
  - **Acción de IAM:**  [búsqueda de copias de seguridad: ListSearchResultExportJobs](#list_backupsearch-action-ListSearchResultExportJobs) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Enumeración

- **   ListTagsForResource  **
  - **Acción de IAM:**  [búsqueda de respaldo: ListTagsForResource](#list_backupsearch-action-ListTagsForResource) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   StartSearchJob  **
  - **Acción de IAM:**  [búsqueda de respaldo: StartSearchJob](#list_backupsearch-action-StartSearchJob)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Escritura
  - **Acción de IAM:**  [búsqueda de respaldo: TagResource](#list_backupsearch-action-TagResource)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Etiquetar, escribir

- **   StartSearchResultExportJob  **
  - **Acción de IAM:**  [búsqueda de respaldo: StartSearchResultExportJob](#list_backupsearch-action-StartSearchResultExportJob)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Escritura
  - **Acción de IAM:**  [búsqueda de respaldo: TagResource](#list_backupsearch-action-TagResource)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Etiquetar, escribir
  - **Acción de IAM:**  [objetivo: PassRole](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html)  / **Clave de condición:** objetivo: PassedToService / **Valores posibles:** backup-search.amazonaws.com / **Nivel de acceso:** Escritura

- **   StopSearchJob  **
  - **Acción de IAM:**  [búsqueda de copias de seguridad: StopSearchJob](#list_backupsearch-action-StopSearchJob) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Escritura

- **   TagResource  **
  - **Acción de IAM:**  [búsqueda de respaldo: TagResource](#list_backupsearch-action-TagResource) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Etiquetar, escribir

- **   UntagResource  **
  - **Acción de IAM:**  [búsqueda de respaldo: UntagResource](#list_backupsearch-action-UntagResource) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Etiquetar, escribir



## Acciones definidas por AWS Búsqueda de Backup
<a name="list_backupsearch-actions-as-permissions"></a>

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.




- **   [GetSearchJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_GetSearchJob.html)  **
  - **Description (Descripción):** Concede permiso para obtener detalles de un trabajo de búsqueda.
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo\*](#list_backupsearch-resource-searchJob)
  - **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [GetSearchResultExportJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_GetSearchResultExportJob.html)  **
  - **Description (Descripción):** Concede permiso para obtener detalles de un trabajo de exportación de resultados de búsqueda.
  - **Tipos de recursos (\*necesarios):** [buscar \* ExportJob](#list_backupsearch-resource-searchExportJob)
  - **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [ListSearchJobBackups](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_ListSearchJobBackups.html)  **
  - **Description (Descripción):** Concede permiso para enumerar las copias de seguridad en el alcance de un trabajo de búsqueda.
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo\*](#list_backupsearch-resource-searchJob)
  - **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [ListSearchJobResults](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_ListSearchJobResults.html)  **
  - **Description (Descripción):** Concede permiso para enumerar los resultados de un trabajo de búsqueda.
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo\*](#list_backupsearch-resource-searchJob)
  - **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [ListSearchJobs](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_ListSearchJobs.html)  **
  - **Description (Descripción):** Concede permiso para enumerar trabajos de búsqueda.
  - **Tipos de recursos (\*necesarios):** 
  - **Claves de condición:**  
  - **Nivel de acceso:** Enumeración

- **   [ListSearchResultExportJobs](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_ListSearchResultExportJobs.html)  **
  - **Description (Descripción):** Concede permiso para enumerar trabajos de exportación de resultados de búsqueda.
  - **Tipos de recursos (\*necesarios):** 
  - **Claves de condición:**  
  - **Nivel de acceso:** Enumeración

- **   [ListTagsForResource](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_ListTagsForResource.html)  **
  - **Description (Descripción):** Concede permiso para enumerar las etiquetas de un recurso
  - **Tipos de recursos (\*necesarios):** [searchExportJob](#list_backupsearch-resource-searchExportJob) / **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo](#list_backupsearch-resource-searchJob) / **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [StartSearchJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_StartSearchJob.html)  **
  - **Description (Descripción):** Concede permiso para crear un trabajo de búsqueda.
  - **Tipos de recursos (\*necesarios):** 
  - **Claves de condición:** [aws: RequestTag /$ {} TagKey](#list_backupsearch-aws_RequestTag___TagKey_)<br />[aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_backupsearch-aws_TagKeys)
  - **Nivel de acceso:** Escritura

- **   [StartSearchResultExportJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_StartSearchResultExportJob.html)  **
  - **Description (Descripción):** Concede permiso para iniciar un trabajo de exportación para un trabajo de búsqueda existente.
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo\*](#list_backupsearch-resource-searchJob)
  - **Claves de condición:** [aws: RequestTag /$ {} TagKey](#list_backupsearch-aws_RequestTag___TagKey_)<br />[aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_backupsearch-aws_TagKeys)
  - **Nivel de acceso:** Escritura

- **   [StopSearchJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_StopSearchJob.html)  **
  - **Description (Descripción):** Concede permiso para detener un trabajo de búsqueda en curso.
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo\*](#list_backupsearch-resource-searchJob)
  - **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Escritura

- **   [TagResource](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_TagResource.html)  **
  - **Description (Descripción):** Concede permiso para etiquetar un recurso
  - **Tipos de recursos (\*necesarios):** [searchExportJob](#list_backupsearch-resource-searchExportJob) / **Claves de condición:** [aws: RequestTag /$ {} TagKey](#list_backupsearch-aws_RequestTag___TagKey_)<br />[aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_backupsearch-aws_TagKeys)
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo](#list_backupsearch-resource-searchJob) / **Claves de condición:** [aws: RequestTag /$ {} TagKey](#list_backupsearch-aws_RequestTag___TagKey_)<br />[aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_backupsearch-aws_TagKeys)
  - **Nivel de acceso:** Etiquetar, escribir

- **   [UntagResource](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BKS_UntagResource.html)  **
  - **Description (Descripción):** Concede permiso para eliminar etiquetas en un recurso
  - **Tipos de recursos (\*necesarios):** [searchExportJob](#list_backupsearch-resource-searchExportJob) / **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_backupsearch-aws_TagKeys)
  - **Tipos de recursos (\*necesarios):** [Buscar trabajo](#list_backupsearch-resource-searchJob) / **Claves de condición:** [aws: ResourceTag /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_backupsearch-aws_TagKeys)
  - **Nivel de acceso:** Etiquetar, escribir



## Tipos de recursos definidos por AWS Búsqueda de Backup
<a name="list_backupsearch-resources-for-iam-policies"></a>

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.



| Tipos de recurso | ARN | Claves de condición | 
| --- | --- | --- | 
| [búsqueda ExportJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-search.html)  | arn: $ {Partition} :backup-search: $ {Region} :$ {Account} :search-export-job/$ {} ResourceId | [ResourceTagAWS: /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_) | 
| [Buscar trabajo](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-search.html)  | arn: $ {Partition} :backup-search: $ {Region} :$ {Account} :search-job/$ {} ResourceId | [ResourceTagAWS: /$ {} TagKey](#list_backupsearch-aws_ResourceTag___TagKey_) | 

## Claves de condición para AWS Búsqueda de Backup
<a name="list_backupsearch-policy-keys"></a>

AWS Backup Search define las siguientes claves de condición que se pueden usar en el `Condition` elemento de una política de IAM.



| Claves de condición | Descripción | Tipo | 
| --- | --- | --- | 
|  [aws: RequestTag /$ {} TagKey](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag)  | Filtra el acceso por el conjunto de valores permitidos para cada una de las etiquetas. | Cadena | 
|  [aws: ResourceTag /$ {} TagKey](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag)  | Filtra el acceso por las etiquetas asociadas al recurso | Cadena | 
|  [AWS: TagKeys](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys)  | Filtra el acceso por la presencia de etiquetas obligatorias en la solicitud | ArrayOfString |