Start Stop Managed Instance Schedules - Create Or Update

Référence

Service:: SQL Database

API Version:: 2023-08-01-preview

Crée ou met à jour la planification start/stop de l’instance managée.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/startStopSchedules/default?api-version=2023-08-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
managedInstanceName	path	True	string	Nom de l'instance managée.
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.
startStopScheduleName	path	True	StartStopScheduleName	Nom de la planification de démarrage/d’arrêt de l’instance gérée.
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.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.scheduleList	True	ScheduleItem[]	Liste des planifications.
properties.description		string	Description de la planification.
properties.timeZoneId		string	Fuseau horaire de la planification.

Réponses

Nom	Type	Description
200 OK	StartStopManagedInstanceSchedule	Définissez correctement la planification Start/Stop.
201 Created	StartStopManagedInstanceSchedule	La planification Start/Stop a été créée.
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid : l’utilisateur a tenté d’effectuer l’opération CRUD de la planification Start/Stop avec un nom de planification différent de « default » 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid : l’ensemble de paramètres fourni dans le corps de la requête est vide ou non valide. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid : le paramètre de fuseau horaire fourni n’est pas valide. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid : la planification start/stop fournie n’est pas valide. La planification ne contient aucun élément dans la liste de planification ou certains des éléments de la liste ont des valeurs non valides. 400 StartStopOfManagedInstanceIsDisabled : démarrer et arrêter l’opération sur les instance managés n’est pas activé. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature : l’utilisateur a tenté d’utiliser la fonctionnalité Start/Stop sans avoir l’abonnement dans la liste verte pour la fonctionnalité d’abonnement appropriée. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled : l’utilisateur a tenté d’utiliser la fonctionnalité planifiée Start/Stop Azure SQL Managed Instance, qui est désactivée. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU : l’opération De démarrage/arrêt planifié n’est pas prise en charge sur la référence SKU donnée. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Arrêt de l’exécution sur le instance qui ne s’exécute pas avec Feature Wave Novembre 2022 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Chevauchement dans les paires de planification. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan : la durée entre deux actions successives est inférieure à 1 heure. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid : l’utilisateur a tenté d’effectuer l’opération CRUD de la planification Start/Stop avec un nom de planification différent de « default » 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 ResourceNotFound : la ressource demandée est introuvable. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - Schedule n’existe pas pour un instance managé donné. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation : la tentative de création/mise à jour/suppression de la planification Start/Stop sur le Azure SQL Managed Instance échoué. La planification n’a pas été créée ou n’a pas pu être mise à jour/supprimée, car elle était occupée par une opération planifiée en cours. Renouvelez votre demande à un moment ultérieur.

Nom

Type

Description

200 OK

StartStopManagedInstanceSchedule

Définissez correctement la planification Start/Stop.

201 Created

StartStopManagedInstanceSchedule

La planification Start/Stop a été créée.

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid : l’utilisateur a tenté d’effectuer l’opération CRUD de la planification Start/Stop avec un nom de planification différent de « default »
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid : l’ensemble de paramètres fourni dans le corps de la requête est vide ou non valide.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid : le paramètre de fuseau horaire fourni n’est pas valide.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid : la planification start/stop fournie n’est pas valide. La planification ne contient aucun élément dans la liste de planification ou certains des éléments de la liste ont des valeurs non valides.
400 StartStopOfManagedInstanceIsDisabled : démarrer et arrêter l’opération sur les instance managés n’est pas activé.
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature : l’utilisateur a tenté d’utiliser la fonctionnalité Start/Stop sans avoir l’abonnement dans la liste verte pour la fonctionnalité d’abonnement appropriée.
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled : l’utilisateur a tenté d’utiliser la fonctionnalité planifiée Start/Stop Azure SQL Managed Instance, qui est désactivée.
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU : l’opération De démarrage/arrêt planifié n’est pas prise en charge sur la référence SKU donnée.
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Arrêt de l’exécution sur le instance qui ne s’exécute pas avec Feature Wave Novembre 2022
400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Chevauchement dans les paires de planification.
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan : la durée entre deux actions successives est inférieure à 1 heure.
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid : l’utilisateur a tenté d’effectuer l’opération CRUD de la planification Start/Stop avec un nom de planification différent de « default »
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 ResourceNotFound : la ressource demandée est introuvable.
404 ManagementServiceStartStopManagedInstanceScheduleNotFound - Schedule n’existe pas pour un instance managé donné.
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation : la tentative de création/mise à jour/suppression de la planification Start/Stop sur le Azure SQL Managed Instance échoué. La planification n’a pas été créée ou n’a pas pu être mise à jour/supprimée, car elle était occupée par une opération planifiée en cours. Renouvelez votre demande à un moment ultérieur.

Exemples

Creates or updates the managed instance's Start/Stop schedule with all optional parameters specified.

Creates or updates the managed instance's Start/Stop schedule with no optional parameters specified.

Creates or updates the managed instance's Start/Stop schedule with all optional parameters specified.

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default?api-version=2023-08-01-preview

{
  "properties": {
    "timeZoneId": "Central European Standard Time",
    "description": "This is a schedule for our Dev/Test environment.",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "18:00",
        "stopDay": "Thursday",
        "stopTime": "17:00"
      },
      {
        "startDay": "Thursday",
        "startTime": "15:00",
        "stopDay": "Thursday",
        "stopTime": "14:00"
      }
    ]
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default",
  "name": "default",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2021-08-26T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-27T04:41:33.937Z"
  },
  "properties": {
    "description": "This is a schedule for our Dev/Test environment.",
    "nextExecutionTime": "2021-08-26T14:00:00",
    "nextRunAction": "Stop",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "06:00 PM",
        "stopDay": "Thursday",
        "stopTime": "05:00 PM"
      },
      {
        "startDay": "Thursday",
        "startTime": "03:00 PM",
        "stopDay": "Thursday",
        "stopTime": "02:00 PM"
      }
    ],
    "timeZoneId": "Central European Standard Time"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default",
  "name": "default",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2021-08-26T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-26T04:41:33.937Z"
  },
  "properties": {
    "description": "This is a schedule for our Dev/Test environment.",
    "nextExecutionTime": "2021-08-26T14:00:00",
    "nextRunAction": "Stop",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "06:00 PM",
        "stopDay": "Thursday",
        "stopTime": "05:00 PM"
      },
      {
        "startDay": "Thursday",
        "startTime": "03:00 PM",
        "stopDay": "Thursday",
        "stopTime": "02:00 PM"
      }
    ],
    "timeZoneId": "Central European Standard Time"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}

Creates or updates the managed instance's Start/Stop schedule with no optional parameters specified.

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default?api-version=2023-08-01-preview

{
  "properties": {
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "18:00",
        "stopDay": "Thursday",
        "stopTime": "17:00"
      },
      {
        "startDay": "Thursday",
        "startTime": "15:00",
        "stopDay": "Thursday",
        "stopTime": "14:00"
      }
    ]
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default",
  "name": "default",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2021-08-26T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-27T04:41:33.937Z"
  },
  "properties": {
    "description": "",
    "nextExecutionTime": "2021-08-26T14:00:00",
    "nextRunAction": "Stop",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "06:00 PM",
        "stopDay": "Thursday",
        "stopTime": "05:00 PM"
      },
      {
        "startDay": "Thursday",
        "startTime": "03:00 PM",
        "stopDay": "Thursday",
        "stopTime": "02:00 PM"
      }
    ],
    "timeZoneId": "UTC"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default",
  "name": "default",
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2021-08-26T04:41:33.937Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-26T04:41:33.937Z"
  },
  "properties": {
    "description": "",
    "nextExecutionTime": "2021-08-26T14:00:00",
    "nextRunAction": "Stop",
    "scheduleList": [
      {
        "startDay": "Thursday",
        "startTime": "06:00 PM",
        "stopDay": "Thursday",
        "stopTime": "05:00 PM"
      },
      {
        "startDay": "Thursday",
        "startTime": "03:00 PM",
        "stopDay": "Thursday",
        "stopTime": "02:00 PM"
      }
    ],
    "timeZoneId": "UTC"
  },
  "type": "Microsoft.Sql/managedInstances/startStopSchedules"
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
DayOfWeek	Jour de début.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ScheduleItem	Planifier des informations décrivant quand le serveur doit être démarré ou arrêté.
StartStopManagedInstanceSchedule	Planification de démarrage/d’arrêt des instance managés.
StartStopScheduleName	Nom de la planification de démarrage/d’arrêt de l’instance gérée.
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.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DayOfWeek

Jour de début.

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

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émentaires.

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

ScheduleItem

Planifier des informations décrivant quand le serveur doit être démarré ou arrêté.

Nom	Type	Description
startDay	DayOfWeek	Jour de début.
startTime	string	Heure de début
stopDay	DayOfWeek	Arrêtez la journée.
stopTime	string	Arrêtez le temps.

StartStopManagedInstanceSchedule

Planification de démarrage/d’arrêt des instance managés.

Nom	Type	Valeur par défaut	Description
id	string		ID de la ressource
name	string		Nom de la ressource.
properties.description	string		Description de la planification.
properties.nextExecutionTime	string		Horodatage de l’exécution de l’action suivante dans le fuseau horaire de planification correspondant.
properties.nextRunAction	string		Action suivante à exécuter (Démarrer ou Arrêter)
properties.scheduleList	ScheduleItem[]		Liste des planifications.
properties.timeZoneId	string	UTC	Fuseau horaire de la planification.
systemData	systemData		Données système de la ressource planifiée.
type	string		Type de ressource.

StartStopScheduleName

Nom de la planification de démarrage/d’arrêt de l’instance gérée.

Nom	Type	Description
default	string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	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	Horodatage de la dernière modification de la 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.

Start Stop Managed Instance Schedules - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Creates or updates the managed instance's Start/Stop schedule with all optional parameters specified.

Sample Request

Sample Response

Creates or updates the managed instance's Start/Stop schedule with no optional parameters specified.

Sample Request

Sample Response

Définitions

createdByType

DayOfWeek

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ScheduleItem

StartStopManagedInstanceSchedule

StartStopScheduleName

systemData

Ressources supplémentaires