addPortForwardingRules
    • PDF

    addPortForwardingRules

    • PDF

    Article Summary

    概要

    ポートフォワーディングルール(Port Forwarding Rule)を追加します。保有しているサーバにポートフォワーディングルールを追加して設定したグローバルIPとポート(Port)にアクセスできます。

    リクエスト

    リクエストパラメータ

    パラメータ名必須タイプ制約事項説明
    portForwardingConfigurationNoYesStringポートフォワーディング設定番号
    portForwardingConfigurationNoはgetPortForwardingRuleListアクションを通じて取得できます。
    portForwardingRuleList.N.serverInstanceNoYesList<String>ポートフォワーディングルールリスト.N.サーバインスタンス番号
    ポートフォワーディングを設定するサーバインスタンス番号
    serverInstanceNoはgetServerInstanceListアクションを通じて取得できます。
    ex) portForwardingRuleList.1.serverInstanceNo=1088217
    portForwardingRuleList.N.portForwardingExternalPortYesList<String>Min : 1, Max : 65534ポートフォワーディングルールリスト.N.ポートフォワーディング外部ポート
    ポートフォワーディングにアクセスする外部ポート
    外部ポート番号の範囲は1,024 ~ 65,534であり、サーバアクセスのための機能以外にサービスの用途では使えません。
    ex) portForwardingRuleList.1.portForwardingExternalPort=9090
    portForwardingRuleList.N.portForwardingInternalPortYesList<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リターンコードリターンメッセージ
    40026035Not found certificateName. Please check your input parameter.
    40025033Currently port forwarding setting is being created/ modifying/ deleting. Please try again a few seconds later.
    40024068{0} cannot be controlled. instanceNo = {1}
    40024069Invalid internal port has been configured. Usable internal port(LINUX type : 22, WINDOWS type : 3389)
    40024070A single external port number is used in multiple rules. External port number : {0}
    40024071Single server is existing in multiple rules. Server IP address : {0}
    40024074External internal port as well as server instance number are not designated to port forward rule.

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.