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

Nombre En Requerido Tipo 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

Nombre Tipo Description
200 OK

ManagedInstance

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

Nombre Description
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.

Nombre Tipo 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)

Nombre Tipo 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.

Nombre Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Una instancia administrada Azure SQL.

Nombre Tipo Description
id

string

Identificador del 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 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

ManagedInstanceExternalAdministrator

Administrador de Azure Active Directory del servidor.

properties.collation

string

Intercalació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.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

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

properties.maintenanceConfigurationId

string

Especifica el identificador de configuración de mantenimiento que se va a 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.primaryUserAssignedIdentityId

string

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

properties.privateEndpointConnections

ManagedInstancePecProperty[]

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

ManagedInstanceProxyOverride

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

BackupStorageRedundancy

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 (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

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

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.

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

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

Nombre Tipo Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

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

Nombre Tipo Description
id

string

Identificador del recurso.

properties

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointConnectionProperties

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

Nombre Tipo Description
id

string

Identificador de recurso del punto de conexión privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

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

Nombre Tipo 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.

Nombre Tipo Description
Default

string

PointInTimeRestore

string

PrincipalType

Tipo de entidad de seguridad del administrador del servidor.

Nombre Tipo Description
Application

string

Group

string

User

string

ResourceIdentity

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

Nombre Tipo Description
principalId

string

Identificador de entidad de seguridad de Azure Active Directory.

tenantId

string

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

Nombre Tipo 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

ServicePrincipalType

Tipo de entidad de servicio.

ServicePrincipalType

Tipo de entidad de servicio.

Nombre Tipo Description
None

string

SystemAssigned

string

Sku

Una SKU de recursos de ARM.

Nombre Tipo 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.

Nombre Tipo Description
clientId

string

Identificador de cliente de Azure Active Directory.

principalId

string

Identificador de entidad de seguridad de Azure Active Directory.