Retrieves the Transport Layer Security (TLS) version configuration of a bucket.
Permissions
| Principal | Required permission |
|---|---|
| Alibaba Cloud account | Permitted by default |
| RAM user | oss:GetBucketHttpsConfig |
| Security Token Service (STS) | oss:GetBucketHttpsConfig |
To grant the permission to a RAM user, see Attach a custom policy to a RAM user.
Syntax
ossutil api get-bucket-https-config --bucket <value> [flags]Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
--bucket | string | Yes | The name of the bucket. |
For global flags such as --output-format, see Global command-line options.
This command corresponds to the GetBucketHttpsConfig API operation. For the full parameter reference, see the API documentation.
Examples
Retrieve TLS configuration (default output)
ossutil api get-bucket-https-config --bucket examplebucketRetrieve TLS configuration in JSON format
ossutil api get-bucket-https-config --bucket examplebucket --output-format jsonRetrieve TLS configuration in YAML format
ossutil api get-bucket-https-config --bucket examplebucket --output-format yamlWhat's next
To update the TLS version configuration of a bucket, use put-bucket-https-config.