addPortForwardingRules
    • PDF

    addPortForwardingRules

    • PDF

    記事の要約

    概要

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

    リクエスト

    リクエストパラメータ

    パラメータ名必須の有無タイプ制限事項説明
    portForwardingConfigurationNoYesString- ポートフォワーディング設定番号
    portForwardingConfigurationNoは getPortForwardingRuleListアクションを通じて取得可能
    portForwardingRuleList.N.serverInstanceNoYesList<String>- ポートフォワーディングルールリスト.N.サーバインスタンス番号
    ポートフォワーディングを設定するサーバインスタンス番号
    serverInstanceNoは getServerInstanceListアクションを通じて取得可能
    例) portForwardingRuleList.1.serverInstanceNo=1088217
    portForwardingRuleList.N.portForwardingExternalPortYesList<String>最小: 1, 最大: 65534- ポートフォワーディングルールリスト.N.ポートフォワーディング外部ポート
    ポートフォワーディングで接続する外部ポート
    外部ポート番号の範囲は1,024 ~ 65,534であり、サーバ接続のための機能に加え、サービス用途に使用
    例) portForwardingRuleList.1.portForwardingExternalPort=9090
    portForwardingRuleList.N.portForwardingInternalPortYesList<String>最小: 1, 最大: 65534- ポートフォワーディングルールリスト.N.ポートフォワーディング内部ポート
    ポートフォワーディングで接続する内部ポート
    次のポートのみ入力可能 [Linux: 22 \ Windows: 3389]
    例: portForwardingRuleList.1.portForwardingInternalPort=22
    responseFormatTypeNoString- レスポンス結果の形式タイプ
    オプション: xml | json
    デフォルト: xml

    レスポンス

    レスポンスボディ

    リクエスト例

    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>坪村ゾーン</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>坪村ゾーン</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クラウドプラットフォーム 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.