Create interface
Method | URI | Description |
---|---|---|
POST | /v2/{tenant_id}/servers/{server_id}/os-interface | 仮想サーバにポートをアタッチするためのポートインターフェースを作成して使用します。 |
Normal response codes: 200
Request
下表は、インターフェース作成リクエストのURIパラメーターの一覧です。
Name | Type | Description |
---|---|---|
{tenant_id} | String | プロジェクトID |
{server_id} | UUID | 対象とする仮想サーバの仮想サーバID |
下表は、インターフェース作成リクエストのボディ部のパラメーターの一覧です。
Name | Type | Description |
---|---|---|
interfaceAttachment | object | リクエストボディでinterfaceAttachmentアクションを指定してください。 |
port_id | UUID |
インターフェースを作成するポートID 省略した場合は、portが自動的に割り当てられ、そこにインターフェースが作成されます。 ※port_idまたはnet_idのどちらか1つを指定してください。 |
net_id | UUID |
インターフェースを作成するネットワークID。 省略した場合は、インターフェースがサーバに関連付けられているネットワークに作成されます。 ※port_idまたはnet_idのどちらか1つを指定してください。 |
fixed_ips | array | 固定IPアドレス。 ネットワークIDを指定せずに任意の固定IPアドレスを指定した場合、Bad Request(400)エラーが返却されます。 |
Example. Create interface: JSON request
ポートID指定によるインターフェース作成。
{
"interfaceAttachment": {
"port_id": "ce531f90-199f-48c0-816c-13e38010b442"
}
}
ネットワークIDおよび固定IPアドレス指定によるインターフェース作成。
{
"interfaceAttachment": {
"fixed_ips": [
{
"ip_address": "192.168.1.3"
}
],
"net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6"
}
}
Response
Example. Create interface: JSON response
{
"interfaceAttachment": {
"fixed_ips": [
{
"ip_address": "192.168.1.1",
"subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef"
}
],
"mac_addr": "fa:16:3e:4c:2c:30",
"net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6",
"port_id": "ce531f90-199f-48c0-816c-13e38010b442",
"port_state": "ACTIVE"
}
}