Actualización de un EIP

Función

Esta API se utiliza para convertir la versión de EIP, vincular un EIP a una NIC o desvincular un EIP de una NIC.

URI

PUT /v1/{project_id}/publicips/{publicip_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
  publicip	Sí	publicip object	Especifica el objeto EIP. Para más detalles, consulte Tabla 4.

  Tabla 4 Descripción del campo publicip

  Nombre	Obligatorio	Tipo	Descripción
  port_id	No	String	Especifica el ID de puerto. The value must be an existing port ID. If this parameter is not included or the parameter value is left blank, the EIP is unbound. If the specified port ID does not exist or has already been bound with an EIP, an error message will be displayed.
  ip_version	No	Integer	Especifica la versión de la dirección IP. El valor puede ser 4 o 6. 4: Dirección IPv4 6: Dirección IPv6 Restricciones: La versión IP debe ser compatible con el sistema. Los campos port_id y ip_version no se pueden establecer al mismo tiempo.
  alias	No	String	Especifica el nombre de EIP. El valor puede contener de 1 a 64 caracteres, incluyendo letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).

• Ejemplo de solicitud 1 (Unir un EIP a una NIC)

  PUT https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}
  
  {
      "publicip": {
          "port_id": "f588ccfa-8750-4d7c-bf5d-2ede24414706"
      }
  }

Mensaje de la respuesta

• Parámetro de respuesta

  Tabla 5 Parámetro de respuesta

  Nombre	Tipo	Descripción
  publicip	publicip object	Especifica el objeto EIP. Para más detalles, consulte Tabla 6.

  Tabla 6 Descripción del campo publicips

  Nombre	Tipo	Descripción
  id	String	Especifica el identificador único de un EIP.
  status	String	Especifica el estado de EIP. Los valores posibles son los siguientes: FREEZED (Congelado) BIND_ERROR (Error de enlace) BINDING (Encuadernación) PENDING_DELETE (Liberación) PENDING_CREATE (Asignación) PENDING_UPDATE (Actualización) NOTIFYING (Asignación) NOTIFY_DELETE (Liberación) DOWN (sin consolidar) ACTIVE (Enlazado) ELB (Unido a un balanceador de carga) VPN (enlazado a una VPN) ERROR (Excepciones)
  profile	profile object	Especifica los parámetros adicionales, incluidos el ID de pedido y el ID de producto. Para más detalles, consulte Tabla 7.
  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.
  public_ip_address	String	Especifica el EIP obtenido si sólo están disponibles los EIP IPv4.Specifies the IPv4 address corresponding to the IPv6 address if IPv6 EIPs are available.
  public_ipv6_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. El valor puede ser 4 o 6. 4: IPv4 6: IPv6
  private_ip_address	String	Especifica la dirección IP privada enlazada al EIP. Este parámetro se devuelve solo cuando un puerto está asociado con el EIP.
  port_id	String	Especifica el ID de puerto. Este parámetro se devuelve solo cuando un puerto está asociado con el EIP.
  tenant_id	String	Especifica el ID del proyecto.
  create_time	String	Especifica la hora (UTC) cuando se asigna el EIP.
  bandwidth_id	String	Especifica el ID del ancho de banda EIP.
  bandwidth_size	Integer	Especifica el ancho de banda (Mbit/s).
  bandwidth_share_type	String	Especifica el tipo de ancho de banda EIP. El valor puede ser PER o WHOLE. PER: Ancho de banda dedicado WHOLE: Ancho de banda compartido
  bandwidth_name	String	Especifica el nombre del ancho de banda.
  alias	String	Especifica el nombre de EIP.
  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 (-). Cuando asigne un EIP, asocie un ID de proyecto de empresa con el EIP. Si no se especifica este parámetro, el valor predeterminado es 0, que indica que se utiliza el proyecto de empresa predeterminado. NOTA: Para obtener más información acerca de los proyectos de empresa y cómo obtener los ID de proyecto de empresa, consulte la Guía del usuario de Enterprise Management.

  Tabla 7 Descripción del campo profile

  Nombre	Tipo	Descripción
  order_id	String	Especifica el ID de pedido.
  product_id	String	Especifica el ID del producto.
  region_id	String	Especifica el ID de la región.
  user_id	String	Especifica el ID de usuario.

• Ejemplo de respuesta (Unir un EIP a una NIC)

  {
    "publicip": {
      "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb",
      "status": "ACTIVE",
      "profile": {}, 
      "type": "5_bgp",
      "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe",
      "public_ip_address": "10.xx.xx.162",
      "private_ip_address": "192.168.1.131",
      "tenant_id": "26ae5181a416420998eb2093aaed84d9",
      "create_time": "2019-03-27 01:33:18",
      "bandwidth_size": 7,
      "ip_version": 4,
      "bandwidth_name": "bandwidth-2aef",
      "enterprise_project_id": "0",
      "bandwidth_share_type": "PER",
      "bandwidth_id": "7a258fff-10d8-44b8-8124-c59079eb8f4c"
    }
  }

Código de estado

Consulte Códigos de estado