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

Associe un nom de domaine personnalisé à un bucket.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des politiques RAM ou une Bucket Policy.

API	Action	Description
PutCname	oss:PutCname	Associe un nom de domaine personnalisé à un bucket.
	yundun-cert:DescribeSSLCertificatePrivateKey	Si vous associez un certificat lors de la liaison d'un nom de domaine personnalisé à un bucket, ces trois autorisations sont requises.
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

Command syntax

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

Parameter

Type

Description

--bucket

string

Nom du bucket.

--cname-configuration

string

Conteneur de configuration CNAME.

L'option --cname-configuration accepte les formats XML et JSON. Si la valeur contient le préfixe file://, la configuration est lue à partir d'un fichier.

Syntaxe XML :

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

Syntaxe JSON :

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

Remarque

La commande put-cname n'utilise pas l'option --wildcard. Elle définit le type CNAME via l'élément IsWildCard dans --cname-configuration. La valeur IsWildCard peut être true ou false : true indique un CNAME de domaine générique (la valeur Domain correspond au domaine de base du domaine générique, sans le préfixe *.), et false indique un CNAME exact.
Seuls les Agentic Buckets prennent en charge les CNAME de domaines génériques : lors de la liaison d'un CNAME (exact ou générique) à un Agentic Bucket, vous devez configurer explicitement l'élément IsWildCard. Il ne peut pas être laissé vide ni omis. Les buckets standard ne nécessitent pas cet élément. Assurez-vous que votre version d'ossutil prend en charge l'élément IsWildCard.
La commande put-cname correspond à l'opération API PutCname. Pour plus d'informations sur les paramètres, consultez PutCname. Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez Global command-line options.

Examples

1. Associez le nom de domaine personnalisé example.com au bucket examplebucket.

Utilisez un fichier de configuration XML. Le contenu de cname-configuration.xml est le suivant :

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

Exemple de commande :

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

Utilisez un fichier de configuration JSON. Le contenu de cname-configuration.json est le suivant :

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

Exemple de commande :

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

Utilisez des paramètres de configuration JSON. Exemple de commande :

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

2. Liez un certificat au bucket examplebucket.

Utilisez un fichier de configuration XML. Le contenu de cname-configuration.xml est le suivant :

<?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>

Exemple de commande :

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

Utilisez un fichier de configuration JSON. Le contenu de cname-configuration.json est le suivant :

{
    "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
        }
    }
}

Exemple de commande :

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

3. Associez un CNAME générique pour example.com avec certificat, à l'Agentic Bucket myab-$uid-$region-ab-apsr.

Utilisez un fichier de configuration XML. Le contenu de cname-configuration.xml est le suivant :

<?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>

Exemple de commande :

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

Utilisez des paramètres de configuration JSON. Exemple de commande :

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