Managed Instances - Get

Hiermee haalt u een beheerd exemplaar op.

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

Name In Vereist Type Description
managedInstanceName
path True

string

De naam van het beheerde exemplaar.

resourceGroupName
path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.

subscriptionId
path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.

api-version
query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

$expand
query

string

De onderliggende resources die moeten worden opgenomen in het antwoord.

Antwoorden

Name Type Description
200 OK

ManagedInstance

Het opgegeven beheerde exemplaar is opgehaald.

Other Status Codes

Foutreacties: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy - Geo-Restore is niet toegestaan voor beheerde exemplaren met redundantie van LRS/ZRS-back-upopslag.

  • 400 UpdatingInstanceAndBackupRedundancy- Redundantie van exemplaarzone en redundantie van back-upopslag kunnen niet in dezelfde aanvraag worden bijgewerkt.

  • 400 ProvisioningDisabled - Geeft een foutbericht weer van de resource operation authorizer zoals het is, zonder wijzigingen

  • 400 AadOnlyAuthenticationIsEnabled - Alleen Azure Active Directory-verificatie is ingeschakeld. Neem contact op met de systeembeheerder.

  • 400 ManagementServiceFeatureDisabled - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld.

  • 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden.

  • 404 ServerNotInSubscription: de opgegeven server bestaat niet in het opgegeven abonnement.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup : het opgegeven beheerde exemplaar bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

  • 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden.

  • 404 ResourceNotFound - De aangevraagde resource is niet gevonden.

  • 409 ConflictingManagedInstanceOperation : er wordt momenteel een bewerking uitgevoerd voor het beheerde exemplaar.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict : het exemplaar is multi-az, maar back-upopslag wordt bijgewerkt van zone-redundant naar niet-zone-redundant.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - Kan instantieredundantie niet bijwerken omdat de redundantie van back-upopslag wordt bijgewerkt.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - De back-upopslag is niet zone-redundant, maar instantieredundantie wordt bijgewerkt naar zoneredundant.

  • 409 BackupRedundancyUpdateConflict - Kan redundantie van back-upopslag niet bijwerken omdat er al een redundantie-update voor back-upopslag wordt uitgevoerd.

  • 409 MiDropFailedOnAuthLocks - Gebruiker heeft geprobeerd het laatste beheerde exemplaar te verwijderen in het subnet waarvoor vergrendeling is toegepast op resource(s).

  • 409 MiCreateFailedNonDelegatedSubnet: gebruiker heeft geprobeerd een beheerd exemplaar of een beheerde exemplaargroep te implementeren in het subnet dat niet is gedelegeerd aan Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate : kan redundantie van back-upopslag niet bijwerken omdat het exemplaar niet gereed is.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 ConflictingSubscriptionOperation : er wordt momenteel een bewerking uitgevoerd voor het abonnement.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

  • 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Voorbeelden

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

Definities

Name Description
AdministratorType

Type van de serverbeheerder.

BackupStorageRedundancy

Het opslagaccounttype dat wordt gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.

ManagedInstance

Een Azure SQL beheerd exemplaar.

ManagedInstanceExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn 'LicenseIncluded' (normale prijs inclusief een nieuwe SQL-licentie) en 'BasePrice' (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

ManagedInstancePecProperty

Een privé-eindpuntverbinding onder een beheerd exemplaar

ManagedInstancePrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaardinstelling: het maken van een normaal exemplaar.

Herstellen: hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

PrincipalType

Principal Type van de serverbeheerder.

ResourceIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

ServicePrincipal

De configuratie van de service-principal van het beheerde exemplaar voor een resource.

ServicePrincipalType

Type service-principal.

Sku

Een ARM-resource-SKU.

UserIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

AdministratorType

Type van de serverbeheerder.

Name Type Description
ActiveDirectory

string

BackupStorageRedundancy

Het opslagaccounttype dat wordt gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

Name Type Description
Geo

string

GeoZone

string

Local

string

Zone

string

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.

Name Type Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Een Azure SQL beheerd exemplaar.

Name Type Description
id

string

Resource-id.

identity

ResourceIdentity

De Azure Active Directory-identiteit van het beheerde exemplaar.

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.administratorLogin

string

Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en is vereist voor het maken).

properties.administratorLoginPassword

string

Het aanmeldingswachtwoord voor de beheerder (vereist voor het maken van een beheerd exemplaar).

properties.administrators

ManagedInstanceExternalAdministrator

De Azure Active Directory-beheerder van de server.

properties.collation

string

Sortering van het beheerde exemplaar.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Het opslagaccounttype dat wordt gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

properties.dnsZone

string

De DNS-zone waarin het beheerde exemplaar zich bevindt.

properties.dnsZonePartner

string

De resource-id van een ander beheerd exemplaar waarvan de DNS-zone dit beheerde exemplaar deelt na het maken.

properties.fullyQualifiedDomainName

string

De volledig gekwalificeerde domeinnaam van het beheerde exemplaar.

properties.instancePoolId

string

De id van de exemplaargroep waartoe deze beheerde server behoort.

properties.keyId

string

Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.

properties.licenseType

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn 'LicenseIncluded' (normale prijs inclusief een nieuwe SQL-licentie) en 'BasePrice' (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

properties.maintenanceConfigurationId

string

Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaardinstelling: het maken van een normaal exemplaar.

Herstellen: hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

properties.minimalTlsVersion

string

Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Lijst met privé-eindpuntverbindingen in een beheerd exemplaar.

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

ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

properties.publicDataEndpointEnabled

boolean

Of het eindpunt voor openbare gegevens is ingeschakeld.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Het opslagaccounttype dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string

Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken.

properties.servicePrincipal

ServicePrincipal

De service-principal van het beheerde exemplaar.

properties.sourceManagedInstanceId

string

De resource-id van het beheerde bronexemplaar dat is gekoppeld aan de maakbewerking van dit exemplaar.

properties.state

string

De status van het beheerde exemplaar.

properties.storageSizeInGB

integer

Opslaggrootte in GB. Minimale waarde: 32. Maximale waarde: 16384. Stappen van 32 GB zijn alleen toegestaan. De maximale waarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores.

properties.subnetId

string

Subnetresource-id voor het beheerde exemplaar.

properties.timezoneId

string

Id van de tijdzone. Toegestane waarden zijn tijdzones die door Windows worden ondersteund. Windows bewaart informatie over ondersteunde tijdzones, inclusief de id, in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tijdzones. U kunt deze registerwaarden ophalen via SQL Server door een query uit te voeren op SELECT name AS timezone_id FROM sys.time_zone_info. Lijst met id's kan ook worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Een voorbeeld van een geldige tijdzone-id is 'Pacific Standard Time' of 'W. Europa (standaardtijd).

properties.vCores

integer

Het aantal vCores. Toegestane waarden: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant

boolean

Of de multi-az is ingeschakeld of niet.

sku

Sku

Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Resourcetags.

type

string

Resourcetype.

ManagedInstanceExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

Name Type Description
administratorType

AdministratorType

Type van de serverbeheerder.

azureADOnlyAuthentication

boolean

Alleen Azure Active Directory-verificatie ingeschakeld.

login

string

Aanmeldingsnaam van de serverbeheerder.

principalType

PrincipalType

Principal Type van de serverbeheerder.

sid

string

SID (object-id) van de serverbeheerder.

tenantId

string

Tenant-id van de beheerder.

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn 'LicenseIncluded' (normale prijs inclusief een nieuwe SQL-licentie) en 'BasePrice' (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

Name Type Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

Een privé-eindpuntverbinding onder een beheerd exemplaar

Name Type Description
id

string

Resource-id.

properties

ManagedInstancePrivateEndpointConnectionProperties

Eigenschappen van privé-eindpuntverbinding

ManagedInstancePrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

Name Type Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Privé-eindpunt waartoe de verbinding behoort.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Verbindingsstatus van de privé-eindpuntverbinding.

provisioningState

string

Status van de privé-eindpuntverbinding.

ManagedInstancePrivateEndpointProperty

Name Type Description
id

string

Resource-id van het privé-eindpunt.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

string

De beschrijving van de private link-serviceverbinding.

description

string

De beschrijving van de private link-serviceverbinding.

status

string

De verbindingsstatus van de Private Link-service.

ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

Name Type Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaardinstelling: het maken van een normaal exemplaar.

Herstellen: hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

Name Type Description
Default

string

PointInTimeRestore

string

PrincipalType

Principal Type van de serverbeheerder.

Name Type Description
Application

string

Group

string

User

string

ResourceIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name Type Description
principalId

string

De principal-id van Azure Active Directory.

tenantId

string

De tenant-id van Azure Active Directory.

type

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.

userAssignedIdentities

<string,  UserIdentity>

De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt

ServicePrincipal

De configuratie van de service-principal van het beheerde exemplaar voor een resource.

Name Type Description
clientId

string

De client-id van de Azure Active Directory-toepassing.

principalId

string

De azure Active Directory-toepassingsobject-id.

tenantId

string

De tenant-id van Azure Active Directory.

type

ServicePrincipalType

Type service-principal.

ServicePrincipalType

Type service-principal.

Name Type Description
None

string

SystemAssigned

string

Sku

Een ARM-resource-SKU.

Name Type Description
capacity

integer

Capaciteit van de specifieke SKU.

family

string

Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan dat hier worden vastgelegd.

name

string

De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3.

size

string

Grootte van de specifieke SKU

tier

string

De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium.

UserIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name Type Description
clientId

string

De Azure Active Directory-client-id.

principalId

string

De principal-id van Azure Active Directory.