getServerSpecList

Prev Next

VPC環境で利用できます。

概要

サーバースペックリストを照会します。

リクエスト

リクエストパラメータ

パラメータ名 要否 タイプ 制約事項 説明
regionCode No String - リージョンコード
サーバースペックリストを照会するリージョン(Region)を決定できる
regionCodeは、getRegionListアクションを通じて取得可能
Default: getRegionList照会結果の最初のリージョンを選択
serverImageNo No String - サーバイメージ番号
サーバイメージ番号でフィルタリングして検索可能
serverImageNoは、getServerImageListアクションを通じて取得可能
zoneCode No String - ZONEコード
サーバースペックリストを照会するゾーン(zone)を決定可能
zoneCodeは、getZoneListアクションを通じて取得可能
serverSpecCodeList.N No List<String> - サーバースペックコードリスト
サーバスペックコードでフィルタリングして検索可能
ex) serverSpecCodeList.1=m2-g2-h100
hypervisorTypeCodeList.N No List<String> - ハイパーバイザータイプコードリスト
ハイパーバイザータイプコードでフィルタリングして検索可能
Options : XEN | KVM
ex) hypervisorTypeCodeList.1=XEN&hypervisorTypeCodeList.2=KVM
responseFormatType No String - レスポンス結果のフォーマットタイプ
Options : xml | json
Default : xml

レスポンス

レスポンスデータのタイプ

  • ServerSpecListタイプ
ServerSpecList extends CommonResponse
private Integer totalRows;
private List<ServerSpec> serverSpecList = new ArrayList<>();
ServerSpec
private String serverSpecCode;
private CommonCode hypervisorType;
private CommonCode cpuArchitectureType;
private String generationCode;
private Integer cpuCount;
private Long memorySize;
private Integer blockStorageMaxCount;
private Long blockStorageMaxIops;
private Long blockStorageMaxThroughput;
private Long networkPerformance;
private Integer networkInterfaceMaxCount;
private Integer gpuCount;
private String serverSpecDescription;
private String serverProductCode;

リクエスト例

ncloud vserver getServerSpecList --regionCode KR --serverImageNo ***5847 --serverSpecCodeList c2-g3 --hypervisorTypeCodeList KVM

レスポンス例

<getServerSpecListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <serverSpecList>
    <serverSpec>
      <serverSpecCode>c2-g3</serverSpecCode>
      <hypervisorType>
        <code>KVM</code>
        <codeName>KVM</codeName>
      </hypervisorType>
      <cpuArchitectureType>
        <code>X86_64</code>
        <codeName>x86 64bit</codeName>
      </cpuArchitectureType>
      <generationCode>G3</generationCode>
      <cpuCount>2</cpuCount>
      <memorySize>4294967296</memorySize>
      <blockStorageMaxCount>20</blockStorageMaxCount>
      <blockStorageMaxIops>5250</blockStorageMaxIops>
      <blockStorageMaxThroughput>81</blockStorageMaxThroughput>
      <networkPerformance>17179869184</networkPerformance>
      <networkInterfaceMaxCount>3</networkInterfaceMaxCount>
      <serverSpecDescription>vCPU 2EA, Memory 4GB</serverSpecDescription>
      <productCode>SVR.VSVR.HICPU.C002.M004.G003</productCode>
    </serverSpec>
  </serverSpecList>
</getServerSpecListResponse>