sfctl partition
Consulte e gerencie partições para qualquer serviço.
Comandos
| Comando | Description |
|---|---|
| perda de dados | Esta API induzirá a perda de dados para a partição especificada. |
| status de perda de dados | Obtém o progresso de uma operação de perda de dados de partição iniciada usando a API StartDataLoss. |
| saúde | Obtém a integridade da partição do Service Fabric especificada. |
| informação | Obtém as informações sobre uma partição do Service Fabric. |
| list | Obtém a lista de partições de um serviço do Service Fabric. |
| carregar | Obtém as informações de carregamento da partição do Service Fabric especificada. |
| carga-reposição | Redefine a carga atual de uma partição do Service Fabric. |
| perda de quórum | Induz a perda de quórum para uma determinada partição de serviço com monitoração de estado. |
| status de perda de quórum | Obtém o progresso de uma operação de perda de quorum em uma partição iniciada usando a API StartQuorumLoss. |
| recuperar | Indica ao cluster do Service Fabric que ele deve tentar recuperar uma partição específica que está atualmente presa na perda de quórum. |
| recuperar-tudo | Indica ao cluster do Service Fabric que ele deve tentar recuperar quaisquer serviços (incluindo serviços do sistema) que estejam atualmente presos na perda de quórum. |
| relatório-saúde | Envia um relatório de integridade na partição do Service Fabric. |
| restart | Essa API reiniciará algumas ou todas as réplicas ou instâncias da partição especificada. |
| status de reinicialização | Obtém o progresso de uma operação PartitionRestart iniciada usando StartPartitionRestart. |
| svc-nome | Obtém o nome do serviço Service Fabric para uma partição. |
Perda de dados da partição SFCTL
Esta API induzirá a perda de dados para a partição especificada.
Ele acionará uma chamada para a API OnDataLossAsync da partição. Esta API induzirá a perda de dados para a partição especificada. Ele acionará uma chamada para a API OnDataLoss da partição. A perda real de dados dependerá do DataLossMode especificado.
- PartialDataLoss: Somente um quórum de réplicas é removido e OnDataLoss é acionado para a partição, mas a perda real de dados depende da presença de replicação em andamento.
- FullDataLoss: Todas as réplicas são removidas, portanto, todos os dados são perdidos e OnDataLoss é acionado. Essa API só deve ser chamada com um serviço stateful como destino. Não é aconselhável chamar essa API com um serviço do sistema como destino.
Nota
Uma vez que essa API tenha sido chamada, ela não pode ser revertida. Chamar CancelOperation só interromperá a execução e limpará o estado interno do sistema. Ele não restaurará os dados se o comando tiver progredido o suficiente para causar perda de dados. Chame a API GetDataLossProgress com o mesmo OperationId para retornar informações sobre a operação iniciada com essa API.
Argumentos
| Argumento | Description |
|---|---|
| --data-loss-mode [Obrigatório] | Esse enum é passado para a API StartDataLoss para indicar que tipo de perda de dados induzir. |
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
sfctl partição data-loss-status
Obtém o progresso de uma operação de perda de dados de partição iniciada usando a API StartDataLoss.
Obtém o progresso de uma operação de perda de dados iniciada com StartDataLoss, usando o OperationId.
Argumentos
| Argumento | Description |
|---|---|
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Estado de funcionamento da partição SFCTL
Obtém a integridade da partição do Service Fabric especificada.
Use EventsHealthStateFilter para filtrar a coleção de eventos de integridade relatados no serviço com base no estado de integridade. Use ReplicasHealthStateFilter para filtrar a coleção de objetos ReplicaHealthState na partição. Se você especificar uma partição que não existe no armazenamento de integridade, essa solicitação retornará um erro.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --events-health-state-filter | Permite filtrar a coleção de objetos HealthEvent retornados com base no estado de integridade. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. Somente os eventos que correspondem ao filtro são retornados. Todos os eventos são usados para avaliar o estado de integridade agregado. Se não for especificado, todas as entradas serão retornadas. Os valores de estado são enumeração baseada em sinalizador, de modo que o valor pode ser uma combinação desses valores, obtidos usando o operador bit a bit 'OR'. Por exemplo, se o valor fornecido for 6, todos os eventos com o valor HealthState de OK (2) e Warning (4) serão retornados. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --excluir-estatísticas de saúde | Indica se as estatísticas de integridade devem ser retornadas como parte do resultado da consulta. Falso por padrão. As estatísticas mostram o número de entidades crianças no estado de saúde Ok, Aviso e Erro. |
| --réplicas-saúde-estado-filtro | Permite filtrar a coleção de objetos ReplicaHealthState na partição. O valor pode ser obtido de membros ou operações bitwise em membros de HealthStateFilter. Somente réplicas que correspondam ao filtro serão retornadas. Todas as réplicas serão usadas para avaliar o estado de integridade agregado. Se não for especificado, todas as entradas serão devolvidas. Os valores de estado são enumeração baseada em sinalizador, portanto, o valor pode ser uma combinação desses valores obtidos usando o operador 'OR' bitwise. Por exemplo, se o valor fornecido for 6, todos os eventos com valor HealthState de OK (2) e Warning (4) serão retornados. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
informações sobre a partição sfctl
Obtém as informações sobre uma partição do Service Fabric.
Obtém as informações sobre a partição especificada. A resposta inclui o ID da partição, informações do esquema de particionamento, chaves suportadas pela partição, status, integridade e outros detalhes sobre a partição.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Lista de partições SFCTL
Obtém a lista de partições de um serviço do Service Fabric.
A resposta inclui o ID da partição, informações do esquema de particionamento, chaves suportadas pela partição, status, integridade e outros detalhes sobre a partição.
Argumentos
| Argumento | Description |
|---|---|
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --continuação-token | O parâmetro de token de continuação é usado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem em uma única resposta. Quando esse valor é passado para a próxima chamada de API, a API retorna o próximo conjunto de resultados. Se não houver mais resultados, o token de continuação não conterá um valor. O valor desse parâmetro não deve ser codificado por URL. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Carga de partição SFCTL
Obtém as informações de carregamento da partição do Service Fabric especificada.
Retorna informações sobre a carga de uma partição especificada. A resposta inclui uma lista de relatórios de carga para uma partição do Service Fabric. Cada relatório inclui o nome da métrica de carga, o valor e a última hora relatada em UTC.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
sfctl partição load-reset
Redefine a carga atual de uma partição do Service Fabric.
Redefine a carga atual de uma partição do Service Fabric para a carga padrão do serviço.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
perda de quórum de partição sfctl
Induz a perda de quórum para uma determinada partição de serviço com monitoração de estado.
Esta API é útil para uma situação de perda temporária de quórum no seu serviço. Chame a API GetQuorumLossProgress com o mesmo OperationId para retornar informações sobre a operação iniciada com essa API. Isso só pode ser chamado em serviços stateful persisted (HasPersistedState==true). Não use essa API em serviços sem monitoração de estado ou somente em serviços com monitoração de estado.
Argumentos
| Argumento | Description |
|---|---|
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --quorum-perda-duração [Obrigatório] | O período de tempo durante o qual a partição será mantida em perda de quórum. Isto deve ser especificado em segundos. |
| --quorum-loss-mode [Obrigatório] | Esse enum é passado para a API StartQuorumLoss para indicar que tipo de perda de quórum induzir. |
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
quorum-perda-status da partição sfctl
Obtém o progresso de uma operação de perda de quorum em uma partição iniciada usando a API StartQuorumLoss.
Obtém o progresso de uma operação de perda de quórum iniciada com StartQuorumLoss, usando o OperationId fornecido.
Argumentos
| Argumento | Description |
|---|---|
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Recuperação de partição SFCTL
Indica ao cluster do Service Fabric que ele deve tentar recuperar uma partição específica que está atualmente presa na perda de quórum.
Essa operação só deve ser executada se for sabido que as réplicas que estão inativas não podem ser recuperadas. O uso incorreto desta API pode causar perda potencial de dados.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Partição SFCTL Recover-All
Indica ao cluster do Service Fabric que ele deve tentar recuperar quaisquer serviços (incluindo serviços do sistema) que estejam atualmente presos na perda de quórum.
Essa operação só deve ser executada se for sabido que as réplicas que estão inativas não podem ser recuperadas. O uso incorreto desta API pode causar perda potencial de dados.
Argumentos
| Argumento | Description |
|---|---|
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Relatório de integridade da partição SFCTL
Envia um relatório de integridade na partição do Service Fabric.
Relata o estado de integridade da partição do Service Fabric especificada. O relatório deve conter as informações sobre a fonte do relatório de saúde e a propriedade em que é relatado. O relatório é enviado para uma partição de gateway do Service Fabric, que encaminha para o repositório de integridade. O relatório pode ser aceito pelo gateway, mas rejeitado pelo armazenamento de saúde após validação extra. Por exemplo, o armazenamento de integridade pode rejeitar o relatório devido a um parâmetro inválido, como um número de sequência obsoleto. Para ver se o relatório foi aplicado no repositório de integridade, verifique se o relatório aparece na seção de eventos.
Argumentos
| Argumento | Description |
|---|---|
| --health-property [Obrigatório] | A propriedade das informações de saúde. Uma entidade pode ter relatórios de integridade para propriedades diferentes. A propriedade é uma cadeia de caracteres e não uma enumeração fixa para permitir que o repórter tenha flexibilidade para categorizar a condição de estado que dispara o relatório. Por exemplo, um repórter com SourceId "LocalWatchdog" pode monitorar o estado do disco disponível em um nó, para que possa relatar a propriedade "AvailableDisk" nesse nó. O mesmo repórter pode monitorar a conectividade do nó, para que possa relatar uma propriedade "Conectividade" no mesmo nó. No repositório de integridade, esses relatórios são tratados como eventos de integridade separados para o nó especificado. Juntamente com o SourceId, a propriedade identifica exclusivamente as informações de integridade. |
| --health-state [Obrigatório] | Os valores possíveis incluem: 'Inválido', 'Ok', 'Aviso', 'Erro', 'Desconhecido'. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --source-id [Obrigatório] | O nome de origem que identifica o componente cliente/watchdog/system que gerou as informações de integridade. |
| --descrição | A descrição das informações de saúde. Ele representa o texto livre usado para adicionar informações legíveis por humanos sobre o relatório. O comprimento máximo da cadeia de caracteres para a descrição é de 4096 caracteres. Se a cadeia de caracteres fornecida for mais longa, ela será automaticamente truncada. Quando truncado, os últimos caracteres da descrição contêm um marcador "[Truncado]", e o tamanho total da cadeia de caracteres é de 4096 caracteres. A presença do marcador indica aos usuários que ocorreu truncamento. Observe que, quando truncada, a descrição tem menos de 4096 caracteres da cadeia de caracteres original. |
| --imediato | Um sinalizador que indica se o relatório deve ser enviado imediatamente. Um relatório de integridade é enviado para um Aplicativo de gateway do Service Fabric, que encaminha para o repositório de integridade. Se Immediate estiver definido como true, o relatório será enviado imediatamente do HTTP Gateway para o repositório de integridade, independentemente das configurações do cliente de malha que o Aplicativo de Gateway HTTP está usando. Isso é útil para relatórios críticos que devem ser enviados o mais rápido possível. Dependendo do tempo e de outras condições, o envio do relatório ainda pode falhar, por exemplo, se o Gateway HTTP estiver fechado ou se a mensagem não chegar ao Gateway. Se Immediate estiver definido como false, o relatório será enviado com base nas configurações do cliente de integridade do Gateway HTTP. Portanto, ele será lotado de acordo com a configuração HealthReportSendInterval. Essa é a configuração recomendada porque permite que o cliente de integridade otimize as mensagens de relatório de integridade para o armazenamento de integridade, bem como o processamento de relatórios de integridade. Por padrão, os relatórios não são enviados imediatamente. |
| --remover-quando-expirou | Valor que indica se o relatório é removido do armazenamento de integridade quando expira. Se definido como true, o relatório é removido do armazenamento de integridade depois de expirar. Se definido como false, o relatório é tratado como um erro quando expirado. O valor dessa propriedade é false por padrão. Quando os clientes relatam periodicamente, eles devem definir RemoveWhenExpired false (padrão). Desta forma, se o repórter tiver problemas (por exemplo, impasse) e não puder reportar, a entidade é avaliada com erro quando o relatório de saúde expira. Isso sinaliza a entidade como estando no estado de integridade de erro. |
| --número-sequência | O número de sequência para este relatório de integridade como uma cadeia de caracteres numérica. O número de sequência do relatório é usado pelo repositório de integridade para detetar relatórios obsoletos. Se não for especificado, um número de sequência é gerado automaticamente pelo cliente de integridade quando um relatório é adicionado. |
| --tempo limite -t | Padrão: 60. |
| --TTL | A duração durante a qual este relatório de integridade é válido. Este campo usa ISO8601 formato para especificar a duração. Quando os clientes reportam periodicamente, devem enviar relatórios com maior frequência do que o tempo de vida. Se os clientes relatarem a transição, eles podem definir o tempo de vida como infinito. Quando o tempo de vida expira, o evento de integridade que contém as informações de integridade é removido do armazenamento de integridade, se RemoveWhenExpired for true, ou avaliado em erro, se RemoveWhenExpired false. Se não for especificado, o tempo de vida assume como padrão o valor infinito. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
reinicialização da partição sfctl
Essa API reiniciará algumas ou todas as réplicas ou instâncias da partição especificada.
Esta API é útil para testar o failover. Se usado para direcionar uma partição de serviço sem monitoração de estado, RestartPartitionMode deve ser AllReplicasOrInstances. Chame a API GetPartitionRestartProgress usando o mesmo OperationId para obter o progresso.
Argumentos
| Argumento | Description |
|---|---|
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --restart-partition-mode [Obrigatório] | Descreva quais partições devem ser reiniciadas. |
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
status de reinicialização da partição sfctl
Obtém o progresso de uma operação PartitionRestart iniciada usando StartPartitionRestart.
Obtém o progresso de um PartitionRestart iniciado com StartPartitionRestart usando o OperationId fornecido.
Argumentos
| Argumento | Description |
|---|---|
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
sfctl partição svc-name
Obtém o nome do serviço Service Fabric para uma partição.
Obtém o nome do serviço para a partição especificada. Um erro 404 será retornado se a ID da partição não existir no cluster.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |