你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
startStopScheduleName	path	True	StartStopScheduleName	托管实例启动/停止计划的名称。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
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 - 用户尝试使用不同于“default”的计划名称执行启动/停止计划的 CRUD 操作 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - 请求正文中提供的参数集为空或无效。 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - 提供的时区参数无效。 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - 提供的启动/停止计划无效。计划中不包含任何项目，或者列表中的某些项具有无效值。 400 StartStopOfManagedInstanceIsDisabled - 未启用托管实例上的启动和停止操作。 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - 用户尝试使用启动/停止功能，但未将订阅列入相应订阅功能的允许列表。 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - 用户尝试使用已禁用的计划启动/停止Azure SQL 托管实例功能。 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 给定 SKU 不支持计划的启动/停止操作。 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 停止在未使用 Feature Wave 2022 年 11 月运行的实例上执行 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - 在计划对中重叠。 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 两个连续操作之间的时间小于 1 小时。 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 用户尝试使用不同于“default”的计划名称执行启动/停止计划的 CRUD 操作 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 ResourceNotFound - 找不到请求的资源。 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 给定托管实例不存在计划。 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - 尝试创建/更新/删除Azure SQL 托管实例上的启动/停止计划的创建/更新/删除操作失败。计划要么未创建，要么无法更新/删除，因为它正忙于正在进行的计划操作。请稍后重试请求。

名称

类型

说明

200 OK

StartStopManagedInstanceSchedule

成功设置启动/停止计划。

201 Created

StartStopManagedInstanceSchedule

已成功创建启动/停止计划。

Other Status Codes

ErrorResponse

错误响应：***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 用户尝试使用不同于“default”的计划名称执行启动/停止计划的 CRUD 操作
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - 请求正文中提供的参数集为空或无效。
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - 提供的时区参数无效。
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - 提供的启动/停止计划无效。计划中不包含任何项目，或者列表中的某些项具有无效值。
400 StartStopOfManagedInstanceIsDisabled - 未启用托管实例上的启动和停止操作。
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - 用户尝试使用启动/停止功能，但未将订阅列入相应订阅功能的允许列表。
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - 用户尝试使用已禁用的计划启动/停止Azure SQL 托管实例功能。
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 给定 SKU 不支持计划的启动/停止操作。
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 停止在未使用 Feature Wave 2022 年 11 月运行的实例上执行
400 ManagementServiceStartStopManagedInstanceScheduleOverlap - 在计划对中重叠。
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 两个连续操作之间的时间小于 1 小时。
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 用户尝试使用不同于“default”的计划名称执行启动/停止计划的 CRUD 操作
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。
404 ResourceNotFound - 找不到请求的资源。
404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 给定托管实例不存在计划。
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - 尝试创建/更新/删除Azure SQL 托管实例上的启动/停止计划的创建/更新/删除操作失败。计划要么未创建，要么无法更新/删除，因为它正忙于正在进行的计划操作。请稍后重试请求。

示例

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		资源 ID。
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

其他资源