跳转到内容

资产计算机

您组织中所有计算机的硬件和软件详细信息可在计算机下跟踪

属性

computer_system (JSONObject)
包含系统特定数据
显示属性

computer_system (JSONObject)
包含系统特定数据

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

示例

Sample Content

bios_version (字符串)
计算机系统的 BIOS 版本

bios_version (字符串)
计算机系统的 BIOS 版本

示例

Sample Content

service_tag (字符串)
计算机系统的唯一服务标签

service_tag (字符串)
计算机系统的唯一服务标签

示例

Sample Content

system_manufacturer (字符串)
计算机系统制造商

system_manufacturer (字符串)
计算机系统制造商

示例

Sample Content

bios_name (字符串)
计算机系统的 BIOS 名称

bios_name (字符串)
计算机系统的 BIOS 名称

示例

Sample Content

ram_slots_count (字符串)read only
计算机系统的内存插槽数量

ram_slots_count (字符串)
计算机系统的内存插槽数量

示例

Sample Content

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

示例

Sample Content

bios_date (字符串)
计算机系统的 BIOS 日期

bios_date (字符串)
计算机系统的 BIOS 日期

示例

Sample Content

model (字符串)
计算机系统型号

model (字符串)
计算机系统型号

示例

Sample Content

operating_system (JSONObject)
包含操作系统特定数据
显示属性

operating_system (JSONObject)
包含操作系统特定数据

service_pack (字符串)
计算机上识别的服务包详细信息

service_pack (字符串)
计算机上识别的服务包详细信息

示例

Sample Content

version (字符串)
操作系统版本

version (字符串)
操作系统版本

示例

Sample Content

license_type (字符串)
操作系统的许可类型

license_type (字符串)
操作系统的许可类型

示例

Sample Content

build_number (字符串)
操作系统的构建编号

build_number (字符串)
操作系统的构建编号

示例

Sample Content

language (字符串)
操作系统的语言

language (字符串)
操作系统的语言

示例

Sample Content

os (字符串)
操作系统名称

os (字符串)
操作系统名称

示例

Sample Content

keyboard (JSONObject)
显示键盘属性
显示属性

keyboard (JSONObject)
显示键盘属性

keyboard_type (字符串)
键盘类型

keyboard_type (字符串)
键盘类型

示例

Sample Content

keyboard_serial_number (字符串)
键盘序列号

keyboard_serial_number (字符串)
键盘序列号

示例

Sample Content

keyboard_manufacturer (字符串)
键盘制造商

keyboard_manufacturer (字符串)
键盘制造商

示例

Sample Content

memory (JSONObject)
显示存储属性
显示属性

memory (JSONObject)
显示存储属性

physical_memory (长整型)
以字节显示物理内存

physical_memory (长整型)
以字节显示物理内存

示例

234759602834500

virtual_memory (长整型)
以字节显示虚拟内存

virtual_memory (长整型)
以字节显示虚拟内存

示例

234759602834500

domain (域)
计算机的域

domain (域)
计算机的域

id (长整型)
识别计算机的唯一标识符

id (长整型)
识别计算机的唯一标识符

示例

2134567890

更多属性 全部展开

monitors (工作站监视器)

表示随计算机发现的监视器

monitors (工作站监视器)
表示随计算机发现的监视器

示例

{
  "monitors": {
    "name": "test-monitors",
    "id": "234567890123456"
  }
}

is_remote_control_prompt_enabled (布尔值)

布尔值,指示计算机是否启用远程控制提示

is_remote_control_prompt_enabled (布尔值)
布尔值,指示计算机是否启用远程控制提示

comments (字符串)

计算机添加的评论

comments (字符串)
计算机添加的评论

示例

Sample Content

last_logged_user (字符串)

计算机最后登录的用户

last_logged_user (字符串)
计算机最后登录的用户

示例

Sample Content

sound_card (JSONObject)

显示声卡属性
显示属性

sound_card (JSONObject)
显示声卡属性

sound_card_name (字符串)

声卡名称

sound_card_name (字符串)
声卡名称

示例

Sample Content

添加资产计算机

此操作可帮助您添加计算机。

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers

属性

computer_system (JSONObject)
包含系统特定数据
显示属性

computer_system (JSONObject)
包含系统特定数据

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

示例

Sample Content

bios_version (字符串)
计算机系统的 BIOS 版本

bios_version (字符串)
计算机系统的 BIOS 版本

示例

Sample Content

service_tag (字符串)
计算机系统的唯一服务标签

service_tag (字符串)
计算机系统的唯一服务标签

示例

Sample Content

system_manufacturer (字符串)
计算机系统制造商

system_manufacturer (字符串)
计算机系统制造商

示例

Sample Content

bios_name (字符串)
计算机系统的 BIOS 名称

bios_name (字符串)
计算机系统的 BIOS 名称

示例

Sample Content

ram_slots_count (字符串)read only
计算机系统的内存插槽数量

ram_slots_count (字符串)
计算机系统的内存插槽数量

示例

Sample Content

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

示例

Sample Content

bios_date (字符串)
计算机系统的 BIOS 日期

bios_date (字符串)
计算机系统的 BIOS 日期

示例

Sample Content

model (字符串)
计算机系统型号

model (字符串)
计算机系统型号

示例

Sample Content

operating_system (JSONObject)
包含操作系统特定数据
显示属性

operating_system (JSONObject)
包含操作系统特定数据

service_pack (字符串)
计算机上识别的服务包详细信息

service_pack (字符串)
计算机上识别的服务包详细信息

示例

Sample Content

version (字符串)
操作系统版本

version (字符串)
操作系统版本

示例

Sample Content

license_type (字符串)
操作系统的许可类型

license_type (字符串)
操作系统的许可类型

示例

Sample Content

build_number (字符串)
操作系统的构建编号

build_number (字符串)
操作系统的构建编号

示例

Sample Content

language (字符串)
操作系统的语言

language (字符串)
操作系统的语言

示例

Sample Content

os (字符串)
操作系统名称

os (字符串)
操作系统名称

示例

Sample Content

keyboard (JSONObject)
显示键盘属性
显示属性

keyboard (JSONObject)
显示键盘属性

keyboard_type (字符串)
键盘类型

keyboard_type (字符串)
键盘类型

示例

Sample Content

keyboard_serial_number (字符串)
键盘序列号

keyboard_serial_number (字符串)
键盘序列号

示例

Sample Content

keyboard_manufacturer (字符串)
键盘制造商

keyboard_manufacturer (字符串)
键盘制造商

示例

Sample Content

memory (JSONObject)
显示存储属性
显示属性

memory (JSONObject)
显示存储属性

physical_memory (长整型)
以字节显示物理内存

physical_memory (长整型)
以字节显示物理内存

示例

234759602834500

virtual_memory (长整型)
以字节显示虚拟内存

virtual_memory (长整型)
以字节显示虚拟内存

示例

234759602834500

domain (域)
计算机的域

domain (域)
计算机的域

id (长整型)
识别计算机的唯一标识符

id (长整型)
识别计算机的唯一标识符

示例

2134567890

更多属性 全部展开

is_remote_control_prompt_enabled (布尔值)

布尔值,指示计算机是否启用远程控制提示

is_remote_control_prompt_enabled (布尔值)
布尔值,指示计算机是否启用远程控制提示

is_server (布尔值)read only

布尔值,指示此工作站是否为服务器

is_server (布尔值)
布尔值,指示此工作站是否为服务器

last_logged_user (字符串)

计算机最后登录的用户

last_logged_user (字符串)
计算机最后登录的用户

示例

Sample Content

sound_card (JSONObject)

显示声卡属性
显示属性

sound_card (JSONObject)
显示声卡属性

sound_card_name (字符串)

声卡名称

sound_card_name (字符串)
声卡名称

示例

Sample Content

$ curl <service domain|custom domain>/app/<portal>/api/v3/asset_computers\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "asset_computer": {
    "id"            : "12000000099001",
    "name"          : "WS-IND-456",
    "asset_tag"     : "AT-WS-456",
    "serial_number" : "PFRMQ08",
    "computer_system": { "system_manufacturer": "Dell Inc.", "model": "Latitude 7440", "service_tag": "JX9PMQ8" },
    "operating_system": { "os": "Windows 11 Enterprise", "version": "23H2", "build_number": "22631.4317" },
    "created_time"  : { "value": "1747312033000", "display_value": "May 15, 2026 06:30 PM" }
  }
}

编辑资产计算机

此操作可帮助您编辑计算机。

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}

属性

computer_system (JSONObject)
包含系统特定数据
显示属性

computer_system (JSONObject)
包含系统特定数据

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

示例

Sample Content

bios_version (字符串)
计算机系统的 BIOS 版本

bios_version (字符串)
计算机系统的 BIOS 版本

示例

Sample Content

service_tag (字符串)
计算机系统的唯一服务标签

service_tag (字符串)
计算机系统的唯一服务标签

示例

Sample Content

system_manufacturer (字符串)
计算机系统制造商

system_manufacturer (字符串)
计算机系统制造商

示例

Sample Content

bios_name (字符串)
计算机系统的 BIOS 名称

bios_name (字符串)
计算机系统的 BIOS 名称

示例

Sample Content

ram_slots_count (字符串)read only
计算机系统的内存插槽数量

ram_slots_count (字符串)
计算机系统的内存插槽数量

示例

Sample Content

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

示例

Sample Content

bios_date (字符串)
计算机系统的 BIOS 日期

bios_date (字符串)
计算机系统的 BIOS 日期

示例

Sample Content

model (字符串)
计算机系统型号

model (字符串)
计算机系统型号

示例

Sample Content

operating_system (JSONObject)
包含操作系统特定数据
显示属性

operating_system (JSONObject)
包含操作系统特定数据

service_pack (字符串)
计算机上识别的服务包详细信息

service_pack (字符串)
计算机上识别的服务包详细信息

示例

Sample Content

version (字符串)
操作系统版本

version (字符串)
操作系统版本

示例

Sample Content

license_type (字符串)
操作系统的许可类型

license_type (字符串)
操作系统的许可类型

示例

Sample Content

build_number (字符串)
操作系统的构建编号

build_number (字符串)
操作系统的构建编号

示例

Sample Content

language (字符串)
操作系统的语言

language (字符串)
操作系统的语言

示例

Sample Content

os (字符串)
操作系统名称

os (字符串)
操作系统名称

示例

Sample Content

keyboard (JSONObject)
显示键盘属性
显示属性

keyboard (JSONObject)
显示键盘属性

keyboard_type (字符串)
键盘类型

keyboard_type (字符串)
键盘类型

示例

Sample Content

keyboard_serial_number (字符串)
键盘序列号

keyboard_serial_number (字符串)
键盘序列号

示例

Sample Content

keyboard_manufacturer (字符串)
键盘制造商

keyboard_manufacturer (字符串)
键盘制造商

示例

Sample Content

memory (JSONObject)
显示存储属性
显示属性

memory (JSONObject)
显示存储属性

physical_memory (长整型)
以字节显示物理内存

physical_memory (长整型)
以字节显示物理内存

示例

234759602834500

virtual_memory (长整型)
以字节显示虚拟内存

virtual_memory (长整型)
以字节显示虚拟内存

示例

234759602834500

domain (域)
计算机的域

domain (域)
计算机的域

id (长整型)
识别计算机的唯一标识符

id (长整型)
识别计算机的唯一标识符

示例

2134567890

更多属性 全部展开

monitors (工作站监视器)

表示随计算机发现的监视器

monitors (工作站监视器)
表示随计算机发现的监视器

示例

{
  "monitors": {
    "name": "test-monitors",
    "id": "234567890123456"
  }
}

is_remote_control_prompt_enabled (布尔值)

布尔值,指示计算机是否启用远程控制提示

is_remote_control_prompt_enabled (布尔值)
布尔值,指示计算机是否启用远程控制提示

is_server (布尔值)read only

布尔值,指示此工作站是否为服务器

is_server (布尔值)
布尔值,指示此工作站是否为服务器

last_logged_user (字符串)

计算机最后登录的用户

last_logged_user (字符串)
计算机最后登录的用户

示例

Sample Content

sound_card (JSONObject)

显示声卡属性
显示属性

sound_card (JSONObject)
显示声卡属性

sound_card_name (字符串)

声卡名称

sound_card_name (字符串)
声卡名称

示例

Sample Content

$ curl <service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "asset_computer": {
    "id"             : "12000000099001",
    "operating_system": { "os": "Windows 11 Enterprise", "version": "23H2", "build_number": "22631.4317" },
    "computer_system": { "threads_per_core": 2, "logical_cpu_count": 16, "total_cpu_cores": 8 },
    "last_updated_time": { "value": "1747312500000", "display_value": "May 15, 2026 06:38 PM" }
  }
}

获取资产计算机

此操作可帮助您获取计算机。

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}

属性

computer_system (JSONObject)
包含系统特定数据
显示属性

computer_system (JSONObject)
包含系统特定数据

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

sm_bios_version (字符串)
计算机系统的系统管理 BIOS 版本

示例

Sample Content

bios_version (字符串)
计算机系统的 BIOS 版本

bios_version (字符串)
计算机系统的 BIOS 版本

示例

Sample Content

service_tag (字符串)
计算机系统的唯一服务标签

service_tag (字符串)
计算机系统的唯一服务标签

示例

Sample Content

system_manufacturer (字符串)
计算机系统制造商

system_manufacturer (字符串)
计算机系统制造商

示例

Sample Content

bios_name (字符串)
计算机系统的 BIOS 名称

bios_name (字符串)
计算机系统的 BIOS 名称

示例

Sample Content

ram_slots_count (字符串)read only
计算机系统的内存插槽数量

ram_slots_count (字符串)
计算机系统的内存插槽数量

示例

Sample Content

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

bios_manufacturer (字符串)
创建计算机系统 BIOS 固件的公司名称

示例

Sample Content

bios_date (字符串)
计算机系统的 BIOS 日期

bios_date (字符串)
计算机系统的 BIOS 日期

示例

Sample Content

model (字符串)
计算机系统型号

model (字符串)
计算机系统型号

示例

Sample Content

operating_system (JSONObject)
包含操作系统特定数据
显示属性

operating_system (JSONObject)
包含操作系统特定数据

service_pack (字符串)
计算机上识别的服务包详细信息

service_pack (字符串)
计算机上识别的服务包详细信息

示例

Sample Content

version (字符串)
操作系统版本

version (字符串)
操作系统版本

示例

Sample Content

license_type (字符串)
操作系统的许可类型

license_type (字符串)
操作系统的许可类型

示例

Sample Content

build_number (字符串)
操作系统的构建编号

build_number (字符串)
操作系统的构建编号

示例

Sample Content

language (字符串)
操作系统的语言

language (字符串)
操作系统的语言

示例

Sample Content

os (字符串)
操作系统名称

os (字符串)
操作系统名称

示例

Sample Content

keyboard (JSONObject)
显示键盘属性
显示属性

keyboard (JSONObject)
显示键盘属性

keyboard_type (字符串)
键盘类型

keyboard_type (字符串)
键盘类型

示例

Sample Content

keyboard_serial_number (字符串)
键盘序列号

keyboard_serial_number (字符串)
键盘序列号

示例

Sample Content

keyboard_manufacturer (字符串)
键盘制造商

keyboard_manufacturer (字符串)
键盘制造商

示例

Sample Content

memory (JSONObject)
显示存储属性
显示属性

memory (JSONObject)
显示存储属性

physical_memory (长整型)
以字节显示物理内存

physical_memory (长整型)
以字节显示物理内存

示例

234759602834500

virtual_memory (长整型)
以字节显示虚拟内存

virtual_memory (长整型)
以字节显示虚拟内存

示例

234759602834500

domain (域)
计算机的域

domain (域)
计算机的域

id (长整型)
识别计算机的唯一标识符

id (长整型)
识别计算机的唯一标识符

示例

2134567890

更多属性 全部展开

monitors (工作站监视器)

表示随计算机发现的监视器

monitors (工作站监视器)
表示随计算机发现的监视器

示例

{
  "monitors": {
    "name": "test-monitors",
    "id": "234567890123456"
  }
}

is_remote_control_prompt_enabled (布尔值)

布尔值,指示计算机是否启用远程控制提示

is_remote_control_prompt_enabled (布尔值)
布尔值,指示计算机是否启用远程控制提示

is_server (布尔值)read only

布尔值,指示此工作站是否为服务器

is_server (布尔值)
布尔值,指示此工作站是否为服务器

last_logged_user (字符串)

计算机最后登录的用户

last_logged_user (字符串)
计算机最后登录的用户

示例

Sample Content

sound_card (JSONObject)

显示声卡属性
显示属性

sound_card (JSONObject)
显示声卡属性

sound_card_name (字符串)

声卡名称

sound_card_name (字符串)
声卡名称

示例

Sample Content

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "asset_computer": {
    "id"            : "12000000099001",
    "name"          : "WS-IND-456",
    "is_server"     : false,
    "vm_type"       : 0,
    "operating_system": { "os": "Windows 11 Enterprise", "version": "23H2", "build_number": "22631.4317" },
    "computer_system": { "threads_per_core": 2, "logical_cpu_count": 16, "total_cpu_cores": 8 },
    "memory":           { "physical_memory": 17179869184, "virtual_memory": 19327352832 },
    "processors":       [ { "id": "12000000099001", "name": "Intel Core i7-1365U" } ],
    "hard_disks":       [ { "id": "12000000099002", "model_number": "NVMe KIOXIA KXG80" } ],
    "logical_drives":   [ { "id": "12000000099003", "drive_name": "C:" } ],
    "software":         [ { "id": "12000000099004", "name": "Microsoft Office" } ],
    "user":             { "id": "12000000099005", "email_id": "rita@acme.com" },
    "site":             { "id": "12000000099006", "name": "Bangalore" },
    "state":            { "id": "12000000099007", "name": "In Use" }
  }
}

获取资产计算机列表

此操作可帮助您获取计算机列表。

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers

属性

computer_system (JSONObject)
包含系统特定数据
显示属性

computer_system (JSONObject)
包含系统特定数据

service_tag (字符串)
计算机系统的唯一服务标签

service_tag (字符串)
计算机系统的唯一服务标签

示例

Sample Content

model (字符串)
计算机系统型号

model (字符串)
计算机系统型号

示例

Sample Content

id (长整型)
识别计算机的唯一标识符

id (长整型)
识别计算机的唯一标识符

示例

2134567890

name (字符串)
无描述

name (字符串)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

last_logged_user (字符串)
计算机最后登录的用户

last_logged_user (字符串)
计算机最后登录的用户

示例

Sample Content

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/asset_computers\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data='{
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
}'@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
}'''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "list_info": { "has_more_rows": true, "start_index": 1, "row_count": 50, "total_count": 184 },
  "asset_computers": [
    { "id": "12000000099001", "name": "WS-IND-456", "service_tag": "JX9PMQ8",
      "operating_system": { "os": "Windows 11 Enterprise" } },
    { "id": "12000000099045", "name": "WS-IND-471", "service_tag": "8FRMD12",
      "operating_system": { "os": "Windows 11 Pro" } }
  ]
}

删除资产计算机

此操作可帮助您删除计算机。

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}

$ curl <service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}