Servers - List By Resource Group
지정된 리소스 그룹의 모든 서버를 나열합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/flexibleServers?api-version=2024-12-30
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Azure 작업이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
List servers in a resource group
샘플 요청
샘플 응답
{
"value": [
{
"name": "mysqltestserver1",
"type": "Microsoft.DBforMySQL/flexibleServers",
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver1",
"location": "Southeast Asia",
"properties": {
"administratorLogin": "cloudsa",
"availabilityZone": "1",
"backup": {
"backupIntervalHours": 24,
"backupRetentionDays": 7,
"earliestRestoreDate": "2021-06-17T07:08:17.4259886+00:00",
"geoRedundantBackup": "Disabled"
},
"databasePort": 3306,
"fullVersion": "5.7.44",
"fullyQualifiedDomainName": "mysqltestserver1.database.mysql.azure.com",
"highAvailability": {
"mode": "Disabled",
"state": "NotEnabled"
},
"maintenancePolicy": {
"patchStrategy": "Regular"
},
"maintenanceWindow": {
"batchOfMaintenance": "Default",
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
},
"network": {
"publicNetworkAccess": "Enabled"
},
"replicaCapacity": 10,
"replicationRole": "None",
"state": "Ready",
"storage": {
"autoGrow": "Enabled",
"iops": 369,
"storageRedundancy": "LocalRedundancy",
"storageSizeGB": 23,
"storageSku": "Premium_LRS"
},
"version": "5.7"
},
"sku": {
"name": "Standard_B1ms",
"tier": "Burstable"
},
"tags": {
"num": "1"
}
},
{
"name": "mysqltestserver2",
"type": "Microsoft.DBforMySQL/flexibleServers",
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver2",
"location": "Southeast Asia",
"properties": {
"administratorLogin": "cloudsa",
"availabilityZone": "2",
"backup": {
"backupIntervalHours": 24,
"backupRetentionDays": 7,
"earliestRestoreDate": "2021-06-17T07:08:17.4259886+00:00",
"geoRedundantBackup": "Disabled"
},
"databasePort": 3306,
"fullVersion": "5.7.44",
"fullyQualifiedDomainName": "mysqltestserver2.mysql.database.azure.com",
"highAvailability": {
"mode": "Disabled",
"state": "NotEnabled"
},
"maintenancePolicy": {
"patchStrategy": "Default"
},
"maintenanceWindow": {
"batchOfMaintenance": "Default",
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
},
"network": {
"publicNetworkAccess": "Enabled"
},
"replicaCapacity": 10,
"replicationRole": "None",
"state": "Ready",
"storage": {
"autoGrow": "Enabled",
"iops": 369,
"storageRedundancy": "LocalRedundancy",
"storageSizeGB": 23,
"storageSku": "Premium_LRS"
},
"version": "5.7"
},
"sku": {
"name": "Standard_D2ds_v4",
"tier": "GeneralPurpose"
},
"tags": {
"num": "1"
}
},
{
"name": "mysqltestserver3",
"type": "Microsoft.DBforMySQL/flexibleServers",
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver3",
"location": "Southeast Asia",
"properties": {
"administratorLogin": "cloudsa",
"availabilityZone": "1",
"backup": {
"backupIntervalHours": 24,
"backupRetentionDays": 7,
"earliestRestoreDate": "2021-06-24T06:28:19.0611667+00:00",
"geoRedundantBackup": "Disabled"
},
"databasePort": 3306,
"fullVersion": "5.7.44",
"fullyQualifiedDomainName": "mysqltestserver3.mysql.database.azure.com",
"highAvailability": {
"mode": "Disabled",
"state": "NotEnabled"
},
"maintenanceWindow": {
"batchOfMaintenance": "Default",
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
},
"network": {
"publicNetworkAccess": "Enabled"
},
"replicaCapacity": 10,
"replicationRole": "None",
"state": "Ready",
"storage": {
"autoGrow": "Enabled",
"iops": 600,
"storageRedundancy": "ZoneRedundancy",
"storageSizeGB": 100,
"storageSku": "Premium_ZRS"
},
"version": "5.7"
},
"sku": {
"name": "Standard_E2ds_v4",
"tier": "MemoryOptimized"
},
"tags": {
"num": "1"
}
}
]
}
정의
| Name | Description |
|---|---|
| Backup |
서버의 스토리지 프로필 속성 |
|
Batch |
사용하도록 설정된 경우 유지 관리의 일괄 처리: 서버의 사용자 지정 관리 유지 관리 기간입니다. |
|
created |
리소스를 만든 ID의 형식입니다. |
|
Create |
새 MySQL 서버를 만드는 모드입니다. |
|
Data |
cmk에 대한 날짜 암호화입니다. |
|
Data |
키 형식, cmk를 사용하도록 설정하기 위한 AzureKeyVault, cmk를 사용하지 않도록 설정하기 위한 SystemManaged입니다. |
|
Enable |
값이 'Enabled' 또는 'Disabled'인지 여부를 나타내는 열거형 |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
High |
서버의 고가용성 속성 |
|
High |
서버에 대한 고가용성 모드입니다. |
|
High |
서버 고가용성의 상태입니다. |
|
Import |
원본 관련 속성을 가져옵니다. |
|
Import |
가져오기 원본의 스토리지 유형입니다. |
|
Maintenance |
서버의 유지 관리 정책입니다. |
|
Maintenance |
서버의 유지 관리 기간입니다. |
|
Managed |
관리 서비스 ID의 유형입니다. |
|
My |
Bring Your Own Keys에 대한 ID를 구성하는 속성 |
|
My |
서버의 청구 정보 관련 속성입니다. |
| Network |
서버의 네트워크 관련 속성 |
|
Patch |
서버의 패치 전략을 나타내는 열거형 |
|
Private |
프라이빗 엔드포인트 리소스입니다. |
|
Private |
프라이빗 엔드포인트 연결 리소스입니다. |
|
Private |
현재 프로비저닝 상태입니다. |
|
Private |
프라이빗 엔드포인트 연결 상태입니다. |
|
Private |
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다. |
|
Replication |
복제 역할입니다. |
| Server |
서버를 나타냅니다. |
|
Server |
서버 목록 작업의 응답입니다. |
|
Server |
특정 SKU의 계층(예: GeneralPurpose)입니다. |
|
Server |
서버의 상태입니다. |
|
Server |
서버의 주 버전입니다. 8.0.21은 MySQL 8.0, 5.7.44는 MySQL 5.7을 의미합니다. |
| Storage |
서버의 스토리지 프로필 속성 |
|
Storage |
서버 스토리지의 중복 형식입니다. 매개 변수는 서버를 만드는 데 사용됩니다. |
|
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
|
User |
사용자 할당 ID의 메타데이터입니다. |
Backup
서버의 스토리지 프로필 속성
| Name | 형식 | Default value | Description |
|---|---|---|---|
| backupIntervalHours |
integer (int32) |
서버에 대한 백업 간격 시간입니다. |
|
| backupRetentionDays |
integer (int32) |
서버의 백업 보존 기간(일)입니다. |
|
| earliestRestoreDate |
string (date-time) |
가장 빠른 복원 지점 생성 시간(ISO8601 형식) |
|
| geoRedundantBackup | Disabled |
지역 중복 백업을 사용할 수 있는지 여부입니다. |
BatchOfMaintenance
사용하도록 설정된 경우 유지 관리의 일괄 처리: 서버의 사용자 지정 관리 유지 관리 기간입니다.
| 값 | Description |
|---|---|
| Default | |
| Batch1 | |
| Batch2 |
createdByType
리소스를 만든 ID의 형식입니다.
| 값 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreateMode
새 MySQL 서버를 만드는 모드입니다.
| 값 | Description |
|---|---|
| Default | |
| PointInTimeRestore | |
| Replica | |
| GeoRestore |
DataEncryption
cmk에 대한 날짜 암호화입니다.
| Name | 형식 | Description |
|---|---|---|
| geoBackupKeyURI |
string |
키 자격 증명 모음이 지역을 교차할 수 없으므로 지역 백업 키 URI, 지역 백업과 동일한 지역에 cmk 필요 |
| geoBackupUserAssignedIdentityId |
string |
ID가 지역을 교차할 수 없으므로 지역 백업 사용자 ID 리소스 ID, 지역 백업과 동일한 지역에 ID가 필요합니다. |
| primaryKeyURI |
string |
기본 키 URI |
| primaryUserAssignedIdentityId |
string |
기본 사용자 ID 리소스 ID |
| type |
키 형식, cmk를 사용하도록 설정하기 위한 AzureKeyVault, cmk를 사용하지 않도록 설정하기 위한 SystemManaged입니다. |
DataEncryptionType
키 형식, cmk를 사용하도록 설정하기 위한 AzureKeyVault, cmk를 사용하지 않도록 설정하기 위한 SystemManaged입니다.
| 값 | Description |
|---|---|
| AzureKeyVault | |
| SystemManaged |
EnableStatusEnum
값이 'Enabled' 또는 'Disabled'인지 여부를 나타내는 열거형
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
HighAvailability
서버의 고가용성 속성
| Name | 형식 | Description |
|---|---|---|
| mode |
서버에 대한 고가용성 모드입니다. |
|
| standbyAvailabilityZone |
string |
대기 서버의 가용성 영역입니다. |
| state |
서버 고가용성의 상태입니다. |
HighAvailabilityMode
서버에 대한 고가용성 모드입니다.
| 값 | Description |
|---|---|
| Disabled | |
| ZoneRedundant | |
| SameZone |
HighAvailabilityState
서버 고가용성의 상태입니다.
| 값 | Description |
|---|---|
| NotEnabled | |
| CreatingStandby | |
| Healthy | |
| FailingOver | |
| RemovingStandby |
ImportSourceProperties
원본 관련 속성을 가져옵니다.
| Name | 형식 | Description |
|---|---|---|
| dataDirPath |
string |
스토리지에 있는 데이터 디렉터리의 상대 경로입니다. |
| sasToken |
string (password) |
원본 스토리지에 액세스하기 위한 Sas 토큰입니다. sas 토큰에는 읽기 및 목록 권한이 필요합니다. |
| storageType |
가져오기 원본의 스토리지 유형입니다. |
|
| storageUrl |
string |
가져오기 원본 스토리지의 URI입니다. |
ImportSourceStorageType
가져오기 원본의 스토리지 유형입니다.
| 값 | Description |
|---|---|
| AzureBlob |
MaintenancePolicy
서버의 유지 관리 정책입니다.
| Name | 형식 | Description |
|---|---|---|
| patchStrategy |
이 서버의 패치 전략 |
MaintenanceWindow
서버의 유지 관리 기간입니다.
| Name | 형식 | Description |
|---|---|---|
| batchOfMaintenance |
사용하도록 설정된 경우 유지 관리의 일괄 처리: 서버의 사용자 지정 관리 유지 관리 기간입니다. |
|
| customWindow |
string |
사용자 지정 창을 사용할지 여부를 나타냅니다. |
| dayOfWeek |
integer (int32) |
유지 관리 기간의 요일 |
| startHour |
integer (int32) |
유지 관리 기간의 시작 시간 |
| startMinute |
integer (int32) |
유지 관리 기간의 시작 시간(분) |
ManagedServiceIdentityType
관리 서비스 ID의 유형입니다.
| 값 | Description |
|---|---|
| UserAssigned |
MySQLServerIdentity
Bring Your Own Keys에 대한 ID를 구성하는 속성
| Name | 형식 | Description |
|---|---|---|
| principalId |
string |
KeyVault의 ObjectId |
| tenantId |
string |
KeyVault의 TenantId |
| type |
관리 서비스 ID의 유형입니다. |
|
| userAssignedIdentities |
<string,
User |
사용자 할당 ID의 메타데이터입니다. |
MySQLServerSku
서버의 청구 정보 관련 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| name |
string |
sku의 이름(예: Standard_D32s_v3)입니다. |
| tier |
특정 SKU의 계층(예: GeneralPurpose)입니다. |
Network
서버의 네트워크 관련 속성
| Name | 형식 | Description |
|---|---|---|
| delegatedSubnetResourceId |
string |
서버에 대한 vnet을 설정하는 데 사용되는 위임된 서브넷 리소스 ID입니다. |
| privateDnsZoneResourceId |
string |
프라이빗 DNS 영역 리소스 ID입니다. |
| publicNetworkAccess |
이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 서버에 VNet 통합이 있는 경우 값은 '사용 안 함'입니다. |
PatchStrategy
서버의 패치 전략을 나타내는 열거형
| 값 | Description |
|---|---|
| Regular | |
| VirtualCanary |
PrivateEndpoint
프라이빗 엔드포인트 리소스입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
프라이빗 엔드포인트에 대한 ARM 식별자입니다. |
PrivateEndpointConnection
프라이빗 엔드포인트 연결 리소스입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
리소스의 이름 |
| properties.groupIds |
string[] |
프라이빗 엔드포인트 리소스의 그룹 ID입니다. |
| properties.privateEndpoint |
프라이빗 엔드포인트 리소스입니다. |
|
| properties.privateLinkServiceConnectionState |
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다. |
|
| properties.provisioningState |
프라이빗 엔드포인트 연결 리소스의 프로비전 상태입니다. |
|
| systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
현재 프로비저닝 상태입니다.
| 값 | Description |
|---|---|
| Succeeded | |
| Creating | |
| Deleting | |
| Failed |
PrivateEndpointServiceConnectionStatus
프라이빗 엔드포인트 연결 상태입니다.
| 값 | Description |
|---|---|
| Pending | |
| Approved | |
| Rejected |
PrivateLinkServiceConnectionState
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.
| Name | 형식 | Description |
|---|---|---|
| actionsRequired |
string |
서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다. |
| description |
string |
연결의 승인/거부 이유입니다. |
| status |
서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다. |
ReplicationRole
복제 역할입니다.
| 값 | Description |
|---|---|
| None | |
| Source | |
| Replica |
Server
서버를 나타냅니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
서버의 cmk ID입니다. |
|
| location |
string |
리소스가 있는 지리적 위치 |
| name |
string |
리소스의 이름 |
| properties.administratorLogin |
string |
서버의 관리자 로그인 이름입니다. 서버를 만들 때만 지정할 수 있습니다(만들기에 필요). |
| properties.administratorLoginPassword |
string (password) |
관리자 로그인의 암호입니다(서버 생성에 필요). |
| properties.availabilityZone |
string |
서버의 가용성 영역 정보입니다. |
| properties.backup |
서버의 관련 속성을 백업합니다. |
|
| properties.createMode |
새 MySQL 서버를 만드는 모드입니다. |
|
| properties.dataEncryption |
CMK에 대한 데이터 암호화입니다. |
|
| properties.databasePort |
integer (int32) |
서버 데이터베이스 포트입니다. 서버를 만들 때만 지정할 수 있습니다. |
| properties.fullVersion |
string |
메이저 버전 및 실제 엔진 버전 |
| properties.fullyQualifiedDomainName |
string |
서버의 정규화된 도메인 이름입니다. |
| properties.highAvailability |
서버의 고가용성 관련 속성입니다. |
|
| properties.importSourceProperties |
스토리지에서 가져오기 위한 원본 속성입니다. |
|
| properties.maintenancePolicy |
서버의 유지 관리 정책입니다. |
|
| properties.maintenanceWindow |
서버의 유지 관리 기간입니다. 알려진 문제: 서버를 만드는 동안 설정하거나 서버 업데이트 중에 다른 속성으로 업데이트할 수 없습니다. 는 별도로 업데이트해야 합니다. |
|
| properties.network |
서버의 네트워크 관련 속성입니다. |
|
| properties.privateEndpointConnections |
서버의 PrivateEndpointConnections 관련 속성입니다. |
|
| properties.replicaCapacity |
integer (int32) minimum: 0 |
주 서버에 있을 수 있는 최대 복제본 수입니다. |
| properties.replicationRole |
복제 역할입니다. |
|
| properties.restorePointInTime |
string (date-time) |
복원할 시간을 지정하는 복원 지점 생성 시간(ISO8601 형식)입니다. |
| properties.sourceServerResourceId |
string |
원본 MySQL 서버 ID입니다. |
| properties.state |
서버의 상태입니다. |
|
| properties.storage |
서버의 스토리지 관련 속성입니다. |
|
| properties.version |
MySQL의 주 버전입니다. 8.0.21은 MySQL 8.0, 5.7.44는 MySQL 5.7을 의미합니다. |
|
| sku |
서버의 SKU(가격 책정 계층)입니다. |
|
| systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
| tags |
object |
리소스 태그. |
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
ServerListResult
서버 목록 작업의 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| nextLink |
string (uri) |
항목의 다음 페이지에 대한 링크 |
| value |
Server[] |
이 페이지의 서버 항목 |
ServerSkuTier
특정 SKU의 계층(예: GeneralPurpose)입니다.
| 값 | Description |
|---|---|
| Burstable | |
| GeneralPurpose | |
| MemoryOptimized |
ServerState
서버의 상태입니다.
| 값 | Description |
|---|---|
| Ready | |
| Dropping | |
| Disabled | |
| Starting | |
| Stopping | |
| Stopped | |
| Updating |
ServerVersion
서버의 주 버전입니다. 8.0.21은 MySQL 8.0, 5.7.44는 MySQL 5.7을 의미합니다.
| 값 | Description |
|---|---|
| 5.7 | |
| 8.0.21 |
Storage
서버의 스토리지 프로필 속성
| Name | 형식 | Default value | Description |
|---|---|---|---|
| autoGrow | Disabled |
스토리지 자동 증가를 사용하도록 설정합니다. |
|
| autoIoScaling | Enabled |
IO 자동 크기 조정을 사용하도록 설정합니다. |
|
| iops |
integer (int32) |
서버에 대한 스토리지 IOPS입니다. |
|
| logOnDisk | Disabled |
로그온 디스크를 사용하도록 설정합니다. |
|
| storageRedundancy | LocalRedundancy |
서버 스토리지의 중복 형식입니다. 매개 변수는 서버를 만드는 데 사용됩니다. |
|
| storageSizeGB |
integer (int32) |
서버에 허용되는 최대 스토리지 크기입니다. |
|
| storageSku |
string |
서버 스토리지의 sku 이름입니다. |
StorageRedundancyEnum
서버 스토리지의 중복 형식입니다. 매개 변수는 서버를 만드는 데 사용됩니다.
| 값 | Description |
|---|---|
| LocalRedundancy | |
| ZoneRedundancy |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
| createdBy |
string |
리소스를 만든 ID입니다. |
| createdByType |
리소스를 만든 ID의 형식입니다. |
|
| lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
| lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
| lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |
UserAssignedIdentity
사용자 할당 ID의 메타데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| clientId |
string |
사용자 할당 ID의 클라이언트 ID |
| principalId |
string |
사용자 할당 ID의 보안 주체 ID |