الانتقال إلى المحتوى الرئيسي
PUT
/
policy
/
{policyId}
تحديث سياسة DNS
curl --request PUT \
  --url https://api.altostrat.io/policy/{policyId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "سياسة واي فاي الضيوف",
  "applications": [
    "9a9b3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b"
  ],
  "safe_search": [
    {
      "id": "9a9f3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8f",
      "option": "strict"
    }
  ],
  "dns_whitelist": [
    "partner-portal.com"
  ],
  "dns_blacklist": [
    "<string>"
  ],
  "block_adult": true,
  "sites": [
    "9a9d3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8d",
    "9a9e3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8e"
  ]
}'
{
  "id": "9a9a3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8a",
  "name": "سياسة الموظفين القياسية",
  "applications": [
    "9a9b3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b",
    "9a9c3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"
  ],
  "safe_search": [
    {
      "id": "9a9f3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8f",
      "option": "strict"
    }
  ],
  "dns_whitelist": [
    "internal.corp.com",
    "status.altostrat.io"
  ],
  "dns_blacklist": [
    "malicious-site.net"
  ],
  "block_adult": true,
  "attachments": 5,
  "created_at": "2025-10-29T13:04:44Z"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

policyId
string<uuid>
required

المعرّف الفريد لسياسة DNS المطلوب تحديثها.

Body

application/json
name
string
required

اسم مقروء للسياسة.

Example:

"سياسة واي فاي الضيوف"

block_adult
boolean
required

إذا كانت القيمة 'true'، يتم حظر جميع التطبيقات المصنفة كمحتوى للبالغين تلقائيًا.

Example:

true

applications
string<uuid>[]

قائمة بمعرّفات التطبيقات التي سيتم حظرها بواسطة هذه السياسة.

Example:
["9a9b3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b"]

قائمة بقواعد فرض البحث الآمن.

dns_whitelist
string<hostname>[]

قائمة بأسماء النطاقات المؤهلة بالكامل (FQDNs) للسماح بها دائمًا.

Example:
["partner-portal.com"]
dns_blacklist
string<hostname>[]

قائمة بأسماء النطاقات المؤهلة بالكامل (FQDNs) لحظرها دائمًا.

sites
string<uuid>[]

قائمة بمعرّفات المواقع التي يجب ربط هذه السياسة بها. سيتم فصل أي مواقع غير موجودة في هذه القائمة.

Example:
[
"9a9d3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8d",
"9a9e3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8e"
]

Response

تم تحديث سياسة DNS بنجاح.

id
string<uuid>

المعرّف الفريد لسياسة DNS.

Example:

"9a9a3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8a"

name
string

اسم مقروء للسياسة.

Example:

"سياسة الموظفين القياسية"

applications
string<uuid>[]

قائمة بمعرّفات التطبيقات التي سيتم حظرها بواسطة هذه السياسة.

Example:
[
"9a9b3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b",
"9a9c3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"
]

قائمة بقواعد فرض البحث الآمن.

dns_whitelist
string<hostname>[]

قائمة بأسماء النطاقات المؤهلة بالكامل (FQDNs) للسماح بها دائمًا، متجاوزة أي قواعد حظر.

Example:
["internal.corp.com", "status.altostrat.io"]
dns_blacklist
string<hostname>[]

قائمة بأسماء النطاقات المؤهلة بالكامل (FQDNs) لحظرها دائمًا.

Example:
["malicious-site.net"]
block_adult
boolean

إذا كانت القيمة 'true'، يتم حظر جميع التطبيقات المصنفة كمحتوى للبالغين تلقائيًا.

Example:

true

attachments
integer

عدد المواقع التي تستخدم هذه السياسة حاليًا.

Example:

5

created_at
string<date-time>

الطابع الزمني الذي تم فيه إنشاء السياسة.

Example:

"2025-10-29T13:04:44Z"