Object Storage Service:PutCname - カスタムドメイン名をバケットにマッピング

注意事項

• エージェントバケットに完全一致 CNAME またはワイルドカード CNAME をマッピングする場合、リクエスト XML に IsWildCard 要素を明示的に含め、true または false に設定する必要があります。この値は空にできません。

• エージェントバケットでは、次の要素はサポートされていません：AccessPointName、AccessPointNameForObjectProcess、PurgeConfiguration/IsPurgeCdnCache、および ClientCaConfiguration (casCertId、インライン証明書、削除操作を含む)。これらのいずれかを設定すると、OSS は 400 MalformedXML エラーを返します。標準バケットは、引き続きこれらの要素を完全にサポートします。

• バケットスペースを CNAME に直接マッピングすることはできません。バケットスペースへのパブリックネットワークアクセスは、その親のエージェントバケットにマッピングされたワイルドカード CNAME を経由します。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウント配下の RAM ユーザーおよび RAM ロールは、デフォルトでは権限がありません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを使用して、必要な権限を付与する必要があります。

リクエスト構文

POST /?cname&comp=add HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: GMT Date
Authorization: SignatureValue
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

リクエストヘッダー

この操作は、共通のリクエストヘッダーのみを使用します。詳細については、「共通 HTTP ヘッダー」をご参照ください。

リクエスト要素

レスポンスヘッダー

この操作は、共通のレスポンスヘッダーのみを返します。詳細については、「共通 HTTP ヘッダー」をご参照ください。

例

• リクエスト例

  • 標準バケットへのカスタムドメイン名のマッピング

    POST /?cname&comp=add HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 24 Sep 2015 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>

  • 標準バケットのカスタムドメイン名への証明書のバインド

    POST /?cname&comp=add HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 24 Sep 2015 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
        <CertificateConfiguration>
          <CertId>493****-cn-hangzhou</CertId>
          <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
          <PrivateKey>-----BEGIN PRIVATE KEY----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END PRIVATE KEY-----</PrivateKey>
          <PreviousCertId>493****-cn-hangzhou</PreviousCertId>
          <Force>true</Force>
        </CertificateConfiguration>
      </Cname>
    </BucketCnameConfiguration>

  • 標準バケットのカスタムドメイン名からの証明書のバインド解除

    ドメイン名でこの証明書を使用する必要がなくなった場合は、バインドを解除してください。

    POST /?cname&comp=add HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 24 Sep 2015 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
          <CertificateConfiguration>
          <DeleteCertificate>true</DeleteCertificate>
        </CertificateConfiguration>
      </Cname>
    </BucketCnameConfiguration>

  • エージェントバケットへのワイルドカード CNAME のマッピング (ワイルドカード証明書を使用)

    POST /?cname&comp=add HTTP/1.1
    Host: myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
        <IsWildCard>true</IsWildCard>
        <CertificateConfiguration>
          <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
          <PrivateKey>-----BEGIN PRIVATE KEY----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END PRIVATE KEY-----</PrivateKey>
        </CertificateConfiguration>
      </Cname>
    </BucketCnameConfiguration>

  • エージェントバケットへの完全一致 CNAME のマッピング

    POST /?cname&comp=add HTTP/1.1
    Host: myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <BucketCnameConfiguration>
      <Cname>
        <Domain>console.example.com</Domain>
        <IsWildCard>false</IsWildCard>
      </Cname>
    </BucketCnameConfiguration>

• レスポンス例

  content-length: 0
  x-oss-console-auth: success
  server: AliyunOSS
  x-oss-server-time: 980
  connection: keep-alive
  x-oss-request-id: 5C1B138A109F4E405B2D
  date: Wed, 15 Sep 2021 03:33:37 GMT

OSS SDK

次の OSS SDK が PutCname API をサポートしています：

• Java

• Python V2

• Go V2

• Node.js

• PHP V2

ossutil

PutCname API に対応する ossutil コマンドの詳細については、「put-cname」をご参照ください。

エラーコード