AWS CLI Command Reference

Note:

You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . codeconnections ]

create-sync-configuration

Description

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

Synopsis

  create-sync-configuration
--branch <value>
--config-file <value>
--repository-link-id <value>
--resource-name <value>
--role-arn <value>
--sync-type <value>
[--publish-deployment-status <value>]
[--trigger-resource-update-on <value>]
[--pull-request-comment <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]

Options

--branch (string)

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

--config-file (string)

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

--repository-link-id (string)

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.

--resource-name (string)

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.

--role-arn (string)

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.

--sync-type (string)

The type of sync configuration.

Possible values:

  • CFN_STACK_SYNC

--publish-deployment-status (string)

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

Possible values:

  • ENABLED
  • DISABLED

--trigger-resource-update-on (string)

When to trigger Git sync to begin the stack update.

Possible values:

  • ANY_CHANGE
  • FILE_CHANGE

--pull-request-comment (string)

A toggle that specifies whether to enable or disable pull request comments for the sync configuration to be created.

Possible values:

  • ENABLED
  • DISABLED

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command's default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

  • json
  • text
  • table

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

Output

SyncConfiguration -> (structure)

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.