Cloud9 / Client / describe_environment_status

describe_environment_status#

Cloud9.Client.describe_environment_status(**kwargs)#

Gets status information for an Cloud9 development environment.

See also: AWS API Documentation

Request Syntax

response = client.describe_environment_status(
    environmentId='string'
)
Parameters:

environmentId (string) –

[REQUIRED]

The ID of the environment to get status information about.

Return type:

dict

Returns:

Response Syntax

{
    'status': 'error'|'creating'|'connecting'|'ready'|'stopping'|'stopped'|'deleting',
    'message': 'string'
}

Response Structure

  • (dict) –

    • status (string) –

      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 (string) –

      Any informational message about the status of the environment.

Exceptions

  • Cloud9.Client.exceptions.BadRequestException

  • Cloud9.Client.exceptions.ConflictException

  • Cloud9.Client.exceptions.NotFoundException

  • Cloud9.Client.exceptions.ForbiddenException

  • Cloud9.Client.exceptions.TooManyRequestsException

  • Cloud9.Client.exceptions.LimitExceededException

  • Cloud9.Client.exceptions.InternalServerErrorException

Examples

response = client.describe_environment_status(
    environmentId='8d9967e2f0624182b74e7690ad69ebEX',
)

print(response)

Expected Output:

{
    'message': 'Environment is ready to use',
    'status': 'ready',
    'ResponseMetadata': {
        '...': '...',
    },
}