sfctl partition
Запрос секций для любой службы и управление ими.
Команды
| Команда | Description |
|---|---|
| data-loss | Этот API вызовет потерю данных в указанной секции. |
| data-loss-status | Возвращает ход выполнения операции потери данных, запущенной с помощью API StartDataLoss. |
| Здравоохранение | Возвращает состояние работоспособности указанной секции Service Fabric. |
| info | Возвращает сведения о секции Service Fabric. |
| список | Получает список секций службы Service Fabric. |
| загрузить | Возвращает сведения о нагрузке указанной секции Service Fabric. |
| load-reset | Сбрасывает текущую нагрузку секции Service Fabric. |
| quorum-loss | Вызывает потерю кворума в указанной секции службы с отслеживанием состояния. |
| quorum-loss-status | Возвращает ход выполнения операции потери кворума, запущенной с помощью API StartQuorumLoss. |
| восстановление | Указывает кластеру Service Fabric, что следует попытаться восстановить определенную секцию, которая в настоящее время находится в состоянии потери кворума. |
| recover-all | Указывает кластеру Service Fabric, что следует попытаться восстановить все службы (в том числе системные), которые в настоящее время находятся в состоянии потери кворума. |
| report-health | Отправляет отчет о работоспособности секции Service Fabric. |
| restart | Этот API перезапустит некоторые или все реплики или экземпляры указанной секции. |
| restart-status | Возвращает ход выполнения операции PartitionRestart, запущенной с помощью StartPartitionRestart. |
| svc-name | Возвращает имя службы Service Fabric для секции. |
sfctl partition data-loss
Этот API вызовет потерю данных в указанной секции.
Он активирует вызов API OnDataLossAsync секции. Этот API вызовет потерю данных в указанной секции. Он активирует вызов API OnDataLoss секции. Потеря фактических данных будет зависеть от указанного DataLossMode.
- PartialDataLoss. Только кворум реплик будет удален, и OnDataLoss запустится для секции, но фактическая потеря данных зависит от наличия репликации на лету.
- FullDataLoss. Все реплики удаляются, таким образом все данные будут потеряны и активируется OnDataLoss. Этот API следует вызывать только со службой с отслеживанием состояния в качестве целевого объекта. Вызов этого API с системной службой в качестве целевого объекта не рекомендуется.
Примечание.
Вызов этого API нельзя отменить. Вызов CancelOperation только остановит выполнение и очистит внутреннее состояния системы. Данные не восстановятся, если команда выполнялась достаточное время, чтобы вызвать потерю данных. Вызовите API GetDataLossProgress с тем же OperationId, чтобы вернуть сведения об операции, запущенной с помощью этого API.
Аргументы
| Аргумент | Description |
|---|---|
| --data-loss-mode [обязательный параметр] | Это перечисление передается в API StartDataLoss, чтобы указать, какой тип потери данных следует вызвать. |
| --operation-id [обязательный параметр] | Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition data-loss-status
Возвращает ход выполнения операции потери данных, запущенной с помощью API StartDataLoss.
Возвращает сведения о ходе выполнения операции с потерей данных, запущенной с помощью StartDataLoss, с использованием OperationId.
Аргументы
| Аргумент | Description |
|---|---|
| --operation-id [обязательный параметр] | Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition health
Возвращает состояние работоспособности указанной секции Service Fabric.
EventsHealthStateFilter используется для фильтрации получаемой коллекции событий работоспособности службы на основе состояния работоспособности. ReplicasHealthStateFilter используется для фильтрации коллекции объектов ReplicaHealthState для секции. Если указанная секция не существует в хранилище данных о работоспособности, то этот запрос возвращает ошибку.
Аргументы
| Аргумент | Description |
|---|---|
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --events-health-state-filter | Позволяет отфильтровать коллекцию возвращаемых объектов HealthEvent по состоянию работоспособности. Возможные значения для этого параметра — целочисленное значение одного из приведенных ниже состояний работоспособности. Возвращаются только те события, которые соответствуют заданному фильтру. Для оценки общего состояния работоспособности используются все события. Если фильтр не указан, возвращаются все записи. Значения состояния — это перечисление на основе флага, поэтому значение может представлять собой сочетание этих значений, полученное с помощью битового оператора OR. Например, если указано значение 6, то возвращаются все события со значениями HealthState "OK" (2) и "Warning" (4). -Default — значение по умолчанию. Соответствует любому значению HealthState. Значение равно нулю. -None — фильтр, который не соответствует какому-либо значению HealthState. Используется для возвращения нуля результатов для определенной коллекции состояний. Значение равно 1. -OK — фильтр, извлекающий входные данные с HealthState со значением "OK". Значение равно 2. -Warning — фильтр, извлекающий входные данные с HealthState со значением "Warning". Значение равно 4. -Error — фильтр, извлекающий входные данные с HealthState со значением "Error". Значение равно 8. -All — фильтр, извлекающий входные данные с любым значением HealthState. Значение равно 65535. |
| --exclude-health-statistics | Указывает, должна ли возвращаться статистика работоспособности в составе результатов запроса. Значение по умолчанию: false. Статистика содержит число дочерних сущностей в состоянии работоспособности OK, Warning и Error. |
| --replicas-health-state-filter | Позволяет фильтровать коллекцию объектов ReplicaHealthState для секции. Это значение можно получить из элементов HealthStateFilter или с помощью битовых операций с элементами HealthStateFilter. Возвратятся только те реплики, которые соответствуют заданному фильтру. Для оценки общего состояния работоспособности будут использоваться все реплики. Если фильтр не указан, возвратятся все записи. Значения состояния — это перечисление на основе флага. Поэтому значение может представлять собой сочетание этих значений, полученное с помощью битового оператора OR. Например, если указано значение 6, то возвратятся все события со значениями HealthState "OK" (2) и "Warning" (4). Возможные значения для этого параметра — целочисленное значение одного из приведенных ниже состояний работоспособности. -Default — значение по умолчанию. Соответствует любому значению HealthState. Значение равно нулю. -None — фильтр, который не соответствует какому-либо значению HealthState. Используется для возвращения нуля результатов для определенной коллекции состояний. Значение равно 1. -OK — фильтр, извлекающий входные данные с HealthState со значением "OK". Значение равно 2. -Warning — фильтр, извлекающий входные данные с HealthState со значением "Warning". Значение равно 4. -Error — фильтр, извлекающий входные данные с HealthState со значением "Error". Значение равно 8. -All — фильтр, извлекающий входные данные с любым значением HealthState. Значение равно 65535. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition info
Возвращает сведения о секции Service Fabric.
Возвращает сведения об указанной секции. Ответ содержит идентификатор секции, сведения о схеме секционирования, ключи, поддерживаемые секцией, состояние, данные о работоспособности и другие сведения о секции.
Аргументы
| Аргумент | Description |
|---|---|
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition list
Получает список секций службы Service Fabric.
Ответ содержит идентификатор секции, сведения о схеме секционирования, ключи, поддерживаемые секцией, состояние, данные о работоспособности и другие сведения о секции.
Аргументы
| Аргумент | Description |
|---|---|
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --continuation-token | Параметр маркера продолжения используется для получения следующего набора результатов. Маркер продолжения с непустым значением добавляется в ответ API, когда результаты из системы не помещаются в один ответ. Когда это значение передается в следующем вызове API, API возвращает следующий набор результатов. Если результаты отсутствуют, маркер продолжения не будет содержать значение. Значение этого параметра не должно быть указано в формате URL-адреса. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition load
Возвращает сведения о нагрузке указанной секции Service Fabric.
Возвращает сведения о нагрузке указанной секции. Ответ включает список отчетов по загрузке для секции Service Fabric. Каждый отчет содержит имя метрики нагрузки, значение и время последнего сообщения в формате UTC.
Аргументы
| Аргумент | Description |
|---|---|
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition load-reset
Сбрасывает текущую нагрузку секции Service Fabric.
Сбрасывает текущую нагрузку секции Service Fabric к загрузке по умолчанию для службы.
Аргументы
| Аргумент | Description |
|---|---|
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition quorum-loss
Вызывает потерю кворума в указанной секции службы с отслеживанием состояния.
Этот API полезен в ситуации временной потери кворума в службе. Вызовите API GetQuorumLossProgress с тем же OperationId, чтобы вернуть сведения об операции, запущенной с помощью этого API. Его можно вызвать только в постоянных службах с отслеживанием состояния (HasPersistedState имеет значение true). Не используйте этот API в службах без отслеживания состояния или в службах с отслеживанием состояния, применяемых только в памяти.
Аргументы
| Аргумент | Description |
|---|---|
| --operation-id [обязательный параметр] | Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --quorum-loss-duration [обязательный параметр] | Количество времени, в течение которого секция будет находиться в состоянии потери кворума. Значение должно указываться в секундах. |
| --quorum-loss-mode [обязательный параметр] | Это перечисление передается в API StartQuorumLoss, чтобы указать, какой тип потери кворума следует вызвать. |
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition quorum-loss-status
Возвращает ход выполнения операции потери кворума, запущенной с помощью API StartQuorumLoss.
Возвращает сведения о ходе выполнения операции потери кворума, запущенной с помощью StartQuorumLoss, с использованием предоставленного OperationId.
Аргументы
| Аргумент | Description |
|---|---|
| --operation-id [обязательный параметр] | Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition recover
Указывает кластеру Service Fabric, что следует попытаться восстановить определенную секцию, которая в настоящее время находится в состоянии потери кворума.
Эту операцию следует выполнять только в том случае, если известно, что неработающие реплики невозможно восстановить. Неправильное использование этого API может привести к потере данных.
Аргументы
| Аргумент | Description |
|---|---|
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition recover-all
Указывает кластеру Service Fabric, что следует попытаться восстановить все службы (в том числе системные), которые в настоящее время находятся в состоянии потери кворума.
Эту операцию следует выполнять только в том случае, если известно, что неработающие реплики невозможно восстановить. Неправильное использование этого API может привести к потере данных.
Аргументы
| Аргумент | Description |
|---|---|
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition report-health
Отправляет отчет о работоспособности секции Service Fabric.
Возвращает состояние работоспособности для указанной секции Service Fabric. Отчет должен содержать информацию об источнике отчета о работоспособности и свойстве, в котором об этом сообщается. Отчет отправляется в секцию шлюза Service Fabric, которая передает его в хранилище данных о работоспособности. Отчет может быть принят шлюзом, но затем отклонен хранилищем данных о работоспособности после дополнительной проверки. Например, хранилище данных о работоспособности может отклонить отчет из-за недопустимого параметра, например устаревшего порядкового номера. Чтобы проверить, применен ли отчет в хранилище данных о работоспособности, найдите этот отчет в разделе событий.
Аргументы
| Аргумент | Description |
|---|---|
| --health-property [обязательный параметр] | Свойство информации о работоспособности. Один объект может возвращать отчеты о работоспособности для разных свойств. Это свойство имеет строковый формат, а не фиксированное перечисление, чтобы создатель отчетов мог гибко классифицировать состояние, активировавшее отчет. Например, создатель отчета с идентификатором источника LocalWatchdog может отслеживать состояние доступного дискового пространства на узле и передавать для этого узла свойство AvailableDisk. Этот же создатель отчета может отслеживать подключения узла и передавать свойство Connectivity для того же узла. В хранилище данных о работоспособности эти отчеты обрабатываются как независимые события работоспособности для указанного узла. Кроме идентификатора источника, свойство однозначно идентифицирует данные о работоспособности. |
| --health-state [обязательный параметр] | Возможные значения: Invalid, OK, Warning, Error, Unknown. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --source-id [обязательный параметр] | Имя источника, которое определяет клиента, службу наблюдения или компонент системы, создавший информацию о работоспособности. |
| --description | Описание информации о работоспособности. Это свойство предоставляет информацию об отчете в произвольном текстовом формате, доступном для чтения. Максимальная длина строки для описания составляет 4096 символов. Более длинные строки автоматически усекаются. При усечении в последние символы описания помещается маркер [Truncated], длина которого входит в строку длиной 4096 символов. Наличие маркера указывает на усечение. Обратите внимание, что усеченное описание включает менее 4096 символов исходной строки. |
| --immediate | Этот флаг обозначает, что отчет нужно отправить немедленно. Отчет о работоспособности отправляется в приложение шлюза Service Fabric, которое передает его в хранилище данных о работоспособности. Если флагу Immediate задано значение true, отчет немедленно отправляется через шлюз HTTP в хранилище данных о работоспособности, независимо от параметров клиента структуры, которые использует приложение шлюза HTTP. Это полезно для критически важных отчетов, которые необходимо передать как можно быстрее. В зависимости от времени и других условий отправка отчета может завершиться сбоем, например, если шлюз HTTP закрыт или сообщение не достигает этого шлюза. Если флагу Immediate задано значение false, отчет отправляется с учетом параметров клиента работоспособности через шлюз HTTP. Это значит, что он будет включен в пакет отчетов в соответствии со значением параметра HealthReportSendInterval. Рекомендуется применять именно такой вариант, так как он позволяет клиенту работоспособности оптимизировать отправку отчетов в хранилище данных о работоспособности, а также обработку отчетов о работоспособности. По умолчанию отчеты не отправляются немедленно. |
| --remove-when-expired | Это значение указывает, удаляется ли отчет из хранилища работоспособности после истечения срока его действия. Если задано значение true, отчет будет удален из хранилища работоспособности после истечения срока его действия. Если задано значение false, отчет с истекшим сроком действия рассматривается как указывающий на ошибку. Для этого свойства по умолчанию используется значение false. Если клиенты создают периодические отчеты, для параметра RemoveWhenExpired следует использовать значение false (по умолчанию). Если возникнет проблема с создателем отчетов (например, взаимоблокировка), не позволяющая ему отправить следующий отчет, это позволит зарегистрировать ошибку для сущности с истекшим отчетом о работоспособности. Такая сущность будет находиться в состоянии "Ошибка работоспособности". |
| --sequence-number | Порядковый номер отчета о работоспособности в формате числовой строки. Порядковый номер отчета используется хранилищем данных о работоспособности для отслеживания устаревших отчетов. Если значение не указано, порядковый номер автоматически создается клиентом работоспособности при добавлении отчета. |
| --timeout -t | Значение по умолчанию: 60. |
| --ttl | Срок, в течение которого отчет о работоспособности считается действительным. В этом поле указывается длительность в формате ISO8601. Если клиенты создают периодические отчеты, периодичность отправки отчетов должна быть выше, чем срок жизни отчетов. Если клиенты передают отчеты об изменении состояния, для них можно установить бесконечный срок действия. По истечении срока жизни событие работоспособности, которое содержит данные о работоспособности, удаляется из хранилища данных о работоспособности (если RemoveWhenExpired имеет значение true) или считается ошибкой (если RemoveWhenExpired имеет значение false). Если значение не указано, по умолчанию устанавливается бесконечный срок жизни. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition restart
Этот API перезапустит некоторые или все реплики или экземпляры указанной секции.
Этот API удобен для тестирования отработки отказа. Если он используется для секции службы без отслеживания состояния, то параметр RestartPartitionMode должен иметь значение AllReplicasOrInstances. Вызовите API GetPartitionRestartProgress, указав то же значение OperationId, чтобы узнать ход выполнения.
Аргументы
| Аргумент | Description |
|---|---|
| --operation-id [обязательный параметр] | Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --restart-partition-mode [обязательный параметр] | Указывает, какие секции нужно перезапустить. |
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition restart-status
Возвращает ход выполнения операции PartitionRestart, запущенной с помощью StartPartitionRestart.
Возвращает сведения о ходе выполнения PartitionRestart, запущенного с помощью StartPartitionRestart, с использованием предоставленного OperationId.
Аргументы
| Аргумент | Description |
|---|---|
| --operation-id [обязательный параметр] | Идентификатор GUID, определяющий вызов этого API. Он передается в соответствующий API GetProgress. |
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --service-id [обязательный параметр] | Идентификатор службы. Обычно он содержит полное имя службы из URI службы без указания схемы "fabric:". Начиная с версии 6.0, иерархические имена разделяются знаком "~". Например, если имя службы — "fabric:/myapp/app1/svc1", то в версии 6.0 и более поздних версиях идентификатором службы будет "myapp~app1~svc1", а в предыдущих версиях идентификатором был бы "myapp/app1/svc1". |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
sfctl partition svc-name
Возвращает имя службы Service Fabric для секции.
Возвращает имя службы для заданной секции. Возвращается сообщение об ошибке 404, если идентификатор секции не существует в кластере.
Аргументы
| Аргумент | Description |
|---|---|
| --partition-id [обязательный параметр] | Идентификатор секции. |
| --timeout -t | Время ожидания сервера для выполнения операции (в секундах). Время ожидания — это интервал, в течение которого клиент готов ждать выполнения запрошенной операции. Значение этого параметра по умолчанию — 60 секунд. Значение по умолчанию: 60. |
Глобальные аргументы
| Аргумент | Description |
|---|---|
| --debug | Повышение уровня детализации журнала для включения всех журналов отладки. |
| --help -h | Отображение этого справочного сообщения и выход. |
| --output -o | Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json. |
| --query | Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/. |
| --verbose | Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug. |
Следующие шаги
- Настройте интерфейс командной строки Service Fabric.
- Узнайте, как использовать интерфейс командной строки Service Fabric, с помощью примеров сценариев.