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 políticas do RAM ou Bucket Policy.

API	Ação	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	Nome do bucket.
--cname-configuration	string	Contêiner que armazena o registro CNAME.

Nota

O comando put-cname corresponde à operação PutCname. Para obter mais informações sobre os parâmetros dessa operação, consulte PutCname.

--cname-configuration

A opção de configuração --cname-configuration aceita os formatos XML e JSON. Se o valor contiver o prefixo file://, o ossutil lerá as configurações de um arquivo.

Formato XML:

<BucketCnameConfiguration>
  <Cname>
    <Domain>string</Domain>
  </Cname>
</BucketCnameConfiguration>

Formato json:

{
  "Cname": {
    "Domain": "string"
  }
}

Nota

Para obter mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.

Exemplos

Os exemplos a seguir mostram como mapear example.com para um bucket chamado examplebucket.

Crie um arquivo de configuração chamado cname-configuration.xml e adicione o seguinte código:

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

Crie um arquivo de configuração chamado cname-configuration.json e adicione o seguinte código:

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

Comando de exemplo:

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

Configure os parâmetros diretamente no comando usando o formato JSON:

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

Os exemplos a seguir mostram como vincular um certificado ao examplebucket.

Crie um arquivo de configuração chamado cname-configuration.xml e adicione o seguinte código:

<?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-----\nMIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****\n-----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

Crie um arquivo de configuração chamado cname-configuration.json e adicione o seguinte código:

{
    "Cname": {
        "Domain": "example.com",
        "CertificateConfiguration": {
            "CertId": "493****-cn-hangzhou",
            "Certificate": "-----BEGIN CERTIFICATE-----\nMIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****\n-----END CERTIFICATE-----",
            "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC****\n-----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