list_environments

list_environments(**kwargs)

List environments with detail data summaries.

See also: AWS API Documentation

Request Syntax

response = client.list_environments(
    environmentTemplates=[
        {
            'majorVersion': 'string',
            'templateName': 'string'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • environmentTemplates (list) --

    An array of the versions of the environment template.

    • (dict) --

      A search filter for environment templates.

      • majorVersion (string) -- [REQUIRED]

        Include majorVersion to filter search for a major version.

      • templateName (string) -- [REQUIRED]

        Include templateName to filter search for a template name.

  • maxResults (integer) -- The maximum number of environments to list.
  • nextToken (string) -- A token that indicates the location of the next environment in the array of environments, after the list of environments that was previously requested.
Return type

dict

Returns

Response Syntax

{
    'environments': [
        {
            'arn': 'string',
            'componentRoleArn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED',
            'deploymentStatusMessage': 'string',
            'description': 'string',
            'environmentAccountConnectionId': 'string',
            'environmentAccountId': 'string',
            'lastDeploymentAttemptedAt': datetime(2015, 1, 1),
            'lastDeploymentSucceededAt': datetime(2015, 1, 1),
            'name': 'string',
            'protonServiceRoleArn': 'string',
            'provisioning': 'CUSTOMER_MANAGED',
            'templateMajorVersion': 'string',
            'templateMinorVersion': 'string',
            'templateName': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • environments (list) --

      An array of environment detail data summaries.

      • (dict) --

        Summary data of an Proton environment resource. An Proton environment is a set of resources shared across Proton services.

        • arn (string) --

          The Amazon Resource Name (ARN) of the environment.

        • componentRoleArn (string) --

          The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision.

          The environment must have a componentRoleArn to allow directly defined components to be associated with the environment.

          For more information about components, see Proton components in the Proton User Guide .

        • createdAt (datetime) --

          The time when the environment was created.

        • deploymentStatus (string) --

          The environment deployment status.

        • deploymentStatusMessage (string) --

          An environment deployment status message.

        • description (string) --

          The description of the environment.

        • environmentAccountConnectionId (string) --

          The ID of the environment account connection that the environment is associated with.

        • environmentAccountId (string) --

          The ID of the environment account that the environment infrastructure resources are provisioned in.

        • lastDeploymentAttemptedAt (datetime) --

          The time when a deployment of the environment was last attempted.

        • lastDeploymentSucceededAt (datetime) --

          The time when the environment was last deployed successfully.

        • name (string) --

          The name of the environment.

        • protonServiceRoleArn (string) --

          The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf.

        • provisioning (string) --

          When included, indicates that the environment template is for customer provisioned and managed infrastructure.

        • templateMajorVersion (string) --

          The major version of the environment template.

        • templateMinorVersion (string) --

          The minor version of the environment template.

        • templateName (string) --

          The name of the environment template.

    • nextToken (string) --

      A token that indicates the location of the next environment in the array of environments, after the current requested list of environments.

Exceptions

  • Proton.Client.exceptions.ValidationException
  • Proton.Client.exceptions.AccessDeniedException
  • Proton.Client.exceptions.ThrottlingException
  • Proton.Client.exceptions.ResourceNotFoundException
  • Proton.Client.exceptions.InternalServerException