Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ API Gateway/ Referencia de la API/ API de gateway dedicados (V2)/ Gestión de gateway/ Consulta de las AZ
Actualización más reciente 2025-12-22 GMT+08:00
Ver PDF
Compartir

Consulta de las AZ

Función

Esta API se utiliza para consultar las zonas de disponibilidad donde se pueden comprar gateways.

Método de invocación

Para obtener más información, véase invocación de API.

URI

GET /v2/{project_id}/apigw/available-zones

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto. Para obtener más información sobre cómo obtenerlo, véase Obtención de un ID de proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es un token.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

available_zones

Array of AvailableZone objects

Lista de zona de disponibilidad.
Tabla 4 AvailableZone

Parámetro

Tipo

Descripción

name

String

Nombre de zona de disponibilidad.

id

String

Mensaje de error.

code

String

Código de zona de disponibilidad.

port

String

Puerto de zona de disponibilidad.

local_name

LocalName object

Nombres de zona de disponibilidad.

specs

Map<String,Boolean>

Ediciones de gateway disponibles en zona de disponibilidad.
Tabla 5 LocalName

Parámetro

Tipo

Descripción

en_us

String

Nombre de zona de disponibilidad.

zh_cn

String

Nombre de zona de disponibilidad.

Código de estado: 401

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 403

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 8 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de las solicitudes

Ninguno

Ejemplo de respuestas

Código de estado: 200

Aceptar

{
  "available_zones" : [ {
    "code" : "xx-xxx-4a",
    "id" : "effdcbc7d4d64a02aa1fa26b42f56533",
    "local_name" : {
      "en_us" : "AZ1",
      "zh_cn" : "<Name_of_AZ1>"
    },
    "name" : "<Name_of_AZ1>",
    "port" : "8403",
    "specs" : {
      "BASIC" : true,
      "BASIC_IPV6" : false,
      "ENTERPRISE" : true,
      "ENTERPRISE_IPV6" : false,
      "PLATINUM" : true,
      "PLATINUM_IPV6" : false,
      "PROFESSIONAL" : true,
      "PROFESSIONAL_IPV6" : false,
      "TRIAL" : true,
      "PLATINUM_X2" : false,
      "PLATINUM_X3" : false,
      "PLATINUM_X4" : false,
      "PLATINUM_X5" : false,
      "PLATINUM_X6" : false,
      "PLATINUM_X7" : false,
      "PLATINUM_X8" : false
    }
  }, {
    "code" : "xx-xxx-4b",
    "id" : "a0865121f83b41cbafce65930a22a6e8",
    "local_name" : {
      "en_us" : "AZ2",
      "zh_cn" : "<Name_of_AZ2>"
    },
    "name" : "<Name_of_AZ2>",
    "port" : "8404",
    "specs" : {
      "BASIC" : true,
      "BASIC_IPV6" : true,
      "ENTERPRISE" : true,
      "ENTERPRISE_IPV6" : true,
      "PLATINUM" : true,
      "PLATINUM_IPV6" : false,
      "PROFESSIONAL" : true,
      "PROFESSIONAL_IPV6" : true,
      "TRIAL" : true,
      "PLATINUM_X2" : false,
      "PLATINUM_X3" : false,
      "PLATINUM_X4" : false,
      "PLATINUM_X5" : false,
      "PLATINUM_X6" : false,
      "PLATINUM_X7" : false,
      "PLATINUM_X8" : false
    }
  } ]
}

Código de estado: 401

Sin autorización

{
  "error_code" : "APIC.7102",
  "error_msg" : "Incorrect token or token resolution failed"
}

Código de estado: 403

Prohibido

{
  "error_code" : "APIC.7106",
  "error_msg" : "No permissions to request for the method"
}

Código de estado: 500

Error del servidor interno

{
  "error_code" : "APIC.9000",
  "error_msg" : "Failed to request internal service"
}

Códigos de estado

Código de estado

Descripción

200

Aceptar

401

Sin autorización

403

Prohibido

500

Error del servidor interno

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de gateway