associatePublicIpWithServerInstance

Prev Next

概要

グローバル IPアドレスをサーバインスタンスに割り当てます。

リクエスト

リクエストパラメータ

パラメータ名 必須の有無 タイプ 制限事項 説明
publicIpInstanceNo Yes String - 割り当て対象のグローバル IPアドレスのインスタンス番号
publicIpInstanceNoは getPublicIpInstanceListアクションを通じて取得可能
serverInstanceNo Yes String - 割り当て対象のサーバインスタンス番号
グローバル IPアドレスの割り当てが可能な serverInstanceNoは getPublicIpTargetServerInstanceListアクションを通じて取得可能
responseFormatType No String - レスポンス結果の形式タイプ
オプション: xml | json
デフォルト: xml

レスポンス

レスポンスボディ

リクエスト例

GET {SERVER_API_URL}/associatePublicIpWithServerInstance
?publicIpInstanceNo=1089236
&serverInstanceNo=1088217

レスポンス例

<associatePublicIpWithServerInstanceResponse>
  <requestId>b4b38b18-a07e-4b9b-84fb-1ffeda6638fd</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstance>
      <publicIpInstanceNo>1089236</publicIpInstanceNo>
      <publicIp>49.236.137.138</publicIp>
      <publicIpDescription></publicIpDescription>
      <createDate>2018-11-28T14:38:55+0900</createDate>
      <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>CREAT</code>
        <codeName>NET CREATE state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>USE</code>
        <codeName>NET USE OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp>
        <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>49.236.137.138</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>
        <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/>
      </serverInstanceAssociatedWithPublicIp>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>坪村ゾーン</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</associatePublicIpWithServerInstanceResponse>

エラーコード

以下のエラーコードは、このアクション(Action)で発生する特徴的なエラーです。共通して発生するエラーについての詳細説明は、NAVERクラウドプラットフォーム APIをご参照ください。

HTTP Response Code リターンコード リターンメッセージ
400 24094 The line for internet access of server does not correspond with which of Public IP.
400 24109 The input parameter instance number is invalid.
400 24120 The input parameter server instance number is invalid.
400 24122 The input parameter public IP instance number is invalid.
400 25029 You may not perform the allocate task since (other) user is changing the target official IP settings.
400 25101 The server is currently being operated. so public IP is unable to be associated with the server.
400 28100 Another public IP is already associated with the server.
400 28101 A public IP is already associated with server.