Managed Instances - Get

Pobiera wystąpienie zarządzane.

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 identyfikatora URI

Nazwa W Wymagane Typ Opis
managedInstanceName
path True

string

Nazwa wystąpienia zarządzanego.

resourceGroupName
path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

subscriptionId
path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True

string

Wersja interfejsu API do użycia dla żądania.

$expand
query

string

Zasoby podrzędne do uwzględnienia w odpowiedzi.

Odpowiedzi

Nazwa Typ Opis
200 OK

ManagedInstance

Pomyślnie pobrano określone wystąpienie zarządzane.

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy — Geo-Restore nie jest dozwolona dla wystąpień zarządzanych z nadmiarowością magazynu kopii zapasowych LRS/ZRS.

  • 400 ZaktualizowanieinstanceAndBackupRedundancy — nadmiarowość strefy wystąpienia i nadmiarowość magazynu kopii zapasowych nie może zostać zaktualizowana w tym samym żądaniu.

  • 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów, tak jak to jest, bez zmian

  • 400 AadOnlyAuthenticationIsEnabled — jest włączone tylko uwierzytelnianie usługi Azure Active Directory. Skontaktuj się z administratorem systemu.

  • 400 ManagementServiceFeatureDisabled — użytkownik próbował użyć funkcji, która jest wyłączona.

  • 404 SubscriptionNotFound — nie znaleziono żądanej subskrypcji.

  • 404 ServerNotInSubscription — określony serwer nie istnieje w określonej subskrypcji.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup — określone wystąpienie zarządzane nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 SubscriptionNotFound — nie znaleziono żądanej subskrypcji.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 409 ConflictingManagedInstanceOperation — operacja jest obecnie w toku dla wystąpienia zarządzanego.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict — wystąpienie to multi-az, ale magazyn kopii zapasowych jest aktualizowany ze strefy nadmiarowej do strefowo nadmiarowych.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress — nie można zaktualizować nadmiarowości wystąpienia, ponieważ trwa aktualizacja nadmiarowości magazynu kopii zapasowych.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict — magazyn kopii zapasowych jest strefowo nadmiarowy, ale nadmiarowość wystąpień jest aktualizowana do strefowo nadmiarowej.

  • 409 BackupRedundancyUpdateConflict — nie można zaktualizować nadmiarowości magazynu kopii zapasowej, ponieważ aktualizacja nadmiarowości magazynu kopii zapasowej jest już w toku.

  • 409 MiDropFailedOnAuthLocks — użytkownik próbował usunąć ostatnie wystąpienie zarządzane w podsieci, która ma blokadę zastosowaną w zasobach.

  • 409 MiCreateFailedNonDelegatedSubnet — użytkownik próbował wdrożyć wystąpienie zarządzane lub pulę wystąpień zarządzanych w podsieci, która nie jest delegowana do usługi Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate — nie można zaktualizować nadmiarowości magazynu kopii zapasowych, ponieważ wystąpienie nie jest gotowe.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

Przykłady

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

Definicje

Nazwa Opis
AdministratorType

Typ administratora serwera.

BackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tego wystąpienia. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage)

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.

ManagedInstance

Wystąpienie zarządzane Azure SQL.

ManagedInstanceExternalAdministrator

Właściwości administratora usługi Active Directory.

ManagedInstanceLicenseType

Typ licencji. Możliwe wartości to "LicenseIncluded" (zwykła cena włącznie z nową licencją SQL) i "BasePrice" (obniżona cena AHB za wprowadzenie własnych licencji SQL).

ManagedInstancePecProperty

Połączenie prywatnego punktu końcowego w ramach wystąpienia zarządzanego

ManagedInstancePrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Typ połączenia używany do nawiązywania połączenia z wystąpieniem.

ManagedServerCreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie wystąpienia.

Przywracanie: tworzy wystąpienie, przywracając zestaw kopii zapasowych do określonego punktu w czasie. Należy określić wartości RestorePointInTime i SourceManagedInstanceId.

PrincipalType

Typ podmiotu zabezpieczeń administratora serwera.

ResourceIdentity

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

ServicePrincipal

Konfiguracja jednostki usługi wystąpienia zarządzanego dla zasobu.

ServicePrincipalType

Typ jednostki usługi.

Sku

Jednostka SKU zasobu usługi ARM.

UserIdentity

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

AdministratorType

Typ administratora serwera.

Nazwa Typ Opis
ActiveDirectory

string

BackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tego wystąpienia. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage)

Nazwa Typ Opis
Geo

string

GeoZone

string

Local

string

Zone

string

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.

Nazwa Typ Opis
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Wystąpienie zarządzane Azure SQL.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

identity

ResourceIdentity

Tożsamość usługi Azure Active Directory wystąpienia zarządzanego.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.administratorLogin

string

Nazwa użytkownika administratora dla wystąpienia zarządzanego. Można określić tylko wtedy, gdy wystąpienie zarządzane jest tworzone (i jest wymagane do utworzenia).

properties.administratorLoginPassword

string

Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego).

properties.administrators

ManagedInstanceExternalAdministrator

Administrator usługi Azure Active Directory serwera.

properties.collation

string

Sortowanie wystąpienia zarządzanego.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tego wystąpienia. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage)

properties.dnsZone

string

Strefa DNS, w którą znajduje się wystąpienie zarządzane.

properties.dnsZonePartner

string

Identyfikator zasobu innego wystąpienia zarządzanego, którego strefa DNS będzie współużytkowała to wystąpienie zarządzane po utworzeniu.

properties.fullyQualifiedDomainName

string

W pełni kwalifikowana nazwa domeny wystąpienia zarządzanego.

properties.instancePoolId

string

Identyfikator puli wystąpień, do którego należy ten serwer zarządzany.

properties.keyId

string

Identyfikator URI klucza do użycia na potrzeby szyfrowania.

properties.licenseType

ManagedInstanceLicenseType

Typ licencji. Możliwe wartości to "LicenseIncluded" (zwykła cena włącznie z nową licencją SQL) i "BasePrice" (obniżona cena AHB za wprowadzenie własnych licencji SQL).

properties.maintenanceConfigurationId

string

Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego wystąpienia zarządzanego.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie wystąpienia.

Przywracanie: tworzy wystąpienie, przywracając zestaw kopii zapasowych do określonego punktu w czasie. Należy określić wartości RestorePointInTime i SourceManagedInstanceId.

properties.minimalTlsVersion

string

Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId

string

Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Lista połączeń prywatnego punktu końcowego w wystąpieniu zarządzanym.

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

ManagedInstanceProxyOverride

Typ połączenia używany do nawiązywania połączenia z wystąpieniem.

properties.publicDataEndpointEnabled

boolean

Określa, czy publiczny punkt końcowy danych jest włączony.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tego wystąpienia. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string

Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych.

properties.servicePrincipal

ServicePrincipal

Jednostka usługi wystąpienia zarządzanego.

properties.sourceManagedInstanceId

string

Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia.

properties.state

string

Stan wystąpienia zarządzanego.

properties.storageSizeInGB

integer

Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 16384. Dozwolone są tylko przyrosty o rozmiarze 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych.

properties.subnetId

string

Identyfikator zasobu podsieci dla wystąpienia zarządzanego.

properties.timezoneId

string

Identyfikator strefy czasowej. Dozwolone wartości to strefy czasowe obsługiwane przez system Windows. System Windows przechowuje szczegółowe informacje na temat obsługiwanych stref czasowych, w tym identyfikatora, w rejestrze w obszarze KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Te wartości rejestru można uzyskać za pośrednictwem SQL Server, wysyłając zapytanie o nazwę SELECT AS timezone_id FROM sys.time_zone_info. Listę identyfikatorów można również uzyskać, wykonując polecenie [System.TimeZoneInfo]::GetSystemTimeZones() w programie PowerShell. Przykładem prawidłowego identyfikatora strefy czasowej jest "Pacyficzny czas standardowy" lub "W. Europa (czas standardowy).

properties.vCores

integer

Liczba rdzeni wirtualnych. Dozwolone wartości: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant

boolean

Bez względu na to, czy włączono funkcję multi-az.

sku

Sku

Jednostka SKU wystąpienia zarządzanego. Dozwolone wartości sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Tagi zasobów.

type

string

Typ zasobu.

ManagedInstanceExternalAdministrator

Właściwości administratora usługi Active Directory.

Nazwa Typ Opis
administratorType

AdministratorType

Typ administratora serwera.

azureADOnlyAuthentication

boolean

Włączono tylko uwierzytelnianie usługi Azure Active Directory.

login

string

Nazwa logowania administratora serwera.

principalType

PrincipalType

Typ podmiotu zabezpieczeń administratora serwera.

sid

string

Identyfikator SID (identyfikator obiektu) administratora serwera.

tenantId

string

Identyfikator dzierżawy administratora.

ManagedInstanceLicenseType

Typ licencji. Możliwe wartości to "LicenseIncluded" (zwykła cena włącznie z nową licencją SQL) i "BasePrice" (obniżona cena AHB za wprowadzenie własnych licencji SQL).

Nazwa Typ Opis
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

Połączenie prywatnego punktu końcowego w ramach wystąpienia zarządzanego

Nazwa Typ Opis
id

string

Identyfikator zasobu.

properties

ManagedInstancePrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego

ManagedInstancePrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego.

Nazwa Typ Opis
privateEndpoint

ManagedInstancePrivateEndpointProperty

Prywatny punkt końcowy, do którego należy połączenie.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Stan połączenia prywatnego punktu końcowego.

provisioningState

string

Stan połączenia prywatnego punktu końcowego.

ManagedInstancePrivateEndpointProperty

Nazwa Typ Opis
id

string

Identyfikator zasobu prywatnego punktu końcowego.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Nazwa Typ Opis
actionsRequired

string

Opis połączenia usługi private link.

description

string

Opis połączenia usługi private link.

status

string

Stan połączenia usługi private link.

ManagedInstanceProxyOverride

Typ połączenia używany do nawiązywania połączenia z wystąpieniem.

Nazwa Typ Opis
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie wystąpienia.

Przywracanie: tworzy wystąpienie, przywracając zestaw kopii zapasowych do określonego punktu w czasie. Należy określić wartości RestorePointInTime i SourceManagedInstanceId.

Nazwa Typ Opis
Default

string

PointInTimeRestore

string

PrincipalType

Typ podmiotu zabezpieczeń administratora serwera.

Nazwa Typ Opis
Application

string

Group

string

User

string

ResourceIdentity

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

Nazwa Typ Opis
principalId

string

Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory.

tenantId

string

Identyfikator dzierżawy usługi Azure Active Directory.

type

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.

userAssignedIdentities

<string,  UserIdentity>

Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia

ServicePrincipal

Konfiguracja jednostki usługi wystąpienia zarządzanego dla zasobu.

Nazwa Typ Opis
clientId

string

Identyfikator klienta aplikacji usługi Azure Active Directory.

principalId

string

Identyfikator obiektu aplikacji usługi Azure Active Directory.

tenantId

string

Identyfikator dzierżawy usługi Azure Active Directory.

type

ServicePrincipalType

Typ jednostki usługi.

ServicePrincipalType

Typ jednostki usługi.

Nazwa Typ Opis
None

string

SystemAssigned

string

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa Typ Opis
capacity

integer

Pojemność określonej jednostki SKU.

family

string

Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.

name

string

Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.

size

string

Rozmiar określonej jednostki SKU

tier

string

Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.

UserIdentity

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

Nazwa Typ Opis
clientId

string

Identyfikator klienta usługi Azure Active Directory.

principalId

string

Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory.