Start Stop Managed Instance Schedules - Get

參考

服務:: SQL Database

API 版本:: 2024-05-01-preview

取得受控實例的啟動/停止排程。

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

URI 參數

名稱	位於	必要	類型	Description
managedInstanceName	path	True	string	受控實例的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure Resource Manager API 或入口網站取得此值。
startStopScheduleName	path	True	StartStopScheduleName	受控實例的啟動/停止排程名稱。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。

回應

名稱	類型	Description
200 OK	StartStopManagedInstanceSchedule	已成功擷取開始/停止排程。
Other Status Codes	ErrorResponse	錯誤回應： *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 使用者嘗試執行 Start/Stop 排程的 CRUD 作業，其排程名稱與 'default' 不同 400 StartStopOfManagedInstanceIsDisabled - 未啟用受控實例上的啟動和停止作業。 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - 使用者嘗試使用啟動/停止功能，而不需針對適當的訂用帳戶功能列出訂用帳戶允許清單。 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - 用戶嘗試使用已停用的已排程啟動/停止 Azure SQL 受控實例功能。指定的 SKU 不支援 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 排程的啟動/停止作業。 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 停止在未使用 Feature Wave 2022 年 11 月執行的實例上執行 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - 排程配對重疊。 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 兩個連續動作之間的時間小於 1 小時。 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - 要求主體中提供的一組參數是空的或無效的。 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - 提供的時區參數無效。 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - 提供的啟動/停止排程無效。排程不包含排程清單中的專案，或清單中的某些專案具有無效的值。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ResourceNotFound - 找不到要求的資源。 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 指定受控實例的排程不存在。 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 使用者嘗試執行 Start/Stop 排程的 CRUD 作業，其排程名稱與 'default' 不同 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - 嘗試在 Azure SQL 受控實例上建立/更新/刪除排程的啟動/停止排程作業失敗。排程未建立或無法更新/刪除，因為它正忙於進行中的排程作業。請稍後再重試您的要求。

名稱

類型

Description

200 OK

StartStopManagedInstanceSchedule

已成功擷取開始/停止排程。

Other Status Codes

ErrorResponse

錯誤回應： ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 使用者嘗試執行 Start/Stop 排程的 CRUD 作業，其排程名稱與 'default' 不同
400 StartStopOfManagedInstanceIsDisabled - 未啟用受控實例上的啟動和停止作業。
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - 使用者嘗試使用啟動/停止功能，而不需針對適當的訂用帳戶功能列出訂用帳戶允許清單。
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - 用戶嘗試使用已停用的已排程啟動/停止 Azure SQL 受控實例功能。
指定的 SKU 不支援 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 排程的啟動/停止作業。
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 停止在未使用 Feature Wave 2022 年 11 月執行的實例上執行
400 ManagementServiceStartStopManagedInstanceScheduleOverlap - 排程配對重疊。
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 兩個連續動作之間的時間小於 1 小時。
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - 要求主體中提供的一組參數是空的或無效的。
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - 提供的時區參數無效。
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - 提供的啟動/停止排程無效。排程不包含排程清單中的專案，或清單中的某些專案具有無效的值。
404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器
404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。
404 ResourceNotFound - 找不到要求的資源。
404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 指定受控實例的排程不存在。
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 使用者嘗試執行 Start/Stop 排程的 CRUD 作業，其排程名稱與 'default' 不同
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - 嘗試在 Azure SQL 受控實例上建立/更新/刪除排程的啟動/停止排程作業失敗。排程未建立或無法更新/刪除，因為它正忙於進行中的排程作業。請稍後再重試您的要求。

範例

Gets the managed instance's Start/Stop schedule.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/schedulerg/providers/Microsoft.Sql/managedInstances/schedulemi/startStopSchedules/default?api-version=2024-05-01-preview

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python start_stop_managed_instance_schedule_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-1111-2222-3333-444444444444",
    )

    response = client.start_stop_managed_instance_schedules.get(
        resource_group_name="schedulerg",
        managed_instance_name="schedulemi",
        start_stop_schedule_name="default",
    )
    print(response)


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2024-05-01-preview/examples/StartStopManagedInstanceScheduleGet.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:: 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"
}

定義

名稱	Description
createdByType	建立資源的身分識別類型。
DayOfWeek	開始日。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ScheduleItem	排程資訊，描述伺服器何時應該啟動或停止。
StartStopManagedInstanceSchedule	受控實例的啟動/停止排程。
StartStopScheduleName	受控實例的啟動/停止排程名稱。
systemData	與建立和上次修改資源相關的元數據。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
Application
Key
ManagedIdentity
User

DayOfWeek

列舉型別

開始日。

值	Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ScheduleItem

Object

排程資訊，描述伺服器何時應該啟動或停止。

名稱	類型	Description
startDay	DayOfWeek	開始日。
startTime	string	開始時間。
stopDay	DayOfWeek	停止一天。
stopTime	string	停止時間。

StartStopManagedInstanceSchedule

Object

受控實例的啟動/停止排程。

名稱	類型	預設值	Description
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

列舉型別

受控實例的啟動/停止排程名稱。

值	Description
default

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為

Start Stop Managed Instance Schedules - Get

URI 參數

回應

範例

Gets the managed instance's Start/Stop schedule.

範例要求

範例回覆

定義

createdByType

DayOfWeek

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ScheduleItem

StartStopManagedInstanceSchedule

StartStopScheduleName

systemData

其他資源