createNetworkInterface
- 印刷する
- PDF
createNetworkInterface
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
VPC環境で利用できます。
概要
ネットワークインターフェースを作成します。
リクエスト
リクエストパラメータ
| パラメータ名 | 要否 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| regionCode | No | String | - リージョンコード ネットワークインターフェースが作成するリージョン(Region)を決定可能 regionCodeは、getRegionListアクションを通じて取得可能 Default: getRegionList照会結果の最初のリージョンを選択 | |
| vpcNo | Yes | String | - VPC番号 ネットワークインターフェースが作成する VPC決定 vpcNoは、getVpcListアクションを通じて取得可能 | |
| subnetNo | Yes | String | - Subnet番号 ネットワークインターフェースが作成する Subnet決定 subnetNoは、 getSubnetListアクションを通じて取得可能 | |
| networkInterfaceName | No | String | Min : 3, Max : 30 小文字、数字、特殊文字の「-」のみ入力可能で、先頭文字はアルファベットにする 末尾文字はアルファベットまたは数字にする | - 作成するネットワークインターフェース名 Default: NAVERクラウドプラットフォームが自動で付与 |
| accessControlGroupNoList.N | Yes | List<String> | Min : 1, Max : 3個 | - ネットワークインターフェースに適用する ACG番号リスト 最大3個の ACGを適用可能 accessControlGroupNoは、getAccessControlGroupListアクションにより取得可能 ex) accessControlGroupNoList.1=1234&accessControlGroupNoList.2=2345 |
| serverInstanceNo | No | String | - ネットワークインターフェースを割り当てるサーバインスタンス番号 作成するネットワークインターフェースが、Private Subnetのネットワークインターフェースである場合にのみサーバに割り当て可能 serverInstanceNoは、getServerInstanceListアクションにより取得可能 | |
| ip | No | String | - IPアドレス ネットワークインターフェースに割り当てる IPアドレスを直接入力できる ネットワークインターフェースが作成する Subnetの IPアドレス範囲に含めなければならない サブネットの0~5番目、最後の IPアドレスは使用できず、Subnetの範囲で重複した IPアドレスは使用不可 Default: 条件を満たす IPアドレスが順次割り当てられる ex) 192.168.0.6 | |
| isBareMetal | No | Boolean | - ベアメタル用のネットワークインターフェースの有無 trueに設定する際、ベアメタル用ネットワークインターフェースを作成し、この場合はサーバを明示してこそ作成可能(serverInstanceNoパラメータ必須) falseに設定すると、一般ネットワークインターフェースを作成 一般のサブネットではベアメタル用のネットワークインターフェース作成不可 Default : 一般ネットワークインターフェースの作成 | |
| secondaryIpList.N | No | List<String> | Min : 0, Max : 5個 | - 補助 IPリスト 選択した Subnetの IPアドレス範囲に含まれる Private IPアドレスを補助 IPアドレスとして追加可能 secondaryIpCountの個数と合わせて最大5個の補助 IPアドレスを追加可能 選択した Subnetで既に使用中の IPアドレスは使用不可 明示的な再割り当て機能を利用するには、ネットワークインターフェース作成後、assignSecondaryIpsアクションにより可能 ex) secondaryIpList.1=192.168.0.1&secondaryIpList.2=192.168.0.2 |
| secondaryIpCount | No | Integer | Min : 0, Max : 5 | - 補助 IPアドレス自動割り当て個数 指定した個数だけ補助 IPアドレスを自動割り当てできる 選択した Subnetで使用されていない Private IPアドレスが順次割り当てられる secondaryIpListの個数と合わせて最大5つの補助 IPアドレスを追加可能 |
| networkInterfaceDescription | No | String | Min : 0, Max : 1000 Bytes | 作成するネットワークインターフェースに対する説明 |
| responseFormatType | No | String | - レスポンス結果のフォーマットタイプ Options : xml | json Default : xml |
レスポンス
レスポンスボディ
例
リクエスト例
GET {API_URL}/createNetworkInterface
?regionCode=KR
&vpcNo=***04
&subnetNo=***43
&networkInterfaceName=test-***
&accessControlGroupNoList.1=***63
&serverInstanceNo=***4299
&ip=***.***.1.7
&secondaryIpList.1=***.***.1.8
&secondaryIpCount=1
レスポンス例
<createNetworkInterfaceResponse>
<requestId>18e8b085-c6bc-4953-9ec7-9cdf43236c59</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<networkInterfaceList>
<networkInterface>
<networkInterfaceNo>***87</networkInterfaceNo>
<networkInterfaceName>test-***</networkInterfaceName>
<subnetNo>***43</subnetNo>
<deleteOnTermination>false</deleteOnTermination>
<isDefault>false</isDefault>
<deviceName>eth1</deviceName>
<networkInterfaceStatus>
<code>USED</code>
<codeName>used </codeName>
</networkInterfaceStatus>
<instanceType>
<code>VSVR</code>
<codeName>Server (VPC)</codeName>
</instanceType>
<instanceNo>***4299</instanceNo>
<ip>***.***.1.7</ip>
<macAddress>F2:20:***:***:8A:F5</macAddress>
<accessControlGroupNoList>
<accessControlGroupNo>***63</accessControlGroupNo>
</accessControlGroupNoList>
<networkInterfaceDescription></networkInterfaceDescription>
<secondaryIpList>
<secondaryIp>***.***.1.8</secondaryIp>
<secondaryIp>***.***.1.9</secondaryIp>
</secondaryIpList>
</networkInterface>
</networkInterfaceList>
</createNetworkInterfaceResponse>
この記事は役に立ちましたか?