Maintenance Window Options - Get
Ruft eine Liste der verfügbaren Wartungsfenster ab.
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-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
database
|
path | True |
string |
Der Name der Datenbank. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
server
|
path | True |
string |
Name des Servers |
|
subscription
|
path | True |
string (uuid) |
Die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
|
maintenance
|
query | True |
string |
Name der Wartungsfensteroptionen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Azure-Operation erfolgreich abgeschlossen. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
Gets a list of available maintenance windows for a selected database.
Beispielanforderung
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
Beispiel für eine Antwort
{
"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
}
}
Definitionen
| Name | Beschreibung |
|---|---|
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Day |
Tag des Wartungsfensters. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Maintenance |
Wartungsfensteroptionen. |
|
Maintenance |
Zeitbereich des Wartungsfensters. |
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DayOfWeek
Tag des Wartungsfensters.
| Wert | Beschreibung |
|---|---|
| Sunday |
Sonntag |
| Monday |
Monday |
| Tuesday |
Dienstag |
| Wednesday |
Wednesday |
| Thursday |
Thursday |
| Friday |
Freitag |
| Saturday |
Saturday |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
Die zusätzlichen Informationen. |
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
MaintenanceWindowOptions
Wartungsfensteroptionen.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Der Name der Ressource |
| properties.allowMultipleMaintenanceWindowsPerCycle |
boolean |
Gibt an, ob mehrere Wartungsfenster pro Zyklus zulässig sind. |
| properties.defaultDurationInMinutes |
integer (int32) |
Standarddauer für wartungsfenster. |
| properties.isEnabled |
boolean |
Gibt an, ob Wartungsfenster für die Datenbank aktiviert sind. |
| properties.maintenanceWindowCycles |
Verfügbare Wartungszyklen, z. B. {Samstag, 0, 4860}, {Mittwoch, 0, 2460}. |
|
| properties.minCycles |
integer (int32) |
Mindestanzahl der Wartungsfenster, die für die Datenbank festgelegt werden sollen. |
| properties.minDurationInMinutes |
integer (int32) |
Mindestdauer des Wartungsfensters. |
| properties.timeGranularityInMinutes |
integer (int32) |
Zeit granularität in Minuten für Wartungsfenster. |
| systemData |
Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten. |
|
| type |
string |
Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten" |
MaintenanceWindowTimeRange
Zeitbereich des Wartungsfensters.
| Name | Typ | Beschreibung |
|---|---|---|
| dayOfWeek |
Tag des Wartungsfensters. |
|
| duration |
string |
Dauer des Wartungsfensters in Minuten. |
| startTime |
string |
Die Startzeitminuten werden von 12:00 Uhr versetzt. |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |