Databases - Get

服務:: SQL Database

API 版本:: 2023-08-01

取得資料庫。

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

含選擇性參數:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?$expand={$expand}&$filter={$filter}&api-version=2023-08-01

URI 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	資料庫的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure Resource Manager API 或入口網站取得此值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。
$expand	query		string	要包含在回應中的子資源。
$filter	query		string	篩選集合中元素的 OData 篩選表示式。

回應

名稱	類型	Description
200 OK	Database	已成功擷取指定的資料庫。
Other Status Codes	ErrorResponse	錯誤回應： *** 400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業 400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ResourceNotFound - 找不到要求的資源。

名稱

類型

Description

200 OK

Database

已成功擷取指定的資料庫。

Other Status Codes

ErrorResponse

錯誤回應： ***

400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業
400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業
404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。
404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器
404 ResourceNotFound - 找不到要求的資源。

範例

Gets a database configured with Default enclave type.

Gets a database configured with VBS enclave type.

Gets a database with Availability zone specified.

Gets a database with database level keys expanded.

Gets a database.

Gets a database configured with Default enclave type.

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetVCoreDatabaseDefaultEnclave.json
// this example is just showing the usage of "Databases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// invoke the operation
SqlDatabaseResource result = await sqlDatabase.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

範例回覆

狀態碼:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "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_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_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",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "preferredEnclaveType": "Default"
  },
  "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"
}

Gets a database configured with VBS enclave type.

範例要求

HTTP
dotnet

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetVCoreDatabaseVBSEnclave.json
// this example is just showing the usage of "Databases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// invoke the operation
SqlDatabaseResource result = await sqlDatabase.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

範例回覆

狀態碼:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "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_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_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",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "preferredEnclaveType": "VBS"
  },
  "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"
}

Gets a database with Availability zone specified.

範例要求

HTTP
dotnet

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetDatabaseWithAvailabilityZone.json
// this example is just showing the usage of "Databases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// invoke the operation
SqlDatabaseResource result = await sqlDatabase.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

範例回覆

狀態碼:: 200

{
  "sku": {
    "name": "S0",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isLedgerOn": false,
    "availabilityZone": "1"
  },
  "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"
}

Gets a database with database level keys expanded.

範例要求

HTTP
dotnet

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?$expand=keys&api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetVCoreDatabaseWithExpandEqualsKeys.json
// this example is just showing the usage of "Databases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// invoke the operation
string expand = "keys";
SqlDatabaseResource result = await sqlDatabase.GetAsync(expand: expand);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

範例回覆

狀態碼:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "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_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_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",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "keys": {
      "https://your-key-vault-name.vault.azure.net/yourKey/yourKeyVersion": {},
      "https://your-key-vault-name.vault.azure.net/yourKey2/yourKey2Version": {}
    },
    "encryptionProtector": "https://your-key-vault-name.vault.azure.net/yourKey/yourKeyVersion"
  },
  "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"
}

Gets a database.

範例要求

HTTP
dotnet

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetVCoreDatabase.json
// this example is just showing the usage of "Databases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// invoke the operation
SqlDatabaseResource result = await sqlDatabase.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

範例回覆

狀態碼:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "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_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_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",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "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"
}

定義

名稱	Description
AlwaysEncryptedEnclaveType	資料庫上要求的記憶體保護區類型，也就是預設或 VBS記憶體保護區。
AvailabilityZoneType	指定資料庫釘選到的可用性區域。
BackupStorageRedundancy	用來儲存此資料庫的備份的記憶體帳戶類型。
CatalogCollationType	元資料目錄的定序。
CreateMode	指定資料庫建立模式。默認值：定期建立資料庫。複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。
Database	資料庫資源。
DatabaseIdentity	資源的 Azure Active Directory 身分識別設定。
DatabaseIdentityType	識別類型
DatabaseKey	用於待用加密的資料庫層級金鑰。
DatabaseKeyType	資料庫金鑰類型。只有支援的值為『AzureKeyVault』。
DatabaseLicenseType	要套用此資料庫的授權類型。如果您需要授權，或擁有授權且符合 Azure Hybrid Benefit 資格，請 `LicenseIncludedBasePrice`。
DatabaseReadScale	唯讀路由的狀態。如果啟用，在其連接字串中將應用程式意圖設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。不適用於彈性集區內的超大規模資料庫。
DatabaseStatus	資料庫的狀態。
DatabaseUserIdentity	資源的 Azure Active Directory 身分識別設定。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
FreeLimitExhaustionBehavior	指定免費資料庫用完每月可用限制時的行為。 AutoPause：資料庫會在當月剩餘時間的可用限制用盡時自動暫停。 BillForUsage：資料庫會在免費限制用盡時繼續上線，並收取任何超額費用。
SampleName	建立這個資料庫時要套用的範例架構名稱。
SecondaryType	如果資料庫是輔助資料庫，則為次要類型。有效值為 Geo、Named 和 Standby。
Sku	ARM 資源 SKU。

AlwaysEncryptedEnclaveType

列舉型別

資料庫上要求的記憶體保護區類型，也就是預設或 VBS記憶體保護區。

值	Description
Default
VBS

AvailabilityZoneType

列舉型別

指定資料庫釘選到的可用性區域。

值	Description
NoPreference
1
2
3

BackupStorageRedundancy

列舉型別

用來儲存此資料庫的備份的記憶體帳戶類型。

值	Description
Geo
Local
Zone
GeoZone

CatalogCollationType

列舉型別

元資料目錄的定序。

值	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

列舉型別

指定資料庫建立模式。

默認值：定期建立資料庫。

複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。

次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。

PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。

復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。

還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。

RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。

DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。

值	Description
Default
Copy
Secondary
PointInTimeRestore
Restore
Recovery
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
OnlineSecondary

Database

Object

資料庫資源。

名稱	類型	Description
id	string	資源標識碼。
identity	DatabaseIdentity	資料庫的 Azure Active Directory 身分識別。
kind	string	資料庫種類。這是用於 Azure 入口網站體驗的元數據。
location	string	資源位置。
managedBy	string	管理資料庫的資源。
name	string	資源名稱。
properties.autoPauseDelay	integer (int32)	在幾分鐘后自動暫停資料庫的時間。 -1 值表示已停用自動暫停
properties.availabilityZone	AvailabilityZoneType	指定資料庫釘選到的可用性區域。
properties.catalogCollation	CatalogCollationType	元資料目錄的定序。
properties.collation	string	資料庫的定序。
properties.createMode	CreateMode	指定資料庫建立模式。默認值：定期建立資料庫。複製：建立資料庫做為現有資料庫的複本。 sourceDatabaseId 必須指定為源資料庫的資源標識碼。次要：建立資料庫做為現有資料庫的次要複本。 sourceDatabaseId 必須指定為現有主資料庫的資源標識碼。 PointInTimeRestore：藉由還原現有資料庫的時間點備份來建立資料庫。 sourceDatabaseId 必須指定為現有資料庫的資源標識符，而且必須指定 restorePointInTime。復原：藉由還原異地復寫備份來建立資料庫。 sourceDatabaseId 必須指定為要還原的可復原資料庫資源標識符。還原：藉由還原已刪除資料庫的備份來建立資料庫。必須指定sourceDatabaseId。如果 sourceDatabaseId 是資料庫的原始資源識別碼，則必須指定 sourceDatabaseDeletionDate。否則，sourceDatabaseId 必須是可還原的卸除資料庫資源標識符，而且會忽略 sourceDatabaseDeletionDate。 restorePointInTime 也可以指定為從先前的時間點還原。 RestoreLongTermRetentionBackup：從長期保留保存庫還原來建立資料庫。 recoveryServicesRecoveryPointResourceId 必須指定為恢復點資源標識符。 DataWarehouse 版本不支援 Copy、Secondary 和 RestoreLongTermRetentionBackup。
properties.creationDate	string (date-time)	資料庫的建立日期（ISO8601格式）。
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	用來儲存此資料庫的備份的記憶體帳戶類型。
properties.currentServiceObjectiveName	string	資料庫目前的服務等級目標名稱。
properties.currentSku	Sku	SKU 的名稱和層。
properties.databaseId	string (uuid)	資料庫的標識碼。
properties.defaultSecondaryLocation	string	這個資料庫的預設次要區域。
properties.earliestRestoreDate	string (date-time)	這會記錄此資料庫最早的開始日期和時間（ISO8601格式）。
properties.elasticPoolId	string (arm-id)	包含此資料庫之彈性集區的資源標識碼。
properties.encryptionProtector	string	如果資料庫已針對每個資料庫客戶管理的金鑰進行設定，則為資料庫的 Azure 金鑰保存庫 URI。
properties.encryptionProtectorAutoRotation	boolean	啟用或停用資料庫加密保護裝置 AKV 金鑰自動輪替的旗標。
properties.failoverGroupId	string	此資料庫所屬的故障轉移群組資源標識碼。
properties.federatedClientId	string (uuid)	用於每個資料庫跨租使用者的用戶端標識碼 CMK 案例
properties.freeLimitExhaustionBehavior	FreeLimitExhaustionBehavior	指定免費資料庫用完每月可用限制時的行為。 AutoPause：資料庫會在當月剩餘時間的可用限制用盡時自動暫停。 BillForUsage：資料庫會在免費限制用盡時繼續上線，並收取任何超額費用。
properties.highAvailabilityReplicaCount	integer (int32)	與用來提供高可用性的商業關鍵、進階或超大規模資料庫相關聯的次要複本數目。不適用於彈性集區內的超大規模資料庫。
properties.isInfraEncryptionEnabled	boolean	此資料庫已啟用基礎結構加密。
properties.isLedgerOn	boolean	這個資料庫是否為總賬資料庫，這表示資料庫中的所有數據表都是總賬數據表。注意：建立資料庫之後，就無法變更此屬性的值。
properties.keys	<string, DatabaseKey>	要使用的使用者指派身分識別的資源標識碼
properties.licenseType	DatabaseLicenseType	要套用此資料庫的授權類型。如果您需要授權，或擁有授權且符合 Azure Hybrid Benefit 資格，請 `LicenseIncludedBasePrice`。
properties.longTermRetentionBackupResourceId	string (arm-id)	與此資料庫建立作業相關聯的長期保留備份資源標識符。
properties.maintenanceConfigurationId	string	指派給資料庫的維護組態標識碼。此組態會定義維護更新發生的期間。
properties.manualCutover	boolean	客戶控制手動完全移轉是否需要在更新資料庫作業期間完成超大規模資料庫層。只有在將資料庫從業務關鍵/一般用途/進階/標準層調整為超大規模資料庫層時，才適用此屬性。指定manualCutover時，調整作業會等候使用者輸入觸發超大規模資料庫完全移轉。若要觸發完全移轉，請在調整作業處於等候狀態時提供『performCutover』參數。
properties.maxLogSizeBytes	integer (int64)	這個資料庫的記錄大小上限。
properties.maxSizeBytes	integer (int64)	以位元組表示的資料庫大小上限。
properties.minCapacity	number (double)	資料庫一律配置的最小容量，如果未暫停，則為
properties.pausedDate	string (date-time)	用戶設定或動作暫停資料庫的日期（ISO8601格式）。如果資料庫已就緒，則為 Null。
properties.performCutover	boolean	在調整作業進行中時，觸發客戶控制的手動完全移轉。這個屬性參數僅適用於起始與 'manualCutover' 參數一起起始的調整作業。只有當資料庫從業務關鍵/一般用途/進階/標準層調整至超大規模資料庫層級正在進行時，才適用此屬性。指定了performCutover時，調整作業會觸發完全移轉，並執行超大規模資料庫的角色變更。
properties.preferredEnclaveType	AlwaysEncryptedEnclaveType	資料庫上要求的記憶體保護區類型，也就是預設或 VBS記憶體保護區。
properties.readScale	DatabaseReadScale	唯讀路由的狀態。如果啟用，在其連接字串中將應用程式意圖設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。不適用於彈性集區內的超大規模資料庫。
properties.recoverableDatabaseId	string (arm-id)	與此資料庫建立作業相關聯的可復原資料庫資源標識符。
properties.recoveryServicesRecoveryPointId	string (arm-id)	與此資料庫建立作業相關聯的恢復點資源標識碼。
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	要用來儲存此資料庫的備份的記憶體帳戶類型。
properties.requestedServiceObjectiveName	string	資料庫所要求的服務等級目標名稱。
properties.restorableDroppedDatabaseId	string (arm-id)	與這個資料庫建立作業相關聯的可還原卸除資料庫資源標識符。
properties.restorePointInTime	string (date-time)	指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。
properties.resumedDate	string (date-time)	使用者動作或資料庫登入繼續資料庫的日期（ISO8601格式）。如果資料庫暫停，則為 Null。
properties.sampleName	SampleName	建立這個資料庫時要套用的範例架構名稱。
properties.secondaryType	SecondaryType	如果資料庫是輔助資料庫，則為次要類型。有效值為 Geo、Named 和 Standby。
properties.sourceDatabaseDeletionDate	string (date-time)	指定刪除資料庫的時間。
properties.sourceDatabaseId	string (arm-id)	與這個資料庫建立作業相關聯的源資料庫資源標識符。
properties.sourceResourceId	string (arm-id)	與這個資料庫建立作業相關聯的來源資源標識符。只有 DataWarehouse 版本才支援此屬性，而且允許跨訂用帳戶還原。指定 sourceResourceId 時，sourceDatabaseId、recoverableDatabaseId、restoreableDroppedDatabaseId 和 sourceDatabaseDeletionDate 不得指定，而 CreateMode 必須是 PointInTimeRestore、Restore 或 Recover。當 createMode 是 PointInTimeRestore 時，sourceResourceId 必須是現有資料庫或現有 sql 集區的資源標識碼，而且必須指定 restorePointInTime。當 createMode 為 Restore 時，sourceResourceId 必須是可還原卸除資料庫或可還原的已卸除 sql 集區的資源識別符。當 createMode 為 Recover 時，sourceResourceId 必須是可復原資料庫或可復原 SQL 集區的資源標識碼。當來源訂用帳戶屬於與目標訂用帳戶不同的租使用者時，“x-ms-authorization-auxiliary” 標頭必須包含來源租使用者的驗證令牌。如需「x-ms-authorization-auxiliary」標頭的詳細資訊，請參閱 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	資料庫的狀態。
properties.useFreeLimit	boolean	資料庫是否使用免費每月限制。在訂用帳戶中的一個資料庫上允許。
properties.zoneRedundant	boolean	此資料庫是否為區域備援，這表示此資料庫的複本會分散到多個可用性區域。
sku	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	資源類型。

DatabaseIdentity

Object

資源的 Azure Active Directory 身分識別設定。

名稱	類型	Description
tenantId	string (uuid)	Azure Active Directory 租用戶標識符。
type	DatabaseIdentityType	識別類型
userAssignedIdentities	<string, DatabaseUserIdentity>	要使用的使用者指派身分識別的資源標識碼

DatabaseIdentityType

列舉型別

識別類型

值	Description
None
UserAssigned

DatabaseKey

Object

用於待用加密的資料庫層級金鑰。

名稱	類型	Description
creationDate	string (date-time)	資料庫金鑰建立日期。
subregion	string	伺服器索引鍵的子區域。
thumbprint	string	資料庫金鑰的指紋。
type	DatabaseKeyType	資料庫金鑰類型。只有支援的值為『AzureKeyVault』。

DatabaseKeyType

列舉型別

資料庫金鑰類型。只有支援的值為『AzureKeyVault』。

值	Description
AzureKeyVault

DatabaseLicenseType

列舉型別

要套用此資料庫的授權類型。如果您需要授權，或擁有授權且符合 Azure Hybrid Benefit 資格，請 LicenseIncludedBasePrice。

值	Description
LicenseIncluded
BasePrice

DatabaseReadScale

列舉型別

唯讀路由的狀態。如果啟用，在其連接字串中將應用程式意圖設定為唯讀的連線，可能會路由傳送至相同區域中的唯讀次要複本。不適用於彈性集區內的超大規模資料庫。

值	Description
Enabled
Disabled

DatabaseStatus

列舉型別

資料庫的狀態。

值	Description
Online
Restoring
RecoveryPending
Recovering
Suspect
Offline
Standby
Shutdown
EmergencyMode
AutoClosed
Copying
Creating
Inaccessible
OfflineSecondary
Pausing
Paused
Resuming
Scaling
OfflineChangingDwPerformanceTiers
OnlineChangingDwPerformanceTiers
Disabled
Stopping
Stopped
Starting

DatabaseUserIdentity

Object

資源的 Azure Active Directory 身分識別設定。

名稱	類型	Description
clientId	string (uuid)	Azure Active Directory 用戶端標識符。
principalId	string (uuid)	Azure Active Directory 主體標識符。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

FreeLimitExhaustionBehavior

列舉型別

指定免費資料庫用完每月可用限制時的行為。

AutoPause：資料庫會在當月剩餘時間的可用限制用盡時自動暫停。

BillForUsage：資料庫會在免費限制用盡時繼續上線，並收取任何超額費用。

值	Description
AutoPause
BillOverUsage

SampleName

列舉型別

建立這個資料庫時要套用的範例架構名稱。

值	Description
AdventureWorksLT
WideWorldImportersStd
WideWorldImportersFull

SecondaryType

列舉型別

如果資料庫是輔助資料庫，則為次要類型。有效值為 Geo、Named 和 Standby。

值	Description
Geo
Named
Standby

Sku

Object

ARM 資源 SKU。

名稱	類型	Description
capacity	integer (int32)	特定 SKU 的容量。
family	string	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。
name	string	SKU 的名稱，通常是字母 + 數位碼，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的階層或版本，例如基本、進階。

共用方式為

Databases - Get

URI 參數

回應

範例

Gets a database configured with Default enclave type.

範例要求

範例回覆

Gets a database configured with VBS enclave type.

範例要求

範例回覆

Gets a database with Availability zone specified.

範例要求

範例回覆

Gets a database with database level keys expanded.

範例要求

範例回覆

Gets a database.

範例要求

範例回覆

定義

AlwaysEncryptedEnclaveType

AvailabilityZoneType

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseKey

DatabaseKeyType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FreeLimitExhaustionBehavior

SampleName

SecondaryType

Sku