Start Stop Managed Instance Schedules - Create Or Update

Tjänst:

SQL Database

API-version:

2023-08-01

Skapar eller uppdaterar den hanterade instansens start-/stoppschema.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
startStopScheduleName	path	True	StartStopScheduleName	Namnet på start-/stoppschemat för den hanterade instansen.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.scheduleList	True	ScheduleItem[]	Schemalista.
properties.description		string	Beskrivningen av schemat.
properties.timeZoneId		string	Schemats tidszon.

Svar

Name	Typ	Description
200 OK	StartStopManagedInstanceSchedule	Ställ in start-/stoppschemat.
201 Created	StartStopManagedInstanceSchedule	Start-/stoppschemat har skapats.
Other Status Codes	ErrorResponse	Felsvar: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid – Användaren försökte utföra CRUD-driften av start-/stoppschemat med ett annat schemanamn än "standard" 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid – Den angivna uppsättningen parametrar i brödtexten i begäran är antingen tom eller ogiltig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid – den angivna tidszonsparametern är ogiltig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid – det angivna start-/stoppschemat är ogiltigt. Schemat innehåller antingen inga objekt i schemalistan eller så har vissa av objekten i listan ogiltiga värden. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan – Tiden mellan två efterföljande åtgärder är mindre än 1 timme. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature – Användaren försökte använda start-/stoppfunktionen utan att ha prenumerationen tillåten för lämplig prenumerationsfunktion. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU – schemalagd start-/stoppåtgärd stöds inte på den angivna SKU:n. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Stoppa körs på den instans som inte körs med Feature Wave november 2022 400 StartStopOfManagedInstanceIsDisabled – Start- och stoppåtgärden på den hanterade instansen är inte aktiverad. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled – Användaren försökte använda den schemalagda funktionen Start/Stop Azure SQL Managed Instance, som är inaktiverad. 400 ManagementServiceStartStopManagedInstanceScheduleOverlap – Överlappning i schemapar. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid – Användaren försökte utföra CRUD-driften av start-/stoppschemat med ett annat schemanamn än "standard" 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ResourceNotFound – Den begärda resursen hittades inte. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound – Schemat finns inte för en viss hanterad instans. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation – Det gick inte att skapa/uppdatera/ta bort start-/stoppschemat i Azure SQL Managed Instance. Schemat skapades inte eller kunde inte uppdateras/tas bort eftersom det var upptaget med en pågående schemalagd åtgärd. Försök igen senare.

Exempel

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.

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Statuskod:

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.

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Statuskod:

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

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
DayOfWeek	Startdag.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ScheduleItem	Schemalägg information som beskriver när servern ska startas eller stoppas.
StartStopManagedInstanceSchedule	Start-/stoppschema för den hanterade instansen.
StartStopScheduleName	Namnet på start-/stoppschemat för den hanterade instansen.
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

DayOfWeek

Uppräkning

Startdag.

Värde	Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ScheduleItem

Objekt

Schemalägg information som beskriver när servern ska startas eller stoppas.

Name	Typ	Description
startDay	DayOfWeek	Startdag.
startTime	string	Starttid.
stopDay	DayOfWeek	Stoppa dagen.
stopTime	string	Stopptid.

StartStopManagedInstanceSchedule

Objekt

Start-/stoppschema för den hanterade instansen.

Name	Typ	Standardvärde	Description
id	string		Resurs-ID.
name	string		Resursnamn.
properties.description	string		Beskrivningen av schemat.
properties.nextExecutionTime	string		Tidsstämpel när nästa åtgärd körs i motsvarande tidszon för schemat.
properties.nextRunAction	string		Nästa åtgärd som ska köras (Start eller Stopp)
properties.scheduleList	ScheduleItem[]		Schemalista.
properties.timeZoneId	string	UTC	Schemats tidszon.
systemData	systemData		Systemdata för den schemalagda resursen.
type	string		Resurstyp.

StartStopScheduleName

Uppräkning

Namnet på start-/stoppschemat för den hanterade instansen.

Värde	Description
default

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.