Managed Instances - Create Or Update

Tjänst:

SQL Database

API-version:

2022-08-01-preview

Skapar eller uppdaterar en hanterad instans.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Resursplats.
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	Administratörens inloggningslösenord (krävs för att skapa en hanterad instans).
properties.administrators		ManagedInstanceExternalAdministrator	Azure Active Directory-administratören för instansen. Detta kan endast användas vid instansens skapandetid. Om det används för instansuppdatering ignoreras det eller så resulterar det i ett fel. För uppdateringar måste enskilda API:er användas.
properties.collation		string	Sortering av den hanterade instansen.
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.instancePoolId		string	ID:t för instanspoolen som den hanterade servern tillhör.
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.minimalTlsVersion		string	Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2"
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.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.storageSizeInGB		integer (int32)	Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 16384. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
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 behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tidszoner. Du kan hämta dessa registervärden via SQL Server genom att fråga 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: 8, 16, 24, 32, 40, 64, 80.
properties.zoneRedundant		boolean	Om multi-az är aktiverat eller inte.
sku		Sku	SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	ManagedInstance	Den hanterade instansen har uppdaterats.
201 Created	ManagedInstance	Den hanterade instansen har skapats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidDnsZone – Åtgärden misslyckades eftersom du försöker distribuera en hanterad instans som en geo-replikering sekundär till undernätet {0} där det redan finns en hanterad instans. Distribution av hanterad instans som en sekundär geo-replikering stöds endast i de fall då den hanterade instansen är den första instansen som distribueras i ett undernät. Överväg att distribuera en hanterad instans som en geo-replikering sekundär till ett annat undernät där det inte finns några befintliga hanterade instanser, eller om distribution till ett undernät med befintlig hanterad instans inaktiverar alternativet geo-replikering. 400 HkCannotSwitchToInactive – Databasen kan inte fortsätta med uppdatering på prisnivå eftersom den har minnesoptimerade objekt. Släpp sådana objekt och försök igen. 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed – Ogiltig lagringsstorlek: Gränsen för lagringsstorlek ({0} GB) är mindre än det aktuella lagringsutrymmet som används ({1} GB). Ange en högre lagringsstorleksgräns. 400 InstanceTimezoneUpdateNotSupported – Tidszonsuppdatering för instans stöds inte. 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported – Skapa hanterad instans med icke-standardtidszon stöds inte. 400 ManagedInstanceIpAddressRangeLimit – Det går inte att skapa/skala den hanterade instansen eftersom det inte finns tillräckligt med tillgängliga IP-adresser i undernätet för att utföra åtgärden. 400 VnetDelegationNotAllowed – Användaren försökte mata in Managed Server till undernätet som är delegerat. 400 SubnetHasResourcesOfDifferentType – Användaren försökte skapa MI i undernät som har resurser av olika typ. 400 UpdateManagedServerWithMaintenanceWindowNotAllowed – Uppdatering av hanterad instans med inställningar för underhållsperiod tillåts inte. 400 VnetPrepareNIPFailed – Användaren försökte förbereda undernät som har en konflikt med NetworkIntentPolicy. 400 InvalidUsername – Angivet användarnamn innehåller ogiltiga tecken. 400 ManagedInstanceDeprecatedHardwareFamily – Det går inte att ändra maskinvarugenereringen till inaktuell {0} generation. 400 ManagedInstanceBackupStorageTypeNotSupported – Parametern Säkerhetskopieringslagringstyp tillåts inte i instansuppdateringsåtgärden. 400 InvalidParameterValue – ett ogiltigt värde gavs till en parameter. 400 EmptyPDCInvalidDnsZone – Den här hanterade instansen kan inte distribueras eftersom dns-zonen inte matchar DNS-prefixet för det avsedda virtuella klustret för undernät {0}. Även om det här virtuella klustret är tomt kan dess DNS-prefix inte ändras. Tomma virtuella kluster tas bort automatiskt efter flera timmar. Överväg att vänta tills det här virtuella klustret upphör att gälla eller manuellt ta bort det här virtuella klustret och sedan skapa den hanterade instansen. 400 InstancePoolNotEnoughCapacity – en instanspool har inte tillräckligt med kapacitet 400 ServerNotFound – Den begärda servern hittades inte. 400 MissingIdentityId – Ingen användartilldelad identitet tillhandahålls när identitetstypen är inställd på UserAssigned 400 InvalidPrimaryIdentityId – Användaren tillhandahåller ett värde för PrimaryUserIdentityId men detsamma visas inte i parametern IdentityId Funktionen 400 ManagedInstanceZoneRedudantFeatureNotSupported – ZoneRedundant stöds inte för den valda tjänstnivån. Mer information finns i aka.ms/sqlmi-service-tier-characteristics. 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled – Det går inte att aktivera funktionen zoneRedundant när den hanterade instansen har skapats. Mer information finns i aka.ms/sqlmi-high-availability. 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled – Det går inte att inaktivera zoneRedundant-funktionen när den hanterade instansen har skapats. Mer information finns i aka.ms/sqlmi-high-availability. 400 TokenTooLong – den angivna token är för lång. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId som tillhandahålls 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId 400 SubnetIdCantBeUpdated – det går inte att ändra undernätet för hanterad instans. Ta bort den här parametern från begäran. 400 MigrationToAnotherVNetNotSupported – Det valda undernätet finns i ett annat virtuellt nätverk. Det går inte att flytta en hanterad instans till ett annat virtuellt nätverk. Ange undernät från Virtual Network {0}. 400 MigrationToSubnetWithDifferentDnsZoneNotSupported – Undernätet som tillhandahålls har en annan DNS-zon än den aktuella. Det går inte att ändra DNS-zonen för instanser. Ange ett undernät med samma DNS-zon, skapa ett nytt undernät eller ange ett tomt. 400 MigrationToGen4SubnetNotSupported – Det går inte att uppdatera undernätet när det körs på Gen4-maskinvara eftersom det är inaktuellt. Uppgradera maskinvaran från Gen4 till Gen5 som en del av den föränderliga undernätsåtgärden för hanterad instans genom att ange båda parametrarna samtidigt: målundernät och maskinvarugenerering. 400 PrimaryIdentityMissingPermissionForKeyId – KeyId tillhandahålls av användaren under skapande men PrimaryUserAssignedIdentityId anges inte i API-anropet 400 InvalidIdentityTypeForKeyId – KeyId tillhandahålls av användaren under skapande men identitetstypen är inte inställd på "UserAssigned" 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit – Åtgärden kunde inte slutföras eftersom vissa av databasfilerna överskrider den maximala filstorleksgränsen för generell användning på {0} GB. 400 CloudLifterUnsupportedFeature – Funktionen är inte tillgänglig på den hanterade instansen just nu. 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd 400 OperationCanNotStartDueToMiLink – åtgärden "{0}" kan inte slutföras eftersom det finns en databas som håller på att skapas via länken Hanterad instans. Vänta tills länken har skapats eller ta bort länken och försök igen. 400 ManagedInstanceSloUpdateFailed – SLO{0}åtgärden kan inte lyckas eftersom minnesanvändningen för{1}överskrider kvoten. 400 SourceAndTargetSubnetsMustBeVnetPeered – Undernätet som för närvarande används av den hanterade instansen och det tillhandahållna målundernätet är en del av de virtuella nätverk som inte är anslutna till peering för virtuella nätverk eller som har peering upprättad men som inte har tillåten trafik. För att kunna flytta den hanterade instansen från ett undernät till ett annat måste peering för virtuella nätverk upprättas från både det virtuella källnätverket och det virtuella målnätverket. Konfigurera krav för virtuella nätverk och försök sedan igen. Läs mer https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks. 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription – Undernätet som tillhandahålls för distribution av hanterad instans finns i en annan prenumeration än den som skickas för den hanterade instansen. Hanterad instans och undernät som används för att distribuera instansen måste finnas i samma prenumeration. Ange ett annat undernät eller växla till undernätsprenumerationen och försök sedan igen. 400 CreateManagedInstanceInvalidSubnetSize – Användaren försökte skapa en hanterad instans i ett undernät som är mindre än den tillåtna minimala undernätsstorleken. 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap – Undernätet som valts för migrering av hanterad instans har adressintervall som överlappar adressintervallet för undernät som innehåller geo-replikerad sekundär instans. Kontrollera att ditt undernät har konfigurerats enligt riktlinjerna i https://aka.ms/move-managed-instance. 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication – Undernätet som valts för migrering av hanterad instans har inte konfigurerats för att aktivera kommunikation med en geo-replikerad sekundär instans. Kontrollera om alla nödvändiga portar är öppna. Om du vill konfigurera undernätet korrekt läser du riktlinjerna i https://aka.ms/move-managed-instance. 400 ManagedInstanceLocalStorageUpdateSloDisabled – Uppdaterings-SLO för hanterade instanser med lokal lagring stöds inte ännu. 400 InvalidLoginName – det angivna inloggningsnamnet är ogiltigt. 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds. 400 PasswordTooShort – Det angivna lösenordet är för kort 400 PasswordTooLong – Det angivna lösenordet är för långt. 400 PasswordNotComplex – det angivna lösenordet är inte tillräckligt komplext. 400 GatewayInvalidEdition –{0}är inte en giltig databasversion i den här versionen av SQL Server. 400 InvalidSubnetResourceId – det angivna undernätsresurs-ID:t för den hanterade instansen är ogiltigt. 400 InstanceFailoverGroupDoesNotExist – redundansgruppen finns inte på en server. 400 InvalidLocation – en ogiltig plats har angetts. 400 VnetInWrongRegion – Det virtuella nätverket är i fel region. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 VnetAddressRangeError – Adressintervallet för virtuellt nätverk är ogiltigt. 400 VnetConfigIsNotAllowed – Konfiguration av virtuellt nätverk tillåts inte. 400 InvalidCollation – Ogiltig sortering. 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 ManagedInstanceClassicVnetNotSupported – Hanterad instans kan inte anslutas till ett klassiskt virtuellt nätverk. 400 AlterDbDeactivatedNotSupported – Databasåtgärden misslyckades för server{0}, databas{1}på grund av oväntad fördröjning. Försök igen. 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database-servrar. Detta kan ändras vid ett senare tillfälle. 400 VnetConfigHasNsg – Användaren försökte mata in managed server-undernätet med nätverkssäkerhetsgrupper. 400 VnetConfigHasNoUdr – Användaren försökte mata in managed server-undernätet utan standardtabellen för användardefinierad väg. 400 VnetConfigHasInvalidUdr – Användaren försökte mata in managed server-undernätet med en ogiltig användardefinierad routningstabell. 400 VnetConfigHasInvalidDns – Användaren försökte mata in managed server-undernätet med ogiltig anpassad DNS. 400 VnetConfigHasServiceEndpoints – Användaren försökte mata in managed server-undernät med tjänstslutpunkter. 400 VnetSubnetIsInUse – Användaren försökte mata in managed server-undernätet som inte är tomt. 400 VnetSubnetIsLocked – Användaren försökte mata in managed server-undernät som är i låst omfång. 400 VnetSubnetIsGateway – Användaren försökte mata in managed server-undernätet som är gatewayundernät. 400 VnetSubnetIsUnknown – Användaren försökte mata in managed server-undernät som inte finns. 400 VnetSubnetConflictWithIntendedPolicy – Användaren försökte mata in managed server-undernät som har en konflikt med IntendedPolicy. 400 NameAlreadyExists – Det angivna namnet finns redan. 400 ManagedInstanceInvalidEditionForSku – den angivna utgåvan {0} är inte konsekvent med den angivna SKU:n {1}. 400 ProvisioningDisabled – Visar felmeddelande från resursåtgärdsauktoriseraren som den är, utan ändringar 400 ManagedInstanceInvalidLicenseType – den angivna licenstypen {0} är ogiltig. 400 ManagedInstanceUpdateSloInProgress – "Åtgärden kunde inte slutföras eftersom en ändring på tjänstnivå pågår för den hanterade instansen{0}. Vänta tills åtgärden pågår och försök igen." 400 VnetResourceNotFound – Resursen hittades inte: "{0}". 400 InvalidTimezone – Ogiltig tidszon. 400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller DNS-anslutningsproblem. 400 InstanceCollationUpdateNotSupported – Användaren kan inte ändra instanssortering på hanterad instans. 400 CreateManagedInstanceWithNonDefaultCollationNotSupported – Användaren kan bara skapa en hanterad instans med sorteringen "SQL_Latin1_General_CP1_CI_AS". 400 ManagedInstanceOperationInProgress – Åtgärden kunde inte slutföras eftersom {0} åtgärden pågår. Vänta tills åtgärden pågår och försök igen. 400 ManagedInstanceExceedMaxAzureStorage – Åtgärden kunde inte slutföras eftersom den totala allokerade lagringsstorleken för Generell användning-instans skulle överskrida {0}. Minska antalet databasfiler och försök igen. 400 ManagedInstanceHasGeoReplica – Åtgärden kunde inte slutföras eftersom instansen har konfigurerat geo-replikerad sekundär instans. 400 InvalidManagedServerDnsZonePartner – resurs-URI:n för den geo-primära hanterade instans som anges i begäran om att skapa är ogiltig. Kontrollera att egenskapen har formatet /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/managedInstances/{managedInstanceName} 400 MiGeoRestoreWithWrongBackupStorageRedundancy – Geo-Restore tillåts inte för hanterade instanser med redundans för lagring av LRS/ZRS-säkerhetskopiering. 400 UpdatingInstanceAndBackupRedundancy – Redundans för instanszoner och redundans för säkerhetskopieringslagring kan inte uppdateras i samma begäran. 400 ProvisioningDisabled – Visar felmeddelande från resursåtgärdsauktoriseraren som den är, utan ändringar 400 AadOnlyAuthenticationIsEnabled – Endast Azure Active Directory-autentisering är aktiverat. Kontakta systemadministratören. 400 ManagementServiceFeatureDisabled – Användaren försökte använda en funktion som är inaktiverad. 400 MismatchingResourceGroupNameWithUrl – Det angivna resursgruppsnamnet matchade inte namnet i URL:en. 400 MismatchingSubscriptionWithUrl – Den angivna prenumerationen matchade inte prenumerationen i URL:en. 400 InvalidMinimalTlsVersion – Ogiltig minimal TLS-version. 400 InvalidResourceId – Ogiltig resursidentifierare. 400 InvalidParameterValue – ett ogiltigt värde gavs till en parameter. 400 InvalidMaintenanceWindowSettings – Ogiltiga inställningar för underhållsperiod. 400 InvalidMaintenanceWindowProperty – Egenskapen Ogiltig underhållsperiod angavs. 400 InvalidMaintenanceWindowPropertyNull – Ogiltigt underhållsperiod med nödvändiga egenskaper null. 400 InvalidMaintenanceWindowTypeWithPropertySpecified – Underhållsfönstertypen får inte ha vissa egenskaper angivna. 400 UpdateOfParameterNotSupported – uppdatering av "{0}" stöds inte. 400 AadOnlyAuthenticationIsEnabled – Endast Azure Active Directory-autentisering är aktiverat. Kontakta systemadministratören. 400 InvalidExternalAdministratorLogin – Ogiltigt eller saknade inloggningsnamn för extern administratör. 400 InvalidExternalAdministratorSid – Ogiltigt eller saknat objekt-ID för extern administratör. 400 InvalidExternalAdministratorTenantId – Ogiltigt eller saknat klient-ID för extern administratör. 400 ExternalAdministratorPrincipalType – Ogiltig eller saknad extern administratörshuvudnamnstyp. Välj från Användare, Program eller Grupp. 400 MissingExternalAdministratorWithAadOnlyAuth – Ange information om en extern administratör för att kunna använda Endast Azure AD-autentisering. 400 ExternalAdministratorLoginSameAsSqlAdmin – Namnen på Azure Active Directory-administratören och serveradministratörskontot måste vara olika. Ange olika värden. 400 SecurityAdalPrincipalCertExpiredError – Åtgärden kunde inte slutföras eftersom Azure Key Vault-huvudcertifikatet har upphört att gälla. 400 AkvHostNotResolvingFromNode – AKV-värden{0}kan inte matchas från SQL, på serverns{1}. 400 SecurityInvalidAzureKeyVaultRecoveryLevel – Den angivna Key Vault-URI:n är inte giltig. 400 KeyMaterialNotFoundOnRemoteServer – Fjärrservern har inte åtkomst till nyckelmaterial som används som TDE-skydd. 400 AzureKeyVaultRsaKeyNotSupported – Det angivna nyckelvalvet använder RSA-nyckelstorlek eller nyckeltyp som inte stöds. RSA-nyckelstorleken som stöds är 2048 eller 3072 och nyckeltypen är RSA eller RSA-HSM. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId som tillhandahålls 400 SameKeyUriNotFoundOnRemoteServer – Sekundär server har inte nyckelmaterialet från samma nyckelvalv som den primära serverns krypteringsskydd med automatisk rotation aktiverad. 400 SameKeyMaterialNotFoundOnRemoteServer – sekundär server har inte nyckelmaterialet för den primära serverns krypteringsskydd. 400 SecurityAzureKeyVaultGeoChainError – Det går inte att skapa sekundär sekundär (en process som kallas länkning) när transparent datakryptering aktiveras med hjälp av Azure Key Vault (BYOK). 400 PerDatabaseCMKDWNotSupported – CMK på databasnivå i förhandsversionen stöds inte för Datawarehouse Edition. 400 BlockSystemAssignedIdentityForCrossTenantCMK – CMK för flera klientorganisationer kan bara konfigureras när servern har konfigurerats med en användartilldelad hanterad identitet. Se https://aka.ms/sqltdebyokumi för att konfigurera användartilldelad hanterad identitet. 400 AzureKeyVaultKeyDisabled – Det gick inte att slutföra åtgärden på servern eftersom Azure Key Vault-nyckeln är inaktiverad. 400 PerDatabaseCMKRestoreNotSupported – Databasåterställning stöds inte när CMK på databasnivå konfigureras i förhandsversionen. 400 AzureKeyVaultInvalidExpirationDate – Det gick inte att slutföra åtgärden eftersom förfallodatumet för Azure Key Vault-nyckeln är ogiltigt. 400 PerDatabaseCMKHSNotSupported – CMK på databasnivå i förhandsversionen stöds inte för Hyperskala-utgåvan. 400 SecurityAzureKeyVaultUrlNullOrEmpty – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-URI:n är null eller tom. 400 CMKOperationNotAllowed – Användaren försökte utföra en åtgärd på servern när servern inte hade Åtkomst till Azure Key Vault. 400 AkvEndpointNotReachableFromNode – AKV-slutpunkten{0}kan inte nås från SQL, på serverns{1}. 400 AzureKeyVaultNoServerIdentity – serveridentiteten är inte korrekt konfigurerad. 400 AzureKeyVaultInvalidUri – ett ogiltigt svar från Azure Key Vault. Använd en giltig Azure Key Vault-URI. 400 AzureKeyVaultMissingPermissions – Servern saknar nödvändiga behörigheter i Azure Key Vault. 400 SecurityAzureKeyVaultInvalidKeyName – Åtgärden kunde inte slutföras på grund av ett ogiltigt servernyckelnamn. 400 AdalGenericError – Det gick inte att slutföra åtgärden eftersom ett Azure Active Directory-fel påträffades. 400 AdalServicePrincipalNotFound – Det gick inte att slutföra åtgärden eftersom ett azure Active Directory-bibliotekstjänsthuvudnamn inte hittades. 400 AzureKeyVaultMalformedVaultUri – Den angivna Key Vault-URI:n är inte giltig. 404 ManagedInstanceNotInSubscriptionResourceGroup – Angiven hanterad instans finns inte i den angivna resursgruppen och prenumerationen. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 404 SubscriptionNotFound – Det gick inte att hitta den begärda prenumerationen. 404 OperationIdNotFound – Åtgärden med ID finns inte. 404 ResourceDoesNotExist – Resurs med namnet{0}finns inte. Om du vill fortsätta anger du ett giltigt resursnamn. 404 InstancePoolNotFound – det går inte att hitta en instanspool 404 SubscriptionNotFound – Det gick inte att hitta den begärda prenumerationen. 404 ResourceNotFound – Den begärda resursen hittades inte. 405 InvalidVcoreValue – värdet för virtuell kärna {0} inte är giltigt. Ange ett giltigt värde för virtuell kärna. 405 InvalidHardwareGenerationValue – HardwareGeneration {0} är inte giltig. Ange ett giltigt HardwareGeneration-värde. 405 InvalidStorageSizeValue – "Ogiltig lagringsstorlek: {0} GB. Lagringsstorleken måste anges mellan {1} och {2} gigabyte, i steg om {3} GB. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 409 ConflictingServerOperation – En åtgärd pågår för närvarande för servern. 409 SubscriptionDisabled – Prenumerationen är inaktiverad. 409 ServerAlreadyExists – Duplicera servernamn. 409 ServerOverridePreconditionFailed – Det gick inte att tillämpa server åsidosättning på kategorin{0}eftersom den fysiska databasen eller instansen{1}på servern{2}för närvarande inte är i tillståndet Klar eller Inaktiverad. 409 ServerDisabled – Servern är inaktiverad. 409 ManagedInstanceIsBusy – servern "{0}" är upptagen för närvarande. Vänta några minuter innan du försöker igen. 409 ServerQuotaExceeded – Servern kan inte läggas till i en prenumeration eftersom den överskrider kvoten. 409 ConflictingManagedInstanceOperation – En åtgärd pågår för närvarande för den hanterade instansen. 409 BackupRedundancyUpdateAndInstanceRedundancyConflict – instansen är multi-az men lagringen för säkerhetskopiering uppdateras från zonredundant till icke-zonredundant. 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress – Det går inte att uppdatera instansredundans eftersom redundansuppdateringen för säkerhetskopieringslagring pågår. 409 InstanceRedundancyUpdateAndBackupRedundancyConflict – säkerhetskopieringslagringen är inte zonredundant, men instansredundans uppdateras till zonredundant. 409 BackupRedundancyUpdateConflict – Det går inte att uppdatera redundansen för lagring av säkerhetskopior eftersom en uppdatering av redundans för säkerhetskopieringslagring redan pågår. 409 MiDropFailedOnAuthLocks – Användaren försökte släppa den senaste hanterade instansen i undernätet som har Lås tillämpat på resurser. 409 MiCreateFailedNonDelegatedSubnet – Användaren försökte distribuera hanterad instans eller hanterad instanspool i undernät som inte har delegerats till Microsoft.Sql/managedInstances. 409 ServerKeyNameAlreadyExists – servernyckeln finns redan på servern. 409 ServerKeyUriAlreadyExists – Servernyckelns URI finns redan på servern. 409 ServerKeyDoesNotExists – servernyckeln finns inte. 409 AzureKeyVaultKeyNameNotFound – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-nyckelnamnet inte finns. 409 AzureKeyVaultKeyInUse – Nyckeln används för närvarande av servern. 412 InstanceNotReadyForBackupRedundancyUpdate – Det går inte att uppdatera redundans för säkerhetskopieringslagring eftersom instansen inte är klar. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 ConflictingSubscriptionOperation – En åtgärd pågår för närvarande för prenumerationen. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 429 ConflictingSubscriptionOperation – En åtgärd pågår för närvarande för prenumerationen. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen. 500 GatewayInternalServerError – Servern påträffade ett oväntat undantag. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 AzureKeyVaultConnectionFailed – Det gick inte att slutföra åtgärden på servern eftersom det inte gick att ansluta till Azure Key Vault 503 AzureKeyVaultGenericConnectionError – Det gick inte att slutföra åtgärden eftersom ett fel uppstod vid försök att hämta Key Vault-information . 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

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=2022-08-01-preview

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "timezoneId": "UTC",
    "instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "servicePrincipal": {
      "type": "SystemAssigned"
    }
  }
}

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python managed_instance_create_max.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="20D7082A-0FC7-4468-82BD-542694D5042B",
    )

    response = client.managed_instances.begin_create_or_update(
        resource_group_name="testrg",
        managed_instance_name="testinstance",
        parameters={
            "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",
                },
                "collation": "SQL_Latin1_General_CP1_CI_AS",
                "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
                "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",
                "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"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMax.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsql_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/sql/armsql/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/01e99457ccf5613a95d5b2960d31a12f84018863/specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMax.json
func ExampleManagedInstancesClient_BeginCreateOrUpdate_createManagedInstanceWithAllProperties() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsql.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewManagedInstancesClient().BeginCreateOrUpdate(ctx, "testrg", "testinstance", armsql.ManagedInstance{
		Location: to.Ptr("Japan East"),
		Tags: map[string]*string{
			"tagKey1": to.Ptr("TagValue1"),
		},
		Properties: &armsql.ManagedInstanceProperties{
			AdministratorLogin:         to.Ptr("dummylogin"),
			AdministratorLoginPassword: to.Ptr("PLACEHOLDER"),
			Administrators: &armsql.ManagedInstanceExternalAdministrator{
				AzureADOnlyAuthentication: to.Ptr(true),
				Login:                     to.Ptr("bob@contoso.com"),
				PrincipalType:             to.Ptr(armsql.PrincipalTypeUser),
				Sid:                       to.Ptr("00000011-1111-2222-2222-123456789111"),
				TenantID:                  to.Ptr("00000011-1111-2222-2222-123456789111"),
			},
			Collation:                        to.Ptr("SQL_Latin1_General_CP1_CI_AS"),
			DNSZonePartner:                   to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance"),
			InstancePoolID:                   to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1"),
			LicenseType:                      to.Ptr(armsql.ManagedInstanceLicenseTypeLicenseIncluded),
			MaintenanceConfigurationID:       to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"),
			MinimalTLSVersion:                to.Ptr("1.2"),
			ProxyOverride:                    to.Ptr(armsql.ManagedInstanceProxyOverrideRedirect),
			PublicDataEndpointEnabled:        to.Ptr(false),
			RequestedBackupStorageRedundancy: to.Ptr(armsql.BackupStorageRedundancyGeo),
			ServicePrincipal: &armsql.ServicePrincipal{
				Type: to.Ptr(armsql.ServicePrincipalTypeSystemAssigned),
			},
			StorageSizeInGB: to.Ptr[int32](1024),
			SubnetID:        to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
			TimezoneID:      to.Ptr("UTC"),
			VCores:          to.Ptr[int32](8),
		},
		SKU: &armsql.SKU{
			Name: to.Ptr("GP_Gen5"),
			Tier: to.Ptr("GeneralPurpose"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ManagedInstance = armsql.ManagedInstance{
	// 	Name: to.Ptr("testinstance"),
	// 	Type: to.Ptr("Microsoft.Sql/managedInstances"),
	// 	ID: to.Ptr("/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance"),
	// 	Location: to.Ptr("japaneast"),
	// 	Tags: map[string]*string{
	// 		"tagKey1": to.Ptr("TagValue1"),
	// 	},
	// 	Properties: &armsql.ManagedInstanceProperties{
	// 		AdministratorLogin: to.Ptr("dummylogin"),
	// 		Administrators: &armsql.ManagedInstanceExternalAdministrator{
	// 			AzureADOnlyAuthentication: to.Ptr(true),
	// 			Login: to.Ptr("bob@contoso.com"),
	// 			PrincipalType: to.Ptr(armsql.PrincipalTypeUser),
	// 			Sid: to.Ptr("00000011-1111-2222-2222-123456789111"),
	// 			TenantID: to.Ptr("00000011-1111-2222-2222-123456789111"),
	// 		},
	// 		Collation: to.Ptr("SQL_Latin1_General_CP1_CI_AS"),
	// 		CurrentBackupStorageRedundancy: to.Ptr(armsql.BackupStorageRedundancyGeo),
	// 		DNSZone: to.Ptr("1b4e2caff2530"),
	// 		FullyQualifiedDomainName: to.Ptr("testinstance.1b4e2caff2530.database.windows.net"),
	// 		InstancePoolID: to.Ptr("/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1"),
	// 		LicenseType: to.Ptr(armsql.ManagedInstanceLicenseTypeLicenseIncluded),
	// 		MaintenanceConfigurationID: to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"),
	// 		MinimalTLSVersion: to.Ptr("1.2"),
	// 		ProvisioningState: to.Ptr(armsql.ManagedInstancePropertiesProvisioningStateSucceeded),
	// 		ProxyOverride: to.Ptr(armsql.ManagedInstanceProxyOverrideRedirect),
	// 		PublicDataEndpointEnabled: to.Ptr(false),
	// 		RequestedBackupStorageRedundancy: to.Ptr(armsql.BackupStorageRedundancyGeo),
	// 		ServicePrincipal: &armsql.ServicePrincipal{
	// 			Type: to.Ptr(armsql.ServicePrincipalTypeSystemAssigned),
	// 			ClientID: to.Ptr("00000011-1111-2222-2222-123456789111"),
	// 			PrincipalID: to.Ptr("00000011-1111-2222-2222-123456789111"),
	// 			TenantID: to.Ptr("00000011-1111-2222-2222-123456789111"),
	// 		},
	// 		State: to.Ptr("Ready"),
	// 		StorageSizeInGB: to.Ptr[int32](1024),
	// 		SubnetID: to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
	// 		TimezoneID: to.Ptr("UTC"),
	// 		VCores: to.Ptr[int32](8),
	// 	},
	// 	SKU: &armsql.SKU{
	// 		Name: to.Ptr("GP_Gen5"),
	// 		Capacity: to.Ptr[int32](8),
	// 		Family: to.Ptr("Gen5"),
	// 		Tier: to.Ptr("GeneralPurpose"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SqlManagementClient } = require("@azure/arm-sql");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a managed instance.
 *
 * @summary Creates or updates a managed instance.
 * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMax.json
 */
async function createManagedInstanceWithAllProperties() {
  const subscriptionId =
    process.env["SQL_SUBSCRIPTION_ID"] || "20D7082A-0FC7-4468-82BD-542694D5042B";
  const resourceGroupName = process.env["SQL_RESOURCE_GROUP"] || "testrg";
  const managedInstanceName = "testinstance";
  const parameters = {
    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",
    },
    collation: "SQL_Latin1_General_CP1_CI_AS",
    dnsZonePartner:
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    instancePoolId:
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    licenseType: "LicenseIncluded",
    location: "Japan East",
    maintenanceConfigurationId:
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    minimalTlsVersion: "1.2",
    proxyOverride: "Redirect",
    publicDataEndpointEnabled: false,
    requestedBackupStorageRedundancy: "Geo",
    servicePrincipal: { type: "SystemAssigned" },
    sku: { name: "GP_Gen5", tier: "GeneralPurpose" },
    storageSizeInGB: 1024,
    subnetId:
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    tags: { tagKey1: "TagValue1" },
    timezoneId: "UTC",
    vCores: 8,
  };
  const credential = new DefaultAzureCredential();
  const client = new SqlManagementClient(credential, subscriptionId);
  const result = await client.managedInstances.beginCreateOrUpdateAndWait(
    resourceGroupName,
    managedInstanceName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMax.json
// this example is just showing the usage of "ManagedInstances_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "20D7082A-0FC7-4468-82BD-542694D5042B";
string resourceGroupName = "testrg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ManagedInstanceResource
ManagedInstanceCollection collection = resourceGroupResource.GetManagedInstances();

// invoke the operation
string managedInstanceName = "testinstance";
ManagedInstanceData data = new ManagedInstanceData(new AzureLocation("Japan East"))
{
    Sku = new SqlSku("GP_Gen5")
    {
        Tier = "GeneralPurpose",
    },
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "PLACEHOLDER",
    SubnetId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
    LicenseType = ManagedInstanceLicenseType.LicenseIncluded,
    VCores = 8,
    StorageSizeInGB = 1024,
    Collation = "SQL_Latin1_General_CP1_CI_AS",
    ManagedDnsZonePartner = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance"),
    IsPublicDataEndpointEnabled = false,
    ProxyOverride = ManagedInstanceProxyOverride.Redirect,
    TimezoneId = "UTC",
    InstancePoolId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1"),
    MaintenanceConfigurationId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1"),
    MinimalTlsVersion = "1.2",
    RequestedBackupStorageRedundancy = SqlBackupStorageRedundancy.Geo,
    Administrators = new ManagedInstanceExternalAdministrator
    {
        PrincipalType = SqlServerPrincipalType.User,
        Login = "bob@contoso.com",
        Sid = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        TenantId = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        IsAzureADOnlyAuthenticationEnabled = true,
    },
    ServicePrincipal = new SqlServicePrincipal
    {
        PrincipalType = SqlServicePrincipalType.SystemAssigned,
    },
    Tags =
    {
    ["tagKey1"] = "TagValue1"
    },
};
ArmOperation<ManagedInstanceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, managedInstanceName, data);
ManagedInstanceResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedInstanceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exempelsvar

Statuskod:

200

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "timezoneId": "UTC",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Statuskod:

201

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "timezoneId": "UTC",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

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=2022-08-01-preview

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded"
  },
  "location": "Japan East"
}

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python managed_instance_create_min.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="20D7082A-0FC7-4468-82BD-542694D5042B",
    )

    response = client.managed_instances.begin_create_or_update(
        resource_group_name="testrg",
        managed_instance_name="testinstance",
        parameters={
            "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_Gen4", "tier": "GeneralPurpose"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMin.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsql_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/sql/armsql/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/01e99457ccf5613a95d5b2960d31a12f84018863/specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMin.json
func ExampleManagedInstancesClient_BeginCreateOrUpdate_createManagedInstanceWithMinimalProperties() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsql.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewManagedInstancesClient().BeginCreateOrUpdate(ctx, "testrg", "testinstance", armsql.ManagedInstance{
		Location: to.Ptr("Japan East"),
		Properties: &armsql.ManagedInstanceProperties{
			AdministratorLogin:         to.Ptr("dummylogin"),
			AdministratorLoginPassword: to.Ptr("PLACEHOLDER"),
			LicenseType:                to.Ptr(armsql.ManagedInstanceLicenseTypeLicenseIncluded),
			StorageSizeInGB:            to.Ptr[int32](1024),
			SubnetID:                   to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
			VCores:                     to.Ptr[int32](8),
		},
		SKU: &armsql.SKU{
			Name: to.Ptr("GP_Gen4"),
			Tier: to.Ptr("GeneralPurpose"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ManagedInstance = armsql.ManagedInstance{
	// 	Name: to.Ptr("testinstance"),
	// 	Type: to.Ptr("Microsoft.Sql/managedInstances"),
	// 	ID: to.Ptr("/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance"),
	// 	Location: to.Ptr("japaneast"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armsql.ManagedInstanceProperties{
	// 		AdministratorLogin: to.Ptr("dummylogin"),
	// 		Collation: to.Ptr("SQL_Latin1_General_CP1_CI_AS"),
	// 		CurrentBackupStorageRedundancy: to.Ptr(armsql.BackupStorageRedundancyGeo),
	// 		DNSZone: to.Ptr("1b4e2caff2530"),
	// 		FullyQualifiedDomainName: to.Ptr("testinstance.1b4e2caff2530.database.windows.net"),
	// 		LicenseType: to.Ptr(armsql.ManagedInstanceLicenseTypeLicenseIncluded),
	// 		ProvisioningState: to.Ptr(armsql.ManagedInstancePropertiesProvisioningStateSucceeded),
	// 		ProxyOverride: to.Ptr(armsql.ManagedInstanceProxyOverrideRedirect),
	// 		PublicDataEndpointEnabled: to.Ptr(false),
	// 		RequestedBackupStorageRedundancy: to.Ptr(armsql.BackupStorageRedundancyGeo),
	// 		State: to.Ptr("Ready"),
	// 		StorageSizeInGB: to.Ptr[int32](1024),
	// 		SubnetID: to.Ptr("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
	// 		VCores: to.Ptr[int32](8),
	// 	},
	// 	SKU: &armsql.SKU{
	// 		Name: to.Ptr("GP_Gen4"),
	// 		Capacity: to.Ptr[int32](8),
	// 		Family: to.Ptr("Gen4"),
	// 		Tier: to.Ptr("GeneralPurpose"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SqlManagementClient } = require("@azure/arm-sql");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a managed instance.
 *
 * @summary Creates or updates a managed instance.
 * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMin.json
 */
async function createManagedInstanceWithMinimalProperties() {
  const subscriptionId =
    process.env["SQL_SUBSCRIPTION_ID"] || "20D7082A-0FC7-4468-82BD-542694D5042B";
  const resourceGroupName = process.env["SQL_RESOURCE_GROUP"] || "testrg";
  const managedInstanceName = "testinstance";
  const parameters = {
    administratorLogin: "dummylogin",
    administratorLoginPassword: "PLACEHOLDER",
    licenseType: "LicenseIncluded",
    location: "Japan East",
    sku: { name: "GP_Gen4", tier: "GeneralPurpose" },
    storageSizeInGB: 1024,
    subnetId:
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    vCores: 8,
  };
  const credential = new DefaultAzureCredential();
  const client = new SqlManagementClient(credential, subscriptionId);
  const result = await client.managedInstances.beginCreateOrUpdateAndWait(
    resourceGroupName,
    managedInstanceName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/preview/2022-08-01-preview/examples/ManagedInstanceCreateMin.json
// this example is just showing the usage of "ManagedInstances_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "20D7082A-0FC7-4468-82BD-542694D5042B";
string resourceGroupName = "testrg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ManagedInstanceResource
ManagedInstanceCollection collection = resourceGroupResource.GetManagedInstances();

// invoke the operation
string managedInstanceName = "testinstance";
ManagedInstanceData data = new ManagedInstanceData(new AzureLocation("Japan East"))
{
    Sku = new SqlSku("GP_Gen4")
    {
        Tier = "GeneralPurpose",
    },
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "PLACEHOLDER",
    SubnetId = new ResourceIdentifier("/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
    LicenseType = ManagedInstanceLicenseType.LicenseIncluded,
    VCores = 8,
    StorageSizeInGB = 1024,
};
ArmOperation<ManagedInstanceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, managedInstanceName, data);
ManagedInstanceResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedInstanceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exempelsvar

Statuskod:

200

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "dnsZone": "1b4e2caff2530",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo"
  },
  "location": "japaneast",
  "tags": {},
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Statuskod:

201

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "dnsZone": "1b4e2caff2530",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo"
  },
  "location": "japaneast",
  "tags": {},
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Statuskod:

202

Definitioner

Name	Description
AdministratorType	Typ av administratör för serverservern.
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)
IdentityType	Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.
ManagedInstance	En hanterad Azure SQL-instans.
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.
PrincipalType	Huvudtyp för sever-administratören.
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.
UserIdentity	Azure Active Directory-identitetskonfiguration för en resurs.

AdministratorType

Uppräkning

Typ av administratör för serverservern.

Värde	Description
ActiveDirectory

BackupStorageRedundancy

Uppräkning

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)

Värde	Description
Geo
GeoZone
Local
Zone

IdentityType

Uppräkning

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

Värde	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Objekt

En hanterad Azure SQL-instans.

Name	Typ	Description
id	string	Resurs-ID.
identity	ResourceIdentity	Azure Active Directory-identiteten för den hanterade instansen.
location	string	Resursplats.
name	string	Resursnamn.
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	Administratörens inloggningslösenord (krävs för att skapa en hanterad instans).
properties.administrators	ManagedInstanceExternalAdministrator	Azure Active Directory-administratören för instansen. Detta kan endast användas vid instansens skapandetid. Om det används för instansuppdatering ignoreras det eller så resulterar det i ett fel. För uppdateringar måste enskilda API:er användas.
properties.collation	string	Sortering av den hanterade instansen.
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.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.fullyQualifiedDomainName	string	Det fullständigt kvalificerade domännamnet för den hanterade instansen.
properties.instancePoolId	string	ID:t för instanspoolen som den hanterade servern tillhör.
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.minimalTlsVersion	string	Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2"
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	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
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.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.storageSizeInGB	integer (int32)	Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 16384. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
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 behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tidszoner. Du kan hämta dessa registervärden via SQL Server genom att fråga 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: 8, 16, 24, 32, 40, 64, 80.
properties.zoneRedundant	boolean	Om multi-az är aktiverat eller inte.
sku	Sku	SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Resurstaggar.
type	string	Resurstyp.

ManagedInstanceExternalAdministrator

Objekt

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

Name	Typ	Description
administratorType	AdministratorType	Typ av administratör för serverservern.
azureADOnlyAuthentication	boolean	Endast Azure Active Directory-autentisering aktiverat.
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
BasePrice
LicenseIncluded

ManagedInstancePecProperty

Objekt

En privat slutpunktsanslutning under en hanterad instans

Name	Typ	Description
id	string	Resurs-ID.
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
Default
Proxy
Redirect

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
PointInTimeRestore

PrincipalType

Uppräkning

Huvudtyp för sever-administratören.

Värde	Description
Application
Group
User

ResourceIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
principalId	string (uuid)	Huvud-ID:t för Azure Active Directory.
tenantId	string (uuid)	Klient-ID:t för Azure Active Directory.
type	IdentityType	Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn 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	Klient-ID:t för Azure Active Directory-programmet.
principalId	string	Objekt-ID för Azure Active Directory-program.
tenantId	string	Klient-ID:t för Azure Active Directory.
type	ServicePrincipalType	Tjänstens huvudnamnstyp.

ServicePrincipalType

Uppräkning

Tjänstens huvudnamnstyp.

Värde	Description
None
SystemAssigned

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.

UserIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
clientId	string (uuid)	Azure Active Directory-klient-ID: t.
principalId	string (uuid)	Huvud-ID:t för Azure Active Directory.