Dela via


Managed Instances - Get

Hämtar en hanterad instans.

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

Name I Obligatorisk Typ Description
managedInstanceName
path True

string

Namnet på den hanterade instansen.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

subscriptionId
path True

string

Prenumerations-ID:t som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

$expand
query

string

De underordnade resurser som ska ingå i svaret.

Svar

Name Typ Description
200 OK

ManagedInstance

Den angivna hanterade instansen har hämtats.

Other Status Codes

Felsvar: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy – Geo-Restore tillåts inte för hanterade instanser med redundans för LRS/ZRS-säkerhetskopieringslagring.

  • 400 UpdatingInstanceAndBackupRedundancy – Redundans för instanszoner och redundans för säkerhetskopieringslagring kan inte uppdateras i samma begäran.

  • 400 ProvisioningDisabled – Visar felmeddelande från resursåtgärdsauktoriseraren som den är, utan ändringar

  • 400 AadOnlyAuthenticationIsEnabled – Endast Azure Active Directory-autentisering är aktiverat. Kontakta systemadministratören.

  • 400 ManagementServiceFeatureDisabled – Användaren försökte använda en funktion som är inaktiverad.

  • 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte.

  • 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup – Angiven hanterad instans finns inte i den angivna resursgruppen och prenumerationen.

  • 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte.

  • 404 ResourceNotFound – Den begärda resursen hittades inte.

  • 409 ConflictingManagedInstanceOperation – En åtgärd pågår för den hanterade instansen.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict – instansen är multi-az, men lagring av säkerhetskopior uppdateras från zonredundant till icke-zonredundant.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress – Det går inte att uppdatera instansredundans eftersom redundansuppdateringen för säkerhetskopieringslagring pågår.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict – säkerhetskopieringslagringen är icke-zonredundant, men instansredundans uppdateras till zonredundant.

  • 409 BackupRedundancyUpdateConflict – Det går inte att uppdatera redundans för säkerhetskopieringslagring eftersom en redundansuppdatering för säkerhetskopieringslagring redan pågår.

  • 409 MiDropFailedOnAuthLocks – Användaren försökte släppa den senaste hanterade instansen i undernätet som har Lås tillämpat på resurser.

  • 409 MiCreateFailedNonDelegatedSubnet – Användaren försökte distribuera hanterad instans eller hanterad instanspool i undernät som inte har delegerats till Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate – Det går inte att uppdatera redundansen för lagring av säkerhetskopior eftersom instansen inte är klar.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 ConflictingSubscriptionOperation – En åtgärd pågår för prenumerationen.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

  • 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

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

Get managed instance

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
AdministratorType

Typ av administratör för serverservern.

BackupStorageRedundancy

Den typ av lagringskonto som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)

IdentityType

Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

ManagedInstance

En Azure SQL hanterad instans.

ManagedInstanceExternalAdministrator

Egenskaper för en Active Directory-administratör.

ManagedInstanceLicenseType

Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med dina egna SQL-licenser).

ManagedInstancePecProperty

En privat slutpunktsanslutning under en hanterad instans

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Anslutningstyp som används för att ansluta till instansen.

ManagedServerCreateMode

Anger läget för att skapa databasen.

Standard: Skapande av vanlig instans.

Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.

PrincipalType

Huvudtyp för administratören för serverservern.

ResourceIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

ServicePrincipal

Den hanterade instansens konfiguration av tjänstens huvudnamn för en resurs.

ServicePrincipalType

Tjänstens huvudnamnstyp.

Sku

En ARM-resurs-SKU.

UserIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

AdministratorType

Typ av administratör för serverservern.

Name Typ Description
ActiveDirectory

string

BackupStorageRedundancy

Den typ av lagringskonto som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)

Name Typ Description
Geo

string

GeoZone

string

Local

string

Zone

string

IdentityType

Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

Name Typ Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

En Azure SQL hanterad instans.

Name Typ Description
id

string

Resurs-ID.

identity

ResourceIdentity

Azure Active Directory-identiteten för den hanterade instansen.

location

string

Resursplats.

name

string

Resursnamn.

properties.administratorLogin

string

Administratörsanvändarnamn för den hanterade instansen. Kan endast anges när den hanterade instansen skapas (och krävs för att skapa).

properties.administratorLoginPassword

string

Administratörens inloggningslösenord (krävs för att skapa en hanterad instans).

properties.administrators

ManagedInstanceExternalAdministrator

Azure Active Directory-administratören för servern.

properties.collation

string

Sortering av den hanterade instansen.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Den typ av lagringskonto som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)

properties.dnsZone

string

Dns-zonen som den hanterade instansen finns i.

properties.dnsZonePartner

string

Resurs-ID:t för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats.

properties.fullyQualifiedDomainName

string

Det fullständigt kvalificerade domännamnet för den hanterade instansen.

properties.instancePoolId

string

ID:t för instanspoolen som den hanterade servern tillhör.

properties.keyId

string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.licenseType

ManagedInstanceLicenseType

Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med dina egna SQL-licenser).

properties.maintenanceConfigurationId

string

Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Anger läget för att skapa databasen.

Standard: Skapande av vanlig instans.

Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.

properties.minimalTlsVersion

string

Minimal TLS-version. Tillåtna värden: "None", "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId

string

Resurs-ID för en användartilldelad identitet som ska användas som standard.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Lista över privata slutpunktsanslutningar på en hanterad instans.

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

ManagedInstanceProxyOverride

Anslutningstyp som används för att ansluta till instansen.

properties.publicDataEndpointEnabled

boolean

Om den offentliga dataslutpunkten är aktiverad eller inte.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Den typ av lagringskonto som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string

Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.

properties.servicePrincipal

ServicePrincipal

Den hanterade instansens huvudnamn för tjänsten.

properties.sourceManagedInstanceId

string

Resursidentifieraren för den källhanterade instans som är associerad med skapandeåtgärden för den här instansen.

properties.state

string

Tillståndet för den hanterade instansen.

properties.storageSizeInGB

integer

Lagringsstorlek i GB. Minsta värde: 32. Maxvärde: 16384. Steg på endast 32 GB tillåts. Det maximala värdet beror på den valda maskinvarufamiljen och antalet virtuella kärnor.

properties.subnetId

string

Resurs-ID för undernätet för den hanterade instansen.

properties.timezoneId

string

ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Du kan hämta dessa registervärden via SQL Server genom att fråga SELECT-namnet AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på ett giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid".

properties.vCores

integer

Antalet virtuella kärnor. Tillåtna värden: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant

boolean

Om multi-az är aktiverat eller inte.

sku

Sku

SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Resurstaggar.

type

string

Resurstyp.

ManagedInstanceExternalAdministrator

Egenskaper för en Active Directory-administratör.

Name Typ Description
administratorType

AdministratorType

Typ av serveradministratör.

azureADOnlyAuthentication

boolean

Endast Azure Active Directory-autentisering aktiverat.

login

string

Serveradministratörens inloggningsnamn.

principalType

PrincipalType

Huvudtyp för serveradministratören.

sid

string

SID (objekt-ID) för serveradministratören.

tenantId

string

Administratörens klientorganisations-ID.

ManagedInstanceLicenseType

Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med dina egna SQL-licenser).

Name Typ Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

En privat slutpunktsanslutning under en hanterad instans

Name Typ Description
id

string

Resurs-ID.

properties

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

Name Typ Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

provisioningState

string

Status för den privata slutpunktsanslutningen.

ManagedInstancePrivateEndpointProperty

Name Typ Description
id

string

Resurs-ID för den privata slutpunkten.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Typ Description
actionsRequired

string

Beskrivning av tjänstanslutningen för privat länk.

description

string

Beskrivning av tjänstanslutningen för privat länk.

status

string

Anslutningsstatus för tjänsten private link.

ManagedInstanceProxyOverride

Anslutningstyp som används för att ansluta till instansen.

Name Typ Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

Anger läget för att skapa databasen.

Standard: Skapande av vanlig instans.

Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.

Name Typ Description
Default

string

PointInTimeRestore

string

PrincipalType

Huvudtyp för administratören för serverservern.

Name Typ Description
Application

string

Group

string

User

string

ResourceIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Name Typ Description
principalId

string

Huvud-ID:t för Azure Active Directory.

tenantId

string

Klient-ID:t för Azure Active Directory.

type

IdentityType

Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

userAssignedIdentities

<string,  UserIdentity>

Resurs-ID:n för de användartilldelade identiteter som ska användas

ServicePrincipal

Den hanterade instansens konfiguration av tjänstens huvudnamn för en resurs.

Name Typ Description
clientId

string

Klient-ID för Azure Active Directory-program.

principalId

string

Objekt-ID för Azure Active Directory-program.

tenantId

string

Klient-ID:t för Azure Active Directory.

type

ServicePrincipalType

Tjänstens huvudnamnstyp.

ServicePrincipalType

Tjänstens huvudnamnstyp.

Name Typ Description
None

string

SystemAssigned

string

Sku

En ARM-resurs-SKU.

Name Typ Description
capacity

integer

Kapacitet för den specifika SKU:n.

family

string

Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.

name

string

Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.

size

string

Storleken på den specifika SKU:n

tier

string

Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.

UserIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Name Typ Description
clientId

string

Azure Active Directory-klient-ID: t.

principalId

string

Huvud-ID:t för Azure Active Directory.