Просмотр кода страницы AWS обнаружение аномалий API - PUT конфигурация

Обновляет конфигурацию обнаружения аномалий для AWS.

Запрос использует в качестве полезной нагрузки <code>application/json</code> формат.
{| class="wikitable"
| rowspan="2" |PUT
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws</nowiki></code>
|-
|Среда АктивногоШлюза
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws</nowiki></code>
|}

== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Запись конфигурации ( <code>WriteConfig</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимость
|-
|body
|AwsAnomalyDetectionConfig
|Тело запроса в формате JSON, содержащее параметры конфигурации обнаружения аномалий AWS.
|body
|по желанию
|}

=== Объекты тела запроса ===

==== Объект <code>AwsAnomalyDetectionConfig</code> ====
Конфигурация обнаружения аномалий для AWS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|metadata
|ConfigurationMetadata
|Метаданные, полезные для отладки
|по желанию
|-
|rdsHighCpuDetection
|RdsHighCpuDetectionConfig
|Конфигурация высокой загрузки ЦП при обнаружении RDS.
|требуется
|-
|rdsHighWriteReadLatencyDetection
|RdsHighWriteReadLatencyDetectionConfig
|Конфигурация обнаружения высокой задержки записи/чтения RDS.
|требуется
|-
|rdsLowStorageDetection
|RdsLowStorageDetectionConfig
|Конфигурация низкого свободного места на диске при обнаружении RDS.
|требуется
|-
|rdsHighMemoryDetection
|RdsHighMemoryDetectionConfig
|Конфигурация RDS с обнаружением нехватки памяти.
|требуется
|-
|elbHighConnectionErrorsDetection
|ElbHighConnectionErrorsDetectionConfig
|Конфигурация большого количества ошибок соединения с серверной частью при обнаружении ELB.
|требуется
|-
|rdsRestartsSequenceDetection
|RdsRestartsSequenceDetectionConfig
|Конфигурация последовательности перезапусков при обнаружении RDS.
|требуется
|-
|lambdaHighErrorRateDetection
|LambdaHighErrorRateDetectionConfig
|Конфигурация обнаружения высокой частоты ошибок AWS Lambda.
|требуется
|-
|ec2CandidateCpuSaturationDetection
|Ec2CandidateCpuSaturationDetectionConfig
|Конфигурация высокой загрузки ЦП на EC2 без установленного агента (кандидат на мониторинг). Если null, то эта конфигурация не будет изменена.
|по желанию
|}

==== Объект <code>ConfigurationMetadata</code> ====
Метаданные, полезные для отладки
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|configurationVersions
|integer[]
|Отсортированный список номеров версий конфигурации.
|по желанию
|-
|currentConfigurationVersions
|string[]
|Отсортированный список номеров версий конфигурации.
|по желанию
|-
|clusterVersion
|string
|Версия Ключ-АСТРОМ.
|по желанию
|}

==== Объект <code>RdsHighCpuDetectionConfig</code> ====
Конфигурация высокой загрузки ЦП при обнаружении RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsHighCpuThresholds
|Пользовательские пороги высокой загрузки ЦП в RDS. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>RdsHighCpuThresholds</code> ====
Пользовательские пороги высокой загрузки ЦП в RDS. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|cpuUsagePercentage
|integer
|Предупреждать, если загрузка ЦП превышает ''X'' % в 3 из 5 выборок.
|требуется
|}

==== Объект <code>RdsHighWriteReadLatencyDetectionConfig</code> ====
Конфигурация обнаружения высокой задержки записи/чтения RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsHighLatencyThresholds
|Пользовательские пороговые значения для высокой задержки записи/чтения RDS. Если не установлено, используется автоматический режим
|по желанию
|}

==== Объект <code>RdsHighLatencyThresholds</code> ====
Пользовательские пороговые значения для высокой задержки записи/чтения RDS. Если не установлено, используется автоматический режим
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|writeReadLatency
|integer
|Оповещение, если задержка чтения/записи превышает ''X'' миллисекунд в 3 из 5 выборок.
|требуется
|}

==== Объект _ <code>RdsLowStorageDetectionConfig</code> ====
Конфигурация низкого свободного места на диске при обнаружении RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsLowStorageThresholds
|Пользовательские пороги для низкого свободного места на RDS. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>RdsLowStorageThresholds</code> ====
Пользовательские пороги для низкого свободного места на RDS. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|freeStoragePercentage
|integer
|Предупреждать, если свободное пространство хранения, разделенное на выделенное хранилище, меньше ''X'' % в 3 из 5 выборок.
|требуется
|}

==== Объект <code>RdsHighMemoryDetectionConfig</code> ====
Конфигурация RDS с обнаружением нехватки памяти.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsHighMemoryThresholds
|Пользовательские пороги для RDS, у которых заканчивается память. Если не установлено, используется автоматический режим.

Для срабатывания оповещения должны быть выполнены все условия.
|по желанию
|}

==== Объект <code>RdsHighMemoryThresholds</code> ====
Пользовательские пороги для RDS, у которых заканчивается память. Если не установлено, используется автоматический режим.

Для срабатывания оповещения должны быть выполнены все условия.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|freeMemory
|number
|Свободная память меньше ''X'' мегабайт в 3 из 5 образцов.
|требуется
|-
|swapUsage
|number
|Использование подкачки превышает ''X'' гигабайт в 3 из 5 образцов.
|требуется
|}

==== Объект <code>ElbHighConnectionErrorsDetectionConfig</code> ====
Конфигурация большого количества ошибок соединения с серверной частью при обнаружении ELB.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|ElbHighConnectionErrorsThresholds
|Пользовательские пороги для большого количества ошибок соединения с серверной частью на ELB. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>ElbHighConnectionErrorsThresholds</code> ====
Пользовательские пороги для большого количества ошибок соединения с серверной частью на ELB. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|connectionErrorsPerMinute
|integer
|Оповещение, если количество ошибок соединения с серверной частью превышает ''X'' в минуту в 3 из 5 выборок.
|требуется
|}

==== Объект <code>RdsRestartsSequenceDetectionConfig</code> ====
Конфигурация последовательности перезапусков при обнаружении RDS.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|RdsRestartsThresholds
|Пользовательские пороги для последовательности перезапусков в RDS. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>RdsRestartsThresholds</code> ====
Пользовательские пороги для последовательности перезапусков в RDS. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|restartsPerMinute
|integer
|Предупреждать, если количество перезапусков ''X'' в минуту или выше в 3 из 20 образцов.
|требуется
|}

==== Объект <code>LambdaHighErrorRateDetectionConfig</code> ====
Конфигурация обнаружения высокой частоты ошибок AWS Lambda.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|LambdaHighErrorRateThresholds
|Пользовательские пороговые значения для высокой частоты ошибок AWS Lambda. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>LambdaHighErrorRateThresholds</code> ====
Пользовательские пороговые значения для высокой частоты ошибок AWS Lambda. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|failedInvocationsRate
|integer
|Оповещение, если частота неудачных вызовов превышает ''X'' % в 3 из 5 выборок.
|требуется
|}

==== Объект <code>Ec2CandidateCpuSaturationDetectionConfig</code> ====
Конфигурация высокой загрузки ЦП на EC2 без установленного агента (кандидат на мониторинг). Если null, то эта конфигурация не будет изменена.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|enabled
|boolean
|Обнаружение включено ( <code>true</code>) или отключено ( <code>false</code>).
|требуется
|-
|customThresholds
|Ec2CandidateCpuSaturationThresholds
|Пользовательские пороги высокой загрузки ЦП для кандидата на мониторинг EC2. Если не установлено, используется автоматический режим.
|по желанию
|}

==== Объект <code>Ec2CandidateCpuSaturationThresholds</code> ====
Пользовательские пороги высокой загрузки ЦП для кандидата на мониторинг EC2. Если не установлено, используется автоматический режим.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|cpuUsagePercentage
|integer
|Предупреждать, если загрузка ЦП превышает ''X'' % в 3 из 5 выборок.
|требуется
|}

=== JSON-модель тела запроса ===
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
 <code>{
   "metadata": {
     "configurationVersions": [
       4,
       2
     ],
     "clusterVersion": "Mock version"
   },
   "rdsHighCpuDetection": {
     "enabled": true,
     "customThresholds": {
       "cpuUsagePercentage": 99
     }
   },
   "rdsHighWriteReadLatencyDetection": {
     "enabled": true,
     "customThresholds": {
       "writeReadLatency": 800
     }
   },
   "rdsLowStorageDetection": {
     "enabled": true,
     "customThresholds": {
       "freeStoragePercentage": 7
     }
   },
   "rdsHighMemoryDetection": {
     "enabled": true,
     "customThresholds": {
       "freeMemory": 96.99,
       "swapUsage": 5.5
     }
   },
   "elbHighConnectionErrorsDetection": {
     "enabled": true,
     "customThresholds": {
       "connectionErrorsPerMinute": 4
     }
   },
   "rdsRestartsSequenceDetection": {
     "enabled": true,
     "customThresholds": {
       "restartsPerMinute": 3
     }
   },
   "lambdaHighErrorRateDetection": {
     "enabled": true,
     "customThresholds": {
       "failedInvocationsRate": 2
     }
   },
   "ec2CandidateCpuSaturationDetection": {
     "enabled": true,
     "customThresholds": {
       "cpuUsagePercentage": 98
     }
   }
 }</code>

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|204
|
|Успех. Конфигурация обновлена. Ответ не имеет тела.
|-
|400
|ErrorEnvelope
|Не удалось. Ввод недействителен.
|}

== Проверка полезной нагрузки ==
Мы рекомендуем вам проверить полезную нагрузку перед ее отправкой с фактическим запросом. Код ответа 204 указывает на действительную полезную нагрузку.

Запрос использует в качестве полезной нагрузки <code>application/json</code> формат.
{| class="wikitable"
| rowspan="2" |POST
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws/validator</nowiki></code>
|-
|Среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws/validator</nowiki></code>
|}

=== Аутентификация ===
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Запись конфигурации ( <code>WriteConfig</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

=== Ответ ===

==== Коды ответов ====
{| class="wikitable"
!Код
|Тип
!Описание
|-
|204
|
|Подтверждено. Представленная конфигурация действительна. Ответ не имеет тела.
|-
|400
|ErrorEnvelope
|Не удалось. Ввод недействителен.
|}

== Пример ==
В этом примере запрос обновляет конфигурацию обнаружения аномалий для AWS из примера запроса GET . Он переключает высокую загрузку ЦП при обнаружении RDS в режим настраиваемого порога и устанавливает порог 90 %. Он также отключает обнаружение нехватки памяти RDS .

Маркер API передается в заголовке авторизации .

Вы можете скачать или скопировать образец тела запроса, чтобы попробовать его самостоятельно. Обязательно создайте резервную копию текущей конфигурации с помощью вызова конфигурации GET AWS для обнаружения аномалий .

==== Curl ====
 <code>curl -X PUT \
   <nowiki>https://mySampleEnv.live.ruscomtech.ru/api/config/v1/anomalyDetection/aws</nowiki> \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
   -H 'Content-Type: application/json' \
   -d '{
   "rdsHighCpuDetection": {
     "enabled": true,
     "customThresholds": {
       "cpuUsagePercentage": 90
     }
   },
   "rdsHighWriteReadLatencyDetection": {
     "enabled": true
   },
   "rdsLowStorageDetection": {
     "enabled": true
   },
   "rdsHighMemoryDetection": {
     "enabled": false
   },
   "elbHighConnectionErrorsDetection": {
     "enabled": true
   },
   "rdsRestartsSequenceDetection": {
     "enabled": true
   },
   "lambdaHighErrorRateDetection": {
     "enabled": true
   }
 }
 '</code>

==== URL-адрес запроса ====
 <code><nowiki>https://mySampleEnv.live.ruscomtech.ru/api/config/v1/anomalyDetection/aws</nowiki></code>

==== Тело запроса ====
 <code>{
   "rdsHighCpuDetection": {
     "enabled": true,
     "customThresholds": {
       "cpuUsagePercentage": 90
     }
   },
   "rdsHighWriteReadLatencyDetection": {
     "enabled": true
   },
   "rdsLowStorageDetection": {
     "enabled": true
   },
   "rdsHighMemoryDetection": {
     "enabled": false
   },
   "elbHighConnectionErrorsDetection": {
     "enabled": true
   },
   "rdsRestartsSequenceDetection": {
     "enabled": true
   },
   "lambdaHighErrorRateDetection": {
     "enabled": true
   }
 }</code>

==== Код ответа ====
204

==== Результат ====
Обновленная конфигурация имеет следующие параметры: