Managed Instances - Get

Yönetilen örneği alır.

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

URI Parametreleri

Name In Required Type Description
managedInstanceName
path True
  • string

Yönetilen örneğin adı.

resourceGroupName
path True
  • string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.

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 Type Description
200 OK

Belirtilen yönetilen örnek başarıyla alındı.

Other Status Codes

Hata Yanıtları: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy - LRS/ZRS yedekleme depolama yedekliliği olan yönetilen örnekler için Geo-Restore izin verilmez.

  • 400 UpdatingInstanceAndBackupRedundancy - Örnek bölgesi yedekliliği ve yedek depolama yedekliliği aynı istekte güncelleştirilemez.

  • 400 ProvisioningDisabled - Kaynak işlemi yetkilisinden gelen hata iletisini olduğu gibi, değişiklik olmadan görüntüler

  • 400 AadOnlyAuthenticationIsEnabled - Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi. Sistem yöneticinize başvurun.

  • 400 ManagementServiceFeatureDisabled - Kullanıcı devre dışı bırakılmış bir özelliği kullanmaya çalıştı.

  • 404 SubscriptionNotFound - İstenen abonelik bulunamadı.

  • 404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup - Belirtilen yönetilen örnek belirtilen kaynak grubunda ve abonelikte yok.

  • 404 SubscriptionNotFound - İstenen abonelik bulunamadı.

  • 404 ResourceNotFound - İstenen kaynak bulunamadı.

  • 409 ConflictingManagedInstanceOperation - Yönetilen örnek için şu anda bir işlem devam ediyor.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - Örnek multi-az ancak yedekleme depolama alanı alanlar arası yedekliden alanlar arası yedekli olmayana güncelleştiriliyor.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - Yedekleme depolama yedekliliği güncelleştirmesi devam ettiğinden örnek yedekliliği güncelleştirilemiyor.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - Yedekleme depolama alanı alanlar arası yedekli değil, ancak örnek yedekliliği alanlar arası yedekli olarak güncelleştiriliyor.

  • 409 BackupRedundancyUpdateConflict - Yedekleme depolama yedekliliği güncelleştirmesi zaten devam ettiğinden yedekleme depolama yedekliliği güncelleştirilemiyor.

  • 409 MiDropFailedOnAuthLocks - Kullanıcı, kaynaklara Kilit uygulanmış alt ağda son Yönetilen Örneği bırakmaya çalıştı.

  • 409 MiCreateFailedNonDelegatedSubnet - Kullanıcı, Microsoft.Sql/managedInstances'a devredilmeyen alt ağda Yönetilen Örnek veya Yönetilen Örnek havuzu dağıtmaya çalıştı.

  • 412 InstanceNotReadyForBackupRedundancyUpdate - Örnek hazır olmadığından yedek depolama yedekliliği güncelleştirilemiyor.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 ConflictingSubscriptionOperation - Abonelik için şu anda bir işlem devam ediyor.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 504 RequestTimeout - Hizmet isteği izin verilen zaman aşımını aştı.

  • 504 RequestTimeout - Hizmet isteği izin verilen zaman aşımını aştı.

Örnekler

Get managed instance
Get managed instance with $expand=administrators/activedirectory

Get managed instance

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.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",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.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",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "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",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Tanımlar

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ı).

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 Type 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 Type 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 Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ManagedInstance

yönetilen bir Azure SQL örneği.

Name Type Description
id
  • string

Kaynak Kimliği.

identity

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

Sunucunun Azure Active Directory yöneticisi.

properties.collation
  • string

Yönetilen örneğin harmanlanması.

properties.currentBackupStorageRedundancy

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

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

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

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

Ö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

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

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ındaki 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

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 Type Description
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

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 Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstancePecProperty

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

Name Type Description
id
  • string

Kaynak Kimliği.

properties

Özel uç nokta bağlantı özellikleri

ManagedInstancePrivateEndpointConnectionProperties

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

Name Type Description
privateEndpoint

Bağlantının ait olduğu özel uç nokta.

privateLinkServiceConnectionState

Özel Uç Nokta Bağlantısının Bağlantı Durumu.

provisioningState
  • string

Özel Uç Nokta Bağlantısının durumu.

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

Özel uç noktanın kaynak kimliği.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type 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 Type 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 Type Description
Default
  • string
PointInTimeRestore
  • string

PrincipalType

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

Name Type Description
Application
  • string
Group
  • string
User
  • string

ResourceIdentity

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

Name Type Description
principalId
  • string

Azure Active Directory asıl kimliği.

tenantId
  • string

Azure Active Directory kiracı kimliği.

type

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

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 Type 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

Hizmet sorumlusu türü.

ServicePrincipalType

Hizmet sorumlusu türü.

Name Type Description
None
  • string
SystemAssigned
  • string

Sku

ARM Kaynağı SKU'su.

Name Type 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 Type Description
clientId
  • string

Azure Active Directory istemci kimliği.

principalId
  • string

Azure Active Directory asıl kimliği.