Sql Virtual Machines - Update

SQL 가상 머신을 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}?api-version=2017-03-01-preview

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

리소스를 포함하는 리소스 그룹의 이름 Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

sqlVirtualMachineName
path True
  • string

SQL 가상 머신의 이름입니다.

subscriptionId
path True
  • string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True
  • string

요청에 사용할 API 버전입니다.

요청 본문

Name Type Description
tags
  • object

리소스 태그.

응답

Name Type Description
200 OK

SQL 가상 머신을 업데이트했습니다.

Other Status Codes

오류 응답: ***

  • 400 SqlLicenseTypeNotSupported - SqlLicenseType NotSet이 잘못 제공됨

  • 400 UnsupportedSqlManagementMode - SQL 관리 모드를 업데이트할 {0}수 없습니다. Windows Server 2008에는 모드만 {1} 지원됩니다.

  • 400 SqlSkuMismatchWithGroup - SQL 가상 머신 그룹에 설정된 SQL sku가 SQL 가상 머신의 sku와 일치하지 않습니다.

  • 400 SubscriptionDoesNotExist - 구독 ID가 없습니다.

  • 400 SubscriptionNotReady - 구독이 준비되지 않음

  • 400 AutoBackupEncryptionPasswordNotSpecified - 자동 백업 설정으로 암호화를 사용하도록 설정할 때 암호가 제공되지 않습니다.

  • 400 BackupScheduleTypeNotSet - 백업 일정 유형을 설정해야 합니다.

  • 400 BackupStorageCredentialsNotSpecified - 백업 스토리지 자격 증명이 지정되지 않았습니다.

  • 400 KeyVaultCredentialsNotSpecified - Key Vault 자격 증명이 지정되지 않았습니다.

  • 400 SqlCredentialsNotSpecified - SQL Server 자격 증명이 지정되지 않았습니다.

  • 400 IncompleteAutoPatchingSettings - 불완전한 자동 패치 설정이 지정되었습니다.

  • 400 IncompleteAutoBackupSettings - 불완전한 자동 백업 설정이 지정되었습니다.

  • 400 IncompleteSqlStorageSettings - 불완전한 SQL 스토리지 설정이 지정되었습니다.

  • 400 InvalidVmResourceIdChange - 가상 머신 리소스 ID 속성을 업데이트할 수 없습니다.

  • 400 SqlVmAlreadyIncludedInGroup - SQL 가상 머신은 동일한 작업에서 한 그룹에서 다른 그룹으로 이동할 수 없습니다.

  • 400 SqlVmCannotRemoveFromGroup - SQL 가상 머신을 그룹에서 제거할 수 없습니다.

  • 400 VmLocationMismatch - VM 위치가 SQL 가상 머신의 위치와 일치하지 않습니다.

  • 400 VmInsufficientPermission - Vm에 대한 권한이 부족합니다.

  • 400 SingleNicOnVmAllowed - SQL VM 그룹에서 단일 NIC 가상 머신만 허용됩니다.

  • 400 InvalidSqlVmGroupResourceIdParameterValue - SQL 가상 머신 그룹 리소스 ID가 올바른 형식이 아닙니다.

  • 400 MismatchVmGroupSubscription - SQL 가상 머신 및 SQL 가상 머신 그룹에 대한 구독 ID가 다릅니다.

  • 400 IncompleteDomainCredentialsProperty - 도메인 자격 증명 속성에 대해 불완전한 입력이 제공되었습니다.

  • 400 BYOLChangeToPAYGNotSupported - AHUB에서 PAYG로의 변환은 BYOL 이미지에 대해 지원되지 않습니다.

  • 400 InvalidVmResourceIdParameterValue - 제공된 가상 머신 리소스 ID가 잘못되었습니다.

  • 400 MismatchInSqlVmAndVmResourceIdSubscription - SQL 가상 머신 및 가상 머신 리소스 ID 속성에 대한 구독 ID가 일치하지 않습니다.

  • 400 MismatchSqlVmAndVmName - SQL 가상 머신 이름은 VirtualMachineResourceId 속성에 제공된 가상 머신 이름과 다릅니다.

  • 400 MismatchSqlVmAndVmRgName - SQL 가상 머신 리소스 그룹 이름은 VirtualMachineResourceId 속성에 제공된 가상 머신 리소스 그룹 이름과 다릅니다.

  • 400 NotSupportedSqlVmOSVersion - 가상 머신 OS 유형이 Windows 않습니다. Windows OS 버전만 지원됩니다.

  • 400 VmNotRunning - VM이 실행 중 상태가 아닙니다.

  • 400 VmAgentNotRunning - VM 에이전트가 설치되지 않았거나 실행 중 상태입니다.

  • 400 PAYGNotSupportedForNonGalleryVM - 라이선스 유형 PAYG가 Azure Marketplace 이미지에서 만들어지지 않았기 때문에 이 Virtual Machine에 대해 유효하지 않습니다.

  • 400 CannotDetermineSqlVersionAndEditionFromVm - Sql IaaS 확장은 vm에서 SQL 버전 및 버전을 확인할 수 없습니다.

  • 400 MismatchSqlVmSku - Sql 가상 머신 sku 불일치.

  • 400 CannotConvertToFreeBenefit - Free SQL 버전을 .(으)로 변환할 {0}수 없습니다.

  • 400 SqlEvaluationSkuNotSupported - SQL 평가판 버전에서는 라이선스 변경을 지원하지 않습니다.

  • 400 IncompleteStorageConfigurationSettings - 불완전한 Storage 구성 설정

  • 400 InvalidDefaultFilePath - 잘못된 기본 파일 경로

  • 400 InvalidLUNSpecified - 잘못된 논리 단위 번호를 지정했습니다. 논리 단위 번호는 음수가 아닌 숫자여야 합니다.

  • 400 BothStorageV1V2Specified - 잘못된 요청입니다. SQL Storage Storage 설정 또는 Storage 구성 설정 중 하나만 지정해야 합니다.

  • 400 InvalidLUNsSpecifiedForSameDrive - 잘못된 논리 단위 번호가 지정되었습니다. 동일한 드라이브에 사용되는 논리 단위 번호는 동일해야 합니다.

  • 400 InvalidLUNsSpecifiedForDifferentDrives - 잘못된 논리 단위 번호가 지정되었습니다. 다른 드라이브에서 동일한 논리 단위 번호를 다시 사용할 수 없습니다.

  • 400 InvalidExtendPayload - 잘못된 Sql Storage 설정 페이로드를 확장합니다. 한 번에 하나의 드라이브만 확장할 수 있습니다.

  • 400 SqlVersionMismatchWithGroup - SQL 가상 머신 그룹과 버전이 일치하지 SQL.

  • 400 SqlLicenseTypeMissing - Sql Virtual Machine에 대한 라이선스 유형을 지정하세요. 속성은 'SqlServerLicenceType'이며 허용되는 값은 PAYG, AHUB 및 DR입니다.

  • 400 VmOSVersionMismatchWithGroup - OS 버전이 그룹과 일치하지 않습니다.

  • 400 VmAgentIsRunningForNoAgent - 게스트 에이전트가 실행되는 동안 NoAgent 모델로 만들거나 업데이트할 수 없습니다.

  • 400 InvalidSqlManagementMode - SQL 관리 모드를 업데이트할 {0}수 없습니다. 현재 모드는 다음과 같습니다{1}.

  • 400 CannotDetermineSqlEditionFromRequest - SQL 버전을 확인할 수 없습니다.

  • 400 SqlManagementMissing - Sql Virtual Machine에 대한 관리 모드를 지정하세요. 속성은 'SqlManagement'이며 허용되는 값은 LightWeight 또는 Full입니다.

  • 400 SqlImageSkuMissingNoAgent - NoAgent 모드에서 Sql Virtual Machine용 Sql Server 버전을 지정하세요. 속성은 'SqlImageSku'이며 허용되는 값은 Developer, Express, Web, Standard 또는 Enterprise.

  • 400 SqlImageOfferMissingNoAgent - NoAgent 모드에서 Sql Virtual Machine용 Sql Server 버전 및 OS 버전을 지정하세요. 속성은 'SqlImageOffer'이고 허용되는 값은 SQL2008-WS2008 및 SQL2008R2-WS2008입니다.

  • 400 InvalidSqlImageOfferChange - SqlImageOffer 속성을 업데이트할 수 없습니다.

  • 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.

  • 400 RPGenericUser - 다른 리소스 공급자를 호출할 때 사용자 오류가 발생했습니다.

  • 400 RPResponseMissingAsyncOperationHeader - 응답에 비동기 작업 헤더 정보가 없습니다.

  • 400 InvalidArgument - 잘못된 인수 '{0}'입니다.

  • 400 ArgumentNotInRange - '' 인수{0}가 범위에 없습니다.

  • 400 ResourceNotProvisioned - 리소스: {0} 프로비전된 상태가 아니기 때문에 요청을 앞으로 진행할 수 없습니다.

  • 400 CRPNotAllowedOperation - 다음 오류로 인해 작업을 완료할 수 없습니다. {0}

  • 400 InvalidRgResourceId - 잘못된 리소스 그룹 리소스 ID가 지정되었습니다.

  • 403 AccessDenied - 액세스가 거부되었습니다.

  • 404 SubscriptionDoesNotHaveSqlVMInResourceGroup - 구독에 리소스 그룹에 SQL 가상 머신 인스턴스가 없습니다.

  • 404 SubscriptionDoesNotHaveSqlVMGroupInResourceGroup - 구독에 리소스 그룹에 SQL 가상 머신 그룹이 없습니다.

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

  • 404 SubscriptionDoesNotExist - 구독 ID가 없습니다.

  • 404 ResourceDoesNotExist - 리소스가 없습니다.

  • 404 RPOperationNotFound - 작업을 찾을 수 없음

  • 404 OperationIdNotFound - 작업 ID를 찾을 수 없습니다.

  • 404 OperationTypeNotFound - 작업 유형을 찾을 수 없습니다.

  • 409 ResourceAlreadyExists - 리소스가 이미 있습니다.

  • 409 LBGenericErrors - LB 작업 실패

  • 409 NICGenericError - NIC 작업 실패

  • 409 SqlExtensionNotInstalled - SQL 확장이 설치되지 않았습니다.

  • 409 RPPluginSubstatusMissing - RP 플러그 인 하위 상태 누락

  • 409 MissingMoveResources - 요청에 일부 리소스가 없으므로 리소스를 이동할 수 없습니다.

  • 409 ResourceExists - 리소스 정리에 내부 오류가 발생했습니다.

  • 409 SubscriptionOperationInProgress - 구독에 대한 작업이 이미 진행 중입니다.

  • 409 OperationInProgress - 리소스에서 이미 진행 중인 작업입니다.

  • 409 OperationCanceled - 작업이 취소되었습니다.

  • 500 RPGenericSystem - 다른 리소스 공급자를 호출할 때 시스템 오류가 발생했습니다.

  • 500 UnExpectedErrorOccurred - 예기치 않은 오류가 발생했습니다.

  • 500 OperationTimeout - 작업 시간이 초과되었습니다.

예제

Updates a SQL virtual machine tags.

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm?api-version=2017-03-01-preview

{
  "tags": {
    "mytag": "myval"
  }
}

Sample Response

{
  "properties": {
    "virtualMachineResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Compute/virtualMachines/testvm",
    "provisioningState": "Updating",
    "sqlServerLicenseType": "PAYG",
    "sqlImageSku": "Enterprise"
  },
  "location": "northeurope",
  "tags": {
    "mytag": "myval"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm",
  "name": "testvm",
  "type": "Microsoft.SqlVirtualMachine/sqlVirtualMachines"
}

정의

AdditionalFeaturesServerConfigurations

추가 SQL Server 기능 설정입니다.

AutoBackupSettings

SQL 가상 머신에서 데이터베이스에 대한 백업을 구성합니다.

AutoPatchingSettings

Windows 및 SQL 패치가 적용되는 패치 창을 설정합니다.

BackupScheduleType

백업 일정 유형입니다.

ConnectivityType

SQL Server 연결 옵션입니다.

DayOfWeek

패치를 적용할 요일입니다.

DiskConfigurationType

SQL Server 적용할 디스크 구성입니다.

FullBackupFrequencyType

전체 백업의 빈도입니다. 두 경우 모두 전체 백업은 예약된 다음 기간 동안 시작됩니다.

IdentityType

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

KeyVaultCredentialSettings

Azure Key Vault 서비스에 연결할 수 있도록 SQL 가상 머신을 구성합니다.

ResourceIdentity

리소스에 대한 ID 구성을 Azure Active Directory.

ServerConfigurationsManagementSettings

연결, 스토리지 및 워크로드 설정을 지정합니다.

SqlConnectivityUpdateSettings

SQL Server 대한 액세스 수준 및 네트워크 포트 설정을 지정합니다.

SqlImageSku

SQL Server 버전 유형입니다.

SqlManagementMode

SQL Server 관리 유형입니다.

SqlServerLicenseType

SQL Server 라이선스 유형입니다.

SQLStorageSettings

SQL Server 디스크 스토리지 설정을 지정합니다.

SqlStorageUpdateSettings

SQL Server 디스크 스토리지 설정을 지정합니다.

SqlVirtualMachine

SQL 가상 머신입니다.

SqlVirtualMachineUpdate

SQL 가상 머신에 대한 업데이트입니다.

SqlWorkloadType

SQL Server 워크로드 유형입니다.

SqlWorkloadTypeUpdateSettings

워크로드 유형을 설정하여 SQL Server 스토리지를 최적화합니다.

StorageConfigurationSettings

SQL 데이터, 로그 및 TempDb에 대한 Storage 구성입니다.

StorageWorkloadType

Storage 워크로드 유형입니다.

WsfcDomainCredentials

SQL 가용성 그룹에 대한 Windows 서버 장애 조치(failover) 클러스터를 설정하기 위한 도메인 자격 증명입니다.

AdditionalFeaturesServerConfigurations

추가 SQL Server 기능 설정입니다.

Name Type Description
isRServicesEnabled
  • boolean

R 서비스를 사용하거나 사용하지 않도록 설정합니다(SQL 2016 이상).

AutoBackupSettings

SQL 가상 머신에서 데이터베이스에 대한 백업을 구성합니다.

Name Type Description
backupScheduleType

백업 일정 유형입니다.

backupSystemDbs
  • boolean

자동 백업에서 시스템 데이터베이스를 포함하거나 제외합니다.

enable
  • boolean

SQL 가상 머신에서 자동 복구를 사용하거나 사용하지 않도록 설정합니다.

enableEncryption
  • boolean

SQL 가상 머신에서 백업에 암호화를 사용하거나 사용하지 않도록 설정합니다.

fullBackupFrequency

전체 백업의 빈도입니다. 두 경우 모두 전체 백업은 예약된 다음 기간 동안 시작됩니다.

fullBackupStartTime
  • integer

전체 백업이 수행될 수 있는 지정된 날의 시작 시간입니다. 0-23시간.

fullBackupWindowHours
  • integer

전체 백업이 수행될 수 있는 지정된 날의 시간 기간입니다. 1-23시간.

logBackupFrequency
  • integer

로그 백업의 빈도입니다. 5-60분.

password
  • string

백업에서 암호화를 위한 암호입니다.

retentionPeriod
  • integer

백업 보존 기간: 1-30일

storageAccessKey
  • string

백업을 수행할 계정 키를 Storage.

storageAccountUrl
  • string

백업을 수행할 계정 URL을 Storage.

AutoPatchingSettings

Windows 및 SQL 패치가 적용되는 패치 창을 설정합니다.

Name Type Description
dayOfWeek

패치를 적용할 요일입니다.

enable
  • boolean

SQL 가상 머신에서 자동 패치를 사용하거나 사용하지 않도록 설정합니다.

maintenanceWindowDuration
  • integer

패치 기간입니다.

maintenanceWindowStartingHour
  • integer

패치가 시작되는 하루 중 시간입니다. 로컬 VM 시간입니다.

BackupScheduleType

백업 일정 유형입니다.

Name Type Description
Automated
  • string
Manual
  • string

ConnectivityType

SQL Server 연결 옵션입니다.

Name Type Description
LOCAL
  • string
PRIVATE
  • string
PUBLIC
  • string

DayOfWeek

패치를 적용할 요일입니다.

Name Type Description
Friday
  • string
Monday
  • string
Saturday
  • string
Sunday
  • string
Thursday
  • string
Tuesday
  • string
Wednesday
  • string

DiskConfigurationType

SQL Server 적용할 디스크 구성입니다.

Name Type Description
ADD
  • string
EXTEND
  • string
NEW
  • string

FullBackupFrequencyType

전체 백업의 빈도입니다. 두 경우 모두 전체 백업은 예약된 다음 기간 동안 시작됩니다.

Name Type Description
Daily
  • string
Weekly
  • string

IdentityType

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

Name Type Description
SystemAssigned
  • string

KeyVaultCredentialSettings

Azure Key Vault 서비스에 연결할 수 있도록 SQL 가상 머신을 구성합니다.

Name Type Description
azureKeyVaultUrl
  • string

Azure Key Vault URL입니다.

credentialName
  • string

자격 증명 이름입니다.

enable
  • boolean

키 자격 증명 모음 자격 증명 설정을 사용하거나 사용하지 않도록 설정합니다.

servicePrincipalName
  • string

키 자격 증명 모음에 액세스할 서비스 주체 이름입니다.

servicePrincipalSecret
  • string

키 자격 증명 모음에 액세스하기 위한 서비스 주체 이름 비밀입니다.

ResourceIdentity

리소스에 대한 ID 구성을 Azure Active Directory.

Name Type Description
principalId
  • string

Azure Active Directory 보안 주체 ID입니다.

tenantId
  • string

Azure Active Directory 테넌트 ID입니다.

type

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

ServerConfigurationsManagementSettings

연결, 스토리지 및 워크로드 설정을 지정합니다.

Name Type Description
additionalFeaturesServerConfigurations

추가 SQL 기능 설정입니다.

sqlConnectivityUpdateSettings

연결 유형 설정을 SQL.

sqlStorageUpdateSettings

스토리지 업데이트 설정을 SQL.

sqlWorkloadTypeUpdateSettings

워크로드 유형 설정을 SQL.

SqlConnectivityUpdateSettings

SQL Server 대한 액세스 수준 및 네트워크 포트 설정을 지정합니다.

Name Type Description
connectivityType

SQL Server 연결 옵션입니다.

port
  • integer

SQL Server 포트입니다.

sqlAuthUpdatePassword
  • string

sysadmin 로그인 암호를 SQL Server.

sqlAuthUpdateUserName
  • string

sysadmin 로그인을 SQL Server 만듭니다.

SqlImageSku

SQL Server 버전 유형입니다.

Name Type Description
Developer
  • string
Enterprise
  • string
Express
  • string
Standard
  • string
Web
  • string

SqlManagementMode

SQL Server 관리 유형입니다.

Name Type Description
Full
  • string
LightWeight
  • string
NoAgent
  • string

SqlServerLicenseType

SQL Server 라이선스 유형입니다.

Name Type Description
AHUB
  • string
DR
  • string
PAYG
  • string

SQLStorageSettings

SQL Server 디스크 스토리지 설정을 지정합니다.

Name Type Description
defaultFilePath
  • string

기본 파일 경로 SQL Server

luns
  • integer[]

디스크의 논리 단위 번호입니다.

SqlStorageUpdateSettings

SQL Server 디스크 스토리지 설정을 지정합니다.

Name Type Description
diskConfigurationType

SQL Server 적용할 디스크 구성입니다.

diskCount
  • integer

가상 머신 디스크 수입니다.

startingDeviceId
  • integer

업데이트할 첫 번째 디스크의 디바이스 ID입니다.

SqlVirtualMachine

SQL 가상 머신입니다.

Name Type Description
id
  • string

리소스 ID입니다.

identity

서버의 id를 Azure Active Directory.

location
  • string

리소스 위치.

name
  • string

리소스 이름입니다.

properties.autoBackupSettings

SQL Server 대한 자동 백업 설정입니다.

properties.autoPatchingSettings

SQL 가상 머신에 중요한 보안 업데이트를 적용하기 위한 자동 패치 설정입니다.

properties.keyVaultCredentialSettings

키 자격 증명 모음 자격 증명 설정.

properties.provisioningState
  • string

비동기 작업 상태를 추적하는 프로비전 상태입니다.

properties.serverConfigurationsManagementSettings

구성 관리 설정을 SQL Server.

properties.sqlImageOffer
  • string

SQL 이미지 제품입니다. 예를 들어 SQL2016-WS2016, SQL2017-WS2016이 있습니다.

properties.sqlImageSku

SQL Server 버전 유형입니다.

properties.sqlManagement

SQL Server 관리 유형입니다.

properties.sqlServerLicenseType

SQL Server 라이선스 유형입니다.

properties.sqlVirtualMachineGroupResourceId
  • string

이 SQL 가상 머신이 있거나 해당되는 SQL 가상 머신 그룹의 ARM 리소스 ID입니다.

properties.storageConfigurationSettings

Storage 구성 설정.

properties.virtualMachineResourceId
  • string

SQL Marketplace 이미지에서 만든 기본 가상 머신의 ARM 리소스 ID입니다.

properties.wsfcDomainCredentials

SQL 가용성 그룹에 대한 Windows 서버 장애 조치(failover) 클러스터를 설정하기 위한 도메인 자격 증명입니다.

tags
  • object

리소스 태그.

type
  • string

리소스 종류.

SqlVirtualMachineUpdate

SQL 가상 머신에 대한 업데이트입니다.

Name Type Description
tags
  • object

리소스 태그.

SqlWorkloadType

SQL Server 워크로드 유형입니다.

Name Type Description
DW
  • string
GENERAL
  • string
OLTP
  • string

SqlWorkloadTypeUpdateSettings

워크로드 유형을 설정하여 SQL Server 스토리지를 최적화합니다.

Name Type Description
sqlWorkloadType

SQL Server 워크로드 유형입니다.

StorageConfigurationSettings

SQL 데이터, 로그 및 TempDb에 대한 Storage 구성입니다.

Name Type Description
diskConfigurationType

SQL Server 적용할 디스크 구성입니다.

sqlDataSettings

데이터 Storage 설정 SQL Server.

sqlLogSettings

로그 Storage 설정 SQL Server.

sqlTempDbSettings

tempDb Storage 설정 SQL Server.

storageWorkloadType

Storage 워크로드 유형입니다.

StorageWorkloadType

Storage 워크로드 유형입니다.

Name Type Description
DW
  • string
GENERAL
  • string
OLTP
  • string

WsfcDomainCredentials

SQL 가용성 그룹에 대한 Windows 서버 장애 조치(failover) 클러스터를 설정하기 위한 도메인 자격 증명입니다.

Name Type Description
clusterBootstrapAccountPassword
  • string

클러스터 부트스트랩 계정 암호입니다.

clusterOperatorAccountPassword
  • string

클러스터 운영자 계정 암호입니다.

sqlServiceAccountPassword
  • string

서비스 계정 암호를 SQL.