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 İçinde Gerekli Tür 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 Tür Description
200 OK

ManagedInstance

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şlem yetkilisinden gelen hata iletisini olduğu gibi, değişiklik yapmadan 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ı yedekliliğe 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 temsilci olarak atanmayan alt ağda Yönetilen Örnek veya Yönetilen Örnek havuzu dağıtmaya çalıştı.

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

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

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

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

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ö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

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

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

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.