Sdílet prostřednictvím


Managed Instances - List By Resource Group

Získá seznam spravovaných instancí ve skupině prostředků.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2021-11-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
path True

string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z 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 Typ Description
200 OK

ManagedInstanceListResult

Seznam spravovaných instancí se úspěšně načetl.

Other Status Codes

Chybové odpovědi: ***

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

  • 400 UpdatingInstanceAndBackupRedundancy – Redundanci zóny instance a redundanci úložiště zálohování není možné aktualizovat ve stejném požadavku.

  • 400 ProvisioningDisabled – zobrazí chybovou zprávu z operace prostředků authorizer tak, jak je, beze 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 v zadané skupině prostředků a předplatném neexistuje.

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

  • 404 ResourceNotFound – Požadovaný prostředek se nenašel.

  • 409 ConflictingManagedInstanceOperation – aktuálně probíhá operace pro spravovanou instanci.

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

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

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

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

  • 409 MiDropFailedOnAuthLocks – Uživatel se pokusil vypustit poslední spravovanou instanci v podsíti, na kterou se u prostředků použil zámek.

  • 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 maximální počet požadavků, které je možné zpracovat dostupnými prostředky.

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

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

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

  • 429 ConflictingSubscriptionOperation – aktuálně probíhá operace pro předplatné.

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

  • 503 TooManyRequests – požadavky nad rámec maximálního počtu 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

List managed instances by resource group
List managed instances by resource group with $expand=administrators/activedirectory

List managed instances by resource group

Ukázkový požadavek

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2021-11-01

Ukázková odpověď

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "maintenanceConfigurationId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    }
  ]
}

List managed instances by resource group with $expand=administrators/activedirectory

Ukázkový požadavek

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2021-11-01

Ukázková odpověď

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "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",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "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
        }
      }
    }
  ]
}

Definice

Name Description
AdministratorType

Typ správce serveru.

BackupStorageRedundancy

Typ účtu úložiště, který slouží k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).

IdentityType

Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.

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 používání vlastních licencí SQL).

ManagedInstanceListResult

Seznam spravovaných instancí.

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žitý pro připojení k instanci.

ManagedServerCreateMode

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

Výchozí: Běžné vytváření instancí.

Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.

PrincipalType

Typ objektu zabezpečení 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 Typ Description
ActiveDirectory

string

BackupStorageRedundancy

Typ účtu úložiště, který slouží k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).

Name Typ Description
Geo

string

GeoZone

string

Local

string

Zone

string

IdentityType

Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.

Name Typ Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Spravovaná instance Azure SQL.

Name Typ Description
id

string

ID prostředku.

identity

ResourceIdentity

Identita spravované instance v Azure Active Directory.

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 v případě, že se spravovaná instance vytváří (a vyžaduje se k vytvoření).

properties.administratorLoginPassword

string

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

properties.administrators

ManagedInstanceExternalAdministrator

Správce Azure Active Directory serveru.

properties.collation

string

Kolace spravované instance

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Typ účtu úložiště, který slouží k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).

properties.dnsZone

string

Zóna DNS, ve které se spravovaná instance nachází.

properties.dnsZonePartner

string

ID prostředku jiné spravované instance, jejíž zónu DNS bude tato spravovaná instance 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

ManagedInstanceLicenseType

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

properties.maintenanceConfigurationId

string

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

properties.managedInstanceCreateMode

ManagedServerCreateMode

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

Výchozí: Běžné vytváření instancí.

Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty 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 použije ve výchozím nastavení.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

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

ManagedInstanceProxyOverride

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

properties.publicDataEndpointEnabled

boolean

Určuje, jestli je povolený veřejný datový koncový bod.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

properties.restorePointInTime

string

Určuje bod v čase (ISO8601 formát) zdrojové databáze, která se obnoví za účelem vytvoření nové databáze.

properties.servicePrincipal

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. Jsou povoleny pouze přírůstky o velikosti 32 GB. 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ásma podporovaná systémem Windows. Systém Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\systém Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat prostřednictvím SQL Server zadáním dotazu SELECT name AS timezone_id FROM sys.time_zone_info. Seznam ID můžete 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ří (běžný čas) nebo W. Evropa (běžný čas).

properties.vCores

integer

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

properties.zoneRedundant

boolean

Určuje, jestli je multi-az povolený nebo ne.

sku

Sku

SKU 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 Typ Description
administratorType

AdministratorType

Typ správce serveru.

azureADOnlyAuthentication

boolean

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

login

string

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

principalType

PrincipalType

Typ objektu zabezpečení 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 používání vlastních licencí SQL).

Name Typ Description
BasePrice

string

LicenseIncluded

string

ManagedInstanceListResult

Seznam spravovaných instancí.

Name Typ Description
nextLink

string

Odkaz na načtení další stránky výsledků

value

ManagedInstance[]

Pole výsledků

ManagedInstancePecProperty

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

Name Typ Description
id

string

ID prostředku.

properties

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointConnectionProperties

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

Name Typ Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

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

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

provisioningState

string

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

ManagedInstancePrivateEndpointProperty

Name Typ Description
id

string

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Typ 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žitý pro připojení k instanci.

Name Typ Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

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

Výchozí: Běžné vytváření instancí.

Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.

Name Typ Description
Default

string

PointInTimeRestore

string

PrincipalType

Typ objektu zabezpečení správce serveru.

Name Typ Description
Application

string

Group

string

User

string

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Typ Description
principalId

string

ID objektu zabezpečení Azure Active Directory.

tenantId

string

ID tenanta Azure Active Directory.

type

IdentityType

Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.

userAssignedIdentities

<string,  UserIdentity>

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

ServicePrincipalType

Typ instančního objektu.

ServicePrincipalType

Typ instančního objektu.

Name Typ Description
None

string

SystemAssigned

string

Sku

Skladová položka prostředku ARM.

Name Typ 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 to tady zaznamenat.

name

string

Název skladové položky, obvykle písmeno + číslo, například 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 Typ Description
clientId

string

ID klienta Azure Active Directory.

principalId

string

ID objektu zabezpečení Azure Active Directory.