Partager via


Start Stop Managed Instance Schedules - Create Or Update

Crée ou met à jour la planification de démarrage/d’arrêt 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

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 start/stop de l’instance managée.

subscriptionId
path True

string

ID d’abonnement qui identifie 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 Démarrer/Arrêter.

201 Created

StartStopManagedInstanceSchedule

Création réussie de la planification Start/Stop.

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 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan : l’heure entre deux actions successives est inférieure à 1 heure.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - L’utilisateur a tenté d’utiliser la fonctionnalité Start/Stop sans avoir l’abonnement autorisé pour la fonctionnalité d’abonnement appropriée.

  • 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - L’opération de démarrage/arrêt planifiée n’est pas prise en charge sur la référence SKU donnée.

  • 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Arrêter l’exécution sur l’instance qui n’est pas en cours d’exécution avec Feature Wave novembre 2022

  • 400 StartStopOfManagedInstanceIsDisabled : l’opération de démarrage et d’arrêt sur l’instance managée n’est pas activée.

  • 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled : l’utilisateur a tenté d’utiliser la fonctionnalité Start/Stop Azure SQL Managed Instance planifiée, qui est désactivée.

  • 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Chevauchement dans les paires de planifications.

  • 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 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable

  • 404 ResourceNotFound : la ressource demandée est introuvable.

  • 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - La planification n’existe pas pour une instance managée donnée.

  • 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation : l’opération de création/mise à jour/suppression de l’opération Start/Stop sur Azure SQL Managed Instance a échoué. La planification n’a pas été créée ou n’a pas pu être mise à jour/supprimée, car elle était occupée avec une opération planifiée en cours. Réessayez votre demande ultérieurement.

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.

Exemple de requête

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

{
  "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"
      }
    ]
  }
}

Exemple de réponse

{
  "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"
}
{
  "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.

Exemple de requête

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

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

Exemple de réponse

{
  "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"
}
{
  "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

Début de la journée.

ErrorAdditionalInfo

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

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ScheduleItem

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

StartStopManagedInstanceSchedule

Planification de démarrage/arrêt de l’instance managée.

StartStopScheduleName

Nom de la planification start/stop de l’instance managé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.

Valeur Description
User
Application
ManagedIdentity
Key

DayOfWeek

Début de la journée.

Valeur Description
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

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.

ScheduleItem

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

Nom Type Description
startDay

DayOfWeek

Début de la journée.

startTime

string

Heure de début.

stopDay

DayOfWeek

Arrêtez la journée.

stopTime

string

Arrêtez l’heure.

StartStopManagedInstanceSchedule

Planification de démarrage/arrêt de l’instance managée.

Nom Type Valeur par défaut Description
id

string

ID de ressource.

name

string

Nom de la ressource.

properties.description

string

Description de la planification.

properties.nextExecutionTime

string

Horodatage lorsque l’action suivante sera exécutée 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 start/stop de l’instance managée.

Valeur Description
default

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.