Managed Databases - List By Instance

서비스:: SQL Database

API 버전:: 2023-08-01

관리되는 데이터베이스 목록을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases?api-version=2023-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
managedInstanceName	path	True	string	관리되는 인스턴스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	ManagedDatabaseListResult	데이터베이스 목록을 성공적으로 검색했습니다.
Other Status Codes	ErrorResponse	오류 응답: *** 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

Name

형식

Description

200 OK

ManagedDatabaseListResult

데이터베이스 목록을 성공적으로 검색했습니다.

Other Status Codes

ErrorResponse

오류 응답: ***

400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업
400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

예제

List databases by managed instances

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/managedInstance/databases?api-version=2023-08-01

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
      "location": "southeastasia",
      "name": "testdb1",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "status": "Online",
        "isLedgerOn": false
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb2",
      "location": "southeastasia",
      "name": "testdb2",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "status": "Online",
        "isLedgerOn": false
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    }
  ]
}

정의

Name	Description
CatalogCollationType	메타데이터 카탈로그의 데이터 정렬입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ManagedDatabase	관리되는 데이터베이스 리소스입니다.
ManagedDatabaseCreateMode	관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
ManagedDatabaseListResult	관리되는 데이터베이스 목록입니다.
ManagedDatabaseStatus	데이터베이스의 상태입니다.

CatalogCollationType

열거형

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

값	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ManagedDatabase

Object

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

Name	형식	Description
id	string	리소스 ID입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.autoCompleteRestore	boolean	이 관리되는 데이터베이스의 자동 복원을 완료할지 여부입니다.
properties.catalogCollation	CatalogCollationType	메타데이터 카탈로그의 데이터 정렬입니다.
properties.collation	string	관리되는 데이터베이스의 데이터 정렬입니다.
properties.createMode	ManagedDatabaseCreateMode	관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
properties.creationDate	string (date-time)	데이터베이스의 생성 날짜입니다.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	복원 가능한 구독 간 리소스 ID가 삭제되어 이 데이터베이스를 만들 때 복원할 수 있습니다.
properties.crossSubscriptionSourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 구독 간 원본 데이터베이스의 리소스 식별자입니다.
properties.crossSubscriptionTargetManagedInstanceId	string	구독 간 복원에 사용되는 대상 관리되는 인스턴스 ID입니다.
properties.defaultSecondaryLocation	string	지역 쌍을 이루는 지역입니다.
properties.earliestRestorePoint	string (date-time)	특정 시점 복원에 대한 가장 빠른 복원 시점입니다.
properties.failoverGroupId	string	이 관리되는 데이터베이스가 속한 인스턴스 장애 조치(failover) 그룹 리소스 식별자입니다.
properties.isLedgerOn	boolean	이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다.
properties.lastBackupName	string	이 관리되는 데이터베이스의 복원을 위한 마지막 백업 파일 이름입니다.
properties.longTermRetentionBackupResourceId	string	이 관리되는 데이터베이스의 복원에 사용할 장기 보존 백업의 이름입니다.
properties.recoverableDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.restorableDroppedDatabaseId	string	이 데이터베이스를 만들 때 복원할 복원 가능한 삭제된 데이터베이스 리소스 ID입니다.
properties.restorePointInTime	string (date-time)	조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.sourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.status	ManagedDatabaseStatus	데이터베이스의 상태입니다.
properties.storageContainerIdentity	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 사용됩니다. 스토리지 컨테이너 인증에 사용되는 ID를 지정합니다. 'SharedAccessSignature' 또는 'ManagedIdentity'일 수 있습니다. 지정하지 않으면 'SharedAccessSignature'가 가정됩니다.
properties.storageContainerSasToken	string	조건부. createMode가 RestoreExternalBackup이고 storageContainerIdentity가 ManagedIdentity가 아닌 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다.
properties.storageContainerUri	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다.
tags	object	리소스 태그.
type	string	리소스 종류입니다.

ManagedDatabaseCreateMode

열거형

관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).

값	Description
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseListResult

Object

관리되는 데이터베이스 목록입니다.

Name	형식	Description
nextLink	string	결과의 다음 페이지를 검색하는 링크입니다.
value	ManagedDatabase[]	결과 배열입니다.

ManagedDatabaseStatus

열거형

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

값	Description
Online
Offline
Shutdown
Creating
Inaccessible
Restoring
Updating
Stopping
Stopped
Starting
DbMoving
DbCopying

다음을 통해 공유

Managed Databases - List By Instance

URI 매개 변수

응답

예제

List databases by managed instances

샘플 요청

샘플 응답

정의

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus