Managed Instances - Get

Obtém um caso gerido.

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 do URI

Name In Required Type Description
managedInstanceName
path True
  • string

O nome do caso gerido.

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir do Azure Resource Manager API ou do portal.

subscriptionId
path True
  • string

O ID de subscrição que identifica uma subscrição do Azure.

api-version
query True
  • string

A versão API a utilizar para o pedido.

$expand
query
  • string

Os recursos da criança para incluir na resposta.

Respostas

Name Type Description
200 OK

Recuperou com sucesso a instância gerida especificada.

Other Status Codes

Respostas de erro: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy - Geo-Restore não é permitido para casos geridos com redundância de armazenamento de backup LRS/ZRS.

  • 400 UpdateInstanceAndBackupRedundancy - Redundância de zona de instância e despedimento de armazenamento de backup não pode ser atualizado no mesmo pedido.

  • 400 ProvisioningDabled - Exibe mensagem de erro do autor da operação de recursos, tal como está, sem alterações

  • 400 AadOnlyAuthenticationIsEnabled - Azure Ative Directory Only Authentication está ativado. Contacte o administrador do sistema.

  • 400 ManagementServiceFeatureDabled - O utilizador tentou utilizar uma funcionalidade desativada.

  • 404 SubscriçãoNotFound - A subscrição solicitada não foi encontrada.

  • 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup - Não existe uma instância gerida especificada no grupo de recursos especificado e na subscrição.

  • 404 SubscriçãoNotFound - A subscrição solicitada não foi encontrada.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 409 Conflituosa Operação de Operação DeInstance - Está em curso uma operação para a instância gerida.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - O caso é multi-az, mas o armazenamento de backup está sendo atualizado de zona redundante para não-zona redundante.

  • 409 InstanceDundancyUpdateWhileBackupundancyUpdateInProgress - Não pode atualizar o despedimento de exemplo porque a atualização do despedimento de armazenamento de backup está em andamento.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - O armazenamento de backup não é redundante, mas o despedimento de exemplo está a ser atualizado para a zona redundante.

  • 409 BackupRedundancyUpdateConflict - Não é possível atualizar a redundância de armazenamento de backup porque uma atualização de despedimento de armazenamento de backup já está em andamento.

  • 409 MiDropFailedOnAuthLocks - O utilizador tentou deixar cair a última Instância Gerida na sub-rede que tem o Lock aplicado nos recursos.s.

  • 409 MiCreateFailedNonDelegatedSubnet - O utilizador tentou implementar o pool De Instância Gerida ou Caso Gerido na sub-rede que não está delegada na Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupncyUpdate - Não é possível atualizar a redundância de armazenamento de backup porque a instância não está pronta.

  • 429 SubscriçõesTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriçõesTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriçõesTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriçõesTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 ConflituosaSubscriçãoOperação - Está em curso uma operação para a subscrição.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 504 RequestTimeout - Pedido de serviço excedeu o tempo limite permitido.

  • 504 RequestTimeout - Pedido de serviço excedeu o tempo limite permitido.

Exemplos

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

Definições

AdministratorType

Tipo de administrador de corte.

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar cópias de segurança para este caso. As opções são Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone (GeoZoneRedundantStorage)

IdentityType

O tipo de identidade. Desaprova isto para 'SystemAssigned' de modo a criar e atribuir automaticamente um diretor de diretório ativo Azure para o recurso.

ManagedInstance

Um SQL do Azure caso gerido.

ManagedInstanceExternalAdministrator

Propriedades de um administrador de diretório ativo.

ManagedInstanceLicenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular, incluindo uma nova licença SQL) e 'BasePrice' (preço AHB descontado para trazer as suas próprias licenças SQL).

ManagedInstancePecProperty

Uma ligação de ponto final privado sob uma instância gerida

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Tipo de ligação utilizado para a ligação ao caso.

ManagedServerCreateMode

Especifica o modo de criação de base de dados.

Padrão: Criação de instâncias regulares.

Restaurar: Cria um caso restaurando um conjunto de backups para determinado ponto no tempo. Restaurar o Tempo De Restauro e SourceManagedInstanceId deve ser especificado.

PrincipalType

Tipo principal do administrador de corte.

ResourceIdentity

Configuração de identidade do Azure Ative Directory para um recurso.

ServicePrincipal

A configuração principal do serviço da instância gerida para um recurso.

ServicePrincipalType

Tipo principal de serviço.

Sku

Um SKU de Recursos ARM.

UserIdentity

Configuração de identidade do Azure Ative Directory para um recurso.

AdministratorType

Tipo de administrador de corte.

Name Type Description
ActiveDirectory
  • string

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar cópias de segurança para este caso. As opções são Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone (GeoZoneRedundantStorage)

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

IdentityType

O tipo de identidade. Desaprova isto para 'SystemAssigned' de modo a criar e atribuir automaticamente um diretor de diretório ativo Azure para o recurso.

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

ManagedInstance

Um SQL do Azure caso gerido.

Name Type Description
id
  • string

Identificação de recursos.

identity

A identidade do Diretório Ativo Azure do caso gerido.

location
  • string

Localização do recurso.

name
  • string

Nome de recurso.

properties.administratorLogin
  • string

Nome de utilizador do administrador para a instância gerida. Só pode ser especificado quando a instância gerida está a ser criada (e é necessária para a criação).

properties.administratorLoginPassword
  • string

A palavra-passe de login do administrador (necessária para a criação de instâncias geridas).

properties.administrators

O administrador do diretor ativo do Azure.

properties.collation
  • string

Colagem do caso gerido.

properties.currentBackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar cópias de segurança para este caso. As opções são Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone (GeoZoneRedundantStorage)

properties.dnsZone
  • string

A Zona dns em que se encontra o caso gerido.

properties.dnsZonePartner
  • string

O id de recursos de outro caso gerido cuja zona de DNS este caso gerido partilhará após a criação.

properties.fullyQualifiedDomainName
  • string

O nome de domínio totalmente qualificado da instância gerida.

properties.instancePoolId
  • string

O ID do conjunto de casos a que este servidor gerido pertence.

properties.keyId
  • string

Um CMK URI da chave a utilizar para encriptação.

properties.licenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular, incluindo uma nova licença SQL) e 'BasePrice' (preço AHB descontado para trazer as suas próprias licenças SQL).

properties.maintenanceConfigurationId
  • string

Especifica o id de configuração de manutenção para aplicar a este caso gerido.

properties.managedInstanceCreateMode

Especifica o modo de criação de base de dados.

Padrão: Criação de instâncias regulares.

Restaurar: Cria um caso restaurando um conjunto de backups para determinado ponto no tempo. Restaurar o Tempo De Restauro e SourceManagedInstanceId deve ser especificado.

properties.minimalTlsVersion
  • string

Versão mínima TLS. Valores permitidos: 'Nenhum', '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId
  • string

O id de recursos de um utilizador atribuído identidade para ser usado por padrão.

properties.privateEndpointConnections

Lista de ligações privadas de ponto final num caso gerido.

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

Tipo de ligação utilizado para a ligação ao caso.

properties.publicDataEndpointEnabled
  • boolean

Se o ponto final dos dados públicos está ou não ativado.

properties.requestedBackupStorageRedundancy

O tipo de conta de armazenamento a ser usado para armazenar cópias de segurança para este caso. As opções são Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone (GeoZoneRedundantStorage)

properties.restorePointInTime
  • string

Especifica o ponto no tempo (formato ISO8601) da base de dados de origem que será restaurada para criar a nova base de dados.

properties.servicePrincipal

O diretor de serviço do caso gerido.

properties.sourceManagedInstanceId
  • string

O identificador de recursos da origem geriu o exemplo associado à criação de operação deste caso.

properties.state
  • string

O estado do caso gerido.

properties.storageSizeInGB
  • integer

Tamanho de armazenamento em GB. Valor mínimo: 32. Valor máximo: 16384. Incrementos de 32 GB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores.

properties.subnetId
  • string

ID de recurso sub-rede para o caso gerido.

properties.timezoneId
  • string

Identificação do timezone. Os valores permitidos são os azonos temporizadores suportados pelo Windows. O Windows mantém detalhes sobre fusos horários suportados, incluindo o id, no registo sob KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores de registo através de SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de Ids também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() em PowerShell. Um exemplo de id de timezone válido é "Pacific Standard Time" ou "W. Tempo Padrão da Europa".

properties.vCores
  • integer

O número de vCores. Valores permitidos: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant
  • boolean

Se o multi-az está ou não ativado.

sku

Caso gerido SKU. 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.

ManagedInstanceExternalAdministrator

Propriedades de um administrador de diretório ativo.

Name Type Description
administratorType

Tipo de administrador de corte.

azureADOnlyAuthentication
  • boolean

Azure Ative Directy apenas Autenticação ativada.

login
  • string

Nome de login do administrador do servidor.

principalType

Tipo principal do administrador de corte.

sid
  • string

SID (ID do objeto) do administrador do servidor.

tenantId
  • string

Identificação do administrador do administrador.

ManagedInstanceLicenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular, incluindo uma nova licença SQL) e 'BasePrice' (preço AHB descontado para trazer as suas próprias licenças SQL).

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstancePecProperty

Uma ligação de ponto final privado sob uma instância gerida

Name Type Description
id
  • string

Identificação de recursos.

properties

Propriedades de conexão de ponto final privado

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

Name Type Description
privateEndpoint

Ponto final privado a que a ligação pertence.

privateLinkServiceConnectionState

Estado de ligação da ligação do ponto final privado.

provisioningState
  • string

Estado da Ligação De Ponto Final Privado.

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

Identificação de recursos do ponto final privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired
  • string

A descrição da ligação de serviço de ligação privada.

description
  • string

A descrição da ligação de serviço de ligação privada.

status
  • string

O estado de ligação do serviço de ligação privada.

ManagedInstanceProxyOverride

Tipo de ligação utilizado para a ligação ao caso.

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

ManagedServerCreateMode

Especifica o modo de criação de base de dados.

Padrão: Criação de instâncias regulares.

Restaurar: Cria um caso restaurando um conjunto de backups para determinado ponto no tempo. Restaurar o Tempo De Restauro e SourceManagedInstanceId deve ser especificado.

Name Type Description
Default
  • string
PointInTimeRestore
  • string

PrincipalType

Tipo principal do administrador de corte.

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

ResourceIdentity

Configuração de identidade do Azure Ative Directory para um recurso.

Name Type Description
principalId
  • string

O ID principal do Azure Ative Directory.

tenantId
  • string

O ID do Inquilino Azure Ative Directory.

type

O tipo de identidade. Desaprova isto para 'SystemAssigned' de modo a criar e atribuir automaticamente um diretor de diretório ativo Azure para o recurso.

userAssignedIdentities

Os ids de recursos do utilizador atribuiu identidades para usar

ServicePrincipal

A configuração principal do serviço da instância gerida para um recurso.

Name Type Description
clientId
  • string

O Id do cliente de aplicação do Azure Ative Directory.

principalId
  • string

O id de aplicação do Diretório Ativo Azure.

tenantId
  • string

O ID do Inquilino Azure Ative Directory.

type

Tipo principal de serviço.

ServicePrincipalType

Tipo principal de serviço.

Name Type Description
None
  • string
SystemAssigned
  • string

Sku

Um SKU de Recursos ARM.

Name Type Description
capacity
  • integer

Capacidade do SKU em particular.

family
  • string

Se o serviço tem diferentes gerações de hardware, para o mesmo SKU, então isso pode ser capturado aqui.

name
  • string

O nome do SKU, tipicamente, uma letra + código número, por exemplo P3.

size
  • string

Tamanho do SKU em particular

tier
  • string

O nível ou edição do SKU em particular, por exemplo, Básico, Premium.

UserIdentity

Configuração de identidade do Azure Ative Directory para um recurso.

Name Type Description
clientId
  • string

O ID do cliente do Azure Ative Directory.

principalId
  • string

O ID principal do Azure Ative Directory.