Managed Instances - Create Or Update

Szolgáltatás:

SQL Database

API-verzió:

2025-01-01

Felügyelt példányt hoz létre vagy frissít.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
managedInstanceName	path	True	string	A felügyelt példány neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Az a földrajzi hely, ahol az erőforrás él
identity		ResourceIdentity	A kezelt példány Azure Active Directory identitása.
properties.administratorLogin		string	A felügyelt példány rendszergazdai felhasználóneve. Csak a felügyelt példány létrehozásakor adható meg (és a létrehozáshoz szükséges).
properties.administratorLoginPassword		string (password)	A rendszergazda bejelentkezési jelszava (a felügyelt példány létrehozásához szükséges).
properties.administrators		ManagedInstanceExternalAdministrator	Az Azure Active Directory adír használható instance-készítés és instanzfrissítések során, kivéve az azureADOnlyAuthentication tulajdonságot. A tulajdonság azureADOnlyAuthentication frissítéséhez egyedi API-t kell használni.
properties.authenticationMetadata		AuthMetadataLookupModes	A felügyelt példány hitelesítési metaadatainak keresési módja.
properties.collation		string	A felügyelt példány rendezése.
properties.databaseFormat		ManagedInstanceDatabaseFormat	Az SQL-motor verziójára jellemző példányadatbázisok belső formátumát adja meg.
properties.dnsZonePartner		string (arm-id)	Egy másik felügyelt példány erőforrás-azonosítója, amelynek DNS-zónáját ez a felügyelt példány a létrehozás után megosztja.
properties.hybridSecondaryUsage		HybridSecondaryUsage	Hibrid másodlagos használat. Lehetséges értékek az "Aktív" (alapértelmezett érték) és a "Passzív" (az ügyfél a másodlagost passzív DR-ként használja).
properties.instancePoolId		string	Annak a példánykészletnek az azonosítója, amelyhez a felügyelt kiszolgáló tartozik.
properties.isGeneralPurposeV2		boolean	Függetlenül attól, hogy ez az Általános célú kiadás GPv2-változata-e.
properties.keyId		string	A titkosításhoz használandó kulcs CMK URI-ja.
properties.licenseType		ManagedInstanceLicenseType	A licenc típusa. Lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár saját SQL-licencek behozása esetén).
properties.maintenanceConfigurationId		string	Megadja a felügyelt példányra alkalmazandó karbantartási konfiguráció azonosítóját.
properties.managedInstanceCreateMode		ManagedServerCreateMode	Megadja az adatbázis létrehozásának módját. Alapértelmezett: Normál példánylétrehozás. Visszaállítás: Létrehoz egy példányt a biztonsági másolatok adott időpontra való visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId azonosítót.
properties.memorySizeInGB		integer (int32)	Memória mérete GB-ban. Minimális érték: 28. Maximális érték: 870. A minimális és maximális érték a virtuális magok számától és a szolgáltatási szinttől függ. További információ az erőforráskorlátokról: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion		string	Minimális TLS-verzió. Engedélyezett értékek: "Nincs", "1.0", "1.1", "1.2"
properties.pricingModel		PricingModel	A Managed Instance ármodellje.
properties.primaryUserAssignedIdentityId		string (arm-id)	A felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.
properties.proxyOverride		ManagedInstanceProxyOverride	A példányhoz való csatlakozáshoz használt kapcsolattípus.
properties.publicDataEndpointEnabled		boolean	Azt jelzi, hogy a nyilvános adatvégpont engedélyezve van-e.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	A példány biztonsági mentéseinek tárolására használt tárfiók típusa. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Megadja a logikai elérhetőségi zónát, amelyhez a Managed Instance kitűzve van.
properties.restorePointInTime		string (date-time)	Megadja annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaállítva.
properties.servicePrincipal		ServicePrincipal	A felügyelt példány szolgáltatásnév.
properties.sourceManagedInstanceId		string (arm-id)	A példány létrehozási műveletéhez társított felügyelt forráspéldány erőforrás-azonosítója.
properties.storageIOps		integer (int32)	Tárolási IOps. Minimális érték: 300. Maximális érték: 80000. Csak 1 IOps-növekmény engedélyezett. A maximális érték a kiválasztott hardvercsaládtól és a virtuális magok számától függ.
properties.storageSizeInGB		integer (int32)	Tárterület mérete GB-ban. Minimális érték: 32. Maximális érték: 32768. Csak 32 GB-os növekmények engedélyezettek. A maximális érték a kiválasztott hardvercsaládtól és a virtuális magok számától függ.
properties.storageThroughputMBps		integer (int32)	A tárkapacitás MBps paramétere nem támogatott a példány létrehozási/frissítési műveletében.
properties.subnetId		string (arm-id)	A felügyelt példány alhálózati erőforrás-azonosítója.
properties.timezoneId		string	Az időzón azonosítója. Az engedélyezett értékek a Windows által támogatott időzónák. Windows a támogatott időzónákról, beleértve az azonosítót is, a KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones adatbázisban tárolja. Ezeket a nyilvántartási értékeket SQL Server-n keresztül kaphatod meg, ha SELECT név AS timezone_id FROM sys.time_zone_info-TÓL. Az azonosítók listája a [System.TimeZoneInfo]::GetSystemTimeZones() PowerShellben történő végrehajtásával is lekérhető. Az érvényes időzón-azonosító például a "Csendes-óceáni téli idő" vagy a "W". Európai téli idő".
properties.vCores		integer (int32)	A virtuális magok száma. Megengedett értékek: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. A támogatott virtuális magok a kiválasztott hardvercsaládtól és szolgáltatási szinttől függenek.
properties.zoneRedundant		boolean	Engedélyezve van-e a zónaredundancia.
sku		Sku	Felügyelt példány termékváltozata. A sku.name megengedett értékei: GP_Gen5 (általános célú, standard sorozat); GP_G8IM (általános célú, prémium sorozat); GP_G8IH (általános célú, prémium sorozatú memóriaoptimalizált); BC_Gen5 (Üzleti kritikus, Standard-Series); BC_G8IM (Business Critical, Premium-sorozat); BC_G8IH (üzletileg kritikus, prémium sorozatú memóriaoptimalizált).
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	ManagedInstance	Az erőforrás 'ManagedInstance' frissítési művelete sikeres
201 Created	ManagedInstance	Resource 'ManagedInstance' létrehozása sikeres Fejlécek Location: string Retry-After: integer
202 Accepted		Az erőforrásművelet elfogadott. Fejlécek Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

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

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/SQL/stable/2025-01-01/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,
    HybridSecondaryUsage = HybridSecondaryUsage.Passive,
    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,
    },
    AuthenticationMetadata = AuthMetadataLookupMode.Aad,
    DatabaseFormat = ManagedInstanceDatabaseFormat.AlwaysUpToDate,
    RequestedLogicalAvailabilityZone = SqlAvailabilityZoneType.One,
    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

Mintaválasz

Állapotkód:

200

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

Állapotkód:

201

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

Állapotkód:

202

Create managed instance with minimal properties

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

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

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/SQL/stable/2025-01-01/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_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,
};
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

Mintaválasz

Állapotkód:

200

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

Állapotkód:

201

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

Állapotkód:

202

Definíciók

Name	Description
AdministratorType	A rendszergazda típusa.
AuthMetadataLookupModes	A felügyelt példány hitelesítési metaadatainak keresési módja.
AvailabilityZoneType	Azt a rendelkezésre állási zónát adja meg, amelybe az adatbázis rögzítve van.
BackupStorageRedundancy	Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
ExternalGovernanceStatus	A külső irányítás állapota.
HybridSecondaryUsage	Hibrid másodlagos használat. Lehetséges értékek az "Aktív" (alapértelmezett érték) és a "Passzív" (az ügyfél a másodlagost passzív DR-ként használja).
HybridSecondaryUsageDetected	Hibrid másodlagos használat észlelhető. A lehetséges értékek "Aktívak" (az ügyfél nem felel meg a másodlagos passzív dr. használatára vonatkozó követelményeknek) és a "Passzív" (az ügyfél megfelel a másodlagos passzív DR használatára vonatkozó követelményeknek).
IdentityType	Az identitás típusa. Állítsuk be 'SystemAssigned'-re, hogy automatikusan létrehozhass és hozzárendelhesd az Azure Active Directory alapvetőt az erőforráshoz.
ManagedInstance	Egy Azure SQL által kezelt instance.
ManagedInstanceDatabaseFormat	Az SQL-motor verziójára jellemző példányadatbázisok belső formátumát adja meg.
ManagedInstanceExternalAdministrator	Az Active Directory-rendszergazda tulajdonságai.
ManagedInstanceLicenseType	A licenc típusa. Lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár saját SQL-licencek behozása esetén).
ManagedInstancePecProperty	Privát végpontkapcsolat felügyelt példány alatt
ManagedInstancePrivateEndpointConnectionProperties	Privát végpontkapcsolat tulajdonságai.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	A példányhoz való csatlakozáshoz használt kapcsolattípus.
ManagedServerCreateMode	Megadja az adatbázis létrehozásának módját. Alapértelmezett: Normál példánylétrehozás. Visszaállítás: Létrehoz egy példányt a biztonsági másolatok adott időpontra való visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId azonosítót.
PricingModel	A Managed Instance ármodellje.
PrincipalType	A rendszergazda egyszerű típusa.
ProvisioningState	A feladat végrehajtásának ARM-kiépítési állapota.
ResourceIdentity	Azure Active Directory identity configuration for a resource
ServicePrincipal	A felügyelt példány szolgáltatásnév-konfigurációja egy erőforráshoz.
ServicePrincipalType	Szolgáltatásnév típusa.
Sku	ARM-erőforrás termékváltozata.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UserIdentity	Azure Active Directory identity configuration for a resource

AdministratorType

Felsorolás

A rendszergazda típusa.

Érték	Description
ActiveDirectory	ActiveDirectory

AuthMetadataLookupModes

Felsorolás

A felügyelt példány hitelesítési metaadatainak keresési módja.

Érték	Description
AzureAD	AzureAD
Paired	Párosított
Windows	Windows

AvailabilityZoneType

Felsorolás

Azt a rendelkezésre állási zónát adja meg, amelybe az adatbázis rögzítve van.

Érték	Description
NoPreference	NoPreference
1	1
2	2
3	3

BackupStorageRedundancy

Felsorolás

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

Érték	Description
Geo	Földrajz
Local	Helyi
Zone	Zóna
GeoZone	Geozónia

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

ExternalGovernanceStatus

Felsorolás

A külső irányítás állapota.

Érték	Description
Enabled	Engedélyezett
Disabled	Disabled

HybridSecondaryUsage

Felsorolás

Hibrid másodlagos használat. Lehetséges értékek az "Aktív" (alapértelmezett érték) és a "Passzív" (az ügyfél a másodlagost passzív DR-ként használja).

Érték	Description
Active	Aktív
Passive	Passive

HybridSecondaryUsageDetected

Felsorolás

Hibrid másodlagos használat észlelhető. A lehetséges értékek "Aktívak" (az ügyfél nem felel meg a másodlagos passzív dr. használatára vonatkozó követelményeknek) és a "Passzív" (az ügyfél megfelel a másodlagos passzív DR használatára vonatkozó követelményeknek).

Érték	Description
Active	Aktív
Passive	Passive

IdentityType

Felsorolás

Az identitás típusa. Állítsuk be 'SystemAssigned'-re, hogy automatikusan létrehozhass és hozzárendelhesd az Azure Active Directory alapvetőt az erőforráshoz.

Érték	Description
None	Nincs
SystemAssigned	Rendszer Által Hozzárendelve
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned,UserAssigned

ManagedInstance

Tárgy

Egy Azure SQL által kezelt instance.

Name	Típus	Description
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	A kezelt példány Azure Active Directory identitása.
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.administratorLogin	string	A felügyelt példány rendszergazdai felhasználóneve. Csak a felügyelt példány létrehozásakor adható meg (és a létrehozáshoz szükséges).
properties.administratorLoginPassword	string (password)	A rendszergazda bejelentkezési jelszava (a felügyelt példány létrehozásához szükséges).
properties.administrators	ManagedInstanceExternalAdministrator	Az Azure Active Directory adír használható instance-készítés és instanzfrissítések során, kivéve az azureADOnlyAuthentication tulajdonságot. A tulajdonság azureADOnlyAuthentication frissítéséhez egyedi API-t kell használni.
properties.authenticationMetadata	AuthMetadataLookupModes	A felügyelt példány hitelesítési metaadatainak keresési módja.
properties.collation	string	A felügyelt példány rendezése.
properties.createTime	string (date-time)	Megadja a Managed Instance létrehozásának időpontját (ISO8601 formátumot).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	A példány biztonsági mentéseinek tárolására használt tárfióktípus. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Az SQL-motor verziójára jellemző példányadatbázisok belső formátumát adja meg.
properties.dnsZone	string	A felügyelt példány dns-zónája.
properties.dnsZonePartner	string (arm-id)	Egy másik felügyelt példány erőforrás-azonosítója, amelynek DNS-zónáját ez a felügyelt példány a létrehozás után megosztja.
properties.externalGovernanceStatus	ExternalGovernanceStatus	A külső irányítás állapota.
properties.fullyQualifiedDomainName	string	A felügyelt példány teljes tartományneve.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Hibrid másodlagos használat. Lehetséges értékek az "Aktív" (alapértelmezett érték) és a "Passzív" (az ügyfél a másodlagost passzív DR-ként használja).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Hibrid másodlagos használat észlelhető. A lehetséges értékek "Aktívak" (az ügyfél nem felel meg a másodlagos passzív dr. használatára vonatkozó követelményeknek) és a "Passzív" (az ügyfél megfelel a másodlagos passzív DR használatára vonatkozó követelményeknek).
properties.instancePoolId	string	Annak a példánykészletnek az azonosítója, amelyhez a felügyelt kiszolgáló tartozik.
properties.isGeneralPurposeV2	boolean	Függetlenül attól, hogy ez az Általános célú kiadás GPv2-változata-e.
properties.keyId	string	A titkosításhoz használandó kulcs CMK URI-ja.
properties.licenseType	ManagedInstanceLicenseType	A licenc típusa. Lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár saját SQL-licencek behozása esetén).
properties.maintenanceConfigurationId	string	Megadja a felügyelt példányra alkalmazandó karbantartási konfiguráció azonosítóját.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Megadja az adatbázis létrehozásának módját. Alapértelmezett: Normál példánylétrehozás. Visszaállítás: Létrehoz egy példányt a biztonsági másolatok adott időpontra való visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId azonosítót.
properties.memorySizeInGB	integer (int32)	Memória mérete GB-ban. Minimális érték: 28. Maximális érték: 870. A minimális és maximális érték a virtuális magok számától és a szolgáltatási szinttől függ. További információ az erőforráskorlátokról: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion	string	Minimális TLS-verzió. Engedélyezett értékek: "Nincs", "1.0", "1.1", "1.2"
properties.pricingModel	PricingModel	A Managed Instance ármodellje.
properties.primaryUserAssignedIdentityId	string (arm-id)	A felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Felügyelt példány privát végpontkapcsolatainak listája.
properties.provisioningState	ProvisioningState	Felügyelt példány kiépítési állapota.
properties.proxyOverride	ManagedInstanceProxyOverride	A példányhoz való csatlakozáshoz használt kapcsolattípus.
properties.publicDataEndpointEnabled	boolean	Azt jelzi, hogy a nyilvános adatvégpont engedélyezve van-e.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	A példány biztonsági mentéseinek tárolására használt tárfiók típusa. A beállítások a következők: Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) és GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone	AvailabilityZoneType	Megadja a logikai elérhetőségi zónát, amelyhez a Managed Instance kitűzve van.
properties.restorePointInTime	string (date-time)	Megadja annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaállítva.
properties.servicePrincipal	ServicePrincipal	A felügyelt példány szolgáltatásnév.
properties.sourceManagedInstanceId	string (arm-id)	A példány létrehozási műveletéhez társított felügyelt forráspéldány erőforrás-azonosítója.
properties.state	string	A felügyelt példány állapota.
properties.storageIOps	integer (int32)	Tárolási IOps. Minimális érték: 300. Maximális érték: 80000. Csak 1 IOps-növekmény engedélyezett. A maximális érték a kiválasztott hardvercsaládtól és a virtuális magok számától függ.
properties.storageSizeInGB	integer (int32)	Tárterület mérete GB-ban. Minimális érték: 32. Maximális érték: 32768. Csak 32 GB-os növekmények engedélyezettek. A maximális érték a kiválasztott hardvercsaládtól és a virtuális magok számától függ.
properties.storageThroughputMBps	integer (int32)	A tárkapacitás MBps paramétere nem támogatott a példány létrehozási/frissítési műveletében.
properties.subnetId	string (arm-id)	A felügyelt példány alhálózati erőforrás-azonosítója.
properties.timezoneId	string	Az időzón azonosítója. Az engedélyezett értékek a Windows által támogatott időzónák. Windows a támogatott időzónákról, beleértve az azonosítót is, a KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones adatbázisban tárolja. Ezeket a nyilvántartási értékeket SQL Server-n keresztül kaphatod meg, ha SELECT név AS timezone_id FROM sys.time_zone_info-TÓL. Az azonosítók listája a [System.TimeZoneInfo]::GetSystemTimeZones() PowerShellben történő végrehajtásával is lekérhető. Az érvényes időzón-azonosító például a "Csendes-óceáni téli idő" vagy a "W". Európai téli idő".
properties.vCores	integer (int32)	A virtuális magok száma. Megengedett értékek: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. A támogatott virtuális magok a kiválasztott hardvercsaládtól és szolgáltatási szinttől függenek.
properties.virtualClusterId	string	Virtuális klaszter erőforrás-azonosítója a Managed Instance-hoz.
properties.zoneRedundant	boolean	Engedélyezve van-e a zónaredundancia.
sku	Sku	Felügyelt példány termékváltozata. A sku.name megengedett értékei: GP_Gen5 (általános célú, standard sorozat); GP_G8IM (általános célú, prémium sorozat); GP_G8IH (általános célú, prémium sorozatú memóriaoptimalizált); BC_Gen5 (Üzleti kritikus, Standard-Series); BC_G8IM (Business Critical, Premium-sorozat); BC_G8IH (üzletileg kritikus, prémium sorozatú memóriaoptimalizált).
systemData	systemData	Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok"

ManagedInstanceDatabaseFormat

Felsorolás

Az SQL-motor verziójára jellemző példányadatbázisok belső formátumát adja meg.

Érték	Description
AlwaysUpToDate	AlwaysNapToDate
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Tárgy

Az Active Directory-rendszergazda tulajdonságai.

Name	Típus	Description
administratorType	AdministratorType	A rendszergazda típusa.
azureADOnlyAuthentication	boolean	Azure Active Directory csak hitelesítés engedélyezve.
login	string	A kiszolgáló rendszergazdájának bejelentkezési neve.
principalType	PrincipalType	A rendszergazda egyszerű típusa.
sid	string (uuid)	A kiszolgáló rendszergazdájának SID-azonosítója (objektumazonosítója).
tenantId	string (uuid)	A rendszergazda bérlőazonosítója.

ManagedInstanceLicenseType

Felsorolás

A licenc típusa. Lehetséges értékek a "LicenseIncluded" (az új SQL-licenceket tartalmazó normál ár) és a "BasePrice" (kedvezményes AHB-ár saját SQL-licencek behozása esetén).

Érték	Description
LicenseIncluded	LicenceIncluded
BasePrice	BasePrice

ManagedInstancePecProperty

Tárgy

Privát végpontkapcsolat felügyelt példány alatt

Name	Típus	Description
id	string	Erőforrás-azonosító.
properties	ManagedInstancePrivateEndpointConnectionProperties	Privát végpont kapcsolati tulajdonságai

ManagedInstancePrivateEndpointConnectionProperties

Tárgy

Privát végpontkapcsolat tulajdonságai.

Name	Típus	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Privát végpont, amelyhez a kapcsolat tartozik.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	A privát végpontkapcsolat kapcsolati állapota.
provisioningState	string	A privát végpontkapcsolat állapota.

ManagedInstancePrivateEndpointProperty

Tárgy

Name	Típus	Description
id	string	A privát végpont erőforrás-azonosítója.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Tárgy

Name	Típus	Description
actionsRequired	string	A privát kapcsolat szolgáltatás kapcsolatának leírása.
description	string	A privát kapcsolat szolgáltatás kapcsolatának leírása.
status	string	A privát kapcsolat szolgáltatás kapcsolati állapota.

ManagedInstanceProxyOverride

Felsorolás

A példányhoz való csatlakozáshoz használt kapcsolattípus.

Érték	Description
Proxy	Proxy
Redirect	Redirect
Default	Alapértelmezett

ManagedServerCreateMode

Felsorolás

Megadja az adatbázis létrehozásának módját.

Alapértelmezett: Normál példánylétrehozás.

Visszaállítás: Létrehoz egy példányt a biztonsági másolatok adott időpontra való visszaállításával. Meg kell adni a RestorePointInTime és a SourceManagedInstanceId azonosítót.

Érték	Description
Default	Alapértelmezett
PointInTimeRestore	PointInTimeRestore

PricingModel

Felsorolás

A Managed Instance ármodellje.

Érték	Description
Regular	Rendszeres
Freemium	Freemium

PrincipalType

Felsorolás

A rendszergazda egyszerű típusa.

Érték	Description
User	User
Group	Csoport
Application	Application

ProvisioningState

Felsorolás

A feladat végrehajtásának ARM-kiépítési állapota.

Érték	Description
Created	Létrehozott
InProgress	Folyamatban
Succeeded	Sikerült
Failed	Meghiúsult
Canceled	Érvénytelenített

ResourceIdentity

Tárgy

Azure Active Directory identity configuration for a resource

Name	Típus	Description
principalId	string (uuid)	Az Azure Active Directory fő azonosítója.
tenantId	string (uuid)	Az Azure Active Directory tenant id.
type	IdentityType	Az identitás típusa. Állítsuk be 'SystemAssigned'-re, hogy automatikusan létrehozhass és hozzárendelhesd az Azure Active Directory alapvetőt az erőforráshoz.
userAssignedIdentities	<string,  UserIdentity>	A felhasználó által hozzárendelt használt identitások erőforrás-azonosítói

ServicePrincipal

Tárgy

A felügyelt példány szolgáltatásnév-konfigurációja egy erőforráshoz.

Name	Típus	Description
clientId	string	Az Azure Active Directory application client id-je.
principalId	string	Az Azure Active Directory application object id.
tenantId	string	Az Azure Active Directory tenant id.
type	ServicePrincipalType	Szolgáltatásnév típusa.

ServicePrincipalType

Felsorolás

Szolgáltatásnév típusa.

Érték	Description
None	Nincs
SystemAssigned	Rendszer Által Hozzárendelve

Sku

Tárgy

ARM-erőforrás termékváltozata.

Name	Típus	Description
capacity	integer (int32)	Az adott termékváltozat kapacitása.
family	string	Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti.
name	string	Az termékváltozat neve általában egy betű + Szám kód, pl. P3.
size	string	Az adott termékváltozat mérete
tier	string	Az adott termékváltozat szintje vagy kiadása, például Alapszintű, Prémium.

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UserIdentity

Tárgy

Azure Active Directory identity configuration for a resource

Name	Típus	Description
clientId	string (uuid)	Az Azure Active Directory kliensazonosítója.
principalId	string (uuid)	Az Azure Active Directory fő azonosítója.