Remover Réplica
Remove uma réplica de serviço em execução num nó.
Esta API simula uma falha de réplica do Service Fabric ao remover uma réplica de um cluster do Service Fabric. A remoção fecha a réplica, transita a réplica para a função Nenhum e, em seguida, remove todas as informações de estado da réplica do cluster. Esta API testa o caminho de remoção do estado da réplica e simula o caminho permanente da falha de relatório através das APIs cliente. Aviso – não existem verificações de segurança efetuadas quando esta API é utilizada. A utilização incorreta desta API pode levar à perda de dados para serviços com estado. Além disso, o sinalizador forceRemove afeta todas as outras réplicas alojadas no mesmo processo.
Pedir
Método | URI do pedido |
---|---|
POST | /Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete?api-version=6.0&ForceRemove={ForceRemove}&timeout={timeout} |
Parâmetros
Nome | Tipo | Necessário | Localização |
---|---|---|---|
nodeName |
string | Yes | Caminho |
partitionId |
cadeia (uuid) | Yes | Caminho |
replicaId |
string | Yes | Caminho |
api-version |
string | Yes | Consulta |
ForceRemove |
boolean | No | Consulta |
timeout |
número inteiro (int64) | No | Consulta |
nodeName
Tipo: cadeia
Obrigatório: Sim
O nome do nó.
partitionId
Tipo: cadeia (uuid)
Obrigatório: Sim
A identidade da partição.
replicaId
Tipo: cadeia
Obrigatório: Sim
O identificador da réplica.
api-version
Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.0
A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de 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 suporta mais do que uma versão da API. Esta é a versão suportada mais recente da API. Se for transmitida uma versão da API inferior, a resposta devolvida poderá ser diferente da documentada nesta especificação.
Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à 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 escrita dos clientes, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será conforme a versão documentada 6.0.
ForceRemove
Tipo: booleano
Obrigatório: Não
Remova uma aplicação ou serviço do Service Fabric com força sem passar pela sequência de encerramento correta. Este parâmetro pode ser utilizado para eliminar com força uma aplicação ou serviço para o qual a eliminação está a exceder o tempo limite devido a problemas no código de serviço que impedem o encerramento correto das réplicas.
timeout
Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos.
Respostas
Código de Estado HTTP | Description | Esquema de Resposta |
---|---|---|
200 (OK) | Uma operação bem-sucedida devolverá o código de estado 200. Uma operação bem-sucedida significa que o comando de reinício foi recebido pela réplica no nó e está em processo de reinício. |
|
Todos os outros códigos de estado | A resposta detalhada ao erro. |
FabricError |