put-cname - Object Storage Service - Centro de documentación de Alibaba Cloud

Asigna un nombre de dominio personalizado a un bucket.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios o roles de RAM asociados a una cuenta de Alibaba Cloud no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o el administrador de la cuenta debe otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API	Action	Descripción
PutCname	oss:PutCname	Asigna un nombre de dominio personalizado a un bucket.
	yundun-cert:DescribeSSLCertificatePrivateKey	Estos tres permisos son obligatorios cuando se asigna un nombre de dominio personalizado a un bucket y este lleva adjunto un certificado.
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

Sintaxis del comando

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

Parámetro	Tipo	Descripción
--bucket	string	El nombre del bucket.
--cname-configuration	string	El contenedor de configuración de CNAME.

La opción --cname-configuration admite formatos XML y JSON. Si el valor incluye el prefijo file://, la configuración se lee desde un archivo.

Sintaxis XML:

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

Sintaxis JSON:

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

Nota

put-cname no utiliza la opción --wildcard. En su lugar, declara el tipo de CNAME mediante el elemento IsWildCard dentro de --cname-configuration. Establezca IsWildCard en true o false: true indica un CNAME de dominio comodín (el valor de Domain es el dominio base del dominio comodín, sin el prefijo *.), mientras que false indica un CNAME exacto.
Solo los Agentic Buckets admiten CNAME de dominio comodín. Al vincular un CNAME (exacto o comodín) a un Agentic Bucket, configure explícitamente el elemento IsWildCard. No lo deje vacío ni lo omita. Los buckets estándar no requieren este elemento. Compruebe que su versión de ossutil sea compatible con el elemento IsWildCard.
El comando put-cname corresponde a la operación de API PutCname. Para obtener más información sobre los parámetros, consulte PutCname. Para conocer las opciones globales de línea de comandos compatibles, consulte Global command-line options.

Ejemplos

Asigne el nombre de dominio personalizado example.com al bucket examplebucket.

Utilice un archivo de configuración XML. El contenido de cname-configuration.xml es el siguiente:

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

Comando de ejemplo:

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

Utilice un archivo de configuración JSON. El contenido de cname-configuration.json es el siguiente:

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

Comando de ejemplo:

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

Especifique los parámetros de configuración en formato JSON. Comando de ejemplo:

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

Vincule un certificado al bucket examplebucket.

Utilice un archivo de configuración XML. El contenido de cname-configuration.xml es el siguiente:

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

Comando de ejemplo:

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

Utilice un archivo de configuración JSON. El contenido de cname-configuration.json es el siguiente:

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

Comando de ejemplo:

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

Asigne un CNAME comodín para example.com, con certificado, al Agentic Bucket myab-$uid-$region-ab-apsr.

Utilice un archivo de configuración XML. El contenido de cname-configuration.xml es el siguiente:

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

Comando de ejemplo:

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

Especifique los parámetros de configuración en formato JSON. Comando de ejemplo:

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