Todos los productos
Search
Centro de documentos

:DescribeRegions

Última actualización: Sep 03, 2026

Consulta las regiones que admiten instancias de Network Load Balancer (NLB).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar 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.

ServiceCode String No nlb

El código del servicio. Establezca el valor en nlb.

AcceptLanguage String No en-US

El lenguaje natural compatible. Valores válidos:

  • zh-CN: chino
  • en-US (predeterminado): inglés
  • ja: japonés
ClientToken String No 123e4567-e89b-12d3-a456-426655440000

El token de cliente que garantiza la idempotencia de la solicitud.

Puede usar el cliente para generar el valor, pero asegúrese de que sea único entre todas las solicitudes. ClientToken solo puede contener caracteres ASCII.

Nota Si no establece este parámetro, ClientToken toma el valor de RequestId. El valor de RequestId puede ser diferente para cada solicitud de API.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

El ID de la solicitud.

Regions

Array of Region

Una lista de regiones.

LocalName

String

China (Hangzhou)

El nombre de la región.

RegionEndpoint

String

nlb.cn-hangzhou.aliyuncs.com

El endpoint del servicio de la región.

RegionId

String

cn-hangzhou

El ID de la región.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=DescribeRegions
&ServiceCode=200
&AcceptLanguage=zh-CN
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<DescribeRegionsResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <Regions>
        <LocalName>China (Hangzhou)</LocalName>
        <RegionEndpoint>nlb.cn-hangzhou.aliyuncs.com</RegionEndpoint>
        <RegionId>cn-hangzhou</RegionId>
    </Regions>
</DescribeRegionsResponse>

Formato JSON

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

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "Regions" : [ {
    "LocalName":"China (Hangzhou)",
    "RegionEndpoint" : "nlb.cn-hangzhou.aliyuncs.com",
    "RegionId" : "cn-hangzhou"
  } ]
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.