CodeConnections *************** Client ====== class CodeConnections.Client A low-level client representing AWS CodeConnections This Amazon Web Services CodeConnections API Reference provides descriptions and usage examples of the operations and data types for the Amazon Web Services CodeConnections API. You can use the connections API to work with connections and installations. *Connections* are configurations that you use to connect Amazon Web Services resources to external code repositories. Each connection is a resource that can be given to services such as CodePipeline to connect to a third-party repository such as Bitbucket. For example, you can add the connection in CodePipeline so that it triggers your pipeline when a code change is made to your third-party code repository. Each connection is named and associated with a unique ARN that is used to reference the connection. When you create a connection, the console initiates a third-party connection handshake. *Installations* are the apps that are used to conduct this handshake. For example, the installation for the Bitbucket provider type is the Bitbucket app. When you create a connection, you can choose an existing installation or create one. When you want to create a connection to an installed provider type such as GitHub Enterprise Server, you create a *host* for your connections. You can work with connections by calling: * CreateConnection, which creates a uniquely named connection that can be referenced by services such as CodePipeline. * DeleteConnection, which deletes the specified connection. * GetConnection, which returns information about the connection, including the connection status. * ListConnections, which lists the connections associated with your account. You can work with hosts by calling: * CreateHost, which creates a host that represents the infrastructure where your provider is installed. * DeleteHost, which deletes the specified host. * GetHost, which returns information about the host, including the setup status. * ListHosts, which lists the hosts associated with your account. You can work with tags in Amazon Web Services CodeConnections by calling the following: * ListTagsForResource, which gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in Amazon Web Services CodeConnections. * TagResource, which adds or updates tags for a resource in Amazon Web Services CodeConnections. * UntagResource, which removes tags for a resource in Amazon Web Services CodeConnections. For information about how to use Amazon Web Services CodeConnections, see the Developer Tools User Guide. import boto3 client = boto3.client('codeconnections') These are the available methods: * can_paginate * close * create_connection * create_host * create_repository_link * create_sync_configuration * delete_connection * delete_host * delete_repository_link * delete_sync_configuration * get_connection * get_host * get_paginator * get_repository_link * get_repository_sync_status * get_resource_sync_status * get_sync_blocker_summary * get_sync_configuration * get_waiter * list_connections * list_hosts * list_repository_links * list_repository_sync_definitions * list_sync_configurations * list_tags_for_resource * tag_resource * untag_resource * update_host * update_repository_link * update_sync_blocker * update_sync_configuration CodeConnections / Client / update_sync_blocker update_sync_blocker ******************* CodeConnections.Client.update_sync_blocker(**kwargs) Allows you to update the status of a sync blocker, resolving the blocker and allowing syncing to continue. See also: AWS API Documentation **Request Syntax** response = client.update_sync_blocker( Id='string', SyncType='CFN_STACK_SYNC', ResourceName='string', ResolvedReason='string' ) Parameters: * **Id** (*string*) -- **[REQUIRED]** The ID of the sync blocker to be updated. * **SyncType** (*string*) -- **[REQUIRED]** The sync type of the sync blocker to be updated. * **ResourceName** (*string*) -- **[REQUIRED]** The name of the resource for the sync blocker to be updated. * **ResolvedReason** (*string*) -- **[REQUIRED]** The reason for resolving the sync blocker. Return type: dict Returns: **Response Syntax** { 'ResourceName': 'string', 'ParentResourceName': 'string', 'SyncBlocker': { 'Id': 'string', 'Type': 'AUTOMATED', 'Status': 'ACTIVE'|'RESOLVED', 'CreatedReason': 'string', 'CreatedAt': datetime(2015, 1, 1), 'Contexts': [ { 'Key': 'string', 'Value': 'string' }, ], 'ResolvedReason': 'string', 'ResolvedAt': datetime(2015, 1, 1) } } **Response Structure** * *(dict) --* * **ResourceName** *(string) --* The resource name for the sync blocker. * **ParentResourceName** *(string) --* The parent resource name for the sync blocker. * **SyncBlocker** *(dict) --* Information about the sync blocker to be updated. * **Id** *(string) --* The ID for a specific sync blocker. * **Type** *(string) --* The sync blocker type. * **Status** *(string) --* The status for a specific sync blocker. * **CreatedReason** *(string) --* The provided reason for a specific sync blocker. * **CreatedAt** *(datetime) --* The creation time for a specific sync blocker. * **Contexts** *(list) --* The contexts for a specific sync blocker. * *(dict) --* The context for a specific sync blocker. * **Key** *(string) --* The key provided for a context key-value pair for a specific sync blocker. * **Value** *(string) --* The value provided for a context key-value pair for a specific sync blocker. * **ResolvedReason** *(string) --* The resolved reason for a specific sync blocker. * **ResolvedAt** *(datetime) --* The time that a specific sync blocker was resolved. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.RetryLatestCommitFailedExcept ion" * "CodeConnections.Client.exceptions.SyncBlockerDoesNotExistExcept ion" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / list_repository_links list_repository_links ********************* CodeConnections.Client.list_repository_links(**kwargs) Lists the repository links created for connections in your account. See also: AWS API Documentation **Request Syntax** response = client.list_repository_links( MaxResults=123, NextToken='string' ) Parameters: * **MaxResults** (*integer*) -- A non-zero, non-negative integer used to limit the number of returned results. * **NextToken** (*string*) -- An enumeration token that, when provided in a request, returns the next batch of the results. Return type: dict Returns: **Response Syntax** { 'RepositoryLinks': [ { 'ConnectionArn': 'string', 'EncryptionKeyArn': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkArn': 'string', 'RepositoryLinkId': 'string', 'RepositoryName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **RepositoryLinks** *(list) --* Lists the repository links called by the list repository links operation. * *(dict) --* Information about the repository link resource, such as the repository link ARN, the associated connection ARN, encryption key ARN, and owner ID. * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection associated with the repository link. * **EncryptionKeyArn** *(string) --* The Amazon Resource Name (ARN) of the encryption key for the repository associated with the repository link. * **OwnerId** *(string) --* The owner ID for the repository associated with the repository link, such as the owner ID in GitHub. * **ProviderType** *(string) --* The provider type for the connection, such as GitHub, associated with the repository link. * **RepositoryLinkArn** *(string) --* The Amazon Resource Name (ARN) of the repository link. * **RepositoryLinkId** *(string) --* The ID of the repository link. * **RepositoryName** *(string) --* The name of the repository associated with the repository link. * **NextToken** *(string) --* An enumeration token that allows the operation to batch the results of the operation. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / get_paginator get_paginator ************* CodeConnections.Client.get_paginator(operation_name) Create a paginator for an operation. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Raises: **OperationNotPageableError** -- Raised if the operation is not pageable. You can use the "client.can_paginate" method to check if an operation is pageable. Return type: "botocore.paginate.Paginator" Returns: A paginator object. CodeConnections / Client / create_host create_host *********** CodeConnections.Client.create_host(**kwargs) Creates a resource that represents the infrastructure where a third-party provider is installed. The host is used when you create connections to an installed third-party provider type, such as GitHub Enterprise Server. You create one host for all connections to that provider. Note: A host created through the CLI or the SDK is in *PENDING* status by default. You can make its status *AVAILABLE* by setting up the host in the console. See also: AWS API Documentation **Request Syntax** response = client.create_host( Name='string', ProviderType='Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', ProviderEndpoint='string', VpcConfiguration={ 'VpcId': 'string', 'SubnetIds': [ 'string', ], 'SecurityGroupIds': [ 'string', ], 'TlsCertificate': 'string' }, Tags=[ { 'Key': 'string', 'Value': 'string' }, ] ) Parameters: * **Name** (*string*) -- **[REQUIRED]** The name of the host to be created. * **ProviderType** (*string*) -- **[REQUIRED]** The name of the installed provider to be associated with your connection. The host resource represents the infrastructure where your provider type is installed. The valid provider type is GitHub Enterprise Server. * **ProviderEndpoint** (*string*) -- **[REQUIRED]** The endpoint of the infrastructure to be represented by the host after it is created. * **VpcConfiguration** (*dict*) -- The VPC configuration to be provisioned for the host. A VPC must be configured and the infrastructure to be represented by the host must already be connected to the VPC. * **VpcId** *(string) --* **[REQUIRED]** The ID of the Amazon VPC connected to the infrastructure where your provider type is installed. * **SubnetIds** *(list) --* **[REQUIRED]** The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **SecurityGroupIds** *(list) --* **[REQUIRED]** The ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **TlsCertificate** *(string) --* The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed. * **Tags** (*list*) -- Tags for the host to be created. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* **[REQUIRED]** The tag's key. * **Value** *(string) --* **[REQUIRED]** The tag's value. Return type: dict Returns: **Response Syntax** { 'HostArn': 'string', 'Tags': [ { 'Key': 'string', 'Value': 'string' }, ] } **Response Structure** * *(dict) --* * **HostArn** *(string) --* The Amazon Resource Name (ARN) of the host to be created. * **Tags** *(list) --* Tags for the created host. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* The tag's key. * **Value** *(string) --* The tag's value. **Exceptions** * "CodeConnections.Client.exceptions.LimitExceededException" CodeConnections / Client / can_paginate can_paginate ************ CodeConnections.Client.can_paginate(operation_name) Check if an operation can be paginated. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Returns: "True" if the operation can be paginated, "False" otherwise. CodeConnections / Client / delete_host delete_host *********** CodeConnections.Client.delete_host(**kwargs) The host to be deleted. Before you delete a host, all connections associated to the host must be deleted. Note: A host cannot be deleted if it is in the VPC_CONFIG_INITIALIZING or VPC_CONFIG_DELETING state. See also: AWS API Documentation **Request Syntax** response = client.delete_host( HostArn='string' ) Parameters: **HostArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the host to be deleted. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ResourceUnavailableException" CodeConnections / Client / create_connection create_connection ***************** CodeConnections.Client.create_connection(**kwargs) Creates a connection that can then be given to other Amazon Web Services services like CodePipeline so that it can access third- party code repositories. The connection is in pending status until the third-party connection handshake is completed from the console. See also: AWS API Documentation **Request Syntax** response = client.create_connection( ProviderType='Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', ConnectionName='string', Tags=[ { 'Key': 'string', 'Value': 'string' }, ], HostArn='string' ) Parameters: * **ProviderType** (*string*) -- The name of the external provider where your third-party code repository is configured. * **ConnectionName** (*string*) -- **[REQUIRED]** The name of the connection to be created. * **Tags** (*list*) -- The key-value pair to use when tagging the resource. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* **[REQUIRED]** The tag's key. * **Value** *(string) --* **[REQUIRED]** The tag's value. * **HostArn** (*string*) -- The Amazon Resource Name (ARN) of the host associated with the connection to be created. Return type: dict Returns: **Response Syntax** { 'ConnectionArn': 'string', 'Tags': [ { 'Key': 'string', 'Value': 'string' }, ] } **Response Structure** * *(dict) --* * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection to be created. The ARN is used as the connection reference when the connection is shared between Amazon Web Services services. Note: The ARN is never reused if the connection is deleted. * **Tags** *(list) --* Specifies the tags applied to the resource. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* The tag's key. * **Value** *(string) --* The tag's value. **Exceptions** * "CodeConnections.Client.exceptions.LimitExceededException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ResourceUnavailableException" CodeConnections / Client / list_tags_for_resource list_tags_for_resource ********************** CodeConnections.Client.list_tags_for_resource(**kwargs) Gets the set of key-value pairs (metadata) that are used to manage the resource. See also: AWS API Documentation **Request Syntax** response = client.list_tags_for_resource( ResourceArn='string' ) Parameters: **ResourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the resource for which you want to get information about tags, if any. Return type: dict Returns: **Response Syntax** { 'Tags': [ { 'Key': 'string', 'Value': 'string' }, ] } **Response Structure** * *(dict) --* * **Tags** *(list) --* A list of tag key and value pairs associated with the specified resource. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* The tag's key. * **Value** *(string) --* The tag's value. **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" CodeConnections / Client / get_host get_host ******** CodeConnections.Client.get_host(**kwargs) Returns the host ARN and details such as status, provider type, endpoint, and, if applicable, the VPC configuration. See also: AWS API Documentation **Request Syntax** response = client.get_host( HostArn='string' ) Parameters: **HostArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the requested host. Return type: dict Returns: **Response Syntax** { 'Name': 'string', 'Status': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'ProviderEndpoint': 'string', 'VpcConfiguration': { 'VpcId': 'string', 'SubnetIds': [ 'string', ], 'SecurityGroupIds': [ 'string', ], 'TlsCertificate': 'string' } } **Response Structure** * *(dict) --* * **Name** *(string) --* The name of the requested host. * **Status** *(string) --* The status of the requested host. * **ProviderType** *(string) --* The provider type of the requested host, such as GitHub Enterprise Server. * **ProviderEndpoint** *(string) --* The endpoint of the infrastructure represented by the requested host. * **VpcConfiguration** *(dict) --* The VPC configuration of the requested host. * **VpcId** *(string) --* The ID of the Amazon VPC connected to the infrastructure where your provider type is installed. * **SubnetIds** *(list) --* The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **SecurityGroupIds** *(list) --* The ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **TlsCertificate** *(string) --* The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed. **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ResourceUnavailableException" CodeConnections / Client / untag_resource untag_resource ************** CodeConnections.Client.untag_resource(**kwargs) Removes tags from an Amazon Web Services resource. See also: AWS API Documentation **Request Syntax** response = client.untag_resource( ResourceArn='string', TagKeys=[ 'string', ] ) Parameters: * **ResourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the resource to remove tags from. * **TagKeys** (*list*) -- **[REQUIRED]** The list of keys for the tags to be removed from the resource. * *(string) --* Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" CodeConnections / Client / get_connection get_connection ************** CodeConnections.Client.get_connection(**kwargs) Returns the connection ARN and details such as status, owner, and provider type. See also: AWS API Documentation **Request Syntax** response = client.get_connection( ConnectionArn='string' ) Parameters: **ConnectionArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of a connection. Return type: dict Returns: **Response Syntax** { 'Connection': { 'ConnectionName': 'string', 'ConnectionArn': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'OwnerAccountId': 'string', 'ConnectionStatus': 'PENDING'|'AVAILABLE'|'ERROR', 'HostArn': 'string' } } **Response Structure** * *(dict) --* * **Connection** *(dict) --* The connection details, such as status, owner, and provider type. * **ConnectionName** *(string) --* The name of the connection. Connection names must be unique in an Amazon Web Services account. * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection. The ARN is used as the connection reference when the connection is shared between Amazon Web Services services. Note: The ARN is never reused if the connection is deleted. * **ProviderType** *(string) --* The name of the external provider where your third-party code repository is configured. * **OwnerAccountId** *(string) --* The identifier of the external provider where your third- party code repository is configured. For Bitbucket, this is the account ID of the owner of the Bitbucket repository. * **ConnectionStatus** *(string) --* The current status of the connection. * **HostArn** *(string) --* The Amazon Resource Name (ARN) of the host associated with the connection. **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ResourceUnavailableException" CodeConnections / Client / get_waiter get_waiter ********** CodeConnections.Client.get_waiter(waiter_name) Returns an object that can wait for some condition. Parameters: **waiter_name** (*str*) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters. Returns: The specified waiter object. Return type: "botocore.waiter.Waiter" CodeConnections / Client / update_host update_host *********** CodeConnections.Client.update_host(**kwargs) Updates a specified host with the provided configurations. See also: AWS API Documentation **Request Syntax** response = client.update_host( HostArn='string', ProviderEndpoint='string', VpcConfiguration={ 'VpcId': 'string', 'SubnetIds': [ 'string', ], 'SecurityGroupIds': [ 'string', ], 'TlsCertificate': 'string' } ) Parameters: * **HostArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the host to be updated. * **ProviderEndpoint** (*string*) -- The URL or endpoint of the host to be updated. * **VpcConfiguration** (*dict*) -- The VPC configuration of the host to be updated. A VPC must be configured and the infrastructure to be represented by the host must already be connected to the VPC. * **VpcId** *(string) --* **[REQUIRED]** The ID of the Amazon VPC connected to the infrastructure where your provider type is installed. * **SubnetIds** *(list) --* **[REQUIRED]** The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **SecurityGroupIds** *(list) --* **[REQUIRED]** The ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **TlsCertificate** *(string) --* The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.ConflictException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ResourceUnavailableException" * "CodeConnections.Client.exceptions.UnsupportedOperationException" CodeConnections / Client / get_sync_configuration get_sync_configuration ********************** CodeConnections.Client.get_sync_configuration(**kwargs) Returns details about a sync configuration, including the sync type and resource name. A sync configuration allows the configuration to sync (push and pull) changes from the remote repository for a specified branch in a Git repository. See also: AWS API Documentation **Request Syntax** response = client.get_sync_configuration( SyncType='CFN_STACK_SYNC', ResourceName='string' ) Parameters: * **SyncType** (*string*) -- **[REQUIRED]** The sync type for the sync configuration for which you want to retrieve information. * **ResourceName** (*string*) -- **[REQUIRED]** The name of the Amazon Web Services resource for the sync configuration for which you want to retrieve information. Return type: dict Returns: **Response Syntax** { 'SyncConfiguration': { 'Branch': 'string', 'ConfigFile': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkId': 'string', 'RepositoryName': 'string', 'ResourceName': 'string', 'RoleArn': 'string', 'SyncType': 'CFN_STACK_SYNC', 'PublishDeploymentStatus': 'ENABLED'|'DISABLED', 'TriggerResourceUpdateOn': 'ANY_CHANGE'|'FILE_CHANGE', 'PullRequestComment': 'ENABLED'|'DISABLED' } } **Response Structure** * *(dict) --* * **SyncConfiguration** *(dict) --* The details about the sync configuration for which you want to retrieve information. * **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. * **PullRequestComment** *(string) --* A toggle that specifies whether to enable or disable pull request comments for the sync configuration to be created. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / get_repository_sync_status get_repository_sync_status ************************** CodeConnections.Client.get_repository_sync_status(**kwargs) Returns details about the sync status for a repository. A repository sync uses Git sync to push and pull changes from your remote repository. See also: AWS API Documentation **Request Syntax** response = client.get_repository_sync_status( Branch='string', RepositoryLinkId='string', SyncType='CFN_STACK_SYNC' ) Parameters: * **Branch** (*string*) -- **[REQUIRED]** The branch of the repository link for the requested repository sync status. * **RepositoryLinkId** (*string*) -- **[REQUIRED]** The repository link ID for the requested repository sync status. * **SyncType** (*string*) -- **[REQUIRED]** The sync type of the requested sync status. Return type: dict Returns: **Response Syntax** { 'LatestSync': { 'StartedAt': datetime(2015, 1, 1), 'Status': 'FAILED'|'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'QUEUED', 'Events': [ { 'Event': 'string', 'ExternalId': 'string', 'Time': datetime(2015, 1, 1), 'Type': 'string' }, ] } } **Response Structure** * *(dict) --* * **LatestSync** *(dict) --* The status of the latest sync returned for a specified repository and branch. * **StartedAt** *(datetime) --* The start time of a specific sync attempt. * **Status** *(string) --* The status of a specific sync attempt. The following are valid statuses: * INITIATED - A repository sync attempt has been created and will begin soon. * IN_PROGRESS - A repository sync attempt has started and work is being done to reconcile the branch. * SUCCEEDED - The repository sync attempt has completed successfully. * FAILED - The repository sync attempt has failed. * QUEUED - The repository sync attempt didn't execute and was queued. * **Events** *(list) --* The events associated with a specific sync attempt. * *(dict) --* Information about a repository sync event. * **Event** *(string) --* A description of a repository sync event. * **ExternalId** *(string) --* The ID for a repository sync event. * **Time** *(datetime) --* The time that a repository sync event occurred. * **Type** *(string) --* The event type for a repository sync event. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / update_repository_link update_repository_link ********************** CodeConnections.Client.update_repository_link(**kwargs) Updates the association between your connection and a specified external Git repository. A repository link allows Git sync to monitor and sync changes to files in a specified Git repository. See also: AWS API Documentation **Request Syntax** response = client.update_repository_link( ConnectionArn='string', EncryptionKeyArn='string', RepositoryLinkId='string' ) Parameters: * **ConnectionArn** (*string*) -- The Amazon Resource Name (ARN) of the connection for the repository link to be updated. The updated connection ARN must have the same providerType (such as GitHub) as the original connection ARN for the repo link. * **EncryptionKeyArn** (*string*) -- The Amazon Resource Name (ARN) of the encryption key for the repository link to be updated. * **RepositoryLinkId** (*string*) -- **[REQUIRED]** The ID of the repository link to be updated. Return type: dict Returns: **Response Syntax** { 'RepositoryLinkInfo': { 'ConnectionArn': 'string', 'EncryptionKeyArn': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkArn': 'string', 'RepositoryLinkId': 'string', 'RepositoryName': 'string' } } **Response Structure** * *(dict) --* * **RepositoryLinkInfo** *(dict) --* Information about the repository link to be updated. * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection associated with the repository link. * **EncryptionKeyArn** *(string) --* The Amazon Resource Name (ARN) of the encryption key for the repository associated with the repository link. * **OwnerId** *(string) --* The owner ID for the repository associated with the repository link, such as the owner ID in GitHub. * **ProviderType** *(string) --* The provider type for the connection, such as GitHub, associated with the repository link. * **RepositoryLinkArn** *(string) --* The Amazon Resource Name (ARN) of the repository link. * **RepositoryLinkId** *(string) --* The ID of the repository link. * **RepositoryName** *(string) --* The name of the repository associated with the repository link. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConditionalCheckFailedExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" * "CodeConnections.Client.exceptions.UpdateOutOfSyncException" CodeConnections / Client / list_repository_sync_definitions list_repository_sync_definitions ******************************** CodeConnections.Client.list_repository_sync_definitions(**kwargs) Lists the repository sync definitions for repository links in your account. See also: AWS API Documentation **Request Syntax** response = client.list_repository_sync_definitions( RepositoryLinkId='string', SyncType='CFN_STACK_SYNC' ) Parameters: * **RepositoryLinkId** (*string*) -- **[REQUIRED]** The ID of the repository link for the sync definition for which you want to retrieve information. * **SyncType** (*string*) -- **[REQUIRED]** The sync type of the repository link for the the sync definition for which you want to retrieve information. Return type: dict Returns: **Response Syntax** { 'RepositorySyncDefinitions': [ { 'Branch': 'string', 'Directory': 'string', 'Parent': 'string', 'Target': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **RepositorySyncDefinitions** *(list) --* The list of repository sync definitions returned by the request. A "RepositorySyncDefinition" is a mapping from a repository branch to all the Amazon Web Services resources that are being synced from that branch. * *(dict) --* The definition for a repository with a sync configuration. * **Branch** *(string) --* The branch specified for a repository sync definition. * **Directory** *(string) --* The configuration file for a repository sync definition. This value comes from creating or updating the "config- file" field of a "sync-configuration". * **Parent** *(string) --* The parent resource specified for a repository sync definition. * **Target** *(string) --* The target resource specified for a repository sync definition. In some cases, such as CFN_STACK_SYNC, the parent and target resource are the same. * **NextToken** *(string) --* An enumeration token that, when provided in a request, returns the next batch of the results. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / get_resource_sync_status get_resource_sync_status ************************ CodeConnections.Client.get_resource_sync_status(**kwargs) Returns the status of the sync with the Git repository for a specific Amazon Web Services resource. See also: AWS API Documentation **Request Syntax** response = client.get_resource_sync_status( ResourceName='string', SyncType='CFN_STACK_SYNC' ) Parameters: * **ResourceName** (*string*) -- **[REQUIRED]** The name of the Amazon Web Services resource for the sync status with the Git repository. * **SyncType** (*string*) -- **[REQUIRED]** The sync type for the sync status with the Git repository. Return type: dict Returns: **Response Syntax** { 'DesiredState': { 'Branch': 'string', 'Directory': 'string', 'OwnerId': 'string', 'RepositoryName': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'Sha': 'string' }, 'LatestSuccessfulSync': { 'Events': [ { 'Event': 'string', 'ExternalId': 'string', 'Time': datetime(2015, 1, 1), 'Type': 'string' }, ], 'InitialRevision': { 'Branch': 'string', 'Directory': 'string', 'OwnerId': 'string', 'RepositoryName': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'Sha': 'string' }, 'StartedAt': datetime(2015, 1, 1), 'Status': 'FAILED'|'INITIATED'|'IN_PROGRESS'|'SUCCEEDED', 'TargetRevision': { 'Branch': 'string', 'Directory': 'string', 'OwnerId': 'string', 'RepositoryName': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'Sha': 'string' }, 'Target': 'string' }, 'LatestSync': { 'Events': [ { 'Event': 'string', 'ExternalId': 'string', 'Time': datetime(2015, 1, 1), 'Type': 'string' }, ], 'InitialRevision': { 'Branch': 'string', 'Directory': 'string', 'OwnerId': 'string', 'RepositoryName': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'Sha': 'string' }, 'StartedAt': datetime(2015, 1, 1), 'Status': 'FAILED'|'INITIATED'|'IN_PROGRESS'|'SUCCEEDED', 'TargetRevision': { 'Branch': 'string', 'Directory': 'string', 'OwnerId': 'string', 'RepositoryName': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'Sha': 'string' }, 'Target': 'string' } } **Response Structure** * *(dict) --* * **DesiredState** *(dict) --* The desired state of the Amazon Web Services resource for the sync status with the Git repository. * **Branch** *(string) --* The branch name for a specific revision. * **Directory** *(string) --* The directory, if any, for a specific revision. * **OwnerId** *(string) --* The owner ID for a specific revision, such as the GitHub owner ID for a GitHub repository. * **RepositoryName** *(string) --* The repository name for a specific revision. * **ProviderType** *(string) --* The provider type for a revision, such as GitHub. * **Sha** *(string) --* The SHA, such as the commit ID, for a specific revision. * **LatestSuccessfulSync** *(dict) --* The latest successful sync for the sync status with the Git repository. * **Events** *(list) --* The events related to a resource sync attempt. * *(dict) --* Information about a resource sync event for the resource associated with a sync configuration. * **Event** *(string) --* The event for a resource sync event. * **ExternalId** *(string) --* The ID for a resource sync event. * **Time** *(datetime) --* The time that a resource sync event occurred. * **Type** *(string) --* The type of resource sync event. * **InitialRevision** *(dict) --* The current state of the resource as defined in the resource's "config-file" in the linked repository. * **Branch** *(string) --* The branch name for a specific revision. * **Directory** *(string) --* The directory, if any, for a specific revision. * **OwnerId** *(string) --* The owner ID for a specific revision, such as the GitHub owner ID for a GitHub repository. * **RepositoryName** *(string) --* The repository name for a specific revision. * **ProviderType** *(string) --* The provider type for a revision, such as GitHub. * **Sha** *(string) --* The SHA, such as the commit ID, for a specific revision. * **StartedAt** *(datetime) --* The start time for a resource sync attempt. * **Status** *(string) --* The status for a resource sync attempt. The follow are valid statuses: * SYNC-INITIATED - A resource sync attempt has been created and will begin soon. * SYNCING - Syncing has started and work is being done to reconcile state. * SYNCED - Syncing has completed successfully. * SYNC_FAILED - A resource sync attempt has failed. * **TargetRevision** *(dict) --* The desired state of the resource as defined in the resource's "config-file" in the linked repository. Git sync attempts to update the resource to this state. * **Branch** *(string) --* The branch name for a specific revision. * **Directory** *(string) --* The directory, if any, for a specific revision. * **OwnerId** *(string) --* The owner ID for a specific revision, such as the GitHub owner ID for a GitHub repository. * **RepositoryName** *(string) --* The repository name for a specific revision. * **ProviderType** *(string) --* The provider type for a revision, such as GitHub. * **Sha** *(string) --* The SHA, such as the commit ID, for a specific revision. * **Target** *(string) --* The name of the Amazon Web Services resource that is attempted to be synchronized. * **LatestSync** *(dict) --* The latest sync for the sync status with the Git repository, whether successful or not. * **Events** *(list) --* The events related to a resource sync attempt. * *(dict) --* Information about a resource sync event for the resource associated with a sync configuration. * **Event** *(string) --* The event for a resource sync event. * **ExternalId** *(string) --* The ID for a resource sync event. * **Time** *(datetime) --* The time that a resource sync event occurred. * **Type** *(string) --* The type of resource sync event. * **InitialRevision** *(dict) --* The current state of the resource as defined in the resource's "config-file" in the linked repository. * **Branch** *(string) --* The branch name for a specific revision. * **Directory** *(string) --* The directory, if any, for a specific revision. * **OwnerId** *(string) --* The owner ID for a specific revision, such as the GitHub owner ID for a GitHub repository. * **RepositoryName** *(string) --* The repository name for a specific revision. * **ProviderType** *(string) --* The provider type for a revision, such as GitHub. * **Sha** *(string) --* The SHA, such as the commit ID, for a specific revision. * **StartedAt** *(datetime) --* The start time for a resource sync attempt. * **Status** *(string) --* The status for a resource sync attempt. The follow are valid statuses: * SYNC-INITIATED - A resource sync attempt has been created and will begin soon. * SYNCING - Syncing has started and work is being done to reconcile state. * SYNCED - Syncing has completed successfully. * SYNC_FAILED - A resource sync attempt has failed. * **TargetRevision** *(dict) --* The desired state of the resource as defined in the resource's "config-file" in the linked repository. Git sync attempts to update the resource to this state. * **Branch** *(string) --* The branch name for a specific revision. * **Directory** *(string) --* The directory, if any, for a specific revision. * **OwnerId** *(string) --* The owner ID for a specific revision, such as the GitHub owner ID for a GitHub repository. * **RepositoryName** *(string) --* The repository name for a specific revision. * **ProviderType** *(string) --* The provider type for a revision, such as GitHub. * **Sha** *(string) --* The SHA, such as the commit ID, for a specific revision. * **Target** *(string) --* The name of the Amazon Web Services resource that is attempted to be synchronized. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / get_repository_link get_repository_link ******************* CodeConnections.Client.get_repository_link(**kwargs) Returns details about a repository link. A repository link allows Git sync to monitor and sync changes from files in a specified Git repository. See also: AWS API Documentation **Request Syntax** response = client.get_repository_link( RepositoryLinkId='string' ) Parameters: **RepositoryLinkId** (*string*) -- **[REQUIRED]** The ID of the repository link to get. Return type: dict Returns: **Response Syntax** { 'RepositoryLinkInfo': { 'ConnectionArn': 'string', 'EncryptionKeyArn': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkArn': 'string', 'RepositoryLinkId': 'string', 'RepositoryName': 'string' } } **Response Structure** * *(dict) --* * **RepositoryLinkInfo** *(dict) --* The information returned for a specified repository link. * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection associated with the repository link. * **EncryptionKeyArn** *(string) --* The Amazon Resource Name (ARN) of the encryption key for the repository associated with the repository link. * **OwnerId** *(string) --* The owner ID for the repository associated with the repository link, such as the owner ID in GitHub. * **ProviderType** *(string) --* The provider type for the connection, such as GitHub, associated with the repository link. * **RepositoryLinkArn** *(string) --* The Amazon Resource Name (ARN) of the repository link. * **RepositoryLinkId** *(string) --* The ID of the repository link. * **RepositoryName** *(string) --* The name of the repository associated with the repository link. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / create_sync_configuration create_sync_configuration ************************* CodeConnections.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', PullRequestComment='ENABLED'|'DISABLED' ) 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. * **PullRequestComment** (*string*) -- A toggle that specifies whether to enable or disable pull request comments for the sync configuration to be created. Return type: dict Returns: **Response Syntax** { 'SyncConfiguration': { 'Branch': 'string', 'ConfigFile': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkId': 'string', 'RepositoryName': 'string', 'ResourceName': 'string', 'RoleArn': 'string', 'SyncType': 'CFN_STACK_SYNC', 'PublishDeploymentStatus': 'ENABLED'|'DISABLED', 'TriggerResourceUpdateOn': 'ANY_CHANGE'|'FILE_CHANGE', 'PullRequestComment': 'ENABLED'|'DISABLED' } } **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. * **PullRequestComment** *(string) --* A toggle that specifies whether to enable or disable pull request comments for the sync configuration to be created. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.LimitExceededException" * "CodeConnections.Client.exceptions.ResourceAlreadyExistsExceptio n" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / close close ***** CodeConnections.Client.close() Closes underlying endpoint connections. CodeConnections / Client / create_repository_link create_repository_link ********************** CodeConnections.Client.create_repository_link(**kwargs) Creates a link to a specified external Git repository. A repository link allows Git sync to monitor and sync changes to files in a specified Git repository. See also: AWS API Documentation **Request Syntax** response = client.create_repository_link( ConnectionArn='string', OwnerId='string', RepositoryName='string', EncryptionKeyArn='string', Tags=[ { 'Key': 'string', 'Value': 'string' }, ] ) Parameters: * **ConnectionArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the connection to be associated with the repository link. * **OwnerId** (*string*) -- **[REQUIRED]** The owner ID for the repository associated with a specific sync configuration, such as the owner ID in GitHub. * **RepositoryName** (*string*) -- **[REQUIRED]** The name of the repository to be associated with the repository link. * **EncryptionKeyArn** (*string*) -- The Amazon Resource Name (ARN) encryption key for the repository to be associated with the repository link. * **Tags** (*list*) -- The tags for the repository to be associated with the repository link. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* **[REQUIRED]** The tag's key. * **Value** *(string) --* **[REQUIRED]** The tag's value. Return type: dict Returns: **Response Syntax** { 'RepositoryLinkInfo': { 'ConnectionArn': 'string', 'EncryptionKeyArn': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkArn': 'string', 'RepositoryLinkId': 'string', 'RepositoryName': 'string' } } **Response Structure** * *(dict) --* * **RepositoryLinkInfo** *(dict) --* The returned information about the created repository link. * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection associated with the repository link. * **EncryptionKeyArn** *(string) --* The Amazon Resource Name (ARN) of the encryption key for the repository associated with the repository link. * **OwnerId** *(string) --* The owner ID for the repository associated with the repository link, such as the owner ID in GitHub. * **ProviderType** *(string) --* The provider type for the connection, such as GitHub, associated with the repository link. * **RepositoryLinkArn** *(string) --* The Amazon Resource Name (ARN) of the repository link. * **RepositoryLinkId** *(string) --* The ID of the repository link. * **RepositoryName** *(string) --* The name of the repository associated with the repository link. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.LimitExceededException" * "CodeConnections.Client.exceptions.ResourceAlreadyExistsExceptio n" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / delete_connection delete_connection ***************** CodeConnections.Client.delete_connection(**kwargs) The connection to be deleted. See also: AWS API Documentation **Request Syntax** response = client.delete_connection( ConnectionArn='string' ) Parameters: **ConnectionArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the connection to be deleted. Note: The ARN is never reused if the connection is deleted. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" CodeConnections / Client / list_sync_configurations list_sync_configurations ************************ CodeConnections.Client.list_sync_configurations(**kwargs) Returns a list of sync configurations for a specified repository. See also: AWS API Documentation **Request Syntax** response = client.list_sync_configurations( MaxResults=123, NextToken='string', RepositoryLinkId='string', SyncType='CFN_STACK_SYNC' ) Parameters: * **MaxResults** (*integer*) -- A non-zero, non-negative integer used to limit the number of returned results. * **NextToken** (*string*) -- An enumeration token that allows the operation to batch the results of the operation. * **RepositoryLinkId** (*string*) -- **[REQUIRED]** The ID of the repository link for the requested list of sync configurations. * **SyncType** (*string*) -- **[REQUIRED]** The sync type for the requested list of sync configurations. Return type: dict Returns: **Response Syntax** { 'SyncConfigurations': [ { 'Branch': 'string', 'ConfigFile': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkId': 'string', 'RepositoryName': 'string', 'ResourceName': 'string', 'RoleArn': 'string', 'SyncType': 'CFN_STACK_SYNC', 'PublishDeploymentStatus': 'ENABLED'|'DISABLED', 'TriggerResourceUpdateOn': 'ANY_CHANGE'|'FILE_CHANGE', 'PullRequestComment': 'ENABLED'|'DISABLED' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **SyncConfigurations** *(list) --* The list of repository sync definitions returned by the request. * *(dict) --* Information, such as repository, branch, provider, and resource names for a specific sync configuration. * **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. * **PullRequestComment** *(string) --* A toggle that specifies whether to enable or disable pull request comments for the sync configuration to be created. * **NextToken** *(string) --* An enumeration token that allows the operation to batch the next results of the operation. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / list_hosts list_hosts ********** CodeConnections.Client.list_hosts(**kwargs) Lists the hosts associated with your account. See also: AWS API Documentation **Request Syntax** response = client.list_hosts( MaxResults=123, NextToken='string' ) Parameters: * **MaxResults** (*integer*) -- The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned "nextToken" value. * **NextToken** (*string*) -- The token that was returned from the previous "ListHosts" call, which can be used to return the next set of hosts in the list. Return type: dict Returns: **Response Syntax** { 'Hosts': [ { 'Name': 'string', 'HostArn': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'ProviderEndpoint': 'string', 'VpcConfiguration': { 'VpcId': 'string', 'SubnetIds': [ 'string', ], 'SecurityGroupIds': [ 'string', ], 'TlsCertificate': 'string' }, 'Status': 'string', 'StatusMessage': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **Hosts** *(list) --* A list of hosts and the details for each host, such as status, endpoint, and provider type. * *(dict) --* A resource that represents the infrastructure where a third-party provider is installed. The host is used when you create connections to an installed third-party provider type, such as GitHub Enterprise Server. You create one host for all connections to that provider. Note: A host created through the CLI or the SDK is in *PENDING* status by default. You can make its status *AVAILABLE* by setting up the host in the console. * **Name** *(string) --* The name of the host. * **HostArn** *(string) --* The Amazon Resource Name (ARN) of the host. * **ProviderType** *(string) --* The name of the installed provider to be associated with your connection. The host resource represents the infrastructure where your provider type is installed. The valid provider type is GitHub Enterprise Server. * **ProviderEndpoint** *(string) --* The endpoint of the infrastructure where your provider type is installed. * **VpcConfiguration** *(dict) --* The VPC configuration provisioned for the host. * **VpcId** *(string) --* The ID of the Amazon VPC connected to the infrastructure where your provider type is installed. * **SubnetIds** *(list) --* The ID of the subnet or subnets associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **SecurityGroupIds** *(list) --* The ID of the security group or security groups associated with the Amazon VPC connected to the infrastructure where your provider type is installed. * *(string) --* * **TlsCertificate** *(string) --* The value of the Transport Layer Security (TLS) certificate associated with the infrastructure where your provider type is installed. * **Status** *(string) --* The status of the host, such as PENDING, AVAILABLE, VPC_CONFIG_DELETING, VPC_CONFIG_INITIALIZING, and VPC_CONFIG_FAILED_INITIALIZATION. * **StatusMessage** *(string) --* The status description for the host. * **NextToken** *(string) --* A token that can be used in the next "ListHosts" call. To view all items in the list, continue to call this operation with each subsequent token until no more "nextToken" values are returned. CodeConnections / Client / get_sync_blocker_summary get_sync_blocker_summary ************************ CodeConnections.Client.get_sync_blocker_summary(**kwargs) Returns a list of the most recent sync blockers. See also: AWS API Documentation **Request Syntax** response = client.get_sync_blocker_summary( SyncType='CFN_STACK_SYNC', ResourceName='string' ) Parameters: * **SyncType** (*string*) -- **[REQUIRED]** The sync type for the sync blocker summary. * **ResourceName** (*string*) -- **[REQUIRED]** The name of the Amazon Web Services resource currently blocked from automatically being synced from a Git repository. Return type: dict Returns: **Response Syntax** { 'SyncBlockerSummary': { 'ResourceName': 'string', 'ParentResourceName': 'string', 'LatestBlockers': [ { 'Id': 'string', 'Type': 'AUTOMATED', 'Status': 'ACTIVE'|'RESOLVED', 'CreatedReason': 'string', 'CreatedAt': datetime(2015, 1, 1), 'Contexts': [ { 'Key': 'string', 'Value': 'string' }, ], 'ResolvedReason': 'string', 'ResolvedAt': datetime(2015, 1, 1) }, ] } } **Response Structure** * *(dict) --* * **SyncBlockerSummary** *(dict) --* The list of sync blockers for a specified resource. * **ResourceName** *(string) --* The resource name for sync blocker summary. * **ParentResourceName** *(string) --* The parent resource name for a sync blocker summary. * **LatestBlockers** *(list) --* The latest events for a sync blocker summary. * *(dict) --* Information about a blocker for a sync event. * **Id** *(string) --* The ID for a specific sync blocker. * **Type** *(string) --* The sync blocker type. * **Status** *(string) --* The status for a specific sync blocker. * **CreatedReason** *(string) --* The provided reason for a specific sync blocker. * **CreatedAt** *(datetime) --* The creation time for a specific sync blocker. * **Contexts** *(list) --* The contexts for a specific sync blocker. * *(dict) --* The context for a specific sync blocker. * **Key** *(string) --* The key provided for a context key-value pair for a specific sync blocker. * **Value** *(string) --* The value provided for a context key-value pair for a specific sync blocker. * **ResolvedReason** *(string) --* The resolved reason for a specific sync blocker. * **ResolvedAt** *(datetime) --* The time that a specific sync blocker was resolved. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / update_sync_configuration update_sync_configuration ************************* CodeConnections.Client.update_sync_configuration(**kwargs) Updates the sync configuration for your connection and a specified external Git repository. See also: AWS API Documentation **Request Syntax** response = client.update_sync_configuration( Branch='string', ConfigFile='string', RepositoryLinkId='string', ResourceName='string', RoleArn='string', SyncType='CFN_STACK_SYNC', PublishDeploymentStatus='ENABLED'|'DISABLED', TriggerResourceUpdateOn='ANY_CHANGE'|'FILE_CHANGE', PullRequestComment='ENABLED'|'DISABLED' ) Parameters: * **Branch** (*string*) -- The branch for the sync configuration to be updated. * **ConfigFile** (*string*) -- The configuration file for the sync configuration to be updated. * **RepositoryLinkId** (*string*) -- The ID of the repository link for the sync configuration to be updated. * **ResourceName** (*string*) -- **[REQUIRED]** The name of the Amazon Web Services resource for the sync configuration to be updated. * **RoleArn** (*string*) -- The ARN of the IAM role for the sync configuration to be updated. * **SyncType** (*string*) -- **[REQUIRED]** The sync type for the sync configuration to be updated. * **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. * **PullRequestComment** (*string*) -- TA toggle that specifies whether to enable or disable pull request comments for the sync configuration to be updated. Return type: dict Returns: **Response Syntax** { 'SyncConfiguration': { 'Branch': 'string', 'ConfigFile': 'string', 'OwnerId': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'RepositoryLinkId': 'string', 'RepositoryName': 'string', 'ResourceName': 'string', 'RoleArn': 'string', 'SyncType': 'CFN_STACK_SYNC', 'PublishDeploymentStatus': 'ENABLED'|'DISABLED', 'TriggerResourceUpdateOn': 'ANY_CHANGE'|'FILE_CHANGE', 'PullRequestComment': 'ENABLED'|'DISABLED' } } **Response Structure** * *(dict) --* * **SyncConfiguration** *(dict) --* The information returned for the sync configuration to be updated. * **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. * **PullRequestComment** *(string) --* A toggle that specifies whether to enable or disable pull request comments for the sync configuration to be created. **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" * "CodeConnections.Client.exceptions.UpdateOutOfSyncException" CodeConnections / Client / tag_resource tag_resource ************ CodeConnections.Client.tag_resource(**kwargs) Adds to or modifies the tags of the given resource. Tags are metadata that can be used to manage a resource. See also: AWS API Documentation **Request Syntax** response = client.tag_resource( ResourceArn='string', Tags=[ { 'Key': 'string', 'Value': 'string' }, ] ) Parameters: * **ResourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the resource to which you want to add or update tags. * **Tags** (*list*) -- **[REQUIRED]** The tags you want to modify or add to the resource. * *(dict) --* A tag is a key-value pair that is used to manage the resource. This tag is available for use by Amazon Web Services services that support tags. * **Key** *(string) --* **[REQUIRED]** The tag's key. * **Value** *(string) --* **[REQUIRED]** The tag's value. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.LimitExceededException" CodeConnections / Client / delete_repository_link delete_repository_link ********************** CodeConnections.Client.delete_repository_link(**kwargs) Deletes the association between your connection and a specified external Git repository. See also: AWS API Documentation **Request Syntax** response = client.delete_repository_link( RepositoryLinkId='string' ) Parameters: **RepositoryLinkId** (*string*) -- **[REQUIRED]** The ID of the repository link to be deleted. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.SyncConfigurationStillExistsE xception" * "CodeConnections.Client.exceptions.ResourceNotFoundException" * "CodeConnections.Client.exceptions.ThrottlingException" * "CodeConnections.Client.exceptions.UnsupportedProviderTypeExcept ion" CodeConnections / Client / delete_sync_configuration delete_sync_configuration ************************* CodeConnections.Client.delete_sync_configuration(**kwargs) Deletes the sync configuration for a specified repository and connection. See also: AWS API Documentation **Request Syntax** response = client.delete_sync_configuration( SyncType='CFN_STACK_SYNC', ResourceName='string' ) Parameters: * **SyncType** (*string*) -- **[REQUIRED]** The type of sync configuration to be deleted. * **ResourceName** (*string*) -- **[REQUIRED]** The name of the Amazon Web Services resource associated with the sync configuration to be deleted. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "CodeConnections.Client.exceptions.AccessDeniedException" * "CodeConnections.Client.exceptions.ConcurrentModificationExcepti on" * "CodeConnections.Client.exceptions.InternalServerException" * "CodeConnections.Client.exceptions.InvalidInputException" * "CodeConnections.Client.exceptions.LimitExceededException" * "CodeConnections.Client.exceptions.ThrottlingException" CodeConnections / Client / list_connections list_connections **************** CodeConnections.Client.list_connections(**kwargs) Lists the connections associated with your account. See also: AWS API Documentation **Request Syntax** response = client.list_connections( ProviderTypeFilter='Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', HostArnFilter='string', MaxResults=123, NextToken='string' ) Parameters: * **ProviderTypeFilter** (*string*) -- Filters the list of connections to those associated with a specified provider, such as Bitbucket. * **HostArnFilter** (*string*) -- Filters the list of connections to those associated with a specified host. * **MaxResults** (*integer*) -- The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned "nextToken" value. * **NextToken** (*string*) -- The token that was returned from the previous "ListConnections" call, which can be used to return the next set of connections in the list. Return type: dict Returns: **Response Syntax** { 'Connections': [ { 'ConnectionName': 'string', 'ConnectionArn': 'string', 'ProviderType': 'Bitbucket'|'GitHub'|'GitHubEnterpriseServer'|'GitLab'|'GitLabSelfManaged'|'AzureDevOps', 'OwnerAccountId': 'string', 'ConnectionStatus': 'PENDING'|'AVAILABLE'|'ERROR', 'HostArn': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **Connections** *(list) --* A list of connections and the details for each connection, such as status, owner, and provider type. * *(dict) --* A resource that is used to connect third-party source providers with services like CodePipeline. Note: A connection created through CloudFormation, the CLI, or the SDK is in *PENDING* status by default. You can make its status *AVAILABLE* by updating the connection in the console. * **ConnectionName** *(string) --* The name of the connection. Connection names must be unique in an Amazon Web Services account. * **ConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the connection. The ARN is used as the connection reference when the connection is shared between Amazon Web Services services. Note: The ARN is never reused if the connection is deleted. * **ProviderType** *(string) --* The name of the external provider where your third-party code repository is configured. * **OwnerAccountId** *(string) --* The identifier of the external provider where your third-party code repository is configured. For Bitbucket, this is the account ID of the owner of the Bitbucket repository. * **ConnectionStatus** *(string) --* The current status of the connection. * **HostArn** *(string) --* The Amazon Resource Name (ARN) of the host associated with the connection. * **NextToken** *(string) --* A token that can be used in the next "ListConnections" call. To view all items in the list, continue to call this operation with each subsequent token until no more "nextToken" values are returned. **Exceptions** * "CodeConnections.Client.exceptions.ResourceNotFoundException"