الطريقة: الحالة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتحقّق من حالة خدمة قائمة التحكم في الوصول إلى المفاتيح (KACLS) لتقييم ما إذا كان
نشطة ومهيأة بشكل صحيح.
عمليات الفحص الذاتي الداخلية، مثل التحقّق من إمكانية الوصول إلى KMS أو سلامة نظام التسجيل
يمكن تنفيذها أيضًا.
طلب HTTP
GET https://KACLS_URL/status
استبدِل KACLS_URL بخدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير (KACLS).
عنوان URL.
مَعلمات المسار
بلا عُري
نص الطلب
بلا عُري
نص الاستجابة
يحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"name": string,
"vendor_id": string,
"version": string,
"server_type": string,
"operations_supported": string array
}
|
| الحقول |
name |
string (UTF-8)
اسم مثيل اختياري.
|
operations_supported |
string array
قائمة بالعمليات التي توفِّرها الخدمة يتم تحديد اسم العملية من خلال مسار عنوان URL الخاص بها.
|
server_type |
string (UTF-8)
يجب أن يكون KACLS.
|
vendor_id |
string (UTF-8)
اسم مورِّد خدمة KACLS
|
version |
string (UTF-8)
إصدار البرنامج.
|
مثال
يوفّر هذا المثال نموذجًا للرد على status.
.
الرد
{
"server_type": "KACLS",
"vendor_id": "Test",
"version": "demo",
"name": "K8 reference",
"operations_supported": [
"wrap", "unwrap", "privilegedunwrap",
"privatekeydecrypt", "privatekeysign", "privilegedprivatekeydecrypt"
]
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis endpoint (\u003ccode\u003eGET /status\u003c/code\u003e) checks the operational status and configuration of a Key Access Control List Service (KACLS).\u003c/p\u003e\n"],["\u003cp\u003eIt provides essential information about the KACLS instance, such as its name, vendor, version, server type, and supported operations.\u003c/p\u003e\n"],["\u003cp\u003eThe response confirms whether the KACLS is active and details the functionalities it offers.\u003c/p\u003e\n"],["\u003cp\u003eInternal self-checks within the KACLS, including KMS accessibility and logging system health, might also be conducted as part of the status check.\u003c/p\u003e\n"]]],["A `GET` request to the `/status` endpoint of a Key Access Control List Service (KACLS) URL checks its status. The response contains JSON data, including the KACLS's `server_type` (which must be \"KACLS\"), `vendor_id`, `version`, an optional `name`, and a `operations_supported` array. This method is also used for internal checks such as KMS accessibility and logging health. Example provided of how a successful response looks like.\n"],null,["# Method: status\n\nChecks the status of a Key Access Control List Service (KACLS) to assess whether\nit's active and properly configured.\n\nInternal self checks, like checking KMS accessibility or logging system health,\ncan also be performed.\n\n### HTTP request\n\n`GET https://`\u003cvar translate=\"no\"\u003eKACLS_URL\u003c/var\u003e`/status`\n\nReplace \u003cvar translate=\"no\"\u003eKACLS_URL\u003c/var\u003e with the Key Access Control List Service (KACLS)\nURL.\n\n### Path parameters\n\nNone.\n\n### Request body\n\nNone.\n\n### Response body\n\nThe response body contains data with the following structure:\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"vendor_id\": string, \"version\": string, \"server_type\": string, \"operations_supported\": string array } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------|\n| `name` | `string (UTF-8)` An optional instance name. |\n| `operations_supported` | `string array` List of operations supported by the service. The name of the operation is defined by its URL path. |\n| `server_type` | `string (UTF-8)` Must be `KACLS`. |\n| `vendor_id` | `string (UTF-8)` The KACLS vendor name. |\n| `version` | `string (UTF-8)` The software version. |\n\n### Example\n\nThis example provides a sample response for the `status`\nmethod.\n\n#### Response\n\n {\n \"server_type\": \"KACLS\",\n \"vendor_id\": \"Test\",\n \"version\": \"demo\",\n \"name\": \"K8 reference\",\n \"operations_supported\": [\n \"wrap\", \"unwrap\", \"privilegedunwrap\",\n \"privatekeydecrypt\", \"privatekeysign\", \"privilegedprivatekeydecrypt\"\n ]\n }"]]
