Managed Instances - Create Or Update

Yönetilen örneği oluşturur veya güncelleştirir.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
managedInstanceName
path True

string

Yönetilen örneğin adı.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.

subscriptionId
path True

string (uuid)

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Gerekli Tür Description
location True

string

Kaynağın bulunduğu coğrafi konum

identity

ResourceIdentity

Yönetilen örneğin Azure Active Directory kimliği.

properties.administratorLogin

string

Yönetilen örnek için yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir).

properties.administratorLoginPassword

string (password)

Yönetici oturum açma parolası (yönetilen örnek oluşturma için gereklidir).

properties.administrators

ManagedInstanceExternalAdministrator

Azure Active Directory yöneticisi, örnek oluşturma ve örnek güncellemeleri sırasında kullanılabilir, azureADOnlyAuthentication özelliği hariç. azureADOnlyAuthentication özelliğini güncelleştirmek için tek tek API'nin kullanılması gerekir.

properties.authenticationMetadata

AuthMetadataLookupModes

Yönetilen örneğin kimlik doğrulaması meta veri arama modu.

properties.collation

string

Yönetilen örneğin harmanlanması.

properties.databaseFormat

ManagedInstanceDatabaseFormat

SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir.

properties.dnsZonePartner

string (arm-id)

Bu yönetilen örneğin dns bölgesi oluşturulduktan sonra paylaşılacak başka bir yönetilen örneğin kaynak kimliği.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır).

properties.instancePoolId

string

Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği.

properties.isGeneralPurposeV2

boolean

Bunun Genel Amaçlı sürümün GPv2 çeşitlemesi olup olmadığı.

properties.keyId

string

Şifreleme için kullanılacak anahtarın CMK URI'si.

properties.licenseType

ManagedInstanceLicenseType

Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).

properties.maintenanceConfigurationId

string

Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.

properties.memorySizeInGB

integer (int32)

GB cinsinden bellek boyutu. Minimum değer: 28. En büyük değer: 870. En düşük ve en yüksek değer, sanal çekirdek sayısına ve hizmet katmanına bağlıdır. Kaynak sınırları hakkında daha fazla bilgi edinin: https://aka.ms/mi-resource-limits-api.

properties.minimalTlsVersion

string

En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2'

properties.pricingModel

PricingModel

Managed Instance'ın fiyatlandırma modeli.

properties.primaryUserAssignedIdentityId

string (arm-id)

Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.

properties.proxyOverride

ManagedInstanceProxyOverride

Örneğe bağlanmak için kullanılan bağlantı türü.

properties.publicDataEndpointEnabled

boolean

Genel veri uç noktasının etkinleştirilip etkinleştirilmediği.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Bu örneğe yönelik yedeklemeleri depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

Managed Instance'ın sabitlendiği mantıksal erişilebilirlik bölgesini belirtir.

properties.restorePointInTime

string (date-time)

Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir.

properties.servicePrincipal

ServicePrincipal

Yönetilen örneğin hizmet sorumlusu.

properties.sourceManagedInstanceId

string (arm-id)

Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı.

properties.storageIOps

integer (int32)

Depolama IOps'si. En düşük değer: 300. Maksimum değer: 80000. Yalnızca 1 IOps artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.

properties.storageSizeInGB

integer (int32)

GB cinsinden depolama boyutu. En düşük değer: 32. En büyük değer: 32768. Yalnızca 32 GB'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.

properties.storageThroughputMBps

integer (int32)

Depolama aktarım hızı MB/sn parametresi örnek oluşturma/güncelleştirme işleminde desteklenmez.

properties.subnetId

string (arm-id)

Yönetilen örneğin alt ağ kaynak kimliği.

properties.timezoneId

string

Saat diliminin kimliği. İzin verilen değerler, Windows tarafından desteklenen zaman dilimleridir. Windows, desteklenen saat dilimleri, kimlik dahil olmak üzere, KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones altında kayıt defterinde tutar. Bu kayıt değerlerini SQL Server üzerinden alabilirsiniz; sys.time_zone_info'dan SELECT ismi AS timezone_id AS SELECT sorgusu yaparak sorgulayabilirsiniz. Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir. Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".

properties.vCores

integer (int32)

Sanal çekirdek sayısı. İzin verilen değerler: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Desteklenen sanal çekirdekler, seçilen donanım ailesine ve hizmet katmanına bağlıdır.

properties.zoneRedundant

boolean

Bölge yedekliliğinin etkinleştirilip etkinleştirilmediği.

sku

Sku

Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5 (Genel Amaçlı, Standart seri); GP_G8IM (Genel Amaçlı, Premium seri); GP_G8IH (Genel Amaçlı, Premium serisi bellek için optimize edilmiş); BC_Gen5 (İş Açısından Kritik, Standard-Series); BC_G8IM (İş Açısından Kritik, Premium seri); BC_G8IH (İş Açısından Kritik, Premium serisi bellek için iyileştirilmiş).

tags

object

Kaynak etiketleri.

Yanıtlar

Name Tür Description
200 OK

ManagedInstance

Resource 'ManagedInstance' güncelleme işlemi başarılı oldu

201 Created

ManagedInstance

Resource 'ManagedInstance' create operation succeeded

Üst Bilgiler

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

Kaynak işlemi kabul edildi.

Üst Bilgiler

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

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

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

Create managed instance with all properties

Örnek isteği

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

Örnek yanıt

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

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
AdministratorType

Sunucu yöneticisinin türü.

AuthMetadataLookupModes

Yönetilen örneğin kimlik doğrulaması meta veri arama modu.

AvailabilityZoneType

Veritabanının sabitlendiği kullanılabilirlik bölgesini belirtir.

BackupStorageRedundancy

Bu veritabanı için yedeklemeleri depolamak için kullanılan depolama hesabı türü.

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

ExternalGovernanceStatus

Dış idarenin durumu.

HybridSecondaryUsage

Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır).

HybridSecondaryUsageDetected

Karma ikincil kullanım algılandı. Olası değerler 'Etkin' (müşteri ikincil dr'yi Pasif DR olarak kullanma gereksinimlerini karşılamaz) ve 'Pasif' (müşteri ikincil dr'yi Pasif DR olarak kullanma gereksinimlerini karşılar).

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory ana özelliği oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

ManagedInstance

Azure SQL yönetilen bir instance.

ManagedInstanceDatabaseFormat

SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir.

ManagedInstanceExternalAdministrator

Active Directory yöneticisinin özellikleri.

ManagedInstanceLicenseType

Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).

ManagedInstancePecProperty

Yönetilen örnek altında özel uç nokta bağlantısı

ManagedInstancePrivateEndpointConnectionProperties

Özel uç nokta bağlantısının özellikleri.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Örneğe bağlanmak için kullanılan bağlantı türü.

ManagedServerCreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.

PricingModel

Managed Instance'ın fiyatlandırma modeli.

PrincipalType

Sunucu yöneticisinin Asıl Türü.

ProvisioningState

İş yürütmenin ARM sağlama durumu.

ResourceIdentity

Azure Active Directory identity configuration for a resource.

ServicePrincipal

Yönetilen örneğin bir kaynak için hizmet sorumlusu yapılandırması.

ServicePrincipalType

Hizmet sorumlusu türü.

Sku

ARM Kaynağı SKU'su.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

UserIdentity

Azure Active Directory identity configuration for a resource.

AdministratorType

Sunucu yöneticisinin türü.

Değer Description
ActiveDirectory

ActiveDirectory (ActiveDirectory)

AuthMetadataLookupModes

Yönetilen örneğin kimlik doğrulaması meta veri arama modu.

Değer Description
AzureAD

AzureAD

Paired

Çift

Windows

Windows

AvailabilityZoneType

Veritabanının sabitlendiği kullanılabilirlik bölgesini belirtir.

Değer Description
NoPreference

Tercih Yok

1

1

2

2

3

3

BackupStorageRedundancy

Bu veritabanı için yedeklemeleri depolamak için kullanılan depolama hesabı türü.

Değer Description
Geo

Coğrafya

Local

Yerel

Zone

Bölge

GeoZone

GeoZone

createdByType

Kaynağı oluşturan kimliğin türü.

Değer Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

ExternalGovernanceStatus

Dış idarenin durumu.

Değer Description
Enabled

Enabled

Disabled

Disabled

HybridSecondaryUsage

Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır).

Değer Description
Active

Aktif

Passive

Passive

HybridSecondaryUsageDetected

Karma ikincil kullanım algılandı. Olası değerler 'Etkin' (müşteri ikincil dr'yi Pasif DR olarak kullanma gereksinimlerini karşılamaz) ve 'Pasif' (müşteri ikincil dr'yi Pasif DR olarak kullanma gereksinimlerini karşılar).

Değer Description
Active

Aktif

Passive

Passive

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory ana özelliği oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

Değer Description
None

Hiçbiri

SystemAssigned

Sistem Ataması

UserAssigned

UserAssigned

SystemAssigned,UserAssigned

SystemAssigned,UserAssigned

ManagedInstance

Azure SQL yönetilen bir instance.

Name Tür Description
id

string (arm-id)

Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ResourceIdentity

Yönetilen örneğin Azure Active Directory kimliği.

location

string

Kaynağın bulunduğu coğrafi konum

name

string

Kaynağın adı

properties.administratorLogin

string

Yönetilen örnek için yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir).

properties.administratorLoginPassword

string (password)

Yönetici oturum açma parolası (yönetilen örnek oluşturma için gereklidir).

properties.administrators

ManagedInstanceExternalAdministrator

Azure Active Directory yöneticisi, örnek oluşturma ve örnek güncellemeleri sırasında kullanılabilir, azureADOnlyAuthentication özelliği hariç. azureADOnlyAuthentication özelliğini güncelleştirmek için tek tek API'nin kullanılması gerekir.

properties.authenticationMetadata

AuthMetadataLookupModes

Yönetilen örneğin kimlik doğrulaması meta veri arama modu.

properties.collation

string

Yönetilen örneğin harmanlanması.

properties.createTime

string (date-time)

Managed Instance oluşturulmasının zaman noktasını (ISO8601 formatını) belirtir.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Bu örneğe yönelik yedeklemeleri depolamak için kullanılan depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)

properties.databaseFormat

ManagedInstanceDatabaseFormat

SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir.

properties.dnsZone

string

Yönetilen örneğin içinde olduğu Dns Bölgesi.

properties.dnsZonePartner

string (arm-id)

Bu yönetilen örneğin dns bölgesi oluşturulduktan sonra paylaşılacak başka bir yönetilen örneğin kaynak kimliği.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Dış idarenin durumu.

properties.fullyQualifiedDomainName

string

Yönetilen örneğin tam etki alanı adı.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Karma ikincil kullanım. Olası değerler 'Etkin' (varsayılan değer) ve 'Pasif' değerleridir (müşteri ikincil değeri Pasif DR olarak kullanır).

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

Karma ikincil kullanım algılandı. Olası değerler 'Etkin' (müşteri ikincil dr'yi Pasif DR olarak kullanma gereksinimlerini karşılamaz) ve 'Pasif' (müşteri ikincil dr'yi Pasif DR olarak kullanma gereksinimlerini karşılar).

properties.instancePoolId

string

Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği.

properties.isGeneralPurposeV2

boolean

Bunun Genel Amaçlı sürümün GPv2 çeşitlemesi olup olmadığı.

properties.keyId

string

Şifreleme için kullanılacak anahtarın CMK URI'si.

properties.licenseType

ManagedInstanceLicenseType

Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).

properties.maintenanceConfigurationId

string

Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.

properties.memorySizeInGB

integer (int32)

GB cinsinden bellek boyutu. Minimum değer: 28. En büyük değer: 870. En düşük ve en yüksek değer, sanal çekirdek sayısına ve hizmet katmanına bağlıdır. Kaynak sınırları hakkında daha fazla bilgi edinin: https://aka.ms/mi-resource-limits-api.

properties.minimalTlsVersion

string

En düşük TLS sürümü. İzin verilen değerler: 'Hiçbiri', '1.0', '1.1', '1.2'

properties.pricingModel

PricingModel

Managed Instance'ın fiyatlandırma modeli.

properties.primaryUserAssignedIdentityId

string (arm-id)

Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Yönetilen örnekteki özel uç nokta bağlantılarının listesi.

properties.provisioningState

ProvisioningState

Yönetilen örneğin sağlama durumu.

properties.proxyOverride

ManagedInstanceProxyOverride

Örneğe bağlanmak için kullanılan bağlantı türü.

properties.publicDataEndpointEnabled

boolean

Genel veri uç noktasının etkinleştirilip etkinleştirilmediği.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Bu örneğe yönelik yedeklemeleri depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage)

properties.requestedLogicalAvailabilityZone

AvailabilityZoneType

Managed Instance'ın sabitlendiği mantıksal erişilebilirlik bölgesini belirtir.

properties.restorePointInTime

string (date-time)

Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir.

properties.servicePrincipal

ServicePrincipal

Yönetilen örneğin hizmet sorumlusu.

properties.sourceManagedInstanceId

string (arm-id)

Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı.

properties.state

string

Yönetilen örneğin durumu.

properties.storageIOps

integer (int32)

Depolama IOps'si. En düşük değer: 300. Maksimum değer: 80000. Yalnızca 1 IOps artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.

properties.storageSizeInGB

integer (int32)

GB cinsinden depolama boyutu. En düşük değer: 32. En büyük değer: 32768. Yalnızca 32 GB'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır.

properties.storageThroughputMBps

integer (int32)

Depolama aktarım hızı MB/sn parametresi örnek oluşturma/güncelleştirme işleminde desteklenmez.

properties.subnetId

string (arm-id)

Yönetilen örneğin alt ağ kaynak kimliği.

properties.timezoneId

string

Saat diliminin kimliği. İzin verilen değerler, Windows tarafından desteklenen zaman dilimleridir. Windows, desteklenen saat dilimleri, kimlik dahil olmak üzere, KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones altında kayıt defterinde tutar. Bu kayıt değerlerini SQL Server üzerinden alabilirsiniz; sys.time_zone_info'dan SELECT ismi AS timezone_id AS SELECT sorgusu yaparak sorgulayabilirsiniz. Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir. Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".

properties.vCores

integer (int32)

Sanal çekirdek sayısı. İzin verilen değerler: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Desteklenen sanal çekirdekler, seçilen donanım ailesine ve hizmet katmanına bağlıdır.

properties.virtualClusterId

string

Managed Instance için sanal küme kaynak kimliği.

properties.zoneRedundant

boolean

Bölge yedekliliğinin etkinleştirilip etkinleştirilmediği.

sku

Sku

Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5 (Genel Amaçlı, Standart seri); GP_G8IM (Genel Amaçlı, Premium seri); GP_G8IH (Genel Amaçlı, Premium serisi bellek için optimize edilmiş); BC_Gen5 (İş Açısından Kritik, Standard-Series); BC_G8IM (İş Açısından Kritik, Premium seri); BC_G8IH (İş Açısından Kritik, Premium serisi bellek için iyileştirilmiş).

systemData

systemData

Azure Resource Manager metadata içeren createdBy ve modifiedBy bilgileri.

tags

object

Kaynak etiketleri.

type

string

Kaynağın türü. Örneğin "Microsoft. Compute/virtualMachines" veya "Microsoft. Depo/Depolama Hesapları"

ManagedInstanceDatabaseFormat

SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir.

Değer Description
AlwaysUpToDate

AlwaysUpdateToDate

SQLServer2022

SQLServer2022

SQLServer2025

SQLServer2025

ManagedInstanceExternalAdministrator

Active Directory yöneticisinin özellikleri.

Name Tür Description
administratorType

AdministratorType

Sunucu yöneticisinin türü.

azureADOnlyAuthentication

boolean

Azure Active Directory Yalnızca Authentication etkin.

login

string

Sunucu yöneticisinin oturum açma adı.

principalType

PrincipalType

Sunucu yöneticisinin Asıl Türü.

sid

string (uuid)

Sunucu yöneticisinin SID (nesne kimliği).

tenantId

string (uuid)

Yöneticinin Kiracı Kimliği.

ManagedInstanceLicenseType

Lisans türü. Olası değerler şunlardır: 'LicenseIncludded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı).

Değer Description
LicenseIncluded

Lisans Dahil

BasePrice

BasePrice

ManagedInstancePecProperty

Yönetilen örnek altında özel uç nokta bağlantısı

Name Tür Description
id

string

Kaynak Kimliği.

properties

ManagedInstancePrivateEndpointConnectionProperties

Özel uç nokta bağlantı özellikleri

ManagedInstancePrivateEndpointConnectionProperties

Özel uç nokta bağlantısının özellikleri.

Name Tür Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Bağlantının ait olduğu özel uç nokta.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Özel Uç Nokta Bağlantısının Bağlantı Durumu.

provisioningState

string

Özel Uç Nokta Bağlantısının Durumu.

ManagedInstancePrivateEndpointProperty

Name Tür Description
id

string

Özel uç noktanın kaynak kimliği.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Tür Description
actionsRequired

string

Özel bağlantı hizmeti bağlantı açıklaması.

description

string

Özel bağlantı hizmeti bağlantı açıklaması.

status

string

Özel bağlantı hizmeti bağlantı durumu.

ManagedInstanceProxyOverride

Örneğe bağlanmak için kullanılan bağlantı türü.

Değer Description
Proxy

Proxy

Redirect

Yönlendir

Default

Varsayılan

ManagedServerCreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.

Değer Description
Default

Varsayılan

PointInTimeRestore

PointInTimeRestore

PricingModel

Managed Instance'ın fiyatlandırma modeli.

Değer Description
Regular

Düzenli

Freemium

Freemium

PrincipalType

Sunucu yöneticisinin Asıl Türü.

Değer Description
User

User

Group

Grup

Application

Başvuru

ProvisioningState

İş yürütmenin ARM sağlama durumu.

Değer Description
Created

Oluşturuldu

InProgress

Devam Ediyor

Succeeded

Succeeded

Failed

Başarısız oldu

Canceled

İptal edildi

ResourceIdentity

Azure Active Directory identity configuration for a resource.

Name Tür Description
principalId

string (uuid)

Azure Active Directory principal id.

tenantId

string (uuid)

Azure Active Directory tenant id.

type

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory ana özelliği oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

userAssignedIdentities

<string,  UserIdentity>

Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

ServicePrincipal

Yönetilen örneğin bir kaynak için hizmet sorumlusu yapılandırması.

Name Tür Description
clientId

string

Azure Active Directory uygulama istemci kimliği.

principalId

string

Azure Active Directory application object id.

tenantId

string

Azure Active Directory tenant id.

type

ServicePrincipalType

Hizmet sorumlusu türü.

ServicePrincipalType

Hizmet sorumlusu türü.

Değer Description
None

Hiçbiri

SystemAssigned

Sistem Ataması

Sku

ARM Kaynağı SKU'su.

Name Tür Description
capacity

integer (int32)

Belirli bir SKU'nun kapasitesi.

family

string

Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir.

name

string

SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.

size

string

Belirli SKU'nun boyutu

tier

string

Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string (date-time)

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

UserIdentity

Azure Active Directory identity configuration for a resource.

Name Tür Description
clientId

string (uuid)

Azure Active Directory istemci kimliği.

principalId

string (uuid)

Azure Active Directory principal id.