Delen via


Managed Instances - Create Or Update

Hiermee maakt of werkt u een beheerd exemplaar bij.

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

URI-parameters

Name In Vereist Type Description
managedInstanceName
path True

string

De naam van het beheerde exemplaar.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
location True

string

De geografische locatie waar de resource zich bevindt

identity

ResourceIdentity

De Azure Active Directory-identiteit van de beheerde instantie.

properties.administratorLogin

string

Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en vereist is voor het maken).

properties.administratorLoginPassword

string (password)

Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van een beheerd exemplaar).

properties.administrators

ManagedInstanceExternalAdministrator

De Azure Active Directory-beheerder kan worden gebruikt tijdens het aanmaken van een instantie en voor updates van instanties, behalve voor de eigenschap azureADOnlyAuthentication. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API worden gebruikt.

properties.authenticationMetadata

AuthMetadataLookupModes

De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar.

properties.collation

string

Sortering van het beheerde exemplaar.

properties.databaseFormat

ManagedInstanceDatabaseFormat

Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine.

properties.dnsZonePartner

string (arm-id)

De resource-id van een ander beheerd exemplaar waarvan de DNS-zone dit beheerde exemplaar deelt na het maken.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr).

properties.instancePoolId

string

De id van de exemplaargroep waartoe deze beheerde server behoort.

properties.isGeneralPurposeV2

boolean

Of dit nu een GPv2-variant van de editie Algemeen gebruik is.

properties.keyId

string

Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.

properties.licenseType

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

properties.maintenanceConfigurationId

string

Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaard: het maken van een normaal exemplaar.

Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

properties.memorySizeInGB

integer (int32)

Geheugengrootte in GB. Minimale waarde: 28. Maximale waarde: 870. De minimum- en maximumwaarde zijn afhankelijk van het aantal vCores en de servicelaag. Lees meer over resourcelimieten: https://aka.ms/mi-resource-limits-api.

properties.minimalTlsVersion

string

Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2'

properties.pricingModel

PricingModel

Prijsmodel van Managed Instance.

properties.primaryUserAssignedIdentityId

string (arm-id)

De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.

properties.proxyOverride

ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

properties.publicDataEndpointEnabled

boolean

Of het openbare gegevenseindpunt al dan niet is ingeschakeld.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Lokaal (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

Specificeert de logische beschikbaarheidszone waaraan Managed Instance is vastgezet.

properties.restorePointInTime

string (date-time)

Hiermee geeft u het tijdstip (ISO8601-indeling) van de brondatabase op die wordt hersteld om de nieuwe database te maken.

properties.servicePrincipal

ServicePrincipal

De service-principal van het beheerde exemplaar.

properties.sourceManagedInstanceId

string (arm-id)

De resource-id van het bronbeheerexemplaar dat is gekoppeld aan het maken van de bewerking van dit exemplaar.

properties.storageIOps

integer (int32)

Opslag IOps. Minimumwaarde: 300. Maximumwaarde: 80000. Verhogingen van 1 IOps zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores.

properties.storageSizeInGB

integer (int32)

Opslaggrootte in GB. Minimumwaarde: 32. Maximale waarde: 32768. Verhogingen van 32 GB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores.

properties.storageThroughputMBps

integer (int32)

De MBps-parameter voor opslagdoorvoer wordt niet ondersteund in de bewerking voor het maken/bijwerken van exemplaren.

properties.subnetId

string (arm-id)

Subnetresource-id voor het beheerde exemplaar.

properties.timezoneId

string

Id van de tijdzone. Toegestane waarden zijn tijdzones die door Windows worden ondersteund. Windows bewaart details over ondersteunde tijdzones, inclusief het id, in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Je kunt die registerwaarden via SQL Server krijgen door SELECT naam AS timezone_id FROM sys.time_zone_info te zoeken. Lijst met id's kan ook worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Een voorbeeld van een geldige tijdzone-id is Pacific Standard Time of W. Europa Standaardtijd".

properties.vCores

integer (int32)

Het aantal vCores. Toegestane waarden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Ondersteunde vCores is afhankelijk van de geselecteerde hardwarefamilie en servicelaag.

properties.zoneRedundant

boolean

Of de zone-redundantie al dan niet is ingeschakeld.

sku

Sku

Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5 (General Purpose, Standard-serie); GP_G8IM (Algemeen gebruik, Premium-serie); GP_G8IH (voor algemeen gebruik, geoptimaliseerd voor geheugen uit de Premium-serie); BC_Gen5 (Bedrijfskritisch, Standard-Series); BC_G8IM (Bedrijfskritisch, Premium-serie); BC_G8IH (bedrijfskritisch, geoptimaliseerd voor geheugen uit de Premium-serie).

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

ManagedInstance

Resource 'ManagedInstance' updateoperatie is geslaagd

201 Created

ManagedInstance

Resource 'ManagedInstance' aanmaakoperatie is geslaagd

Kopteksten

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

Resourcebewerking geaccepteerd.

Kopteksten

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

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create managed instance with all properties
Create managed instance with minimal properties

Create managed instance with all properties

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Create managed instance with minimal properties

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
AdministratorType

Type van de serverbeheerder.

AuthMetadataLookupModes

De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar.

AvailabilityZoneType

Hiermee geeft u de beschikbaarheidszone op waaraan de database is vastgemaakt.

BackupStorageRedundancy

Het type opslagaccount dat wordt gebruikt voor het opslaan van back-ups voor deze database.

createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

ExternalGovernanceStatus

Status van extern beheer.

HybridSecondaryUsage

Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr).

HybridSecondaryUsageDetected

Hybride secundair gebruik gedetecteerd. Mogelijke waarden zijn Actief (de klant voldoet niet aan de vereisten voor het gebruik van de secundaire als passieve DR) en 'Passief' (klant voldoet aan de vereisten voor het gebruik van de secundaire als passieve DR).

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen.

ManagedInstance

Een Azure SQL managed instance.

ManagedInstanceDatabaseFormat

Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine.

ManagedInstanceExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

ManagedInstancePecProperty

Een privé-eindpuntverbinding onder een beheerd exemplaar

ManagedInstancePrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaard: het maken van een normaal exemplaar.

Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

PricingModel

Prijsmodel van Managed Instance.

PrincipalType

Principal-type van de serverbeheerder.

ProvisioningState

De ARM-inrichtingsstatus van de taakuitvoering.

ResourceIdentity

Azure Active Directory identiteitsconfiguratie voor een resource.

ServicePrincipal

De configuratie van de service-principal van het beheerde exemplaar voor een resource.

ServicePrincipalType

Type service-principal.

Sku

Een ARM-resource-SKU.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

UserIdentity

Azure Active Directory identiteitsconfiguratie voor een resource.

AdministratorType

Type van de serverbeheerder.

Waarde Description
ActiveDirectory

Active Directory

AuthMetadataLookupModes

De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar.

Waarde Description
AzureAD

AzureAD

Paired

Gekoppeld

Windows

Windows

AvailabilityZoneType

Hiermee geeft u de beschikbaarheidszone op waaraan de database is vastgemaakt.

Waarde Description
NoPreference

NoPreference

1

1

2

2

3

3

BackupStorageRedundancy

Het type opslagaccount dat wordt gebruikt voor het opslaan van back-ups voor deze database.

Waarde Description
Geo

Geografie

Local

Lokaal

Zone

Gebied

GeoZone

GeoZone

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoelwit.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ExternalGovernanceStatus

Status van extern beheer.

Waarde Description
Enabled

Ingeschakeld

Disabled

Disabled

HybridSecondaryUsage

Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr).

Waarde Description
Active

Actief

Passive

Passive

HybridSecondaryUsageDetected

Hybride secundair gebruik gedetecteerd. Mogelijke waarden zijn Actief (de klant voldoet niet aan de vereisten voor het gebruik van de secundaire als passieve DR) en 'Passief' (klant voldoet aan de vereisten voor het gebruik van de secundaire als passieve DR).

Waarde Description
Active

Actief

Passive

Passive

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen.

Waarde Description
None

Geen

SystemAssigned

SysteemToegewezen

UserAssigned

UserAssigned

SystemAssigned,UserAssigned

SysteemToegewezen, GebruikerToegewezen

ManagedInstance

Een Azure SQL managed instance.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"

identity

ResourceIdentity

De Azure Active Directory-identiteit van de beheerde instantie.

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.administratorLogin

string

Gebruikersnaam van beheerder voor het beheerde exemplaar. Kan alleen worden opgegeven wanneer het beheerde exemplaar wordt gemaakt (en vereist is voor het maken).

properties.administratorLoginPassword

string (password)

Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van een beheerd exemplaar).

properties.administrators

ManagedInstanceExternalAdministrator

De Azure Active Directory-beheerder kan worden gebruikt tijdens het aanmaken van een instantie en voor updates van instanties, behalve voor de eigenschap azureADOnlyAuthentication. Als u de eigenschap azureADOnlyAuthentication wilt bijwerken, moet een afzonderlijke API worden gebruikt.

properties.authenticationMetadata

AuthMetadataLookupModes

De zoekmodus voor verificatiemetagegevens van het beheerde exemplaar.

properties.collation

string

Sortering van het beheerde exemplaar.

properties.createTime

string (date-time)

Specificeert het tijdstip (ISO8601 formaat) van de Managed Instance creatie.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Het type opslagaccount dat wordt gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Lokaal (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

properties.databaseFormat

ManagedInstanceDatabaseFormat

Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine.

properties.dnsZone

string

De DNS-zone waarin het beheerde exemplaar zich bevindt.

properties.dnsZonePartner

string (arm-id)

De resource-id van een ander beheerd exemplaar waarvan de DNS-zone dit beheerde exemplaar deelt na het maken.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Status van extern beheer.

properties.fullyQualifiedDomainName

string

De volledig gekwalificeerde domeinnaam van het beheerde exemplaar.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Hybride secundair gebruik. Mogelijke waarden zijn 'Actief' (standaardwaarde) en 'Passief' (klant gebruikt de secundaire als passieve dr).

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

Hybride secundair gebruik gedetecteerd. Mogelijke waarden zijn Actief (de klant voldoet niet aan de vereisten voor het gebruik van de secundaire als passieve DR) en 'Passief' (klant voldoet aan de vereisten voor het gebruik van de secundaire als passieve DR).

properties.instancePoolId

string

De id van de exemplaargroep waartoe deze beheerde server behoort.

properties.isGeneralPurposeV2

boolean

Of dit nu een GPv2-variant van de editie Algemeen gebruik is.

properties.keyId

string

Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.

properties.licenseType

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

properties.maintenanceConfigurationId

string

Hiermee geeft u de onderhoudsconfiguratie-id op die moet worden toegepast op dit beheerde exemplaar.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaard: het maken van een normaal exemplaar.

Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

properties.memorySizeInGB

integer (int32)

Geheugengrootte in GB. Minimale waarde: 28. Maximale waarde: 870. De minimum- en maximumwaarde zijn afhankelijk van het aantal vCores en de servicelaag. Lees meer over resourcelimieten: https://aka.ms/mi-resource-limits-api.

properties.minimalTlsVersion

string

Minimale TLS-versie. Toegestane waarden: 'None', '1.0', '1.1', '1.2'

properties.pricingModel

PricingModel

Prijsmodel van Managed Instance.

properties.primaryUserAssignedIdentityId

string (arm-id)

De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Lijst met privé-eindpuntverbindingen op een beheerd exemplaar.

properties.provisioningState

ProvisioningState

Inrichtingsstatus van beheerd exemplaar.

properties.proxyOverride

ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

properties.publicDataEndpointEnabled

boolean

Of het openbare gegevenseindpunt al dan niet is ingeschakeld.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor dit exemplaar. De opties zijn Lokaal (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) en GeoZone(GeoZoneRedundantStorage)

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

Specificeert de logische beschikbaarheidszone waaraan Managed Instance is vastgezet.

properties.restorePointInTime

string (date-time)

Hiermee geeft u het tijdstip (ISO8601-indeling) van de brondatabase op die wordt hersteld om de nieuwe database te maken.

properties.servicePrincipal

ServicePrincipal

De service-principal van het beheerde exemplaar.

properties.sourceManagedInstanceId

string (arm-id)

De resource-id van het bronbeheerexemplaar dat is gekoppeld aan het maken van de bewerking van dit exemplaar.

properties.state

string

De status van het beheerde exemplaar.

properties.storageIOps

integer (int32)

Opslag IOps. Minimumwaarde: 300. Maximumwaarde: 80000. Verhogingen van 1 IOps zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores.

properties.storageSizeInGB

integer (int32)

Opslaggrootte in GB. Minimumwaarde: 32. Maximale waarde: 32768. Verhogingen van 32 GB zijn alleen toegestaan. De maximumwaarde is afhankelijk van de geselecteerde hardwarefamilie en het aantal vCores.

properties.storageThroughputMBps

integer (int32)

De MBps-parameter voor opslagdoorvoer wordt niet ondersteund in de bewerking voor het maken/bijwerken van exemplaren.

properties.subnetId

string (arm-id)

Subnetresource-id voor het beheerde exemplaar.

properties.timezoneId

string

Id van de tijdzone. Toegestane waarden zijn tijdzones die door Windows worden ondersteund. Windows bewaart details over ondersteunde tijdzones, inclusief het id, in het register onder KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Je kunt die registerwaarden via SQL Server krijgen door SELECT naam AS timezone_id FROM sys.time_zone_info te zoeken. Lijst met id's kan ook worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Een voorbeeld van een geldige tijdzone-id is Pacific Standard Time of W. Europa Standaardtijd".

properties.vCores

integer (int32)

Het aantal vCores. Toegestane waarden: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Ondersteunde vCores is afhankelijk van de geselecteerde hardwarefamilie en servicelaag.

properties.virtualClusterId

string

Virtuele cluster resource id voor de Managed Instance.

properties.zoneRedundant

boolean

Of de zone-redundantie al dan niet is ingeschakeld.

sku

Sku

Beheerde exemplaar-SKU. Toegestane waarden voor sku.name: GP_Gen5 (General Purpose, Standard-serie); GP_G8IM (Algemeen gebruik, Premium-serie); GP_G8IH (voor algemeen gebruik, geoptimaliseerd voor geheugen uit de Premium-serie); BC_Gen5 (Bedrijfskritisch, Standard-Series); BC_G8IM (Bedrijfskritisch, Premium-serie); BC_G8IH (bedrijfskritisch, geoptimaliseerd voor geheugen uit de Premium-serie).

systemData

systemData

Azure Resource Manager metadata met creationBy en modifiedBy informatie.

tags

object

Resourcetags.

type

string

Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts"

ManagedInstanceDatabaseFormat

Hiermee geeft u de interne indeling van exemplaardatabases op die specifiek zijn voor de versie van de SQL-engine.

Waarde Description
AlwaysUpToDate

AlwaysUpToDate

SQLServer2022

SQLServer2022

SQLServer2025

SQLServer2025

ManagedInstanceExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

Name Type Description
administratorType

AdministratorType

Type van de serverbeheerder.

azureADOnlyAuthentication

boolean

Azure Active Directory alleen authenticatie ingeschakeld.

login

string

Aanmeldingsnaam van de serverbeheerder.

principalType

PrincipalType

Principal-type van de serverbeheerder.

sid

string (uuid)

SID (object-id) van de serverbeheerder.

tenantId

string (uuid)

Tenant-id van de beheerder.

ManagedInstanceLicenseType

Het licentietype. Mogelijke waarden zijn LicenseIncluded (reguliere prijs inclusief een nieuwe SQL-licentie) en BasePrice (korting op AHB-prijs voor het meenemen van uw eigen SQL-licenties).

Waarde Description
LicenseIncluded

LicentieInbegrepen

BasePrice

BasePrice

ManagedInstancePecProperty

Een privé-eindpuntverbinding onder een beheerd exemplaar

Name Type Description
id

string

Resource-ID.

properties

ManagedInstancePrivateEndpointConnectionProperties

Eigenschappen van privé-eindpuntverbinding

ManagedInstancePrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

Name Type Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Privé-eindpunt waartoe de verbinding behoort.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Verbindingsstatus van de privé-eindpuntverbinding.

provisioningState

string

Status van de privé-eindpuntverbinding.

ManagedInstancePrivateEndpointProperty

Name Type Description
id

string

Resource-id van het privé-eindpunt.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

string

De beschrijving van de private link-serviceverbinding.

description

string

De beschrijving van de private link-serviceverbinding.

status

string

De verbindingsstatus van de Private Link-service.

ManagedInstanceProxyOverride

Verbindingstype dat wordt gebruikt om verbinding te maken met het exemplaar.

Waarde Description
Proxy

Proxy

Redirect

Doorverwijzen

Default

Verstek

ManagedServerCreateMode

Hiermee geeft u de modus voor het maken van de database op.

Standaard: het maken van een normaal exemplaar.

Herstellen: Hiermee maakt u een exemplaar door een set back-ups te herstellen naar een bepaald tijdstip. RestorePointInTime en SourceManagedInstanceId moeten worden opgegeven.

Waarde Description
Default

Verstek

PointInTimeRestore

PointInTimeRestore

PricingModel

Prijsmodel van Managed Instance.

Waarde Description
Regular

Normaal

Freemium

Freemium

PrincipalType

Principal-type van de serverbeheerder.

Waarde Description
User

Gebruiker

Group

Groep

Application

Application

ProvisioningState

De ARM-inrichtingsstatus van de taakuitvoering.

Waarde Description
Created

Gecreëerd

InProgress

In uitvoering

Succeeded

Geslaagd

Failed

Mislukt

Canceled

Geannuleerd

ResourceIdentity

Azure Active Directory identiteitsconfiguratie voor een resource.

Name Type Description
principalId

string (uuid)

De principal id van Azure Active Directory.

tenantId

string (uuid)

De Azure Active Directory tenant id.

type

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource aan te maken en toe te wijzen.

userAssignedIdentities

<string,  UserIdentity>

De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt

ServicePrincipal

De configuratie van de service-principal van het beheerde exemplaar voor een resource.

Name Type Description
clientId

string

De Azure Active Directory application client id.

principalId

string

De Azure Active Directory application object id.

tenantId

string

De Azure Active Directory tenant id.

type

ServicePrincipalType

Type service-principal.

ServicePrincipalType

Type service-principal.

Waarde Description
None

Geen

SystemAssigned

SysteemToegewezen

Sku

Een ARM-resource-SKU.

Name Type Description
capacity

integer (int32)

Capaciteit van de specifieke SKU.

family

string

Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan die hier worden vastgelegd.

name

string

De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3.

size

string

Grootte van de specifieke SKU

tier

string

De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserIdentity

Azure Active Directory identiteitsconfiguratie voor een resource.

Name Type Description
clientId

string (uuid)

De Azure Active Directory client id.

principalId

string (uuid)

De principal id van Azure Active Directory.