Managed Instances - Create Or Update
Tworzy lub aktualizuje wystąpienie zarządzane.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2025-01-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
managed
|
path | True |
string |
Nazwa wystąpienia zarządzanego. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string (uuid) |
Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| identity |
Tożsamość Azure Active Directory zarządzanej instancji. |
||
| 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 (password) |
Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). |
|
| properties.administrators |
Administrator Azure Active Directory może być używany podczas tworzenia instancji oraz aktualizacji instancji, z wyjątkiem właściwości azureADOnlyAuthentication. Aby zaktualizować właściwość azureADOnlyAuthentication, należy użyć indywidualnego interfejsu API. |
||
| properties.authenticationMetadata |
Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. |
||
| properties.collation |
string |
Sortowanie wystąpienia zarządzanego. |
|
| properties.databaseFormat |
Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu SQL. |
||
| properties.dnsZonePartner |
string (arm-id) |
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.hybridSecondaryUsage |
Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). |
||
| properties.instancePoolId |
string |
Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. |
|
| properties.isGeneralPurposeV2 |
boolean |
Niezależnie od tego, czy jest to wariant GPv2 wersji Ogólnego przeznaczenia. |
|
| properties.keyId |
string |
Identyfikator URI klucza cmK 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.memorySizeInGB |
integer (int32) |
Rozmiar pamięci w GB. Wartość minimalna: 28. Wartość maksymalna: 870. Wartość minimalna i maksymalna zależy od liczby rdzeni wirtualnych i warstwy usługi. Więcej informacji na temat limitów zasobów można znaleźć tutaj: https://aka.ms/mi-resource-limits-api. |
|
| properties.minimalTlsVersion |
string |
Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" |
|
| properties.pricingModel |
Model wyceny Managed Instance. |
||
| properties.primaryUserAssignedIdentityId |
string (arm-id) |
Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. |
|
| 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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) |
||
| properties.requestedLogicalAvailabilityZone |
Określa logiczną strefę dostępności, do której przypięty jest Managed Instance. |
||
| properties.restorePointInTime |
string (date-time) |
Określa punkt w czasie (ISO8601 format) ź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 (arm-id) |
Identyfikator zasobu źródłowego wystąpienia zarządzanego skojarzonego z operacją tworzenia tego wystąpienia. |
|
| properties.storageIOps |
integer (int32) |
Operacje we/wy pamięci masowej. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. |
|
| properties.storageSizeInGB |
integer (int32) |
Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 32768. Liczba dozwolonych przyrostów 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. |
|
| properties.storageThroughputMBps |
integer (int32) |
Parametr MBps przepływności magazynu nie jest obsługiwany w operacji tworzenia/aktualizowania wystąpienia. |
|
| properties.subnetId |
string (arm-id) |
Identyfikator zasobu podsieci dla wystąpienia zarządzanego. |
|
| properties.timezoneId |
string |
Identyfikator strefy czasowej. Dozwolone wartości to strefy czasowe obsługiwane przez Windows. Windows przechowuje szczegóły dotyczące obsługiwanych stref czasowych, w tym identyfikator, w rejestrze w KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Wartości rejestru można uzyskać przez SQL Server, zapytując SELECT name 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 "Czas standardowy pacyficzny" lub "W. Europa (czas standardowy). |
|
| properties.vCores |
integer (int32) |
Liczba rdzeni wirtualnych. Dozwolone wartości: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Obsługiwane rdzenie wirtualne zależą od wybranej rodziny sprzętu i warstwy usług. |
|
| properties.zoneRedundant |
boolean |
Czy nadmiarowość strefy jest włączona. |
|
| sku |
Jednostka SKU wystąpienia zarządzanego. Dopuszczalne wartości dla sku.name: GP_Gen5 (ogólnego przeznaczenia, seria standardowa); GP_G8IM (ogólnego przeznaczenia, seria Premium); GP_G8IH (ogólnego przeznaczenia, zoptymalizowana pod kątem pamięci serii Premium); BC_Gen5 (Krytyczne dla biznesu, Standard-Series); BC_G8IM (Krytyczne dla firmy, seria Premium); BC_G8IH (Krytyczne dla działania firmy, zoptymalizowane pod kątem pamięci serii Premium). |
||
| tags |
object |
Tagi zasobów. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Aktualizacja zasobu 'ManagedInstance' zakończyła się sukcesem |
|
| 201 Created |
Operacja tworzenia zasobu 'ManagedInstance' zakończyła się sukcesem Nagłówki
|
|
| 202 Accepted |
Zaakceptowano operację zasobu. Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
| Create managed instance with all properties |
| Create managed instance with minimal properties |
Create managed instance with all properties
Przykładowe żądanie
PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01
{
"location": "Japan East",
"properties": {
"administratorLogin": "dummylogin",
"administratorLoginPassword": "PLACEHOLDER",
"administrators": {
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"principalType": "User",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"authenticationMetadata": "AzureAD",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"databaseFormat": "AlwaysUpToDate",
"dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"hybridSecondaryUsage": "Passive",
"instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"minimalTlsVersion": "1.2",
"proxyOverride": "Redirect",
"publicDataEndpointEnabled": false,
"requestedBackupStorageRedundancy": "Geo",
"requestedLogicalAvailabilityZone": "1",
"servicePrincipal": {
"type": "SystemAssigned"
},
"storageSizeInGB": 1024,
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"timezoneId": "UTC",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose"
},
"tags": {
"tagKey1": "TagValue1"
}
}
Przykładowa odpowiedź
{
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"administrators": {
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"principalType": "User",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"authenticationMetadata": "AzureAD",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"currentBackupStorageRedundancy": "Geo",
"databaseFormat": "AlwaysUpToDate",
"dnsZone": "1b4e2caff2530",
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"hybridSecondaryUsage": "Passive",
"instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"minimalTlsVersion": "1.2",
"provisioningState": "Creating",
"proxyOverride": "Redirect",
"publicDataEndpointEnabled": false,
"requestedBackupStorageRedundancy": "Geo",
"requestedLogicalAvailabilityZone": "1",
"servicePrincipal": {
"type": "SystemAssigned",
"clientId": "00000011-1111-2222-2222-123456789111",
"principalId": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"state": "Ready",
"storageSizeInGB": 1024,
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"timezoneId": "UTC",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"capacity": 8,
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {
"tagKey1": "TagValue1"
}
}
{
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"administrators": {
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"principalType": "User",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"authenticationMetadata": "AzureAD",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"currentBackupStorageRedundancy": "Geo",
"databaseFormat": "AlwaysUpToDate",
"dnsZone": "1b4e2caff2530",
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"hybridSecondaryUsage": "Passive",
"instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"minimalTlsVersion": "1.2",
"provisioningState": "Creating",
"proxyOverride": "Redirect",
"publicDataEndpointEnabled": false,
"requestedBackupStorageRedundancy": "Geo",
"requestedLogicalAvailabilityZone": "1",
"servicePrincipal": {
"type": "SystemAssigned",
"clientId": "00000011-1111-2222-2222-123456789111",
"principalId": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"state": "Ready",
"storageSizeInGB": 1024,
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"timezoneId": "UTC",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"capacity": 8,
"family": "Gen5",
"tier": "GeneralPurpose"
},
"tags": {
"tagKey1": "TagValue1"
}
}
Create managed instance with minimal properties
Przykładowe żądanie
PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01
{
"location": "Japan East",
"properties": {
"administratorLogin": "dummylogin",
"administratorLoginPassword": "PLACEHOLDER",
"licenseType": "LicenseIncluded",
"storageSizeInGB": 1024,
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose"
}
}
Przykładowa odpowiedź
{
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"currentBackupStorageRedundancy": "Geo",
"databaseFormat": "SQLServer2022",
"dnsZone": "1b4e2caff2530",
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"hybridSecondaryUsage": "Passive",
"licenseType": "LicenseIncluded",
"provisioningState": "Creating",
"proxyOverride": "Redirect",
"publicDataEndpointEnabled": false,
"requestedBackupStorageRedundancy": "Geo",
"state": "Ready",
"storageSizeInGB": 1024,
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"capacity": 8,
"family": "Gen4",
"tier": "GeneralPurpose"
},
"tags": {}
}
{
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances",
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"currentBackupStorageRedundancy": "Geo",
"databaseFormat": "SQLServer2022",
"dnsZone": "1b4e2caff2530",
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"hybridSecondaryUsage": "Passive",
"licenseType": "LicenseIncluded",
"provisioningState": "Creating",
"proxyOverride": "Redirect",
"publicDataEndpointEnabled": false,
"requestedBackupStorageRedundancy": "Geo",
"state": "Ready",
"storageSizeInGB": 1024,
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"vCores": 8
},
"sku": {
"name": "GP_Gen5",
"capacity": 8,
"family": "Gen4",
"tier": "GeneralPurpose"
},
"tags": {}
}
Definicje
| Nazwa | Opis |
|---|---|
|
Administrator |
Typ administratora serwera. |
|
Auth |
Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. |
|
Availability |
Określa strefę dostępności, do których jest przypięta baza danych. |
|
Backup |
Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych. |
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
External |
Stan nadzoru zewnętrznego. |
|
Hybrid |
Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). |
|
Hybrid |
Wykryto użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (klient nie spełnia wymagań dotyczących używania pomocniczego jako pasywnego odzyskiwania po awarii) i "Pasywne" (klient spełnia wymagania dotyczące używania pomocniczego jako pasywnego odzyskiwania po awarii). |
|
Identity |
Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę Azure Active Directory dla zasobu. |
|
Managed |
Zarządzana instancja Azure SQL. |
|
Managed |
Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu 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 |
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. |
|
Pricing |
Model wyceny Managed Instance. |
|
Principal |
Typ podmiotu zabezpieczeń administratora serwera. |
|
Provisioning |
Stan aprowizacji zadania w usłudze ARM. |
|
Resource |
Azure Active Directory identity configuration for a resource. |
|
Service |
Konfiguracja jednostki usługi wystąpienia zarządzanego dla zasobu. |
|
Service |
Typ jednostki usługi. |
| Sku |
Jednostka SKU zasobu usługi ARM. |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
User |
Azure Active Directory identity configuration for a resource. |
AdministratorType
Typ administratora serwera.
| Wartość | Opis |
|---|---|
| ActiveDirectory |
Usługa ActiveDirectory |
AuthMetadataLookupModes
Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego.
| Wartość | Opis |
|---|---|
| AzureAD |
Usługa AzureAD |
| Paired |
Para |
| Windows |
Windows |
AvailabilityZoneType
Określa strefę dostępności, do których jest przypięta baza danych.
| Wartość | Opis |
|---|---|
| NoPreference |
NoPreference |
| 1 |
1 |
| 2 |
2 |
| 3 |
3 |
BackupStorageRedundancy
Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.
| Wartość | Opis |
|---|---|
| Geo |
Geo |
| Local |
Lokalny |
| Zone |
Strefa |
| GeoZone |
Strefa geograficzna |
createdByType
Typ tożsamości, która utworzyła zasób.
| Wartość | Opis |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Błąd dodatkowe informacje. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
ExternalGovernanceStatus
Stan nadzoru zewnętrznego.
| Wartość | Opis |
|---|---|
| Enabled |
Enabled |
| Disabled |
Wyłączony |
HybridSecondaryUsage
Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii).
| Wartość | Opis |
|---|---|
| Active |
Aktywne |
| Passive |
Passive |
HybridSecondaryUsageDetected
Wykryto użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (klient nie spełnia wymagań dotyczących używania pomocniczego jako pasywnego odzyskiwania po awarii) i "Pasywne" (klient spełnia wymagania dotyczące używania pomocniczego jako pasywnego odzyskiwania po awarii).
| Wartość | Opis |
|---|---|
| Active |
Aktywne |
| Passive |
Passive |
IdentityType
Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę Azure Active Directory dla zasobu.
| Wartość | Opis |
|---|---|
| None |
Żadne |
| SystemAssigned |
SystemowoPrzydzielony |
| UserAssigned |
UserAssigned |
| SystemAssigned,UserAssigned |
SystemPrzypisany,Przypisany przez użytkownika |
ManagedInstance
Zarządzana instancja Azure SQL.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Tożsamość Azure Active Directory zarządzanej instancji. |
|
| location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| 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 (password) |
Hasło logowania administratora (wymagane do utworzenia wystąpienia zarządzanego). |
| properties.administrators |
Administrator Azure Active Directory może być używany podczas tworzenia instancji oraz aktualizacji instancji, z wyjątkiem właściwości azureADOnlyAuthentication. Aby zaktualizować właściwość azureADOnlyAuthentication, należy użyć indywidualnego interfejsu API. |
|
| properties.authenticationMetadata |
Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego. |
|
| properties.collation |
string |
Sortowanie wystąpienia zarządzanego. |
| properties.createTime |
string (date-time) |
Określa punkt w czasie (ISO8601 format) Managed Instance tworzenia. |
| properties.currentBackupStorageRedundancy |
Typ konta magazynu używany do przechowywania kopii zapasowych dla tego wystąpienia. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) |
|
| properties.databaseFormat |
Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu SQL. |
|
| properties.dnsZone |
string |
Strefa DNS, w ramach którego znajduje się wystąpienie zarządzane. |
| properties.dnsZonePartner |
string (arm-id) |
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.externalGovernanceStatus |
Stan nadzoru zewnętrznego. |
|
| properties.fullyQualifiedDomainName |
string |
W pełni kwalifikowana nazwa domeny wystąpienia zarządzanego. |
| properties.hybridSecondaryUsage |
Użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (wartość domyślna) i "Pasywne" (klient używa pomocniczego jako pasywnego odzyskiwania po awarii). |
|
| properties.hybridSecondaryUsageDetected |
Wykryto użycie pomocnicze hybrydowe. Możliwe wartości to "Aktywne" (klient nie spełnia wymagań dotyczących używania pomocniczego jako pasywnego odzyskiwania po awarii) i "Pasywne" (klient spełnia wymagania dotyczące używania pomocniczego jako pasywnego odzyskiwania po awarii). |
|
| properties.instancePoolId |
string |
Identyfikator puli wystąpień, do którego należy ten serwer zarządzany. |
| properties.isGeneralPurposeV2 |
boolean |
Niezależnie od tego, czy jest to wariant GPv2 wersji Ogólnego przeznaczenia. |
| properties.keyId |
string |
Identyfikator URI klucza cmK 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.memorySizeInGB |
integer (int32) |
Rozmiar pamięci w GB. Wartość minimalna: 28. Wartość maksymalna: 870. Wartość minimalna i maksymalna zależy od liczby rdzeni wirtualnych i warstwy usługi. Więcej informacji na temat limitów zasobów można znaleźć tutaj: https://aka.ms/mi-resource-limits-api. |
| properties.minimalTlsVersion |
string |
Minimalna wersja protokołu TLS. Dozwolone wartości: "None", "1.0", "1.1", "1.2" |
| properties.pricingModel |
Model wyceny Managed Instance. |
|
| properties.primaryUserAssignedIdentityId |
string (arm-id) |
Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany. |
| properties.privateEndpointConnections |
Lista połączeń prywatnych punktów końcowych w wystąpieniu zarządzanym. |
|
| properties.provisioningState |
Stan aprowizacji wystąpienia zarządzanego. |
|
| 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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage) |
|
| properties.requestedLogicalAvailabilityZone |
Określa logiczną strefę dostępności, do której przypięty jest Managed Instance. |
|
| properties.restorePointInTime |
string (date-time) |
Określa punkt w czasie (ISO8601 format) ź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 (arm-id) |
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.storageIOps |
integer (int32) |
Operacje we/wy pamięci masowej. Wartość minimalna: 300. Wartość maksymalna: 80000. Liczba operacji we/wy na sekundę jest 1 dozwolona. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. |
| properties.storageSizeInGB |
integer (int32) |
Rozmiar magazynu w GB. Wartość minimalna: 32. Wartość maksymalna: 32768. Liczba dozwolonych przyrostów 32 GB. Maksymalna wartość zależy od wybranej rodziny sprzętu i liczby rdzeni wirtualnych. |
| properties.storageThroughputMBps |
integer (int32) |
Parametr MBps przepływności magazynu nie jest obsługiwany w operacji tworzenia/aktualizowania wystąpienia. |
| properties.subnetId |
string (arm-id) |
Identyfikator zasobu podsieci dla wystąpienia zarządzanego. |
| properties.timezoneId |
string |
Identyfikator strefy czasowej. Dozwolone wartości to strefy czasowe obsługiwane przez Windows. Windows przechowuje szczegóły dotyczące obsługiwanych stref czasowych, w tym identyfikator, w rejestrze w KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Wartości rejestru można uzyskać przez SQL Server, zapytując SELECT name 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 "Czas standardowy pacyficzny" lub "W. Europa (czas standardowy). |
| properties.vCores |
integer (int32) |
Liczba rdzeni wirtualnych. Dozwolone wartości: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Obsługiwane rdzenie wirtualne zależą od wybranej rodziny sprzętu i warstwy usług. |
| properties.virtualClusterId |
string |
Wirtualny klaster resource id dla Managed Instance. |
| properties.zoneRedundant |
boolean |
Czy nadmiarowość strefy jest włączona. |
| sku |
Jednostka SKU wystąpienia zarządzanego. Dopuszczalne wartości dla sku.name: GP_Gen5 (ogólnego przeznaczenia, seria standardowa); GP_G8IM (ogólnego przeznaczenia, seria Premium); GP_G8IH (ogólnego przeznaczenia, zoptymalizowana pod kątem pamięci serii Premium); BC_Gen5 (Krytyczne dla biznesu, Standard-Series); BC_G8IM (Krytyczne dla firmy, seria Premium); BC_G8IH (Krytyczne dla działania firmy, zoptymalizowane pod kątem pamięci serii Premium). |
|
| systemData |
Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
| tags |
object |
Tagi zasobów. |
| type |
string |
Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts" |
ManagedInstanceDatabaseFormat
Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu SQL.
| Wartość | Opis |
|---|---|
| AlwaysUpToDate |
ZawszeNa Aktualnym |
| SQLServer2022 |
SQLServer2022 |
| SQLServer2025 |
SQLServer2025 |
ManagedInstanceExternalAdministrator
Właściwości administratora usługi Active Directory.
| Nazwa | Typ | Opis |
|---|---|---|
| administratorType |
Typ administratora serwera. |
|
| azureADOnlyAuthentication |
boolean |
Azure Active Directory tylko uwierzytelnianie włączone. |
| login |
string |
Nazwa logowania administratora serwera. |
| principalType |
Typ podmiotu zabezpieczeń administratora serwera. |
|
| sid |
string (uuid) |
Identyfikator SID (identyfikator obiektu) administratora serwera. |
| tenantId |
string (uuid) |
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).
| Wartość | Opis |
|---|---|
| LicenseIncluded |
LicencjaUwzględniona |
| BasePrice |
BasePrice |
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.
| Wartość | Opis |
|---|---|
| Proxy |
Proxy |
| Redirect |
Redirect |
| Default |
Wartość domyślna |
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.
| Wartość | Opis |
|---|---|
| Default |
Wartość domyślna |
| PointInTimeRestore |
PointInTimeRestore |
PricingModel
Model wyceny Managed Instance.
| Wartość | Opis |
|---|---|
| Regular |
Standardowy |
| Freemium |
Freemium |
PrincipalType
Typ podmiotu zabezpieczeń administratora serwera.
| Wartość | Opis |
|---|---|
| User |
Użytkownik |
| Group |
Grupa |
| Application |
Application |
ProvisioningState
Stan aprowizacji zadania w usłudze ARM.
| Wartość | Opis |
|---|---|
| Created |
Created |
| InProgress |
W toku |
| Succeeded |
Powodzenie |
| Failed |
Niepowodzenie |
| Canceled |
Anulowane |
ResourceIdentity
Azure Active Directory identity configuration for a resource.
| Nazwa | Typ | Opis |
|---|---|---|
| principalId |
string (uuid) |
The Azure Active Directory principal id. |
| tenantId |
string (uuid) |
Identyfikator tenant Azure Active Directory. |
| type |
Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę 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 Azure Active Directory. |
| principalId |
string |
Identyfikator obiektu aplikacji Azure Active Directory. |
| tenantId |
string |
Identyfikator tenant Azure Active Directory. |
| type |
Typ jednostki usługi. |
ServicePrincipalType
Typ jednostki usługi.
| Wartość | Opis |
|---|---|
| None |
Żadne |
| SystemAssigned |
SystemowoPrzydzielony |
Sku
Jednostka SKU zasobu usługi ARM.
| Nazwa | Typ | Opis |
|---|---|---|
| capacity |
integer (int32) |
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 konkretnej jednostki SKU |
| tier |
string |
Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
| Nazwa | Typ | Opis |
|---|---|---|
| createdAt |
string (date-time) |
Sygnatura czasowa tworzenia zasobu (UTC). |
| createdBy |
string |
Tożsamość, która utworzyła zasób. |
| createdByType |
Typ tożsamości, która utworzyła zasób. |
|
| lastModifiedAt |
string (date-time) |
Znacznik czasu ostatniej modyfikacji zasobu (UTC) |
| lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
| lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
UserIdentity
Azure Active Directory identity configuration for a resource.
| Nazwa | Typ | Opis |
|---|---|---|
| clientId |
string (uuid) |
Identyfikator klienta Azure Active Directory. |
| principalId |
string (uuid) |
The Azure Active Directory principal id. |