Compartir a través de

Managed Instances - Get

  • Referencia
Servicio:
SQL Database
Versión de la API:
2023-08-01

Obtiene una instancia administrada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2023-08-01
Con parámetros opcionales: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2023-08-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
managedInstanceName
 path True

string

Nombre de la instancia administrada.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
subscriptionId
 path True

string

Identificador de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

Versión de la API que se va a usar para la solicitud.
$expand
 query

string

Los recursos secundarios que se van a incluir en la respuesta.

Respuestas

Nombre Tipo Description
200 OK

ManagedInstance

Se recuperó correctamente la instancia administrada especificada.
Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 400 SubredMissingRequiredDelegation: la subred seleccionada no está delegada para SQL Managed Instance.

  • 400 ManagementServiceManagedServerDisabled: error en la operación, ya que la instancia administrada '{0}' está deshabilitada. Habilite Instancia administrada e inténtelo de nuevo.

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy: no se permite Geo-Restore para instancias administradas con redundancia de almacenamiento de copia de seguridad LRS/ZRS.

  • 400 LastBackupNameHasNewline: no use caracteres prohibidos ('\n', '\r') en lastBackupName.

  • 400 LastBackupNameHasNonAsciiCharacter: la operación se anuló porque el parámetro "LastBackupName" contiene caracteres no válidos. Solo se permiten caracteres ASCII.

  • 400 ProvisioningDisabled: muestra el mensaje de error del autorizador de operaciones de recursos tal como está, sin cambios

  • 400 LRSCutoverDatabaseDoesNotExist: la operación se anuló porque el nombre de la base de datos especificado en la solicitud no coincide con ningún nombre de base de datos en el servidor especificado.

  • 400 LRSCutoverDatabaseNotInRestoringState: la operación se anuló porque la base de datos especificada no está en estado de restauración.

  • 400 LRSCutoverDatabaseAlreadyRestored: la operación se anuló porque la base de datos especificada ya se restauró.

  • 400 LRSCutoverAlreadyInitiated: la operación se anuló porque ya hay una transición para la base de datos especificada.

  • 400 ManagementServiceFeatureDisabled: el usuario intentó usar una característica que está deshabilitada.

  • 400 AadOnlyAuthenticationIsEnabled: la autenticación solo de Azure Active Directory está habilitada. Póngase en contacto con el administrador del sistema.

  • 400 UpdatingInstanceAndBackupRedundancy: la redundancia de zona de instancia y la redundancia de almacenamiento de copia de seguridad no se pueden actualizar en la misma solicitud.

  • 400 DeleteOfManagedInstanceIsDisabled: la operación de eliminación de la instancia administrada está deshabilitada.

  • 400 RequestCantLandOnPaaSv2Platform: la solicitud debe aterrizar en la plataforma PaaSv2, pero PaaSv2 no está habilitada.

  • 400 CustomMaintenanceWindowIsDisabled: la ventana de mantenimiento personalizado no está habilitada.

  • 400 DeleteOfVersion2VirtualClusterIsDisabled: la eliminación del clúster virtual con la versión 2 no está habilitada.

  • 400 DeleteOfVirtualClusterIsDisabled: la eliminación del clúster virtual no está habilitada.

  • 400 MICantBeMovedFromOrToInstancePool: la instancia administrada existente no se puede mover al grupo de instancias administradas.

  • 400 DnsRefreshOnVirtualClusterIsDisabled: la actualización de registros DNS en el clúster virtual no está habilitada.

  • 404 SubscriptionNotFound: no se encontró la suscripción solicitada.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup: la instancia administrada especificada no existe en el grupo de recursos y la suscripción especificados.

  • 404 SubscriptionNotFound: no se encontró la suscripción solicitada.

  • 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 409 MiCreateFailedNonDelegatedSubnet: el usuario intentó implementar instancia administrada o grupo de instancias administradas en la subred que no está delegada en Microsoft.Sql/managedInstances.

  • 409 InstancePoolBusy: un grupo de instancias está ocupado con otra operación en curso

  • 409 ConflictingManagedInstanceOperation: una operación está actualmente en curso para la instancia administrada.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict: la instancia es multi-az, pero el almacenamiento de copia de seguridad se actualiza de redundancia de zona a no con redundancia de zona.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress: no se puede actualizar la redundancia de instancia porque la actualización de redundancia de almacenamiento de copia de seguridad está en curso.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict: el almacenamiento de copia de seguridad no es redundante de zona, pero la redundancia de instancia se está actualizando a redundancia de zona.

  • 409 BackupRedundancyUpdateConflict: no se puede actualizar la redundancia del almacenamiento de copia de seguridad porque ya hay una actualización de redundancia de almacenamiento de copia de seguridad en curso.

  • 409 MiDropFailedOnAuthLocks: el usuario intentó quitar la última instancia administrada en la subred que tiene el bloqueo aplicado en los recursos.

  • 412 InstanceNotReadyForBackupRedundancyUpdate: no se puede actualizar la redundancia del almacenamiento de copia de seguridad porque la instancia no está lista.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 ConflictingSubscriptionOperation: una operación está actualmente en curso para la suscripción.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Get managed instance
Get managed instance while resource is updating
Get managed instance with $expand=administrators/activedirectory

Get managed instance

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01

Respuesta de muestra

status code:
200 
{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance while resource is updating

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01

Respuesta de muestra

status code:
200 
{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Updating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "externalGovernanceStatus": "Enabled",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01

Respuesta de muestra

status code:
200 
{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Definiciones

Nombre Description
AdministratorType

Tipo del administrador del servidor.
AuthMetadataLookupModes

Modo de búsqueda de metadatos de autenticación de la instancia administrada.
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)
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. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.
ManagedInstance

Una instancia administrada 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 la instancia administrada.
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.
UserIdentity

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

AdministratorType

Enumeración

Tipo del administrador del servidor.

Valor Description
ActiveDirectory

AuthMetadataLookupModes

Enumeración

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

Valor Description
AzureAD
Paired
Windows

BackupStorageRedundancy

Enumeración

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)

Valor Description
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

Object

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

Object

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

Mensaje de error.
target

string

Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ExternalGovernanceStatus

Enumeración

Estado de la gobernanza externa.

Valor Description
Disabled
Enabled

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
Passive

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
Passive

IdentityType

Enumeración

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

Valor Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Object

Una instancia administrada de Azure SQL.

Nombre Tipo Description
id

string

Identificador de recurso.
identity

ResourceIdentity

Identidad de Azure Active Directory de la instancia administrada.
location

string

Ubicación del 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

La contraseña de inicio de sesión del administrador (necesaria para la creación de la instancia administrada).
properties.administrators

ManagedInstanceExternalAdministrator

Administrador de Azure Active Directory de la instancia. Esto solo se puede usar en tiempo de creación de instancia. Si se usa para la actualización por ejemplo, se omitirá o se producirá un error. Para las actualizaciones, es necesario usar las API individuales.
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 dado (ISO8601 formato) de la creación de 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.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.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: 16384. 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 compatibles con Windows. Windows mantiene detalles sobre las zonas horarias admitidas, incluido el identificador, en el Registro en KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Para obtener esos valores del Registro a través de SQL Server, consulte SELECT name AS timezone_id FROM 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: 8, 16, 24, 32, 40, 64, 80.
properties.virtualClusterId

string

Identificador de recurso de clúster virtual para instancia administrada.
properties.zoneRedundant

boolean

Indica si el multi-az está habilitado o no.
sku

Sku

SKU de instancia administrada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags

object

Etiquetas de recursos.
type

string

Tipo de recurso.

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
SQLServer2022

ManagedInstanceExternalAdministrator

Object

Propiedades de un administrador de Active Directory.

Nombre Tipo Description
administratorType

AdministratorType

Tipo del administrador del servidor.
azureADOnlyAuthentication

boolean

Autenticación solo de Azure Active Directory 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
BasePrice
LicenseIncluded

ManagedInstancePecProperty

Object

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

Object

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

Object
Nombre Tipo Description
id

string

Identificador de recurso del punto de conexión privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object
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
Default
Proxy
Redirect

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
PointInTimeRestore

PricingModel

Enumeración

Modelo de precios de Instancia administrada.

Valor Description
Freemium
Regular

PrincipalType

Enumeración

Tipo de entidad de seguridad del administrador del servidor.

Valor Description
Application
Group
User

ProvisioningState

Enumeración

Estado de aprovisionamiento de la instancia administrada.

Valor Description
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

Object

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

Nombre Tipo Description
principalId

string (uuid)

Identificador de entidad de seguridad de Azure Active Directory.
tenantId

string (uuid)

Identificador de inquilino de Azure Active Directory.
type

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad 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

Object

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

Nombre Tipo Description
clientId

string

Identificador de cliente de la aplicación de Azure Active Directory.
principalId

string

Identificador del objeto de aplicación de Azure Active Directory.
tenantId

string

Identificador de inquilino de Azure Active Directory.
type

ServicePrincipalType

Tipo de entidad de servicio.

ServicePrincipalType

Enumeración

Tipo de entidad de servicio.

Valor Description
None
SystemAssigned

Sku

Object

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.

UserIdentity

Object

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

Nombre Tipo Description
clientId

string (uuid)

Identificador de cliente de Azure Active Directory.
principalId

string (uuid)

Identificador de entidad de seguridad de Azure Active Directory.