Mirroring - Get Mirroring Status
获取镜像数据库的状态。
权限
调用方必须具有镜像数据库的 读取 权限。
所需的委派范围
MirroredDatabase.Read.All 或 MirroredDatabase.ReadWrite.All 或 Item.Read.All 或 Item.ReadWrite.All
Microsoft Entra 支持的标识
此 API 支持本节中列出的Microsoft 标识。
| 身份 | 支持 |
|---|---|
| 用户 | 是的 |
| 服务主体和托管标识 | 是的 |
接口
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getMirroringStatusURI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
mirrored
|
path | True |
string (uuid) |
镜像数据库 ID。 |
|
workspace
|
path | True |
string (uuid) |
工作区 ID。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
请求成功完成。 |
|
| Other Status Codes |
常见错误代码：
|
示例
Get mirroring status example
示例请求
POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/getMirroringStatus
示例响应
{
"status": "Running"
}定义
| 名称 | 说明 |
|---|---|
|
Error |
与错误相关的资源详细信息对象。 |
|
Error |
错误响应。 |
|
Error |
错误响应详细信息。 |
|
Mirroring |
镜像状态类型。 可能会随着时间的推移添加其他 |
|
Mirroring |
获取镜像状态的响应。 |
ErrorRelatedResource
与错误相关的资源详细信息对象。
| 名称 | 类型 | 说明 |
|---|---|---|
| resourceId |
string |
错误中涉及的资源 ID。 |
| resourceType |
string |
错误中涉及的资源的类型。 |
ErrorResponse
错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| errorCode |
string |
提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。 |
| message |
string |
错误的人工可读表示形式。 |
| moreDetails |
其他错误详细信息的列表。 |
|
| relatedResource |
与错误相关的资源详细信息。 |
|
| requestId |
string |
与错误关联的请求的 ID。 |
ErrorResponseDetails
错误响应详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| errorCode |
string |
提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。 |
| message |
string |
错误的人工可读表示形式。 |
| relatedResource |
与错误相关的资源详细信息。 |
MirroringStatus
镜像状态类型。 可能会随着时间的推移添加其他 MirroringStatus 类型。
| 值 | 说明 |
|---|---|
| Initializing |
关联的 SQL 终结点预配正在进行中。 |
| Initialized |
关联的 SQL 终结点预配已成功，镜像数据库已准备好启动。 |
| Starting |
镜像数据库的镜像实例正在启动。 |
| Running |
镜像数据库的镜像实例正在运行。 |
| Stopping |
镜像数据库的镜像实例正在停止。 |
| Stopped |
镜像数据库的镜像实例已停止。 |
MirroringStatusResponse
获取镜像状态的响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
如果在镜像中发生错误，则设置错误 |
|
| status |
镜像的状态 |