Risk Exchange 用 CrowdStrike プラグイン

使うAPI一覧

認証トークンを取得する

API Endpoint: /oauth2/token
Method: POST
Parameter

Sample API Response

{
 "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6InB1YmxpYzphNDdiNTc2MS0zYzk3LTQwMmItOTgzNi0wNmNhODI0NTViOTMiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOltdLCJjbGllbnRfaWQiOiJlZTA5YTc3MjAwNzc0MzYwOTlhYTM5N2M2MTJlYTQzYiIsImV4cCI6MTcwMzI0MDQzOSwiZXh0Ijp7InN1Yl90eXBlIjoiY2xpZW50In0sImlhdCI6MTcwMzIzODYzOSwiaXNzIjoiaHR0cHM6Ly9hcGkuY3Jvd2RzdHJpa2UuY29tLyIsImp0aSI6ImQ5ZTlmZWI4LTM0ODAtNDM2NC1hYzI2LTBhZjgzNDdlOWY2OSIsIm5iZiI6MTcwMzIzODYzOSwic2NwIjpbXSwic3ViIjoiZWUwOWE3NzIwMDc3NDM2MDk5YWEzOTdjNjEyZWE0M2IiLq_wgw5-EAB-hHiRB-coF2Yy_PeP-8IvjWQVIjlDJrRmRQ-s-NmAkm8XaG9GojFZvaT-sufiBxKEDmpdntABNkEG1fcbVvd7tVW-vi36PFPoc3p1t4sbaMhf9_Kts8iAHsv6BudVyFsPhPAreGc2OXUFT39ZvuDTN5BxOFiPT_9_gadXt-7N*************************************************************************************",
 "expires_in": 1799,
 "token_type": "bearer"
}

レコードを取得する

API endpoint: /devices/queries/devices-scroll/v1

Method: 得る

Parameters

Headers

Sample API Response

{
    "meta": {
        "query_time": 0.025422559,
        "pagination": {
            "offset": 1,
            "limit": 1,
            "total": 21
        },
        "powered_by": "device-api",
        "trace_id": "5f1a1eeb-9d8b-4412-8523-0fc933a0bf6f"
    },
    "resources": [
        "89b9743fcb6b4ccaa09600ac5204bac4"
    ],
    "errors": []
}

スコアを取得

API Endpoint: /zero-trust-assessment​/entities​/assessments​/v1
Method: GET
Parameters

Headers

Sample API Response

{
    "meta": {
        "query_time": 0.003210238,
        "trace_id": "ba076fd9-7340-49f3-a9a2-41b6f2eb94d9"
    },
    "errors": [],
    "resources": [
        {
            "aid": "e039334e8b0e4747bdfc7a29406ec8e1",
            "cid": "c17f3a80ded0418eb107db3d26a27983",
            "system_serial_number": "FVHX2HEDJ1WK",
            "event_platform": "Mac",
            "product_type_desc": "Workstation",
            "modified_time": "2024-05-01T08:42:07Z",
            "sensor_file_status": "confirmed",
            "assessment": {
                "sensor_config": 66,
                "os": 72,
                "overall": 68,
                "version": "3.8.1"
            },
            "assessment_items": {
                "os_signals": [
                    {
                        "signal_id": "mac_os_version",
                        "signal_name": "macOS Version",
                        "group_name": "macOS",
                        "criteria": "macOS version is ≥11.0",
                        "meets_criteria": "yes"
                    }
                ],
                "sensor_signals": [
                    {
                        "signal_id": "ml_cloud_antimalware_detection_mac",
                        "signal_name": "Cloud ML - Cloud Anti-malware - Detection for macOS",
                        "group_name": "Prevention",
                        "criteria": "Cloud ML - Cloud Anti-malware Detection: set to Aggressive or higher",
                        "meets_criteria": "yes"
                    },
                                   ]
            }
        }
    ]
}

RTRクラウドにファイルをアップロードする

API Endpoint: /real-time-response/entities/put-files/v1
Method: POST
Headers

Data

{
  "description": "file representing a ZTA score of 1_25",
  "name": "crwd_zta_1_25.txt",
  "comments_for_audit_log": "uploade file representing a ZTA score of 1_25 for Netskope ZTA-RTR integration"
}

Sample API Response

{
  "meta": {
    "query_time": 0.536670425,
    "writes": {
      "resources_affected": 1
    },
    "powered_by": "empower-api",
    "trace_id": "d4bddc66-83fd-4875-9016-a17899fd83ba"
  }
}

スクリプトの存在を確認する

API Endpoint: /real-time-response/queries/scripts/v1
Method: GET
Headers

Parameters

API Response

{
    "meta": {
        "query_time": 0.025087906,
        "pagination": {
            "offset": 0,
            "limit": 100,
            "total": 1
        },
        "powered_by": "empower-api",
        "trace_id": "0e9ccedb-58c9-44a9-842c-620977f096b1"
    },
    "resources": [
        "bab3f0ff134311efb74642cd23408b64_ee09a7720077436099aa397c612ea43b"
    ]
}

RTRクラウド上でスコアファイル削除スクリプトを作成する

API Endpoint: /real-time-response/entities/scripts/v1
Method: POST
Headers

Data

Files
スクリプトファイルをアップロードしてください。
Pythonスクリプトの場合、requestsのfilesパラメータに以下のタプルを追加してください。

[
                (
                    "file",
                    (
                        "",
                        file,
                        "application/octet-stream",
                    ),
                )
            ]

API Response

{
    "meta": {
        "query_time": 0.947792627,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "empower-api",
        "trace_id": "eed1850a-0c07-488a-b36d-a70d5e904d71"
    }
}

プラットフォーム名を取得する

API Endpoint: /デバイス/entities/デバイス/v2
Method: GET
Headers

Parameters

API Response

{
    "meta": {
        "query_time": 0.001626152,
        "powered_by": "device-api",
        "trace_id": "8adcbd8a-40cd-4086-8e5d-5d3962fb1073"
    },
    "resources": [
        {
            "device_id": "d2abab7b4c6a4d9998b298b19bbda31f",
            "cid": "c17f3a80ded0418eb107db3d26a27983",
            "agent_load_flags": "0",
            "agent_local_time": "2023-12-22T11:19:53.929Z",
            "agent_version": "7.05.17603.0",
            "bios_manufacturer": "Apple Inc.",
            "bios_version": "515.0.0.0.0",
            "config_id_base": "65994753",
            "config_id_build": "17603",
            "config_id_platform": "4",
            "cpu_signature": "526057",
            "external_ip": "117.217.127.213",
            "mac_address": "dc-a9-04-99-43-aa",
            "hostname": "ITs-MacBook-Pro.local",
            "first_seen": "2023-12-18T08:46:57Z",
            "last_login_timestamp": "2023-12-21T08:00:38Z",
            "last_login_user": "it",
            "last_login_uid": "501",
            "last_login_user_sid": "S-1-5-21-1276927669-3124867281-3856135234-2002",
            "last_seen": "2023-12-22T11:46:27Z",
            "local_ip": "172.20.10.87",
            "major_version": "22",
            "minor_version": "6",
            "os_version": "Ventura (13)",
            "os_build": "22G120",
            "platform_id": "1",
            "platform_name": "Mac",
            "policies": [
                {
                    "policy_type": "prevention",
                    "policy_id": "e17fdf411592409794d748e907da9967",
                    "applied": true,
                    "settings_hash": "528b286b",
                    "assigned_date": "2023-12-18T08:48:02.464865254Z",
                    "applied_date": "2023-12-18T08:48:08.608666735Z",
                    "rule_groups": []
                }
            ],
            "reduced_functionality_mode": "yes",
            "device_policies": {
                "prevention": {
                    "policy_type": "prevention",
                    "policy_id": "e17fdf411592409794d748e907da9967",
                    "applied": true,
                    "settings_hash": "528b286b",
                    "assigned_date": "2023-12-18T08:48:02.464865254Z",
                    "applied_date": "2023-12-18T08:48:08.608666735Z",
                    "rule_groups": []
                },
                "sensor_update": {
                    "policy_type": "sensor-update",
                    "policy_id": "766825ba2e2847f8a9134f7f48f44214",
                    "applied": true,
                    "settings_hash": "tagged|3;101",
                    "assigned_date": "2023-12-18T09:00:47.465877148Z",
                    "applied_date": "2023-12-18T09:03:49.721523878Z",
                    "uninstall_protection": "ENABLED"
                },
                "device_control": {
                    "policy_type": "device-control",
                    "policy_id": "6e4a89125c4343f3ab42cbf2fa482702",
                    "applied": true,
                    "assigned_date": "2023-12-18T08:48:02.464932037Z",
                    "applied_date": "2023-12-18T08:49:48.770860727Z"
                },
                "global_config": {
                    "policy_type": "globalconfig",
                    "policy_id": "e2289d74264744f38e62d1146b13189d",
                    "applied": true,
                    "settings_hash": "1fda691c",
                    "assigned_date": "2023-12-22T11:20:01.358167731Z",
                    "applied_date": "2023-12-22T11:21:05.552056147Z"
                },
                "remote_response": {
                    "policy_type": "remote-response",
                    "policy_id": "70d43a45f67149e8b54c8d80ac00df10",
                    "applied": true,
                    "settings_hash": "797eb425",
                    "assigned_date": "2023-12-18T08:48:02.464926863Z",
                    "applied_date": "2023-12-18T08:48:08.689092082Z"
                },
                "firewall": {
                    "policy_type": "firewall",
                    "policy_id": "b1a5ff10a3c44f66a47c7f08f2e372e5",
                    "applied": true,
                    "assigned_date": "2023-12-18T08:48:02.464940776Z",
                    "applied_date": "2023-12-18T08:48:08.752377285Z",
                    "rule_set_id": "b1a5ff10a3c44f66a47c7f08f2e372e5"
                }
            },
            "groups": [],
            "group_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "product_type_desc": "Workstation",
            "provision_status": "Provisioned",
            "serial_number": "C02V10FEHV2T",
            "status": "normal",
            "system_manufacturer": "Apple Inc.",
            "system_product_name": "MacBookPro14,2",
            "tags": [],
            "modified_timestamp": "2023-12-22T11:46:35Z",
            "meta": {
                "version": "110",
                "version_string": "6:10864108136"
            },
            "kernel_version": "22.6.0",
            "chassis_type": "9",
            "chassis_type_desc": "Laptop"
        }
    ],
    "errors": null
}

セッションIDを取得する

API Endpoint: リアルタイムレスポンス/エンティティ/セッション/v1
Method: POST
Headers

Data

Sample API Response

{
    "meta": {
        "query_time": 0.315515137,
        "powered_by": "empower-api",
        "trace_id": "0483a37f-896b-4bb3-bf1e-8f8b3618a2e2"
    },
    "resources": [
        {
            "session_id": "a26ad68e-1272-482b-95b5-78ee27344d80",
            "scripts": [
                {
                    "command": "cat",
                    "description": "Read a file from disk and display as ASCII",
                    "examples": "cat foo.txt\r\ncat -n foo.txt\r\ncat -t foo.txt\r\ncat -t -n foo.txt",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": [
                        {
                            "id": 582,
                            "created_at": "2019-07-03T18:52:15Z",
                            "updated_at": "2019-07-03T18:52:15Z",
                            "script_id": 527,
                            "arg_type": "arg",
                            "data_type": "string",
                            "requires_value": false,
                            "arg_name": "Path",
                            "description": "path to cat",
                            "default_value": "",
                            "required": true,
                            "sequence": 1,
                            "options": null,
                            "encoding": "",
                            "command_level": "non-destructive"
                        },
                        {
                    "command": "getsid",
                    "description": "Enumerate local users and Security Identifiers (SID)",
                    "examples": "getsid\r\n    List all users and associated SIDs\r\ngetsid foo\r\n    List users and associated SIDs matching substring \"foo\"",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": [
                        {
                            "id": 661,
                            "created_at": "2020-04-02T03:31:02Z",
                            "updated_at": "2020-04-02T03:31:02Z",
                            "script_id": 557,
                            "arg_type": "arg",
                            "data_type": "string",
                            "requires_value": false,
                            "arg_name": "UserName",
                            "description": "Partial or full username to filter results",
                            "default_value": "",
                            "required": false,
                            "sequence": 1,
                            "options": null,
                            "encoding": "",
                            "command_level": "non-destructive"
                        }
                    ]
                },
                {
                    "command": "ls",
                    "description": "Display the contents of the specified path",
                    "examples": "ls\r\nls -l\r\nls -L\r\nls -t\r\nls -l -@\r\nls -R\r\nls -l -R\r\nls -l -t -R -L",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": [
                        {
                            "id": 576,
                            "created_at": "2019-07-03T18:51:13Z",
                            "updated_at": "2019-07-03T18:51:13Z",
                            "script_id": 526,
                            "arg_type": "arg",
                            "data_type": "string",
                            "requires_value": false,
                            "arg_name": "Path",
                            "description": "Path ",
                            "default_value": ".",
                            "required": false,
                            "sequence": 1,
                            "options": null,
                            "encoding": "",
                            "command_level": "non-destructive"
                        }                    ]
                },
                {
                    "command": "mount",
                    "description": "List or mount filesystem volumes",
                    "examples": "Executable by all RTR roles:\r\nmount\r\nExecutable by privileged RTR users only:\r\nmount -t=nfs \"host:/exports/filesystem\" \"/mnt/filesystem\"\r\n    Mount the NFS filesystem located at \"/exports/filesystem\" on \"host\" to the local destination \"/mnt/filesystem\"\r\nmount -t=smbfs \"//user:password@host/filesystem\" \"/mnt/mountpoint\"\r\n    Mount the SMB \"/filesystem\" on \"host\" as \"user\" with \"password\" to \"/mnt/mountpoint\"\r\nmount -t=smbfs -o=nobrowse \"//user:password@host/filesystem\" \"/mnt/mountpoint\"\r\n    Mount the SMB \"/filesystem\" with option \"nobrowse\" on \"host\" as \"user\" with \"password\" to \"/mnt/mountpoint\"",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": []
                },
                {
                    "command": "netstat",
                    "description": "Display routing information or network connections",
                    "examples": "netstat\r\nnetstat -nr",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": [
                            {
                            "id": 973,
                            "created_at": "2023-11-20T23:23:37Z",
                            "updated_at": "2023-11-20T23:23:37Z",
                            "script_id": 539,
                            "arg_type": "flag",
                            "data_type": "string",
                            "requires_value": false,
                            "arg_name": "n",
                            "description": "Flag to show network addresses as numbers",
                            "default_value": "",
                            "required": false,
                            "sequence": 2,
                            "options": null,
                            "encoding": "",
                            "command_level": "non-destructive"
                        }
                    ]
                },
                {
                    "command": "users",
                    "description": "Get details about local users",
                    "examples": "users\r\n    List details about all local users\r\nusers foo\r\n    List details about local user \"foo\"",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": [
                        {
                            "id": 679,
                            "created_at": "2020-04-02T03:31:12Z",
                            "updated_at": "2020-04-02T03:31:12Z",
                            "script_id": 565,
                            "arg_type": "arg",
                            "data_type": "string",
                            "requires_value": false,
                            "arg_name": "UserName",
                            "description": "Username to filter results",
                            "default_value": "",
                            "required": false,
                            "sequence": 1,
                            "options": null,
                            "encoding": "",
                            "command_level": "non-destructive"
                        }
                    ]
                }
            ],
            "existing_aid_sessions": 1,
            "created_at": "2023-12-22T15:47:24.904481922Z",
            "offline_queued": true
        }
    ],
    "errors": null
}

ディレクトリを変更する

API Endpoint: /real-time-response/entities/admin-command/v1

Method: 役職
Headers

Data

Sample API Response

{
    "meta": {
        "query_time": 0.052249291,
        "powered_by": "empower-api",
        "trace_id": "ebb0457c-1000-4607-99c5-85fd2c2aae91"
    },
    "resources": [
        {
            "session_id": "30b171e9-26ca-4856-b00e-10d5c4be765e",
            "cloud_request_id": "399d6ed9-e2c5-4e72-8618-97515f69dc72",
            "queued_command_offline": false
        }
    ],
    "errors": null
}

デバイスにファイルを保存する

API Endpoint: /real-time-response/entities/admin-command/v1

Method: 役職
Headers

Data

Sample API Response

{
    "meta": {
        "query_time": 0.052249291,
        "powered_by": "empower-api",
        "trace_id": "ebb0457c-1000-4607-99c5-85fd2c2aae91"
    },
    "resources": [
        {
            "session_id": "30b171e9-26ca-4856-b00e-10d5c4be765e",
            "cloud_request_id": "399d6ed9-e2c5-4e72-8618-97515f69dc72",
            "queued_command_offline": false
        }
    ],
    "errors": null
}

デバイスからファイルを削除する

API Endpoint: /real-time-response/entities/admin-command/v1

Method: 役職
Headers

Data

Sample API Response

{
    "meta": {
        "query_time": 0.052249291,
        "powered_by": "empower-api",
        "trace_id": "ebb0457c-1000-4607-99c5-85fd2c2aae91"
    },
    "resources": [
        {
            "session_id": "30b171e9-26ca-4856-b00e-10d5c4be765e",
            "cloud_request_id": "399d6ed9-e2c5-4e72-8618-97515f69dc72",
            "queued_command_offline": false
        }
    ],
    "errors": null
}

コマンドステータスを取得する

API Endpoint: /real-time-response/entities/admin-command/v1
Method: GET
Headers

Parameters

Sample API Response

{
    "meta": {
        "query_time": 0.30452861,
        "powered_by": "empower-api",
        "trace_id": "f2fbc47d-a6e5-4ddf-9bb0-778fd7b32017"
    },
    "resources": [
        {
            "session_id": "30b171e9-26ca-4856-b00e-10d5c4be765e",
            "task_id": "399d6ed9-e2c5-4e72-8618-97515f69dc72",
            "complete": true,
            "stdout": "",
            "stderr": "/Library/Application Support/Netskope/STAgent does not exist\n",
            "base_command": "cd"
        }
    ],
    "errors": []
}

セッションを削除する

API Endpoint: /real-time-response/entities/sessions/v1

Method: DELETE
Headers

Parameter

Sample API Response

Status code: 204
No Content

ホストの詳細を取得

API endpoint: /devices/entities/devices/v2

Method: 役職

Parameters

Headers

Sample API Response

{
    "meta": {
        "query_time": 0.117260667,
        "powered_by": "device-api",
        "trace_id": "0a85703e-2de1-49e5-b6e4-f2bd0d34089e"
    },
    "resources": [
        {
            "device_id": "ea72524ea4ad4b27972d243ecbaa1301",
            "cid": "c17f3a80ded0418eb107db3d26a27983",
            "agent_load_flags": "17",
            "agent_local_time": "2025-09-24T06:32:54.445Z",
            "agent_version": "7.26.19811.0",
            "bios_manufacturer": "Amazon EC2",
            "bios_version": "1.0",
            "build_number": "20348",
            "config_id_base": "65994767",
            "config_id_build": "19811",
            "config_id_platform": "3",
            "cpu_signature": "526072",
            "cpu_vendor": "0",
            "external_ip": "3.94.32.239",
            "mac_address": "0e-2d-ab-80-66-21",
            "instance_id": "i-029d628a3ccff68b2",
            "service_provider": "AWS_EC2_V2",
            "service_provider_account_id": "697148468905",
            "hostname": "WSAMZN-ITJAV0IR",
            "filesystem_containment_status": "normal",
            "first_seen": "2025-05-30T19:36:27Z",
            "last_login_timestamp": "2025-06-02T19:53:00Z",
            "last_login_user": "admin01",
            "last_login_user_sid": "S-1-5-21-1855757304-2032728104-4068347724-1147",
            "last_seen": "2025-09-24T06:34:07Z",
            "local_ip": "198.19.158.136",
            "machine_domain": "Test.com",
            "major_version": "10",
            "minor_version": "0",
            "os_version": "Windows Server 2022",
            "os_build": "20348",
            "ou": [
                "Computers",
                "Test"
            ],
            "platform_id": "0",
            "platform_name": "Windows",
            "policies": [
                {
                    "policy_type": "prevention",
                    "policy_id": "07edbe6317064e6bace102d489e9e19a",
                    "applied": true,
                    "settings_hash": "9ad81c1b",
                    "assigned_date": "2025-05-30T19:37:40.446318344Z",
                    "applied_date": "2025-05-30T19:37:50.956236409Z",
                    "rule_groups": [
                        "6872ddd9b48f46feb1d4abf2d3542310"
                    ]
                }
            ],
            "reduced_functionality_mode": "no",
            "rtr_state": "enabled",
            "device_policies": {
                "prevention": {
                    "policy_type": "prevention",
                    "policy_id": "07edbe6317064e6bace102d489e9e19a",
                    "applied": true,
                    "settings_hash": "9ad81c1b",
                    "assigned_date": "2025-05-30T19:37:40.446318344Z",
                    "applied_date": "2025-05-30T19:37:50.956236409Z",
                    "rule_groups": [
                        "6872ddd9b48f46feb1d4abf2d3542310"
                    ]
                },
                "sensor_update": {
                    "policy_type": "sensor-update",
                    "policy_id": "e306abdd429c43c3950543f22662bb15",
                    "applied": true,
                    "settings_hash": "tagged|2;101",
                    "assigned_date": "2025-08-27T04:11:41.092429921Z",
                    "applied_date": "2025-08-27T04:13:01.950732526Z",
                    "uninstall_protection": "ENABLED"
                },
                "device_control": {
                    "policy_type": "device-control",
                    "policy_id": "61c165fc44cd4a4d920aada842fd0e6c",
                    "applied": true,
                    "settings_hash": "e53be076",
                    "assigned_date": "2025-05-30T19:37:40.446402575Z",
                    "applied_date": "2025-05-30T19:37:51.181527598Z"
                },
                "global_config": {
                    "policy_type": "globalconfig",
                    "policy_id": "bc920818ad0046238a4f7565a97b1ffa",
                    "applied": true,
                    "settings_hash": "6f3f73f5",
                    "assigned_date": "2025-09-24T04:06:34.523107331Z",
                    "applied_date": "2025-09-24T06:39:09.987097062Z"
                },
                "remote_response": {
                    "policy_type": "remote-response",
                    "policy_id": "e18954cfc9dd4707a4b7e7209614b38f",
                    "applied": true,
                    "settings_hash": "797eb425",
                    "assigned_date": "2025-05-30T19:37:40.446118335Z",
                    "applied_date": "2025-05-30T19:37:50.946803441Z"
                },
                "firewall": {
                    "policy_type": "firewall",
                    "policy_id": "046a320f8aa5446ba46ff168dad25b21",
                    "applied": true,
                    "settings_hash": "f5bd3b38",
                    "assigned_date": "2025-05-30T19:37:40.445507286Z",
                    "applied_date": "2025-05-30T19:37:51.191633303Z",
                    "rule_set_id": "046a320f8aa5446ba46ff168dad25b21"
                },
                "system-tray": {
                    "policy_type": "system-tray",
                    "policy_id": "21166876996942fea6826e86af5d8851",
                    "applied": true,
                    "settings_hash": "64111ecabb0f2fff301bef6007dd2792f26df4fe37d52475b301883d5d05a856",
                    "assigned_date": "2025-05-30T19:37:40.44621436Z",
                    "applied_date": "2025-05-30T19:37:50.979483198Z"
                },
                "it-automation": {
                    "policy_type": "it-automation",
                    "policy_id": "e5023d7fe0f04d079aa6781ea551b7b7",
                    "applied": true,
                    "settings_hash": "8b2dd4644a0b8d81afb2b5abb021036c15740677d05e981c9ec52aeed3795d40",
                    "assigned_date": "2025-08-01T04:04:54.664467601Z",
                    "applied_date": "2025-08-01T04:06:34.647303444Z"
                },
                "host-retention": {
                    "policy_type": "host-retention",
                    "policy_id": "2bc7c08cc62542a5aecdcf7ee6ef0521",
                    "applied": true,
                    "settings_hash": "fce339fc6cbb4dae36929fe363a81368f4a7e3f2c3a3d62ff7e3ef202ee48df5",
                    "assigned_date": "2025-05-30T19:37:40.445855778Z",
                    "applied_date": "2025-05-30T19:37:51.027363767Z"
                },
                "browser-extension": {
                    "policy_type": "browser-extension",
                    "policy_id": "73a923145bde4185952e565997e98e76",
                    "applied": true,
                    "settings_hash": "703a53a9569764fe0169ebc6af5d0f4e1646ee9c933ddfae4aed2b89244ac704",
                    "assigned_date": "2025-05-30T19:40:27.187530564Z",
                    "applied_date": "2025-05-30T19:45:38.428436061Z"
                },
                "content-update": {
                    "policy_type": "content-update",
                    "policy_id": "3854f9273d2e40dd8b2cb38a6cb5723e",
                    "applied": true,
                    "settings_hash": "12843283258447456940",
                    "assigned_date": "2025-05-30T19:37:40.445946984Z",
                    "applied_date": "2025-05-30T19:37:40.445946984Z"
                }
            },
            "groups": [],
            "group_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "product_type": "3",
            "product_type_desc": "Server",
            "provision_status": "Provisioned",
            "serial_number": "ec2b81ea-aff2-8ace-e98e-e084a7c87951",
            "service_pack_minor": "0",
            "pointer_size": "8",
            "site_name": "Default-First-Site-Name",
            "status": "normal",
            "system_manufacturer": "Amazon EC2",
            "system_product_name": "m7i-flex.large",
            "tags": [],
            "modified_timestamp": "2025-09-24T06:39:10Z",
            "meta": {
                "version": "252",
                "version_string": "14:40353731180"
            },
            "zone_group": "us-east-1b",
            "kernel_version": "10.0.20348.4163",
            "os_product_name": "Windows Server 2022 Datacenter",
            "chassis_type": "1",
            "chassis_type_desc": "Other",
            "last_reboot": "2025-09-24T06:32:46Z",
            "pod_labels": [],
            "pod_annotations": [],
            "connection_ip": "172.30.0.131",
            "default_gateway_ip": "172.30.0.1",
            "connection_mac_address": "0e-98-05-92-b0-8b"
        }
    ],
    "errors": null
}

ホストへのタグの追加／削除

API endpoint: /devices/entities/devices/tags/v1

Method: パッチ

Parameters

Headers

Sample API Response

{
    "meta": {
        "query_time": 0.306923974,
        "powered_by": "device-api",
        "trace_id": "f7e2c5a0-7678-40c0-8c64-1beaa19a3aad"
    },
    "resources": [
        {
            "device_id": "6b19e5d6f58140f895d3d9e74c3effaf",
            "updated": true,
            "code": 200
        }
    ],
    "errors": null
}