Managed Instances - Get
Obtiene una instancia administrada.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2022-05-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2022-05-01-preview
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
managed
|
path | True |
string |
El nombre de la instancia administrada. |
resource
|
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. |
subscription
|
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. |
Nombre | Tipo | Description |
---|---|---|
200 OK |
Recuperó correctamente la instancia administrada especificada. |
|
Other Status Codes |
Respuestas de error: ***
|
Solicitud de ejemplo
GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2022-05-01-preview
Respuesta de muestra
{
"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"
}
Solicitud de ejemplo
GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2022-05-01-preview
Respuesta de muestra
{
"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"
}
Nombre | Description |
---|---|
Administrator |
Tipo del administrador del servidor. |
Backup |
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) |
Identity |
Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso. |
Managed |
Una instancia administrada Azure SQL. |
Managed |
Propiedades de un administrador de Active Directory. |
Managed |
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). |
Managed |
Una conexión de punto de conexión privado en una instancia administrada |
Managed |
Propiedades de una conexión de punto de conexión privado. |
Managed |
|
Managed |
|
Managed |
Tipo de conexión que se usa para conectarse a la instancia de . |
Managed |
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. |
Principal |
Tipo principal del administrador del servidor. |
Resource |
Configuración de identidad de Azure Active Directory para un recurso. |
Service |
Configuración de la entidad de servicio de la instancia administrada para un recurso. |
Service |
Tipo de entidad de servicio. |
Sku |
Una SKU de recursos de ARM. |
User |
Configuración de identidad de Azure Active Directory para un recurso. |
Tipo del administrador del servidor.
Nombre | Tipo | Description |
---|---|---|
ActiveDirectory |
string |
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 |
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 |
Una instancia administrada Azure SQL.
Nombre | Tipo | 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 de la instancia. Esto solo se puede usar en el momento de la creación de la instancia. Si se usa para la actualización por ejemplo, se omitirá o se producirá un error. En el caso de las actualizaciones, es necesario usar las API individuales. |
|
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:
|
|
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 (ISO8601 formato) 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. |
Propiedades de un administrador de Active Directory.
Nombre | Tipo | 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. |
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 |
Una conexión de punto de conexión privado en una instancia administrada
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del recurso. |
properties |
Propiedades de conexión de punto de conexión privado |
Propiedades de una conexión de punto de conexión privado.
Nombre | Tipo | 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. |
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso del punto de conexión privado. |
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. |
Tipo de conexión que se usa para conectarse a la instancia de .
Nombre | Tipo | Description |
---|---|---|
Default |
string |
|
Proxy |
string |
|
Redirect |
string |
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 |
Tipo principal del administrador del servidor.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
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 |
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,
User |
Identificadores de recurso de las identidades asignadas por el usuario que se van a usar |
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 |
Tipo de entidad de servicio. |
Tipo de entidad de servicio.
Nombre | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
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. |
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. |