Managed Instances - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2025-01-01

Vytvoří nebo aktualizuje spravovanou instanci.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
managedInstanceName	path	True	string	Název spravované instance.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
identity		ResourceIdentity	Identita Azure Active Directory spravované instance.
properties.administratorLogin		string	Uživatelské jméno správce pro spravovanou instanci. Je možné zadat pouze při vytváření spravované instance (a vyžaduje se k vytvoření).
properties.administratorLoginPassword		string (password)	Přihlašovací heslo správce (vyžaduje se k vytvoření spravované instance).
properties.administrators		ManagedInstanceExternalAdministrator	Správce Azure Active Directory lze využít při vytváření instance a například při aktualizacích, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API.
properties.authenticationMetadata		AuthMetadataLookupModes	Režim vyhledávání metadat ověřování spravované instance.
properties.collation		string	Kolace spravované instance
properties.databaseFormat		ManagedInstanceDatabaseFormat	Určuje interní formát databází instancí specifických pro verzi modulu SQL.
properties.dnsZonePartner		string (arm-id)	ID prostředku jiné spravované instance, jejíž zóna DNS bude tato spravovaná instance sdílet po vytvoření.
properties.hybridSecondaryUsage		HybridSecondaryUsage	Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).
properties.instancePoolId		string	ID fondu instancí, do které tento spravovaný server patří.
properties.isGeneralPurposeV2		boolean	Určuje, jestli se jedná o variantu GPv2 edice Pro obecné účely.
properties.keyId		string	Identifikátor URI klíče CMK, který se má použít k šifrování.
properties.licenseType		ManagedInstanceLicenseType	Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).
properties.maintenanceConfigurationId		string	Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci.
properties.managedInstanceCreateMode		ManagedServerCreateMode	Určuje režim vytváření databáze. Výchozí hodnota: Vytvoření pravidelné instance. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.
properties.memorySizeInGB		integer (int32)	Velikost paměti v GB. Minimální hodnota: 28. Maximální hodnota: 870. Minimální a maximální hodnota závisí na počtu virtuálních jader a úrovni služby. Přečtěte si více o omezeních zdrojů: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion		string	Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2
properties.pricingModel		PricingModel	Cenový model Managed Instance.
properties.primaryUserAssignedIdentityId		string (arm-id)	ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.
properties.proxyOverride		ManagedInstanceProxyOverride	Typ připojení použitý pro připojení k instanci.
properties.publicDataEndpointEnabled		boolean	Určuje, jestli je povolený veřejný datový koncový bod nebo ne.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Specifikuje logickou dostupnost, ke které je Managed Instance připnut.
properties.restorePointInTime		string (date-time)	Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi.
properties.servicePrincipal		ServicePrincipal	Instanční objekt spravované instance.
properties.sourceManagedInstanceId		string (arm-id)	Identifikátorprostředkuho
properties.storageIOps		integer (int32)	Úložiště IOps. Minimální hodnota: 300. Maximální hodnota: 80000. Přírůstky 1 vstupně-výstupních operací za sekundu jsou povolené jenom. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader.
properties.storageSizeInGB		integer (int32)	Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 32768. Jsou povoleny pouze přírůstky o 32 GB. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader.
properties.storageThroughputMBps		integer (int32)	Parametr MBps propustnosti úložiště se v operaci vytvoření nebo aktualizace instance nepodporuje.
properties.subnetId		string (arm-id)	ID prostředku podsítě pro spravovanou instanci.
properties.timezoneId		string	ID časového pásma. Povolené hodnoty jsou časová pásma podporovaná Windows. Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru pod KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat přes SQL Server dotazem SELECT name AS timezone_id FROM sys.time_zone_info. Seznam ID lze získat také spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je Tichomoří (běžný čas) nebo W. Evropský standardní čas".
properties.vCores		integer (int32)	Počet virtuálních jader. Povolené hodnoty: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Podporovaná virtuální jádra závisí na vybrané rodině hardwaru a úrovni služby.
properties.zoneRedundant		boolean	Zda je povolena zónová redundance.
sku		Sku	Skladová položka spravované instance Povolené hodnoty pro sku.name: GP_Gen5 (Pro obecné použití, řada Standard); GP_G8IM (pro všeobecné použití, řada Premium); GP_G8IH (pro všeobecné použití, optimalizováno pro paměť řady Premium); BC_Gen5 (Důležité obchodní informace, Standard-Series); BC_G8IM (Pro důležité obchodní informace, řada Premium); BC_G8IH (Pro důležité obchodní informace, optimalizováno pro paměť řady Premium).
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	ManagedInstance	Aktualizace zdroje 'ManagedInstance' byla úspěšná
201 Created	ManagedInstance	Operace vytvoření zdroje 'ManagedInstance' byla úspěšná Hlavičky Location: string Retry-After: integer
202 Accepted		Operace prostředku byla přijata. Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
  }
}

Stavový kó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"
  }
}

Stavový kód:

202

Create managed instance with minimal properties

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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": {}
}

Stavový kó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": {}
}

Stavový kód:

202

Definice

Name	Description
AdministratorType	Typ správce serveru.
AuthMetadataLookupModes	Režim vyhledávání metadat ověřování spravované instance.
AvailabilityZoneType	Určuje zónu dostupnosti, ke které je databáze připnutá.
BackupStorageRedundancy	Typ účtu úložiště použitý k ukládání záloh pro tuto databázi.
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExternalGovernanceStatus	Stav externích zásad správného řízení
HybridSecondaryUsage	Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).
HybridSecondaryUsageDetected	Zjistilo se hybridní sekundární využití. Možné hodnoty jsou Aktivní (zákazník nesplňuje požadavky na použití sekundárního systému jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundárního pasivního zotavení po havárii).
IdentityType	Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj.
ManagedInstance	A Azure SQL managed instance.
ManagedInstanceDatabaseFormat	Určuje interní formát databází instancí specifických pro verzi modulu SQL.
ManagedInstanceExternalAdministrator	Vlastnosti správce služby Active Directory
ManagedInstanceLicenseType	Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).
ManagedInstancePecProperty	Připojení privátního koncového bodu ve spravované instanci
ManagedInstancePrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Typ připojení použitý pro připojení k instanci.
ManagedServerCreateMode	Určuje režim vytváření databáze. Výchozí hodnota: Vytvoření pravidelné instance. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.
PricingModel	Cenový model Managed Instance.
PrincipalType	Hlavní typ správce serveru.
ProvisioningState	Stav zřizování ARM při provádění úlohy.
ResourceIdentity	Azure Active Directory identity configuration for a resource.
ServicePrincipal	Konfigurace instančního objektu spravované instance pro prostředek.
ServicePrincipalType	Typ instančního objektu.
Sku	Skladová položka prostředku ARM.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UserIdentity	Azure Active Directory identity configuration for a resource.

AdministratorType

Výčet

Typ správce serveru.

Hodnota	Description
ActiveDirectory	Active Directory

AuthMetadataLookupModes

Výčet

Režim vyhledávání metadat ověřování spravované instance.

Hodnota	Description
AzureAD	AzureAD
Paired	Párové
Windows	Windows

AvailabilityZoneType

Výčet

Určuje zónu dostupnosti, ke které je databáze připnutá.

Hodnota	Description
NoPreference	NoPreference
1	1
2	2
3	3

BackupStorageRedundancy

Výčet

Typ účtu úložiště použitý k ukládání záloh pro tuto databázi.

Hodnota	Description
Geo	Geo
Local	Místní
Zone	Zóna
GeoZone	GeoZone

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExternalGovernanceStatus

Výčet

Stav externích zásad správného řízení

Hodnota	Description
Enabled	Enabled
Disabled	Disabled

HybridSecondaryUsage

Výčet

Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).

Hodnota	Description
Active	Aktivní
Passive	Passive

HybridSecondaryUsageDetected

Výčet

Zjistilo se hybridní sekundární využití. Možné hodnoty jsou Aktivní (zákazník nesplňuje požadavky na použití sekundárního systému jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundárního pasivního zotavení po havárii).

Hodnota	Description
Active	Aktivní
Passive	Passive

IdentityType

Výčet

Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj.

Hodnota	Description
None	None
SystemAssigned	Přiřazen systémem
UserAssigned	Přiřazeno uživatelem
SystemAssigned,UserAssigned	SystémPřiřazené,Přiřazené uživatelem

ManagedInstance

Objekt

A Azure SQL managed instance.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	Identita Azure Active Directory spravované instance.
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.administratorLogin	string	Uživatelské jméno správce pro spravovanou instanci. Je možné zadat pouze při vytváření spravované instance (a vyžaduje se k vytvoření).
properties.administratorLoginPassword	string (password)	Přihlašovací heslo správce (vyžaduje se k vytvoření spravované instance).
properties.administrators	ManagedInstanceExternalAdministrator	Správce Azure Active Directory lze využít při vytváření instance a například při aktualizacích, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API.
properties.authenticationMetadata	AuthMetadataLookupModes	Režim vyhledávání metadat ověřování spravované instance.
properties.collation	string	Kolace spravované instance
properties.createTime	string (date-time)	Specifikuje časový bod (ISO8601 formát) Managed Instance vytvoření.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Typ účtu úložiště použitý k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Určuje interní formát databází instancí specifických pro verzi modulu SQL.
properties.dnsZone	string	Zóna DNS, ve které je spravovaná instance.
properties.dnsZonePartner	string (arm-id)	ID prostředku jiné spravované instance, jejíž zóna DNS bude tato spravovaná instance sdílet po vytvoření.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stav externích zásad správného řízení
properties.fullyQualifiedDomainName	string	Plně kvalifikovaný název domény spravované instance.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Zjistilo se hybridní sekundární využití. Možné hodnoty jsou Aktivní (zákazník nesplňuje požadavky na použití sekundárního systému jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundárního pasivního zotavení po havárii).
properties.instancePoolId	string	ID fondu instancí, do které tento spravovaný server patří.
properties.isGeneralPurposeV2	boolean	Určuje, jestli se jedná o variantu GPv2 edice Pro obecné účely.
properties.keyId	string	Identifikátor URI klíče CMK, který se má použít k šifrování.
properties.licenseType	ManagedInstanceLicenseType	Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).
properties.maintenanceConfigurationId	string	Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Určuje režim vytváření databáze. Výchozí hodnota: Vytvoření pravidelné instance. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.
properties.memorySizeInGB	integer (int32)	Velikost paměti v GB. Minimální hodnota: 28. Maximální hodnota: 870. Minimální a maximální hodnota závisí na počtu virtuálních jader a úrovni služby. Přečtěte si více o omezeních zdrojů: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion	string	Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2
properties.pricingModel	PricingModel	Cenový model Managed Instance.
properties.primaryUserAssignedIdentityId	string (arm-id)	ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Seznam připojení privátních koncových bodů ve spravované instanci
properties.provisioningState	ProvisioningState	Stav zřizování spravované instance
properties.proxyOverride	ManagedInstanceProxyOverride	Typ připojení použitý pro připojení k instanci.
properties.publicDataEndpointEnabled	boolean	Určuje, jestli je povolený veřejný datový koncový bod nebo ne.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone	AvailabilityZoneType	Specifikuje logickou dostupnost, ke které je Managed Instance připnut.
properties.restorePointInTime	string (date-time)	Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi.
properties.servicePrincipal	ServicePrincipal	Instanční objekt spravované instance.
properties.sourceManagedInstanceId	string (arm-id)	Identifikátorprostředkuho
properties.state	string	Stav spravované instance.
properties.storageIOps	integer (int32)	Úložiště IOps. Minimální hodnota: 300. Maximální hodnota: 80000. Přírůstky 1 vstupně-výstupních operací za sekundu jsou povolené jenom. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader.
properties.storageSizeInGB	integer (int32)	Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 32768. Jsou povoleny pouze přírůstky o 32 GB. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader.
properties.storageThroughputMBps	integer (int32)	Parametr MBps propustnosti úložiště se v operaci vytvoření nebo aktualizace instance nepodporuje.
properties.subnetId	string (arm-id)	ID prostředku podsítě pro spravovanou instanci.
properties.timezoneId	string	ID časového pásma. Povolené hodnoty jsou časová pásma podporovaná Windows. Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru pod KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat přes SQL Server dotazem SELECT name AS timezone_id FROM sys.time_zone_info. Seznam ID lze získat také spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je Tichomoří (běžný čas) nebo W. Evropský standardní čas".
properties.vCores	integer (int32)	Počet virtuálních jader. Povolené hodnoty: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Podporovaná virtuální jádra závisí na vybrané rodině hardwaru a úrovni služby.
properties.virtualClusterId	string	Virtuální cluster resource id pro Managed Instance.
properties.zoneRedundant	boolean	Zda je povolena zónová redundance.
sku	Sku	Skladová položka spravované instance Povolené hodnoty pro sku.name: GP_Gen5 (Pro obecné použití, řada Standard); GP_G8IM (pro všeobecné použití, řada Premium); GP_G8IH (pro všeobecné použití, optimalizováno pro paměť řady Premium); BC_Gen5 (Důležité obchodní informace, Standard-Series); BC_G8IM (Pro důležité obchodní informace, řada Premium); BC_G8IH (Pro důležité obchodní informace, optimalizováno pro paměť řady Premium).
systemData	systemData	Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.
tags	object	Značky prostředků
type	string	Typ prostředku. Například "Microsoft. Compute/virtualMachines" nebo "Microsoft. Úložiště/úložištěÚčty"

ManagedInstanceDatabaseFormat

Výčet

Určuje interní formát databází instancí specifických pro verzi modulu SQL.

Hodnota	Description
AlwaysUpToDate	AlwaysUpToAktuální
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Objekt

Vlastnosti správce služby Active Directory

Name	Typ	Description
administratorType	AdministratorType	Typ správce serveru.
azureADOnlyAuthentication	boolean	Azure Active Directory pouze Authentication povolen.
login	string	Přihlašovací jméno správce serveru.
principalType	PrincipalType	Hlavní typ správce serveru.
sid	string (uuid)	IDENTIFIKÁTOR SID (ID objektu) správce serveru.
tenantId	string (uuid)	ID tenanta správce.

ManagedInstanceLicenseType

Výčet

Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).

Hodnota	Description
LicenseIncluded	LicenceZahrnuto
BasePrice	BasePrice

ManagedInstancePecProperty

Objekt

Připojení privátního koncového bodu ve spravované instanci

Name	Typ	Description
id	string	ID prostředku.
properties	ManagedInstancePrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu

ManagedInstancePrivateEndpointConnectionProperties

Objekt

Vlastnosti připojení privátního koncového bodu

Name	Typ	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Privátní koncový bod, ke kterému připojení patří.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Stav připojení připojení privátního koncového bodu
provisioningState	string	Stav připojení privátního koncového bodu

ManagedInstancePrivateEndpointProperty

Objekt

Name	Typ	Description
id	string	ID prostředku privátního koncového bodu

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objekt

Name	Typ	Description
actionsRequired	string	Popis připojení služby Private Link.
description	string	Popis připojení služby Private Link.
status	string	Stav připojení služby Private Link.

ManagedInstanceProxyOverride

Výčet

Typ připojení použitý pro připojení k instanci.

Hodnota	Description
Proxy	Proxy
Redirect	Přesměrovat
Default	Výchozí

ManagedServerCreateMode

Výčet

Určuje režim vytváření databáze.

Výchozí hodnota: Vytvoření pravidelné instance.

Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.

Hodnota	Description
Default	Výchozí
PointInTimeRestore	PointInTimeRestore

PricingModel

Výčet

Cenový model Managed Instance.

Hodnota	Description
Regular	Běžné
Freemium	Freemium

PrincipalType

Výčet

Hlavní typ správce serveru.

Hodnota	Description
User	User
Group	Skupina
Application	Přihláška

ProvisioningState

Výčet

Stav zřizování ARM při provádění úlohy.

Hodnota	Description
Created	Vytvořeno
InProgress	Probíhající
Succeeded	Úspěch
Failed	Nezdařilo se
Canceled	Zrušeno

ResourceIdentity

Objekt

Azure Active Directory identity configuration for a resource.

Name	Typ	Description
principalId	string (uuid)	The Azure Active Directory principal id.
tenantId	string (uuid)	Tenant id Azure Active Directory.
type	IdentityType	Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj.
userAssignedIdentities	<string,  UserIdentity>	ID prostředků identit přiřazených uživatelem, které se mají použít

ServicePrincipal

Objekt

Konfigurace instančního objektu spravované instance pro prostředek.

Name	Typ	Description
clientId	string	Client ID aplikace Azure Active Directory.
principalId	string	Id Azure Active Directory application object.
tenantId	string	Tenant id Azure Active Directory.
type	ServicePrincipalType	Typ instančního objektu.

ServicePrincipalType

Výčet

Typ instančního objektu.

Hodnota	Description
None	None
SystemAssigned	Přiřazen systémem

Sku

Objekt

Skladová položka prostředku ARM.

Name	Typ	Description
capacity	integer (int32)	Kapacita konkrétní skladové položky.
family	string	Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete ji zde zachytit.
name	string	Název skladové položky, obvykle písmeno + číslo, např. P3.
size	string	Velikost konkrétní skladové položky
tier	string	Úroveň nebo edice konkrétní skladové položky, např. Basic, Premium.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

UserIdentity

Objekt

Azure Active Directory identity configuration for a resource.

Name	Typ	Description
clientId	string (uuid)	Client ID Azure Active Directory.
principalId	string (uuid)	The Azure Active Directory principal id.