PATCH /v1/computers/{:connector_guid}
Description
Name | Type | Description |
---|---|---|
version | String | |
metadata.links.self | String | |
data.connector_guid | GUID | |
data.hostname | String | |
data.windows_processor_id | String | |
data.active | Boolean | |
data.links.computer | String | |
data.links.trajectory | String | |
data.links.group | String | |
data.connector_version | String | |
data.operating_system | String | |
data.os_version | String | |
data.internal_ips | Array | |
data.internal_ips[] | String | |
data.external_ip | String | |
data.group_guid | GUID | |
data.install_date | String (Time ISO8601) | |
data.is_compromised | Boolean | |
data.demo | Boolean | |
data.network_addresses | Array | |
data.network_addresses[].mac | String | |
data.network_addresses[].ip | String | |
data.policy.guid | GUID | |
data.policy.name | String | |
data.groups | Array | |
data.groups[].guid | GUID | |
data.groups[].name | String | |
data.faults | Array | |
data.isolation.available | Boolean | |
data.isolation.status | String | |
data.orbital.status | String |
Examples
Moves computer to a group with given connector_guid and group_guid
Request
Requires AuthorizationPATCH /v1/computers/bad2c522-3052-4d75-93a0-832d6283c299
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
content-length: 53
cURL Edit, then copy and paste on your terminal
curl -X PATCH \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
-H 'content-length: 53' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-d '{"group_guid":"6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"}' \
-u YOUR_API_CLIENT_ID \
'https://api.consumer.amp.cisco.com/v1/computers/bad2c522-3052-4d75-93a0-832d6283c299'
Body
{"group_guid":"6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"}
Response
cURL Edit, then copy and paste on your terminal
curl -X PATCH \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'accept-encoding: identity' \ -H 'content-length: 53' \ --compressed -H 'Accept-Encoding: gzip, deflate' \ -d '{"group_guid":"6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"}' \ -u YOUR_API_CLIENT_ID \ 'https://api.consumer.amp.cisco.com/v1/computers/bad2c522-3052-4d75-93a0-832d6283c299'
Shortened for readability
content-type: application/json transfer-encoding: chunked status: 202 Accepted x-ratelimit-limit: 3000 x-ratelimit-reset: 892 strict-transport-security: max-age=31536000; includeSubDomains referrer-policy: strict-origin-when-cross-origin x-ratelimit-remaining: 2839 x-permitted-cross-domain-policies: none x-download-options: noopen x-frame-options: SAMEORIGIN x-ratelimit-resetdate: 2022-03-18T11:55:11Z
{
"version": "v1.2.0",
"metadata": {
"links": {
"self": "https://api.consumer.amp.cisco.com/v1/computers/bad2c522-3052-4d75-93a0-832d6283c299"
}
},
"data": {
"connector_guid": "bad2c522-3052-4d75-93a0-832d6283c299",
"hostname": "Demo_AMP",
"windows_processor_id": "195b0d8736e2af4",
"active": true,
"links": {
"computer": "https://api.consumer.amp.cisco.com/v1/computers/bad2c522-3052-4d75-93a0-832d6283c299",
"trajectory": "https://api.consumer.amp.cisco.com/v1/computers/bad2c522-3052-4d75-93a0-832d6283c299/trajectory",
"group": "https://api.consumer.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"74.177.148.86"
],
"external_ip": "78.127.198.189",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:01Z",
"is_compromised": true,
"demo": true,
"network_addresses": [
{
"mac": "31:5e:f7:d7:d3:31",
"ip": "74.177.148.86"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
}
}