Managed Databases - List By Instance

참조

서비스:: SQL Database

API 버전:: 2021-11-01

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

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

URI 매개 변수

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

응답

Name	형식	Description
200 OK	ManagedDatabaseListResult	데이터베이스 목록을 성공적으로 검색했습니다.
Other Status Codes		오류 응답: *** 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

Name

형식

Description

200 OK

ManagedDatabaseListResult

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

Other Status Codes

오류 응답: ***

404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

예제

List databases by managed instances

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


/**
 * Samples for ManagedDatabases ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseListByManagedInstance.
     * json
     */
    /**
     * Sample code: List databases by managed instances.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listDatabasesByManagedInstances(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().listByInstance("Test1", "managedInstance",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 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"
      },
      "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"
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    }
  ]
}

정의

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

CatalogCollationType

Enumeration

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

값	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

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	데이터베이스의 생성 날짜입니다.
properties.defaultSecondaryLocation	string	지역 쌍을 이루는 지역입니다.
properties.earliestRestorePoint	string	특정 시점 복원에 대한 가장 빠른 복원 시점입니다.
properties.failoverGroupId	string	이 관리형 데이터베이스가 속한 인스턴스 장애 조치(failover) 그룹 리소스 식별자입니다.
properties.lastBackupName	string	이 관리되는 데이터베이스의 복원을 위한 마지막 백업 파일 이름입니다.
properties.longTermRetentionBackupResourceId	string	이 관리되는 데이터베이스의 복원에 사용할 장기 보존 백업의 이름입니다.
properties.recoverableDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.restorableDroppedDatabaseId	string	이 데이터베이스를 만들 때 복원할 복원 가능한 삭제된 데이터베이스 리소스 ID입니다.
properties.restorePointInTime	string	조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.sourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.status	ManagedDatabaseStatus	데이터베이스의 상태입니다.
properties.storageContainerSasToken	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다.
properties.storageContainerUri	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다.
tags	object	리소스 태그.
type	string	리소스 종류.

ManagedDatabaseCreateMode

Enumeration

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

값	Description
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseListResult

Object

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

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

ManagedDatabaseStatus

Enumeration

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

값	Description
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

다음을 통해 공유

Managed Databases - List By Instance

URI 매개 변수

응답

예제

List databases by managed instances

샘플 요청

샘플 응답

정의

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus

추가 리소스