Aller au contenu
NimbusNexus

Interfaces de VM

Une interface de VM est un rattachement réseau sur une VM — le lien entre la VM et l’un de ses ports réseau. La plupart des VM se contentent de l’interface par défaut créée au lancement ; vous ne gérez les interfaces directement que lorsque vous devez attacher une VM à plusieurs réseaux (par exemple pour des services à double rattachement ou des bascules de réseau blue/green).

L’attachement d’une interface se fait à chaud — la VM ne redémarre pas. Le noyau voit immédiatement la nouvelle carte réseau ; vous devrez peut-être l’activer (ip link set <name> up) et configurer l’adressage manuellement, sauf si le cloud-init de l’image s’en charge.

Le détachement se fait aussi à chaud. Les sockets liés à l’interface détachée sont coupés ; les sockets des autres interfaces ne sont pas affectés.

Étapes suivantes

Reference

GET/api/v1/instance/{server_id}/interfaces/

List Interfaces

List network interfaces currently attached to a virtual machine instance.

Parameters

NameInTypeDescription
server_id*pathstring—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/instance/<server_id>/interfaces/" \
  -H "Authorization: Bearer $NIMBUS_KEY"
POST/api/v1/instance/{server_id}/interfaces/

Attach Interface

Attach a new network interface (port) to a virtual machine instance.

Parameters

NameInTypeDescription
server_id*pathstring—

Request body

FieldTypeDescription
port_idstring | null—
net_idstring | null—
fixed_ipstring | null—
bandwidth_subscriptionPlanType | null—

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/instance/<server_id>/interfaces/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
GET/api/v1/instance/{server_id}/interfaces/artifacts

Interface Artifacts

Return reference data needed to attach a new interface (available networks, subnets and ports for the instance).

Parameters

NameInTypeDescription
server_id*pathstring—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/instance/<server_id>/interfaces/artifacts" \
  -H "Authorization: Bearer $NIMBUS_KEY"
DELETE/api/v1/instance/{server_id}/interfaces/{port_id}

Detach Interface

Detach a network interface (port) from a virtual machine instance.

Parameters

NameInTypeDescription
server_id*pathstring—
port_id*pathstring—

Responses

  • 204Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X DELETE "https://api.nimbusnexus.net/api/v1/instance/<server_id>/interfaces/<port_id>" \
  -H "Authorization: Bearer $NIMBUS_KEY"

Need to make a real call? Try these endpoints in the live Swagger UI →