调用DescribeEdgeMachines查询云原生一体机列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求语法

`GET /edge_machines?hostname=String&model=String&online_state=String&life_state=String&page_size=Long&page_number=Long  HTTP/1.1`

请求参数

表 1. 请求Query参数
参数名称 类型 是否必选 示例 说明
hostname String ack-v-b010-ssdfw****

云原生一体机hostname

model String ACK-V-B010

云原生一体机类型

online_state String offline/online

云原生一体机的在线状态,取值:

  • offline:离线
  • online:在线
life_state String activated/waitOnline/deleting

生命周期状态

page_size Long 10

每页显示的记录数

page_number Long 1

当前页码

响应体语法

HTTP/1.1 200
Content-Type:application/json
{
    "edge_machines": [
        {
            "edge_machine_id": "c61083909b13f4a95b8554bda9577****",
            "created": "2021-07-07T20:44:00+08:00",
            "updated": "2021-07-07T20:44:00+08:00",
            "name": "ack-v-b010-ssdfw****",
            "hostname": "ack-v-b010-ssdfw****",
            "sn": "ACK9GBL31SXX****",
            "model": "ACK-V-B010",
            "life_state": "waitOnline",
            "online_state": "offline",
            "active_time": "0001-01-01T00:00:00Z"
        }
    ],
    "page_info": {
        "page_number": 1,
        "page_size": 10,
        "total_count": 1
    }
}

响应参数

表 2. 响应Body参数
参数名称 类型 示例 说明
edge_machines Array of edge_machines

云原生一体机列表信息

edge_machine_id String c61083909b13f4a95b8554bda9577****

设备ID

created String 2021-07-07T20:44:00+08:00

创建时间

updated String 2021-07-07T20:44:00+08:00

更新时间

name String ack-v-b010-ssdfw****

机器名称

hostname String ack-v-b010-ssdfw****

云原生一体机hostname

sn String ACK9GBL31SXX****

SN序列号

model String ACK-V-B010

云原生一体机型号

life_state String activated

生命周期

online_state String online

在线状态

active_time String 2021-07-19T16:07:48+08:00

激活时间

page_info Object

分页信息

page_number Integer 1

页码。

默认值:1。

page_size Integer 10

每页显示的记录数。

默认值:10。

total_count Integer 1

总数

请求示例

根据以下示例查询云原生一体机列表:

GET /edge_machines?hostname=ack-v-b010-ssdfw****&model=ACK-V-B010&online_state=offline/online&life_state=activated/waitOnline/deleting&page_size=50&page_number=4 HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeEdgeMachinesResponse>
    <edge_machines>
        <edge_machine_id>c61083909b13f4a95b8554bda9577****</edge_machine_id>
        <created>2021-07-07T20:44:00+08:00</created>
        <updated>2021-07-07T20:44:00+08:00</updated>
        <name>ack-v-b010-ssdfw****</name>
        <hostname>ack-v-b010-ssdfw****</hostname>
        <sn>ACK9GBL31SXX****</sn>
        <model>ACK-V-B010</model>
        <life_state>activated</life_state>
        <online_state>online</online_state>
        <active_time>2021-07-19T16:07:48+08:00</active_time>
    </edge_machines>
    <page_info>
        <page_number>1</page_number>
        <page_size>50</page_size>
        <total_count>1</total_count>
    </page_info>
</DescribeEdgeMachinesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "edge_machines" : [ {
    "edge_machine_id" : "c61083909b13f4a95b8554bda9577****",
    "created" : "2021-07-07T20:44:00+08:00",
    "updated" : "2021-07-07T20:44:00+08:00",
    "name" : "ack-v-b010-ssdfw****",
    "hostname" : "ack-v-b010-ssdfw****",
    "sn" : "ACK9GBL31SXX****",
    "model" : "ACK-V-B010",
    "life_state" : "activated",
    "online_state" : "online",
    "active_time" : "2021-07-19T16:07:48+08:00"
  } ],
  "page_info" : {
    "page_number" : 1,
    "page_size" : 50,
    "total_count" : 1
  }
}

错误码

访问错误中心查看更多错误码。

开发者资源

  • SDK

    阿里云为您提供多种语言的SDK,帮助您快速通过API集成阿里云的产品和服务,推荐您使用SDK调用API,已免除您手动签名验证。

  • OpenAPI Explorer

    快速检索,可视化调试API,在线命令行工具,同步动态生成可执行的SDK代码示例。

  • 阿里云CLI

    阿里云资产管理和配置工具,可通过命令方式同时管理多个阿里云产品和服务,简单快捷,是您上云好帮手。