dcloud s3 buckets create

Create a bucket

IAM s3:CreateBucketChanges state

Bucket names are shared by everyone on the platform: 409 when the name is taken or the organization is at its bucket limit.

Synopsis

dcloud s3 buckets create --name name [flags]

Flags

  • --nameRequired

    string

    Globally unique: 3–63 lowercase letters, digits and hyphens, no dots

    Constraints: 3-63 chars, /^[a-z0-9][a-z0-9-]*[a-z0-9]$/

  • --object-lockOptional

    boolean (--object-lock / --no-object-lock)

    Enable object lock, and with it versioning, for good. Only possible at creation

  • --zoneOptional

    string

    Zone the bytes live in, e.g. de1a (Falkenstein) or de1b (Nuremberg); the region default when omitted. Fixed for good

    Constraints: max 16 chars

  • --kms-key-idOptional

    string

    KMS key that encrypts the objects (SSE-KMS); the platform key (SSE-S3) when omitted. Needs kms:Encrypt on it

  • --tagsOptional

    map of string

    Tags for the new resource, e.g. {"env": "prod", "project": "shop"}. Keys your organization marks required must be present, or the create is refused with the missing keys (GET /tags/api/keys lists them).

    Constraints: key=value

Example

dcloud s3 buckets create --name example

Generated from the API description, the same one the API checks requests against and the CLI is built from.