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-cloud9:amazon-cloud9-operations-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.1.0
info:
  title: AWS Cloud9 Operations API
  version: '2017-09-23'
  description: Generated from AWS's published Smithy model for AWS Cloud9. 5 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://cloud9.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /#CreateEnvironmentEC2:
    post:
      operationId: CreateEnvironmentEC2
      summary: Create Environment EC2
      description: Creates an Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance,
        and then connects from the instance to the environment. Cloud9 is no longer available to new customers. Existing customers
        of Cloud9 can continue to use the service as normal. Learn more"
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/CreateEnvironmentEC2Result'
              example:
                environmentId: 8d9967e2f0624182b74e7690ad69ebEX
        '400':
          description: BadRequestException; ConflictException; ForbiddenException; LimitExceededException; NotFoundException;
            TooManyRequestsException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSCloud9WorkspaceManagementService.CreateEnvironmentEC2
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/CreateEnvironmentEC2Request'
            example:
              name: my-demo-environment
              description: This is my demonstration environment.
              instanceType: t2.micro
              imageId: amazonlinux-2023-x86_64
              subnetId: subnet-6300cd1b
              automaticStopTimeMinutes: 60
              ownerArn: arn:aws:iam::123456789012:user/MyDemoUser
      tags:
      - Operations
  /#DescribeEnvironmentStatus:
    post:
      operationId: DescribeEnvironmentStatus
      summary: Describe Environment Status
      description: Gets status information for an Cloud9 development environment. Cloud9 is no longer available to new customers.
        Existing customers of Cloud9 can continue to use the service as normal. Learn more"
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/DescribeEnvironmentStatusResult'
              example:
                status: ready
                message: Environment is ready to use
        '400':
          description: BadRequestException; ConflictException; ForbiddenException; LimitExceededException; NotFoundException;
            TooManyRequestsException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSCloud9WorkspaceManagementService.DescribeEnvironmentStatus
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/DescribeEnvironmentStatusRequest'
            example:
              environmentId: 8d9967e2f0624182b74e7690ad69ebEX
      tags:
      - Operations
  /#ListTagsForResource:
    post:
      operationId: ListTagsForResource
      summary: List Tags For Resource
      description: Gets a list of the tags associated with an Cloud9 development environment. Cloud9 is no longer available
        to new customers. Existing customers of Cloud9 can continue to use the service as normal. Learn more"
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ListTagsForResourceResponse'
        '400':
          description: BadRequestException; NotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSCloud9WorkspaceManagementService.ListTagsForResource
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/ListTagsForResourceRequest'
      tags:
      - Operations
  /#TagResource:
    post:
      operationId: TagResource
      summary: Tag Resource
      description: Adds tags to an Cloud9 development environment. Cloud9 is no longer available to new customers. Existing
        customers of Cloud9 can continue to use the service as normal. Learn more" Tags that you add to an Cloud9 environment
        by using this method will NOT be automatically propagated to underlying resources.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/TagResourceResponse'
        '400':
          description: BadRequestException; ConcurrentAccessException; NotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSCloud9WorkspaceManagementService.TagResource
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/TagResourceRequest'
      tags:
      - Operations
  /#UntagResource:
    post:
      operationId: UntagResource
      summary: Untag Resource
      description: Removes tags from an Cloud9 development environment. Cloud9 is no longer available to new customers. Existing
        customers of Cloud9 can continue to use the service as normal. Learn more"
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/UntagResourceResponse'
        '400':
          description: BadRequestException; ConcurrentAccessException; NotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalServerErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InternalServerErrorException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSCloud9WorkspaceManagementService.UntagResource
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/UntagResourceRequest'
      tags:
      - Operations
components:
  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: cloud9
  schemas:
    BadRequestException:
      type: object
      properties:
        message:
          type: string
        className:
          type: string
        code:
          type: integer
    CreateEnvironmentEC2Request:
      type: object
      properties:
        name:
          type: string
          description: The name of the environment to create. This name is visible to other IAM users in the same Amazon Web
            Services account.
        description:
          type: string
          description: The description of the environment to create.
        clientRequestToken:
          type: string
          description: A unique, case-sensitive string that helps Cloud9 to ensure this operation completes no more than one
            time. For more information, see Client Tokens in the Amazon EC2 API Reference.
        instanceType:
          type: string
          description: The type of instance to connect to the environment (for example, t2.micro).
        subnetId:
          type: string
          description: The ID of the subnet in Amazon VPC that Cloud9 will use to communicate with the Amazon EC2 instance.
        imageId:
          type: string
          description: The identifier for the Amazon Machine Image (AMI) that's used to create the EC2 instance. To choose
            an AMI for the instance, you must specify a valid AMI alias or a valid Amazon EC2 Systems Manager (SSM) path.
            We recommend using Amazon Linux 2023 as the AMI to create your environment as it is fully supported. From December
            16, 2024, Ubuntu 18.04 will be removed from the list of available imageIds for Cloud9. This change is necessary
            as Ubuntu 18.04 has ended standard support on May 31, 2023. This change will only affect direct API consumers,
            and not Cloud9 console users. Since Ubuntu 18.04 has
        automaticStopTimeMinutes:
          type: integer
          description: The number of minutes until the running instance is shut down after the environment has last been used.
        ownerArn:
          type: string
          description: The Amazon Resource Name (ARN) of the environment owner. This ARN can be the ARN of any IAM principal.
            If this value is not specified, the ARN defaults to this environment's creator.
        tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: An array of key-value pairs that will be associated with the new Cloud9 development environment.
        connectionType:
          type: string
          enum:
          - CONNECT_SSH
          - CONNECT_SSM
          description: The connection type used for connecting to an Amazon EC2 environment. Valid values are CONNECT_SSH
            (default) and CONNECT_SSM (connected through Amazon EC2 Systems Manager). For more information, see Accessing
            no-ingress EC2 instances with Amazon EC2 Systems Manager in the Cloud9 User Guide.
        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:
      - name
      - instanceType
      - imageId
    CreateEnvironmentEC2Result:
      type: object
      properties:
        environmentId:
          type: string
          description: The ID of the environment that was created.
    DescribeEnvironmentStatusRequest:
      type: object
      properties:
        environmentId:
          type: string
          description: The ID of the environment to get status information about.
      required:
      - environmentId
    DescribeEnvironmentStatusResult:
      type: object
      properties:
        status:
          type: string
          enum:
          - error
          - creating
          - connecting
          - ready
          - stopping
          - stopped
          - deleting
          description: 'The status of the environment. Available values include: connecting: The environment is connecting.
            creating: The environment is being created. deleting: The environment is being deleted. error: The environment
            is in an error state. ready: The environment is ready. stopped: The environment is stopped. stopping: The environment
            is stopping.'
        message:
          type: string
          description: Any informational message about the status of the environment.
      required:
      - status
      - message
    InternalServerErrorException:
      type: object
      properties:
        message:
          type: string
        className:
          type: string
        code:
          type: integer
    ListTagsForResourceRequest:
      type: object
      properties:
        ResourceARN:
          type: string
          description: The Amazon Resource Name (ARN) of the Cloud9 development environment to get the tags for.
      required:
      - ResourceARN
    ListTagsForResourceResponse:
      type: object
      properties:
        Tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: The list of tags associated with the Cloud9 development environment.
    Tag:
      type: object
      properties:
        Key:
          type: string
          description: The name part of a tag.
        Value:
          type: string
          description: The value part of a tag.
      required:
      - Key
      - Value
    TagResourceRequest:
      type: object
      properties:
        ResourceARN:
          type: string
          description: The Amazon Resource Name (ARN) of the Cloud9 development environment to add tags to.
        Tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: The list of tags to add to the given Cloud9 development environment.
      required:
      - ResourceARN
      - Tags
    TagResourceResponse:
      type: object
      properties: {}
    UntagResourceRequest:
      type: object
      properties:
        ResourceARN:
          type: string
          description: The Amazon Resource Name (ARN) of the Cloud9 development environment to remove tags from.
        TagKeys:
          type: array
          items:
            type: string
          description: The tag names of the tags to remove from the given Cloud9 development environment.
      required:
      - ResourceARN
      - TagKeys
    UntagResourceResponse:
      type: object
      properties: {}
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloud9/service/2017-09-23/cloud9-2017-09-23.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)