Sql Virtual Machines - List By Resource Group
获取资源组中的所有 SQL 虚拟机。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines?api-version=2022-02-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string |
包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。 |
subscription
|
path | True |
string |
标识 Azure 订阅的订阅 ID。 |
api-version
|
query | True |
string |
要用于请求的 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
已成功检索到资源组中的所有 SQL 虚拟机。 |
|
Other Status Codes |
错误响应: ***
|
示例
Gets all SQL virtual machines in a resource group.
示例请求
示例响应
{
"value": [
{
"properties": {
"virtualMachineResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Compute/virtualMachines/testvm",
"provisioningState": "Succeeded",
"sqlImageOffer": "SQL2016-WS2016",
"sqlImageSku": "Enterprise",
"sqlServerLicenseType": "PAYG"
},
"location": "northeurope",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm",
"name": "testvm",
"type": "Microsoft.SqlVirtualMachine/sqlVirtualMachines"
},
{
"properties": {
"virtualMachineResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Compute/virtualMachines/testvm1",
"provisioningState": "Succeeded",
"sqlImageOffer": "SQL2017-WS2016",
"sqlImageSku": "Enterprise",
"sqlServerLicenseType": "PAYG"
},
"location": "northeurope",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm1",
"name": "testvm1",
"type": "Microsoft.SqlVirtualMachine/sqlVirtualMachines"
}
]
}
定义
名称 | 说明 |
---|---|
Additional |
其他 SQL Server 功能设置。 |
Assessment |
运行评估的一周中的一天。 |
Assessment |
为 SQL 虚拟机中的数据库配置评估。 |
Auto |
当 FullBackupFrequency 设置为“每周”时,备份的一周中的天数。 |
Auto |
为 SQL 虚拟机中的数据库配置备份。 |
Auto |
设置一个修补窗口,在此期间将应用 Windows 和 SQL 修补程序。 |
Backup |
备份计划类型。 |
Connectivity |
SQL Server 连接选项。 |
created |
创建资源的标识的类型。 |
Day |
应用修补程序的一周中的一天。 |
Disk |
要应用于 SQL Server 的磁盘配置。 |
Full |
完整备份的频率。 在这两种情况下,完整备份将在下一个计划的时间范围内开始。 |
Identity |
标识类型。 将此设置为“SystemAssigned”,以便自动为资源创建和分配 Azure Active Directory 主体。 |
Key |
将 SQL 虚拟机配置为能够连接到 Azure Key Vault 服务。 |
Resource |
资源的 Azure Active Directory 标识配置。 |
Schedule | |
Server |
设置连接、存储和工作负荷设置。 |
Sql |
设置 SQL Server 的访问级别和网络端口设置。 |
Sql |
SQL Server 版本类型。 |
SQLInstance |
设置 SQL Server 的服务器/实例级设置。 |
Sql |
SQL Server 管理类型。 |
Sql |
SQL Server 许可证类型。 |
SQLStorage |
设置 SQL Server 的磁盘存储设置。 |
Sql |
设置 SQL Server 的磁盘存储设置。 |
SQLTemp |
|
Sql |
SQL 虚拟机。 |
Sql |
SQL 虚拟机的列表。 |
Sql |
SQL Server 工作负荷类型。 |
Sql |
设置工作负荷类型以优化 SQL Server 的存储。 |
Storage |
SQL 数据、日志和 TempDb 的存储配置。 |
Storage |
存储工作负荷类型。 |
system |
与创建和上次修改资源相关的元数据。 |
Wsfc |
用于为 SQL 可用性组设置 Windows Server 故障转移群集的域凭据。 |
AdditionalFeaturesServerConfigurations
其他 SQL Server 功能设置。
名称 | 类型 | 说明 |
---|---|---|
isRServicesEnabled |
boolean |
启用或禁用 R 服务(SQL 2016 及更高版本)。 |
AssessmentDayOfWeek
运行评估的一周中的一天。
值 | 说明 |
---|---|
Friday | |
Monday | |
Saturday | |
Sunday | |
Thursday | |
Tuesday | |
Wednesday |
AssessmentSettings
为 SQL 虚拟机中的数据库配置评估。
名称 | 类型 | 说明 |
---|---|---|
enable |
boolean |
在 SQL 虚拟机上启用或禁用评估功能。 |
runImmediately |
boolean |
立即在 SQL 虚拟机上运行评估。 |
schedule |
评估计划。 |
AutoBackupDaysOfWeek
当 FullBackupFrequency 设置为“每周”时,备份的一周中的天数。
值 | 说明 |
---|---|
Friday | |
Monday | |
Saturday | |
Sunday | |
Thursday | |
Tuesday | |
Wednesday |
AutoBackupSettings
为 SQL 虚拟机中的数据库配置备份。
名称 | 类型 | 说明 |
---|---|---|
backupScheduleType |
备份计划类型。 |
|
backupSystemDbs |
boolean |
包括或排除自动备份中的系统数据库。 |
daysOfWeek |
当 FullBackupFrequency 设置为“每周”时,备份的一周中的天数。 |
|
enable |
boolean |
在 SQL 虚拟机上启用或禁用自动回退。 |
enableEncryption |
boolean |
启用或禁用 SQL 虚拟机上备份的加密。 |
fullBackupFrequency |
完整备份的频率。 在这两种情况下,完整备份将在下一个计划的时间范围内开始。 |
|
fullBackupStartTime |
integer (int32) |
给定日期的开始时间,在此期间可以进行完整备份。 0-23 小时。 |
fullBackupWindowHours |
integer (int32) |
给定日期的时间窗口的持续时间,在此期间可以进行完整备份。 1-23 小时。 |
logBackupFrequency |
integer (int32) |
日志备份的频率。 5-60 分钟。 |
password |
string |
备份时加密的密码。 |
retentionPeriod |
integer (int32) |
备份的保留期:1-90 天。 |
storageAccessKey |
string |
将备份到的存储帐户密钥。 |
storageAccountUrl |
string |
将备份到的存储帐户 URL。 |
storageContainerName |
string |
将备份到的存储容器名称。 |
AutoPatchingSettings
设置一个修补窗口,在此期间将应用 Windows 和 SQL 修补程序。
名称 | 类型 | 说明 |
---|---|---|
dayOfWeek |
应用修补程序的一周中的一天。 |
|
enable |
boolean |
在 SQL 虚拟机上启用或禁用自动修补。 |
maintenanceWindowDuration |
integer (int32) |
修补的持续时间。 |
maintenanceWindowStartingHour |
integer (int32) |
开始修补的一天中的一小时。 本地 VM 时间。 |
BackupScheduleType
备份计划类型。
值 | 说明 |
---|---|
Automated | |
Manual |
ConnectivityType
SQL Server 连接选项。
值 | 说明 |
---|---|
LOCAL | |
PRIVATE | |
PUBLIC |
createdByType
创建资源的标识的类型。
值 | 说明 |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DayOfWeek
应用修补程序的一周中的一天。
值 | 说明 |
---|---|
Everyday | |
Friday | |
Monday | |
Saturday | |
Sunday | |
Thursday | |
Tuesday | |
Wednesday |
DiskConfigurationType
要应用于 SQL Server 的磁盘配置。
值 | 说明 |
---|---|
ADD | |
EXTEND | |
NEW |
FullBackupFrequencyType
完整备份的频率。 在这两种情况下,完整备份将在下一个计划的时间范围内开始。
值 | 说明 |
---|---|
Daily | |
Weekly |
IdentityType
标识类型。 将此设置为“SystemAssigned”,以便自动为资源创建和分配 Azure Active Directory 主体。
值 | 说明 |
---|---|
None | |
SystemAssigned |
KeyVaultCredentialSettings
将 SQL 虚拟机配置为能够连接到 Azure Key Vault 服务。
名称 | 类型 | 说明 |
---|---|---|
azureKeyVaultUrl |
string |
Azure Key Vault URL。 |
credentialName |
string |
凭据名称。 |
enable |
boolean |
启用或禁用密钥保管库凭据设置。 |
servicePrincipalName |
string |
用于访问密钥保管库的服务主体名称。 |
servicePrincipalSecret |
string |
用于访问密钥保管库的服务主体名称机密。 |
ResourceIdentity
资源的 Azure Active Directory 标识配置。
名称 | 类型 | 说明 |
---|---|---|
principalId |
string (uuid) |
Azure Active Directory 主体 ID。 |
tenantId |
string (uuid) |
Azure Active Directory 租户 ID。 |
type |
标识类型。 将此设置为“SystemAssigned”,以便自动为资源创建和分配 Azure Active Directory 主体。 |
Schedule
名称 | 类型 | 说明 |
---|---|---|
dayOfWeek |
运行评估的一周中的一天。 |
|
enable |
boolean |
在 SQL 虚拟机上启用或禁用评估计划。 |
monthlyOccurrence |
integer (int32) |
在一个月内发生 DayOfWeek 日期以安排评估。 采用值:1,2,3,4 和 -1。 对月份的最后一天使用 -1 OfWeek 日期 |
startTime |
string |
以 HH:mm 格式表示的一天时间。例如17:30 |
weeklyInterval |
integer (int32) |
计划 2 个评估运行之间的周数。 从 1-6 获取值 |
ServerConfigurationsManagementSettings
设置连接、存储和工作负荷设置。
名称 | 类型 | 说明 |
---|---|---|
additionalFeaturesServerConfigurations |
其他 SQL 功能设置。 |
|
sqlConnectivityUpdateSettings |
SQL 连接类型设置。 |
|
sqlInstanceSettings |
SQL 实例设置。 |
|
sqlStorageUpdateSettings |
SQL 存储更新设置。 |
|
sqlWorkloadTypeUpdateSettings |
SQL 工作负荷类型设置。 |
SqlConnectivityUpdateSettings
设置 SQL Server 的访问级别和网络端口设置。
名称 | 类型 | 说明 |
---|---|---|
connectivityType |
SQL Server 连接选项。 |
|
port |
integer (int32) |
SQL Server 端口。 |
sqlAuthUpdatePassword |
string |
SQL Server sysadmin 登录密码。 |
sqlAuthUpdateUserName |
string |
要创建的 SQL Server sysadmin 登录名。 |
SqlImageSku
SQL Server 版本类型。
值 | 说明 |
---|---|
Developer | |
Enterprise | |
Express | |
Standard | |
Web |
SQLInstanceSettings
设置 SQL Server 的服务器/实例级设置。
名称 | 类型 | 说明 |
---|---|---|
collation |
string |
SQL Server 排序规则。 |
isIfiEnabled |
boolean |
SQL Server IFI。 |
isLpimEnabled |
boolean |
SQL Server LPIM。 |
isOptimizeForAdHocWorkloadsEnabled |
boolean |
SQL Server Optimize for Adhoc workloads. |
maxDop |
integer (int32) |
SQL Server MAXDOP。 |
maxServerMemoryMB |
integer (int32) |
SQL Server 最大内存。 |
minServerMemoryMB |
integer (int32) |
SQL Server 最小内存。 |
SqlManagementMode
SQL Server 管理类型。
值 | 说明 |
---|---|
Full | |
LightWeight | |
NoAgent |
SqlServerLicenseType
SQL Server 许可证类型。
值 | 说明 |
---|---|
AHUB | |
DR | |
PAYG |
SQLStorageSettings
设置 SQL Server 的磁盘存储设置。
名称 | 类型 | 说明 |
---|---|---|
defaultFilePath |
string |
SQL Server 默认文件路径 |
luns |
integer[] (int32) |
磁盘的逻辑单元号。 |
SqlStorageUpdateSettings
设置 SQL Server 的磁盘存储设置。
名称 | 类型 | 说明 |
---|---|---|
diskConfigurationType |
要应用于 SQL Server 的磁盘配置。 |
|
diskCount |
integer (int32) |
虚拟机磁盘计数。 |
startingDeviceId |
integer (int32) |
要更新的第一个磁盘的设备 ID。 |
SQLTempDbSettings
名称 | 类型 | 说明 |
---|---|---|
dataFileCount |
integer (int32) |
SQL Server tempdb 数据文件计数 |
dataFileSize |
integer (int32) |
SQL Server tempdb 数据文件大小 |
dataGrowth |
integer (int32) |
SQL Server tempdb 数据文件自动增长大小 |
defaultFilePath |
string |
SQL Server 默认文件路径 |
logFileSize |
integer (int32) |
SQL Server tempdb 日志文件大小 |
logGrowth |
integer (int32) |
SQL Server tempdb 日志文件自动增长大小 |
luns |
integer[] (int32) |
磁盘的逻辑单元号。 |
persistFolder |
boolean |
SQL Server tempdb persist 文件夹选项 |
persistFolderPath |
string |
SQL Server tempdb 保留文件夹位置 |
SqlVirtualMachine
SQL 虚拟机。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID。 |
identity |
服务器的 Azure Active Directory 标识。 |
|
location |
string |
资源位置。 |
name |
string |
资源名称。 |
properties.assessmentSettings |
评估设置。 |
|
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 |
存储配置设置。 |
|
properties.virtualMachineResourceId |
string |
从 SQL 市场映像创建的基础虚拟机的 ARM 资源 ID。 |
properties.wsfcDomainCredentials |
用于为 SQL 可用性组设置 Windows Server 故障转移群集的域凭据。 |
|
properties.wsfcStaticIp |
string |
用于为 SQL 可用性组设置 Windows Server 故障转移群集的域凭据。 |
systemData |
与创建和上次修改资源相关的元数据。 |
|
tags |
object |
资源标记。 |
type |
string |
资源类型。 |
SqlVirtualMachineListResult
SQL 虚拟机的列表。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
用于检索下一页结果的链接。 |
value |
结果数组。 |
SqlWorkloadType
SQL Server 工作负荷类型。
值 | 说明 |
---|---|
DW | |
GENERAL | |
OLTP |
SqlWorkloadTypeUpdateSettings
设置工作负荷类型以优化 SQL Server 的存储。
名称 | 类型 | 说明 |
---|---|---|
sqlWorkloadType |
SQL Server 工作负荷类型。 |
StorageConfigurationSettings
SQL 数据、日志和 TempDb 的存储配置。
名称 | 类型 | 说明 |
---|---|---|
diskConfigurationType |
要应用于 SQL Server 的磁盘配置。 |
|
sqlDataSettings |
SQL Server 数据存储设置。 |
|
sqlLogSettings |
SQL Server 日志存储设置。 |
|
sqlSystemDbOnDataDisk |
boolean |
DataPool 上的 SQL Server SystemDb 存储(如果为 true)。 |
sqlTempDbSettings |
SQL Server TempDb 存储设置。 |
|
storageWorkloadType |
存储工作负荷类型。 |
StorageWorkloadType
存储工作负荷类型。
值 | 说明 |
---|---|
DW | |
GENERAL | |
OLTP |
systemData
与创建和上次修改资源相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string (date-time) |
资源创建时间戳(UTC)。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识的类型。 |
|
lastModifiedAt |
string (date-time) |
上次修改的资源时间戳(UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识的类型。 |
WsfcDomainCredentials
用于为 SQL 可用性组设置 Windows Server 故障转移群集的域凭据。
名称 | 类型 | 说明 |
---|---|---|
clusterBootstrapAccountPassword |
string |
群集启动帐户密码。 |
clusterOperatorAccountPassword |
string |
群集操作员帐户密码。 |
sqlServiceAccountPassword |
string |
SQL 服务帐户密码。 |