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 Managed Instance機能を使用しようとしましたが、無効になっています。 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 指定された SKU でスケジュールされた開始/停止操作はサポートされていません。 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Feature Wave 2022 年 11 月に実行されていないインスタンスで実行を停止する 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - スケジュールペアで重複します。 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 2 つの連続するアクション間の時間が 1 時間未満です。 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - ユーザーが 'default' とは異なるスケジュール名で開始/停止スケジュールの CRUD 操作を実行しようとしました 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 特定のマネージドインスタンスに対してスケジュールが存在しません。 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - Azure SQL Managed Instanceの開始/停止スケジュールの作成/更新/削除操作が失敗しました。スケジュールは作成されなかったか、進行中のスケジュールされた操作でビジー状態であったため、更新または削除できませんでした。後で要求を再試行してください。

名前

型

説明

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 Managed Instance機能を使用しようとしましたが、無効になっています。
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 指定された SKU でスケジュールされた開始/停止操作はサポートされていません。
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Feature Wave 2022 年 11 月に実行されていないインスタンスで実行を停止する
400 ManagementServiceStartStopManagedInstanceScheduleOverlap - スケジュールペアで重複します。
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 2 つの連続するアクション間の時間が 1 時間未満です。
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - ユーザーが 'default' とは異なるスケジュール名で開始/停止スケジュールの CRUD 操作を実行しようとしました
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。
404 ResourceNotFound - 要求されたリソースが見つかりませんでした。
404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 特定のマネージドインスタンスに対してスケジュールが存在しません。
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - Azure SQL Managed Instanceの開始/停止スケジュールの作成/更新/削除操作が失敗しました。スケジュールは作成されなかったか、進行中のスケジュールされた操作でビジー状態であったため、更新または削除できませんでした。後で要求を再試行してください。

例

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	リソースを作成した ID の種類。
DayOfWeek	開始日。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ScheduleItem	サーバーを起動または停止するタイミングを説明するスケジュール情報。
StartStopManagedInstanceSchedule	マネージドインスタンスの開始/停止スケジュール。
StartStopScheduleName	マネージドインスタンスの開始/停止スケジュールの名前。
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

リソースを作成した ID の種類。

名前	型	説明
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	error オブジェクト。

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	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

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

その他のリソース