Managed Instances - List

服務:

SQL Database

API 版本:

2021-11-01

取得訂用帳戶中所有受控實例的清單。

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

含選擇性參數:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2021-11-01

URI 參數

名稱	位於	必要	類型	Description
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。
$expand	query		string	要包含在回應中的子資源。

回應

名稱	類型	Description
200 OK	ManagedInstanceListResult	已成功擷取受控實例清單。
Other Status Codes		錯誤回應： ***

範例

List managed instances

List managed instances with $expand=administrators/activedirectory

List managed instances

範例要求

HTTP

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Sql/managedInstances?api-version=2021-11-01

Java

/**
 * Samples for ManagedInstances List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceList.json
     */
    /**
     * Sample code: List managed instances.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedInstances(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().list(null, 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": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 8,
        "storageSizeInGB": 1024,
        "licenseType": "LicenseIncluded",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    }
  ]
}

List managed instances with $expand=administrators/activedirectory

範例要求

HTTP

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Sql/managedInstances?api-version=2021-11-01

Java

/**
 * Samples for ManagedInstances List.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceListWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: List managed instances with $expand=administrators/activedirectory.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedInstancesWithExpandAdministratorsActivedirectory(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().list(null, 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": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 8,
        "storageSizeInGB": 1024,
        "licenseType": "LicenseIncluded",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        }
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        }
      }
    }
  ]
}

定義

名稱	Description
AdministratorType	伺服器管理員的類型。
BackupStorageRedundancy	用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage）
IdentityType	識別類型。 將此設定為 『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。
ManagedInstance	Azure SQL 受控實例。
ManagedInstanceExternalAdministrator	Active Directory 系統管理員的屬性。
ManagedInstanceLicenseType	授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。
ManagedInstanceListResult	受控實例的清單。
ManagedInstancePecProperty	受控實例下的私人端點連線
ManagedInstancePrivateEndpointConnectionProperties	私人端點連線的屬性。
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	用於連接到實例的連接類型。
ManagedServerCreateMode	指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。
PrincipalType	伺服器管理員的主體類型。
ResourceIdentity	資源的 Azure Active Directory 身分識別設定。
ServicePrincipal	資源的受控實例服務主體組態。
ServicePrincipalType	服務主體類型。
Sku	ARM 資源 SKU。
UserIdentity	資源的 Azure Active Directory 身分識別設定。

AdministratorType

列舉型別

伺服器管理員的類型。

值	Description
ActiveDirectory

BackupStorageRedundancy

列舉型別

用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage）

值	Description
Geo
GeoZone
Local
Zone

IdentityType

列舉型別

識別類型。 將此設定為 『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。

值	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Object

Azure SQL 受控實例。

名稱	類型	Description
id	string	資源標識碼。
identity	ResourceIdentity	受控實例的 Azure Active Directory 身分識別。
location	string	資源位置。
name	string	資源名稱。
properties.administratorLogin	string	受控實例的系統管理員用戶名稱。 只有在建立受控實例時才能指定 （而且是建立的必要專案）。
properties.administratorLoginPassword	string	系統管理員登入密碼（建立受控實例所需的密碼）。
properties.administrators	ManagedInstanceExternalAdministrator	伺服器的 Azure Active Directory 系統管理員。
properties.collation	string	受控實例的定序。
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage）
properties.dnsZone	string	受控實例位於的 Dns 區域。
properties.dnsZonePartner	string (arm-id)	另一個受控實例的資源標識符，此受控實例會在建立後共用其 DNS 區域。
properties.fullyQualifiedDomainName	string	受控實例的完整功能變數名稱。
properties.instancePoolId	string	這個受控伺服器所屬之實例集區的標識碼。
properties.keyId	string	要用於加密之金鑰的 CMK URI。
properties.licenseType	ManagedInstanceLicenseType	授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。
properties.maintenanceConfigurationId	string	指定要套用至這個受控實例的維護組態標識碼。
properties.managedInstanceCreateMode	ManagedServerCreateMode	指定資料庫建立模式。 默認值：定期建立實例。 還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。
properties.minimalTlsVersion	string	最低 TLS 版本。 允許的值：'None'、'1.0'、'1.1'、'1.2'
properties.primaryUserAssignedIdentityId	string (arm-id)	預設會使用之使用者指派身分識別的資源標識碼。
properties.privateEndpointConnections	ManagedInstancePecProperty[]	受控實例上的私人端點連線清單。
properties.provisioningState	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
properties.proxyOverride	ManagedInstanceProxyOverride	用於連接到實例的連接類型。
properties.publicDataEndpointEnabled	boolean	是否啟用公用資料端點。
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	要用來儲存此實例備份的記憶體帳戶類型。 選項為 Local （LocalRedundantStorage）、Zone （ZoneRedundantStorage）、Geo （GeoRedundantStorage） 和 GeoZone（GeoZoneRedundantStorage）
properties.restorePointInTime	string (date-time)	指定要還原以建立新資料庫的源資料庫的時間點（ISO8601格式）。
properties.servicePrincipal	ServicePrincipal	受控實例的服務主體。
properties.sourceManagedInstanceId	string (arm-id)	與這個實例建立作業相關聯的來源受控實例資源標識符。
properties.state	string	受控實例的狀態。
properties.storageSizeInGB	integer (int32)	以 GB 為單位的記憶體大小。 最小值：32。 最大值：16384。 僅允許 32 GB 的增量。 最大值取決於選取的硬體系列和虛擬核心數目。
properties.subnetId	string (arm-id)	受控實例的子網資源標識碼。
properties.timezoneId	string	時區的標識碼。 允許的值是 Windows 支援的時區。 Windows 會保留所支援時區的詳細數據，包括標識符，位於登錄KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones 下。 您可以透過 SQL Server 取得這些登錄值，方法是查詢 SELECT 名稱 AS timezone_id FROM sys.time_zone_info。 您也可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得標識符清單。 有效的時區標識符範例是 「Pacific Standard Time」 或 「W」。。 歐洲標準時間“。
properties.vCores	integer (int32)	虛擬核心數目。 允許的值：8、16、24、32、40、64、80。
properties.zoneRedundant	boolean	是否啟用 multi-az。
sku	Sku	受控實例 SKU。 sku.name 允許的值：GP_Gen5、GP_G8IM、GP_G8IH、BC_Gen5、BC_G8IM、BC_G8IH
tags	object	資源標籤。
type	string	資源類型。

ManagedInstanceExternalAdministrator

Object

Active Directory 系統管理員的屬性。

名稱	類型	Description
administratorType	AdministratorType	伺服器管理員的類型。
azureADOnlyAuthentication	boolean	僅啟用 Azure Active Directory 驗證。
login	string	伺服器管理員的登入名稱。
principalType	PrincipalType	伺服器管理員的主體類型。
sid	string (uuid)	伺服器管理員的 SID （物件識別符）。
tenantId	string (uuid)	系統管理員的租用戶標識碼。

ManagedInstanceLicenseType

列舉型別

授權類型。 可能的值為 'LicenseIncluded' （包含新 SQL 授權的一般價格） 和 'BasePrice' （為攜帶您自己的 SQL 授權而折扣 AHB 價格）。

值	Description
BasePrice
LicenseIncluded

ManagedInstanceListResult

Object

受控實例的清單。

名稱	類型	Description
nextLink	string	連結以擷取下一頁的結果。
value	ManagedInstance[]	結果的陣列。

ManagedInstancePecProperty

Object

受控實例下的私人端點連線

名稱	類型	Description
id	string	資源標識碼。
properties	ManagedInstancePrivateEndpointConnectionProperties	私人端點連線屬性

ManagedInstancePrivateEndpointConnectionProperties

Object

私人端點連線的屬性。

名稱	類型	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	線上所屬的私人端點。
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	私人端點連線的連接狀態。
provisioningState	string	私人端點連線的狀態。

ManagedInstancePrivateEndpointProperty

Object

名稱	類型	Description
id	string	私人端點的資源標識碼。

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object

名稱	類型	Description
actionsRequired	string	私人鏈接服務連線描述。
description	string	私人鏈接服務連線描述。
status	string	私人鏈接服務連線狀態。

ManagedInstanceProxyOverride

列舉型別

用於連接到實例的連接類型。

值	Description
Default
Proxy
Redirect

ManagedServerCreateMode

列舉型別

指定資料庫建立模式。

默認值：定期建立實例。

還原：藉由將一組備份還原至特定時間點來建立實例。 必須指定 RestorePointInTime 和 SourceManagedInstanceId。

值	Description
Default
PointInTimeRestore

PrincipalType

列舉型別

伺服器管理員的主體類型。

值	Description
Application
Group
User

ResourceIdentity

Object

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

名稱	類型	Description
principalId	string (uuid)	Azure Active Directory 主體標識符。
tenantId	string (uuid)	Azure Active Directory 租用戶標識符。
type	IdentityType	識別類型。 將此設定為 『SystemAssigned』，以自動建立和指派資源的 Azure Active Directory 主體。
userAssignedIdentities	<string,  UserIdentity>	要使用的使用者指派身分識別的資源標識碼

ServicePrincipal

Object

資源的受控實例服務主體組態。

名稱	類型	Description
clientId	string	Azure Active Directory 應用程式用戶端標識碼。
principalId	string	Azure Active Directory 應用程式對象識別碼。
tenantId	string	Azure Active Directory 租用戶標識符。
type	ServicePrincipalType	服務主體類型。

ServicePrincipalType

列舉型別

服務主體類型。

值	Description
None
SystemAssigned

Sku

Object

ARM 資源 SKU。

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

UserIdentity

Object

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

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