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> Elastic IP> Referencia de la API> Las API> Ancho de banda (V2.0)> Asignación de varios anchos de banda compartidos

Actualización más reciente 2022-11-08 GMT+08:00

Ver PDF

Asignación de varios anchos de banda compartidos

Función

Esta API se utiliza para asignar varios anchos de banda compartidos a la vez.

URI

POST /v2.0/{project_id}/batch-bandwidths

Tabla 1 describes the parameters.

**Tabla 1** Descripción del parámetro
Nombre	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto.

Mensaje de solicitud

Parámetro de solicitud

**Tabla 2** Parámetro de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetro de solicitud
Nombre	Obligatorio	Tipo	Descripción
bandwidth	Sí	bandwidth object	Especifica los objetos de ancho de banda.For details, see Tabla 4.

**Tabla 4** Descripción del campo **bandwidth**
Nombre	Obligatorio	Tipo	Descripción
name	Sí	String	Especifica el nombre del ancho de banda. El valor puede contener de 1 a 64 caracteres, incluyendo letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
size	Sí	Integer	Especifica el tamaño del ancho de banda. El ancho de banda compartido tiene un límite mínimo, que puede variar dependiendo de los sitios. El valor mínimo predeterminado es 5 Mbit/s. El valor varía de 5 Mbit/s a 2000 Mbit/s de forma predeterminada. (El rango específico puede variar dependiendo de la configuración en cada región. Puede ver el rango de ancho de banda disponible en la consola de gestión.) El incremento mínimo para el ajuste de ancho de banda varía dependiendo del rango de ancho de banda. Dichos aspectos se detallan a continuación: El incremento mínimo es de 1 Mbit/s si el ancho de banda permitido oscila entre 0 Mbit/s y 300 Mbit/s (con 300 Mbit/s incluidos). El incremento mínimo es de 50 Mbit/s si el ancho de banda permitido oscila entre 300 Mbit/s y 1000 Mbit/s (con 1000 Mbit/s incluidos). El incremento mínimo es de 500 Mbit/s si el ancho de banda permitido es mayor que 1000 Mbit/s.
count	Sí	Integer	Especifica el número de anchos de banda compartidos que se pueden asignar a la vez. El valor es un entero positivo. Si se especifica una fracción decimal (por ejemplo 2.2) o una string de caracteres (por ejemplo "2"), el valor especificado se convertirá automáticamente en un entero.
public_border_group	No	String	Especifica si se encuentra en una ubicación central o en una ubicación de borde. Valores: center Edge site name Este recurso solo puede asociarse con un EIP de la misma región.

Ejemplo de la solicitud

POST https://{Endpoint}/v2.0/{project_id}/batch-bandwidths

{
    "bandwidth": {
        "name": "bandwidth123",
        "size": 10,
        "count": 2
    }
}

Mensaje de la respuesta

Parámetro de respuesta

**Tabla 5** Parámetro de respuesta
Nombre	Tipo	Descripción
bandwidths	Array of bandwidths objects	Especifica los objetos de ancho de banda. Para más detalles, consulte Tabla 6.

**Tabla 6** Descripción del campo **bandwidths**
Nombre	Tipo	Descripción
name	String	Especifica el nombre del ancho de banda. El valor puede contener de 1 a 64 caracteres, incluyendo letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
size	Integer	Especifica el tamaño del ancho de banda. El valor varía de 5 Mbit/s a 2000 Mbit/s de forma predeterminada. (El rango específico puede variar dependiendo de la configuración en cada región. Puede ver el rango de ancho de banda disponible en la consola de gestión.)
id	String	Especifica el identificador de ancho de banda, que identifica de forma exclusiva el ancho de banda.
share_type	String	Especifica si el ancho de banda es compartido o dedicado. El valor puede ser PER o WHOLE. WHOLE: Ancho de banda compartido PER: Ancho de banda dedicado
publicip_info	Array of publicip_info objects	Especifica información sobre el EIP que utiliza el ancho de banda. Para más detalles, consulte Tabla 7. El ancho de banda, cuyo tipo es WHOLE, puede ser utilizado por múltiples EIP. El ancho de banda, cuyo tipo es PER, puede ser utilizado por un solo EIP.
tenant_id	String	Especifica el ID del proyecto.
bandwidth_type	String	Especifica el tipo de ancho de banda. El valor predeterminado para el ancho de banda compartido es share. El valor puede ser share, bgp o sbgp. share: Ancho de banda compartido. bgp: BGP dinámico sbgp: BGP estático
charge_mode	String	Especifica si el ancho de banda se factura por el tráfico o por el tamaño del ancho de banda. Los valores posibles pueden ser bandwidth (facturado por ancho de banda) y traffic (facturado por tráfico). Si el valor es una string de caracteres vacía o no se especifica ningún valor, se utiliza el valor bandwidth. El ancho de banda compartido se puede facturar solo por ancho de banda.
billing_info	String	Especifica la información de la lista. Si se especifica billing_info, el ancho de banda está en modo de facturación anual/mensual.
status	String	Especifica el estado del ancho de banda. Los valores posibles son los siguientes: FREEZED (Congelado) NORMAL (Normal)
public_border_group	String	Especifica si se encuentra en una ubicación central o en una ubicación de borde. Valores: center Edge site name Este recurso solo puede asociarse con un EIP de la misma región.

**Tabla 7** Objeto **publicip_info**
Nombre	Tipo	Descripción
publicip_id	String	Especifica el ID de EIP que utiliza el ancho de banda.
publicip_address	String	Especifica el EIP obtenido si sólo están disponibles los EIP IPv4.
publicipv6_address	String	Especifica el EIP obtenido si los EIP IPv6 están disponibles. Este parámetro no existe si solo están disponibles EIP IPv4.
ip_version	Integer	Especifica la versión de la dirección IP. Los valores posibles son los siguientes: 4: IPv4 address 6: IPv6 address
publicip_type	String	Especifica el tipo de EIP. El valor puede ser 5_bgp (BGP dinámico) o 5_sbgp (BGP estático). CN South-Guangzhou: 5_bgp y 5_sbgp CN East-Shanghai1: 5_bgp y 5_sbgp CN East-Shanghai2: 5_bgp y 5_sbgp CN North-Beijing1: 5_bgp y 5_sbgp CN-Hong Kong: 5_bgp AP-Bangkok: 5_bgp AP-Singapore: 5_bgp AF-Johannesburg: 5_bgp CN Southwest-Guiyang1: 5_sbgp CN North-Beijing4: 5_bgp y 5_sbgp LA-Santiago: 5_bgp LA-Sao Paulo1: 5_bgp LA-Mexico City1: 5_bgp LA-Buenos Aires1: 5_bgp LA-Lima1: 5_bgp LA-Santiago2: 5_bgp Restricciones: El valor configurado debe ser compatible con el sistema. publicip_id es un puerto IPv4. Si no se especifica publicip_type, el valor predeterminado es 5_bgp.

Ejemplo de la respuesta

{
  "bandwidths": [
    {
      "id": "7e5a1a30-6e88-4ce5-b5fa-1d6c6864e084",
      "name": "bandwidth123",
      "size": 10,
      "share_type": "WHOLE",
      "publicip_info": [],
      "tenant_id": "26ae5181a416420998eb2093aaed84d9",
      "bandwidth_type": "share",
      "charge_mode": "bandwidth",
      "billing_info": "",
      "status": "NORMAL"
    },
    {
      "id": "ed2da50a-3ce9-4d86-9f17-e8f3801299a5",
      "name": "bandwidth123",
      "size": 10,
      "share_type": "WHOLE",
      "publicip_info": [],
      "tenant_id": "26ae5181a416420998eb2093aaed84d9",
      "bandwidth_type": "share",
      "charge_mode": "bandwidth",
      "billing_info": "",
      "status": "NORMAL"
    }
  ]
}