概要
グローバルIPを、指定されたサーバに交替
説明
サーバに割り当てられたグローバルIPを他のサーバに割り当てます。
リクエストパラメータ
| パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| publicIpInstanceNo | Yes | String | 既存サーバに割り当てられたグローバルIPインスタンス番号 | |
| serverInstanceNo | Yes | String | 交替するサーバインスタンス番号 getPublicIpTargetServerInstanceListアクションを通じて取得できます。 同じzoneにあるサーバ同士のみ、グローバルIPの交替が可能です。 (KR-1サーバに割り当てられたグローバルIPをKR-2のサーバに交替することは不可能) |
|
| isErrorThrowing | No | Boolean | Default : true 既にIPが割り当てられているサーバにreplaceServerInstanceAssociatedWithPublicIpアクションを試す時に発生するエラーを発生させません。 |
レスポンスデータタイプ
- PublicIpInstanceListタイプ
| PublicIpInstanceList extends CommonResponse |
|---|
| private Integer totalRows; |
| private List |
| PublicIpInstance |
|---|
| private String publicIpInstanceNo; |
| private String publiclIp; |
| private String publicIpDescription; |
| private Date createDate; |
| private String publicIpInstanceStatusName; |
| private CommonCode publicIpInstanceStatus; |
| private CommonCode publicIpInstanceOperation; |
| private CommonCode publicIpKindType; |
| private ServerInstance serverInstanceAssociatedWithPublicIp; |
| private Region region; |
| private Zone zone; |
例示
呼び出し
ncloud server replaceServerInstanceAssociatedWithPublicIp --serverInstanceNo 691083 --publicIpInstanceNo 662308
レスポンス
{
"replaceServerInstanceAssociatedWithPublicIpResponse": {
"requestId": "82d58738-1aae-4677-982f-b194b24a683b",
"returnCode": "0",
"returnMessage": "success",
"totalRows": 1,
"publicIpInstanceList": [
{
"publicIpInstanceNo": "662308",
"publicIp": "49.236.160.36",
"publicIpDescription": "testfsdf",
"createDate": "2018-05-23T11:04:38+0900",
"publicIpInstanceStatusName": "changing",
"publicIpInstanceStatus": {
"code": "USED",
"codeName": "NET USED state"
},
"publicIpInstanceOperation": {
"code": "CHANG",
"codeName": "NET CHANGE OP"
},
"publicIpKindType": {
"code": "GEN",
"codeName": "General"
},
"serverInstanceAssociatedWithPublicIp": {
"serverInstanceNo": "691083",
"serverName": "import-key",
"serverDescription": "",
"cpuCount": 2,
"memorySize": 4294967296,
"baseBlockStorageSize": 53687091200,
"platformType": {
"code": "LNX64",
"codeName": "Linux 64 Bit"
},
"loginKeyName": "import-key",
"isFeeChargingMonitoring": false,
"publicIp": "49.236.160.36",
"privateIp": "10.39.3.136",
"serverImageName": "centos-6.6-64",
"serverInstanceStatus": {
"code": "RUN",
"codeName": "Server run state"
},
"serverInstanceOperation": {
"code": "NULL",
"codeName": "Server NULL OP"
},
"serverInstanceStatusName": "running",
"createDate": "2018-06-15T11:15:10+0900",
"uptime": "2018-06-15T11:15:10+0900",
"serverImageProductCode": "SPSW0LINUX000044",
"serverProductCode": "SPSVRSSD00000003",
"isProtectServerTermination": false,
"portForwardingPublicIp": "49.236.160.11",
"zone": {
"zoneNo": "2",
"zoneName": "KR-1",
"zoneDescription": "カサン zone",
"regionNo": "1"
},
"region": {
"regionNo": "1",
"regionCode": "KR",
"regionName": "Korea"
},
"baseBlockStorageDiskType": {
"code": "NET",
"codeName": "Network Storage"
},
"baseBlockStorageDiskDetailType": {
"code": "SSD",
"codeName": "SSD"
},
"serverInstanceType": {
"code": "STAND",
"codeName": "Standard"
},
"userData": "",
"accessControlGroupList": []
},
"zone": {
"zoneNo": "2",
"zoneName": "KR-1",
"zoneDescription": "カサン zone",
"regionNo": "1"
}
}
]
}
}
<?xml version="1.0" encoding="UTF-8" ?>
<replaceServerInstanceAssociatedWithPublicIpResponse>
<requestId>82d58738-1aae-4677-982f-b194b24a683b</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<publicIpInstanceList>
<publicIpInstanceNo>662308</publicIpInstanceNo>
<publicIp>49.236.160.36</publicIp>
<publicIpDescription>testfsdf</publicIpDescription>
<createDate>2018-05-23T11:04:38+0900</createDate>
<publicIpInstanceStatusName>changing</publicIpInstanceStatusName>
<publicIpInstanceStatus>
<code>USED</code>
<codeName>NET USED state</codeName>
</publicIpInstanceStatus>
<publicIpInstanceOperation>
<code>CHANG</code>
<codeName>NET CHANGE OP</codeName>
</publicIpInstanceOperation>
<publicIpKindType>
<code>GEN</code>
<codeName>General</codeName>
</publicIpKindType>
<serverInstanceAssociatedWithPublicIp>
<serverInstanceNo>691083</serverInstanceNo>
<serverName>import-key</serverName>
<serverDescription></serverDescription>
<cpuCount>2</cpuCount>
<memorySize>4294967296</memorySize>
<baseBlockStorageSize>53687091200</baseBlockStorageSize>
<platformType>
<code>LNX64</code>
<codeName>Linux 64 Bit</codeName>
</platformType>
<loginKeyName>import-key</loginKeyName>
<isFeeChargingMonitoring>false</isFeeChargingMonitoring>
<publicIp>49.236.160.36</publicIp>
<privateIp>10.39.3.136</privateIp>
<serverImageName>centos-6.6-64</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-06-15T11:15:10+0900</createDate>
<uptime>2018-06-15T11:15:10+0900</uptime>
<serverImageProductCode>SPSW0LINUX000044</serverImageProductCode>
<serverProductCode>SPSVRSSD00000003</serverProductCode>
<isProtectServerTermination>false</isProtectServerTermination>
<portForwardingPublicIp>49.236.160.11</portForwardingPublicIp>
<zone>
<zoneNo>2</zoneNo>
<zoneName>KR-1</zoneName>
<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>SSD</code>
<codeName>SSD</codeName>
</baseBlockStorageDiskDetailType>
<serverInstanceType>
<code>STAND</code>
<codeName>Standard</codeName>
</serverInstanceType>
<userData></userData>
<accessControlGroupList/>
</serverInstanceAssociatedWithPublicIp>
<zone>
<zoneNo>2</zoneNo>
<zoneName>KR-1</zoneName>
<zoneDescription>カサン zone</zoneDescription>
<regionNo>1</regionNo>
</zone>
</publicIpInstanceList>
</replaceServerInstanceAssociatedWithPublicIpResponse>