Managed Instances - Create Or Update

Tjänst:: SQL Database

API-version:: 2025-01-01

Skapar eller uppdaterar en hanterad instans.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2025-01-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
identity		ResourceIdentity	Azure Active Directory-identiteten för den hanterade instansen.
properties.administratorLogin		string	Administratörsanvändarnamn för den hanterade instansen. Kan bara anges när den hanterade instansen skapas (och krävs för att skapa).
properties.administratorLoginPassword		string (password)	Administratörens inloggningslösenord (krävs för att skapa en hanterad instans).
properties.administrators		ManagedInstanceExternalAdministrator	Azure Active Directory-administratören kan användas vid instansskapande och för instansuppdateringar, förutom för egenskapen azureADOnlyAuthentication. Om du vill uppdatera egenskapen azureADOnlyAuthentication måste ett enskilt API användas.
properties.authenticationMetadata		AuthMetadataLookupModes	Den hanterade instansens uppslagsläge för autentiseringsmetadata.
properties.collation		string	Sortering av den hanterade instansen.
properties.databaseFormat		ManagedInstanceDatabaseFormat	Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen.
properties.dnsZonePartner		string (arm-id)	Resurs-ID för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats.
properties.hybridSecondaryUsage		HybridSecondaryUsage	Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).
properties.instancePoolId		string	ID:t för instanspoolen som den hanterade servern tillhör.
properties.isGeneralPurposeV2		boolean	Om det här är en GPv2-variant av General Purpose Edition eller inte.
properties.keyId		string	En CMK-URI för nyckeln som ska användas för kryptering.
properties.licenseType		ManagedInstanceLicenseType	Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser).
properties.maintenanceConfigurationId		string	Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen.
properties.managedInstanceCreateMode		ManagedServerCreateMode	Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.
properties.memorySizeInGB		integer (int32)	Minnesstorlek i GB. Minsta värde: 28. Maximalt värde: 870. Det lägsta och högsta värdet beror på antalet virtuella kärnor och tjänstnivån. Läs mer om resursgränser: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion		string	Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2"
properties.pricingModel		PricingModel	Prissättningsmodellen för Managed Instance.
properties.primaryUserAssignedIdentityId		string (arm-id)	Resurs-ID för en användartilldelad identitet som ska användas som standard.
properties.proxyOverride		ManagedInstanceProxyOverride	Anslutningstyp som används för att ansluta till instansen.
properties.publicDataEndpointEnabled		boolean	Om slutpunkten för offentliga data är aktiverad eller inte.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Specificerar den logiska tillgänglighetszon som Managed Instance är fäst vid.
properties.restorePointInTime		string (date-time)	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.
properties.servicePrincipal		ServicePrincipal	Den hanterade instansens huvudnamn för tjänsten.
properties.sourceManagedInstanceId		string (arm-id)	Resursidentifieraren för den källhanterade instans som är associerad med skapa-åtgärden för den här instansen.
properties.storageIOps		integer (int32)	IOps för lagring. Minsta värde: 300. Maximalt värde: 80000. Steg om endast 1 IOps tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.storageSizeInGB		integer (int32)	Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 32768. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.storageThroughputMBps		integer (int32)	Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd.
properties.subnetId		string (arm-id)	Resurs-ID för undernätet för den hanterade instansen.
properties.timezoneId		string	ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows sparar detaljer om stödda tidszoner, inklusive id, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Du kan få dessa registervärden via SQL Server genom att söka SELECT name AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid".
properties.vCores		integer (int32)	Antalet virtuella kärnor. Tillåtna värden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Vilka virtuella kärnor som stöds beror på den valda maskinvarufamiljen och tjänstnivån.
properties.zoneRedundant		boolean	Om zonredundansen är aktiverad eller inte.
sku		Sku	SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5 (Generell användning, Standard-serien); GP_G8IM (Generell användning, Premium-serien); GP_G8IH (Generell användning, Premium-seriens minne optimerat); BC_Gen5 (Affärskritisk, Standard-Series); BC_G8IM (Affärskritisk, Premium-serien); BC_G8IH (Affärskritisk, minnesoptimerad i Premium-serien).
tags		object	Resursetiketter.

Svar

Name	Typ	Description
200 OK	ManagedInstance	Uppdateringsoperationen för resursen 'ManagedInstance' lyckades
201 Created	ManagedInstance	Resursen 'ManagedInstance' skapade operationen lyckades Sidhuvuden Location: string Retry-After: integer
202 Accepted		Resursåtgärden har godkänts. Sidhuvuden Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

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

Statuskod:: 201

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

Statuskod:: 202

Create managed instance with minimal properties

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

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

Statuskod:: 201

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

Statuskod:: 202

Definitioner

Name	Description
AdministratorType	Typ av administratör för serverservern.
AuthMetadataLookupModes	Den hanterade instansens uppslagsläge för autentiseringsmetadata.
AvailabilityZoneType	Anger tillgänglighetszonen som databasen är fäst på.
BackupStorageRedundancy	Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen.
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Resurshanteringsfelet ytterligare information.
ErrorDetail	Detaljerna om felet.
ErrorResponse	Felsvar
ExternalGovernanceStatus	Status för extern styrning.
HybridSecondaryUsage	Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).
HybridSecondaryUsageDetected	Hybrid sekundär användning har identifierats. Möjliga värden är "Aktiva" (kunden uppfyller inte kraven för att använda den sekundära som passiv DR) och "Passiv" (kunden uppfyller kraven för att använda den sekundära som passiv DR).
IdentityType	Identitetstypen. Ställ in detta till 'SystemAssigned' för att automatiskt skapa och tilldela en Azure Active Directory-princip för resursen.
ManagedInstance	En Azure SQL managed instance.
ManagedInstanceDatabaseFormat	Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen.
ManagedInstanceExternalAdministrator	Egenskaper för en Active Directory-administratör.
ManagedInstanceLicenseType	Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser).
ManagedInstancePecProperty	En privat slutpunktsanslutning under en hanterad instans
ManagedInstancePrivateEndpointConnectionProperties	Egenskaper för en privat slutpunktsanslutning.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Anslutningstyp som används för att ansluta till instansen.
ManagedServerCreateMode	Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.
PricingModel	Prissättningsmodellen för Managed Instance.
PrincipalType	Huvudtyp för sever-administratören.
ProvisioningState	ARM-etableringstillståndet för jobbkörningen.
ResourceIdentity	Azure Active Directory-identitetskonfiguration för en resurs.
ServicePrincipal	Den hanterade instansens konfiguration av tjänstens huvudnamn för en resurs.
ServicePrincipalType	Tjänstens huvudnamnstyp.
Sku	En ARM-resurs-SKU.
systemData	Metadata som rör skapande och senaste ändring av resursen.
UserIdentity	Azure Active Directory-identitetskonfiguration för en resurs.

AdministratorType

Uppräkning

Typ av administratör för serverservern.

Värde	Description
ActiveDirectory	Active Directory

AuthMetadataLookupModes

Uppräkning

Den hanterade instansens uppslagsläge för autentiseringsmetadata.

Värde	Description
AzureAD	AzureAD (på engelska)
Paired	Parade
Windows	Windows

AvailabilityZoneType

Uppräkning

Anger tillgänglighetszonen som databasen är fäst på.

Värde	Description
NoPreference	NoPreference
1	1
2	2
3	3

BackupStorageRedundancy

Uppräkning

Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen.

Värde	Description
Geo	Geo
Local	Lokal
Zone	Zon
GeoZone	GeoZon

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Resurshanteringsfelet ytterligare information.

Name	Typ	Description
info	object	Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Detaljerna om felet.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Felet ytterligare information.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felet objektet.

ExternalGovernanceStatus

Uppräkning

Status för extern styrning.

Värde	Description
Enabled	Aktiverad
Disabled	Inaktiverad

HybridSecondaryUsage

Uppräkning

Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).

Värde	Description
Active	Aktivt
Passive	Passive

HybridSecondaryUsageDetected

Uppräkning

Hybrid sekundär användning har identifierats. Möjliga värden är "Aktiva" (kunden uppfyller inte kraven för att använda den sekundära som passiv DR) och "Passiv" (kunden uppfyller kraven för att använda den sekundära som passiv DR).

Värde	Description
Active	Aktivt
Passive	Passive

IdentityType

Uppräkning

Identitetstypen. Ställ in detta till 'SystemAssigned' för att automatiskt skapa och tilldela en Azure Active Directory-princip för resursen.

Värde	Description
None	Ingen
SystemAssigned	Systemtilldelad
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemTilldelad, AnvändarTilldelad

ManagedInstance

Objekt

En Azure SQL managed instance.

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	Azure Active Directory-identiteten för den hanterade instansen.
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.administratorLogin	string	Administratörsanvändarnamn för den hanterade instansen. Kan bara anges när den hanterade instansen skapas (och krävs för att skapa).
properties.administratorLoginPassword	string (password)	Administratörens inloggningslösenord (krävs för att skapa en hanterad instans).
properties.administrators	ManagedInstanceExternalAdministrator	Azure Active Directory-administratören kan användas vid instansskapande och för instansuppdateringar, förutom för egenskapen azureADOnlyAuthentication. Om du vill uppdatera egenskapen azureADOnlyAuthentication måste ett enskilt API användas.
properties.authenticationMetadata	AuthMetadataLookupModes	Den hanterade instansens uppslagsläge för autentiseringsmetadata.
properties.collation	string	Sortering av den hanterade instansen.
properties.createTime	string (date-time)	Specificerar tidpunkten (ISO8601 format) för Managed Instance skapande.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Den lagringskontotyp som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen.
properties.dnsZone	string	Dns-zonen som den hanterade instansen finns i.
properties.dnsZonePartner	string (arm-id)	Resurs-ID för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status för extern styrning.
properties.fullyQualifiedDomainName	string	Det fullständigt kvalificerade domännamnet för den hanterade instansen.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Hybrid sekundär användning har identifierats. Möjliga värden är "Aktiva" (kunden uppfyller inte kraven för att använda den sekundära som passiv DR) och "Passiv" (kunden uppfyller kraven för att använda den sekundära som passiv DR).
properties.instancePoolId	string	ID:t för instanspoolen som den hanterade servern tillhör.
properties.isGeneralPurposeV2	boolean	Om det här är en GPv2-variant av General Purpose Edition eller inte.
properties.keyId	string	En CMK-URI för nyckeln som ska användas för kryptering.
properties.licenseType	ManagedInstanceLicenseType	Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser).
properties.maintenanceConfigurationId	string	Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.
properties.memorySizeInGB	integer (int32)	Minnesstorlek i GB. Minsta värde: 28. Maximalt värde: 870. Det lägsta och högsta värdet beror på antalet virtuella kärnor och tjänstnivån. Läs mer om resursgränser: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion	string	Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2"
properties.pricingModel	PricingModel	Prissättningsmodellen för Managed Instance.
properties.primaryUserAssignedIdentityId	string (arm-id)	Resurs-ID för en användartilldelad identitet som ska användas som standard.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Lista över privata slutpunktsanslutningar på en hanterad instans.
properties.provisioningState	ProvisioningState	Etableringstillstånd för hanterad instans.
properties.proxyOverride	ManagedInstanceProxyOverride	Anslutningstyp som används för att ansluta till instansen.
properties.publicDataEndpointEnabled	boolean	Om slutpunkten för offentliga data är aktiverad eller inte.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone	AvailabilityZoneType	Specificerar den logiska tillgänglighetszon som Managed Instance är fäst vid.
properties.restorePointInTime	string (date-time)	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.
properties.servicePrincipal	ServicePrincipal	Den hanterade instansens huvudnamn för tjänsten.
properties.sourceManagedInstanceId	string (arm-id)	Resursidentifieraren för den källhanterade instans som är associerad med skapa-åtgärden för den här instansen.
properties.state	string	Tillståndet för den hanterade instansen.
properties.storageIOps	integer (int32)	IOps för lagring. Minsta värde: 300. Maximalt värde: 80000. Steg om endast 1 IOps tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.storageSizeInGB	integer (int32)	Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 32768. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.storageThroughputMBps	integer (int32)	Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd.
properties.subnetId	string (arm-id)	Resurs-ID för undernätet för den hanterade instansen.
properties.timezoneId	string	ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows sparar detaljer om stödda tidszoner, inklusive id, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Du kan få dessa registervärden via SQL Server genom att söka SELECT name AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid".
properties.vCores	integer (int32)	Antalet virtuella kärnor. Tillåtna värden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Vilka virtuella kärnor som stöds beror på den valda maskinvarufamiljen och tjänstnivån.
properties.virtualClusterId	string	Virtuellt klusterresurs-id för Managed Instance.
properties.zoneRedundant	boolean	Om zonredundansen är aktiverad eller inte.
sku	Sku	SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5 (Generell användning, Standard-serien); GP_G8IM (Generell användning, Premium-serien); GP_G8IH (Generell användning, Premium-seriens minne optimerat); BC_Gen5 (Affärskritisk, Standard-Series); BC_G8IM (Affärskritisk, Premium-serien); BC_G8IH (Affärskritisk, minnesoptimerad i Premium-serien).
systemData	systemData	Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information.
tags	object	Resursetiketter.
type	string	Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts"

ManagedInstanceDatabaseFormat

Uppräkning

Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen.

Värde	Description
AlwaysUpToDate	AlwaysUpToDate
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Objekt

Egenskaper för en Active Directory-administratör.

Name	Typ	Description
administratorType	AdministratorType	Typ av administratör för serverservern.
azureADOnlyAuthentication	boolean	Azure Active Directory-endast autentisering aktiverad.
login	string	Serveradministratörens inloggningsnamn.
principalType	PrincipalType	Huvudtyp för sever-administratören.
sid	string (uuid)	SID (objekt-ID) för serveradministratören.
tenantId	string (uuid)	Administratörens klientorganisations-ID.

ManagedInstanceLicenseType

Uppräkning

Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser).

Värde	Description
LicenseIncluded	LicensInkluderad
BasePrice	BasePrice

ManagedInstancePecProperty

Objekt

En privat slutpunktsanslutning under en hanterad instans

Name	Typ	Description
id	string	Resursidentifikator.
properties	ManagedInstancePrivateEndpointConnectionProperties	Egenskaper för privat slutpunktsanslutning

ManagedInstancePrivateEndpointConnectionProperties

Objekt

Egenskaper för en privat slutpunktsanslutning.

Name	Typ	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
provisioningState	string	Tillståndet för den privata slutpunktsanslutningen.

ManagedInstancePrivateEndpointProperty

Objekt

Name	Typ	Description
id	string	Resurs-ID för den privata slutpunkten.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objekt

Name	Typ	Description
actionsRequired	string	Beskrivning av tjänstanslutningen för privat länk.
description	string	Beskrivning av tjänstanslutningen för privat länk.
status	string	Anslutningsstatus för tjänsten private link.

ManagedInstanceProxyOverride

Uppräkning

Anslutningstyp som används för att ansluta till instansen.

Värde	Description
Proxy	Proxy
Redirect	Omdirigera
Default	Standardinställning

ManagedServerCreateMode

Uppräkning

Anger läget för att skapa databasen.

Standard: Skapande av vanlig instans.

Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.

Värde	Description
Default	Standardinställning
PointInTimeRestore	PointInTimeRestore

PricingModel

Uppräkning

Prissättningsmodellen för Managed Instance.

Värde	Description
Regular	Vanligt
Freemium	Freemium

PrincipalType

Uppräkning

Huvudtyp för sever-administratören.

Värde	Description
User	User
Group	Grupp
Application	Ansökan

ProvisioningState

Uppräkning

ARM-etableringstillståndet för jobbkörningen.

Värde	Description
Created	Skapades
InProgress	InProgress
Succeeded	lyckades
Failed	Misslyckades
Canceled	Annullerad

ResourceIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
principalId	string (uuid)	Azure Active Directory principal id.
tenantId	string (uuid)	Azure Active Directory-tenant-id.
type	IdentityType	Identitetstypen. Ställ in detta till 'SystemAssigned' för att automatiskt skapa och tilldela en Azure Active Directory-princip för resursen.
userAssignedIdentities	<string, UserIdentity>	Resurs-ID:n för de användartilldelade identiteter som ska användas

ServicePrincipal

Objekt

Den hanterade instansens konfiguration av tjänstens huvudnamn för en resurs.

Name	Typ	Description
clientId	string	Azure Active Directory-applikationsklient-id.
principalId	string	Azure Active Directory-applikationsobjekt-id.
tenantId	string	Azure Active Directory-tenant-id.
type	ServicePrincipalType	Tjänstens huvudnamnstyp.

ServicePrincipalType

Uppräkning

Tjänstens huvudnamnstyp.

Värde	Description
None	Ingen
SystemAssigned	Systemtilldelad

Sku

Objekt

En ARM-resurs-SKU.

Name	Typ	Description
capacity	integer (int32)	Kapacitet för den specifika SKU:n.
family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
name	string	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.
size	string	Storleken på den specifika SKU:n
tier	string	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för senaste ändring av resurs (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

UserIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
clientId	string (uuid)	Azure Active Directory-klient-id.
principalId	string (uuid)	Azure Active Directory principal id.

Dela via

Managed Instances - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Create managed instance with all properties

Exempelbegäran

Exempelsvar

Create managed instance with minimal properties

Exempelbegäran

Exempelsvar

Definitioner

AdministratorType

AuthMetadataLookupModes

AvailabilityZoneType

BackupStorageRedundancy

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

systemData

UserIdentity