Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . cloud9 ]



Gets information about AWS Cloud9 development environments.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--environment-ids <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--environment-ids (list)

The IDs of individual environments to get information about.


"string" "string" ...

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


To get information about AWS Cloud9 development environments

This example gets information about the specified AWS Cloud9 development environments.


aws cloud9 describe-environments --environment-ids 685f892f431b45c2b28cb69eadcdb0EX 349c86d4579e4e7298d500ff57a6b2EX


  "environments": [
      "id": "685f892f431b45c2b28cb69eadcdb0EX",
      "name": "my-demo-ec2-env",
      "description": "Created from CodeStar.",
      "type": "ec2",
      "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX",
      "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "lifecycle": {
        "status": "CREATED"
      "id": "349c86d4579e4e7298d500ff57a6b2EX",
      "name": my-demo-ssh-env",
      "description": "",
      "type": "ssh",
      "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:349c86d4579e4e7298d500ff57a6b2EX",
      "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "lifecycle": {
        "status": "CREATED"


environments -> (list)

Information about the environments that are returned.


Information about an AWS Cloud9 development environment.

id -> (string)

The ID of the environment.

name -> (string)

The name of the environment.

description -> (string)

The description for the environment.

type -> (string)

The type of environment. Valid values include the following:

  • ec2 : An Amazon Elastic Compute Cloud (Amazon EC2) instance connects to the environment.
  • ssh : Your own server connects to the environment.

arn -> (string)

The Amazon Resource Name (ARN) of the environment.

ownerArn -> (string)

The Amazon Resource Name (ARN) of the environment owner.

lifecycle -> (structure)

The state of the environment in its creation or deletion lifecycle.

status -> (string)

The current creation or deletion lifecycle state of the environment.

  • CREATED : The environment was successfully created.
  • DELETE_FAILED : The environment failed to delete.
  • DELETING : The environment is in the process of being deleted.

reason -> (string)

Any informational message about the lifecycle state of the environment.

failureResource -> (string)

If the environment failed to delete, the Amazon Resource Name (ARN) of the related AWS resource.