Map a custom domain name to a bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

Mapeia um nome de domínio personalizado para um bucket.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a essa conta não possuem permissões iniciais. A conta Alibaba Cloud ou o administrador deve conceder as permissões de operação por meio de RAM policies ou Bucket Policy.

API	Action	Descrição
PutCname	oss:PutCname	Mapeia um nome de domínio personalizado para um bucket.
	yundun-cert:DescribeSSLCertificatePrivateKey	Se você anexar um certificado ao mapear um nome de domínio personalizado para um bucket, estas três permissões serão obrigatórias.
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--cname-configuration

string

O contêiner de configuração do CNAME.

A opção --cname-configuration aceita XML e JSON. Se o valor incluir o prefixo file://, o sistema lerá a configuração de um arquivo.

Sintaxe XML:

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

Sintaxe JSON:

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

Nota

O comando put-cname não usa a opção --wildcard. Em vez disso, declara o tipo de CNAME pelo elemento IsWildCard em --cname-configuration. Defina IsWildCard como true ou false: true indica um CNAME de domínio curinga (o valor de Domain é o domínio base do curinga, sem o prefixo *.); false indica um CNAME exato.
Somente Agentic Buckets aceitam CNAMEs de domínio curinga. Ao vincular um CNAME (exato ou curinga) a um Agentic Bucket, configure explicitamente o elemento IsWildCard. Não deixe esse campo vazio nem o omita. Buckets padrão não exigem esse elemento. Verifique se sua versão do ossutil oferece suporte ao elemento IsWildCard.
O comando put-cname corresponde à operação da API PutCname. Para obter mais informações sobre os parâmetros, consulte PutCname. Para saber mais sobre as opções globais de linha de comando compatíveis, veja Global command-line options.

Exemplos

Mapeie o nome de domínio personalizado example.com para examplebucket.

Use um arquivo de configuração XML. O conteúdo de cname-configuration.xml é o seguinte:

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

Comando de exemplo:

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

Use um arquivo de configuração JSON. O conteúdo de cname-configuration.json é o seguinte:

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

Comando de exemplo:

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

Use parâmetros de configuração JSON. Comando de exemplo:

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

Vincule um certificado a examplebucket.

Use um arquivo de configuração XML. O conteúdo de cname-configuration.xml é o seguinte:

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

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

Use um arquivo de configuração JSON. O conteúdo de cname-configuration.json é o seguinte:

{
    "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 exemplo:

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

Mapeie um CNAME curinga para example.com, com certificado, no Agentic Bucket myab-$uid-$region-ab-apsr.

Use um arquivo de configuração XML. O conteúdo de cname-configuration.xml é o seguinte:

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

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

Use parâmetros de configuração JSON. Comando de exemplo:

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