Managed Databases - Create Or Update
새 데이터베이스를 만들거나 기존 데이터베이스를 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
database
|
path | True |
string |
데이터베이스의 이름입니다. |
managed
|
path | True |
string |
관리되는 인스턴스의 이름입니다. |
resource
|
path | True |
string |
리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다. |
subscription
|
path | True |
string |
Azure 구독을 식별하는 구독 ID입니다. |
api-version
|
query | True |
string |
요청에 사용할 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스 위치. |
properties.autoCompleteRestore |
boolean |
이 관리되는 데이터베이스의 자동 복원을 완료할지 여부입니다. |
|
properties.catalogCollation |
메타데이터 카탈로그의 데이터 정렬입니다. |
||
properties.collation |
string |
관리되는 데이터베이스의 데이터 정렬입니다. |
|
properties.createMode |
관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요). |
||
properties.lastBackupName |
string |
이 관리되는 데이터베이스의 복원을 위한 마지막 백업 파일 이름입니다. |
|
properties.longTermRetentionBackupResourceId |
string |
이 관리되는 데이터베이스의 복원에 사용할 장기 보존 백업의 이름입니다. |
|
properties.recoverableDatabaseId |
string |
이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다. |
|
properties.restorableDroppedDatabaseId |
string |
이 데이터베이스를 만들 때 복원할 복원 가능한 삭제된 데이터베이스 리소스 ID입니다. |
|
properties.restorePointInTime |
string |
조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. |
|
properties.sourceDatabaseId |
string |
이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다. |
|
properties.storageContainerSasToken |
string |
조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다. |
|
properties.storageContainerUri |
string |
조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다. |
|
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
데이터베이스를 업데이트했습니다. |
|
201 Created |
데이터베이스를 만들었습니다. |
|
202 Accepted |
수락됨 |
|
Other Status Codes |
오류 응답: ***
|
예제
Creates a new managed database by restoring from an external backup
샘플 요청
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01
{
"properties": {
"createMode": "RestoreExternalBackup",
"storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
"storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"autoCompleteRestore": true,
"lastBackupName": "last_backup_name"
},
"location": "southeastasia"
}
샘플 응답
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
"name": "testdb1",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
"name": "testdb2",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
Creates a new managed database from restoring a geo-replicated backup
샘플 요청
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/databases/testdb_recovered?api-version=2021-11-01
{
"location": "southeastasia",
"properties": {
"createMode": "Recovery",
"recoverableDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"
}
}
샘플 응답
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/recoverableDatabases/testdb_recovered",
"name": "testdb_recovered",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2018-11-07T04:41:33.937Z"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb_recovered",
"name": "testdb_recovered",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2018-11-07T04:41:33.937Z"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
Creates a new managed database from restoring a long term retention backup
샘플 요청
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01
{
"properties": {
"createMode": "RestoreExternalBackup",
"storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
"storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
"collation": "SQL_Latin1_General_CP1_CI_AS"
},
"location": "southeastasia"
}
샘플 응답
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
"name": "testdb1",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
"name": "testdb2",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
Creates a new managed database using point in time restore
샘플 요청
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01
{
"location": "southeastasia",
"properties": {
"createMode": "PointInTimeRestore",
"sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb",
"restorePointInTime": "2017-07-14T05:35:31.503Z"
}
}
샘플 응답
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
"name": "testdb1",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
"name": "testdb2",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
Creates a new managed database with maximal properties
샘플 요청
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia"
}
샘플 응답
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
"name": "testdb1",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
"name": "testdb2",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
Creates a new managed database with minimal properties
샘플 요청
샘플 응답
{
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
"name": "testdb1",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
{
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
"name": "testdb2",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"status": "Online",
"creationDate": "2017-06-07T04:41:33.937Z",
"defaultSecondaryLocation": "North Europe"
},
"type": "Microsoft.Sql/managedInstances/databases"
}
정의
Name | Description |
---|---|
Catalog |
메타데이터 카탈로그의 데이터 정렬입니다. |
Managed |
관리되는 데이터베이스 리소스입니다. |
Managed |
관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요). |
Managed |
데이터베이스의 상태입니다. |
CatalogCollationType
메타데이터 카탈로그의 데이터 정렬입니다.
Name | 형식 | Description |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
ManagedDatabase
관리되는 데이터베이스 리소스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
location |
string |
리소스 위치. |
name |
string |
리소스 이름입니다. |
properties.autoCompleteRestore |
boolean |
이 관리되는 데이터베이스의 자동 복원을 완료할지 여부입니다. |
properties.catalogCollation |
메타데이터 카탈로그의 데이터 정렬입니다. |
|
properties.collation |
string |
관리되는 데이터베이스의 데이터 정렬입니다. |
properties.createMode |
관리되는 데이터베이스 만들기 모드입니다. 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 |
데이터베이스의 상태입니다. |
|
properties.storageContainerSasToken |
string |
조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다. |
properties.storageContainerUri |
string |
조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다. |
tags |
object |
리소스 태그. |
type |
string |
리소스 종류. |
ManagedDatabaseCreateMode
관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
Name | 형식 | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
RestoreExternalBackup |
string |
|
RestoreLongTermRetentionBackup |
string |
ManagedDatabaseStatus
데이터베이스의 상태입니다.
Name | 형식 | Description |
---|---|---|
Creating |
string |
|
Inaccessible |
string |
|
Offline |
string |
|
Online |
string |
|
Restoring |
string |
|
Shutdown |
string |
|
Updating |
string |