Managed Instances - Create Or Update

Servicio:: SQL Database

Versión de la API:: 2025-01-01

Crea o actualiza una instancia administrada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
managedInstanceName	path	True	string	Nombre de la instancia administrada.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
identity		ResourceIdentity	La identidad de Azure Active Directory de la instancia gestionada.
properties.administratorLogin		string	Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesaria para la creación).
properties.administratorLoginPassword		string (password)	La contraseña de inicio de sesión del administrador (necesaria para la creación de la instancia administrada).
properties.administrators		ManagedInstanceExternalAdministrator	El administrador de Azure Active Directory puede utilizarse durante la creación de instancias y para actualizaciones de instancias, excepto la propiedad azureADOnlyAuthentication. Para actualizar la propiedad azureADOnlyAuthentication, se debe usar una API individual.
properties.authenticationMetadata		AuthMetadataLookupModes	Modo de búsqueda de metadatos de autenticación de la instancia administrada.
properties.collation		string	Intercalación de la instancia administrada.
properties.databaseFormat		ManagedInstanceDatabaseFormat	Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.
properties.dnsZonePartner		string (arm-id)	Identificador de recurso de otra instancia administrada cuya zona DNS compartirá esta instancia administrada después de la creación.
properties.hybridSecondaryUsage		HybridSecondaryUsage	Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).
properties.instancePoolId		string	Identificador del grupo de instancias al que pertenece este servidor administrado.
properties.isGeneralPurposeV2		boolean	Indica si se trata de una variante GPv2 de la edición De uso general.
properties.keyId		string	URI de CMK de la clave que se va a usar para el cifrado.
properties.licenseType		ManagedInstanceLicenseType	Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).
properties.maintenanceConfigurationId		string	Especifica el identificador de configuración de mantenimiento que se aplicará a esta instancia administrada.
properties.managedInstanceCreateMode		ManagedServerCreateMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación de instancias normales. Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.
properties.memorySizeInGB		integer (int32)	Tamaño de la memoria en GB. Valor mínimo: 28. Valor máximo: 870. El valor mínimo y máximo depende del número de núcleos virtuales y del nivel de servicio. Lea más sobre los límites de recursos: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion		string	Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'
properties.pricingModel		PricingModel	Modelo de precios de Instancia administrada.
properties.primaryUserAssignedIdentityId		string (arm-id)	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.
properties.proxyOverride		ManagedInstanceProxyOverride	Tipo de conexión que se usa para conectarse a la instancia.
properties.publicDataEndpointEnabled		boolean	Si el punto de conexión de datos público está habilitado o no.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad para esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Especifica la zona de disponibilidad lógica a la que está fijada Instancia administrada.
properties.restorePointInTime		string (date-time)	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.
properties.servicePrincipal		ServicePrincipal	La entidad de servicio de la instancia administrada.
properties.sourceManagedInstanceId		string (arm-id)	Identificador de recurso de la instancia administrada de origen asociada a la operación de creación de esta instancia.
properties.storageIOps		integer (int32)	IOps de almacenamiento. Valor mínimo: 300. Valor máximo: 80000. Solo se permiten incrementos de 1 IOps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.
properties.storageSizeInGB		integer (int32)	Tamaño de almacenamiento en GB. Valor mínimo: 32. Valor máximo: 32768. Solo se permiten incrementos de 32 GB. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.
properties.storageThroughputMBps		integer (int32)	El parámetro MBps de rendimiento de almacenamiento no se admite en la operación de creación o actualización de la instancia.
properties.subnetId		string (arm-id)	Identificador de recurso de subred para la instancia administrada.
properties.timezoneId		string	Id. de la zona horaria. Los valores permitidos son zonas horarias soportadas por Windows. Windows guarda los detalles de las zonas horarias soportadas, incluido el id, en el registro bajo KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Puedes obtener esos valores de registro a través de SQL Server consultando el nombre SELECT COMO timezone_id DESDE sys.time_zone_info. También se puede obtener la lista de identificadores ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Un ejemplo de identificador de zona horaria válido es "Hora estándar del Pacífico" o "W. Hora estándar de Europa".
properties.vCores		integer (int32)	Número de núcleos virtuales. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Los núcleos virtuales admitidos dependen de la familia de hardware y el nivel de servicio seleccionados.
properties.zoneRedundant		boolean	Si la redundancia de zona está habilitada o no.
sku		Sku	SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5 (uso general, serie estándar); GP_G8IM (Propósito general, serie Premium); GP_G8IH (Propósito general, memoria de la serie Premium optimizada); BC_Gen5 (Crítico para el negocio, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Crítico para la empresa, optimizado para la memoria de la serie Premium).
tags		object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedInstance	Operación de actualización de recursos 'ManagedInstance' exitosa
201 Created	ManagedInstance	Recurso 'ManagedInstance' crear operación exitosa Encabezados Location: string Retry-After: integer
202 Accepted		Operación de recursos aceptada. Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
  }
}

status code:: 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"
  }
}

status code:: 202

Create managed instance with minimal properties

Solicitud de ejemplo

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

Respuesta de muestra

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

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

status code:: 202

Definiciones

Nombre	Description
AdministratorType	Tipo del administrador del servidor.
AuthMetadataLookupModes	Modo de búsqueda de metadatos de autenticación de la instancia administrada.
AvailabilityZoneType	Especifica la zona de disponibilidad a la que está anclada la base de datos.
BackupStorageRedundancy	Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ExternalGovernanceStatus	Estado de la gobernanza externa.
HybridSecondaryUsage	Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).
HybridSecondaryUsageDetected	Se detectó el uso secundario híbrido. Los valores posibles son "Activo" (el cliente no cumple los requisitos para usar la recuperación ante desastres pasivas) y "Pasivo" (el cliente cumple los requisitos para usar la recuperación ante desastres pasiva).
IdentityType	Tipo de identidad. Configura esto en 'SystemAssigned' para crear y asignar automáticamente un principal de Azure Active Directory para el recurso.
ManagedInstance	Una instancia gestionada de Azure SQL.
ManagedInstanceDatabaseFormat	Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.
ManagedInstanceExternalAdministrator	Propiedades de un administrador de Active Directory.
ManagedInstanceLicenseType	Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).
ManagedInstancePecProperty	Una conexión de punto de conexión privado en una instancia administrada
ManagedInstancePrivateEndpointConnectionProperties	Propiedades de una conexión de punto de conexión privado.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Tipo de conexión que se usa para conectarse a la instancia.
ManagedServerCreateMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación de instancias normales. Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.
PricingModel	Modelo de precios de Instancia administrada.
PrincipalType	Tipo de entidad de seguridad del administrador del servidor.
ProvisioningState	Estado de aprovisionamiento de ARM de la ejecución del trabajo.
ResourceIdentity	Configuración de identidad de Azure Active Directory para un recurso.
ServicePrincipal	Configuración de la entidad de servicio de la instancia administrada para un recurso.
ServicePrincipalType	Tipo de entidad de servicio.
Sku	Una SKU de recursos de ARM.
systemData	Metadatos relativos a la creación y última modificación del recurso.
UserIdentity	Configuración de identidad de Azure Active Directory para un recurso.

AdministratorType

Enumeración

Tipo del administrador del servidor.

Valor	Description
ActiveDirectory	Directorio Activo

AuthMetadataLookupModes

Enumeración

Modo de búsqueda de metadatos de autenticación de la instancia administrada.

Valor	Description
AzureAD	AzureAD
Paired	Emparejado
Windows	Windows

AvailabilityZoneType

Enumeración

Especifica la zona de disponibilidad a la que está anclada la base de datos.

Valor	Description
NoPreference	NoPreference
1	1
2	2
3	3

BackupStorageRedundancy

Enumeración

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

Valor	Description
Geo	Geo
Local	Local
Zone	Zona
GeoZone	GeoZone

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ExternalGovernanceStatus

Enumeración

Estado de la gobernanza externa.

Valor	Description
Enabled	Habilitado
Disabled	Deshabilitado

HybridSecondaryUsage

Enumeración

Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).

Valor	Description
Active	Activo
Passive	Pasivo

HybridSecondaryUsageDetected

Enumeración

Se detectó el uso secundario híbrido. Los valores posibles son "Activo" (el cliente no cumple los requisitos para usar la recuperación ante desastres pasivas) y "Pasivo" (el cliente cumple los requisitos para usar la recuperación ante desastres pasiva).

Valor	Description
Active	Activo
Passive	Pasivo

IdentityType

Enumeración

Tipo de identidad. Configura esto en 'SystemAssigned' para crear y asignar automáticamente un principal de Azure Active Directory para el recurso.

Valor	Description
None	Ninguno
SystemAssigned	AsignadoPorElSistema
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned, UserAssigned

ManagedInstance

Objeto

Una instancia gestionada de Azure SQL.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	La identidad de Azure Active Directory de la instancia gestionada.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.administratorLogin	string	Nombre de usuario del administrador para la instancia administrada. Solo se puede especificar cuando se crea la instancia administrada (y es necesaria para la creación).
properties.administratorLoginPassword	string (password)	La contraseña de inicio de sesión del administrador (necesaria para la creación de la instancia administrada).
properties.administrators	ManagedInstanceExternalAdministrator	El administrador de Azure Active Directory puede utilizarse durante la creación de instancias y para actualizaciones de instancias, excepto la propiedad azureADOnlyAuthentication. Para actualizar la propiedad azureADOnlyAuthentication, se debe usar una API individual.
properties.authenticationMetadata	AuthMetadataLookupModes	Modo de búsqueda de metadatos de autenticación de la instancia administrada.
properties.collation	string	Intercalación de la instancia administrada.
properties.createTime	string (date-time)	Especifica el momento en el tiempo (formato ISO8601) de la creación de la Instancia administrada.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad para esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.
properties.dnsZone	string	Zona DNS en la que se encuentra la instancia administrada.
properties.dnsZonePartner	string (arm-id)	Identificador de recurso de otra instancia administrada cuya zona DNS compartirá esta instancia administrada después de la creación.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Estado de la gobernanza externa.
properties.fullyQualifiedDomainName	string	Nombre de dominio completo de la instancia administrada.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Uso secundario híbrido. Los valores posibles son "Activo" (valor predeterminado) y "Pasivo" (el cliente usa la secundaria como recuperación ante desastres pasivas).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Se detectó el uso secundario híbrido. Los valores posibles son "Activo" (el cliente no cumple los requisitos para usar la recuperación ante desastres pasivas) y "Pasivo" (el cliente cumple los requisitos para usar la recuperación ante desastres pasiva).
properties.instancePoolId	string	Identificador del grupo de instancias al que pertenece este servidor administrado.
properties.isGeneralPurposeV2	boolean	Indica si se trata de una variante GPv2 de la edición De uso general.
properties.keyId	string	URI de CMK de la clave que se va a usar para el cifrado.
properties.licenseType	ManagedInstanceLicenseType	Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).
properties.maintenanceConfigurationId	string	Especifica el identificador de configuración de mantenimiento que se aplicará a esta instancia administrada.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Especifica el modo de creación de la base de datos. Valor predeterminado: creación de instancias normales. Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.
properties.memorySizeInGB	integer (int32)	Tamaño de la memoria en GB. Valor mínimo: 28. Valor máximo: 870. El valor mínimo y máximo depende del número de núcleos virtuales y del nivel de servicio. Lea más sobre los límites de recursos: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion	string	Versión mínima de TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'
properties.pricingModel	PricingModel	Modelo de precios de Instancia administrada.
properties.primaryUserAssignedIdentityId	string (arm-id)	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Lista de conexiones de punto de conexión privado en una instancia administrada.
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento de la instancia administrada.
properties.proxyOverride	ManagedInstanceProxyOverride	Tipo de conexión que se usa para conectarse a la instancia.
properties.publicDataEndpointEnabled	boolean	Si el punto de conexión de datos público está habilitado o no.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad para esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)
properties.requestedLogicalAvailabilityZone	AvailabilityZoneType	Especifica la zona de disponibilidad lógica a la que está fijada Instancia administrada.
properties.restorePointInTime	string (date-time)	Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.
properties.servicePrincipal	ServicePrincipal	La entidad de servicio de la instancia administrada.
properties.sourceManagedInstanceId	string (arm-id)	Identificador de recurso de la instancia administrada de origen asociada a la operación de creación de esta instancia.
properties.state	string	Estado de la instancia administrada.
properties.storageIOps	integer (int32)	IOps de almacenamiento. Valor mínimo: 300. Valor máximo: 80000. Solo se permiten incrementos de 1 IOps. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.
properties.storageSizeInGB	integer (int32)	Tamaño de almacenamiento en GB. Valor mínimo: 32. Valor máximo: 32768. Solo se permiten incrementos de 32 GB. El valor máximo depende de la familia de hardware seleccionada y del número de núcleos virtuales.
properties.storageThroughputMBps	integer (int32)	El parámetro MBps de rendimiento de almacenamiento no se admite en la operación de creación o actualización de la instancia.
properties.subnetId	string (arm-id)	Identificador de recurso de subred para la instancia administrada.
properties.timezoneId	string	Id. de la zona horaria. Los valores permitidos son zonas horarias soportadas por Windows. Windows guarda los detalles de las zonas horarias soportadas, incluido el id, en el registro bajo KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Puedes obtener esos valores de registro a través de SQL Server consultando el nombre SELECT COMO timezone_id DESDE sys.time_zone_info. También se puede obtener la lista de identificadores ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Un ejemplo de identificador de zona horaria válido es "Hora estándar del Pacífico" o "W. Hora estándar de Europa".
properties.vCores	integer (int32)	Número de núcleos virtuales. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Los núcleos virtuales admitidos dependen de la familia de hardware y el nivel de servicio seleccionados.
properties.virtualClusterId	string	ID de recurso del clúster virtual para la Instancia administrada.
properties.zoneRedundant	boolean	Si la redundancia de zona está habilitada o no.
sku	Sku	SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5 (uso general, serie estándar); GP_G8IM (Propósito general, serie Premium); GP_G8IH (Propósito general, memoria de la serie Premium optimizada); BC_Gen5 (Crítico para el negocio, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Crítico para la empresa, optimizado para la memoria de la serie Premium).
systemData	systemData	Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento"

ManagedInstanceDatabaseFormat

Enumeración

Especifica el formato interno de las bases de datos de instancia específicas de la versión del motor de SQL.

Valor	Description
AlwaysUpToDate	Siempre al día
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Objeto

Propiedades de un administrador de Active Directory.

Nombre	Tipo	Description
administratorType	AdministratorType	Tipo del administrador del servidor.
azureADOnlyAuthentication	boolean	Solo Azure Active Directory Autenticación habilitada.
login	string	Nombre de inicio de sesión del administrador del servidor.
principalType	PrincipalType	Tipo de entidad de seguridad del administrador del servidor.
sid	string (uuid)	SID (id. de objeto) del administrador del servidor.
tenantId	string (uuid)	Identificador de inquilino del administrador.

ManagedInstanceLicenseType

Enumeración

Tipo de licencia. Los valores posibles son "LicenseIncluded" (precio normal incluido de una nueva licencia de SQL) y "BasePrice" (precio de AHB con descuento para traer sus propias licencias sql).

Valor	Description
LicenseIncluded	LicenciaIncluido
BasePrice	BasePrice

ManagedInstancePecProperty

Objeto

Una conexión de punto de conexión privado en una instancia administrada

Nombre	Tipo	Description
id	string	Identificador de recurso.
properties	ManagedInstancePrivateEndpointConnectionProperties	Propiedades de conexión de punto de conexión privado

ManagedInstancePrivateEndpointConnectionProperties

Objeto

Propiedades de una conexión de punto de conexión privado.

Nombre	Tipo	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Punto de conexión privado al que pertenece la conexión.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Estado de conexión de la conexión de punto de conexión privado.
provisioningState	string	Estado de la conexión de punto de conexión privado.

ManagedInstancePrivateEndpointProperty

Objeto

Nombre	Tipo	Description
id	string	Identificador de recurso del punto de conexión privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objeto

Nombre	Tipo	Description
actionsRequired	string	Descripción de la conexión del servicio private link.
description	string	Descripción de la conexión del servicio private link.
status	string	Estado de conexión del servicio private link.

ManagedInstanceProxyOverride

Enumeración

Tipo de conexión que se usa para conectarse a la instancia.

Valor	Description
Proxy	Proxy
Redirect	Redirigir
Default	Predeterminado

ManagedServerCreateMode

Enumeración

Especifica el modo de creación de la base de datos.

Valor predeterminado: creación de instancias normales.

Restaurar: crea una instancia restaurando un conjunto de copias de seguridad a un momento dado específico. Se debe especificar RestorePointInTime y SourceManagedInstanceId.

Valor	Description
Default	Predeterminado
PointInTimeRestore	PointInTimeRestore

PricingModel

Enumeración

Modelo de precios de Instancia administrada.

Valor	Description
Regular	Regular
Freemium	Precios Freemium

PrincipalType

Enumeración

Tipo de entidad de seguridad del administrador del servidor.

Valor	Description
User	Usuario
Group	Grupo
Application	Aplicación

ProvisioningState

Enumeración

Estado de aprovisionamiento de ARM de la ejecución del trabajo.

Valor	Description
Created	Creado
InProgress	En Progreso
Succeeded	Succeeded
Failed	Fallido
Canceled	Cancelado

ResourceIdentity

Objeto

Configuración de identidad de Azure Active Directory para un recurso.

Nombre	Tipo	Description
principalId	string (uuid)	El id principal de Azure Active Directory.
tenantId	string (uuid)	El ID de tenant de Azure Active Directory.
type	IdentityType	Tipo de identidad. Configura esto en 'SystemAssigned' para crear y asignar automáticamente un principal de Azure Active Directory para el recurso.
userAssignedIdentities	<string, UserIdentity>	Identificadores de recursos de las identidades asignadas por el usuario que se van a usar

ServicePrincipal

Objeto

Configuración de la entidad de servicio de la instancia administrada para un recurso.

Nombre	Tipo	Description
clientId	string	El ID de cliente de la aplicación de Azure Active Directory.
principalId	string	El ID de objeto de aplicación de Azure Active Directory.
tenantId	string	El ID de tenant de Azure Active Directory.
type	ServicePrincipalType	Tipo de entidad de servicio.

ServicePrincipalType

Enumeración

Tipo de entidad de servicio.

Valor	Description
None	Ninguno
SystemAssigned	AsignadoPorElSistema

Sku

Objeto

Una SKU de recursos de ARM.

Nombre	Tipo	Description
capacity	integer (int32)	Capacidad de la SKU determinada.
family	string	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.
name	string	El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3.
size	string	Tamaño de la SKU determinada
tier	string	Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	La marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UserIdentity

Objeto

Configuración de identidad de Azure Active Directory para un recurso.

Nombre	Tipo	Description
clientId	string (uuid)	El id del cliente de Azure Active Directory.
principalId	string (uuid)	El id principal de Azure Active Directory.