update_environment_account_connection

update_environment_account_connection(**kwargs)

In an environment account, update an environment account connection to use a new IAM role.

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

See also: AWS API Documentation

Request Syntax

response = client.update_environment_account_connection(
    codebuildRoleArn='string',
    componentRoleArn='string',
    id='string',
    roleArn='string'
)
Parameters
  • codebuildRoleArn (string) -- The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account.
  • 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 .

  • id (string) --

    [REQUIRED]

    The ID of the environment account connection to update.

  • roleArn (string) -- The Amazon Resource Name (ARN) of the IAM service role that's associated with the environment account connection to update.
Return type

dict

Returns

Response Syntax

{
    'environmentAccountConnection': {
        'arn': 'string',
        'codebuildRoleArn': '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'
    }
}

Response Structure

  • (dict) --

    • environmentAccountConnection (dict) --

      The environment account connection detail data that's returned by Proton.

      • arn (string) --

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

      • codebuildRoleArn (string) --

        The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account.

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

Exceptions

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