View a markdown version of this page

Actions, resources, and condition keys for AWS Backup Search - Service Authorization Reference

Actions, resources, and condition keys for AWS Backup Search

AWS Backup Search (service prefix: backup-search) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by AWS Backup Search

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation IAM action Condition key Possible value(s) Access level

GetSearchJob

backup-search:GetSearchJob

Read

GetSearchResultExportJob

backup-search:GetSearchResultExportJob

Read

ListSearchJobBackups

backup-search:ListSearchJobBackups

Read

ListSearchJobResults

backup-search:ListSearchJobResults

Read

ListSearchJobs

backup-search:ListSearchJobs

List

ListSearchResultExportJobs

backup-search:ListSearchResultExportJobs

List

ListTagsForResource

backup-search:ListTagsForResource

Read

StartSearchJob

backup-search:StartSearchJob

Write

backup-search:TagResource

Tagging, Write

StartSearchResultExportJob

backup-search:StartSearchResultExportJob

Write

StopSearchJob

backup-search:StopSearchJob

Write

TagResource

backup-search:TagResource

Tagging, Write

Actions defined by AWS Backup Search

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

GetSearchJob

Grants permission to get details of a search job

searchJob*

aws:ResourceTag/${TagKey}

Read

GetSearchResultExportJob

Grants permission to get details of a search result export job

searchExportJob*

aws:ResourceTag/${TagKey}

Read

ListSearchJobBackups

Grants permission to list backups in scope of a search job

searchJob*

aws:ResourceTag/${TagKey}

Read

ListSearchJobResults

Grants permission to list results of a search job

searchJob*

aws:ResourceTag/${TagKey}

Read

ListSearchJobs

Grants permission to list search jobs

List

ListSearchResultExportJobs

Grants permission to list search result export jobs

List

ListTagsForResource

Grants permission to list tags for a resource

searchExportJob

aws:ResourceTag/${TagKey}

Read

searchJob

aws:ResourceTag/${TagKey}

StartSearchJob

Grants permission to create a search job

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Write

StartSearchResultExportJob

Grants permission to start an export job for an existing search job

searchJob*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Write

StopSearchJob

Grants permission to stop an in-progress search job

searchJob*

aws:ResourceTag/${TagKey}

Write

TagResource

Grants permission to tag a resource

searchExportJob

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

searchJob

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

UntagResource

Grants permission to untag a resource

searchExportJob

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

searchJob

aws:ResourceTag/${TagKey}

aws:TagKeys

Resource types defined by AWS Backup Search

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

searchExportJob

arn:${Partition}:backup-search:${Region}:${Account}:search-export-job/${ResourceId}

aws:ResourceTag/${TagKey}

searchJob

arn:${Partition}:backup-search:${Region}:${Account}:search-job/${ResourceId}

aws:ResourceTag/${TagKey}

Condition keys for AWS Backup Search

AWS Backup Search defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:RequestTag/${TagKey}

Filters access by the allowed set of values for each of the tags

String

aws:ResourceTag/${TagKey}

Filters access by the tags associated with the resource

String

aws:TagKeys

Filters access by the presence of mandatory tags in the request

ArrayOfString