Managed Instances - List By Resource Group
Pobiera listę wystąpień zarządzanych w grupie zasobów.
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 identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
resource
|
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. |
subscription
|
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 |
Pomyślnie pobrano listę wystąpień zarządzanych. |
|
Other Status Codes |
Odpowiedzi na błędy: ***
|
Przykłady
List managed instances by resource group |
List managed instances by resource group with $expand=administrators/activedirectory |
List managed instances by resource group
Przykładowe żądanie
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
Przykładowa odpowiedź
{
"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
}
}
}
]
}
Definicje
Nazwa | Opis |
---|---|
Administrator |
Typ administratora serwera. |
Backup |
Typ konta magazynu używany do przechowywania kopii zapasowych dla tego wystąpienia. Opcje to Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) |
Identity |
Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. |
Managed |
Wystąpienie zarządzane Azure SQL. |
Managed |
Właściwości administratora usługi Active Directory. |
Managed |
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). |
Managed |
Lista wystąpień zarządzanych. |
Managed |
Połączenie prywatnego punktu końcowego w ramach wystąpienia zarządzanego |
Managed |
Właściwości połączenia prywatnego punktu końcowego. |
Managed |
|
Managed |
|
Managed |
Typ połączenia używany do nawiązywania połączenia z wystąpieniem. |
Managed |
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. |
Principal |
Typ podmiotu zabezpieczeń administratora serwera. |
Resource |
Konfiguracja tożsamości usługi Azure Active Directory dla zasobu. |
Service |
Konfiguracja jednostki usługi wystąpienia zarządzanego dla zasobu. |
Service |
Typ jednostki usługi. |
Sku |
Jednostka SKU zasobu usługi ARM. |
User |
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 |
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 |
Administrator usługi Azure Active Directory serwera. |
|
properties.collation |
string |
Sortowanie wystąpienia zarządzanego. |
properties.currentBackupStorageRedundancy |
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 |
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 |
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 |
Lista połączeń prywatnego punktu końcowego w wystąpieniu zarządzanym. |
|
properties.provisioningState |
enum:
|
|
properties.proxyOverride |
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 |
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 |
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 |
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 |
Typ administratora serwera. |
|
azureADOnlyAuthentication |
boolean |
Włączono tylko uwierzytelnianie usługi Azure Active Directory. |
login |
string |
Nazwa logowania administratora serwera. |
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 |
ManagedInstanceListResult
Lista wystąpień zarządzanych.
Nazwa | Typ | Opis |
---|---|---|
nextLink |
string |
Link, aby pobrać następną stronę wyników. |
value |
Tablica wyników. |
ManagedInstancePecProperty
Połączenie prywatnego punktu końcowego w ramach wystąpienia zarządzanego
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
properties |
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 |
Prywatny punkt końcowy, do którego należy połączenie. |
|
privateLinkServiceConnectionState |
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 |
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,
User |
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 |
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. |