Map a custom domain name to a bucket - Object Storage Service

Özel bir alan adını bir pakete eşler.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam izinlere sahiptir. Bir Alibaba Cloud hesabına bağlı RAM kullanıcıları veya RAM rollerinin varsayılan olarak herhangi bir izni yoktur. Alibaba Cloud hesabı sahibi veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.

API	Eylem	Açıklama
PutCname	oss:PutCname	Özel bir alan adını bir pakete eşler.
	yundun-cert:DescribeSSLCertificatePrivateKey	Özel bir alan adını bir pakete eşlerken sertifika eklenmişse bu üç izin gerekir.
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

Komut sözdizimi

ossutil api put-cname --bucket value --cname-configuration value [flags]

Parametre	Tür	Açıklama
--bucket	dize	Paketin adı.
--cname-configuration	dize	CNAME yapılandırma kapsayıcısı.

--cname-configuration seçeneği hem XML hem de JSON kabul eder. Değer file:// önekini içeriyorsa yapılandırma bir dosyadan okunur.

XML sözdizimi:

<BucketCnameConfiguration>
  <Cname>
    <Domain>string</Domain>
    <IsWildCard>bool</IsWildCard>
  </Cname>
</BucketCnameConfiguration>

JSON sözdizimi:

{
  "Cname": {
    "Domain": "string",
    "IsWildCard": boolean
  }
}

Not

put-cname komutu --wildcard seçeneğini kullanmaz. Bunun yerine CNAME türünü --cname-configuration içindeki IsWildCard öğesi aracılığıyla belirtir. IsWildCard true veya false olarak ayarlanır: true, joker karakterli alan adı CNAME'sini gösterir (Domain değeri, *. öneki olmadan joker karakterli alan adının temel alan adıdır); false ise tam eşleşen CNAME'yi gösterir.
Yalnızca Agentic Paketler joker karakterli alan adı CNAME'lerini destekler. Bir CNAME'yi (tam eşleşen veya joker karakterli) bir Agentic Pakete bağlarken IsWildCard öğesini açıkça yapılandırmanız gerekir. Bu öğe boş bırakılamaz veya atlanamaz. Standart paketlerin bu öğeye ihtiyacı yoktur. ossutil sürümünüzün IsWildCard öğesini desteklediğinden emin olun.
put-cname komutu PutCname API işlemine karşılık gelir. Parametreler hakkında daha fazla bilgi için bkz. PutCname. Desteklenen genel komut satırı seçenekleri hakkında daha fazla bilgi için bkz. Genel komut satırı seçenekleri.

Örnekler

1. Özel alan adı example.com değerini examplebucket ile eşleyin.

Bir XML yapılandırma dosyası kullanın. cname-configuration.xml içeriği aşağıdaki gibidir:

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Örnek komut:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml

Bir JSON yapılandırma dosyası kullanın. cname-configuration.json içeriği aşağıdaki gibidir:

{
  "Cname": {
    "Domain": "example.com"
  }
}

Örnek komut:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.json

JSON yapılandırma parametrelerini kullanın. Örnek komut:

ossutil api put-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"

2. examplebucket için bir sertifika bağlayın.

Bir XML yapılandırma dosyası kullanın. cname-configuration.xml içeriği aşağıdaki gibidir:

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <CertId>493****-cn-hangzhou</CertId>
      <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
      <PrivateKey>-----BEGIN RSA PRIVATE KEY-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****
-----END RSA PRIVATE KEY-----</PrivateKey>
      <PreviousCertId>493****-cn-hangzhou</PreviousCertId>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

Örnek komut:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml

Bir JSON yapılandırma dosyası kullanın. cname-configuration.json içeriği aşağıdaki gibidir:

{
    "Cname": {
        "Domain": "example.com",
        "CertificateConfiguration": {
            "CertId": "493****-cn-hangzhou",
            "Certificate": "-----BEGIN CERTIFICATE-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****
-----END CERTIFICATE-----",
            "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****
-----END RSA PRIVATE KEY-----",
            "PreviousCertId": "493****-cn-hangzhou",
            "Force": true
        }
    }
}

Örnek komut:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.json

3. example.com için sertifikalı bir joker karakterli CNAME'yi Agentic Bucket myab-$uid-$region-ab-apsr ile eşleyin.

Bir XML yapılandırma dosyası kullanın. cname-configuration.xml içeriği aşağıdaki gibidir:

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <IsWildCard>true</IsWildCard>
    <CertificateConfiguration>
      <CertId>493****-cn-hangzhou</CertId>
      <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
      <PrivateKey>-----BEGIN RSA PRIVATE KEY-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****
-----END RSA PRIVATE KEY-----</PrivateKey>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

Örnek komut:

ossutil api put-cname --bucket my-uid-region-ab-apsr --cname-configuration file://cname-configuration.xml

JSON yapılandırma parametrelerini kullanın. Örnek komut:

ossutil api put-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\",\"IsWildCard\":true}}"