mkcloudaccountawss3

Use the mkcloudaccountawss3 command to configure a new cloud account that uses Amazon S3 object storage.

Syntax

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 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 end of the string, and no dot or period next to another dot or period).
-accesskeyid aws_access_key_id: (Required) Specifies the public part of the Amazon Web Services (AWS) access key credential of the AWS user 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 AWS access key credential 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 AWS S3. 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.
-downbandwidthmbits downbandwidth_limit_in_mb: (Optional) Specifies the download bandwidth limit in megabits per second (Mbps). The value must be a number 1 - 10240.
-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

Note: If the system contains an encrypted cloud account that uses USB encryption, a USB flash drive with the system master key must be present in the configuration node before the cloud account can move to the online state. This requirement is necessary when the system is powered down, and then restarted.