Managed Instances - List

Başvuru

Hizmet:: SQL Database

API Sürümü:: 2021-11-01

Abonelikteki tüm yönetilen örneklerin listesini alır.

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.
$expand	query		string	Yanıta eklenecek alt kaynaklar.

Yanıtlar

Name	Tür	Description
200 OK	ManagedInstanceListResult	Yönetilen örneklerin listesi başarıyla alındı.
Other Status Codes		Hata Yanıtları: **

Örnekler

List managed instances

List managed instances with $expand=administrators/activedirectory

List managed instances

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


import com.azure.core.util.Context;

/** 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, 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

Örnek yanıt

Durum kodu:: 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

Örnek isteği

HTTP
Java

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


import com.azure.core.util.Context;

/** 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, 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

Örnek yanıt

Durum kodu:: 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
        }
      }
    }
  ]
}

Tanımlar

Name	Description
AdministratorType	Sunucu yöneticisinin türü.
BackupStorageRedundancy	Bu örneğe yönelik yedeklemeleri depolamak için kullanılan depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)
IdentityType	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.
ManagedInstance	yönetilen bir Azure SQL örneği.
ManagedInstanceExternalAdministrator	Active Directory yöneticisinin özellikleri.
ManagedInstanceLicenseType	Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).
ManagedInstanceListResult	Yönetilen örneklerin listesi.
ManagedInstancePecProperty	Yönetilen örnek altında özel uç nokta bağlantısı
ManagedInstancePrivateEndpointConnectionProperties	Özel uç nokta bağlantısının özellikleri.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Örneğe bağlanmak için kullanılan bağlantı türü.
ManagedServerCreateMode	Veritabanı oluşturma modunu belirtir. Varsayılan: Normal örnek oluşturma. Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
PrincipalType	Sunucu yöneticisinin Asıl Türü.
ResourceIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.
ServicePrincipal	Yönetilen örneğin bir kaynak için hizmet sorumlusu yapılandırması.
ServicePrincipalType	Hizmet sorumlusu türü.
Sku	ARM Kaynağı SKU'su.
UserIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.

AdministratorType

Sunucu yöneticisinin türü.

Name	Tür	Description
ActiveDirectory	string

BackupStorageRedundancy

Bu örneğe yönelik yedeklemeleri depolamak için kullanılan depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)

Name	Tür	Description
Geo	string
GeoZone	string
Local	string
Zone	string

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

Name	Tür	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ManagedInstance

yönetilen bir Azure SQL örneği.

Name	Tür	Description
id	string	Kaynak Kimliği.
identity	ResourceIdentity	Yönetilen örneğin Azure Active Directory kimliği.
location	string	Kaynak konumu.
name	string	Kaynak adı.
properties.administratorLogin	string	Yönetilen örneğin yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir).
properties.administratorLoginPassword	string	Yönetici oturum açma parolası (yönetilen örnek oluşturmak için gereklidir).
properties.administrators	ManagedInstanceExternalAdministrator	Sunucunun Azure Active Directory yöneticisi.
properties.collation	string	Yönetilen örneğin harmanlanması.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Bu örneğe yönelik yedeklemeleri depolamak için kullanılan depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)
properties.dnsZone	string	Yönetilen örneğin içinde olduğu Dns Bölgesi.
properties.dnsZonePartner	string	Bu yönetilen örnek oluşturulduktan sonra DNS bölgesi paylaşılacak olan başka bir yönetilen örneğin kaynak kimliği.
properties.fullyQualifiedDomainName	string	Yönetilen örneğin tam etki alanı adı.
properties.instancePoolId	string	Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği.
properties.keyId	string	Şifreleme için kullanılacak anahtarın CMK URI'si.
properties.licenseType	ManagedInstanceLicenseType	Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).
properties.maintenanceConfigurationId	string	Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Veritabanı oluşturma modunu belirtir. Varsayılan: Normal örnek oluşturma. Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
properties.minimalTlsVersion	string	En düşük TLS sürümü. İzin verilen değerler: 'Yok', '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Yönetilen örnekteki özel uç nokta bağlantılarının listesi.
properties.provisioningState	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
properties.proxyOverride	ManagedInstanceProxyOverride	Örneğe bağlanmak için kullanılan bağlantı türü.
properties.publicDataEndpointEnabled	boolean	Genel veri uç noktasının etkinleştirilip etkinleştirilmediği.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Bu örneğin yedeklerini depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)
properties.restorePointInTime	string	Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir.
properties.servicePrincipal	ServicePrincipal	Yönetilen örneğin hizmet sorumlusu.
properties.sourceManagedInstanceId	string	Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı.
properties.state	string	Yönetilen örneğin durumu.
properties.storageSizeInGB	integer	GB cinsinden depolama boyutu. En düşük değer: 32. En yüksek değer: 16384. Yalnızca 32 GB artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.
properties.subnetId	string	Yönetilen örneğin alt ağ kaynak kimliği.
properties.timezoneId	string	Saat diliminin kimliği. İzin verilen değerler Windows tarafından desteklenen saat dilimleridir. Windows, KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones altında kayıt defterinde kimliği de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları tutar. SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak bu kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz. Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir. Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
properties.vCores	integer	Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80.
properties.zoneRedundant	boolean	multi-az'nin etkinleştirilip etkinleştirilmediği.
sku	Sku	Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

ManagedInstanceExternalAdministrator

Active Directory yöneticisinin özellikleri.

Name	Tür	Description
administratorType	AdministratorType	Sunucu yöneticisinin türü.
azureADOnlyAuthentication	boolean	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.
login	string	Sunucu yöneticisinin oturum açma adı.
principalType	PrincipalType	Sunucu yöneticisinin Asıl Türü.
sid	string	Sunucu yöneticisinin SID (nesne kimliği).
tenantId	string	Yöneticinin kiracı kimliği.

ManagedInstanceLicenseType

Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).

Name	Tür	Description
BasePrice	string
LicenseIncluded	string

ManagedInstanceListResult

Yönetilen örneklerin listesi.

Name	Tür	Description
nextLink	string	Sonuçların sonraki sayfasını almak için bağlantı.
value	ManagedInstance[]	Sonuç dizisi.

ManagedInstancePecProperty

Yönetilen örnek altında özel uç nokta bağlantısı

Name	Tür	Description
id	string	Kaynak Kimliği.
properties	ManagedInstancePrivateEndpointConnectionProperties	Özel uç nokta bağlantı özellikleri

ManagedInstancePrivateEndpointConnectionProperties

Özel uç nokta bağlantısının özellikleri.

Name	Tür	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Bağlantının ait olduğu özel uç nokta.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Özel Uç Nokta Bağlantısının Bağlantı Durumu.
provisioningState	string	Özel Uç Nokta Bağlantısının Durumu.

ManagedInstancePrivateEndpointProperty

Name	Tür	Description
id	string	Özel uç noktanın kaynak kimliği.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name	Tür	Description
actionsRequired	string	Özel bağlantı hizmeti bağlantı açıklaması.
description	string	Özel bağlantı hizmeti bağlantı açıklaması.
status	string	Özel bağlantı hizmeti bağlantı durumu.

ManagedInstanceProxyOverride

Örneğe bağlanmak için kullanılan bağlantı türü.

Name	Tür	Description
Default	string
Proxy	string
Redirect	string

ManagedServerCreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.

Name	Tür	Description
Default	string
PointInTimeRestore	string

PrincipalType

Sunucu yöneticisinin Asıl Türü.

Name	Tür	Description
Application	string
Group	string
User	string

ResourceIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name	Tür	Description
principalId	string	Azure Active Directory asıl kimliği.
tenantId	string	Azure Active Directory kiracı kimliği.
type	IdentityType	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.
userAssignedIdentities	<string, UserIdentity>	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

ServicePrincipal

Yönetilen örneğin bir kaynak için hizmet sorumlusu yapılandırması.

Name	Tür	Description
clientId	string	Azure Active Directory uygulama istemci kimliği.
principalId	string	Azure Active Directory uygulama nesne kimliği.
tenantId	string	Azure Active Directory kiracı kimliği.
type	ServicePrincipalType	Hizmet sorumlusu türü.

ServicePrincipalType

Hizmet sorumlusu türü.

Name	Tür	Description
None	string
SystemAssigned	string

Sku

ARM Kaynağı SKU'su.

Name	Tür	Description
capacity	integer	Belirli bir SKU'nun kapasitesi.
family	string	Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir.
name	string	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.
size	string	Belirli bir SKU'nun boyutu
tier	string	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.

UserIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name	Tür	Description
clientId	string	Azure Active Directory istemci kimliği.
principalId	string	Azure Active Directory asıl kimliği.

Aracılığıyla paylaş

Managed Instances - List

URI Parametreleri

Yanıtlar

Örnekler

List managed instances

Örnek isteği

Örnek yanıt

List managed instances with $expand=administrators/activedirectory

Örnek isteği

Örnek yanıt

Tanımlar

AdministratorType

BackupStorageRedundancy

IdentityType

ManagedInstance

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstanceListResult

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PrincipalType

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

UserIdentity

Ek kaynaklar