Actualización de información de subred

Función

Esta API se utiliza para actualizar información sobre una subred.

URI

PUT /v1/{project_id}/vpcs/{vpc_id}/subnets/{subnet_id}

Mensaje de solicitud

• Parámetro de solicitud

  Tabla 2 Parámetro de solicitud

  Nombre	Obligatorio	Tipo	Descripción
  subnet	Sí	subnet object	Especifica los objetos de subnet.

  Tabla 3 Objetos de subnet

  Nombre	Obligatorio	Tipo	Descripción
  name	Sí	String	Especifica el nombre de la subred. El valor puede contener de 1 a 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
  description	No	String	Proporciona información adicional sobre la subred. El valor no puede contener más de 255 caracteres y no puede contener corchetes angulares (< o >).
  ipv6_enable	No	Boolean	Especifica si se puede crear una subred IPv6. El valor puede ser true (habilitado) o false (deshabilitado).
  dhcp_enable	No	Boolean	Especifica si DHCP está habilitado para la subred. El valor puede ser true (habilitado) o false (deshabilitado). Si este parámetro se deja en blanco, el sistema lo establece automáticamente en true de forma predeterminada. Si este parámetro se establece en false, los ECS recién creados no pueden obtener direcciones IP y los nombres de usuario y contraseñas no se pueden inyectar mediante Cloud-init. Tenga cuidado cuando realice esta acción.
  primary_dns	No	String	Especifica la dirección IP del servidor DNS 1 en la subred. El valor debe ser una dirección IP válida. Para obtener instrucciones acerca de cómo obtener una dirección de servidor DNS privado, vea ¿Cuáles son las direcciones de servidor DNS privado proporcionadas por el servicio DNS? Para obtener instrucciones acerca de cómo utilizar la dirección del servidor DNS, consulte la sección Consulta de servidores de nombres.
  secondary_dns	No	String	Especifica la dirección IP del servidor DNS 2 en la subred. El valor debe ser una dirección IP válida. Para obtener instrucciones acerca de cómo obtener una dirección de servidor DNS privado, vea ¿Cuáles son las direcciones de servidor DNS privado proporcionadas por el servicio DNS? Para obtener instrucciones acerca de cómo utilizar la dirección del servidor DNS, consulte la sección Consulta de servidores de nombres.
  dnsList	No	Array of strings	Especifica la lista de direcciones de servidor DNS de una subred. Este campo es obligatorio si necesita utilizar más de dos servidores DNS. Este valor de parámetro es el superconjunto de la dirección 1 del servidor DNS y la dirección 2 del servidor DNS. Para obtener instrucciones acerca de cómo obtener una dirección de servidor DNS privado, vea ¿Cuáles son las direcciones de servidor DNS privado proporcionadas por el servicio DNS? Para obtener instrucciones acerca de cómo utilizar la dirección del servidor DNS, consulte la sección Consulta de servidores de nombres.
  extra_dhcp_opts	No	Array of extra_dhcp_opt objects	Especifica la dirección del servidor NTP o el tiempo de concesión DHCP configurado para la subred. Para obtener más información, véase Tabla 4.

  Tabla 4 Objeto de extra_dhcp_opt

  Nombre	Obligatorio	Tipo	Descripción
  opt_value	No	String	Especifica la dirección del servidor NTP o el tiempo de caducidad de la concesión DHCP configurado para la subred. Restricciones: La opción ntp para opt_name indica el servidor NTP configurado para la subred. Actualmente, solo se admiten direcciones IPv4. Se puede configurar un máximo de cuatro direcciones IP, y cada dirección debe ser única. Varias direcciones IP deben separarse mediante las comas (,). La opción null para opt_name indica que no hay ningún servidor NTP configurado para la subred. El valor del parámetro no puede ser una string vacía. La opción addresstime para opt_name indica el tiempo de caducidad de la concesión DHCP. El valor puede ser -1 que indica el tiempo de concesión ilimitado o Number+h. El número varía de 1 a 30,000. Por ejemplo, el valor puede ser 5h. El valor predeterminado es 24h.
  opt_name	Sí	String	Especifica el nombre de la dirección del servidor de NTP o el nombre del tiempo de expiración de la concesión DHCP configurado para la subred. Actualmente, el valor solo se puede establecer en ntp o addresstime.

• Ejemplo de la solicitud

  PUT https://{Endpoint}/v1/{project_id}/vpcs/{vpc_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d
  
  {
      "subnet": {
          "name": "subnetqq",
          "ipv6_enable": true,
          "dhcp_enable": false,
          "primary_dns": "114.xx.xx.115",
          "secondary_dns": "114.xx.xx.116",
          "extra_dhcp_opts": [
              {
                  "opt_value": "10.100.0.33,10.100.0.34",
                  "opt_name": "ntp"
              }
          ]
      }
  }
  

Mensaje de la respuesta

• Parámetro de respuesta

  Tabla 5 Parámetro de respuesta

  Nombre	Tipo	Descripción
  subnet	subnet object	Especifica los objetos de subnet.

  Tabla 6 Objetos de subnet

  Nombre	Tipo	Descripción
  id	String	Especifica un ID de recurso en formato UUID.
  status	String	Especifica el estado de la subred. El valor puede ser ACTIVE, UNKNOWN o ERROR. ACTIVE: indica que la subred se ha asociado a una VPC. UNKNOWN: indica que la subred no se ha asociado con una VPC. ERROR indica que la subred es anormal.

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.