Start Stop Managed Instance Schedules - Create Or Update

  • Odwołanie
Service:
SQL Database
API Version:
2023-08-01-preview

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-preview

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 Resource Manager platformy Azure 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 harmonogramów.
properties.description

string

Opis harmonogramu.
properties.timeZoneId

string

Strefa czasowa harmonogramu.

Odpowiedzi

Nazwa Typ Opis
200 OK

StartStopManagedInstanceSchedule

Pomyślnie ustaw 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 StartStopOfManagedInstanceIsDisabled — nie włączono operacji uruchamiania i zatrzymywania w wystąpieniu zarządzanym.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature — użytkownik próbował użyć funkcji Uruchamiania/zatrzymywania bez zezwolenia na subskrypcję dla odpowiedniej funkcji subskrypcji.

  • 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled — użytkownik próbował użyć zaplanowanej funkcji uruchamiania/zatrzymywania Azure SQL Managed Instance, która jest wyłączona.

  • 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU — zaplanowana operacja uruchamiania/zatrzymywania nie jest obsługiwana w danej jednostce SKU.

  • 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform — zatrzymaj wykonywane na wystąpieniu, które nie jest uruchomione z funkcją Wave listopada 2022 r.

  • 400 ManagementServiceStartStopManagedInstanceScheduleOverlap — nakładają się na pary harmonogramu.

  • 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan — czas między dwiema kolejnymi akcjami wynosi mniej niż 1 godzinę.

  • 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — użytkownik próbował wykonać operację CRUD harmonogramu uruchamiania/zatrzymywania z nazwą harmonogramu inną niż "default"

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 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 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 żądanie 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.

Sample Request

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

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

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

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

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

DayOfWeek

Dzień rozpoczęcia.

Nazwa Typ Opis
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

ErrorAdditionalInfo

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.
type

string

Dodatkowy typ informacji.

ErrorDetail

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

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

ScheduleItem

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

Dzień zatrzymania.
stopTime

string

Czas zatrzymania.

StartStopManagedInstanceSchedule

Harmonogram uruchamiania/zatrzymywania wystąpienia zarządzanego.

Nazwa Typ Wartość domyślna Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu.
properties.description

string

Opis harmonogramu.
properties.nextExecutionTime

string

Sygnatura czasowa po wykonaniu następnej akcji w odpowiedniej strefie czasowej harmonogramu.
properties.nextRunAction

string

Następna akcja do wykonania (uruchamianie lub zatrzymywanie)
properties.scheduleList

ScheduleItem[]

Lista harmonogramów.
properties.timeZoneId

string

UTC

Strefa czasowa harmonogramu.
systemData

systemData

Dane systemowe zaplanowanego zasobu.
type

string

Typ zasobu.

StartStopScheduleName

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

Nazwa Typ Opis
default

string

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

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

Sygnatura czasowa 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.