Items - Revalidate CMK
指定した SQL データベースのカスタマー マネージド キー (CMK) を再検証します。
この API は、実行時間の長い操作 (LRO)をサポートします。
指定された SQL データベースのカスタマー マネージド キー (CMK) を再検証します。これは、現在構成されている Azure Key Vault (AKV) キーがまだアクセス可能で有効であり、暗号化操作に対して承認されていることを確認します。
Permissions
呼び出し元には、SQL データベースの 読み取りと書き込みの アクセス許可が必要です。
必要な委任されたスコープ
SQLDatabase.ReadWrite.All または Item.ReadWrite.All
Microsoft Entra でサポートされている ID
この API では、このセクションに記載されている Microsoft ID がサポートされています。
| アイデンティティ | Support |
|---|---|
| ユーザー | イエス |
| サービス プリンシパルとマネージド ID | イエス |
インターフェイス
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/revalidateCMK
URI パラメーター
| Name | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
sql
|
path | True |
string (uuid) |
SQL データベース ID。 |
|
workspace
|
path | True |
string (uuid) |
ワークスペース識別子。 |
応答
| Name | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は正常に完了しました。 |
|
| 202 Accepted |
要求は受け入れ済み。 CMK の再検証が進行中です。 ヘッダー
|
|
| 429 Too Many Requests |
サービス レートの制限を超えました。 サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す ヘッダー Retry-After: integer |
|
| Other Status Codes |
一般的なエラー コード:
その他のエラー コードについては、https://learn.microsoft.com/en-us/rest/api/sql/encryption-protectors/revalidate?view=rest-sql-2023-08-01& を参照してください。tabs=HTTP |
例
Revalidate CMK example
要求のサンプル
POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/revalidateCMK
応答のサンプル
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
定義
| Name | 説明 |
|---|---|
|
Error |
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。 |
|
Error |
エラー関連のリソース詳細オブジェクト。 |
|
Error |
エラー応答。 |
|
Error |
エラー応答の詳細。 |
ErrorParameter
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。
| Name | 型 | 説明 |
|---|---|---|
| message |
string |
パラメーターの意味を人間が判読できる説明。 |
| name |
string |
パラメータ識別子です。 |
| value |
string |
パラメーターの値を指定します。 |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
| Name | 型 | 説明 |
|---|---|---|
| resourceId |
string |
エラーに関係するリソース ID。 |
| resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
| Name | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| isRetriable |
boolean |
true の場合、要求を再試行できます。
|
| message |
string |
エラーの人間が判読できる表現。 |
| moreDetails |
その他のエラーの詳細の一覧。 |
|
| parameters |
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
|
| requestId |
string (uuid) |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
| Name | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| parameters |
エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |