mkcloudaccountawss3

Use the mkcloudaccountawss3 command to configure a new cloud account that uses Amazon Web Services (AWS) Amazon Simple Storage Service (Amazon S3) object storage.

Syntax

Read syntax diagramSkip visual syntax diagram mkcloudaccountawss3 -namename -bucketprefix bucket_prefix -accesskeyid aws_access_key_id -secretaccesskey aws_secret_access_key -certificatepath_to_certificate-upbandwidthmbits upbandwidth_limit_in_mb-downbandwidthmbits downbandwidth_limit_in_mb-region aws_region-encryptyesno

Parameters

-name name
(Optional) Specifies the name for the cloud account. The value must be an alphanumeric string.
-bucketprefix bucket_prefix
(Required) Specifies the prefix for the Amazon S3 bucket names that the system uses. The value must be a lower-case alphabetic string 3 - 58 characters long (with no dot or period at the start or end of the string, and no dot or period next to another dot or period). Prefix name must begin with a letter or number and can not be started with xn--.
-accesskeyid aws_access_key_id
(Required) Specifies the public part of the access key credential of the Amazon S3 account that the system use to access the cloud storage. The value must be a 20-character alphanumeric string of uppercase letters and numbers.
-secretaccesskey aws_secret_access_key
(Required) Specifies the non-public part of the access key credential of the Amazon S3 account that the system use to access the cloud storage. The value must be a 40-character alphanumeric string (That can contain slashes, or "/").
-certificate path_to_certificate
(Optional) Specifies the path to an SSL certificate authority (CA) certificate for Amazon S3 storage. The value must be an alphanumeric string of 1 - 255 characters (in base64-encoded PEM format).
-upbandwidthmbits upbandwidth_limit_in_mb
(Optional) Specifies the upload bandwidth limit in megabits per second (Mbps). The value must be a number 1 - 10240.
Note: No upload bandwidth limit is set unless you specify this keyword.
-downbandwidthmbits downbandwidth_limit_in_mb
(Optional) Specifies the download bandwidth limit in megabits per second (Mbps). The value must be a number 1 - 10240.
Note: No download bandwidth limit is set unless you specify this keyword.
-region aws_region
(Optional) Specifies the AWS region to use to access the cloud account and store data.
-encrypt yes | no
(Optional) Specifies whether to encrypt the data in the cloud account. By default, encryption is enabled unless you specify -encrypt no.

Description

This command configures a new cloud account that uses Amazon S3 object storage.

An invocation example

mkcloudaccountawss3 -name myamazon
                    -bucketprefix svc_backups
                    -accesskeyid AKIAIOSFODNN7EXAMPLE
                    -secretaccesskey wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
                    -upbandwidthmbits 100 
                    -downbandwidthmbits 100

The resulting output:

Cloud Account, id [0], successfully created