POST пакетное выполнение

Запускает пакетное выполнение синтетических мониторов.

Запрос создает и использует в качестве полезной нагрузки application/json формат.

POST	Managed	https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/executions/batch
	Среда ActiveGate	https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/executions/batch

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с областью выполнения Запись синтетического монитора ( syntheticExecutions.write) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр	Тип	Описание	In	Необходимость
body	SyntheticOnDemandExecutionRequest	Тело JSON запроса. Содержит параметры инициированного выполнения по требованию.	body	по желанию

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

Объект SyntheticOnDemandExecutionRequest

Содержит параметры для запуска по запросу мониторов, идентифицированных тегами, приложениями или службами.

Элемент	Тип	Описание	Необходимость
processingMode	string	Режим обработки выполнения Элемент может содержать эти значения STANDARD DISABLE_PROBLEM_DETECTION EXECUTIONS_DETAILS_ONLY	по желанию
failOnPerformanceIssue	boolean	Если true, статус будет FAILED в случае проблем с производительностью.	по желанию
stopOnProblem	boolean	Если true, выполнение не будет запланировано в случае возникновения проблемы.	по желанию
monitors	SyntheticOnDemandExecutionRequestMonitor[]	Список мониторов, которые будут активированы.	по желанию
group	SyntheticOnDemandExecutionRequestGroup	Содержит параметры для запуска по запросу мониторов, идентифицированных тегами, приложениями или службами.	по желанию

Объект SyntheticOnDemandExecutionRequestMonitor

Содержит мониторы, запускаемые по запросу из указанных местоположений.

Элемент	Тип	Описание	Необходимость
monitorId	string	Идентификатор монитора	требуется
locations	string []	Места, из которых должен выполняться монитор.	по желанию

Объект SyntheticOnDemandExecutionRequestGroup

Содержит параметры для запуска по запросу мониторов, идентифицированных тегами, приложениями или службами.

Элемент	Тип	Описание	Необходимость
tags	string[]	Список тегов. Будут выполняться только мониторы со всеми назначенными тегами.	по желанию
applications	string[]	Список идентификаторов приложений. Будут выполняться только мониторы со всеми назначенными приложениями.	по желанию
services	string[]	Список идентификаторов услуг. Будут выполняться только мониторы со всеми назначенными службами.	по желанию
locations	string[]	Места, откуда должны выполняться мониторы.	по желанию

JSON-модель тела запроса

Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.

{
  "processingMode": "EXECUTIONS_DETAILS_ONLY",
  "failOnPerformanceIssue": "false",
  "stopOnProblem": "true",
  "monitors": [
    {
      "monitorId": "HTTP_CHECK-6349B98E1CD87352",
      "locations": [
        "SYNTHETIC_LOCATION-9BB04DAEBA71B8CA",
        "SYNTHETIC_LOCATION-ACCA399FAA1194DD"
      ]
    }
  ],
  "group": {
    "applications": [
      "APPLICATION-CD4BEF05FA9DD044"
    ],
    "services": [
      "SERVICE-01C6C1282960638B",
      "SERVICE-B18840B4E3115C1A"
    ],
    "tags": [
      "tag-production",
      "another-tag"
    ]
  }
}

Ответ

Коды ответов

Код	Тип	Описание
201	SyntheticOnDemandExecutionResult	Успех. Детали ответа монитора на выполнение

Объекты тела ответа

Объект SyntheticOnDemandExecutionResult

Результат выполнения синтетического монитора по требованию.

Элемент	Тип	Описание
batchId	string	Идентификатор пакета запущенных исполнений.
triggeringProblemsCount	integer	Общее количество проблем в пакете.
triggeringProblemsDetails	SyntheticOnDemandTriggeringProblemDetails[]	Список с объектами, для которых возникли проблемы с запуском.
triggeredCount	integer	Общее количество инициированных исполнений в пакете.
triggered	SyntheticOnDemandTriggeredMonitor[]	Мониторы, для которых были инициированы выполнения по требованию.

Объект SyntheticOnDemandTriggeringProblemDetails

Содержит сведения о проблемах, возникших при запуске выполнения по требованию.

Элемент	Тип	Описание
entityId	string	Идентификатор объекта.
locationId	string	Идентификатор местоположения.
cause	string	Причина не запуска сущности.

Объект SyntheticOnDemandTriggeredMonitor

Содержит список запусков монитора по запросу.

Элемент	Тип	Описание
monitorId	string	Идентификатор монитора.
executions	SyntheticOnDemandTriggeredExecutionDetails[]	Список инициированных выполнений.

Объект SyntheticOnDemandTriggeredExecutionDetails

Содержит сведения о запущенном выполнении по требованию.

Элемент	Тип	Описание
executionId	string	Идентификатор выполнения.
locationId	string	Идентификатор места, из которого должен выполняться монитор.

JSON-модель тела ответа

{
  "batchId": "22396514015719218",
  "triggeringProblemsCount": 4,
  "triggeringProblemsDetails": [
    {
      "entityId": "HTTP_CHECK-6349B98E1CD87352",
      "locationId": "SYNTHETIC_LOCAT-9BB04DAEBA71B8CA",
      "cause": "Location not found"
    },
    {
      "entityId": "HTTP_CHECK-6349B98E1CD85432",
      "cause": "Monitor not found"
    },
    {
      "entityId": "HTTP_HACK-AAAAAAA",
      "cause": "Incorrect monitor identifier format"
    },
    {
      "entityId": "APPLICATION-WRONG",
      "cause": "Incorrect application identifier format"
    }
  ],
  "triggeredCount": 1,
  "triggered": [
    {
      "monitorId": "HTTP_CHECK-69A9B98E1CD87352",
      "executions": [
        {
          "executionId": "1069999568093682590",
          "locationId": "SYNTHETIC_LOCATION-9BB04DAE11123122"
        }
      ]
    }
  ]
}