update_account_settings

update_account_settings(**kwargs)

Update Proton settings that are used for multiple services in the Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

response = client.update_account_settings(
    deletePipelineProvisioningRepository=True|False,
    pipelineCodebuildRoleArn='string',
    pipelineProvisioningRepository={
        'branch': 'string',
        'name': 'string',
        'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET'
    },
    pipelineServiceRoleArn='string'
)
Parameters
  • deletePipelineProvisioningRepository (boolean) -- Set to true to remove a configured pipeline repository from the account settings. Don't set this field if you are updating the configured pipeline repository.
  • pipelineCodebuildRoleArn (string) -- The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Proton assumes this role for CodeBuild-based provisioning.
  • pipelineProvisioningRepository (dict) --

    A linked repository for pipeline provisioning. Specify it if you have environments configured for self-managed provisioning with services that include pipelines. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository.

    To remove a previously configured repository, set deletePipelineProvisioningRepository to true , and don't set pipelineProvisioningRepository .

    • branch (string) -- [REQUIRED]

      The repository branch.

    • name (string) -- [REQUIRED]

      The repository name.

    • provider (string) -- [REQUIRED]

      The repository provider.

  • pipelineServiceRoleArn (string) --

    The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning.

    To remove a previously configured ARN, specify an empty string.

Return type

dict

Returns

Response Syntax

{
    'accountSettings': {
        'pipelineCodebuildRoleArn': 'string',
        'pipelineProvisioningRepository': {
            'arn': 'string',
            'branch': 'string',
            'name': 'string',
            'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET'
        },
        'pipelineServiceRoleArn': 'string'
    }
}

Response Structure

  • (dict) --

    • accountSettings (dict) --

      The Proton pipeline service role and repository data shared across the Amazon Web Services account.

      • pipelineCodebuildRoleArn (string) --

        The Amazon Resource Name (ARN) of the service role that Proton uses for provisioning pipelines. Proton assumes this role for CodeBuild-based provisioning.

      • pipelineProvisioningRepository (dict) --

        The linked repository for pipeline provisioning. Required if you have environments configured for self-managed provisioning with services that include pipelines. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository.

        • arn (string) --

          The Amazon Resource Name (ARN) of the linked repository.

        • branch (string) --

          The repository branch.

        • name (string) --

          The repository name.

        • provider (string) --

          The repository provider.

      • pipelineServiceRoleArn (string) --

        The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning.

Exceptions

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