VPC環境で利用できます。
ネットワークインターフェースを作成します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
GET | POST | /vserver/v2/createNetworkInterface |
参考
ガイドは GETメソッドを基準に説明します。POSTメソッドの呼び出しテストは、NAVERクラウドプラットフォームコンソールの API Gatewayサービスの Swaggerで行えます。
リクエストヘッダ
Server APIで共通して使用されるヘッダの詳細は、Serverのリクエストヘッダをご参照ください。
リクエストクエリパラメータ
リクエストクエリパラメータの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
regionCode |
String | Optional | リージョンコード
|
vpcNo |
String | Required | VPC番号
|
subnetNo |
String | Required | Subnet番号 |
networkInterfaceName |
String | Optional | ネットワークインターフェース名
|
accessControlGroupNoList.N |
Array | Required | ACG番号リスト
|
serverInstanceNo |
String | Optional | サーバインスタンス番号
|
ip |
String | Optional | Primary IPアドレス
|
isBareMetal |
Boolean | Optional | ベアメタルサーバ用ネットワークインターフェースかどうか
|
secondaryIpList.N |
Array | Optional | Secondary IPアドレスリスト
|
secondaryIpCount |
Integer | Optional | Secondary IPアドレスの自動割り当て数
|
networkInterfaceDescription |
String | Optional | ネットワークインターフェースの説明(Byte)
|
responseFormatType |
String | Optional | レスポンスデータの形式
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://ncloud.apigw.ntruss.com/vserver/v2/createNetworkInterface
?regionCode=KR
&vpcNo=4**5
&subnetNo=3***5
&networkInterfaceName=mynic
&accessControlGroupNoList.1=1***1
&isBareMetal=false
&secondaryIpCount=0
&responseFormatType=json' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
createNetworkInterfaceResponse |
Object | - | レスポンス結果 |
createNetworkInterfaceResponse.requestId |
String | - | リクエスト ID
|
createNetworkInterfaceResponse.returnCode |
String | - | レスポンスコード |
createNetworkInterfaceResponse.returnMessage |
String | - | レスポンスメッセージ |
レスポンスステータスコード
Server APIで共通して使用されるレスポンスステータスコードの詳細は、Serverのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"createNetworkInterfaceResponse": {
"totalRows": 1,
"networkInterfaceList": [
{
"networkInterfaceNo": "70***0",
"networkInterfaceName": "mynic",
"subnetNo": "3***5",
"deleteOnTermination": false,
"isDefault": false,
"deviceName": "",
"networkInterfaceStatus": {
"code": "NOTUSED",
"codeName": "未使用中"
},
"ip": "10.0.20.6",
"macAddress": "F2:**:**:**:**:A3",
"enableFlowLog": false,
"accessControlGroupNoList": [
"1***1"
],
"networkInterfaceDescription": "",
"secondaryIpList": []
}
],
"requestId": "b201fd9f-****-****-****-7610442de046",
"returnCode": "0",
"returnMessage": "success"
}
}