Sql Virtual Machines - List By Sql Vm Group

SQL 가상 머신 그룹의 sql 가상 머신 목록을 가져옵니다.

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

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

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

sqlVirtualMachineGroupName
path True
  • string

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

subscriptionId
path True
  • string

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

api-version
query True
  • string

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

응답

Name Type Description
200 OK

SQL 가상 머신 그룹의 sql 가상 머신 목록을 성공적으로 검색했습니다.

Other Status Codes

오류 응답: ***

  • 400 FileShareWitnessDisAllowed - Windows Server 2016 이상 설정의 경우 파일 공유 감시가 허용되지 않습니다.

  • 400 InvalidStorageAccountUrl - 잘못된 스토리지 계정 URL입니다.

  • 400 SqlVmGroupNameTooLong - SQL 가상 머신 그룹 이름은 15자를 초과할 수 없습니다.

  • 400 InvalidSqlVmGroupName - SQL 가상 머신 그룹 이름이 잘못되었습니다.

  • 400 InvalidStorageAccountCredentials - 제공된 스토리지 계정 자격 증명이 잘못되었습니다.

  • 400 InvalidStorageAccountType - 이 작업에는 '범용 V2' 유형의 스토리지 계정만 허용됩니다.

  • 400 SqlVmGroupNotEmpty - SQL 가상 머신 그룹이 비어 있지 않습니다.

  • 400 SqlVmGroupUpdateNotAllowed - SQL 가상 머신 그룹에 대한 업데이트는 허용되지 않습니다.

  • 400 SqlVmGroupUpdateFailVmAttached - SQL 가상 머신을 연결한 SQL 가상 머신 그룹을 업데이트할 수 없습니다.

  • 400 InvalidSqlImageOffer - 제공된 SQL 이미지 제품이 잘못되었습니다.

  • 400 InvalidSqlSku - SQL sku가 잘못되었습니다.

  • 400 OuPathAndDomainMismatch - OU 경로가 제공된 도메인 내에 있지 않습니다.

  • 400 InvalidAccountNameFormat - 계정 이름 형식이 잘못되었습니다.

  • 400 CloudWitnessUnsupported - Windows Server 2012R2 설치 클라우드 감시는 허용되지 않습니다.

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

예제

Gets the list of sql virtual machines in a SQL virtual machine group.

Sample Request

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

Sample Response

{
  "value": [
    {
      "properties": {
        "virtualMachineResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Compute/virtualMachines/testvm2",
        "provisioningState": "Succeeded",
        "sqlImageOffer": "SQL2014-WS2012R2",
        "sqlImageSku": "Enterprise",
        "sqlManagement": "LightWeight",
        "sqlServerLicenseType": "PAYG",
        "sqlVirtualMachineGroupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachineGroups/testvmgroup"
      },
      "location": "northeurope",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm2",
      "name": "testvm2",
      "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 가상 머신입니다.

SqlVirtualMachineListResult

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

리소스 종류.

SqlVirtualMachineListResult

SQL 가상 머신의 목록입니다.

Name Type Description
nextLink
  • string

결과의 다음 페이지를 검색하려면 연결합니다.

value

결과의 배열입니다.

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.