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"
         }
       }