Start Stop Managed Instance Schedules - Create Or Update

Service:

SQL Database

API Version:

2023-08-01-preview

Crea o aggiorna la pianificazione di avvio/arresto dell'istanza gestita.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
managedInstanceName	path	True	string	Nome dell'istanza gestita.
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
startStopScheduleName	path	True	StartStopScheduleName	Nome della pianificazione di avvio/arresto dell'istanza gestita.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.scheduleList	True	ScheduleItem[]	Elenco pianificazioni.
properties.description		string	Descrizione della pianificazione.
properties.timeZoneId		string	Fuso orario della pianificazione.

Risposte

Nome	Tipo	Descrizione
200 OK	StartStopManagedInstanceSchedule	Impostare correttamente la pianificazione di avvio/arresto.
201 Created	StartStopManagedInstanceSchedule	Creazione della pianificazione di avvio/arresto completata.
Other Status Codes	ErrorResponse	Risposte di errore: 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - L'utente ha tentato di eseguire l'operazione CRUD della pianificazione di avvio/arresto con un nome di pianificazione diverso da 'default' 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid: il set specificato di parametri nel corpo della richiesta è vuoto o non valido. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid: il parametro del fuso orario specificato non è valido. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid: la pianificazione di avvio/arresto specificata non è valida. La pianificazione non contiene elementi nell'elenco di pianificazione o alcuni elementi dell'elenco hanno valori non validi. 400 StartStopOfManagedInstanceIsDisabled - L'operazione di avvio e arresto nell'istanza gestita non è abilitata. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - L'utente ha tentato di usare la funzionalità Start/Stop senza che la sottoscrizione sia stata consentita per la funzionalità di sottoscrizione appropriata. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled: l'utente ha tentato di usare la funzionalità di Istanza gestita di SQL di Azure di avvio/arresto pianificata, disabilitata. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - L'operazione di avvio/arresto pianificata non è supportata nello SKU specificato. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Arresto eseguito nell'istanza non in esecuzione con Feature Wave novembre 2022 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Sovrapposizione nelle coppie di pianificazione. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan: il tempo tra due azioni successive è inferiore a 1 ora. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - L'utente ha tentato di eseguire l'operazione CRUD della pianificazione di avvio/arresto con un nome di pianificazione diverso da 'default' 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ResourceNotFound: la risorsa richiesta non è stata trovata. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound: la pianificazione non esiste per una determinata istanza gestita. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation : operazione di creazione/aggiornamento/eliminazione tentata di avvio/arresto nella Istanza gestita di SQL di Azure non riuscita. La pianificazione non è stata creata o non è stata aggiornata o eliminata perché è stata occupata con un'operazione pianificata in corso. Riprovare la richiesta più tardi.

Esempio

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

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
DayOfWeek	Giorno di inizio.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ScheduleItem	Pianificare le informazioni che descrivono quando il server deve essere avviato o arrestato.
StartStopManagedInstanceSchedule	Pianificazione di avvio/arresto dell'istanza gestita.
StartStopScheduleName	Nome della pianificazione di avvio/arresto dell'istanza gestita.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

DayOfWeek

Giorno di inizio.

Nome	Tipo	Descrizione
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ScheduleItem

Pianificare le informazioni che descrivono quando il server deve essere avviato o arrestato.

Nome	Tipo	Descrizione
startDay	DayOfWeek	Giorno di inizio.
startTime	string	Ora di inizio.
stopDay	DayOfWeek	Stop day.
stopTime	string	Ora di arresto.

StartStopManagedInstanceSchedule

Pianificazione di avvio/arresto dell'istanza gestita.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa.
name	string		Nome risorsa.
properties.description	string		Descrizione della pianificazione.
properties.nextExecutionTime	string		Timestamp quando l'azione successiva verrà eseguita nel fuso orario di pianificazione corrispondente.
properties.nextRunAction	string		Azione successiva da eseguire (Avvia o Arresta)
properties.scheduleList	ScheduleItem[]		Elenco pianificazioni.
properties.timeZoneId	string	UTC	Fuso orario della pianificazione.
systemData	systemData		Dati di sistema della risorsa pianificata.
type	string		Tipo di risorsa.

StartStopScheduleName

Nome della pianificazione di avvio/arresto dell'istanza gestita.

Nome	Tipo	Descrizione
default	string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.