All Products
Search

This Product

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

    Document Center

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

    Last Updated:Mar 20, 2026

    Retrieves the status and details of a redundancy type conversion task on an OSS bucket.

    Permissions

    Alibaba Cloud account holders can run this command without additional configuration.

    RAM users and Security Token Service (STS) callers require the oss:GetBucketDataRedundancyTransition permission. To grant this permission, see Attach a custom policy to a RAM user.

    Syntax

    ossutil api get-bucket-data-redundancy-transition --bucket <value> --redundancy-transition-taskid <value> [flags]

    Parameters

    ParameterTypeRequiredDescription
    --bucketstringYesName of the bucket.
    --redundancy-transition-taskidstringYesID of the redundancy type conversion task.
    This command maps to the GetBucketDataRedundancyTransition API operation. For all supported global command-line options, see Command-line options.

    Examples

    Query a redundancy type conversion task

    ossutil api get-bucket-data-redundancy-transition --bucket examplebucket --redundancy-transition-taskid 123

    Query and display the result in JSON format

    Use --output-format json to return the result as JSON, which is useful for scripting and programmatic processing.

    ossutil api get-bucket-data-redundancy-transition --bucket examplebucket --redundancy-transition-taskid 123 --output-format json

    Query and display the result in YAML format

    Use --output-format yaml to return the result as YAML.

    ossutil api get-bucket-data-redundancy-transition --bucket examplebucket --redundancy-transition-taskid 123 --output-format yaml