Start Stop Managed Instance Schedules - Create Or Update

Ссылка

Service:: SQL Database

API Version:: 2023-08-01-preview

Создает или обновляет расписание запуска и остановки управляемого экземпляра.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
managedInstanceName	path	True	string	Имя управляемого экземпляра.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
startStopScheduleName	path	True	StartStopScheduleName	Имя расписания запуска и остановки управляемого экземпляра.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Обязательно	Тип	Описание
properties.scheduleList	True	ScheduleItem[]	Список расписаний.
properties.description		string	Описание расписания.
properties.timeZoneId		string	Часовой пояс расписания.

Ответы

Имя	Тип	Описание
200 OK	StartStopManagedInstanceSchedule	Расписание запуска и остановки успешно задано.
201 Created	StartStopManagedInstanceSchedule	Расписание запуска и остановки успешно создано.
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — пользователь попытался выполнить операцию CRUD по расписанию запуска и остановки с именем расписания, отличным от "default" 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid — предоставленный набор параметров в тексте запроса является пустым или недопустимым. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid — указанный параметр часового пояса недопустим. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid — предоставленное расписание начала и остановки является недопустимым. Расписание либо не содержит элементов в списке расписаний, либо некоторые элементы в списке имеют недопустимые значения. 400 StartStopOfManagedInstanceIsDisabled — операция запуска и остановки в управляемом экземпляре не включена. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature — пользователь попытался использовать функцию запуска и остановки без наличия списка разрешенных подписок для соответствующей функции подписки. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled — пользователь попытался использовать функцию запланированного запуска и остановки Управляемый экземпляр SQL Azure, которая отключена. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU — запланированная операция запуска и остановки не поддерживается для заданного номера SKU. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform — остановка выполнения на экземпляре, который не запущен с помощью волны компонентов за ноябрь 2022 г. 400 ManagementServiceStartStopManagedInstanceScheduleOverlap — перекрытие в парах расписания. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan — время между двумя последовательными действиями составляет менее 1 часа. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — пользователь пытался выполнить операцию CRUD по расписанию запуска и остановки с именем расписания, отличным от default. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ResourceNotFound — запрошенный ресурс не найден. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound — расписание не существует для данного управляемого экземпляра. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation — попытка создания, обновления и удаления расписания запуска и остановки в Управляемый экземпляр SQL Azure завершилась сбоем. Расписание не было создано или не удалось обновить или удалить, так как оно было занято текущей запланированной операцией. Повторите попытку запроса позже.

Имя

Тип

Описание

200 OK

StartStopManagedInstanceSchedule

Расписание запуска и остановки успешно задано.

201 Created

StartStopManagedInstanceSchedule

Расписание запуска и остановки успешно создано.

Other Status Codes

ErrorResponse

Ответы на ошибки: ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — пользователь попытался выполнить операцию CRUD по расписанию запуска и остановки с именем расписания, отличным от "default"
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid — предоставленный набор параметров в тексте запроса является пустым или недопустимым.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid — указанный параметр часового пояса недопустим.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid — предоставленное расписание начала и остановки является недопустимым. Расписание либо не содержит элементов в списке расписаний, либо некоторые элементы в списке имеют недопустимые значения.
400 StartStopOfManagedInstanceIsDisabled — операция запуска и остановки в управляемом экземпляре не включена.
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature — пользователь попытался использовать функцию запуска и остановки без наличия списка разрешенных подписок для соответствующей функции подписки.
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled — пользователь попытался использовать функцию запланированного запуска и остановки Управляемый экземпляр SQL Azure, которая отключена.
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU — запланированная операция запуска и остановки не поддерживается для заданного номера SKU.
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform — остановка выполнения на экземпляре, который не запущен с помощью волны компонентов за ноябрь 2022 г.
400 ManagementServiceStartStopManagedInstanceScheduleOverlap — перекрытие в парах расписания.
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan — время между двумя последовательными действиями составляет менее 1 часа.
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid — пользователь пытался выполнить операцию CRUD по расписанию запуска и остановки с именем расписания, отличным от default.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.
404 ResourceNotFound — запрошенный ресурс не найден.
404 ManagementServiceStartStopManagedInstanceScheduleNotFound — расписание не существует для данного управляемого экземпляра.
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation — попытка создания, обновления и удаления расписания запуска и остановки в Управляемый экземпляр SQL Azure завершилась сбоем. Расписание не было создано или не удалось обновить или удалить, так как оно было занято текущей запланированной операцией. Повторите попытку запроса позже.

Примеры

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

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
DayOfWeek	День начала.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
ScheduleItem	Сведения о планировании, описывающие время запуска или остановки сервера.
StartStopManagedInstanceSchedule	Расписание запуска и остановки управляемого экземпляра.
StartStopScheduleName	Имя расписания запуска и остановки управляемого экземпляра.
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

DayOfWeek

День начала.

Имя	Тип	Описание
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ScheduleItem

Сведения о планировании, описывающие время запуска или остановки сервера.

Имя	Тип	Описание
startDay	DayOfWeek	День начала.
startTime	string	Время начала.
stopDay	DayOfWeek	Стоп день.
stopTime	string	Время остановки.

StartStopManagedInstanceSchedule

Расписание запуска и остановки управляемого экземпляра.

Имя	Тип	Значение по умолчанию	Описание
id	string		Идентификатор ресурса.
name	string		Имя ресурса.
properties.description	string		Описание расписания.
properties.nextExecutionTime	string		Метка времени выполнения следующего действия в соответствующем часовом поясе расписания.
properties.nextRunAction	string		Следующее выполняеме действие (запуск или остановка)
properties.scheduleList	ScheduleItem[]		Список расписаний.
properties.timeZoneId	string	UTC	Часовой пояс расписания.
systemData	systemData		Системные данные запланированного ресурса.
type	string		Тип ресурса.

StartStopScheduleName

Имя расписания запуска и остановки управляемого экземпляра.

Имя	Тип	Описание
default	string

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое в последний раз изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, изменяющего ресурс в последний раз.

Share via

Start Stop Managed Instance Schedules - Create Or Update

Параметры URI

Текст запроса

Ответы

Примеры

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

Определения

createdByType

DayOfWeek

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ScheduleItem

StartStopManagedInstanceSchedule

StartStopScheduleName

systemData

Дополнительные ресурсы