Megosztás a következőn keresztül:


Managed Instances - Get

Lekéri a felügyelt példányt.

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-paraméterek

Name In Kötelező Típus Description
managedInstanceName
path True

string

A felügyelt példány neve.

resourceGroupName
path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

subscriptionId
path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True

string

A kéréshez használni kívánt API-verzió.

$expand
query

string

A válaszba belefoglalandó gyermekerőforrások.

Válaszok

Name Típus Description
200 OK

ManagedInstance

Sikeresen lekérte a megadott felügyelt példányt.

Other Status Codes

Hibaválaszok: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy – Geo-Restore nem engedélyezett az LRS/ZRS biztonsági mentési tár redundanciájával rendelkező felügyelt példányokhoz.

  • 400 UpdatedInstanceAndBackupRedundancy – A példányzóna redundanciája és a biztonsági mentési tár redundanciája ugyanabban a kérelemben nem frissíthető.

  • 400 ProvisioningDisabled – Hibaüzenetet jelenít meg az erőforrás-művelet engedélyezője részéről, módosítás nélkül

  • 400 AadOnlyAuthenticationIsEnabled – Csak Azure Active Directory-hitelesítés engedélyezve van. Lépjen kapcsolatba a rendszergazdával.

  • 400 ManagementServiceFeatureDisabled – A felhasználó letiltott funkciót próbált használni.

  • 404 SubscriptionNotFound – A kért előfizetés nem található.

  • 404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup – A megadott felügyelt példány nem létezik a megadott erőforráscsoportban és előfizetésben.

  • 404 SubscriptionNotFound – A kért előfizetés nem található.

  • 404 ResourceNotFound – A kért erőforrás nem található.

  • 409 ConflictingManagedInstanceOperation – Folyamatban van egy művelet a felügyelt példányon.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict – A példány több az, de a biztonsági mentési tár zónaredundánsról nem zónaredundánsra frissül.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress – A példányredundancia nem frissíthető, mert a biztonsági mentési tár redundanciafrissítése folyamatban van.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict – A biztonsági mentési tár nem zónaredundáns, de a példányredundancia zónaredundánsra frissül.

  • 409 BackupRedundancyUpdateConflict – Nem lehet frissíteni a biztonsági mentési tár redundanciát, mert már folyamatban van egy biztonsági mentési tár redundanciafrissítése.

  • 409 MiDropFailedOnAuthLocks – A felhasználó megpróbálta elvetni az utolsó felügyelt példányt az alhálózaton, amelyen a zárolás erőforrás(ok)ra lett alkalmazva.

  • 409 MiCreateFailedNonDelegatedSubnet – A felhasználó olyan alhálózaton próbált felügyelt példányt vagy felügyelt példánykészletet üzembe helyezni, amely nincs delegálva a Microsoft.Sql/managedInstances szolgáltatásba.

  • 412 InstanceNotReadyForBackupRedundancyUpdate – Nem lehet frissíteni a biztonsági mentési tár redundanciát, mert a példány nem áll készen.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 429 ConflictingSubscriptionOperation – Folyamatban van egy művelet az előfizetéshez.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 504 RequestTimeout – A szolgáltatáskérés túllépte az engedélyezett időtúllépést.

  • 504 RequestTimeout – A szolgáltatáskérés túllépte az engedélyezett időtúllépést.

Példák

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

Get managed instance

Mintakérelem

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

Mintaválasz

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

Mintakérelem

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

Mintaválasz

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

Definíciók

Name Description
AdministratorType

A rendszergazda típusa.

BackupStorageRedundancy

A példány biztonsági másolatainak tárolására használt tárfióktípus. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)

IdentityType

Az identitás típusa. Állítsa ezt "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.

ManagedInstance

Egy Azure SQL felügyelt példány.

ManagedInstanceExternalAdministrator

Az Active Directory-rendszergazda tulajdonságai.

ManagedInstanceLicenseType

A licenc típusa. A lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár a saját SQL-licencek behozása esetén).

ManagedInstancePecProperty

Privát végponti kapcsolat felügyelt példány alatt

ManagedInstancePrivateEndpointConnectionProperties

Privát végponti kapcsolat tulajdonságai.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

A példányhoz való csatlakozáshoz használt kapcsolattípus.

ManagedServerCreateMode

Megadja az adatbázis-létrehozás módját.

Alapértelmezett: Normál példánylétrehozás.

Visszaállítás: Létrehoz egy példányt egy biztonsági másolat adott időpontra történő visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId értéket.

PrincipalType

A rendszergazda egyszerű típusa.

ResourceIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

ServicePrincipal

A felügyelt példány szolgáltatásnév-konfigurációja egy erőforráshoz.

ServicePrincipalType

Szolgáltatásnév típusa.

Sku

ARM-erőforrás-termékváltozat.

UserIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

AdministratorType

A rendszergazda típusa.

Name Típus Description
ActiveDirectory

string

BackupStorageRedundancy

A példány biztonsági másolatainak tárolására használt tárfióktípus. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)

Name Típus Description
Geo

string

GeoZone

string

Local

string

Zone

string

IdentityType

Az identitás típusa. Állítsa ezt "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.

Name Típus Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Egy Azure SQL felügyelt példány.

Name Típus Description
id

string

Erőforrás-azonosító.

identity

ResourceIdentity

A felügyelt példány Azure Active Directory-identitása.

location

string

Erőforrás helye.

name

string

Erőforrás neve.

properties.administratorLogin

string

A felügyelt példány rendszergazdai felhasználóneve. Csak a felügyelt példány létrehozásakor adható meg (és a létrehozáshoz szükséges).

properties.administratorLoginPassword

string

A rendszergazdai bejelentkezési jelszó (a felügyelt példány létrehozásához szükséges).

properties.administrators

ManagedInstanceExternalAdministrator

A kiszolgáló Azure Active Directory-rendszergazdája.

properties.collation

string

A felügyelt példány rendezése.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

A példány biztonsági másolatainak tárolására használt tárfióktípus. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)

properties.dnsZone

string

A dns-zóna, amelyben a felügyelt példány található.

properties.dnsZonePartner

string

Egy másik felügyelt példány erőforrás-azonosítója, amelynek DNS-zónáját ez a felügyelt példány a létrehozás után megosztja.

properties.fullyQualifiedDomainName

string

A felügyelt példány teljes tartományneve.

properties.instancePoolId

string

Annak a példánykészletnek az azonosítója, amelyhez a felügyelt kiszolgáló tartozik.

properties.keyId

string

A titkosításhoz használandó kulcs CMK URI-ja.

properties.licenseType

ManagedInstanceLicenseType

A licenc típusa. A lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár a saját SQL-licencek behozása esetén).

properties.maintenanceConfigurationId

string

Megadja a felügyelt példányra alkalmazandó karbantartási konfiguráció azonosítóját.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Megadja az adatbázis-létrehozás módját.

Alapértelmezett: Normál példánylétrehozás.

Visszaállítás: Létrehoz egy példányt egy biztonsági másolat adott időpontra történő visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId értéket.

properties.minimalTlsVersion

string

Minimális TLS-verzió. Megengedett értékek: "Nincs", "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId

string

Egy felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Felügyelt példány privát végponti kapcsolatainak listája.

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

ManagedInstanceProxyOverride

A példányhoz való csatlakozáshoz használt kapcsolattípus.

properties.publicDataEndpointEnabled

boolean

Azt jelzi, hogy a nyilvános adatvégpont engedélyezve van-e.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

A példány biztonsági másolatainak tárolására használt tárfióktípus. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string

Megadja annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaállítva.

properties.servicePrincipal

ServicePrincipal

A felügyelt példány szolgáltatásneve.

properties.sourceManagedInstanceId

string

A példány létrehozási műveletéhez társított felügyelt forráspéldány erőforrás-azonosítója.

properties.state

string

A felügyelt példány állapota.

properties.storageSizeInGB

integer

Tárterület mérete GB-ban. Minimális érték: 32. Maximális érték: 16384. Csak 32 GB-os növekmények engedélyezettek. A maximális érték a kiválasztott hardvercsaládtól és a virtuális magok számától függ.

properties.subnetId

string

A felügyelt példány alhálózati erőforrás-azonosítója.

properties.timezoneId

string

Az időzószám azonosítója. Az engedélyezett értékek a Windows által támogatott időzónák. A Windows a KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones területen tárolja a támogatott időzónák részleteit, beleértve az azonosítót is. Ezeket a beállításjegyzék-értékeket a SQL Server keresztül szerezheti be a SELECT name AS timezone_id FROM sys.time_zone_info lekérdezésével. Az azonosítók listája a [System.TimeZoneInfo]::GetSystemTimeZones() PowerShellben történő végrehajtásával is lekérhető. Az érvényes időzóná-azonosítók például a "Csendes-óceáni téli idő" vagy a "W". Európai téli idő".

properties.vCores

integer

A virtuális magok száma. Megengedett értékek: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant

boolean

Azt jelzi, hogy a multi-az engedélyezve van-e.

sku

Sku

Felügyelt példány termékváltozata. A sku.name engedélyezett értékei: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Erőforráscímkék.

type

string

Erőforrástípus.

ManagedInstanceExternalAdministrator

Az Active Directory-rendszergazda tulajdonságai.

Name Típus Description
administratorType

AdministratorType

A rendszergazda típusa.

azureADOnlyAuthentication

boolean

Csak az Azure Active Directory-hitelesítés engedélyezve van.

login

string

A kiszolgáló-rendszergazda bejelentkezési neve.

principalType

PrincipalType

A rendszergazda egyszerű típusa.

sid

string

A kiszolgálóadminisztrátor SID-azonosítója (objektumazonosítója).

tenantId

string

A rendszergazda bérlőazonosítója.

ManagedInstanceLicenseType

A licenc típusa. A lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár a saját SQL-licencek behozása esetén).

Name Típus Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

Privát végponti kapcsolat felügyelt példány alatt

Name Típus Description
id

string

Erőforrás-azonosító.

properties

ManagedInstancePrivateEndpointConnectionProperties

Privát végpont kapcsolati tulajdonságai

ManagedInstancePrivateEndpointConnectionProperties

Privát végponti kapcsolat tulajdonságai.

Name Típus Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Privát végpont, amelyhez a kapcsolat tartozik.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

A privát végpontkapcsolat kapcsolati állapota.

provisioningState

string

A privát végpontkapcsolat állapota.

ManagedInstancePrivateEndpointProperty

Name Típus Description
id

string

A privát végpont erőforrás-azonosítója.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Típus Description
actionsRequired

string

A private link szolgáltatás kapcsolatának leírása.

description

string

A private link szolgáltatás kapcsolatának leírása.

status

string

A privát kapcsolati szolgáltatás kapcsolati állapota.

ManagedInstanceProxyOverride

A példányhoz való csatlakozáshoz használt kapcsolattípus.

Name Típus Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

Megadja az adatbázis-létrehozás módját.

Alapértelmezett: Normál példánylétrehozás.

Visszaállítás: Létrehoz egy példányt egy biztonsági másolat adott időpontra történő visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId értéket.

Name Típus Description
Default

string

PointInTimeRestore

string

PrincipalType

A rendszergazda egyszerű típusa.

Name Típus Description
Application

string

Group

string

User

string

ResourceIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name Típus Description
principalId

string

Az Azure Active Directory egyszerű azonosítója.

tenantId

string

Az Azure Active Directory-bérlő azonosítója.

type

IdentityType

Az identitás típusa. Állítsa ezt "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.

userAssignedIdentities

<string,  UserIdentity>

A felhasználó által hozzárendelt használandó identitások erőforrás-azonosítói

ServicePrincipal

A felügyelt példány szolgáltatásnév-konfigurációja egy erőforráshoz.

Name Típus Description
clientId

string

Az Azure Active Directory-alkalmazás ügyfél-azonosítója.

principalId

string

Az Azure Active Directory alkalmazásobjektum-azonosítója.

tenantId

string

Az Azure Active Directory-bérlő azonosítója.

type

ServicePrincipalType

Szolgáltatásnév típusa.

ServicePrincipalType

Szolgáltatásnév típusa.

Name Típus Description
None

string

SystemAssigned

string

Sku

ARM-erőforrás-termékváltozat.

Name Típus Description
capacity

integer

Az adott termékváltozat kapacitása.

family

string

Ha a szolgáltatás eltérő hardvergenerációval rendelkezik ugyanahhoz a termékváltozathoz, akkor az itt rögzíthető.

name

string

A termékváltozat neve, általában egy betű + szám kód, például P3.

size

string

Az adott termékváltozat mérete

tier

string

Az adott termékváltozat szintje vagy kiadása, például Alapszintű, Prémium.

UserIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name Típus Description
clientId

string

Az Azure Active Directory-ügyfél azonosítója.

principalId

string

Az Azure Active Directory egyszerű azonosítója.