Todos os produtos
Search
Central de documentação

Object Storage Service:describe-regions

Última atualização: Sep 22, 2026

O comando describe-regions consulta os endpoints de todas as regiões compatíveis ou de uma região específica, incluindo endpoints públicos, internos e de aceleração.

Observações de uso

  • Por padrão, uma conta Alibaba Cloud tem permissão para consultar os endpoints de todas as regiões compatíveis ou de uma região específica. Para consultar os endpoints como usuário RAM ou por meio do Security Token Service (STS), você precisa das permissões de oss:DescribeRegions. Para mais informações, consulte Grant a custom policy.

  • As solicitações iniciadas ao chamar a operação DescribeRegions podem conter apenas domínios de segundo nível, como oss-cn-hangzhou.aliyuncs.com.

Sintaxe do comando

ossutil api describe-regions [flags]

Parâmetro

Tipo

Descrição

--regions

string

ID da região da solicitação.

Nota
  • O comando describe-regions corresponde à operação DescribeRegions. Para mais informações sobre os parâmetros da operação DescribeRegions, consulte DescribeRegions.

  • Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Command-line options.

Exemplos

  • Pesquise os endpoints de todas as regiões compatíveis.

    ossutil api describe-regions
  • Pesquise o endpoint de uma região específica, como a região China (Hangzhou).

    ossutil api describe-regions --regions oss-cn-hangzhou