Todos os produtos
Search
Central de documentação

Object Storage Service:crie-cname-token

Última atualização: Sep 17, 2026

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

Observação de uso

Por padrão, uma conta Alibaba Cloud tem permissão para criar um token CNAME e verificar a propriedade do nome de domínio. Para criar esse token como usuário RAM ou via STS, é necessária a permissão oss:CreateCnameToken. Para mais informações, consulte Grant a custom policy.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket de destino.

--cname-configuration

string

Contêiner de configuração do CNAME.

--wildcard

string

Define se a operação ocorre em um CNAME de domínio curinga. Valores válidos: true e false. Em um Agentic Bucket, defina explicitamente este parâmetro como true ou false. Em buckets padrão, o parâmetro é opcional e assume false por padrão.

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

  • A opção --wildcard aplica-se a operações com CNAME de domínio curinga. Verifique se sua versão do ossutil oferece suporte a este parâmetro.

--cname-configuration

A opção --cname-configuration aceita XML e 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 mais informações sobre as opções globais de linha de comando compatíveis, consulte Global command-line options.

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>

      Comando de exemplo:

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

      Comando de exemplo:

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

      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. Comando de exemplo:

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