All Products
Search

This Product

    Object Storage Service:create-bucket-data-redundancy-transition

    Document Center

    Object Storage Service:create-bucket-data-redundancy-transition

    Last Updated:Sep 18, 2024

    The command create-bucket-data-redundancy-transition is used to create redundancy type conversion tasks for OSS buckets.

    Usage notes

    • By default, an Alibaba Cloud account has the permissions to query the TLS version configurations of OSS buckets. Making query requests as a RAM user or by using Security Token Service (STS) requires oss:CreateBucketDataRedundancyTransition permissions. For more information, see Attach a custom policy to a RAM user.

    • The existing redundancy type of the bucket must be locally redundant storage (LRS). Only coversion from LRS to ZRS (Zone-redundant storage) is supported with OSS. You cannot change the storage redundancy type from ZRS to LRS.

    • The storage class of the bucket must be Standard, Infrequent Access (IA), or Archive. However, the storage class of objects in the bucket can be Cold Archive or Deep Cold Archive. Cold Archive and Deep Cold Archive objects are still stored as LRS objects after the conversion. You cannot change the redundancy type of a Cold Archive or Deep Cold Archive bucket.

    Command syntax

    ossutil api create-bucket-data-redundancy-transition --bucket value --target-redundancy-type value [flags]

    Parameter

    Type

    Description

    --bucket

    string

    Name of the bucket.

    --target-redundancy-type

    string

    The redundancy type to which you want to convert the bucket.

    Note

    • The create-bucket-data-redundancy-transition command corresponds to the CreateBucketDataRedundancyTransition operation. For more information about the parameters in CreateBucketDataRedundancyTransition operation, see CreateBucketDataRedundancyTransition.

    • For more information about supported global command-line options, see Command-line options.

    Examples

    • Create a redundancy type conversion task for examplebucket.

      ossutil api create-bucket-data-redundancy-transition --bucket examplebucket --target-redundancy-type ZRS

    • Create a redundancy type conversion task for examplebucket and display the result in JSON format.

      ossutil api create-bucket-data-redundancy-transition --bucket examplebucket --target-redundancy-type ZRS --output-format json

    • Create a redundancy type conversion task for examplebucket and display the result in YAML format.

      ossutil api create-bucket-data-redundancy-transition --bucket examplebucket --target-redundancy-type ZRS --output-format yaml