AWS Redshift #Action=BatchModifyClusterSnapshots API
The #Action=BatchModifyClusterSnapshots API from AWS Redshift — 1 operation(s) for #action=batchmodifyclustersnapshots.
The #Action=BatchModifyClusterSnapshots API from AWS Redshift — 1 operation(s) for #action=batchmodifyclustersnapshots.
openapi: 3.0.0
info:
version: '2019-12-20'
x-release: v4
title: 'Redshift Data API Service #Action=AcceptReservedNodeExchange #Action=AcceptReservedNodeExchange #Action=BatchModifyClusterSnapshots API'
description: <p>You can use the Amazon Redshift Data API to run queries on Amazon Redshift tables. You can run SQL statements, which are committed if the statement succeeds. </p> <p>For more information about the Amazon Redshift Data API and CLI usage examples, see <a href="https://docs.aws.amazon.com/redshift/latest/mgmt/data-api.html">Using the Amazon Redshift Data API</a> in the <i>Amazon Redshift Management Guide</i>. </p>
x-logo:
url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
backgroundColor: '#FFFFFF'
termsOfService: https://aws.amazon.com/service-terms/
contact:
name: Mike Ralphson
email: mike.ralphson@gmail.com
url: https://github.com/mermade/aws2openapi
x-twitter: PermittedSoc
license:
name: Apache 2.0 License
url: http://www.apache.org/licenses/
x-providerName: amazonaws.com
x-serviceName: redshift-data
x-aws-signingName: redshift-data
x-origin:
- contentType: application/json
url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/redshift-data-2019-12-20.normal.json
converter:
url: https://github.com/mermade/aws2openapi
version: 1.0.0
x-apisguru-driver: external
x-apiClientRegistration:
url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
x-apisguru-categories:
- cloud
x-preferred: true
servers:
- url: http://redshift-data.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Redshift Data API Service multi-region endpoint
- url: https://redshift-data.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Redshift Data API Service multi-region endpoint
- url: http://redshift-data.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Redshift Data API Service endpoint for China (Beijing) and China (Ningxia)
- url: https://redshift-data.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Redshift Data API Service endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: '#Action=BatchModifyClusterSnapshots'
paths:
/#Action=BatchModifyClusterSnapshots:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
get:
x-aws-operation-name: BatchModifyClusterSnapshots
operationId: GET_BatchModifyClusterSnapshots
description: Modifies the settings for a set of cluster snapshots.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/BatchModifyClusterSnapshotsOutputMessage'
'480':
description: InvalidRetentionPeriodFault
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidRetentionPeriodFault'
'481':
description: BatchModifyClusterSnapshotsLimitExceededFault
content:
text/xml:
schema:
$ref: '#/components/schemas/BatchModifyClusterSnapshotsLimitExceededFault'
parameters:
- name: SnapshotIdentifierList
in: query
required: true
description: A list of snapshot identifiers you want to modify.
schema:
type: array
items:
allOf:
- $ref: '#/components/schemas/String'
- xml:
name: String
- name: ManualSnapshotRetentionPeriod
in: query
required: false
description: <p>The number of days that a manual snapshot is retained. If you specify the value -1, the manual snapshot is retained indefinitely.</p> <p>The number must be either -1 or an integer between 1 and 3,653.</p> <p>If you decrease the manual snapshot retention period from its current value, existing manual snapshots that fall outside of the new retention period will return an error. If you want to suppress the errors and delete the snapshots, use the force option. </p>
schema:
type: integer
- name: Force
in: query
required: false
description: 'A boolean value indicating whether to override an exception if the retention period has passed. '
schema:
type: boolean
- name: Action
in: query
required: true
schema:
type: string
enum:
- BatchModifyClusterSnapshots
- name: Version
in: query
required: true
schema:
type: string
enum:
- '2012-12-01'
summary: Amazon Redshift - G E T_ Batch Modify Cluster Snapshots
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- '#Action=BatchModifyClusterSnapshots'
post:
x-aws-operation-name: BatchModifyClusterSnapshots
operationId: POST_BatchModifyClusterSnapshots
description: Modifies the settings for a set of cluster snapshots.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/BatchModifyClusterSnapshotsOutputMessage'
'480':
description: InvalidRetentionPeriodFault
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidRetentionPeriodFault'
'481':
description: BatchModifyClusterSnapshotsLimitExceededFault
content:
text/xml:
schema:
$ref: '#/components/schemas/BatchModifyClusterSnapshotsLimitExceededFault'
requestBody:
content:
text/xml:
schema:
$ref: '#/components/schemas/BatchModifyClusterSnapshotsMessage'
parameters:
- name: Action
in: query
required: true
schema:
type: string
enum:
- BatchModifyClusterSnapshots
- name: Version
in: query
required: true
schema:
type: string
enum:
- '2012-12-01'
summary: Amazon Redshift - P O S T_ Batch Modify Cluster Snapshots
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- '#Action=BatchModifyClusterSnapshots'
components:
parameters:
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
schemas:
Boolean:
type: boolean
BatchModifyClusterSnapshotsOutputMessage:
type: object
properties:
Resources:
allOf:
- $ref: '#/components/schemas/SnapshotIdentifierList'
- description: A list of the snapshots that were modified.
Errors:
allOf:
- $ref: '#/components/schemas/BatchSnapshotOperationErrors'
- description: A list of any errors returned.
BatchModifyClusterSnapshotsMessage:
type: object
required:
- SnapshotIdentifierList
title: BatchModifyClusterSnapshotsMessage
properties:
SnapshotIdentifierList:
allOf:
- $ref: '#/components/schemas/SnapshotIdentifierList'
- description: A list of snapshot identifiers you want to modify.
ManualSnapshotRetentionPeriod:
allOf:
- $ref: '#/components/schemas/IntegerOptional'
- description: <p>The number of days that a manual snapshot is retained. If you specify the value -1, the manual snapshot is retained indefinitely.</p> <p>The number must be either -1 or an integer between 1 and 3,653.</p> <p>If you decrease the manual snapshot retention period from its current value, existing manual snapshots that fall outside of the new retention period will return an error. If you want to suppress the errors and delete the snapshots, use the force option. </p>
Force:
allOf:
- $ref: '#/components/schemas/Boolean'
- description: 'A boolean value indicating whether to override an exception if the retention period has passed. '
BatchSnapshotOperationErrors:
type: array
items:
allOf:
- $ref: '#/components/schemas/SnapshotErrorMessage'
- xml:
name: SnapshotErrorMessage
SnapshotIdentifierList:
type: array
items:
allOf:
- $ref: '#/components/schemas/String'
- xml:
name: String
IntegerOptional:
type: integer
InvalidRetentionPeriodFault: {}
BatchModifyClusterSnapshotsLimitExceededFault: {}
SnapshotErrorMessage:
type: object
properties:
SnapshotIdentifier:
allOf:
- $ref: '#/components/schemas/String'
- description: A unique identifier for the snapshot returning the error.
SnapshotClusterIdentifier:
allOf:
- $ref: '#/components/schemas/String'
- description: A unique identifier for the cluster.
FailureCode:
allOf:
- $ref: '#/components/schemas/String'
- description: The failure code for the error.
FailureReason:
allOf:
- $ref: '#/components/schemas/String'
- description: The text message describing the error.
description: Describes the errors returned by a snapshot.
String:
type: string
maxLength: 2147483647
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/redshift-data/
x-hasEquivalentPaths: true