Todos os produtos
Search
Central de documentação

Object Storage Service:create-cname-token

Última atualização: Sep 22, 2026

Crie um token CNAME para verificar a propriedade do nome de domínio.

Nota de uso

Por padrão, uma conta Alibaba Cloud tem permissão para criar um token CNAME para verificar a propriedade do nome de domínio. A permissão oss:CreateCnameToken é obrigatória para criar um token CNAME como usuário RAM ou por meio do STS. Para obter mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

ossutil api create-cname-token --bucket value --cname-configuration value --wildcard value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket de destino.

--cname-configuration

string

O contêiner de configuração CNAME.

--wildcard

string

Especifica se a operação será executada em um CNAME de domínio curinga. Valores válidos: true e false. Para um Agentic Bucket, defina explicitamente este parâmetro como true ou false. Para um bucket padrão, este parâmetro é opcional e o valor padrão é false.

Nota
  • O comando create-cname-token corresponde à operação da API CreateCnameToken. Para obter mais informações sobre os parâmetros, consulte CreateCnameToken.

  • Use a opção --wildcard para operações de CNAME de domínio curinga. Certifique-se de que sua versão do ossutil suporta este parâmetro.

--cname-configuration

A opção --cname-configuration aceita tanto XML quanto JSON. Se o valor contiver o prefixo file://, a configuração será lida de um arquivo.

  • Sintaxe XML:

    <BucketCnameConfiguration>
      <Cname>
        <Domain>string</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • Sintaxe JSON:

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

Para obter mais informações sobre as opções globais de linha de comando com suporte, consulte Opções globais de linha de comando.

Exemplos

  1. Crie um token CNAME para verificar a propriedade do nome de domínio personalizado example.com mapeado 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>

      Exemplo de comando:

      ossutil api create-cname-token --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"
        }
      }

      Exemplo de comando:

      ossutil api create-cname-token --bucket examplebucket --cname-configuration file://cname-configuration.json
    • Use parâmetros de configuração JSON. Exemplo de comando:

      ossutil api create-cname-token --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  2. Crie um token CNAME para verificar a propriedade do domínio base example.com de um domínio curinga para o Agentic Bucket myab-$uid-$region-ab-apsr.

    Use parâmetros de configuração JSON. Exemplo de comando:

    ossutil api create-cname-token --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard true