Items - Revalidate CMK
Revalidate Customer-Managed Key (CMK) der angegebenen SQL-Datenbank.
Diese API unterstützt LRO-.
Erneute Überprüfung des vom Kunden verwalteten Schlüssels (Customer Managed Key, CMK) der angegebenen SQL-Datenbank, wodurch überprüft wird, ob auf den aktuell konfigurierten Azure Key Vault (AKV)-Schlüssel weiterhin zugegriffen werden kann, gültig und für Verschlüsselungsvorgänge autorisiert ist.
Erlaubnisse
Der Aufrufer muss Über Lese- und Schreibberechtigungen für die SQL-Datenbank verfügen.
Erforderliche delegierte Bereiche
SQLDatabase.ReadWrite.All oder Item.ReadWrite.All
Von Microsoft Entra unterstützte Identitäten
Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.
| Identität | Support |
|---|---|
| Benutzer | Ja |
| Service Principal und Verwaltete Identitäten | Ja |
Schnittstelle
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/revalidateCMK
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
sql
|
path | True |
string (uuid) |
Die SQL-Datenbank-ID. |
|
workspace
|
path | True |
string (uuid) |
Der Arbeitsbereichsbezeichner. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung wurde erfolgreich abgeschlossen. |
|
| 202 Accepted |
Anforderung angenommen. Revalidate CMK wird ausgeführt. Header
|
|
| 429 Too Many Requests |
Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen Header Retry-After: integer |
|
| Other Status Codes |
Häufige Fehlercodes:
Weitere Fehlercodes finden Sie unter: https://learn.microsoft.com/en-us/rest/api/sql/encryption-protectors/revalidate?view=rest-sql-2023-08-01& tabs=HTTP |
Beispiele
Revalidate CMK example
Beispielanforderung
POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/revalidateCMK
Beispiel für eine Antwort
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Definitionen
| Name | Beschreibung |
|---|---|
|
Error |
Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt. |
|
Error |
Das Fehlerbezogene Ressourcendetails-Objekt. |
|
Error |
Die Fehlerantwort. |
|
Error |
Die Fehlerantwortdetails. |
ErrorParameter
Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt.
| Name | Typ | Beschreibung |
|---|---|---|
| message |
string |
Eine lesbare Beschreibung der Bedeutung des Parameters. |
| name |
string |
Die Parameterkennung. |
| value |
string |
Der übergebene Wert |
ErrorRelatedResource
Das Fehlerbezogene Ressourcendetails-Objekt.
| Name | Typ | Beschreibung |
|---|---|---|
| resourceId |
string |
Die Ressourcen-ID, die an dem Fehler beteiligt ist. |
| resourceType |
string |
Der Typ der Ressource, die an dem Fehler beteiligt ist. |
ErrorResponse
Die Fehlerantwort.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| isRetriable |
boolean |
Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den |
| message |
string |
Eine lesbare Darstellung des Fehlers. |
| moreDetails |
Liste der zusätzlichen Fehlerdetails. |
|
| parameters |
Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
|
| requestId |
string (uuid) |
ID der Anforderung, die dem Fehler zugeordnet ist. |
ErrorResponseDetails
Die Fehlerantwortdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| message |
string |
Eine lesbare Darstellung des Fehlers. |
| parameters |
Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |