Maintenance Windows - Create Or Update

Définit les paramètres des fenêtres de maintenance pour une base de données.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/maintenanceWindows/current?api-version=2025-01-01&maintenanceWindowName={maintenanceWindowName}

Paramètres URI

Nom Dans Obligatoire Type Description
databaseName
path True

string

Nom de la base de données.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

serverName
path True

string

Le nom du serveur

subscriptionId
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.

maintenanceWindowName
query True

string

Nom de la fenêtre de maintenance.

Corps de la demande

Nom Type Description
properties.timeRanges

MaintenanceWindowTimeRange[]

Intervalle de temps de la fenêtre de maintenance.

Réponses

Nom Type Description
200 OK

La demande a réussi.

Other Status Codes

ErrorResponse

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

Sets maintenance window settings for a selected database.

Exemple de requête

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb/maintenanceWindows/current?api-version=2025-01-01&maintenanceWindowName=current

{
  "properties": {
    "timeRanges": [
      {
        "dayOfWeek": "Saturday",
        "duration": "PT60M",
        "startTime": "00:00:00"
      }
    ]
  }
}

Exemple de réponse

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

DayOfWeek

Jour de la fenêtre de maintenance.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

MaintenanceWindows

Fenêtres de maintenance.

MaintenanceWindowTimeRange

Intervalle de temps de la fenêtre de maintenance.

systemData

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

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

MaintenanceWindows

Fenêtres 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.timeRanges

MaintenanceWindowTimeRange[]

Intervalle de temps de la fenêtre de maintenance.

systemData

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

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

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

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.