Databases - List By Server
데이터베이스 목록을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?$skipToken={$skipToken}&api-version=2021-11-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다. |
server
|
path | True |
string |
서버의 이름입니다. |
subscription
|
path | True |
string |
Azure 구독을 식별하는 구독 ID입니다. |
api-version
|
query | True |
string |
요청에 사용할 API 버전입니다. |
$skip
|
query |
string |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
데이터베이스 목록을 성공적으로 검색했습니다. |
|
Other Status Codes |
오류 응답: ***
|
예제
Gets a list of databases.
샘플 요청
샘플 응답
{
"value": [
{
"sku": {
"name": "BC_Gen4",
"tier": "BusinessCritical",
"capacity": 2
},
"kind": "v12.0,user,vcore",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"maxSizeBytes": 268435456000,
"status": "Online",
"databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
"creationDate": "2017-06-07T04:41:33.937Z",
"currentServiceObjectiveName": "BC_Gen4_2",
"requestedServiceObjectiveName": "BC_Gen4_2",
"defaultSecondaryLocation": "North Europe",
"catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
"licenseType": "LicenseIncluded",
"maxLogSizeBytes": 104857600,
"isInfraEncryptionEnabled": false,
"zoneRedundant": false,
"readScale": "Enabled",
"earliestRestoreDate": "2017-06-07T04:51:33.937Z",
"currentSku": {
"name": "BC_Gen4",
"tier": "BusinessCritical",
"capacity": 2
},
"currentBackupStorageRedundancy": "Zone",
"requestedBackupStorageRedundancy": "Zone",
"isLedgerOn": false
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"name": "testdb",
"type": "Microsoft.Sql/servers/databases"
},
{
"sku": {
"name": "System0",
"tier": "System",
"capacity": 0
},
"kind": "v12.0,system",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"maxSizeBytes": 32212254720,
"status": "Online",
"databaseId": "e6be351f-2cc9-4604-9e52-b0b28b2710b0",
"creationDate": "2017-06-07T04:23:42.537Z",
"currentServiceObjectiveName": "System0",
"requestedServiceObjectiveName": "System0",
"defaultSecondaryLocation": "North Europe",
"catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
"isInfraEncryptionEnabled": false,
"zoneRedundant": false,
"readScale": "Disabled",
"currentSku": {
"name": "System0",
"tier": "System",
"capacity": 0
},
"currentBackupStorageRedundancy": "Local",
"requestedBackupStorageRedundancy": "Local",
"isLedgerOn": false
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/master",
"name": "master",
"type": "Microsoft.Sql/servers/databases"
}
]
}
정의
Name | Description |
---|---|
Backup |
이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. |
Catalog |
메타데이터 카탈로그의 데이터 정렬입니다. |
Create |
데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 데이터베이스 만들기. 복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다. 보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. 복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime을 지정하여 이전 시점부터 복원할 수도 있습니다. RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다. DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다. |
Database |
데이터베이스 리소스입니다. |
Database |
리소스에 대한 Azure Active Directory ID 구성입니다. |
Database |
ID 유형 |
Database |
이 데이터베이스에 적용할 라이선스 유형입니다.
|
Database |
데이터베이스 목록입니다. |
Database |
읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. |
Database |
데이터베이스의 상태입니다. |
Database |
리소스에 대한 Azure Active Directory ID 구성입니다. |
Sample |
이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다. |
Secondary |
보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다. |
Sku |
ARM 리소스 SKU입니다. |
BackupStorageRedundancy
이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.
Name | 형식 | Description |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
CatalogCollationType
메타데이터 카탈로그의 데이터 정렬입니다.
Name | 형식 | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
CreateMode
데이터베이스 만들기 모드를 지정합니다.
기본값: 일반 데이터베이스 만들기.
복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.
보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.
PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.
복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.
복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime을 지정하여 이전 시점부터 복원할 수도 있습니다.
RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다.
DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
Name | 형식 | Description |
---|---|---|
Copy |
string |
|
Default |
string |
|
OnlineSecondary |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
Restore |
string |
|
RestoreExternalBackup |
string |
|
RestoreExternalBackupSecondary |
string |
|
RestoreLongTermRetentionBackup |
string |
|
Secondary |
string |
Database
데이터베이스 리소스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
identity |
데이터베이스의 Azure Active Directory ID입니다. |
|
kind |
string |
데이터베이스 종류입니다. Azure Portal 환경에 사용되는 메타데이터입니다. |
location |
string |
리소스 위치. |
managedBy |
string |
데이터베이스를 관리하는 리소스입니다. |
name |
string |
리소스 이름입니다. |
properties.autoPauseDelay |
integer |
데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다. |
properties.catalogCollation |
메타데이터 카탈로그의 데이터 정렬입니다. |
|
properties.collation |
string |
데이터베이스의 데이터 정렬입니다. |
properties.createMode |
데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 데이터베이스 만들기. 복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다. 보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. 복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime을 지정하여 이전 시점부터 복원할 수도 있습니다. RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다. DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다. |
|
properties.creationDate |
string |
데이터베이스의 생성 날짜(ISO8601 형식)입니다. |
properties.currentBackupStorageRedundancy |
이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. |
|
properties.currentServiceObjectiveName |
string |
데이터베이스의 현재 서비스 수준 목표 이름입니다. |
properties.currentSku |
SKU의 이름 및 계층입니다. |
|
properties.databaseId |
string |
데이터베이스의 ID입니다. |
properties.defaultSecondaryLocation |
string |
이 데이터베이스의 기본 보조 지역입니다. |
properties.earliestRestoreDate |
string |
이 데이터베이스에 복원을 사용할 수 있는 가장 빠른 시작 날짜와 시간을 기록합니다(ISO8601 형식). |
properties.elasticPoolId |
string |
이 데이터베이스를 포함하는 탄력적 풀의 리소스 식별자입니다. |
properties.failoverGroupId |
string |
이 데이터베이스가 속한 장애 조치(failover) 그룹 리소스 식별자입니다. |
properties.federatedClientId |
string |
데이터베이스별 테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID |
properties.highAvailabilityReplicaCount |
integer |
고가용성을 제공하는 데 사용되는 데이터베이스와 연결된 보조 복제본의 수입니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. |
properties.isInfraEncryptionEnabled |
boolean |
이 데이터베이스에 대해 인프라 암호화를 사용할 수 있습니다. |
properties.isLedgerOn |
boolean |
이 데이터베이스가 원장 데이터베이스인지 여부입니다. 즉, 데이터베이스의 모든 테이블은 원장 테이블입니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다. |
properties.licenseType |
이 데이터베이스에 적용할 라이선스 유형입니다.
|
|
properties.longTermRetentionBackupResourceId |
string |
이 데이터베이스의 만들기 작업과 관련된 장기 보존 백업의 리소스 식별자입니다. |
properties.maintenanceConfigurationId |
string |
데이터베이스에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다. |
properties.maxLogSizeBytes |
integer |
이 데이터베이스의 최대 로그 크기입니다. |
properties.maxSizeBytes |
integer |
바이트로 표현된 데이터베이스의 최대 크기입니다. |
properties.minCapacity |
number |
일시 중지되지 않은 경우 데이터베이스가 항상 할당할 최소 용량 |
properties.pausedDate |
string |
사용자 구성 또는 작업(ISO8601 형식)에 의해 데이터베이스가 일시 중지된 날짜입니다. 데이터베이스가 준비되면 Null입니다. |
properties.readScale |
읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. |
|
properties.recoverableDatabaseId |
string |
이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다. |
properties.recoveryServicesRecoveryPointId |
string |
이 데이터베이스의 만들기 작업과 연결된 복구 지점의 리소스 식별자입니다. |
properties.requestedBackupStorageRedundancy |
이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. |
|
properties.requestedServiceObjectiveName |
string |
데이터베이스의 요청된 서비스 수준 목표 이름입니다. |
properties.restorableDroppedDatabaseId |
string |
이 데이터베이스의 만들기 작업과 연결된 복원 가능한 삭제된 데이터베이스의 리소스 식별자입니다. |
properties.restorePointInTime |
string |
새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. |
properties.resumedDate |
string |
사용자 작업 또는 데이터베이스 로그인(ISO8601 형식)에 의해 데이터베이스가 다시 시작된 날짜입니다. 데이터베이스가 일시 중지된 경우 Null입니다. |
properties.sampleName |
이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다. |
|
properties.secondaryType |
보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다. |
|
properties.sourceDatabaseDeletionDate |
string |
데이터베이스가 삭제된 시간을 지정합니다. |
properties.sourceDatabaseId |
string |
이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다. |
properties.sourceResourceId |
string |
이 데이터베이스의 만들기 작업과 연결된 원본의 리소스 식별자입니다. 이 속성은 DataWarehouse 버전에서만 지원되며 구독 간에 복원할 수 있습니다. sourceResourceId를 지정하면 sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId 및 sourceDatabaseDeletionDate를 지정하지 않아야 하며 CreateMode는 PointInTimeRestore, Restore 또는 Recovery여야 합니다. createMode가 PointInTimeRestore인 경우 sourceResourceId는 기존 데이터베이스 또는 기존 sql 풀의 리소스 ID여야 하며 restorePointInTime을 지정해야 합니다. createMode가 복원인 경우 sourceResourceId는 복원 가능한 삭제된 데이터베이스 또는 복원 가능한 삭제된 sql 풀의 리소스 ID여야 합니다. createMode가 복구인 경우 sourceResourceId는 복구 가능한 데이터베이스 또는 복구 가능한 sql 풀의 리소스 ID여야 합니다. 원본 구독이 대상 구독과 다른 테넌트인 경우 "x-ms-authorization-auxiliary" 헤더에는 원본 테넌트용 인증 토큰이 포함되어야 합니다. "x-ms-authorization-auxiliary" 헤더에 대한 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant |
properties.status |
데이터베이스의 상태입니다. |
|
properties.zoneRedundant |
boolean |
이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다. |
sku |
데이터베이스 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 REST API 또는 다음 명령 중 하나를 사용합니다
|
|
tags |
object |
리소스 태그. |
type |
string |
리소스 종류. |
DatabaseIdentity
리소스에 대한 Azure Active Directory ID 구성입니다.
Name | 형식 | Description |
---|---|---|
tenantId |
string |
Azure Active Directory 테넌트 ID입니다. |
type |
ID 유형 |
|
userAssignedIdentities |
<string,
Database |
사용할 사용자 할당 ID의 리소스 ID |
DatabaseIdentityType
ID 유형
Name | 형식 | Description |
---|---|---|
None |
string |
|
UserAssigned |
string |
DatabaseLicenseType
이 데이터베이스에 적용할 라이선스 유형입니다.
LicenseIncluded
라이선스가 필요하거나 BasePrice
라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.
Name | 형식 | Description |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
DatabaseListResult
데이터베이스 목록입니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
연결하여 결과의 다음 페이지를 검색합니다. |
value |
Database[] |
결과 배열입니다. |
DatabaseReadScale
읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
DatabaseStatus
데이터베이스의 상태입니다.
Name | 형식 | Description |
---|---|---|
AutoClosed |
string |
|
Copying |
string |
|
Creating |
string |
|
Disabled |
string |
|
EmergencyMode |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
OfflineChangingDwPerformanceTiers |
string |
|
OfflineSecondary |
string |
|
Online |
string |
|
OnlineChangingDwPerformanceTiers |
string |
|
Paused |
string |
|
Pausing |
string |
|
Recovering |
string |
|
RecoveryPending |
string |
|
Restoring |
string |
|
Resuming |
string |
|
Scaling |
string |
|
Shutdown |
string |
|
Standby |
string |
|
Starting |
string |
|
Stopped |
string |
|
Stopping |
string |
|
Suspect |
string |
DatabaseUserIdentity
리소스에 대한 Azure Active Directory ID 구성입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
Azure Active Directory 클라이언트 ID입니다. |
principalId |
string |
Azure Active Directory 보안 주체 ID입니다. |
SampleName
이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.
Name | 형식 | Description |
---|---|---|
AdventureWorksLT |
string |
|
WideWorldImportersFull |
string |
|
WideWorldImportersStd |
string |
SecondaryType
보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다.
Name | 형식 | Description |
---|---|---|
Geo |
string |
|
Named |
string |
Sku
ARM 리소스 SKU입니다.
Name | 형식 | Description |
---|---|---|
capacity |
integer |
특정 SKU의 용량입니다. |
family |
string |
서비스에 동일한 SKU에 대해 서로 다른 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다. |
name |
string |
SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. |
size |
string |
특정 SKU의 크기 |
tier |
string |
특정 SKU의 계층 또는 버전(예: 기본, 프리미엄)입니다. |