Maintenance Windows - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

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?maintenanceWindowName={maintenanceWindowName}&api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données pour laquelle définir des fenêtres de maintenance.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.
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		Définissez correctement les paramètres des fenêtres de maintenance.
Other Status Codes		Réponses d’erreur : *** 400 InvalidMaintenanceWindowSelection - Sélection de fenêtre de maintenance non valide.

Exemples

Sets maintenance window settings for a selected database.

Sample Request

HTTP

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

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.MaintenanceWindowsInner;
import com.azure.resourcemanager.sql.models.DayOfWeek;
import com.azure.resourcemanager.sql.models.MaintenanceWindowTimeRange;
import java.util.Arrays;

/** Samples for MaintenanceWindowsOperation CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateMaintenanceWindows.json
     */
    /**
     * Sample code: Sets maintenance window settings for a selected database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        setsMaintenanceWindowSettingsForASelectedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getMaintenanceWindowsOperations().createOrUpdateWithResponse(
            "Default-SQL-SouthEastAsia", "testsvr", "testdwdb", "current",
            new MaintenanceWindowsInner().withTimeRanges(Arrays.asList(new MaintenanceWindowTimeRange()
                .withDayOfWeek(DayOfWeek.SATURDAY).withStartTime("00:00:00").withDuration("PT60M"))),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

Définitions

Nom	Description
DayOfWeek	Fenêtre jour de maintenance.
MaintenanceWindows	Fenêtres de maintenance.
MaintenanceWindowTimeRange	Intervalle de temps de la fenêtre de maintenance.

DayOfWeek

Fenêtre jour de maintenance.

Nom	Type	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

MaintenanceWindows

Fenêtres de maintenance.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.timeRanges	MaintenanceWindowTimeRange[]	Intervalle de temps de la fenêtre de maintenance.
type	string	Type de ressource.

MaintenanceWindowTimeRange

Intervalle de temps de la fenêtre de maintenance.

Nom	Type	Description
dayOfWeek	DayOfWeek	Fenêtre jour de maintenance.
duration	string	Durée de la fenêtre de maintenance en minutes.
startTime	string	Heure de début minutes décalées à partir de 12h00.