Managed Instances - Start

참조

서비스:: SQL Database

API 버전:: 2023-08-01

관리되는 인스턴스를 시작합니다.

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

URI 매개 변수

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

응답

Name	형식	Description
200 OK	ManagedInstance	관리되는 인스턴스를 성공적으로 시작했습니다.
202 Accepted		관리되는 인스턴스 시작이 진행 중입니다. 헤더 Location: string
Other Status Codes	ErrorResponse	오류 응답: *** 400 NameAlreadyExists - 제공된 이름이 이미 있습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU - 지정된 SKU에서 시작 작업이 지원되지 않습니다. 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 사용자가 적절한 구독 기능에 대한 구독 허용 목록을 지정하지 않고 시작/중지 기능을 사용하려고 했습니다. 400 StartStopOfManagedInstanceIsDisabled - 관리되는 인스턴스에서 시작 및 중지 작업을 사용할 수 없습니다. 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - 사용자가 중지된 상태가 아닌 Azure SQL Managed Instance를 시작하려고 했습니다. 400 ManagementServiceStartManagedInstanceFeatureDisabled - 사용자가 사용하지 않도록 설정된 Azure SQL Managed Instance 시작 기능을 사용하려고 했습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 SubscriptionDisabled - 구독을 사용할 수 없습니다. 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

Name

형식

Description

200 OK

ManagedInstance

관리되는 인스턴스를 성공적으로 시작했습니다.

202 Accepted

관리되는 인스턴스 시작이 진행 중입니다.

헤더

Location: string

Other Status Codes

ErrorResponse

오류 응답: ***

400 NameAlreadyExists - 제공된 이름이 이미 있습니다.
400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.
400 ManagementServiceStartManagedInstanceNotSupportedOnSKU - 지정된 SKU에서 시작 작업이 지원되지 않습니다.
400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - 사용자가 적절한 구독 기능에 대한 구독 허용 목록을 지정하지 않고 시작/중지 기능을 사용하려고 했습니다.
400 StartStopOfManagedInstanceIsDisabled - 관리되는 인스턴스에서 시작 및 중지 작업을 사용할 수 없습니다.
400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - 사용자가 중지된 상태가 아닌 Azure SQL Managed Instance를 시작하려고 했습니다.
400 ManagementServiceStartManagedInstanceFeatureDisabled - 사용자가 사용하지 않도록 설정된 Azure SQL Managed Instance 시작 기능을 사용하려고 했습니다.
400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.
400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.
400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.
400 TokenTooLong - 제공된 토큰이 너무 깁니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
409 SubscriptionDisabled - 구독을 사용할 수 없습니다.
409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Starts the managed instance.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart/start?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/StartManagedInstance.json
// this example is just showing the usage of "ManagedInstances_Start" 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 = "startrg";
string managedInstanceName = "mitostart";
ResourceIdentifier managedInstanceResourceId = ManagedInstanceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName);
ManagedInstanceResource managedInstance = client.GetManagedInstanceResource(managedInstanceResourceId);

// invoke the operation
ArmOperation<ManagedInstanceResource> lro = await managedInstance.StartAsync(WaitUntil.Completed);
ManagedInstanceResource result = lro.Value;

// 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
ManagedInstanceData 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

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1234567891234",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "___location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances"
}

상태 코드:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

정의

Name	Description
AdministratorType	심각도 관리자의 유형입니다.
AuthMetadataLookupModes	관리되는 인스턴스의 인증 메타데이터 조회 모드입니다.
BackupStorageRedundancy	이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ExternalGovernanceStatus	외부 거버넌스의 상태입니다.
HybridSecondaryUsage	하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용).
HybridSecondaryUsageDetected	하이브리드 보조 사용량이 검색되었습니다. 가능한 값은 '활성'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족하지 않음) 및 '수동'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족)입니다.
IdentityType	ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.
ManagedInstance	Azure SQL 관리형 인스턴스입니다.
ManagedInstanceDatabaseFormat	SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다.
ManagedInstanceExternalAdministrator	Active Directory 관리자의 속성입니다.
ManagedInstanceLicenseType	라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다.
ManagedInstancePecProperty	관리되는 인스턴스 아래의 프라이빗 엔드포인트 연결
ManagedInstancePrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결의 속성입니다.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	인스턴스에 연결하는 데 사용되는 연결 유형입니다.
ManagedServerCreateMode	데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다.
PricingModel	Managed Instance의 가격 책정 모델입니다.
PrincipalType	서버 관리자의 보안 주체 유형입니다.
ProvisioningState	관리되는 인스턴스의 프로비전 상태입니다.
ResourceIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.
ServicePrincipal	리소스에 대한 관리되는 인스턴스의 서비스 주체 구성입니다.
ServicePrincipalType	서비스 주체 유형입니다.
Sku	ARM 리소스 SKU입니다.
UserIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.

AdministratorType

열거형

심각도 관리자의 유형입니다.

값	Description
ActiveDirectory

AuthMetadataLookupModes

열거형

관리되는 인스턴스의 인증 메타데이터 조회 모드입니다.

값	Description
AzureAD
Paired
Windows

BackupStorageRedundancy

열거형

이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.

값	Description
Geo
GeoZone
Local
Zone

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	오류 개체입니다.

ExternalGovernanceStatus

열거형

외부 거버넌스의 상태입니다.

값	Description
Disabled
Enabled

HybridSecondaryUsage

열거형

하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용).

값	Description
Active
Passive

HybridSecondaryUsageDetected

열거형

하이브리드 보조 사용량이 검색되었습니다. 가능한 값은 '활성'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족하지 않음) 및 '수동'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족)입니다.

값	Description
Active
Passive

IdentityType

열거형

ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.

값	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned