Start Stop Managed Instance Schedules - Create Or Update

Referentie

Service:: SQL Database

API Version:: 2023-08-01-preview

Hiermee wordt het start-/stopschema van het beheerde exemplaar gemaakt of bijgewerkt.

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

URI-parameters

Name	In	Vereist	Type	Description
managedInstanceName	path	True	string	De naam van het beheerde exemplaar.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
startStopScheduleName	path	True	StartStopScheduleName	Naam van het start-/stopschema van het beheerde exemplaar.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Vereist	Type	Description
properties.scheduleList	True	ScheduleItem[]	Planningslijst.
properties.description		string	De beschrijving van de planning.
properties.timeZoneId		string	De tijdzone van de planning.

Antwoorden

Name	Type	Description
200 OK	StartStopManagedInstanceSchedule	Het start-/stopschema is ingesteld.
201 Created	StartStopManagedInstanceSchedule	Het start-/stopschema is gemaakt.
Other Status Codes	ErrorResponse	Foutreacties: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - Gebruiker heeft geprobeerd de CRUD-bewerking van het start-/stopschema uit te voeren met een andere planningsnaam dan 'standaard' 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - De opgegeven set parameters in de hoofdtekst van de aanvraag is leeg of ongeldig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - De opgegeven tijdzoneparameter is ongeldig. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - Het opgegeven start-/stopschema is ongeldig. De planning bevat geen items in de planningslijst of sommige items in de lijst hebben ongeldige waarden. 400 StartStopOfManagedInstanceIsDisabled - De bewerking starten en stoppen op het beheerde exemplaar is niet ingeschakeld. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - Gebruiker heeft geprobeerd de start-/stopfunctie te gebruiken zonder dat het abonnement is toegestaan voor de juiste abonnementsfunctie. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - Gebruiker heeft geprobeerd de geplande Azure SQL Managed Instance-functie starten/stoppen te gebruiken, die is uitgeschakeld. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - Geplande start-/stopbewerking wordt niet ondersteund op de opgegeven SKU. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Stop de uitvoering op het exemplaar dat niet wordt uitgevoerd met feature wave november 2022 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Overlap in schemaparen. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - De tijd tussen twee opeenvolgende acties is minder dan 1 uur. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - Gebruiker heeft geprobeerd de CRUD-bewerking van het start-/stopschema uit te voeren met een andere planningsnaam dan 'standaard' 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - Planning bestaat niet voor een bepaald beheerd exemplaar. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - De poging tot maken/bijwerken/verwijderen van de start-/stopplanning op de Azure SQL Managed Instance is mislukt. De planning is niet gemaakt of kan niet worden bijgewerkt/verwijderd omdat deze bezig was met een lopende geplande bewerking. Probeer uw aanvraag later opnieuw.

Name

Type

Description

200 OK

StartStopManagedInstanceSchedule

Het start-/stopschema is ingesteld.

201 Created

StartStopManagedInstanceSchedule

Het start-/stopschema is gemaakt.

Other Status Codes

ErrorResponse

Foutreacties: ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - Gebruiker heeft geprobeerd de CRUD-bewerking van het start-/stopschema uit te voeren met een andere planningsnaam dan 'standaard'
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - De opgegeven set parameters in de hoofdtekst van de aanvraag is leeg of ongeldig.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - De opgegeven tijdzoneparameter is ongeldig.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - Het opgegeven start-/stopschema is ongeldig. De planning bevat geen items in de planningslijst of sommige items in de lijst hebben ongeldige waarden.
400 StartStopOfManagedInstanceIsDisabled - De bewerking starten en stoppen op het beheerde exemplaar is niet ingeschakeld.
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - Gebruiker heeft geprobeerd de start-/stopfunctie te gebruiken zonder dat het abonnement is toegestaan voor de juiste abonnementsfunctie.
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - Gebruiker heeft geprobeerd de geplande Azure SQL Managed Instance-functie starten/stoppen te gebruiken, die is uitgeschakeld.
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - Geplande start-/stopbewerking wordt niet ondersteund op de opgegeven SKU.
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Stop de uitvoering op het exemplaar dat niet wordt uitgevoerd met feature wave november 2022
400 ManagementServiceStartStopManagedInstanceScheduleOverlap - Overlap in schemaparen.
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - De tijd tussen twee opeenvolgende acties is minder dan 1 uur.
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - Gebruiker heeft geprobeerd de CRUD-bewerking van het start-/stopschema uit te voeren met een andere planningsnaam dan 'standaard'
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.
404 ResourceNotFound - De aangevraagde resource is niet gevonden.
404 ManagementServiceStartStopManagedInstanceScheduleNotFound - Planning bestaat niet voor een bepaald beheerd exemplaar.
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - De poging tot maken/bijwerken/verwijderen van de start-/stopplanning op de Azure SQL Managed Instance is mislukt. De planning is niet gemaakt of kan niet worden bijgewerkt/verwijderd omdat deze bezig was met een lopende geplande bewerking. Probeer uw aanvraag later opnieuw.

Voorbeelden

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

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
DayOfWeek	Begindag.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ScheduleItem	Planningsgegevens die beschrijven wanneer de server moet worden gestart of gestopt.
StartStopManagedInstanceSchedule	Het start-/stopschema van het beheerde exemplaar.
StartStopScheduleName	Naam van het start-/stopschema van het beheerde exemplaar.
systemData	Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DayOfWeek

Begindag.

Name	Type	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ScheduleItem

Planningsgegevens die beschrijven wanneer de server moet worden gestart of gestopt.

Name	Type	Description
startDay	DayOfWeek	Begindag.
startTime	string	Begintijd.
stopDay	DayOfWeek	Stopdag.
stopTime	string	Stoptijd.

StartStopManagedInstanceSchedule

Het start-/stopschema van het beheerde exemplaar.

Name	Type	Standaardwaarde	Description
id	string		Resource-id.
name	string		Resourcenaam.
properties.description	string		De beschrijving van de planning.
properties.nextExecutionTime	string		Tijdstempel wanneer de volgende actie wordt uitgevoerd in de bijbehorende planningstijdzone.
properties.nextRunAction	string		Volgende actie die moet worden uitgevoerd (starten of stoppen)
properties.scheduleList	ScheduleItem[]		Planningslijst.
properties.timeZoneId	string	UTC	De tijdzone van de planning.
systemData	systemData		Systeemgegevens van de geplande resource.
type	string		Resourcetype.

StartStopScheduleName

Naam van het start-/stopschema van het beheerde exemplaar.

Name	Type	Description
default	string

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name	Type	Description
createdAt	string	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit die de resource heeft gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource het laatst heeft gewijzigd.

Start Stop Managed Instance Schedules - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Creates or updates the managed instance's Start/Stop schedule with all optional parameters specified.

Sample Request

Sample Response

Creates or updates the managed instance's Start/Stop schedule with no optional parameters specified.

Sample Request

Sample Response

Definities

createdByType

DayOfWeek

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ScheduleItem

StartStopManagedInstanceSchedule

StartStopScheduleName

systemData

Aanvullende resources