CodeStarconnections / Client / create_sync_configuration

create_sync_configuration

CodeStarconnections.Client.create_sync_configuration(**kwargs)

Creates a sync configuration which allows Amazon Web Services to sync content from a Git repository to update a specified Amazon Web Services resource. Parameters for the sync configuration are determined by the sync type.

See also: AWS API Documentation

Request Syntax

response = client.create_sync_configuration(
    Branch='string',
    ConfigFile='string',
    RepositoryLinkId='string',
    ResourceName='string',
    RoleArn='string',
    SyncType='CFN_STACK_SYNC',
    PublishDeploymentStatus='ENABLED'|'DISABLED',
    TriggerResourceUpdateOn='ANY_CHANGE'|'FILE_CHANGE'
)

Parameters:

• Branch (string) –

  [REQUIRED]

  The branch in the repository from which changes will be synced.

• ConfigFile (string) –

  [REQUIRED]

  The file name of the configuration file that manages syncing between the connection and the repository. This configuration file is stored in the repository.

• RepositoryLinkId (string) –

  [REQUIRED]

  The ID of the repository link created for the connection. A repository link allows Git sync to monitor and sync changes to files in a specified Git repository.

• ResourceName (string) –

  [REQUIRED]

  The name of the Amazon Web Services resource (for example, a CloudFormation stack in the case of CFN_STACK_SYNC) that will be synchronized from the linked repository.

• RoleArn (string) –

  [REQUIRED]

  The ARN of the IAM role that grants permission for Amazon Web Services to use Git sync to update a given Amazon Web Services resource on your behalf.

• SyncType (string) –

  [REQUIRED]

  The type of sync configuration.

• PublishDeploymentStatus (string) – Whether to enable or disable publishing of deployment status to source providers.

• TriggerResourceUpdateOn (string) – When to trigger Git sync to begin the stack update.

Return type:

dict

Returns:

Response Syntax

{
    'SyncConfiguration': {
        'Branch': 'string',
        'ConfigFile': 'string',
        'OwnerId': 'string',
        'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged',
        'RepositoryLinkId': 'string',
        'RepositoryName': 'string',
        'ResourceName': 'string',
        'RoleArn': 'string',
        'SyncType': 'CFN_STACK_SYNC',
        'PublishDeploymentStatus': 'ENABLED'|'DISABLED',
        'TriggerResourceUpdateOn': 'ANY_CHANGE'|'FILE_CHANGE'
    }
}

Response Structure

• (dict) –

  • SyncConfiguration (dict) –

    The created sync configuration for the connection. A sync configuration allows Amazon Web Services to sync content from a Git repository to update a specified Amazon Web Services resource.

    • Branch (string) –

      The branch associated with a specific sync configuration.

    • ConfigFile (string) –

      The file path to the configuration file associated with a specific sync configuration. The path should point to an actual file in the sync configurations linked repository.

    • OwnerId (string) –

      The owner ID for the repository associated with a specific sync configuration, such as the owner ID in GitHub.

    • ProviderType (string) –

      The connection provider type associated with a specific sync configuration, such as GitHub.

    • RepositoryLinkId (string) –

      The ID of the repository link associated with a specific sync configuration.

    • RepositoryName (string) –

      The name of the repository associated with a specific sync configuration.

    • ResourceName (string) –

      The name of the connection resource associated with a specific sync configuration.

    • RoleArn (string) –

      The Amazon Resource Name (ARN) of the IAM role associated with a specific sync configuration.

    • SyncType (string) –

      The type of sync for a specific sync configuration.

    • PublishDeploymentStatus (string) –

      Whether to enable or disable publishing of deployment status to source providers.

    • TriggerResourceUpdateOn (string) –

      When to trigger Git sync to begin the stack update.

Exceptions

• CodeStarconnections.Client.exceptions.AccessDeniedException

• CodeStarconnections.Client.exceptions.ConcurrentModificationException

• CodeStarconnections.Client.exceptions.InternalServerException

• CodeStarconnections.Client.exceptions.InvalidInputException

• CodeStarconnections.Client.exceptions.LimitExceededException

• CodeStarconnections.Client.exceptions.ResourceAlreadyExistsException

• CodeStarconnections.Client.exceptions.ThrottlingException