Partilhar via


Managed Instances - List By Resource Group

Obtém uma lista de instâncias gerenciadas em um grupo de recursos.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

$expand
query

string

Os recursos da criança para incluir na resposta.

Respostas

Name Tipo Description
200 OK

ManagedInstanceListResult

Recuperada com êxito a lista de instâncias gerenciadas.

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 SubnetMissingRequiredDelegation - A sub-rede selecionada não é delegada para a Instância Gerenciada SQL.

  • 400 ManagementServiceManagedServerDisabled - A operação falhou porque a Instância Gerenciada '{0}' está desabilitada. Habilite a Instância Gerenciada e tente novamente.

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

  • 400 LastBackupNameHasNewline - Por favor, não use caracteres proibidos ('\n', '\r') em lastBackupName.

  • 400 LastBackupNameHasNonAsciiCharacter - A operação foi abortada porque o parâmetro 'LastBackupName' contém caracteres inválidos. Apenas caracteres ASCII são permitidos.

  • 400 ProvisioningDisabled - Exibe a mensagem de erro do autorizador da operação de recursos no estado em que se encontra, sem alterações

  • 400 LRSCutoverDatabaseDoesNotExist - A operação foi anulada porque o nome do banco de dados especificado na solicitação não corresponde a nenhum nome de banco de dados no servidor especificado.

  • 400 LRSCutoverDatabaseNotInRestoringState - A operação foi abortada porque o banco de dados especificado não está no estado de restauração.

  • 400 LRSCutoverDatabaseAlreadyRestored - A operação foi abortada porque o banco de dados especificado já foi restaurado.

  • 400 LRSCutoverAlreadyInitiated - A operação foi abortada porque uma substituição para o banco de dados especificado já está em andamento.

  • 400 ManagementServiceFeatureDisabled - O usuário tentou usar um recurso que está desabilitado.

  • 400 AadOnlyAuthenticationIsEnabled - A Autenticação Apenas do Ative Directory do Azure está habilitada. Entre em contato com o administrador do sistema.

  • 400 UpdatingInstanceAndBackupRedundancy - A redundância da zona da instância e a redundância do armazenamento de backup não podem ser atualizadas na mesma solicitação.

  • 400 DeleteOfManagedInstanceIsDisabled - A operação de exclusão da instância gerenciada está desabilitada.

  • 400 RequestCantLandOnPaaSv2Platform - A solicitação precisa pousar na plataforma PaaSv2, mas o PaaSv2 não está habilitado.

  • 400 CustomMaintenanceWindowIsDisabled - A janela de manutenção personalizada não está ativada.

  • 400 DeleteOfVersion2VirtualClusterIsDisabled - A exclusão do cluster virtual com a versão 2 não está habilitada.

  • 400 DeleteOfVirtualClusterIsDisabled - A exclusão do cluster virtual não está habilitada.

  • 400 MICantBeMovedFromOrToInstancePool - A instância gerenciada existente não pode ser movida para o pool de instâncias gerenciadas.

  • 400 DnsRefreshOnVirtualClusterIsDisabled - A atualização de registros DNS no cluster virtual não está habilitada.

  • 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup - A instância gerenciada especificada não existe no grupo de recursos e na assinatura especificados.

  • 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada.

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

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

  • 409 MiCreateFailedNonDelegatedSubnet - O usuário tentou implantar a Instância Gerenciada ou o pool de Instâncias Gerenciadas na sub-rede que não é delegada a Microsoft.Sql/managedInstances.

  • 409 InstancePoolBusy - Um pool de instâncias está ocupado com outra operação em andamento

  • 409 ConflictingManagedInstanceOperation - Uma operação está atualmente em andamento para a instância gerenciada.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - A instância é multi-az, mas o armazenamento de backup está sendo atualizado de zona redundante para redundante de não zona.

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

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - O armazenamento de backup não é redundante de zona, mas a redundância de instância está sendo atualizada para zona redundante.

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

  • 409 MiDropFailedOnAuthLocks - O usuário tentou soltar a última instância gerenciada na sub-rede que tem Lock aplicado no(s) recurso(s).

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

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 ConflictingSubscriptionOperation - Uma operação está atualmente em andamento para a assinatura.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 504 RequestTimeout - A solicitação de serviço excedeu o tempo limite permitido.

  • 504 RequestTimeout - A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

List managed instances by resource group
List managed instances by resource group with $expand=administrators/activedirectory

List managed instances by resource group

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "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",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "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-444444444444",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

List managed instances by resource group with $expand=administrators/activedirectory

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "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",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "externalGovernanceStatus": "Enabled",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "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"
      }
    }
  ]
}

Definições

Name Description
AdministratorType

Tipo de administrador de corte.

AuthMetadataLookupModes

Modo de pesquisa de metadados de autenticação da instância gerenciada.

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ExternalGovernanceStatus

Estatuto da governação externa.

HybridSecondaryUsage

Uso secundário híbrido. Os valores possíveis são 'Ativo' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR passivo).

HybridSecondaryUsageDetected

Uso secundário híbrido detetado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo).

IdentityType

O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

ManagedInstance

Uma instância gerenciada SQL do Azure.

ManagedInstanceDatabaseFormat

Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL.

ManagedInstanceExternalAdministrator

Propriedades de um administrador do Ative Directory.

ManagedInstanceLicenseType

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

ManagedInstanceListResult

Uma lista de instâncias gerenciadas.

ManagedInstancePecProperty

Uma conexão de ponto de extremidade privada em uma instância gerenciada

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de uma conexão de ponto de extremidade privada.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Tipo de conexão usado para se conectar à instância.

ManagedServerCreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação de instância regular.

Restauração: cria uma instância restaurando um conjunto de backups para um point-in-time específico. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

PricingModel

Modelo de precificação da Instância Gerenciada.

PrincipalType

Tipo principal do administrador de corte.

ProvisioningState

Estado de provisionamento da instância gerenciada.

ResourceIdentity

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

ServicePrincipal

A configuração da entidade de serviço da instância gerenciada para um recurso.

ServicePrincipalType

Tipo de entidade de serviço.

Sku

Um SKU de recurso ARM.

UserIdentity

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

AdministratorType

Tipo de administrador de corte.

Valor Description
ActiveDirectory

AuthMetadataLookupModes

Modo de pesquisa de metadados de autenticação da instância gerenciada.

Valor Description
AzureAD
Paired
Windows

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

Valor Description
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ExternalGovernanceStatus

Estatuto da governação externa.

Valor Description
Disabled
Enabled

HybridSecondaryUsage

Uso secundário híbrido. Os valores possíveis são 'Ativo' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR passivo).

Valor Description
Active
Passive

HybridSecondaryUsageDetected

Uso secundário híbrido detetado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo).

Valor Description
Active
Passive

IdentityType

O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

Valor Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Uma instância gerenciada SQL do Azure.

Name Tipo Description
id

string

ID do recurso.

identity

ResourceIdentity

A identidade do Azure Ative Directory da instância gerenciada.

location

string

Localização do recurso.

name

string

Nome do recurso.

properties.administratorLogin

string

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

properties.administratorLoginPassword

string

A senha de login do administrador (necessária para a criação da instância gerenciada).

properties.administrators

ManagedInstanceExternalAdministrator

O administrador do Azure Ative Directory da instância. Isso só pode ser usado no momento de criação da instância. Se usado para atualização de exemplo, ele será ignorado ou resultará em um erro. Para atualizações, APIs individuais precisarão ser usadas.

properties.authenticationMetadata

AuthMetadataLookupModes

Modo de pesquisa de metadados de autenticação da instância gerenciada.

properties.collation

string

Agrupamento da instância gerenciada.

properties.createTime

string (date-time)

Especifica o point-in-time (formato ISO8601) da criação da Instância Gerenciada.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

properties.databaseFormat

ManagedInstanceDatabaseFormat

Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL.

properties.dnsZone

string

A zona Dns em que a instância gerenciada está.

properties.dnsZonePartner

string (arm-id)

A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Estatuto da governação externa.

properties.fullyQualifiedDomainName

string

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

properties.hybridSecondaryUsage

HybridSecondaryUsage

Uso secundário híbrido. Os valores possíveis são 'Ativo' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR passivo).

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

Uso secundário híbrido detetado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo).

properties.instancePoolId

string

A Id do pool de instâncias ao qual esse servidor gerenciado pertence.

properties.isGeneralPurposeV2

boolean

Se esta é ou não uma variante GPv2 da edição de uso geral.

properties.keyId

string

Um URI CMK da chave a ser usada para criptografia.

properties.licenseType

ManagedInstanceLicenseType

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

properties.maintenanceConfigurationId

string

Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação de instância regular.

Restauração: cria uma instância restaurando um conjunto de backups para um point-in-time específico. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

properties.minimalTlsVersion

string

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

properties.pricingModel

PricingModel

Modelo de precificação da Instância Gerenciada.

properties.primaryUserAssignedIdentityId

string (arm-id)

A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Lista de conexões de ponto de extremidade privado em uma instância gerenciada.

properties.provisioningState

ProvisioningState

Estado de provisionamento da instância gerenciada.

properties.proxyOverride

ManagedInstanceProxyOverride

Tipo de conexão usado para se conectar à instância.

properties.publicDataEndpointEnabled

boolean

Se o ponto de extremidade de dados públicos está habilitado ou não.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento a ser usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string (date-time)

Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.

properties.servicePrincipal

ServicePrincipal

A entidade de serviço da instância gerenciada.

properties.sourceManagedInstanceId

string (arm-id)

O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância.

properties.state

string

O estado da instância gerenciada.

properties.storageIOps

integer (int32)

IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Apenas são permitidos incrementos de 1 IOps. O valor máximo depende da família de hardware selecionada e do número de vCores.

properties.storageSizeInGB

integer (int32)

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

properties.storageThroughputMBps

integer (int32)

O parâmetro MBps de taxa de transferência de armazenamento não é suportado na operação de criação/atualização da instância.

properties.subnetId

string (arm-id)

ID do recurso de sub-rede para a instância gerenciada.

properties.timezoneId

string

Id do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre fusos horários suportados, incluindo a id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Você pode obter esses valores do Registro via SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de Ids também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de id de fuso horário válido é "Pacific Standard Time" ou "W. Hora Padrão da Europa".

properties.vCores

integer (int32)

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

properties.virtualClusterId

string

ID de recurso de cluster virtual para a instância gerenciada.

properties.zoneRedundant

boolean

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

sku

Sku

SKU de instância gerenciada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM BC_G8IH

tags

object

Tags de recursos.

type

string

Tipo de recurso.

ManagedInstanceDatabaseFormat

Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL.

Valor Description
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Propriedades de um administrador do Ative Directory.

Name Tipo Description
administratorType

AdministratorType

Tipo de administrador de corte.

azureADOnlyAuthentication

boolean

Somente Autenticação do Ative Directory do Azure habilitada.

login

string

Nome de login do administrador do servidor.

principalType

PrincipalType

Tipo principal do administrador de corte.

sid

string (uuid)

SID (ID do objeto) do administrador do servidor.

tenantId

string (uuid)

ID do locatário do administrador.

ManagedInstanceLicenseType

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

Valor Description
BasePrice
LicenseIncluded

ManagedInstanceListResult

Uma lista de instâncias gerenciadas.

Name Tipo Description
nextLink

string

Link para recuperar a próxima página de resultados.

value

ManagedInstance[]

Matriz de resultados.

ManagedInstancePecProperty

Uma conexão de ponto de extremidade privada em uma instância gerenciada

Name Tipo Description
id

string

ID do recurso.

properties

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de conexão de ponto de extremidade privado

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de uma conexão de ponto de extremidade privada.

Name Tipo Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Ponto de extremidade privado ao qual a conexão pertence.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Estado da Conexão da Conexão de Ponto Final Privado.

provisioningState

string

Estado da Conexão de Ponto Final Privado.

ManagedInstancePrivateEndpointProperty

Name Tipo Description
id

string

ID do recurso do ponto de extremidade privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Tipo Description
actionsRequired

string

A descrição da conexão do serviço de link privado.

description

string

A descrição da conexão do serviço de link privado.

status

string

O status da conexão do serviço de link privado.

ManagedInstanceProxyOverride

Tipo de conexão usado para se conectar à instância.

Valor Description
Default
Proxy
Redirect

ManagedServerCreateMode

Especifica o modo de criação do banco de dados.

Padrão: criação de instância regular.

Restauração: cria uma instância restaurando um conjunto de backups para um point-in-time específico. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

Valor Description
Default
PointInTimeRestore

PricingModel

Modelo de precificação da Instância Gerenciada.

Valor Description
Freemium
Regular

PrincipalType

Tipo principal do administrador de corte.

Valor Description
Application
Group
User

ProvisioningState

Estado de provisionamento da instância gerenciada.

Valor Description
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

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

Name Tipo Description
principalId

string (uuid)

A ID principal do Azure Ative Directory.

tenantId

string (uuid)

A ID de locatário do Azure Ative Directory.

type

IdentityType

O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

userAssignedIdentities

<string,  UserIdentity>

As ids de recurso das identidades atribuídas ao usuário a serem usadas

ServicePrincipal

A configuração da entidade de serviço da instância gerenciada para um recurso.

Name Tipo Description
clientId

string

A ID do cliente do aplicativo Azure Ative Directory.

principalId

string

A ID do objeto do aplicativo Azure Ative Directory.

tenantId

string

A ID de locatário do Azure Ative Directory.

type

ServicePrincipalType

Tipo de entidade de serviço.

ServicePrincipalType

Tipo de entidade de serviço.

Valor Description
None
SystemAssigned

Sku

Um SKU de recurso ARM.

Name Tipo Description
capacity

integer (int32)

Capacidade do SKU específico.

family

string

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

name

string

O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3.

size

string

Tamanho do SKU específico

tier

string

O nível ou edição do SKU específico, por exemplo, Basic, Premium.

UserIdentity

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

Name Tipo Description
clientId

string (uuid)

A ID do cliente do Azure Ative Directory.

principalId

string (uuid)

A ID principal do Azure Ative Directory.