AWS CLI Command Reference

[ 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 | --cli-input-yaml]
[--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>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

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 | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those 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. This may not be specified along with --cli-input-yaml.

--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. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.

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
  • yaml
  • yaml-stream

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

--cli-binary-format (string)

The formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary blobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS CLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a binary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Disable cli pager for output.

--cli-auto-prompt (boolean)

Automatically prompt for CLI input parameters.

--no-cli-auto-prompt (boolean)

Disable automatically prompt for CLI input parameters.

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.
© Copyright 2018, Amazon Web Services. Created using Sphinx.