Actualización de un Ancho de Banda Anual/Mensual

Función

Esta API se utiliza para actualizar información sobre un ancho de banda en modo de facturación anual/mensual.

URI

PUT /v2.0/{project_id}/bandwidths/{bandwidth_id}

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. Para más detalles, consulte Tabla 4.
  extendParam	No	extendParam object	Especifica el parámetro extendido, que se utiliza para aplicar a los recursos en el modo de facturación anual/mensual. Para más detalles, consulte Tabla 5.

  Tabla 4 Descripción del campo bandwidth

  Nombre	Obligatorio	Tipo	Descripción
  name	No	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 (.). Si el valor se deja en blanco, el nombre del ancho de banda no se cambia. Debe especificarse name o size.
  size	No	Integer	Especifica el tamaño del ancho de banda. El tamaño del ancho de banda en el modo de facturación anual/mensual solo se puede cambiar a un valor mayor. El valor varía de 1 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.) Si el parámetro no está incluido, el tamaño del ancho de banda no cambia. Debe especificarse name o size. 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.

  Tabla 5 Descripción del campo extendParam

  Nombre	Obligatorio	Tipo	Descripción
  is_auto_pay	No	boolean	Especifica si un pedido se paga automáticamente desde la cuenta del cliente sin realizar operaciones manuales. Por defecto, el sistema no pagará automáticamente el pedido. Los valores posibles son los siguientes: true: Sí (El pedido se pagará automáticamente.) false: No (valor predeterminado. Debe pagar manualmente el pedido.) Restricciones: Si utiliza el modo de pago automático, solo podrá utilizar el saldo de su cuenta. Si desea utilizar un vale, no utilice el modo de pago automático y seleccione el vale para el pago en el Centro de facturación.

• Ejemplo de la solicitud

  PUT https://{Endpoint}/v2.0/{project_id}/bandwidths/{bandwidth_id}
  
  {
      "bandwidth": {
          "name": "bandwidth123",
          "size": 10
      },
      "extendParam": {
          "is_auto_pay": "false"
      }
  }

Mensaje de la respuesta

• Parámetro de respuesta

  Tabla 6 Parámetro de respuesta

  Nombre	Tipo	Descripción
  bandwidth	bandwidth object	Especifica el objeto de ancho de banda. Este objeto solo se devuelve cuando el valor del parámetro name en los campos bandwidth se actualiza en el modo de pago por uso o de facturación anual/mensual. Para más detalles, consulte Tabla 7.
  order_id	String	Especifica el ID de pedido. (modo de facturación anual/mensual)

  Tabla 7 Descripción del campo bandwidth

  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 8. 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 tráfico, ancho de banda o ancho de banda percentil 95 (mejorado). Los valores posibles pueden ser bandwidth (facturado por ancho de banda), traffic (facturado por tráfico) o 95peak_plus (facturado por ancho de banda percentil 95 mejorado). Si el valor es una string de caracteres vacía o no se especifica ningún valor, se utiliza el valor bandwidth. Solo el ancho de banda compartido admite 95peak_plus (facturado por el ancho de banda mejorado del percentil 95). Si utiliza el ancho de banda de percentil 95 mejorado, especifique el porcentaje de ancho de banda garantizado. El valor predeterminado es 20%. El ancho de banda compartido no admite la facturación por tráfico. El ancho de banda compartido anual/mensual no admite la facturación mediante un ancho de banda mejorado del percentil 95.
  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.
  enterprise_project_id	String	Especifica el ID del proyecto de empresa. El valor es 0 o una string que contiene un máximo de 36 caracteres en formato UUID con guiones (-). El valor 0 indica el proyecto de empresa predeterminado. Cuando cree un ancho de banda compartido, asocie el ID del proyecto de empresa con el ancho de banda compartido.
  status	String	Especifica el estado del ancho de banda. Valores: FREEZED (Congelado) NORMAL (Normal)
  created_at	String	Especifica la hora (UTC) en la que se crea el ancho de banda. Formato: yyyy-MM-ddTHH:mm:ss
  updated_at	String	Especifica la hora (UTC) cuando se actualiza el ancho de banda. Formato: yyyy-MM-ddTHH:mm:ss
  enable_bandwidth_rules	boolean	Especifica si se activa QoS. El valor puede ser true o false.
  rule_quota	integer	Especifica el número máximo de reglas de agrupación admitidas por el ancho de banda.
  bandwidth_rules	Array of bandwidth_rules objects	Especifica las reglas de ancho de banda.
  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 8 Objeto publicip_info

  Nombre	Tipo	Descripción
  publicip_id	String	Especifica el ID de EIP o del puerto IPv6 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: Dirección IPv4 6: Dirección IPv6
  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.

  Tabla 9 Objeto bandwidth_rules

  Nombre	Tipo	Descripción
  id	string	Especifica el ID de regla de ancho de banda.
  name	string	Especifica el nombre de la regla de ancho de banda.
  admin_state_up	boolean	Especifica el estado de configuración. El valor False indica que la configuración no tiene efecto.
  egress_size	integer	Especifica el ancho de banda de salida máximo en Mbit/s. El intervalo de valores varía de 0 a n, donde n indica el tamaño de ancho de banda compartido. Si el valor se establece en 0, se utilizará el ancho de banda máximo, es decir, el tamaño de ancho de banda compartido.
  egress_guarented_size	integer	Especifica el ancho de banda de salida garantizado en Mbit/s. El valor varía de 0 a x, donde x indica el ancho de banda restante.
  publicip_info	Array of publicip_info objects	Especifica el EIP asociado al ancho de banda. El ancho de banda, cuyo tipo se establece en WHOLE, puede ser utilizado por múltiples EIP. El ancho de banda, cuyo tipo se establece en PER, sólo puede ser utilizado por un EIP.

• Ejemplo de respuesta 1 (solo el valor del parámetro name en el campo bandwidth se actualiza en el modo de pago por uso o de facturación anual/mensual)

  {
      "bandwidth": {
          "id": "3fa5b383-5a73-4dcb-a314-c6128546d855",
          "name": "bandwidth123",
          "size": 10,
          "share_type": "PER",
          "publicip_info": [
              {
                  "publicip_id": "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0",
                  "publicip_address": "161.xx.xx.9",
                  "publicip_type": "5_bgp",
                  "ip_version": 4
              }
          ],
          "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
          "created_at": "2020-04-21T08:56:42Z",
          "updated_at": "2020-04-21T08:56:42Z", 
          "bandwidth_type": "bgp"
      }
  }

• Ejemplo de respuesta 2 (ancho de banda anual/mensual)

  {
      "order_id": "xxxx"
  }

Código de estado

Consulte Códigos de estado