Todos os produtos
Search
Central de documentação

Object Storage Service:get-cname-token

Última atualização: Sep 17, 2026

Consulta um token CNAME criado.

Observação de uso

Por padrão, a conta Alibaba Cloud tem permissão para consultar tokens CNAME criados. Usuários RAM ou chamadas via STS exigem a permissão oss:GetCnameToken para realizar essa consulta. 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

Nome do bucket.

--cname

string

Nome do CNAME mapeado.

--wildcard

string

Indica se a consulta deve retornar o token CNAME de um domínio curinga. Valores válidos: true e false.

Em Agentic Buckets, defina este parâmetro explicitamente como true ou false. Em buckets padrão, o parâmetro é opcional e assume false por padrão (CNAME exato).

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

  • A opção --wildcard aplica-se a operações com domínios curinga. Verifique se sua versão do ossutil suporta 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 do domínio example.com mapeado para examplebucket.

    ossutil api get-cname-token --bucket examplebucket --cname example.com
  • Obtenha o token CNAME do domínio example.com associado a examplebucket e exiba o resultado no formato JSON.

    ossutil api get-cname-token --bucket examplebucket --cname example.com --output-format json
  • Recupere o token CNAME referente ao domínio example.com vinculado a examplebucket e apresente a saída em formato YAML.

    ossutil api get-cname-token --bucket examplebucket --cname example.com --output-format yaml
  • Consulte o token CNAME do domínio base foo.example.com de um domínio curinga 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