This command adds a cloud destination for replication. The destination must be an AWS S3 bucket or a custom destination that supports S3 access.
Usage - AWS S3 Bucket
s3replicationpeer create --name NAME --bucket-name BUCKET_NAME --type AWS_S3 --access-key ACCESS_KEY --secret-key SECRET_KEY --aws-region AWS_REGION [--proxies PROXIES]
Usage - Custom S3 Bucket
s3replicationpeer create --name NAME --bucket-name BUCKET_NAME --http-protocol http|https --type CUSTOM_S3 --access-key ACCESS_KEY --secret-key SECRET_KEY --custom-bucket-url CUSTOM_BUCKET_URL [--proxies PROXIES]
Required Parameters
| Sets the name of the target. |
| Sets the bucket name of the S3 bucket to which you are replicating the cluster's data (up to 63 characters). |
| Required only if type is set to custom_s3. Specifies which HTTP protocol over which to access the target. |
| Specify whether the target is an AWS bucket ( |
| Specifies the access key of a key pair for accessing the bucket. |
| Specifies the access key of a key pair for accessing the bucket. |
Options
| For a custom S3 target, include this option and specify the URL of the custom bucket. |
| For an AWS S3 target, include this option to specify the AWS region where the bucket resides. AWS-REGION is the region code. |
| Specifies proxies. If proxies are specified, replication traffic is routed via the proxies to and from the replication target. Proxies can either be external to the cluster or they can run on a subset of the cluster's CNodes. To use a CNode as a proxy, first install third party proxy software on the CNode and then enter the proxy here. You can specify up to eight proxies. Traffic is load balanced between the specified proxies, excluding any inactive proxies if applicable. Specify each proxy using the format To specify multiple proxies, separate the proxies by commas. For example: |
Example
vcli: admin> s3replicationpeer create --name MY-S3-BACKUP-TARGET --type AWS_S3 --access-key AKIARTN2ZMSYQSD5CW45 --secret-key ON/mupAUNe4DdWR5/thZxfoY2xjLLzLCb0SHqQ8n --bucket-name my-s3-bucket --aws-region us-east-1