Todos os produtos
Search
Central de documentação

Object Storage Service:list-cname

Última atualização: Sep 18, 2026

Consulta todos os registros CNAME mapeados a um bucket.

Nota de uso

Por padrão, uma conta Alibaba Cloud tem permissão para consultar todos os registros CNAME mapeados a um bucket. Para consultar registros CNAME como usuário RAM ou por meio do STS, você precisa da permissão oss:ListCname. Para obter mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

ossutil api list-cname --bucket value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

Nota
  • Para um Agentic Bucket, o comando list-cname opera da mesma forma que em um bucket padrão. A resposta pode conter entradas CNAME de domínio curinga, identificadas pelo elemento IsWildCard.

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

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

Exemplos

  • Liste todos os registros CNAME mapeados a examplebucket.

    ossutil api list-cname --bucket examplebucket
  • Liste todos os registros CNAME mapeados a examplebucket e exiba o resultado no formato JSON.

    ossutil api list-cname --bucket examplebucket --output-format json
  • Liste todos os registros CNAME mapeados a examplebucket e exiba o resultado no formato YAML.

    ossutil api list-cname --bucket examplebucket --output-format yaml