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
managedInstanceName
path True

string

Nazwa wystąpienia zarządzanego.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
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

ResourceIdentity

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

ManagedInstanceExternalAdministrator

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

AuthMetadataLookupModes

Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego.

properties.collation

string

Sortowanie wystąpienia zarządzanego.

properties.databaseFormat

ManagedInstanceDatabaseFormat

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

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

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

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

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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage)

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

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

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

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

ManagedInstance

Aktualizacja zasobu 'ManagedInstance' zakończyła się sukcesem

201 Created

ManagedInstance

Operacja tworzenia zasobu 'ManagedInstance' zakończyła się sukcesem

Nagłówki

  • Location: string
  • Retry-After: integer
202 Accepted

Zaakceptowano operację zasobu.

Nagłówki

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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
AdministratorType

Typ administratora serwera.

AuthMetadataLookupModes

Tryb wyszukiwania metadanych uwierzytelniania wystąpienia zarządzanego.

AvailabilityZoneType

Określa strefę dostępności, do których jest przypięta baza danych.

BackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ExternalGovernanceStatus

Stan nadzoru zewnętrznego.

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).

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).

IdentityType

Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę Azure Active Directory dla zasobu.

ManagedInstance

Zarządzana instancja Azure SQL.

ManagedInstanceDatabaseFormat

Określa wewnętrzny format baz danych wystąpień specyficzny dla wersji aparatu 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.

PricingModel

Model wyceny Managed Instance.

PrincipalType

Typ podmiotu zabezpieczeń administratora serwera.

ProvisioningState

Stan aprowizacji zadania w usłudze ARM.

ResourceIdentity

Azure Active Directory identity configuration for a resource.

ServicePrincipal

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

ServicePrincipalType

Typ jednostki usługi.

Sku

Jednostka SKU zasobu usługi ARM.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UserIdentity

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

ErrorAdditionalInfo[]

Błąd dodatkowe informacje.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

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

ResourceIdentity

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

ManagedInstanceExternalAdministrator

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

AuthMetadataLookupModes

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

BackupStorageRedundancy

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

ManagedInstanceDatabaseFormat

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

ExternalGovernanceStatus

Stan nadzoru zewnętrznego.

properties.fullyQualifiedDomainName

string

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

properties.hybridSecondaryUsage

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

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

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

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

ManagedInstancePecProperty[]

Lista połączeń prywatnych punktów końcowych w wystąpieniu zarządzanym.

properties.provisioningState

ProvisioningState

Stan aprowizacji wystąpienia zarządzanego.

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. Dostępne opcje to LocallyRedundantStorage, Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) i GeoZone(GeoZoneRedundantStorage)

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

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

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

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

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

AdministratorType

Typ administratora serwera.

azureADOnlyAuthentication

boolean

Azure Active Directory tylko uwierzytelnianie włączone.

login

string

Nazwa logowania administratora serwera.

principalType

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

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.

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

IdentityType

Typ tożsamości. Ustaw to na 'SystemAssigned', aby automatycznie utworzyć i przypisać zasadę 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 Azure Active Directory.

principalId

string

Identyfikator obiektu aplikacji Azure Active Directory.

tenantId

string

Identyfikator tenant Azure Active Directory.

type

ServicePrincipalType

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

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

createdByType

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.