getEndpointTags: төгсгөлийн төхөөрөмжийн шошгуудыг авах
Энэ хуудсыг AI-аар орчуулж, автоматаар шалгасан. Нарийн тохиргоо хийхээсээ өмнө англи эхтэй тулгаж болно.
Энэ method нь төгсгөлийн төхөөрөмжийн шошго (endpoint tag)-ийн дэлгэрэнгүй мэдээллийг буцаана.
Параметрүүд
| Параметр | Тайлбар | Хүсэлтэд | Төрөл | Утга |
|---|---|---|---|---|
| orderBy | Буцаах төгсгөлийн төхөөрөмжийн шошгуудыг эрэмбэлэх шалгуур. | Заавал биш | String | Боломжит утга: name - шошгуудыг шошгоны нэрээр эрэмбэлнэ. type - шошгуудыг төрлөөр нь эрэмбэлнэ: Custom эсвэл Automatic. created - шошгуудыг үүсгэсэн огноогоор нь эрэмбэлнэ. Өгөгдмөл утга: created. Жишээ: "orderBy": "name" |
| order | Эрэмбийн чиглэл. | Заавал биш | String | Боломжит утга: ASC - шошгуудыг сонгосон шалгуурын дагуу өсөх дарааллаар буцаана: created - хуучнаас шинэ рүү; name - A-аас Z хүртэл цагаан толгойн дарааллаар; type - Custom шошго Automatic шошгоос өмнө. DESC - шошгуудыг сонгосон шалгуурын дагуу буурах дарааллаар буцаана: created - шинээс хуучин руу; name - Z-ээс A хүртэл цагаан толгойн дарааллаар; type - Automatic шошго Custom шошгоос өмнө. Өгөгдмөл утга: DESC. Жишээ: "order": "ASC" |
Ерөнхий параметрүүд
Эдгээр нь Public API-ийн бүх method-д нийтлэг байдаг параметрүүд юм.
| Параметр | Тайлбар | Хүсэлтэд | Төрөл | Утгын шаардлага |
|---|---|---|---|---|
| id | Хүсэлтэд танигч нэмж, түүнийг хариутай нь холбоно. Зорилтот систем хариунд ижил утгыг буцаах тул дуудлагыг амархан хянах боломжтой. | Заавал | String | Нэмэлт шаардлагагүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb" |
| method | Хүсэлт илгээхэд ашиглаж буй method-ын нэр. | Заавал | String | Хүчинтэй method-ын нэр байх ёстой. Жишээ: "method": "methodName" |
| jsonrpc | Хүсэлт ба хариуны ашигласан JSON-RPC хувилбар. | Заавал | String | Цорын ганц боломжит утга: 2.0. Жишээ: "jsonrpc": "2.0" |
| params | Хүсэлтийн тохиргоог агуулсан объект. | Заавал | Object | Нэмэлт шаардлагагүй. Жишээ: "params": {...} |
| params объектын дотор | ||||
| page | Үр дүнгийн хуудасны дугаар. | Заавал биш | Integer | Өгөгдмөл утга: 1. Жишээ: "page": 2 |
| perPage | Нэг хуудсанд харуулах үр дүнгийн тоо. | Заавал биш | Integer | Дээд хязгаар нь нэг хуудсанд 100 зүйл. Өгөгдмөл утга: 30. Жишээ: "perPage": 1 |
Буцаах утга
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
| result | Array of objects | Массив дахь объект бүрийн талаарх дэлгэрэнгүйг result хэсгээс үз. |
Объектууд
result
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
| id | String | Төгсгөлийн төхөөрөмжийн шошгоны ID. Зөвлөмж: энэ ID-г createCustomRule болон updateCustomRule method-уудад ашиглан энэ шошготой төгсгөлийн төхөөрөмжүүдэд чиглэсэн custom дүрэм тохируулна. |
| name | String | Төгсгөлийн төхөөрөмжийн шошгоны нэр. |
| type | Integer | Төгсгөлийн төхөөрөмжийн шошгоны төрөл. Боломжит утга: 0 - Custom шошго; 1 - Automatic шошго |
| description | String | Төгсгөлийн төхөөрөмжийн шошгоны тайлбар. |
| company | Object | Шошготой холбоотой компанийн мэдээлэл. Объект дараахыг агуулна: id (String) - компанийн ID; name (String) - компанийн нэр. |
| created | String | Шошгыг үүсгэсэн огноо, цаг. |
| rules | Object | Automatic шошгыг тодорхойлоход ашигласан дүрмүүд. Объект дараахыг агуулна: endpointName (Object) - төгсгөлийн төхөөрөмжийн нэрийн загварын дүрмийн мэдээлэл, дэлгэрэнгүйг endpointName хэсгээс үз. ip (Object) - IP эсвэл CIDR-ийн дүрмийн мэдээлэл, дэлгэрэнгүйг ip хэсгээс үз. os (Object) - үйлдлийн системийн төрлийн дүрмийн мэдээлэл, дэлгэрэнгүйг os хэсгээс үз. endpointType (Object) - төгсгөлийн төхөөрөмжийн төрлийн дүрмийн мэдээлэл, дэлгэрэнгүйг endpointType хэсгээс үз. |
##### endpointName
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
| enabled | Boolean | Дүрэм шошгоны тодорхойлолтод идэвхтэй эсэхийг заана: идэвхтэй бол true, идэвхгүй бол false. |
| rule | String | Шошго авахын тулд төгсгөлийн төхөөрөмжийн таарах ёстой нэрийн загвар. * болон ? орлуулагч тэмдэгтийг дэмжинэ. Чухал: enabled атрибутын утга false бол утга нь null биш байсан ч энэ атрибут шошгоны ажиллагаанд нөлөөлөхгүй. |
##### ip
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
| enabled | Boolean | Дүрэм шошгоны тодорхойлолтод идэвхтэй эсэхийг заана: идэвхтэй бол true, идэвхгүй бол false. |
| rule | String | Шошго авахын тулд төгсгөлийн төхөөрөмжийн таарах ёстой IP хаяг эсвэл CIDR муж. Чухал: enabled атрибутын утга false бол утга нь null биш байсан ч энэ атрибут шошгоны ажиллагаанд нөлөөлөхгүй. |
##### os
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
| enabled | Boolean | Дүрэм шошгоны тодорхойлолтод идэвхтэй эсэхийг заана: идэвхтэй бол true, идэвхгүй бол false. |
| rule | Integer | Шошго авахын тулд төгсгөлийн төхөөрөмж ажиллуулж байх ёстой үйлдлийн систем. Боломжит утга: 3 - Windows; 4 - Linux; 6 - macOS. Чухал: enabled атрибутын утга false бол утга нь null биш байсан ч энэ атрибут шошгоны ажиллагаанд нөлөөлөхгүй. |
##### endpointType
| Атрибут | Төрөл | Тайлбар |
|---|---|---|
| enabled | Boolean | Дүрэм шошгоны тодорхойлолтод идэвхтэй эсэхийг заана: идэвхтэй бол true, идэвхгүй бол false. |
| rule | Integer | Шошго авахад шаардлагатай төгсгөлийн төхөөрөмжийн төрөл. Боломжит утга: 0 - Workstation; 1 - Server. Чухал: enabled атрибутын утга false бол утга нь null биш байсан ч энэ атрибут шошгоны ажиллагаанд нөлөөлөхгүй. |
Жишээ
Хүсэлт:
Хариу:
{
"jsonrpc": "2.0",
"result": [
{
"id": "6a1823963501cd2e0306f605",
"name": "Production Servers",
"type": 0,
"description": "All production server endpoints",
"company": {
"id": "66a0fe708d3a52774522b111",
"name": "Acme Corp"
},
"created": "2026-03-15T09:42:00+00:00"
},
{
"id": "6a1823963501cd2e0306f609",
"name": "Windows Workstations",
"type": 1,
"description": "Automatic tag for Windows workstations",
"company": {
"id": "66a0fe708d3a52774522b111",
"name": "Acme Corp"
},
"created": "2026-02-10T14:00:00+00:00",
"rules": {
"endpointName": {
"enabled": false,
"rule": "WIN-*"
},
"ip": {
"enabled": false,
"rule": null
},
"os": {
"enabled": true,
"rule": 3
},
"endpointType": {
"enabled": true,
"rule": 0
}
}
}
],
"id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}Энэ хуудсанд гарсан нэр томъёо
- Endpoint
- Хамгаалж буй компьютер, сервер, виртуал машин