Todos os produtos
Search
Central de documentação

:DescribeZones

Última atualização: Jun 27, 2026

Consulta todas as zonas de uma região e os tipos de sistema de arquivos compatíveis em cada zona.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDescribeZones

A operação a ser executada.

Defina o valor como DescribeZones.

RegionIdStringSimcn-hangzhou

O ID da região onde as zonas serão consultadas.

Chame a operação DescribeRegions para obter a lista mais recente de regiões.

FileSystemTypeStringNãostandard

O tipo do sistema de arquivos.

Valores válidos:

  • standard (valor padrão): sistema de arquivos NAS de uso geral
  • extreme: sistema de arquivos NAS Extreme
  • cpfs: sistema de arquivos Cloud Parallel File Storage (CPFS)
Nota Os sistemas de arquivos CPFS estão disponíveis apenas no site da China (aliyun.com).

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdStringA70BEE5D-76D3-49FB-B58F-1F398211****

O ID da solicitação.

ZonesArray of Zone

Detalhes das zonas.

Zone
PerformanceArray of Stringnfs

Parâmetro reservado. Ignore-o.

CapacityArray of Stringnfs

Parâmetro reservado. Ignore-o.

ZoneIdStringcn-hangzhou-b

O ID da zona.

InstanceTypesArray of InstanceType

Detalhes dos tipos de sistema de arquivos.

InstanceType
StorageTypeStringCapacity

O tipo de armazenamento.

  • Se FileSystemType for standard, o tipo de armazenamento será Performance ou Capacity.
  • Se FileSystemType for extreme, o tipo de armazenamento será standard ou advance.
  • Se FileSystemType for cpfs, o tipo de armazenamento será advance_100 (linha de base de 100 MB/s/TiB) ou advance_200 (linha de base de 200 MB/s/TiB).
Nota Os sistemas de arquivos CPFS estão disponíveis apenas no site da China (aliyun.com).
ProtocolTypeStringnfs

O tipo de protocolo.

  • Se FileSystemType for standard, o tipo de protocolo será nfs ou smb.
  • Se FileSystemType for extreme, o tipo de protocolo será nfs.
  • Se FileSystemType for cpfs, o tipo de protocolo será cpfs.
Nota Os sistemas de arquivos CPFS estão disponíveis apenas no site da China (aliyun.com).

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeZones
&RegionId=cn-hangzhou
&FileSystemType=standard
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeZonesResponse>
    <RequestId>A70BEE5D-76D3-49FB-B58F-1F398211****</RequestId>
    <Zones>
        <Performance>nfs</Performance>
        <Capacity>nfs</Capacity>
        <ZoneId>cn-hangzhou-b</ZoneId>
        <InstanceTypes>
            <StorageType>Capacity</StorageType>
            <ProtocolType>nfs</ProtocolType>
        </InstanceTypes>
    </Zones>
</DescribeZonesResponse>
HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A70BEE5D-76D3-49FB-B58F-1F398211****",
  "Zones" : [ {
    "Performance" : [ "nfs" ],
    "Capacity" : [ "nfs" ],
    "ZoneId" : "cn-hangzhou-b",
    "InstanceTypes" : [ {
      "StorageType" : "Capacity",
      "ProtocolType" : "nfs"
    } ]
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

404

InvalidRegionId.NotFound

The specified Region is not found.

A região solicitada não existe ou o serviço de consulta está indisponível nesta região.

500

InternalError

The request processing has failed due to some unknown error.

A solicitação falhou devido a um erro desconhecido. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.