本接口根据边缘实例 ID 获取实例详细信息。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | GetInstance | 公共参数。该参数表示接口名称。取值：GetInstance。 |
Version | String | 是 | 2021-04-30 | 公共参数。该参数表示接口版本。取值：2021-04-30。 |
instance_identity | String | 是 | veen2202012110000220**** | 边缘实例 ID。您可以通过 ListInstances 接口获取边缘实例 ID。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
instance | 请参见返回示例 | 边缘实例详细信息。 |
GET https://veenedge.volcengineapi.com/?Action=GetInstance&Version=2021-04-30 &instance_identity=veen2111270501017515**** &<其他公共参数>
{ "ResponseMetadata": { "RequestId": "20240708143447DA8919F96B355C38****", "Action": "ListInstances", "Version": "2021-04-30", "Service": "veenedge", "Region": "cn-north-1" }, "Result": { "instances": [ { "instance_identity": "veen210541172832123****", "instance_uuid": "5c10aae4-c961-5f21-a42b-44298f0****", "instance_name": "", "load_type": "virtual_machine", "cloud_server_identity": "cloudserver-mtcsppb9q****", "cloud_server_name": "测试LB7", "vpc_identity": "vpc-qfj78n****", "namespace": "ns-210006****", "subnet_cidr": "172.**.***.64/26", "cluster": { "cluster_name": "****cm02", "country": "CN", "region": "Northeast", "province": "LN", "city": "210200", "isp": "CMCC", "level": "2", "alias": "**移动02" }, "spec": "veEN.G1.large", "spec_display": "通用型 | 2C8G", "cpu": "2", "mem": "8", "status": "running", "creator": "ve**", "image": { "image_identity": "imagelgnzqa****", "image_name": "centos-7.2-amd64", "system_arch": "Linux", "system_type": "CentOS", "system_bit": "64位", "system_version": "7.2", "property": "PublicBaseImage", "disable_vga": false, "image_boot_mode": "BIOS", "gpu_version_info": { "driver_version": "", "cuda_version": "", "cudnn_version": "" } }, "storage": { "system_disk": { "storage_type": "CloudBlockSSD", "capacity": "40" }, "data_disk": { "storage_type": "CloudBlockSSD", "capacity": "20" }, "data_disk_list": [ { "storage_type": "CloudBlockSSD", "capacity": "20" } ] }, "network": { "internal_interface": { "ip_addr": "172.**.**.77", "mask": "26", "ip6_addr": "", "mask6": "", "ips": [ { "addr": "172.**.**.77", "mask": "26", "isp": "", "ip_version": "ipv4", "primary": true } ], "mac_addr": "0a:58:**:**:71:4d", "bandwidth_peak": "500" }, "external_interface": { "ip_addr": "120.**.**.4", "mask": "24", "ip6_addr": "", "mask6": "", "ips": [ { "addr": "120.**.**.4", "mask": "24", "isp": "CMCC", "ip_version": "ipv4" } ], "mac_addr": "0a:58:**:**:f4:04", "bandwidth_peak": "5", "bandwidth_package_id": 99** }, "external_interfaces": [ { "ip_addr": "120.**.**.4", "mask": "24", "ip6_addr": "", "mask6": "", "ips": [ { "addr": "120.**.**.4", "mask": "24", "isp": "CMCC", "ip_version": "ipv4" } ], "mac_addr": "0a:58:**:**:f4:04", "bandwidth_peak": "5", "bandwidth_package_id": 998 } ], "default_isp": "", "dns_type": "default", "dns_list": [ "114.114.114.114", "180.184.1.1" ], "bandwidth_peak_update_status": "ready", "limit_mode": "shared" }, "gpu": { "gpus": [] }, "secret": { "secret_type": 3, "secret_data": "sshkey-h4nl4gd7b****" }, "billing": { "computing_billing_method": "MonthlyPeak", "bandwidth_billing_method": "MonthlyP95" }, "account": { "account_identity": 210006**** }, "instance_desc": "", "host_name": "", "arch": "x86", "monitor_agent": { "agent_status": "stopped" }, "project": "default", "spec_feature": 0, "subnet_identity": "subnet-p76xdmvwzr****", "advanced_configuration": { "delete_protection": false }, "start_time": 1716454985, "end_time": 0, "create_time": 1716454939, "update_time": 1716454985 } ], "total_count": 1 } }
如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。