Managed Instances - Get

Obtiene una instancia administrada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2021-11-01

Parámetros de identificador URI

Name In Required Type Description
managedInstanceName
path True
  • string

El nombre de la instancia administrada.

resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

$expand
query
  • string

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

Respuestas

Name Type Description
200 OK

Recuperó correctamente la instancia administrada especificada.

Other Status Codes

Respuestas de error: ***

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

  • 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 ProvisioningDisabled: muestra el mensaje de error del autorizador de operaciones de recursos tal y como está, sin cambios

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

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

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

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

  • 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 ResourceNotFound: no se encontró el recurso solicitado.

  • 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 está actualizando de redundancia de zona a no redundante de zona.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress: no se puede actualizar la redundancia de instancia porque la actualización de redundancia del 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 el último Instancia administrada en la subred que tiene el bloqueo aplicado en los recursos.

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

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

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

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

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante 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 with $expand=administrators/activedirectory

Get managed instance

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/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/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/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/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "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
    }
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Definiciones

AdministratorType

Tipo del administrador del servidor.

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)

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 Azure 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 de 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 de .

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.

PrincipalType

Tipo de entidad de seguridad del administrador del servidor.

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

Tipo del administrador del servidor.

Name Type Description
ActiveDirectory
  • string

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)

Name Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

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.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ManagedInstance

Una instancia administrada Azure SQL.

Name Type Description
id
  • string

Identificador del recurso.

identity

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 necesario para la creación).

properties.administratorLoginPassword
  • string

Contraseña de inicio de sesión del administrador (necesaria para la creación de una instancia administrada).

properties.administrators

Administrador de Azure Active Directory del servidor.

properties.collation
  • string

Intercalación de la instancia administrada.

properties.currentBackupStorageRedundancy

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.dnsZone
  • string

Zona DNS en la que se encuentra la instancia administrada.

properties.dnsZonePartner
  • string

Identificador de recurso de otra instancia administrada cuya zona DNS compartirá esta instancia administrada después de la creación.

properties.fullyQualifiedDomainName
  • string

Nombre de dominio completo de la instancia administrada.

properties.instancePoolId
  • string

El identificador del grupo de instancias al que pertenece este servidor administrado.

properties.keyId
  • string

URI de CMK de la clave que se va a usar para el cifrado.

properties.licenseType

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 de SQL).

properties.maintenanceConfigurationId
  • string

Especifica el identificador de configuración de mantenimiento que se va a aplicar a esta instancia administrada.

properties.managedInstanceCreateMode

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.primaryUserAssignedIdentityId
  • string

Identificador de recurso de una identidad asignada por el usuario que se usará de forma predeterminada.

properties.privateEndpointConnections

Lista de conexiones de punto de conexión privado en una instancia administrada.

properties.provisioningState enum:
  • Accepted
  • Canceled
  • Created
  • Creating
  • Deleted
  • Deleting
  • Failed
  • NotSpecified
  • Registering
  • Running
  • Succeeded
  • TimedOut
  • Unknown
  • Unrecognized
  • Updating
properties.proxyOverride

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

properties.publicDataEndpointEnabled
  • boolean

Si el punto de conexión de datos público está habilitado o no.

properties.requestedBackupStorageRedundancy

Tipo de cuenta de almacenamiento que se va a usar para almacenar copias de seguridad de esta instancia. Las opciones son Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) y GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime
  • string

Especifica el momento dado (formato ISO8601) de la base de datos de origen que se restaurará para crear la nueva base de datos.

properties.servicePrincipal

La entidad de servicio de la instancia administrada.

properties.sourceManagedInstanceId
  • string

Identificador de recurso de la instancia administrada de origen asociada con la operación de creación de esta instancia.

properties.state
  • string

Estado de la instancia administrada.

properties.storageSizeInGB
  • integer

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.subnetId
  • string

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. Puede obtener esos valores del Registro a través de SQL Server consultando 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

Número de núcleos virtuales. Valores permitidos: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant
  • boolean

Si el multi-az está habilitado o no.

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 del recurso.

type
  • string

Tipo de recurso.

ManagedInstanceExternalAdministrator

Propiedades de un administrador de Active Directory.

Name Type Description
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

Tipo de entidad de seguridad del administrador del servidor.

sid
  • string

SID (id. de objeto) del administrador del servidor.

tenantId
  • string

Id. de inquilino del administrador.

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 de SQL).

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstancePecProperty

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

Name Type Description
id
  • string

Identificador del recurso.

properties

Propiedades de conexión de punto de conexión privado

ManagedInstancePrivateEndpointConnectionProperties

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

Name Type Description
privateEndpoint

Punto de conexión privado al que pertenece la conexión.

privateLinkServiceConnectionState

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

Name Type Description
id
  • string

Identificador de recurso del punto de conexión privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type 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

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

Name Type Description
Default
  • string
Proxy
  • string
Redirect
  • string

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.

Name Type Description
Default
  • string
PointInTimeRestore
  • string

PrincipalType

Tipo de entidad de seguridad del administrador del servidor.

Name Type Description
Application
  • string
Group
  • string
User
  • string

ResourceIdentity

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

Name Type Description
principalId
  • string

Identificador de entidad de seguridad de Azure Active Directory.

tenantId
  • string

Identificador de inquilino de Azure Active Directory.

type

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

Identificadores de recurso de las identidades asignadas por el usuario que se van a usar

ServicePrincipal

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

Name Type Description
clientId
  • string

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

principalId
  • string

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

tenantId
  • string

Identificador de inquilino de Azure Active Directory.

type

Tipo de entidad de servicio.

ServicePrincipalType

Tipo de entidad de servicio.

Name Type Description
None
  • string
SystemAssigned
  • string

Sku

Una SKU de recursos de ARM.

Name Type Description
capacity
  • integer

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 numérico, por ejemplo, P3.

size
  • string

Tamaño de la SKU determinada

tier
  • string

El nivel o la edición de la SKU determinada, por ejemplo, Básico, Premium.

UserIdentity

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

Name Type Description
clientId
  • string

Identificador de cliente de Azure Active Directory.

principalId
  • string

Identificador de entidad de seguridad de Azure Active Directory.