Start Stop Managed Instance Schedules - Get

서비스:: SQL Database

API 버전:: 2023-08-01

관리되는 인스턴스의 시작/중지 일정을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
managedInstanceName	path	True	string	관리되는 인스턴스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
startStopScheduleName	path	True	StartStopScheduleName	관리되는 인스턴스 시작/중지 일정의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	StartStopManagedInstanceSchedule	시작/중지 일정을 검색했습니다.
Other Status Codes	ErrorResponse	오류 응답: *** 204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 사용자가 'default'와 다른 일정 이름으로 시작/중지 일정의 CRUD 작업을 수행하려고 했습니다. 400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 두 연속 작업 사이의 시간은 1시간 미만입니다. 400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - 사용자가 적절한 구독 기능에 대한 구독 허용 목록을 지정하지 않고 시작/중지 기능을 사용하려고 했습니다. 400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 지정된 SKU에서 예약된 시작/중지 작업이 지원되지 않습니다. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 2022년 11월 기능 웨이브로 실행되지 않는 인스턴스에서 실행 중지 400 StartStopOfManagedInstanceIsDisabled - 관리되는 인스턴스에서 시작 및 중지 작업을 사용할 수 없습니다. 400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - 사용자가 예약된 Azure SQL Managed Instance 시작/중지 기능을 사용하려고 했습니다. 이 기능은 사용하지 않도록 설정되었습니다. 400 ManagementServiceStartStopManagedInstanceScheduleOverlap - 일정 쌍에서 겹칩니다. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - 요청 본문에 제공된 매개 변수 집합이 비어 있거나 잘못되었습니다. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - 제공된 표준 시간대 매개 변수가 잘못되었습니다. 400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - 제공된 시작/중지 일정이 잘못되었습니다. 일정 목록에 항목이 없거나 목록의 일부 항목에 잘못된 값이 있습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 지정된 관리되는 인스턴스에 대한 일정이 없습니다. 404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 사용자가 'default'와 다른 일정 이름으로 시작/중지 일정의 CRUD 작업을 수행하려고 했습니다. 409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - Azure SQL Managed Instance에서 시작/중지 일정의 만들기/업데이트/삭제 작업이 실패했습니다. 일정이 만들어지지 않았거나 진행 중인 예약 작업으로 사용 중이었기 때문에 업데이트/삭제할 수 없습니다. 나중에 요청을 다시 시도하세요.

Name

형식

Description

200 OK

StartStopManagedInstanceSchedule

시작/중지 일정을 검색했습니다.

Other Status Codes

ErrorResponse

오류 응답: ***

204 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 사용자가 'default'와 다른 일정 이름으로 시작/중지 일정의 CRUD 작업을 수행하려고 했습니다.
400 ManagementServiceStartStopManagedInstanceScheduleSmallTimespan - 두 연속 작업 사이의 시간은 1시간 미만입니다.
400 ManagementServiceStartStopManagedInstanceScheduleSubscriptionNotEnabledForFeature - 사용자가 적절한 구독 기능에 대한 구독 허용 목록을 지정하지 않고 시작/중지 기능을 사용하려고 했습니다.
400 ManagementServiceStartStopManagedInstanceScheduleNotSupportedOnSKU - 지정된 SKU에서 예약된 시작/중지 작업이 지원되지 않습니다.
400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - 2022년 11월 기능 웨이브로 실행되지 않는 인스턴스에서 실행 중지
400 StartStopOfManagedInstanceIsDisabled - 관리되는 인스턴스에서 시작 및 중지 작업을 사용할 수 없습니다.
400 ManagementServiceStartStopManagedInstanceScheduleFeatureDisabled - 사용자가 예약된 Azure SQL Managed Instance 시작/중지 기능을 사용하려고 했습니다. 이 기능은 사용하지 않도록 설정되었습니다.
400 ManagementServiceStartStopManagedInstanceScheduleOverlap - 일정 쌍에서 겹칩니다.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestParametersInvalid - 요청 본문에 제공된 매개 변수 집합이 비어 있거나 잘못되었습니다.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestTimeZoneInvalid - 제공된 표준 시간대 매개 변수가 잘못되었습니다.
400 ManagementServiceStartStopManagedInstanceScheduleCreateOrUpdateRequestScheduleInvalid - 제공된 시작/중지 일정이 잘못되었습니다. 일정 목록에 항목이 없거나 목록의 일부 항목에 잘못된 값이 있습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.
404 ManagementServiceStartStopManagedInstanceScheduleNotFound - 지정된 관리되는 인스턴스에 대한 일정이 없습니다.
404 ManagementServiceStartStopManagedInstanceScheduleNameInvalid - 사용자가 'default'와 다른 일정 이름으로 시작/중지 일정의 CRUD 작업을 수행하려고 했습니다.
409 ManagementServiceStartStopManagedInstanceScheduleConflictingOperation - Azure SQL Managed Instance에서 시작/중지 일정의 만들기/업데이트/삭제 작업이 실패했습니다. 일정이 만들어지지 않았거나 진행 중인 예약 작업으로 사용 중이었기 때문에 업데이트/삭제할 수 없습니다. 나중에 요청을 다시 시도하세요.

예제

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=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/StartStopManagedInstanceScheduleGet.json
// this example is just showing the usage of "StartStopManagedInstanceSchedules_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedInstanceResource created on azure
// for more information of creating ManagedInstanceResource, please refer to the document of ManagedInstanceResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "schedulerg";
string managedInstanceName = "schedulemi";
ResourceIdentifier managedInstanceResourceId = ManagedInstanceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName);
ManagedInstanceResource managedInstance = client.GetManagedInstanceResource(managedInstanceResourceId);

// get the collection of this ManagedInstanceStartStopScheduleResource
ManagedInstanceStartStopScheduleCollection collection = managedInstance.GetManagedInstanceStartStopSchedules();

// invoke the operation
ManagedInstanceStartStopScheduleName startStopScheduleName = ManagedInstanceStartStopScheduleName.Default;
NullableResponse<ManagedInstanceStartStopScheduleResource> response = await collection.GetIfExistsAsync(startStopScheduleName);
ManagedInstanceStartStopScheduleResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ManagedInstanceStartStopScheduleData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

정의

Name	Description
createdByType	리소스를 만든 ID의 형식입니다.
DayOfWeek	시작 날짜입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ScheduleItem	서버를 시작하거나 중지해야 하는 시기를 설명하는 정보를 예약합니다.
StartStopManagedInstanceSchedule	관리되는 인스턴스의 시작/중지 일정입니다.
StartStopScheduleName	관리되는 인스턴스 시작/중지 일정의 이름입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DayOfWeek

열거형

시작 날짜입니다.

값	Description
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ScheduleItem

Object

서버를 시작하거나 중지해야 하는 시기를 설명하는 정보를 예약합니다.

Name	형식	Description
startDay	DayOfWeek	시작 날짜입니다.
startTime	string	시작 시간입니다.
stopDay	DayOfWeek	중지 일.
stopTime	string	중지 시간.

StartStopManagedInstanceSchedule

Object

관리되는 인스턴스의 시작/중지 일정입니다.

Name	형식	Default value	Description
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

열거형

관리되는 인스턴스 시작/중지 일정의 이름입니다.

값	Description
default

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

Start Stop Managed Instance Schedules - Get

URI 매개 변수

응답

예제

Gets the managed instance's Start/Stop schedule.

샘플 요청

샘플 응답

정의

createdByType

DayOfWeek

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ScheduleItem

StartStopManagedInstanceSchedule

StartStopScheduleName

systemData