Maintenance Window Options - Get
Obtient la liste des fenêtres de maintenance disponibles.
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}
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nom de la base de données. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
server
|
path | True |
string |
Le nom du serveur |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
|
maintenance
|
query | True |
string |
Nom des options de fenêtre de maintenance. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération Azure terminée avec succès. |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Gets a list of available maintenance windows for a selected database.
Exemple de requête
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
Exemple de réponse
{
"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
}
}
Définitions
| Nom | Description |
|---|---|
|
created |
Type d’identité qui a créé la ressource. |
|
Day |
Jour de la fenêtre de maintenance. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Maintenance |
Options de fenêtre de maintenance. |
|
Maintenance |
Intervalle de temps de la fenêtre de maintenance. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DayOfWeek
Jour de la fenêtre de maintenance.
| Valeur | Description |
|---|---|
| Sunday |
Dimanche |
| Monday |
Lundi |
| Tuesday |
Mardi |
| Wednesday |
Mercredi |
| Thursday |
Jeudi |
| Friday |
Vendredi |
| Saturday |
Samedi |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
| Nom | Type | Description |
|---|---|---|
| info |
object |
Informations supplémentaires. |
| type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
MaintenanceWindowOptions
Options de fenêtre de maintenance.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| name |
string |
Nom de la ressource |
| properties.allowMultipleMaintenanceWindowsPerCycle |
boolean |
Indique si nous autorisez plusieurs fenêtres de maintenance par cycle. |
| properties.defaultDurationInMinutes |
integer (int32) |
Durée par défaut de la fenêtre de maintenance. |
| properties.isEnabled |
boolean |
Indique si les fenêtres de maintenance sont activées pour la base de données. |
| properties.maintenanceWindowCycles |
Cycles de maintenance disponibles, par exemple {samedi, 0, 4860}, {mercredi, 0, 2460}. |
|
| properties.minCycles |
integer (int32) |
Nombre minimal de cycles de fenêtres de maintenance à définir sur la base de données. |
| properties.minDurationInMinutes |
integer (int32) |
Durée minimale de la fenêtre de maintenance. |
| properties.timeGranularityInMinutes |
integer (int32) |
Granularité de temps en minutes pour les fenêtres de maintenance. |
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
MaintenanceWindowTimeRange
Intervalle de temps de la fenêtre de maintenance.
| Nom | Type | Description |
|---|---|---|
| dayOfWeek |
Jour de la fenêtre de maintenance. |
|
| duration |
string |
Durée de la fenêtre de maintenance en minutes. |
| startTime |
string |
Décalage de l’heure de début de 12 heures. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |