Créer une carte d’interface réseau

1 min

POST

https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{serverId}/nics

Adds a NIC to the specified server. The combined total of NICs and attached volumes cannot exceed 24 per server.

datacenterIdstringThe unique ID of the data center.

serverIdstringThe unique ID of the server.

prettybooleanControls whether the response is pretty-printed (with indentations and new lines).

depthinteger<int32>Controls the detail depth of the response objects. GET /datacenters/[ID] - depth=0: Only direct properties are included; children (servers and other elements) are not included. - depth=1: Direct properties and children references are included. - depth=2: Direct properties and children properties are included. - depth=3: Direct properties and children properties and children's children are included. - depth=... and so on

acceptstringGenerated from available response content types

X-Contract-Numberinteger<int32>Users with multiple contracts must provide the contract number, for which all API requests are to be executed.

bodyobjectThe NIC to create.

202Successful operation

defaultAny erroneous status code: 400 (parse error), 401 (auth error), 402 (trial access), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).

curl --request POST \
     --url 'https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{serverId}/nics?pretty=true&depth=integer%3Cint32%3E' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "type": {},
     "properties": {
     "dhcp": true,
     "dhcpv6": true,
     "lan": 2
     },
     "entities": {
     "flowlogs": {
     "type": {},
     "items": [
     {
     "type": {},
     "properties": {
     "name": "My resource",
     "action": "ACCEPTED",
     "direction": "INGRESS",
     "bucket": "bucketName/key"
     }
     }
     ]
     },
     "firewallrules": {
     "type": {},
     "items": [
     {
     "type": {},
     "properties": {
     "protocol": "TCP"
     }
     }
     ]
     },
     "securitygroups": {
     "type": {},
     "items": [
     {
     "type": {},
     "properties": {
     "name": "My security group"
     }
     }
     ]
     }
     }
     }'

Have a question?

Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.

To ask a question or participate in discussions, you'll need to authenticate first.