Methode: status
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Prüft den Status eines Key Access Control List Service (KACLS), um zu beurteilen, ob
dass es aktiv und richtig konfiguriert ist.
Interne Selbstprüfungen, z. B. das Prüfen des KMS-Zugriffs oder das Logging des Systemzustands
durchgeführt werden.
HTTP-Anfrage
GET https://KACLS_URL/status
Ersetzen Sie KACLS_URL durch den Key Access Control List Service (KACLS)
URL
Pfadparameter
Keine.
Anfragetext
Keine.
Antworttext
Der Antworttext enthält Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"name": string,
"vendor_id": string,
"version": string,
"server_type": string,
"operations_supported": string array
}
|
| Felder |
name |
string (UTF-8)
Ein optionaler Instanzname.
|
operations_supported |
string array
Liste der vom Dienst unterstützten Vorgänge. Der Name des Vorgangs wird durch seinen URL-Pfad definiert.
|
server_type |
string (UTF-8)
Muss KACLS lauten.
|
vendor_id |
string (UTF-8)
Der Name des KACLS-Anbieters.
|
version |
string (UTF-8)
Die Softwareversion.
|
Beispiel
Dieses Beispiel liefert eine Beispielantwort für status
.
Antwort
{
"server_type": "KACLS",
"vendor_id": "Test",
"version": "demo",
"name": "K8 reference",
"operations_supported": [
"wrap", "unwrap", "privilegedunwrap",
"privatekeydecrypt", "privatekeysign", "privilegedprivatekeydecrypt"
]
}
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\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 }"]]
