Share via

Obter progresso da perda de quorum

  • Artigo

Obtém o progresso de uma operação de perda de quorum em uma partição iniciada utilizando a API StartQuorumLoss.

Obtém o progresso de uma operação de perda de quorum iniciada com StartQuorumLoss, usando a OperationId fornecida.

Solicitação

Método URI da solicitação
GET /Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetQuorumLossProgress?api-version=6.0&OperationId={OperationId}&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
serviceId string Sim Caminho
partitionId string (uuid) Sim Caminho
api-version string Sim Consulta
OperationId string (uuid) Sim Consulta
timeout inteiro (int64) No Consulta

serviceId

Tipo: string
Obrigatório: sim

A identidade do serviço. Normalmente, essa ID é o nome completo do serviço sem o esquema de 'malha' do URI. A partir da versão 6.0, nomes hierárquicos são delimitados pelo caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" na versão 6.0 e superiores e and "myapp/app1/svc1" em versões anteriores.

partitionId

Tipo: cadeia de caracteres (uuid)
Obrigatório: sim

A identidade da partição.

api-version

Tipo: string
Obrigatório: sim
Padrão: 6.0

A versão da API. Esse parâmetro é necessário e seu valor deve ser '6.0'.

A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou foi alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nesta especificação.

Além disso, o runtime aceita qualquer versão que seja maior do que a versão mais recente com suporte até a versão atual do runtime. Portanto, se a versão mais recente da API for 6.0, mas se o runtime for 6.1, para facilitar a gravação dos clientes, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão documentada 6.0.

OperationId

Tipo: cadeia de caracteres (uuid)
Obrigatório: sim

Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente

timeout

Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.

Respostas

Código de status HTTP Descrição Esquema de Resposta
200 (OK) Informações sobre o progresso de uma operação de perda de quorum de partição.
 PartitionQuorumLossProgress
Todos os outros códigos de status A resposta de erro detalhada.
 FabricError

Exemplos

Obtém informações sobre uma operação de perda de quorum concluída

Isso mostra um exemplo de possível saída quando GetQuorumLossProgress atinge um Estado de Concluído. Se o Estado tiver um valor De execução, somente o campo Estado terá um valor.

Solicitação

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetQuorumLossProgress?api-version=6.0&OperationId=81fbaee7-4f49-44bb-a350-4cb2b51dbf26

Resposta 200

Corpo
{
  "State": "Completed",
  "InvokeQuorumLossResult": {
    "ErrorCode": "0",
    "SelectedPartition": {
      "ServiceName": "fabric:/myapp/myservice",
      "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
    }
  }
}

Obtém informações sobre uma operação de quorum em execução

Isso mostra um exemplo de possível saída quando GetQuorumLossProgress tem um Estado de Execução. Se o Estado tiver um valor De execução, somente o campo Estado terá um valor.

Solicitação

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetQuorumLossProgress?api-version=6.0&OperationId=81fbaee7-4f49-44bb-a350-4cb2b51dbf26

Resposta 200

Corpo
{
  "State": "Running"
}