list_environment_account_connections

Proton.Client.list_environment_account_connections(**kwargs)

View a list of environment account connections.

For more information, see Environment account connections in the Proton User guide .

See also: AWS API Documentation

Request Syntax

response = client.list_environment_account_connections(
    environmentName='string',
    maxResults=123,
    nextToken='string',
    requestedBy='MANAGEMENT_ACCOUNT'|'ENVIRONMENT_ACCOUNT',
    statuses=[
        'PENDING'|'CONNECTED'|'REJECTED',
    ]
)
Parameters
  • environmentName (string) -- The environment name that's associated with each listed environment account connection.
  • maxResults (integer) -- The maximum number of environment account connections to list.
  • nextToken (string) -- A token that indicates the location of the next environment account connection in the array of environment account connections, after the list of environment account connections that was previously requested.
  • requestedBy (string) --

    [REQUIRED]

    The type of account making the ListEnvironmentAccountConnections request.

  • statuses (list) --

    The status details for each listed environment account connection.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'environmentAccountConnections': [
        {
            'arn': 'string',
            'componentRoleArn': 'string',
            'environmentAccountId': 'string',
            'environmentName': 'string',
            'id': 'string',
            'lastModifiedAt': datetime(2015, 1, 1),
            'managementAccountId': 'string',
            'requestedAt': datetime(2015, 1, 1),
            'roleArn': 'string',
            'status': 'PENDING'|'CONNECTED'|'REJECTED'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • environmentAccountConnections (list) --

      An array of environment account connections with details that's returned by Proton.

      • (dict) --

        Summary data of an Proton environment account connection resource.

        • arn (string) --

          The Amazon Resource Name (ARN) of the environment account connection.

        • componentRoleArn (string) --

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

          The environment account connection must have a componentRoleArn to allow directly defined components to be associated with any environments running in the account.

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

        • environmentAccountId (string) --

          The ID of the environment account that's connected to the environment account connection.

        • environmentName (string) --

          The name of the environment that's associated with the environment account connection.

        • id (string) --

          The ID of the environment account connection.

        • lastModifiedAt (datetime) --

          The time when the environment account connection was last modified.

        • managementAccountId (string) --

          The ID of the management account that's connected to the environment account connection.

        • requestedAt (datetime) --

          The time when the environment account connection request was made.

        • roleArn (string) --

          The IAM service role that's associated with the environment account connection.

        • status (string) --

          The status of the environment account connection.

    • nextToken (string) --

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

Exceptions

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