DescribeRegions - - Centro de documentación de Alibaba Cloud

Consulta las regiones disponibles de Alibaba Cloud.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeRegions	La operación que desea ejecutar. Establezca el valor en DescribeRegions.
InstanceChargeType	String	No	PrePaid	El método de facturación de la instancia. Para obtener más información, consulte Billing overview. Valores válidos: PrePaid: suscripción. Si establece este parámetro en PrePaid, asegúrese de contar con saldo o créditos suficientes en su cuenta; de lo contrario, se devuelve el código de error InvalidPayMethod. PostPaid: pay-as-you-go. Valor predeterminado: PostPaid.
ResourceType	String	No	instance	El tipo de recurso. Valores válidos: instance: instancia de Elastic Compute Service (ECS). disk: disco reservedinstance: reserved instance scu: unidad de capacidad de almacenamiento (SCU) Valor predeterminado: instance.
AcceptLanguage	String	No	zh-CN	El idioma natural utilizado para filtrar las respuestas. Para obtener más información, consulte RFC 7231. Valores válidos: zh-CN: chino en-US: inglés ja: japonés Valor predeterminado: zh-CN.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
Regions	Array of Region		Detalles de las regiones.
Region
Status	String	available	Indica si los clústeres están agotados. Valores válidos: disponible soldOut
RegionEndpoint	String	ecs.aliyuncs.com	El endpoint de la región.
LocalName	String	China (Qingdao)	El nombre de la región.
RegionId	String	cn-qingdao-et2-bo1	El ID de la región.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=DescribeRegions
&RegionId=cn-qingdao
&InstanceChargeType=PrePaid
&ResourceType=Instance
&AcceptLanguage=en-US
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<DescribeRegionsResponse>
    <RequestId>38EC7366-F5A9-46B1-BDB1-0FDC2E296397</RequestId>
    <Regions>
        <Region>
            <RegionId>cn-qingdao-et2-b01</RegionId>
            <RegionEndpoint>ecs.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Qingdao)</LocalName>
        </Region>
        <Region>
            <RegionId>cn-qingdao-nebula</RegionId>
            <RegionEndpoint>ecs.cn-qingdao-nebula.aliyuncs.com</RegionEndpoint>
            <LocalName>cn-qingdao-nebula</LocalName>
        </Region>
    </Regions>
</DescribeRegionsResponse>

Formato JSON

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

{
  "RequestId" : "38EC7366-F5A9-46B1-BDB1-0FDC2E296397",
  "Regions" : {
    "Region" : [ {
      "RegionId" : "cn-qingdao-et2-b01",
      "RegionEndpoint" : "ecs.aliyuncs.com",
      "LocalName" : "China (Qingdao)"
    }, {
      "RegionId" : "cn-qingdao-nebula",
      "RegionEndpoint" : "ecs.cn-qingdao-nebula.aliyuncs.com",
      "LocalName" : "cn-qingdao-nebula"
    } ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
403	Unauthorized.EmptyRegion	The specified account has no access authority to any region.	No tiene permisos para acceder a las regiones. Solicite los permisos obligatorios e inténtelo de nuevo.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	El idioma seleccionado no es compatible. Solo se admiten chino, inglés y japonés.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	No se encuentra el tipo de recurso especificado.

Para consultar la lista de códigos de error, visite Códigos de error del servicio.