Managed Instances - Get

Získá spravovanou instanci.

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

Parametry identifikátoru URI

Name In Required Type Description
managedInstanceName
path True
  • string

Název spravované instance.

resourceGroupName
path True
  • string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo portálu.

subscriptionId
path True
  • string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True
  • string

Verze rozhraní API, která se má použít pro požadavek.

$expand
query
  • string

Podřízené prostředky, které se mají zahrnout do odpovědi.

Odpovědi

Name Type Description
200 OK

Úspěšně se načetla zadaná spravovaná instance.

Other Status Codes

Chybové odpovědi: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy – Geo-Restore není povoleno pro spravované instance s redundancí úložiště zálohování LRS/ZRS.

  • 400 AktualizaceInstanceAndBackupRedundancy – Redundance zón instance a redundance úložiště zálohování nelze aktualizovat ve stejném požadavku.

  • 400 ProvisioningDisabled – zobrazí chybovou zprávu z autorizátoru operací prostředků, jak je, bez změn

  • 400 AadOnlyAuthenticationIsEnabled – Je povolené pouze ověřování Azure Active Directory. Obraťte se na správce systému.

  • 400 ManagementServiceFeatureDisabled – Uživatel se pokusil použít funkci, která je zakázaná.

  • 404 SubscriptionNotFound – Požadované předplatné nebylo nalezeno.

  • 404 ServerNotInSubscription – Zadaný server v zadaném předplatném neexistuje.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup – Zadaná spravovaná instance neexistuje v zadané skupině prostředků a předplatném.

  • 404 SubscriptionNotFound – Požadované předplatné nebylo nalezeno.

  • 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen.

  • 409 KonfliktníManagedInstanceOperation – operace právě probíhá pro spravovanou instanci.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict – Instance je multi-az, ale zálohování úložiště se aktualizuje z zón redundantní na zónově redundantní.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress – Nejde aktualizovat redundanci instance, protože probíhá aktualizace redundance úložiště zálohování.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict – Úložiště zálohování není zónově redundantní, ale redundance instance se aktualizuje na zónově redundantní.

  • 409 BackupRedundancyUpdateConflict – Nejde aktualizovat redundanci úložiště zálohování, protože už probíhá aktualizace redundance úložiště zálohování.

  • 409 MiDropFailedOnAuthLocks – Uživatel se pokusil odstranit poslední spravovanou instanci v podsíti s použitým zámkem u prostředků.

  • 409 MiCreateFailedNonDelegatedSubnet – uživatel se pokusil nasadit spravovanou instanci nebo fond spravovaných instancí v podsíti, která není delegovaná na Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate – Nejde aktualizovat redundanci úložiště zálohování, protože instance není připravená.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 KonfliktníSubscriptionOperation – v současné době probíhá operace pro předplatné.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

  • 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

Příklady

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"
}

Definice

AdministratorType

Typ správce serveru.

BackupStorageRedundancy

Typ účtu úložiště používaný k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

ManagedInstance

Spravovaná instance Azure SQL.

ManagedInstanceExternalAdministrator

Vlastnosti správce služby Active Directory

ManagedInstanceLicenseType

Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za přenesení vlastních licencí SQL).

ManagedInstancePecProperty

Připojení privátního koncového bodu ve spravované instanci

ManagedInstancePrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Typ připojení používaný pro připojení k instanci.

ManagedServerCreateMode

Určuje režim vytváření databáze.

Výchozí nastavení: Vytvoření běžné instance

Obnovení: Vytvoří instanci obnovením sady záloh do konkrétního bodu v čase. Je nutné zadat RestorePointInTime a SourceManagedInstanceId.

PrincipalType

Hlavní typ správce serveru.

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

ServicePrincipal

Konfigurace instančního objektu spravované instance pro prostředek.

ServicePrincipalType

Typ instančního objektu.

Sku

Skladová položka prostředku ARM.

UserIdentity

Konfigurace identity Azure Active Directory pro prostředek

AdministratorType

Typ správce serveru.

Name Type Description
ActiveDirectory
  • string

BackupStorageRedundancy

Typ účtu úložiště používaný k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

Name Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ManagedInstance

Spravovaná instance Azure SQL.

Name Type Description
id
  • string

ID prostředku.

identity

Identita Azure Active Directory spravované instance.

location
  • string

Umístění prostředku.

name
  • string

Název prostředku.

properties.administratorLogin
  • string

Uživatelské jméno správce pro spravovanou instanci. Lze zadat pouze při vytváření spravované instance (a vyžaduje se pro vytvoření).

properties.administratorLoginPassword
  • string

Přihlašovací heslo správce (vyžaduje se pro vytvoření spravované instance).

properties.administrators

Správce serveru Azure Active Directory.

properties.collation
  • string

Kolace spravované instance

properties.currentBackupStorageRedundancy

Typ účtu úložiště používaný k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

properties.dnsZone
  • string

Zóna DNS, ve které je spravovaná instance.

properties.dnsZonePartner
  • string

ID prostředku jiné spravované instance, jejíž zónu DNS tato spravovaná instance bude po vytvoření sdílet.

properties.fullyQualifiedDomainName
  • string

Plně kvalifikovaný název domény spravované instance.

properties.instancePoolId
  • string

ID fondu instancí, do které tento spravovaný server patří.

properties.keyId
  • string

Identifikátor URI klíče CMK, který se má použít k šifrování.

properties.licenseType

Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za přenesení vlastních licencí SQL).

properties.maintenanceConfigurationId
  • string

Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci.

properties.managedInstanceCreateMode

Určuje režim vytváření databáze.

Výchozí nastavení: Vytvoření běžné instance

Obnovení: Vytvoří instanci obnovením sady záloh do konkrétního bodu v čase. Je nutné zadat RestorePointInTime a SourceManagedInstanceId.

properties.minimalTlsVersion
  • string

Minimální verze protokolu TLS. Povolené hodnoty: 'None', '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId
  • string

ID prostředku identity přiřazené uživatelem, které se má používat ve výchozím nastavení.

properties.privateEndpointConnections

Seznam připojení privátních koncových bodů ve spravované instanci

properties.provisioningState enum:
  • Accepted
  • Canceled
  • Created
  • Creating
  • Deleted
  • Deleting
  • Failed
  • NotSpecified
  • Registering
  • Running
  • Succeeded
  • TimedOut
  • Unknown
  • Unrecognized
  • Updating
properties.proxyOverride

Typ připojení používaný pro připojení k instanci.

properties.publicDataEndpointEnabled
  • boolean

Jestli je povolený veřejný datový koncový bod, nebo ne.

properties.requestedBackupStorageRedundancy

Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime
  • string

Určuje bod v čase (formát ISO8601) zdrojové databáze, který se obnoví a vytvoří novou databázi.

properties.servicePrincipal

Instanční objekt spravované instance.

properties.sourceManagedInstanceId
  • string

Identifikátor prostředku zdrojové spravované instance přidružené k operaci vytvoření této instance.

properties.state
  • string

Stav spravované instance.

properties.storageSizeInGB
  • integer

Velikost úložiště v GB Minimální hodnota: 32. Maximální hodnota: 16384. Přírůstky o 32 GB jsou povolené pouze. Maximální hodnota závisí na vybrané řadě hardwaru a počtu virtuálních jader.

properties.subnetId
  • string

ID prostředku podsítě pro spravovanou instanci

properties.timezoneId
  • string

ID časového pásma. Povolené hodnoty jsou časové pásmo podporované systémem Windows. Systém Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v části KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\systém Windows NT\CurrentVersion\Time Zone. Tyto hodnoty registru můžete získat prostřednictvím SQL Server dotazováním názvu SELECT jako timezone_id FROM sys.time_zone_info. Seznam ID lze získat také spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je Tichomoří standardní čas nebo W. Evropský standardní čas".

properties.vCores
  • integer

Počet virtuálních jader. Povolené hodnoty: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant
  • boolean

Bez ohledu na to, jestli je povolený multi-az.

sku

Skladová položka spravované instance Povolené hodnoty pro sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags
  • object

Značky prostředků

type
  • string

Typ prostředku.

ManagedInstanceExternalAdministrator

Vlastnosti správce služby Active Directory

Name Type Description
administratorType

Typ správce serveru.

azureADOnlyAuthentication
  • boolean

Povolené je pouze ověřování Azure Active Directory.

login
  • string

Přihlašovací jméno správce serveru.

principalType

Hlavní typ správce serveru.

sid
  • string

IDENTIFIKÁTOR SID (ID objektu) správce serveru.

tenantId
  • string

ID tenanta správce.

ManagedInstanceLicenseType

Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za přenesení vlastních licencí SQL).

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstancePecProperty

Připojení privátního koncového bodu ve spravované instanci

Name Type Description
id
  • string

ID prostředku.

properties

Vlastnosti připojení privátního koncového bodu

ManagedInstancePrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu.

Name Type Description
privateEndpoint

Privátní koncový bod, ke kterému připojení patří.

privateLinkServiceConnectionState

Stav připojení privátního koncového bodu

provisioningState
  • string

Stav připojení privátního koncového bodu.

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

ID prostředku privátního koncového bodu

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired
  • string

Popis připojení služby private link.

description
  • string

Popis připojení služby private link.

status
  • string

Stav připojení služby Private Link.

ManagedInstanceProxyOverride

Typ připojení používaný pro připojení k instanci.

Name Type Description
Default
  • string
Proxy
  • string
Redirect
  • string

ManagedServerCreateMode

Určuje režim vytváření databáze.

Výchozí nastavení: Vytvoření běžné instance

Obnovení: Vytvoří instanci obnovením sady záloh do konkrétního bodu v čase. Je nutné zadat RestorePointInTime a SourceManagedInstanceId.

Name Type Description
Default
  • string
PointInTimeRestore
  • string

PrincipalType

Hlavní typ správce serveru.

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

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Type Description
principalId
  • string

ID instančního objektu Azure Active Directory

tenantId
  • string

ID tenanta Azure Active Directory

type

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

userAssignedIdentities

ID prostředků identit přiřazených uživatelem, které se mají použít

ServicePrincipal

Konfigurace instančního objektu spravované instance pro prostředek.

Name Type Description
clientId
  • string

ID klienta aplikace Azure Active Directory

principalId
  • string

ID objektu aplikace Azure Active Directory.

tenantId
  • string

ID tenanta Azure Active Directory

type

Typ instančního objektu.

ServicePrincipalType

Typ instančního objektu.

Name Type Description
None
  • string
SystemAssigned
  • string

Sku

Skladová položka prostředku ARM.

Name Type Description
capacity
  • integer

Kapacita konkrétní skladové položky.

family
  • string

Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete ji zde zachytit.

name
  • string

Název skladové položky, obvykle písmeno + číslo, např. P3.

size
  • string

Velikost konkrétní skladové položky

tier
  • string

Úroveň nebo edice konkrétní skladové položky, například Basic, Premium.

UserIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Type Description
clientId
  • string

ID klienta Azure Active Directory

principalId
  • string

ID instančního objektu Azure Active Directory