Maintenance Window Options - Get
取得可用的維護時段清單。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/maintenanceWindowOptions/current?api-version=2025-01-01&maintenanceWindowOptionsName={maintenanceWindowOptionsName}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
資料庫的名稱。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
資源群組的名稱。 名稱不區分大小寫。 |
|
server
|
path | True |
string |
伺服器的名稱。 |
|
subscription
|
path | True |
string (uuid) |
目標訂用帳戶的標識碼。 此值必須是 UUID。 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
|
maintenance
|
query | True |
string |
維護時段選項名稱。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Azure 運作順利完成。 |
|
| Other Status Codes |
未預期的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow.
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 模擬您的用戶帳戶 |
範例
Gets a list of available maintenance windows for a selected database.
範例要求
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/maintenanceWindowOptions/current?api-version=2025-01-01&maintenanceWindowOptionsName=current
範例回覆
{
"name": "current",
"type": "Microsoft.Sql/servers/databases/maintenancewindows",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/maintenancewindowoptions/current",
"properties": {
"allowMultipleMaintenanceWindowsPerCycle": true,
"defaultDurationInMinutes": 120,
"isEnabled": true,
"maintenanceWindowCycles": [
{
"dayOfWeek": "Saturday",
"duration": "PT60M",
"startTime": "00:00:00"
}
],
"minCycles": 2,
"minDurationInMinutes": 60,
"timeGranularityInMinutes": 5
}
}
定義
| 名稱 | Description |
|---|---|
|
created |
建立資源的身分識別類型。 |
|
Day |
維護時間範圍。 |
|
Error |
資源管理錯誤附加資訊。 |
|
Error |
錯誤詳細資料。 |
|
Error |
錯誤回應 |
|
Maintenance |
維護時段選項。 |
|
Maintenance |
維護時段時間範圍。 |
|
system |
與建立和上次修改資源相關的元數據。 |
createdByType
建立資源的身分識別類型。
| 值 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DayOfWeek
維護時間範圍。
| 值 | Description |
|---|---|
| Sunday |
星期日 |
| Monday |
星期一 |
| Tuesday |
星期二 |
| Wednesday |
星期三 |
| Thursday |
星期四 |
| Friday |
星期五 |
| Saturday |
星期六 |
ErrorAdditionalInfo
資源管理錯誤附加資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
附加資訊。 |
| type |
string |
其他資訊類型。 |
ErrorDetail
錯誤詳細資料。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤附加資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳情 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
錯誤物件。 |
MaintenanceWindowOptions
維護時段選項。
| 名稱 | 類型 | Description |
|---|---|---|
| id |
string (arm-id) |
資源的完整資源標識碼。 例如,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| name |
string |
資源的名稱 |
| properties.allowMultipleMaintenanceWindowsPerCycle |
boolean |
我們是否允許每個週期有多個維護期間。 |
| properties.defaultDurationInMinutes |
integer (int32) |
維護期間的預設持續時間。 |
| properties.isEnabled |
boolean |
是否為資料庫啟用維護期間。 |
| properties.maintenanceWindowCycles |
可用的維護週期,例如 {Saturday, 0, 4860}, {Wednesday, 0, 2460}。 |
|
| properties.minCycles |
integer (int32) |
資料庫上要設定的維護時段週期數目下限。 |
| properties.minDurationInMinutes |
integer (int32) |
維護時段的持續時間下限。 |
| properties.timeGranularityInMinutes |
integer (int32) |
維護時段的分鐘數時間粒度。 |
| systemData |
Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。 |
|
| type |
string |
資源的類型。 例如:「Microsoft。運算/虛擬機器」或「Microsoft」。儲存/儲存帳號」 |
MaintenanceWindowTimeRange
維護時段時間範圍。
| 名稱 | 類型 | Description |
|---|---|---|
| dayOfWeek |
維護時間範圍。 |
|
| duration |
string |
維護期間以分鐘為單位。 |
| startTime |
string |
從上午 12 點開始時間分鐘位移。 |
systemData
與建立和上次修改資源相關的元數據。
| 名稱 | 類型 | Description |
|---|---|---|
| createdAt |
string (date-time) |
資源建立的時間戳(UTC)。 |
| createdBy |
string |
建立資源的身分識別。 |
| createdByType |
建立資源的身分識別類型。 |
|
| lastModifiedAt |
string (date-time) |
資源上次修改的時間戳記 (UTC) |
| lastModifiedBy |
string |
上次修改資源的身分識別。 |
| lastModifiedByType |
上次修改資源的身分識別類型。 |