Table Of Contents

Feedback

User Guide

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

[ aws . cloud9 ]

describe-environments

Description

Gets information about AWS Cloud9 development environments.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

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

Options

--environment-ids (list)

The IDs of individual environments to get information about.

Syntax:

"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.

--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.

Examples

To get information about AWS Cloud9 development environments

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

Command:

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

Output:

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

Output

environments -> (list)

Information about the environments that are returned.

(structure)

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.