Start Stop Managed Instance Schedules - Create Or Update

Usługa:

SQL Database

Wersja interfejsu API:

2023-08-01

Tworzy lub aktualizuje harmonogram uruchamiania/zatrzymywania wystąpienia zarządzanego.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
managedInstanceName	path	True	string	Nazwa wystąpienia zarządzanego.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
startStopScheduleName	path	True	StartStopScheduleName	Nazwa harmonogramu uruchamiania/zatrzymywania wystąpienia zarządzanego.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.scheduleList	True	ScheduleItem[]	Lista harmonogramu.
properties.description		string	Opis harmonogramu.
properties.timeZoneId		string	Strefa czasowa harmonogramu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	StartStopManagedInstanceSchedule	Pomyślnie ustawiono harmonogram uruchamiania/zatrzymywania.
201 Created	StartStopManagedInstanceSchedule	Pomyślnie utworzono harmonogram uruchamiania/zatrzymywania.
Other Status Codes	ErrorResponse	Odpowiedzi na błędy: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — użytkownik próbował wykonać operację CRUD harmonogramu uruchamiania/zatrzymywania z nazwą harmonogramu inną niż "default" 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid — podany zestaw parametrów w treści żądania jest pusty lub nieprawidłowy. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid — podany parametr strefy czasowej jest nieprawidłowy. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid — podany harmonogram uruchamiania/zatrzymywania jest nieprawidłowy. Harmonogram nie zawiera żadnych elementów na liście harmonogramu lub niektóre elementy na liście mają nieprawidłowe wartości. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan — czas między dwoma kolejnymi akcjami jest krótszy niż 1 godzina. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature — użytkownik próbował użyć funkcji Uruchamiania/zatrzymywania bez zezwolenia na subskrypcję dla odpowiedniej funkcji subskrypcji. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU — zaplanowana operacja uruchamiania/zatrzymywania nie jest obsługiwana w danej jednostce SKU. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform — zatrzymaj wykonane na wystąpieniu, które nie jest uruchomione z funkcją Wave listopada 2022 r. 400 StartStopOfManagedInstanceIsDisabled — nie włączono operacji uruchamiania i zatrzymywania w wystąpieniu zarządzanym. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled — użytkownik próbował użyć zaplanowanej funkcji uruchamiania/zatrzymywania usługi Azure SQL Managed Instance, która jest wyłączona. 400 ManagementServiceStartStopManagedInstanceScheduleOverlap — nakładają się na pary harmonogramu. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — użytkownik próbował wykonać operację CRUD harmonogramu uruchamiania/zatrzymywania z nazwą harmonogramu inną niż "default" 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound — harmonogram nie istnieje dla danego wystąpienia zarządzanego. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation — próba utworzenia/aktualizacji/usunięcia harmonogramu uruchamiania/zatrzymywania w usłudze Azure SQL Managed Instance nie powiodła się. Harmonogram nie został utworzony lub nie można go zaktualizować/usunąć, ponieważ był zajęty bieżącą zaplanowaną operacją. Ponów próbę żądania później.

Przykłady

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.

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

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.

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

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

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
DayOfWeek	Dzień rozpoczęcia.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ScheduleItem	Informacje o harmonogramie opisujące, kiedy serwer powinien zostać uruchomiony lub zatrzymany.
StartStopManagedInstanceSchedule	Harmonogram uruchamiania/zatrzymywania wystąpienia zarządzanego.
StartStopScheduleName	Nazwa harmonogramu uruchamiania/zatrzymywania wystąpienia zarządzanego.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
Application
Key
ManagedIdentity
User

DayOfWeek

Wyliczanie

Dzień rozpoczęcia.

Wartość	Opis
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ScheduleItem

Objekt

Informacje o harmonogramie opisujące, kiedy serwer powinien zostać uruchomiony lub zatrzymany.

Nazwa	Typ	Opis
startDay	DayOfWeek	Dzień rozpoczęcia.
startTime	string	Godzina rozpoczęcia.
stopDay	DayOfWeek	Zatrzymaj dzień.
stopTime	string	Czas zatrzymania.

StartStopManagedInstanceSchedule

Objekt

Harmonogram uruchamiania/zatrzymywania wystąpienia zarządzanego.

Nazwa	Typ	Domyślna wartość	Opis
id	string		Identyfikator zasobu.
name	string		Nazwa zasobu.
properties.description	string		Opis harmonogramu.
properties.nextExecutionTime	string		Sygnatura czasowa wykonania następnej akcji w odpowiedniej strefie czasowej harmonogramu.
properties.nextRunAction	string		Następna akcja do wykonania (uruchamianie lub zatrzymywanie)
properties.scheduleList	ScheduleItem[]		Lista harmonogramu.
properties.timeZoneId	string	UTC	Strefa czasowa harmonogramu.
systemData	systemData		Dane systemowe zaplanowanego zasobu.
type	string		Typ zasobu.

StartStopScheduleName

Wyliczanie

Nazwa harmonogramu uruchamiania/zatrzymywania wystąpienia zarządzanego.

Wartość	Opis
default

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.