Asociación de subredes con una tabla de rutas
Función
Esta API se utiliza para asociar una subred con una tabla de ruta.
Si una subred ya se ha asociado con la tabla de ruta A, puede asociar la subred con la tabla de ruta B directamente sin desvincularla de la tabla de ruta A primero.
URI
POST /v1/{project_id}/routetables/{routetable_id}/action
Tabla 1 describe los parámetros.
Nombre |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto. |
routetable_id |
Sí |
String |
Especifica el identificador de tabla de ruta, que identifica de forma exclusiva una tabla de ruta. |
Mensaje de solicitud
- Parámetro de solicitud
Tabla 2 Parámetro de solicitud Nombre
Obligatorio
Tipo
Descripción
routetable
Sí
routetable object
Especifica la tabla de ruta. Para obtener más información, véase Tabla 3.
Tabla 3 Descripción del campo de routetable Nombre
Obligatorio
Tipo
Descripción
subnets
Sí
Array of subnet objects
- Especifica las subredes asociadas a la tabla de ruta.
- Solo las subredes de la VPC a las que pertenece la tabla de ruta pueden asociarse a la tabla de ruta.
Tabla 4 Descripción del campo de subnet Nombre
Obligatorio
Tipo
Descripción
associate
No
Array of strings
Especifica una lista de ID de las subredes que se van a asociar a la tabla de ruta.
disassociate
No
Array of strings
Especifica una lista de ID de las subredes que se van a disociar de la tabla de ruta.
- Ejemplo de la solicitud
POST https://{Endpoint}/v1/6fbe9263116a4b68818cf1edce16bc4f/routetables/3d42a0d4-a980-4613-ae76-a2cddecff054/action { "routetable": { "subnets": { "associate": [ "1a8b8c98-3976-401b-a735-8b058109268c" ] } } }
Mensaje de la respuesta
- Parámetro de respuesta
Tabla 5 Parámetro de respuesta Nombre
Tipo
Descripción
routetable
routetable object
Especifica la tabla de ruta. Para obtener más información, véase Tabla 6.
Tabla 6 Descripción del campo de routetable Parámetro
Tipo
Descripción
id
String
- Especifica el ID de tabla de ruta, que identifica de forma única la tabla de ruta.
- El valor debe estar en formato UUID estándar.
name
String
- Especifica el nombre de la tabla de ruta.
- El valor no puede contener más de 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
default
Boolean
- Especifica si la tabla de ruta es la predeterminada.
- El valor puede ser true (tabla de rutas predeterminada) o false (tabla de rutas personalizada).
routes
Array of route objects
- Especifica la lista de rutas. Para obtener más información, véase Tabla 7.
- Cada tabla de rutas puede tener un máximo de 200 rutas.
subnets
Array of subnet objects
- Especifica las subredes asociadas a la tabla de ruta. Para obtener más información, véase Tabla 8.
- Solo las subredes de la VPC a las que pertenece la tabla de ruta pueden asociarse a la tabla de ruta.
tenant_id
String
- Especifica el ID del proyecto.
vpc_id
String
- Especifica el ID de la VPC asociada a la tabla de ruta.
description
String
- Proporciona la información adicional sobre la tabla de rutas.
- El valor no puede contener más de 255 caracteres y no puede contener los corchetes angulares (< o >).
created_at
String
- Especifica la hora (UTC) en la que se crea la tabla de ruta.
- Formato: aaaa-MM-ddTHH:mm:ss
updated_at
String
- Especifica la hora (UTC) en la que se crea la tabla de ruta.
- Formato: aaaa-MM-ddTHH:mm:ss
Tabla 7 Descripción del campo route Nombre
Tipo
Descripción
type
String
- Especifica el tipo de ruta.
- Valores:
- ecs (ECS)
- eni (NIC)
- vip (Dirección IP virtual)
- nat (gateway de NAT)
- peering (interconexión de VPC)
- vpn (VPN)
- dc (conexión de Direct Connect)
- cc (conexión de Cloud Connect)
- egw: nodo del punto de conexión de VPC
destination
String
- Especifica el bloque CIDR de destino de una ruta.
- El valor debe estar en el formato CIDR válido.
nexthop
String
- Especifica el ID del salto siguiente en la ruta.
- Valores:
- Cuando type es ecs, el valor es el ID de ECS.
- Cuando type es eni, el valor es el ID de la NIC de la extensión.
- Cuando type tiene un valor vip, el valor es la dirección IP virtual.
- Cuando type es de nat, el valor es ID de gateway de NAT.
- Cuando type es peering, el valor es el ID de interconexión de VPC.
- Cuando type es vpn, el valor es el ID de VPN.
- Cuando type es dc, el valor es el ID de conexión de Direct Connect.
- Cuando type es cc, el valor es el ID de conexión de Cloud Connect.
- Cuando type se establece en egw, el valor es el ID de punto de conexión de VPC.
description
String
- Proporciona la información adicional sobre la ruta.
- El valor no puede contener más de 255 caracteres y no puede contener los corchetes angulares (< o >).
- Ejemplo de la respuesta
{ "routetable": { "id": "3d42a0d4-a980-4613-ae76-a2cddecff054", "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff", "description": "abc", "routes": [ { "type": "ecs", "destination": "10.10.10.0/24", "nexthop": "7c50463d-d36c-4417-aa85-cc11fa10f341", "description": "abc" } ], "subnets": [ { "id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f" } ], "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f", "created_at": "2022-12-15T02:56:40", "updated_at": "2022-12-15T03:05:10" } }
Código de estado
Véase Códigos de estado.
Código de error
Véase Códigos de error.