バケットの Transport Layer Security (TLS) バージョン管理を有効または無効にします。
使用上の注意
デフォルトでは、Alibaba Cloud アカウントには、バケットの TLS バージョン管理を有効または無効にする権限があります。 RAM ユーザーまたは Security Token Service (STS) を使用して TLS バージョン管理を有効または無効にする場合は、oss:PutBucketHttpsConfig 権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
コマンド構文
ossutil api put-bucket-https-config --bucket value --https-configuration value [flags]パラメーター | タイプ | 説明 |
--bucket | 文字列 | バケットの名前。 |
--https-configuration | 文字列 | TLS バージョン構成を格納するコンテナー。 |
put-bucket-https-config コマンドは PutBucketHttpsConfig 操作に対応します。 PutBucketHttpsConfig 操作のパラメーターの詳細については、「PutBucketHttpsConfig」をご参照ください。
--https-configuration
--https-configuration オプションは、XML と JSON の両方のフォーマットをサポートしています。 オプションの値に file:// プレフィックスが含まれている場合、ossutil は構成ファイルから構成を読み取ります。
XML フォーマット:
<HttpsConfiguration> <TLS> <Enable>boolean</Enable> <TLSVersion>string</TLSVersion> ... </TLS> </HttpsConfiguration>JSON フォーマット:
{ "TLS": { "Enable": boolean, "TLSVersion": ["string", ...] } }
サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。
例
examplebucket という名前のバケットの TLS バージョン管理を有効にし、TLS バージョンを TLS 1.2 および TLS 1.3 に設定します。
https-configuration.xml という名前の XML 構成ファイルを作成し、次のコードを構成ファイルに追加します。
<?xml version="1.0" encoding="UTF-8"?> <HttpsConfiguration> <TLS> <Enable>true</Enable> <TLSVersion>TLSv1.2</TLSVersion> <TLSVersion>TLSv1.3</TLSVersion> </TLS> </HttpsConfiguration>コマンド例:
ossutil api put-bucket-https-config --bucket examplebucket --https-configuration file://https-configuration.xmlhttps-configuration.json という名前の JSON 構成ファイルを作成し、次のコードを構成ファイルに追加します。
{ "TLS": { "Enable": "true", "TLSVersion": [ "TLSv1.2", "TLSv1.3" ] } }コマンド例:
ossutil api put-bucket-https-config --bucket examplebucket --https-configuration file://https-configuration.json次のコマンドでパラメーターを JSON フォーマットで構成します。
ossutil api put-bucket-https-config --bucket examplebucket --https-configuration "{\"TLS\":{\"Enable\":\"true\",\"TLSVersion\":[\"TLSv1.2\",\"TLSv1.3\"]}}"