Databases - List By Server

데이터베이스의 목록을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?api-version=2021-02-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?$skipToken={$skipToken}&api-version=2021-02-01-preview

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

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

serverName
path True
  • string

서버의 이름입니다.

subscriptionId
path True
  • string

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

api-version
query True
  • string

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

$skipToken
query
  • string

응답

Name Type Description
200 OK

데이터베이스 목록을 검색 했습니다.

Other Status Codes

오류 응답: * * *

  • 404 SubscriptionDoesNotHaveServer-요청 된 서버를 찾을 수 없음

  • 404 ServerNotInSubscriptionResourceGroup-지정 된 서버가 지정 된 리소스 그룹 및 구독에 없습니다.

예제

Gets a list of databases.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases?api-version=2021-02-01-preview

Sample Response

{
  "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"
    }
  ]
}

정의

CatalogCollationType

메타데이터 카탈로그의 데이터 정렬입니다.

CreateMode

데이터베이스 생성 모드를 지정 합니다.

기본값: 일반 데이터베이스 만들기

Copy: 데이터베이스를 기존 데이터베이스의 복사본으로 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정 해야 합니다.

보조: 기존 데이터베이스의 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정 해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원 하 여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역 복제 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime을 지정하여 이전 시점부터 복원할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.

CurrentBackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.

Database

데이터베이스 리소스입니다.

DatabaseLicenseType

이 데이터베이스에 적용할 라이선스 유형입니다. LicenseIncluded 라이선스가 필요하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.

DatabaseListResult

데이터베이스 목록입니다.

DatabaseReadScale

읽기 전용 라우팅의 상태입니다. 사용하도록 설정하면 연결 문자열에서 애플리케이션 의도가 읽기 전으로 설정된 연결이 동일한 지역의 읽기용 보조 복제본으로 라우팅될 수 있습니다.

DatabaseStatus

데이터베이스의 상태입니다.

RequestedBackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다.

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.

SecondaryType

보조 데이터베이스인 경우 데이터베이스의 보조 유형입니다. 유효한 값은 Geo 및 Named입니다.

Sku

ARM 리소스 SKU입니다.

CatalogCollationType

메타데이터 카탈로그의 데이터 정렬입니다.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

데이터베이스 생성 모드를 지정 합니다.

기본값: 일반 데이터베이스 만들기

Copy: 데이터베이스를 기존 데이터베이스의 복사본으로 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정 해야 합니다.

보조: 기존 데이터베이스의 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정 해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원 하 여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역 복제 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime을 지정하여 이전 시점부터 복원할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.

Name Type Description
Copy
  • string
Default
  • string
OnlineSecondary
  • string
PointInTimeRestore
  • string
Recovery
  • string
Restore
  • string
RestoreExternalBackup
  • string
RestoreExternalBackupSecondary
  • string
RestoreLongTermRetentionBackup
  • string
Secondary
  • string

CurrentBackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

Database

데이터베이스 리소스입니다.

Name Type Description
id
  • string

리소스 ID입니다.

kind
  • string

데이터베이스의 종류입니다. Azure Portal 환경에 사용 되는 메타 데이터입니다.

location
  • string

리소스 위치.

managedBy
  • string

데이터베이스를 관리 하는 리소스입니다.

name
  • string

리소스 이름입니다.

properties.autoPauseDelay
  • integer

데이터베이스가 자동으로 일시 중지 된 후의 시간 (분)입니다. -1 값은 자동 일시 중지가 사용 되지 않음을 의미 합니다.

properties.catalogCollation

메타 데이터 카탈로그의 데이터 정렬입니다.

properties.collation
  • string

데이터베이스의 데이터 정렬입니다.

properties.createMode

데이터베이스 생성 모드를 지정 합니다.

기본값: 일반 데이터베이스 만들기

Copy: 데이터베이스를 기존 데이터베이스의 복사본으로 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정 해야 합니다.

보조: 기존 데이터베이스의 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정 해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원 하 여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정 해야 하며 restorePointInTime을 지정 해야 합니다.

복구: 지역에서 복제 된 백업을 복원 하 여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정 해야 합니다.

복원: 삭제 된 데이터베이스의 백업을 복원 하 여 데이터베이스를 만듭니다. sourceDatabaseId를 지정 해야 합니다. SourceDatabaseId가 데이터베이스의 원래 리소스 ID 인 경우 sourceDatabaseDeletionDate를 지정 해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제 된 데이터베이스 리소스 ID 여야 하 고 sourceDatabaseDeletionDate는 무시 됩니다. restorePointInTime는 이전 시점에서 복원 하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원 하 여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId은 복구 지점 리소스 ID로 지정 해야 합니다.

Copy, Secondary 및 RestoreLongTermRetentionBackup는 DataWarehouse 버전에서 지원 되지 않습니다.

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.highAvailabilityReplicaCount
  • integer

고가용성을 제공 하는 데 사용 되는 데이터베이스와 연결 된 보조 복제본의 수입니다.

properties.isInfraEncryptionEnabled
  • boolean

이 데이터베이스에 대해 인프라 암호화가 사용 하도록 설정 되어 있습니다.

properties.isLedgerOn
  • boolean

이 데이터베이스가 원장 데이터베이스 인지 여부입니다 .이는 데이터베이스의 모든 테이블이 원장 테이블 임을 의미 합니다. 참고: 데이터베이스를 만든 후에는이 속성의 값을 변경할 수 없습니다.

properties.licenseType

이 데이터베이스에 적용할 라이선스 형식입니다. LicenseIncluded 라이선스가 필요 하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우입니다.

properties.longTermRetentionBackupResourceId
  • string

이 데이터베이스의 만들기 작업과 관련 된 장기 보존 백업의 리소스 식별자입니다.

properties.maintenanceConfigurationId
  • string

데이터베이스에 할당 된 유지 관리 구성 id입니다. 이 구성은 유지 관리 업데이트가 수행 되는 기간을 정의 합니다.

properties.maxLogSizeBytes
  • integer

이 데이터베이스의 최대 로그 크기입니다.

properties.maxSizeBytes
  • integer

바이트 단위로 표시 된 데이터베이스의 최대 크기입니다.

properties.minCapacity
  • number

일시 중지 되지 않은 경우 데이터베이스에서 항상 할당 하는 최소 용량

properties.pausedDate
  • string

사용자 구성 또는 동작 (ISO8601 형식)에 의해 데이터베이스가 일시 중지 된 날짜입니다. 데이터베이스가 준비 된 경우 Null입니다.

properties.readScale

읽기 전용 라우팅의 상태입니다. 사용 하도록 설정 하면 연결 문자열에서 응용 프로그램 의도를 readonly로 설정 하는 연결이 동일한 지역의 읽기 전용 보조 복제본으로 라우팅될 수 있습니다.

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

보조 데이터베이스의 경우 데이터베이스의 보조 유형입니다. 유효한 값은 지역 및 이름입니다.

properties.sourceDatabaseDeletionDate
  • string

데이터베이스가 삭제 된 시간을 지정 합니다.

properties.sourceDatabaseId
  • string

이 데이터베이스의 만들기 작업과 연결 된 원본 데이터베이스의 리소스 식별자입니다.

properties.status

데이터베이스의 상태입니다.

properties.zoneRedundant
  • boolean

이 데이터베이스가 영역 중복 인지 여부입니다 .이는이 데이터베이스의 복제본이 여러 가용성 영역에 분산 됨을 의미 합니다.

sku

데이터베이스 SKU입니다.

Sku 목록은 지역 및 지원 제안에 따라 달라질 수 있습니다. Azure 지역의 구독에서 사용할 수 있는 sku (SKU 이름, 계층/버전, 제품군 및 용량 포함)를 확인 하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용 합니다.

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags
  • object

리소스 태그.

type
  • string

리소스 종류.

DatabaseLicenseType

이 데이터베이스에 적용할 라이선스 유형입니다. LicenseIncluded 라이선스가 필요하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseListResult

데이터베이스 목록입니다.

Name Type Description
nextLink
  • string

다음 결과 페이지를 검색 하는 링크입니다.

value

결과의 배열입니다.

DatabaseReadScale

읽기 전용 라우팅의 상태입니다. 사용하도록 설정하면 연결 문자열에서 애플리케이션 의도가 읽기 전으로 설정된 연결이 동일한 지역의 읽기용 보조 복제본으로 라우팅될 수 있습니다.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

데이터베이스의 상태입니다.

Name Type 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
Suspect
  • string

RequestedBackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다.

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.

Name Type Description
AdventureWorksLT
  • string
WideWorldImportersFull
  • string
WideWorldImportersStd
  • string

SecondaryType

보조 데이터베이스인 경우 데이터베이스의 보조 유형입니다. 유효한 값은 Geo 및 Named입니다.

Name Type Description
Geo
  • string
Named
  • string

Sku

ARM 리소스 SKU입니다.

Name Type Description
capacity
  • integer

특정 SKU의 용량입니다.

family
  • string

서비스에 동일한 SKU에 대해 서로 다른 하드웨어 생성이 있는 경우 여기에서 캡처할 수 있습니다.

name
  • string

SKU 이름입니다. 일반적으로 문자 + 숫자 코드 (예: P3)입니다.

size
  • string

특정 SKU의 크기

tier
  • string

특정 SKU의 계층 또는 버전입니다 (예: Basic, Premium).