Todos os produtos
Search
Central de documentação

Object Storage Service:get-cname-token

Última atualização: Oct 10, 2026

Consulta um token CNAME criado.

Nota de uso

Por padrão, uma conta Alibaba Cloud tem permissões para consultar um token CNAME criado. A permissão oss:GetCnameToken é necessária para consultar um token CNAME como usuário RAM ou usando STS. Para mais informações, consulte Grant a custom policy.

Sintaxe do comando

ossutil api get-cname-token --bucket value --cname value --wildcard=value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--cname

string

O nome do CNAME mapeado.

--wildcard

bool

Especifica se deve consultar o token CNAME de um CNAME de domínio wildcard. Valores válidos: true e false.

Para um Agentic Bucket, você deve definir explicitamente este parâmetro como true ou false. Para um bucket padrão, este parâmetro é opcional e tem como padrão false (CNAME exato).

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

  • A opção --wildcard é usada para operações de CNAME de domínio wildcard. Certifique-se de que sua versão do ossutil suporte este parâmetro.

  • Para mais informações sobre as opções globais de linha de comando suportadas, consulte Global command-line options.

Exemplos

  • Consulte o token CNAME para o domínio example.com mapeado para examplebucket.

    ossutil api get-cname-token --bucket examplebucket --cname example.com
  • Consulte o token CNAME para o domínio example.com mapeado para examplebucket e exiba o resultado no formato JSON.

    ossutil api get-cname-token --bucket examplebucket --cname example.com --output-format json
  • Consulte o token CNAME para o domínio example.com mapeado para examplebucket e exiba o resultado no formato YAML.

    ossutil api get-cname-token --bucket examplebucket --cname example.com --output-format yaml
  • Consulte o token CNAME para o domínio base foo.example.com de um domínio wildcard para o Agentic Bucket myab-$uid-$region-ab-apsr.

    ossutil api get-cname-token --bucket my-uid-region-ab-apsr --cname foo.example.com --wildcard=true