addPortForwardingRules
- 印刷する
- PDF
addPortForwardingRules
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
概要
ポートフォワーディングルール(Port Forwarding Rule)を追加します。保有しているサーバにポートフォワーディングルールを追加して設定したグローバルIPとポート(Port)にアクセスできます。
リクエスト
リクエストパラメータ
パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
---|---|---|---|---|
portForwardingConfigurationNo | Yes | String | ポートフォワーディング設定番号 portForwardingConfigurationNoはgetPortForwardingRuleListアクションを通じて取得できます。 | |
portForwardingRuleList.N.serverInstanceNo | Yes | List<String> | ポートフォワーディングルールリスト.N.サーバインスタンス番号 ポートフォワーディングを設定するサーバインスタンス番号 serverInstanceNoはgetServerInstanceListアクションを通じて取得できます。 ex) portForwardingRuleList.1.serverInstanceNo=1088217 | |
portForwardingRuleList.N.portForwardingExternalPort | Yes | List<String> | Min : 1, Max : 65534 | ポートフォワーディングルールリスト.N.ポートフォワーディング外部ポート ポートフォワーディングにアクセスする外部ポート 外部ポート番号の範囲は1,024 ~ 65,534であり、サーバアクセスのための機能以外にサービスの用途では使えません。 ex) portForwardingRuleList.1.portForwardingExternalPort=9090 |
portForwardingRuleList.N.portForwardingInternalPort | Yes | List<String> | Min : 1, Max : 65534 | ポートフォワーディングルールリスト.N.ポートフォワーディング内部ポート ポートフォワーディングにアクセスする内部ポート 以下のポートのみ入力できます。 [リナックス : 22 \ ウィンドウズ : 3389] ex) portForwardingRuleList.1.portForwardingInternalPort=22 |
レスポンス
レスポンスボディ
例示
リクエスト例示
GET {SERVER_API_URL}/addPortForwardingRules
?portForwardingConfigurationNo=31260
&portForwardingRuleList.1.serverInstanceNo=1088217
&portForwardingRuleList.1.portForwardingExternalPort=9090
&portForwardingRuleList.1.portForwardingInternalPort=22
レスポンス例示
<addPortForwardingRulesResponse>
<requestId>1e50cd88-32cb-422d-bf63-fefbbbb805bc</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<portForwardingRuleList>
<portForwardingRule>
<portForwardingConfigurationNo>31260</portForwardingConfigurationNo>
<portForwardingPublicIp>106.10.51.90</portForwardingPublicIp>
<zone>
<zoneNo>3</zoneNo>
<zoneName>KR-2</zoneName>
<zoneCode>KR-2</zoneCode>
<zoneDescription>평촌 zone</zoneDescription>
<regionNo>1</regionNo>
</zone>
<portForwardingExternalPort>9090</portForwardingExternalPort>
<portForwardingInternalPort>22</portForwardingInternalPort>
<serverInstance>
<serverInstanceNo>1088217</serverInstanceNo>
<serverName>s167545541a3</serverName>
<serverDescription></serverDescription>
<cpuCount>4</cpuCount>
<memorySize>8589934592</memorySize>
<baseBlockStorageSize>53687091200</baseBlockStorageSize>
<platformType>
<code>LNX32</code>
<codeName>Linux 32 Bit</codeName>
</platformType>
<loginKeyName>juhoon-kim</loginKeyName>
<isFeeChargingMonitoring>false</isFeeChargingMonitoring>
<publicIp></publicIp>
<privateIp>10.41.83.168</privateIp>
<serverImageName>centos-6.3-32</serverImageName>
<serverInstanceStatus>
<code>RUN</code>
<codeName>Server run state</codeName>
</serverInstanceStatus>
<serverInstanceOperation>
<code>NULL</code>
<codeName>Server NULL OP</codeName>
</serverInstanceOperation>
<serverInstanceStatusName>running</serverInstanceStatusName>
<createDate>2018-11-27T17:42:13+0900</createDate>
<uptime>2018-11-27T18:35:47+0900</uptime>
<serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
<serverProductCode>SPSVRSTAND000005</serverProductCode>
<isProtectServerTermination>false</isProtectServerTermination>
<portForwardingPublicIp>106.10.51.90</portForwardingPublicIp>
<portForwardingExternalPort>9090</portForwardingExternalPort>
<portForwardingInternalPort>22</portForwardingInternalPort>
<zone>
<zoneNo>3</zoneNo>
<zoneName>KR-2</zoneName>
<zoneCode>KR-2</zoneCode>
<zoneDescription>평촌 zone</zoneDescription>
<regionNo>1</regionNo>
</zone>
<region>
<regionNo>1</regionNo>
<regionCode>KR</regionCode>
<regionName>Korea</regionName>
</region>
<baseBlockStorageDiskType>
<code>NET</code>
<codeName>Network Storage</codeName>
</baseBlockStorageDiskType>
<baseBlockStorageDiskDetailType>
<code>HDD</code>
<codeName>HDD</codeName>
</baseBlockStorageDiskDetailType>
<serverInstanceType>
<code>STAND</code>
<codeName>Standard</codeName>
</serverInstanceType>
<userData></userData>
<accessControlGroupList>
<accessControlGroup>
<accessControlGroupConfigurationNo>39995</accessControlGroupConfigurationNo>
<accessControlGroupName>ncloud-default-acg</accessControlGroupName>
<accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
<isDefault>true</isDefault>
<createDate>2018-04-09T11:12:54+0900</createDate>
</accessControlGroup>
</accessControlGroupList>
<instanceTagList/>
</serverInstance>
</portForwardingRule>
</portForwardingRuleList>
</addPortForwardingRulesResponse>
エラーコード
以下のエラーコードは、このアクション(Action)で特徴的に発生するエラーです。共通的に発生するエラーに対する詳細な説明は NAVER Cloud Platform APIをご参考ください。
HTTP Response Code | リターンコード | リターンメッセージ |
---|---|---|
400 | 26035 | Not found certificateName. Please check your input parameter. |
400 | 25033 | Currently port forwarding setting is being created/ modifying/ deleting. Please try again a few seconds later. |
400 | 24068 | {0} cannot be controlled. instanceNo = {1} |
400 | 24069 | Invalid internal port has been configured. Usable internal port(LINUX type : 22, WINDOWS type : 3389) |
400 | 24070 | A single external port number is used in multiple rules. External port number : {0} |
400 | 24071 | Single server is existing in multiple rules. Server IP address : {0} |
400 | 24074 | External internal port as well as server instance number are not designated to port forward rule. |
この記事は役に立ちましたか?