ENetrebin в 10:44, 25 октября 2022

2022-10-25T10:44:22Z

← Предыдущая		Версия 10:44, 25 октября 2022
Строка 216:		Строка 216:
	==== Результат ====		==== Результат ====
	Подсветка показывает параметры, представленные в запросе.		Подсветка показывает параметры, представленные в запросе.

			[[Файл:syn3.png]]

ENetrebin: Новая страница: «Передает информацию о сторонних синтетических событиях в Ключ-АСТРОМ. Запрос используе...»

2022-10-25T10:42:12Z

Новая страница: «Передает информацию о сторонних синтетических событиях в Ключ-АСТРОМ. Запрос используе...»

Новая страница

Передает информацию о сторонних синтетических событиях в Ключ-АСТРОМ.

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

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

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимость
|-
|body
|3rdPartySyntheticEvents
|Тело JSON запроса. Содержит сторонние синтетические события.
|body
|требуется
|}

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

==== Объект <code>3rdPartySyntheticEvents</code> ====
Список сторонних синтетических событий.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|syntheticEngineName
|string
|Тип стороннего синтетического монитора.
|требуется
|-
|open
|3rdPartyEventOpenNotification[]
|Список открытых сторонних синтетических событий.
|по желанию
|-
|resolved
|3rdPartyEventResolvedNotification[]
|Список закрытых сторонних синтетических событий.
|по желанию
|}

==== Объект <code>3rdPartyEventOpenNotification</code> ====
Открытое стороннее синтетическое событие.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|testId
|string
|Идентификатор стороннего синтетического монитора.
|требуется
|-
|eventId
|string
|Уникальный идентификатор события.
|требуется
|-
|name
|string
|Название события.
|требуется
|-
|eventType
|string
|Тип события.

Элемент может содержать эти значения

* <code>testOutage</code>
* <code>testSlowdown</code>
|требуется
|-
|reason
|string
|Причина события.
|требуется
|-
|startTimestamp
|integer
|Отметка времени начала события в миллисекундах UTC.
|требуется
|-
|locationIds
|string[]
|Список идентификаторов сторонних синтетических локаций, где происходит событие.
|требуется
|}

==== Объект <code>3rdPartyEventResolvedNotification</code> ====
Закрытое стороннее синтетическое мероприятие.
{| class="wikitable"
!Элемент
!Тип
!Описание
!Необходимость
|-
|testId
|string
|Идентификатор стороннего синтетического монитора.
|требуется
|-
|eventId
|string
|Уникальный идентификатор события.
|требуется
|-
|endTimestamp
|integer
|Отметка времени окончания события в миллисекундах UTC.
|требуется
|}

=== JSON-модель тела запроса ===
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
<code>{
"syntheticEngineName": "string",
"open": [
{
"testId": "string",
"eventId": "string",
"name": "string",
"eventType": "testOutage",
"reason": "string",
"startTimestamp": 1,
"locationIds": [
"string"
]
}
],
"resolved": [
{
"testId": "string",
"eventId": "string",
"endTimestamp": 1
}
]
}</code>

== Ответ ==

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

== Обновите существующий сторонний монитор ==
Чтобы обновить существующий сторонний монитор, укажите его движок в поле syntheticEngineName<code>3rdPartySyntheticTests</code> объекта и его ID в поле id<code>3rdPartySyntheticTest</code> объекта.

Вы должны представить все параметры монитора. Не изменяйте значения параметров, которые вы не хотите изменять.

== Пример ==
В этом примере запрос добавляет в пример синтетического монитора событие отключения — 1 сторонний синтетический монитор из ''POST прочие мониторы'' в Ключ-АСТРОМ .

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

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

==== Curl ====
<code>curl -X POST \
<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/synthetic/ext/events</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{<truncated - see the Request body section below>}
'</code>

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

==== Тело запроса ====
<code>{
"syntheticEngineName": "My third-party synthetic",
"open": [
{
"testId": "3rdPartySyntheticMonitor1",
"eventId": "extOpenEvent1-1",
"name": "example of event",
"reason": "sample outage",
"eventType": "testOutage",
"locationIds": ["Linz1"],
"startTimestamp": 1543582285957
}
],
"resolved": []
}</code>

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

==== Результат ====
Подсветка показывает параметры, представленные в запросе.

POST прочие события - История изменений

ENetrebin в 10:44, 25 октября 2022

ENetrebin: Новая страница: «Передает информацию о сторонних синтетических событиях в Ключ-АСТРОМ. Запрос используе...»