Object Storage Service:DescribeRegions

Observações de uso

• A consulta de endpoints de região exige a permissão oss:DescribeRegions. Para mais informações, consulte Grant a custom policy.

• As requisições DescribeRegions aceitam apenas domínios de segundo nível, como oss-cn-hangzhou.aliyuncs.com.

Sintaxe da requisição

• Consulte os endpoints de todas as regiões suportadas

  GET /?regions HTTP/1.1
  Host: oss.example.com
  Date: GMT Date
  Authorization: SignatureValue

• Consulte os endpoints de uma região específica

  Nota

  Especifique a região usando o ID de região OSS em Regions and OSS endpoints in the public cloud.

  GET /?regions=oss-cn-hangzhou HTTP/1.1
  Host: oss.example.com
  Date: GMT Date
  Authorization: SignatureValue

Cabeçalhos da requisição

O DescribeRegions utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common request headers.

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

Elementos da resposta

Exemplos

• Consultar os endpoints de todas as regiões suportadas

  • Exemplo de requisição

    GET /?regions HTTP/1.1
    Host: oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 20 Aug 2021 06:38:30 GMT
    Authorization: SignatureValue

  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b*****
    Date: Fri, 20 Aug 2021 06:38:30 GMT
    Content-Type: application/xml
    Content-Length: 344606
    Server: AliyunOSS
    
    <?xml version="1.0" encoding="UTF-8"?>
    <RegionInfoList>
      <RegionInfo>
         <Region>oss-cn-hangzhou</Region>
         <InternetEndpoint>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint>
         <InternalEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint>
         <AccelerateEndpoint>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
      </RegionInfo>
      <RegionInfo>
         <Region>oss-cn-shanghai</Region>
         <InternetEndpoint>oss-cn-shanghai.aliyuncs.com</InternetEndpoint>
         <InternalEndpoint>oss-cn-shanghai-internal.aliyuncs.com</InternalEndpoint>
         <AccelerateEndpoint>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
      </RegionInfo>
    </RegionInfoList>

• Consultar os endpoints de uma região específica

  • Exemplo de requisição

    GET /?regions=oss-cn-hangzhou HTTP/1.1
    Host: oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 20 Aug 2021 06:40:30 GMT
    Authorization: SignatureValue

  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b*****
    Date: Fri, 20 Aug 2021 06:40:30 GMT
    Content-Type: application/xml
    Content-Length: 3446
    Server: AliyunOSS
    
    <?xml version="1.0" encoding="UTF-8"?>
    <RegionInfoList>
      <RegionInfo>
        <Region>oss-cn-hangzhou</Region>
        <InternetEndpoint>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint>
        <InternalEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint>
        <AccelerateEndpoint>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
      </RegionInfo>
    </RegionInfoList>

ossutil

Para obter informações sobre o comando ossutil correspondente à operação DescribeRegions, consulte describe-regions.

SDKs do OSS

Chame o DescribeRegions com os seguintes SDKs do OSS:

• Python V2

• Go V2

Códigos de erro