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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/amazon-ec2:amazon-ec2-snapshot-attribute-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Amazon Elastic Compute Cloud Snapshot Attribute API
  version: '2016-11-15'
  description: Generated from AWS's published Smithy model for Amazon Elastic Compute Cloud. 3 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://ec2.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Snapshot Attribute
paths:
  /?Action=DescribeSnapshotAttribute:
    post:
      operationId: DescribeSnapshotAttribute
      summary: Describe Snapshot Attribute
      description: Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time. For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon EBS User Guide.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/DescribeSnapshotAttributeResult'
              example:
                SnapshotId: snap-066877671789bd71b
                CreateVolumePermissions: []
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: DescribeSnapshotAttribute
                  Version:
                    type: string
                    const: '2016-11-15'
              - $ref: '#/components/schemas/DescribeSnapshotAttributeRequest'
            example:
              SnapshotId: snap-066877671789bd71b
              Attribute: createVolumePermission
      tags:
      - Snapshot Attribute
  /?Action=ModifySnapshotAttribute:
    post:
      operationId: ModifySnapshotAttribute
      summary: Modify Snapshot Attribute
      description: Adds or removes permission settings for the specified snapshot. You may add or remove specified Amazon Web Services account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single operation. If you need to both add and remove account IDs for a snapshot, you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation. Encrypted snapshots and snapshots with Amazon Web Services Marketplace product codes cannot be made public. Snapshots encrypted with your default KMS key cannot be shared with other accounts. For more information about modifying snapshot permissions, see Share a snapshot in the Amazon EBS User Guide.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                type: string
              example: {}
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: ModifySnapshotAttribute
                  Version:
                    type: string
                    const: '2016-11-15'
              - $ref: '#/components/schemas/ModifySnapshotAttributeRequest'
            example:
              SnapshotId: snap-1234567890abcdef0
              Attribute: createVolumePermission
              OperationType: add
              GroupNames:
              - all
      tags:
      - Snapshot Attribute
  /?Action=ResetSnapshotAttribute:
    post:
      operationId: ResetSnapshotAttribute
      summary: Reset Snapshot Attribute
      description: Resets permission settings for the specified snapshot. For more information about modifying snapshot permissions, see Share a snapshot in the Amazon EBS User Guide.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                type: string
              example: {}
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: ResetSnapshotAttribute
                  Version:
                    type: string
                    const: '2016-11-15'
              - $ref: '#/components/schemas/ResetSnapshotAttributeRequest'
            example:
              SnapshotId: snap-1234567890abcdef0
              Attribute: createVolumePermission
      tags:
      - Snapshot Attribute
components:
  schemas:
    CreateVolumePermission:
      type: object
      properties:
        UserId:
          type: string
          description: The ID of the Amazon Web Services account to be added or removed.
        Group:
          type: string
          enum:
          - all
          description: The group to be added or removed. The possible value is all.
    DescribeSnapshotAttributeResult:
      type: object
      properties:
        ProductCodes:
          type: array
          items:
            $ref: '#/components/schemas/ProductCode'
          description: The product codes.
        SnapshotId:
          type: string
          description: The ID of the EBS snapshot.
        CreateVolumePermissions:
          type: array
          items:
            $ref: '#/components/schemas/CreateVolumePermission'
          description: The users and groups that have the permissions for creating volumes from the snapshot.
    DescribeSnapshotAttributeRequest:
      type: object
      properties:
        Attribute:
          type: string
          enum:
          - productCodes
          - createVolumePermission
          description: The snapshot attribute you would like to view.
        SnapshotId:
          type: string
          description: The ID of the EBS snapshot.
        DryRun:
          type: boolean
          description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
      required:
      - Attribute
      - SnapshotId
    ResetSnapshotAttributeRequest:
      type: object
      properties:
        Attribute:
          type: string
          enum:
          - productCodes
          - createVolumePermission
          description: The attribute to reset. Currently, only the attribute for permission to create volumes can be reset.
        SnapshotId:
          type: string
          description: The ID of the snapshot.
        DryRun:
          type: boolean
          description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
      required:
      - Attribute
      - SnapshotId
    ModifySnapshotAttributeRequest:
      type: object
      properties:
        Attribute:
          type: string
          enum:
          - productCodes
          - createVolumePermission
          description: The snapshot attribute to modify. Only volume creation permissions can be modified.
        CreateVolumePermission:
          $ref: '#/components/schemas/CreateVolumePermissionModifications'
        GroupNames:
          type: array
          items:
            type: string
          description: The group to modify for the snapshot.
        OperationType:
          type: string
          enum:
          - add
          - remove
          description: The type of operation to perform to the attribute.
        SnapshotId:
          type: string
          description: The ID of the snapshot.
        UserIds:
          type: array
          items:
            type: string
          description: The account ID to modify for the snapshot.
        DryRun:
          type: boolean
          description: Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
      required:
      - SnapshotId
    ProductCode:
      type: object
      properties:
        ProductCodeId:
          type: string
          description: The product code.
        ProductCodeType:
          type: string
          enum:
          - devpay
          - marketplace
          description: The type of product code.
    CreateVolumePermissionModifications:
      type: object
      properties:
        Add:
          type: array
          items:
            $ref: '#/components/schemas/CreateVolumePermission'
          description: Adds the specified Amazon Web Services account ID or group to the list.
        Remove:
          type: array
          items:
            $ref: '#/components/schemas/CreateVolumePermission'
          description: Removes the specified Amazon Web Services account ID or group from the list.
  securitySchemes:
    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: ec2
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/ec2/service/2016-11-15/ec2-2016-11-15.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)