DescribeCloudPhoneNodes API による Cloud Phone ノードのフィルタリングとクエリ - ECP

Cloud Phone マトリックスの詳細情報を照会します。Cloud Phone では、マトリックス（Cloud Phone Server）は、物理サーバを表す論理的なリソース管理単位です。このサーバは、マトリックスの基盤となるコンピューティング、ストレージ、ネットワークリソースを共有する複数の独立した Cloud Phone インスタンスに分割できます。マトリックスを作成することは、Cloud Phone インスタンスを作成可能な物理サーバを取得することと同等です。作成可能なインスタンス数は、構成によって異なります。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

GET  HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
BizRegionId	string	任意	リージョン ID。列挙値: cn-shanghai : 中国 (上海) ap-southeast-1 : シンガポール eu-central-1 : ドイツ (フランクフルト) cn-hangzhou : 中国 (杭州)	cn-hangzhou
MaxResults	string	任意	ページングクエリにおける 1 ページあたりの最大エントリ数。最大値は 100 です。デフォルト値は 20 です。	20
NextToken	string	任意	次のクエリ用のトークン。クエリがすべての結果を返さない場合、NextToken は空ではありません。返された NextToken を次のクエリで使用して、処理を続行してください。	AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uONHqPtDLM2U8s****
NodeIds	array	任意	Cloud Phone マトリックスの ID。
	string	任意	Cloud Phone マトリックスの ID。	cpn-192c32356ft1ov1m****
NodeName	string	任意	Cloud Phone マトリックスの名前。	node_name
Status	string	任意	Cloud Phone マトリックスのステータス。列挙値: FAILED : 作成に失敗しました。 RUNNING : 実行中です。 DELETING : 削除中です。 NODE_READY : ノードが準備完了し、インスタンスの作成が開始されています。 DELETED : 削除済みです。 CREATING : 作成中です。	CREATING
ServerType	string	任意	Cloud Phone マトリックスの仕様。列挙値: cpm.gn6.gx1 : cpm.gn6.gx1	cpm.gx7.10xlarge
ChargeType	string	任意	課金方法。サブスクリプション課金のみがサポートされています。列挙値: PrePaid : サブスクリプション。	PrePaid
BandwidthPackageId	string	任意	帯域幅プランの ID。	cbwp-bp17psa7fhxqmm*****
NodeNameList	array	任意
	string	任意

レスポンスフィールド

フィールド	型	説明	例
	object	要求された情報。
RequestId	string	リクエスト ID。	F07A1DA1-E1EB-5CCA-8EED-12F85D32****
NodeModel	array<object>	Cloud Phone マトリックスの詳細情報。
	array<object>	Cloud Phone マトリックスの詳細情報。
Status	string	Cloud Phone マトリックスのステータス。	RUNNING
ServerType	string	Cloud Phone マトリックスの仕様。	cpm.gx7.10xlarge
ResolutionWidth	integer	解像度の幅。単位：ピクセル。	720
NodeName	string	Cloud Phone マトリックスの名前。	node_name
Memory	integer	メモリサイズ。単位：GB。	32
VSwitchId	string	vSwitch ID。	vsw-2zeekryyc1q3sm72l****
GmtModified	string	最終更新日時。	2025-02-13 02:03:14
Cpu	string	CPU コア数。	2
ResolutionHeight	integer	解像度の高さ。単位：ピクセル。	1280
NetworkId	string	ネットワーク ID。	cn-hangzhou+dir-5mwr9azebliva****
GmtExpired	string	サブスクリプション型マトリックスの有効期限。	2025-03-09 02:00:34
PhoneCount	integer	Cloud Phone マトリックス内のインスタンス数。	25
GmtCreate	string	ノードの作成日時。	2024-11-13 02:03:14
ChargeType	string	課金方法。	PrePaid
NodeId	string	Cloud Phone マトリックスの ID。	cpn-ehs0yoedq8ntm****
RegionId	string	リージョン ID。	cn-hangzhou
InstanceType	string	インスタンスタイプ。	ac.max
ShareDataVolume	integer	共有内部ストレージのサイズ。単位：GiB。	100
PhoneDataInfo	object	独立内部ストレージに関する情報。
PhoneDataId	string	独立内部ストレージの ID。	pd-dhusabisshj****
PhoneDataVolume	integer	独立内部ストレージの容量。単位：GiB。	20
NetworkInfos	array<object>	ネットワーク情報。
	object	ネットワーク情報。
VSwitchId	string	仮想プライベートクラウド (VPC) 内の vSwitch の ID。	vsw-j6cjgev6fv3ftw4f0****
NetworkId	string	ネットワーク ID。	cn-hangzhou+dir-avcuocx9805oq****
NetworkType	string	インスタンスのネットワークタイプ。	network_pro_ecd
BandwidthPackageType	string	帯域幅タイプ。	cbwp_ecd
BandwidthPackageId	string	帯域幅プランの ID。	cbwp-hn3tj409amvamz8mf****
NetworkType	string	インスタンスのネットワークタイプ。	network_pro_ecd
BandwidthPackageType	string	帯域幅タイプ。	cbwp_ecd
BandwidthPackageId	string	帯域幅プランの ID。	cbwp-7xvrl7axet2qg6yia******
BizTags	array<object>	タグ。
	object	タグ。
Key	string	タグキー。	keyname
Value	string	タグ値。	valuename
BandwidthPackageStatus	string	帯域幅プランのステータス。有効な値：0（init）、1（Normal）、2（delete）。	1
SwapSize	integer
Tags	array<object>
	object
Key	string
Value	string
TotalCount	integer	エントリの合計数。	31
NextToken	string	次のクエリを開始するために使用されるトークン。 NextToken が空の場合、それ以上結果は返されません。 NextToken に値がある場合、その値が次のクエリのトークンとなります。	AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****
MaxResults	integer	1 ページあたりに返される最大エントリ数。	20

例

成功レスポンス

JSONJSON

{
  "RequestId": "F07A1DA1-E1EB-5CCA-8EED-12F85D32****",
  "NodeModel": [
    {
      "Status": "RUNNING",
      "ServerType": "cpm.gx7.10xlarge",
      "ResolutionWidth": 720,
      "NodeName": "node_name",
      "Memory": 32,
      "VSwitchId": "vsw-2zeekryyc1q3sm72l****",
      "GmtModified": "2025-02-13 02:03:14",
      "Cpu": "2",
      "ResolutionHeight": 1280,
      "NetworkId": "cn-hangzhou+dir-5mwr9azebliva****",
      "GmtExpired": "2025-03-09 02:00:34",
      "PhoneCount": 25,
      "GmtCreate": "2024-11-13 02:03:14",
      "ChargeType": "PrePaid",
      "NodeId": "cpn-ehs0yoedq8ntm****",
      "RegionId": "cn-hangzhou",
      "InstanceType": "ac.max",
      "ShareDataVolume": 100,
      "PhoneDataInfo": {
        "PhoneDataId": "pd-dhusabisshj****",
        "PhoneDataVolume": 20
      },
      "NetworkInfos": [
        {
          "VSwitchId": "vsw-j6cjgev6fv3ftw4f0****",
          "NetworkId": "cn-hangzhou+dir-avcuocx9805oq****",
          "NetworkType": "network_pro_ecd",
          "BandwidthPackageType": "cbwp_ecd",
          "BandwidthPackageId": "cbwp-hn3tj409amvamz8mf****"
        }
      ],
      "NetworkType": "network_pro_ecd",
      "BandwidthPackageType": "cbwp_ecd",
      "BandwidthPackageId": "cbwp-7xvrl7axet2qg6yia******",
      "BizTags": [
        {
          "Key": "keyname",
          "Value": "valuename"
        }
      ],
      "BandwidthPackageStatus": "1",
      "SwapSize": 0,
      "Tags": [
        {
          "Key": "",
          "Value": ""
        }
      ]
    }
  ],
  "TotalCount": 31,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
  "MaxResults": 20
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。