PUT suppliers/{supplier} (режим мультитенантности)
12 августа 2025
ID 296212
Обновление указанной информации об источнике данных об угрозах в рамках указанного тенанта.
С помощью этого запроса могут обновляться только источники данных об угрозах, созданные с помощью REST API.
Путь
/api/%API_VERSION%/{TenantName}/suppliers/{supplier}
Метод
PUT
Заголовки запроса
Этот запрос имеет следующие заголовки.
Заголовки запроса
Имя | Значение | Описание |
|---|---|---|
| String (base 64) | |
|
| Тип содержимого ответа. |
|
| Тип содержимого запроса. Также можно указать кодировку |
| Integer | Размер тела запроса в байтах. Максимальный размер тела этого запроса составляет 128 МБ ( |
Параметры запроса
Этот запрос имеет следующие параметры:
Параметры запроса
Имя | Тип параметра | Описание |
|---|---|---|
| Путь | Имя источника данных об угрозах. |
Тело запроса
Тело этого запроса содержит массив JSON с объектом источника данных об угрозах. Должен быть указан только один объект источника данных об угрозах.
[
{
"name":"%SUPPLIER_NAME%",
"status":"%SUPPLIER_STATUS%,
"confidence": %SUPPLIER_CONFIDENCE%,
"retention": %SUPPLIER_RETENTION%,
"vendor": "%SUPPLIER_VENDOR%"
}
]
Свойства объекта источника данных об угрозах описаны в следующей таблице.
Свойства объекта источника данных об угрозах
Свойство | Значение | Обязательный | Описание |
|---|---|---|---|
| String | Нет | Имя источника данных об угрозах. |
| String | Нет | Статус источника данных об угрозах. Если источник данных об угрозах требуется включить, значение должно быть Если источник данных об угрозах требуется отключить, значение должно быть |
| Integer | Нет | Уровень доверия к индикаторам из этого источника данных об угрозах. |
| Integer | Нет | Срок хранения индикаторов в минутах. Этот параметр определяет период, по истечении которого индикаторы этого источника данных об угрозах перестают использоваться в сопоставлении. |
| String | Нет | Имя поставщика источника данных об угрозах. |
Пример запроса
Ниже приведен пример запроса PUT suppliers/{supplier}.
PUT https://192.168.2.57/api/1.3/ExampleTenant/
Accept: application/json Content-Type: application/json Authorization: Basic Content-Length: 41
[ {"name":"NewName", "confidence": 90} ] |
Заголовки ответа
Ответ имеет следующие заголовки.
Заголовки ответа
Имя | Значение | Описание |
|---|---|---|
|
| Тип содержимого ответа. |
| Integer | Размер тела ответа в байтах. |
Тело ответа
Тело ответа содержит объект JSON со статусом операции.
[
{
"status": "Supplier info successfully updated"
}
]
Свойства объекта статуса описаны в следующей таблице.
Свойства объекта статуса
Свойство | Значение | Описание |
|---|---|---|
| String | Статус операции. |
Пример ответа
Ниже приведен пример ответа на запрос PUT suppliers/{supplier}.
НТТР/1.3 201 ОК Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 46
[{"status": "Supplier info successfully updated"}] |
Ответы с ошибкой
Ответы с ошибкой содержат информацию о статусе ответа.
Ответ с ошибкой содержит объект JSON с описанием ошибки.
[
{
"status": "An error occurred while updating Supplier info",
"reason": "%REASON%"
}
]
Описание свойств объекта ошибки приведено в следующей таблице.
Свойства объекта ошибки
Свойство | Значение | Описание |
|---|---|---|
| String | Описание ошибки. |
| String | Причина ошибки. |
Пример ошибочного ответа
Ниже приведен пример ответа с ошибкой на запрос PUT suppliers/{supplier}.
НТТР/1.3 404 Supplier doesn't exist Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 93
[{"status": "An error occurred while updating supplier info", "reason": "Supplier doesn't exist"}] |