すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:put-bucket-https-config

最終更新日:Nov 09, 2025

バケットの 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.xml
  • https-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\"]}}"