Partilhar via


Instance Failover Groups - Get

Obtém um grupo de ativação pós-falha.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
failoverGroupName
path True

string

O nome do grupo de ativação pós-falha.

locationName
path True

string

O nome da região onde o recurso está localizado.

resourceGroupName
path True

string

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

subscriptionId
path True

string

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

api-version
query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

InstanceFailoverGroup

O grupo de ativação pós-falha especificado foi obtido com êxito.

Other Status Codes

Respostas de Erro: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary – o campo primário especificado na criação ou atualização do corpo do pedido do grupo de ativação pós-falha da instância está vazio ou é inválido.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner – o campo de parceiros especificado na criação ou atualização do corpo do pedido do grupo de ativação pós-falha da instância está vazio ou é inválido.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner – um ou mais dos servidores de parceiros fornecidos já fazem parte do grupo de ativação pós-falha de instâncias. Certifique-se de que o servidor primário e todos os servidores de parceiros especificados são exclusivos.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion – a região da instância gerida do parceiro fornecida no corpo do pedido do grupo de ativação pós-falha de instância está vazia ou é inválida.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – só é suportada uma região de parceiro.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount – só é suportado um par de instâncias geridas.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – o campo readWriteEndpoint é necessário para criar ou atualizar pedidos.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid – o corpo do pedido do grupo de ativação pós-falha de criação ou atualização de instâncias está vazio ou é inválido.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary – as modificações ao grupo de ativação pós-falha da instância não são permitidas num servidor secundário. Execute o pedido no servidor primário.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – o valor do período de tolerância para o ponto final de leitura-escrita tem de ser não negativo.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – o valor do período de tolerância do grupo de ativação pós-falha da instância tem de ser maior ou igual ao período de tolerância mínimo "{0}" minutos

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – a ativação pós-falha da propriedadeWithDataLossGracePeriodMinutes tem de ser fornecida quando a política de ativação pós-falha Automática está selecionada para o ponto final de leitura-escrita.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – o campo failoverPolicy para o ponto final de leitura-escrita é necessário para criar ou atualizar pedidos.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – o valor do período de tolerância não deve ser fornecido quando a política de ativação pós-falha Manual está selecionada para o ponto final de leitura-escrita.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – o corpo do pedido do grupo de ativação pós-falha de criação ou atualização da instância não deve modificar a propriedade só de leitura "{0}".

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary – o pedido de ativação pós-falha deve ser iniciado no servidor secundário do grupo de ativação pós-falha de instâncias.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription – o servidor primário e o servidor parceiro do grupo de ativação pós-falha são de subscrições diferentes. A subscrição cruzada para servidores do grupo de ativação pós-falha não é permitida.

  • 400 FailoverGroupRegionMismatch – a região de parceiro especificada no Grupo de Ativação Pós-falha tem de corresponder à região da instância gerida do parceiro indicada.

  • 400 ServerEditionMismatch - A edição tem de ser a mesma que o servidor primário ao criar um servidor de réplica.

  • 400 DnsZoneMismatch – o DNSZone no servidor parceiro é diferente do DNSZone no servidor de origem. Isto interrompe a funcionalidade InstanceFailoverGroup.

  • 400 InvalidTargetSubregion – o servidor de destino de uma secundária não legível não está numa região do Azure emparelhada com DR.

  • 400 GeoDrInstanceSizeMismatch – a instância gerida primária e a instância gerida do parceiro não têm o mesmo tamanho de armazenamento.

  • 400 SecurityAdalPrincipalCertExpiredError – não foi possível concluir a operação porque o certificado principal do Azure Key Vault expirou.

  • 400 GeoDrSecondaryInstanceNotEmpty – a instância gerida secundária tem bases de dados de utilizador. Para criar um grupo de ativação pós-falha de instância, a instância gerida secundária tem de estar vazia.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration – a configuração de rede está incorreta. O tráfego de replicação do servidor primário não consegue aceder ao servidor secundário.

  • 400 IncorrectReplicationLinkState – a operação espera que a base de dados esteja num estado esperado na ligação de replicação.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – o URI de Key Vault fornecido não é válido.

  • 400 KeyMaterialNotFoundOnRemoteServer – o servidor remoto não tem acesso a material de chave utilizado como protetor de Encriptação de Dados Transparente.

  • 400 AzureKeyVaultRsaKeyNotSupported – o cofre de chaves fornecido utiliza o Tamanho ou Tipo de Chave RSA não suportado. O tamanho da chave RSA suportado é 2048 ou 3072 e o Tipo de Chave é RSA ou RSA-HSM.

  • 400 UnableToResolveRemoteServer – não foi possível resolver o nome do servidor do parceiro remoto devido a um nome de servidor ou problemas de conectividade DNS inválidos.

  • 400 SameKeyUriNotFoundOnRemoteServer – o servidor secundário não tem o material de chave do mesmo cofre de chaves que o protetor de encriptação do servidor primário com a rotação automática de chaves ativada.

  • 400 RemoteDatabaseCopyPermission – o utilizador não tem permissão suficiente para criar uma cópia de base de dados no servidor especificado.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – o servidor secundário não tem o material de chave do protetor de encriptação do servidor primário.

  • 400 CannotUseReservedDatabaseName – não é possível utilizar o nome da base de dados reservada nesta operação.

  • 400 InvalidFailoverGroupRegion – os servidores especificados num Grupo de Ativação Pós-falha de Instâncias têm de residir em regiões diferentes para fornecer isolamento.

  • 400 InstanceFailoverGroupDoesNotExist – o grupo de ativação pós-falha não existe num servidor.

  • 400 InstanceFailoverGroupNotSecondary – não é possível iniciar a ativação pós-falha a partir do servidor primário num grupo de ativação pós-falha de instâncias.

  • 400 InvalidServerName – nome de servidor inválido especificado.

  • 400 InvalidIdentifier – o identificador contém NULL ou um caráter unicode inválido.

  • 400 TokenTooLong – o token fornecido é demasiado longo.

  • 400 AzureKeyVaultKeyDisabled – não foi possível concluir a operação no servidor porque a chave de Key Vault do Azure está desativada.

  • 400 AzureKeyVaultInvalidExpirationDate – não foi possível concluir a operação porque a data de expiração da chave de Key Vault do Azure é inválida.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – não foi possível concluir a operação porque o URI de Key Vault do Azure é nulo ou está vazio.

  • 400 InvalidSku - O utilizador especificou um SKU inválido.

  • 400 InvalidAddSecondaryPermission – o utilizador não tem permissão suficiente para adicionar um servidor secundário no servidor especificado.

  • 400 ServerNotFound – o servidor pedido não foi encontrado.

  • 400 AzureKeyVaultNoServerIdentity – a identidade do servidor não está configurada corretamente.

  • 400 AzureKeyVaultInvalidUri – uma resposta inválida do Azure Key Vault. Utilize um URI de Key Vault do Azure válido.

  • 400 AzureKeyVaultMissingPermissions – o servidor tem as permissões necessárias em falta no Key Vault do Azure.

  • 400 SecurityAzureKeyVaultInvalidKeyName – não foi possível concluir a operação devido a um nome de Chave de Servidor inválido.

  • 400 PlannedFailoverTimedOutForDatabase - O utilizador invocou failover planeado, excedeu o limite de tempo e uma base de dados específica parece ser a culpada.

  • 400 PlannedFailoverTimedOut – o utilizador invocou failover planeado e excedeu o limite de tempo ao tentar contactar o serviço de gestão de parceiros.

  • 400 AdalGenericError – não foi possível concluir a operação porque foi encontrado um erro do Azure Active Directory.

  • 400 GeoReplicationDatabaseNotSecondary – a operação espera que a base de dados seja um destino de replicação.

  • 400 AdalServicePrincipalNotFound – não foi possível concluir a operação porque não foi encontrado um erro de Principal de Serviço da biblioteca do Azure Active Directory.

  • 400 AzureKeyVaultMalformedVaultUri – o URI de Key Vault fornecido não é válido.

  • 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 SourceDatabaseNotFound – a base de dados de origem não existe.

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

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

  • 405 UnsupportedReplicationOperation – foi iniciada uma operação de replicação não suportada na base de dados.

  • 409 ManagedInstanceHasHybridLink – o utilizador tentou iniciar a operação que não é suportada quando a instância gerida tem uma ligação híbrida configurada.

  • 409 RemoteDatabaseExists – o nome da base de dados de destino já existe no servidor de destino.

  • 409 ConflictingServerOperation - Está atualmente em curso uma operação para o servidor.

  • 409 SubscriptionDisabled - A subscrição está desativada.

  • 409 InstanceFailoverGroupAlreadyExists – o grupo ativação pós-falha já existe num determinado servidor.

  • 409 InstanceFailoverGroupBusy – O grupo de ativação pós-falha de instâncias está ocupado com outra operação.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - O utilizador tentou efetuar a ativação pós-falha ou forçar o fim de uma ligação geográfica enquanto a secundária se encontra num estado em que pode não ser fisicamente consistente e, por isso, não pode introduzir a função primária.

  • 409 InstanceFailoverGroupDnsRecordInUse – existe um registo DNS duplicado para o ponto final pedido.

  • 409 ServerKeyNameAlreadyExists – a chave de servidor já existe no servidor.

  • 409 ServerKeyUriAlreadyExists - O URI da chave de servidor já existe no servidor.

  • 409 ServerKeyDoesNotExists - A chave de servidor não existe.

  • 409 InvalidFailoverGroupName – foi fornecido o nome do Grupo de Ativação Pós-falha de Instância Inválido.

  • 409 UpdateSloInProgress – o utilizador tentou iniciar uma operação incompatível enquanto uma atualização do SLO estava em curso.

  • 409 AzureKeyVaultKeyNameNotFound – não foi possível concluir a operação porque o nome da Chave de Key Vault do Azure não existe.

  • 409 AzureKeyVaultKeyInUse – a chave está atualmente a ser utilizada pelo servidor.

  • 409 ConflictingSystemOperationInProgress - Está em curso uma operação de manutenção do sistema na base de dados e as operações adicionais têm de aguardar até que seja concluída.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – foi realizada uma operação de propagação de replicação numa base de dados que já se encontra numa relação de replicação.

  • 409 InvalidDatabaseStateForOperation - A operação não é permitida na base de dados no estado de replicação atual.

  • 409 DuplicateGeoDrRelation – as bases de dados já estão numa relação de replicação. Este é um pedido duplicado.

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

  • 429 SubscriptionTooManyRequests - 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.

  • 503 AzureKeyVaultConnectionFailed - Não foi possível concluir a operação no servidor porque as tentativas de ligação ao Azure Key Vault falharam

  • 503 AzureKeyVaultGenericConnectionError – não foi possível concluir a operação porque foi encontrado um erro ao tentar obter Key Vault informações.

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

Exemplos

Get failover group

Pedido de amostra

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test?api-version=2021-11-01

Resposta da amostra

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Definições

Name Description
InstanceFailoverGroup

Um grupo de ativação pós-falha de instâncias.

InstanceFailoverGroupReadOnlyEndpoint

Ponto final só de leitura da instância do grupo de ativação pós-falha.

InstanceFailoverGroupReadWriteEndpoint

Ponto final de leitura/escrita da instância do grupo de ativação pós-falha.

InstanceFailoverGroupReplicationRole

Função de replicação local da instância do grupo de ativação pós-falha.

ManagedInstancePairInfo

Pares de Instâncias Geridas no grupo de ativação pós-falha.

PartnerRegionInfo

Informações da região do parceiro para o grupo de ativação pós-falha.

ReadOnlyEndpointFailoverPolicy

Política de ativação pós-falha do ponto final só de leitura para o grupo de ativação pós-falha.

ReadWriteEndpointFailoverPolicy

Política de ativação pós-falha do ponto final de leitura-escrita para o grupo de ativação pós-falha. Se failoverPolicy for Automático, é necessária a ativação pós-falhaWithDataLossGracePeriodMinutes.

InstanceFailoverGroup

Um grupo de ativação pós-falha de instâncias.

Name Tipo Description
id

string

ID do Recurso.

name

string

Nome do recurso.

properties.managedInstancePairs

ManagedInstancePairInfo[]

Lista de pares de instâncias geridas no grupo de ativação pós-falha.

properties.partnerRegions

PartnerRegionInfo[]

Informações da região do parceiro para o grupo de ativação pós-falha.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Ponto final só de leitura da instância do grupo de ativação pós-falha.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Ponto final de leitura/escrita da instância do grupo de ativação pós-falha.

properties.replicationRole

InstanceFailoverGroupReplicationRole

Função de replicação local da instância do grupo de ativação pós-falha.

properties.replicationState

string

Estado de replicação da instância do grupo de ativação pós-falha.

type

string

Tipo de recurso.

InstanceFailoverGroupReadOnlyEndpoint

Ponto final só de leitura da instância do grupo de ativação pós-falha.

Name Tipo Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Política de ativação pós-falha do ponto final só de leitura para o grupo de ativação pós-falha.

InstanceFailoverGroupReadWriteEndpoint

Ponto final de leitura/escrita da instância do grupo de ativação pós-falha.

Name Tipo Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

Política de ativação pós-falha do ponto final de leitura-escrita para o grupo de ativação pós-falha. Se failoverPolicy for Automático, é necessária a ativação pós-falhaWithDataLossGracePeriodMinutes.

failoverWithDataLossGracePeriodMinutes

integer

Período de tolerância antes da ativação pós-falha com a perda de dados ser tentada para o ponto final de leitura-escrita. Se failoverPolicy for Automático, é necessária a ativação pós-falhaWithDataLossGracePeriodMinutes.

InstanceFailoverGroupReplicationRole

Função de replicação local da instância do grupo de ativação pós-falha.

Name Tipo Description
Primary

string

Secondary

string

ManagedInstancePairInfo

Pares de Instâncias Geridas no grupo de ativação pós-falha.

Name Tipo Description
partnerManagedInstanceId

string

ID da Instância Gerida do Parceiro em par.

primaryManagedInstanceId

string

ID da Instância Gerida Primária em par.

PartnerRegionInfo

Informações da região do parceiro para o grupo de ativação pós-falha.

Name Tipo Description
location

string

Localização geográfica das instâncias geridas pelo parceiro.

replicationRole

InstanceFailoverGroupReplicationRole

Função de replicação das instâncias geridas pelo parceiro.

ReadOnlyEndpointFailoverPolicy

Política de ativação pós-falha do ponto final só de leitura para o grupo de ativação pós-falha.

Name Tipo Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Política de ativação pós-falha do ponto final de leitura-escrita para o grupo de ativação pós-falha. Se failoverPolicy for Automático, é necessária a ativação pós-falhaWithDataLossGracePeriodMinutes.

Name Tipo Description
Automatic

string

Manual

string