Instance Failover Groups - Failover

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Efetua a reativação pós-falha da instância gerida primária atual para esta instância gerida.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}/failover?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	Ativação pós-falha com êxito.
202 Accepted		Aceite
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 OperationIdNotFound – a operação com o ID não existe. 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 OperationIdNotFound – a operação com o ID não existe. 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 subscrição especificados. 405 UnsupportedReplicationOperation – foi iniciada uma operação de replicação não suportada na base de dados. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 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. 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. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operaçã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. 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.

Name

Tipo

Description

200 OK

InstanceFailoverGroup

Ativação pós-falha com êxito.

202 Accepted

Aceite

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 OperationIdNotFound – a operação com o ID não existe.
404 ResourceNotFound – o recurso pedido não foi encontrado.
404 OperationIdNotFound – a operação com o ID não existe.
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 subscrição especificados.
405 UnsupportedReplicationOperation – foi iniciada uma operação de replicação não suportada na base de dados.
409 OperationCancelled - A operação foi cancelada pelo utilizador.
409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.
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.
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.
500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operaçã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.
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

Planned failover of a failover group

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


/**
 * Samples for InstanceFailoverGroups Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/InstanceFailoverGroupFailover.json
     */
    /**
     * Sample code: Planned failover of a failover group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAFailoverGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstanceFailoverGroups().failover("Default", "Japan West",
            "failover-group-test-3", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanWest/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 East",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance"
      }
    ]
  }
}

Código de estado:: 202

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

Partilhar via

Instance Failover Groups - Failover

Parâmetros do URI

Respostas

Exemplos

Planned failover of a failover group

Pedido de amostra

Resposta da amostra

Definições

InstanceFailoverGroup

InstanceFailoverGroupReadOnlyEndpoint

InstanceFailoverGroupReadWriteEndpoint

InstanceFailoverGroupReplicationRole

ManagedInstancePairInfo

PartnerRegionInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

Recursos adicionais