AWS Backup Selections API
The Backup Selections API from AWS Backup — 1 operation(s) for backup selections.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aws-backup:aws-backup-backup-selections-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Aws Backup Backup Selections API
version: '2018-11-15'
description: 'Operations tagged Backup Selections across 2 of this provider''s published API definitions: aws-backup-openapi.yml, aws-backup-backup-selections-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://backup.{region}.amazonaws.com
description: AWS Backup regional endpoint
variables:
region:
default: us-east-1
description: AWS region
tags:
- name: Backup Selections
paths:
/backup/plans/{backupPlanId}/selections:
get:
tags:
- Backup Selections
summary: List backup selections
operationId: ListBackupSelections
parameters:
- $ref: '#/components/parameters/BackupPlanId'
responses:
'200':
$ref: '#/components/responses/OK'
security:
- SigV4: []
put:
tags:
- Backup Selections
summary: Create a backup selection
operationId: CreateBackupSelection
parameters:
- $ref: '#/components/parameters/BackupPlanId'
requestBody:
$ref: '#/components/requestBodies/JsonBody'
responses:
'200':
$ref: '#/components/responses/OK'
security:
- SigV4: []
servers:
- url: https://backup.{region}.amazonaws.com
description: AWS Backup regional endpoint
variables:
region:
default: us-east-1
description: AWS region
/backup/plans/{BackupPlanId}/selections:
put:
operationId: putBackupPlansByBackupPlanIdSelections
summary: Create Backup Selection
description: Creates a JSON document that specifies a set of resources to assign to a backup plan. For examples, see Assigning resources programmatically.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBackupSelectionOutput'
'400':
description: AlreadyExistsException; InvalidParameterValueException; LimitExceededException; MissingParameterValueException
content:
application/json:
schema:
$ref: '#/components/schemas/AlreadyExistsException'
'500':
description: ServiceUnavailableException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailableException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBackupSelectionInput'
tags:
- Backup Selections
security:
- sigv4: []
x-operation-id-source: normalized
x-operation-id-original: CreateBackupSelection
get:
operationId: getBackupPlansByBackupPlanIdSelections
summary: List Backup Selections
description: Returns an array containing metadata of the resources associated with the target backup plan.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListBackupSelectionsOutput'
'400':
description: InvalidParameterValueException; MissingParameterValueException; ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidParameterValueException'
'500':
description: ServiceUnavailableException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailableException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListBackupSelectionsInput'
tags:
- Backup Selections
security:
- sigv4: []
x-operation-id-source: normalized
x-operation-id-original: ListBackupSelections
servers:
- url: https://backup.{region}.amazonaws.com
variables:
region:
default: us-east-1
components:
responses:
OK:
description: Successful response
content:
application/json:
schema:
type: object
additionalProperties: true
parameters:
BackupPlanId:
name: backupPlanId
in: path
required: true
schema:
type: string
requestBodies:
JsonBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: true
schemas:
AlreadyExistsException:
type: object
properties:
Code:
type: string
Message:
type: string
CreatorRequestId:
type: string
Arn:
type: string
Type:
type: string
Context:
type: string
ServiceUnavailableException:
type: object
properties:
Code:
type: string
Message:
type: string
Type:
type: string
Context:
type: string
CreateBackupSelectionOutput:
type: object
properties:
SelectionId:
type: string
description: Uniquely identifies the body of a request to assign a set of resources to a backup plan.
BackupPlanId:
type: string
description: The ID of the backup plan.
CreationDate:
type: string
format: date-time
description: The date and time a backup selection is created, in Unix format and Coordinated Universal Time (UTC). The value of CreationDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
CreateBackupSelectionInput:
type: object
properties:
BackupPlanId:
type: string
description: The ID of the backup plan.
BackupSelection:
$ref: '#/components/schemas/BackupSelection'
CreatorRequestId:
type: string
description: A unique string that identifies the request and allows failed requests to be retried without the risk of running the operation twice. This parameter is optional. If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.
required:
- BackupPlanId
- BackupSelection
InvalidParameterValueException:
type: object
properties:
Code:
type: string
Message:
type: string
Type:
type: string
Context:
type: string
ConditionParameter:
type: object
properties:
ConditionKey:
type: string
description: 'The key in a key-value pair. For example, in the tag Department: Accounting, Department is the key.'
ConditionValue:
type: string
description: 'The value in a key-value pair. For example, in the tag Department: Accounting, Accounting is the value.'
Conditions:
type: object
properties:
StringEquals:
type: array
items:
$ref: '#/components/schemas/ConditionParameter'
description: Filters the values of your tagged resources for only those resources that you tagged with the same value. Also called "exact matching."
StringNotEquals:
type: array
items:
$ref: '#/components/schemas/ConditionParameter'
description: Filters the values of your tagged resources for only those resources that you tagged that do not have the same value. Also called "negated matching."
StringLike:
type: array
items:
$ref: '#/components/schemas/ConditionParameter'
description: Filters the values of your tagged resources for matching tag values with the use of a wildcard character (*) anywhere in the string. For example, "prod*" or "*rod*" matches the tag value "production".
StringNotLike:
type: array
items:
$ref: '#/components/schemas/ConditionParameter'
description: Filters the values of your tagged resources for non-matching tag values with the use of a wildcard character (*) anywhere in the string.
BackupSelectionsListMember:
type: object
properties:
SelectionId:
type: string
description: Uniquely identifies a request to assign a set of resources to a backup plan.
SelectionName:
type: string
description: The display name of a resource selection document.
BackupPlanId:
type: string
description: Uniquely identifies a backup plan.
CreationDate:
type: string
format: date-time
description: The date and time a backup plan is created, in Unix format and Coordinated Universal Time (UTC). The value of CreationDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
CreatorRequestId:
type: string
description: A unique string that identifies the request and allows failed requests to be retried without the risk of running the operation twice. This parameter is optional. If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.
IamRoleArn:
type: string
description: Specifies the IAM role Amazon Resource Name (ARN) to create the target recovery point; for example, arn:aws:iam::123456789012:role/S3Access.
ListBackupSelectionsOutput:
type: object
properties:
NextToken:
type: string
description: The next item following a partial list of returned items. For example, if a request is made to return MaxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
BackupSelectionsList:
type: array
items:
$ref: '#/components/schemas/BackupSelectionsListMember'
description: An array of backup selection list items containing metadata about each resource in the list.
BackupSelection:
type: object
properties:
SelectionName:
type: string
description: The display name of a resource selection document. Must contain 1 to 50 alphanumeric or '-_.' characters.
IamRoleArn:
type: string
description: The ARN of the IAM role that Backup uses to authenticate when backing up the target resource; for example, arn:aws:iam::123456789012:role/S3Access.
Resources:
type: array
items:
type: string
description: The Amazon Resource Names (ARNs) of the resources to assign to a backup plan. The maximum number of ARNs is 500 without wildcards, or 30 ARNs with wildcards. If you need to assign many resources to a backup plan, consider a different resource selection strategy, such as assigning all resources of a resource type or refining your resource selection using tags. If you specify multiple ARNs, the resources much match any of the ARNs (OR logic). When using wildcards in ARN patterns for backup selections, the asterisk (*) must appear at the end of the ARN string (prefix pattern). For example, arn:aw
ListOfTags:
type: array
items:
$ref: '#/components/schemas/Condition'
description: 'The conditions that you define to assign resources to your backup plans using tags. For example, "StringEquals": { "ConditionKey": "backup", "ConditionValue": "daily"}. ListOfTags supports only StringEquals. Condition operators are case sensitive. If you specify multiple conditions, the resources much match any of the conditions (OR logic).'
NotResources:
type: array
items:
type: string
description: The Amazon Resource Names (ARNs) of the resources to exclude from a backup plan. The maximum number of ARNs is 500 without wildcards, or 30 ARNs with wildcards. If you need to exclude many resources from a backup plan, consider a different resource selection strategy, such as assigning only one or a few resource types or refining your resource selection using tags.
Conditions:
$ref: '#/components/schemas/Conditions'
required:
- SelectionName
- IamRoleArn
Condition:
type: object
properties:
ConditionType:
type: string
enum:
- STRINGEQUALS
description: An operation applied to a key-value pair used to assign resources to your backup plan. Condition only supports StringEquals. For more flexible assignment options, including StringLike and the ability to exclude resources from your backup plan, use Conditions (with an "s" on the end) for your BackupSelection .
ConditionKey:
type: string
description: 'The key in a key-value pair. For example, in the tag Department: Accounting, Department is the key.'
ConditionValue:
type: string
description: 'The value in a key-value pair. For example, in the tag Department: Accounting, Accounting is the value.'
required:
- ConditionType
- ConditionKey
- ConditionValue
ListBackupSelectionsInput:
type: object
properties:
BackupPlanId:
type: string
description: Uniquely identifies a backup plan.
NextToken:
type: string
description: The next item following a partial list of returned items. For example, if a request is made to return MaxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.
MaxResults:
type: integer
description: The maximum number of items to be returned.
required:
- BackupPlanId
securitySchemes:
SigV4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4 signed Authorization header
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: backup
x-refined-from:
- aws-backup-openapi.yml
- aws-backup-backup-selections-api-openapi.yml