AWS Redshift #Action=BatchModifyClusterSnapshots API

The #Action=BatchModifyClusterSnapshots API from AWS Redshift — 1 operation(s) for #action=batchmodifyclustersnapshots.

OpenAPI Specification

aws-redshift-action-batchmodifyclustersnapshots-api-openapi.yml Raw ↑
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