POST локация*: различия между версиями

Текущая версия от 17:05, 2 января 2025

API АппОптима / Эндпойнты среды / Развёртывание / Синтетика v1 / Синтетические локации / POST локация*

Создает новую частную синтетическую локацию. Дополнительные сведения о создании синтетического местоположения см. в разделе Создание частного искусственного местоположения .

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

POST	АппОптима	`https://{your-domain}/e/{your-environment-id}/api/v1/synthetic/locations`
POST	Среда АктивногоШлюза	`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/synthetic/locations`

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

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

Параметр

Чтобы найти все варианты моделей, зависящие от типа модели, см. раздел модели JSON .

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

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

Объект `SyntheticLocation`

Конфигурация синтетической локации.

Параметры countryCode , regionCode , city являются необязательными, поскольку их можно получить на основе широты и долготы местоположения.

Фактический набор полей зависит от типа местоположения. Найдите список актуальных объектов в описании поля типа или см. Синтетические локации API v2 — модели JSON .

Элемент	Тип	Описание	Необходимость
nodes	string[]	Список синтетических нод, принадлежащих локации. Вы можете получить список доступных нод с помощью вызова GET all nodes .	по желанию
availabilityLocationOutage	boolean	Предупреждение об отключении местоположения включено ( `true`) или отключено ( `false`).	по желанию
availabilityNodeOutage	boolean	Оповещение об отключении ноды включено ( `true`) или отключено ( `false`). Если включено, сбой любой ноды в локации вызывает оповещение.	по желанию
locationNodeOutageDelayInMinutes	integer	Оповещение, если сбой местоположения или ноды длится дольше X минут. Применимо только в том случае, если для параметра availabilityLocationOutage или availabilityNodeOutage задано значение .`true`	по желанию
availabilityNotificationsEnabled	boolean	Уведомления о сбое местоположения и ноды включены ( `true`) или отключены ( `false`).	по желанию
deploymentType	string	Тип развертывания местоположения: `STANDARD`: расположение развернуто в Windows или Linux. `KUBERNETES`: расположение развернуто в Kubernetes. Элемент может содержать эти значения `KUBERNETES` `STANDARD`	по желанию
autoUpdateChromium	boolean	Автоматическое обновление Chromium включено ( `true`) или отключено ( `false`).	по желанию

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

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

<{
  "nodes": [
    "string"
  ],
  "availabilityLocationOutage": true,
  "availabilityNodeOutage": true,
  "locationNodeOutageDelayInMinutes": 1,
  "availabilityNotificationsEnabled": true,
  "deploymentType": "KUBERNETES",
  "autoUpdateChromium": true
}

Ответ

Коды ответов

Код	Тип	Описание
200	EntityIdDto	Успех

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

Объект `EntityIdDto`

DTO для идентификатора объекта.

Элемент	Тип	Описание
entityId	string	Идентификатор объекта для передачи

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

<{
  "entityId": "string"
}

Пример

В этом примере запрос создает новое частное синтетическое местоположение. Это место находится в Линце, Австрия . Он использует синтетическую ноду с идентификатором 93302281 .

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

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

Curl

<curl -X POST \
  https://mySampleEnv.live.ruscomtech.ru/api/v1/synthetic/locations \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "PRIVATE",
  "name": "REST example - Linz",
  "countryCode": "AT",
  "regionCode": "AU04",
  "city": "Linz",
  "latitude": 48.306351,
  "longitude": 14.287399,
  "nodes": [
    "93302281"
  ]
}
'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru/api/v1/synthetic/locations

Тело запроса

<{
  "type": "PRIVATE",
  "name": "REST example - Linz",
  "countryCode": "AT",
  "regionCode": "AU04",
  "city": "Linz",
  "latitude": 48.306351,
  "longitude": 14.287399,
  "nodes": ["93302281"]
}

Тело ответа

<{
  "entityId": "SYNTHETIC_LOCATION-8F419D1B53639A45"
}

Код ответа

200

@@ Строка 1: / Строка 1: @@
+'''''[[API АппОптима]] / [[API АппОптима|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=GET%20%D1%81%D1%85%D0%B5%D0%BC%D0%B0-,%D0%A1%D0%B8%D0%BD%D1%82%D0%B5%D1%82%D0%B8%D0%BA%D0%B0%20v1,-%D0%A1%D0%B8%D0%BD%D1%82%D0%B5%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5%20%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D1%8B Синтетика v1] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=JSON%20%D0%BC%D0%BE%D0%B4%D0%B5%D0%BB%D0%B8-,%D0%A1%D0%B8%D0%BD%D1%82%D0%B5%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5%20%D0%BB%D0%BE%D0%BA%D0%B0%D1%86%D0%B8%D0%B8,-GET%20%D0%B2%D1%81%D0%B5%20%D0%BB%D0%BE%D0%BA%D0%B0%D1%86%D0%B8%D0%B8 Синтетические локации] / POST локация*'''''
 Создает новую частную синтетическую локацию. Дополнительные сведения о создании синтетического местоположения см. в разделе Создание частного искусственного местоположения .
@@ Строка 4: / Строка 6: @@
 {| class="wikitable"
 | rowspan="2" |POST
-|Managed
+|АппОптима
 |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/synthetic/locations</nowiki></code>
 |-
@@ Строка 96: / Строка 98: @@
 === JSON-модель тела запроса ===
 Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
-  <code>{
+  <{
     "nodes": [
       "string"
@@ Строка 106: / Строка 108: @@
     "deploymentType": "KUBERNETES",
     "autoUpdateChromium": true
-  }</code>
+  }
 == Ответ ==
@@ Строка 136: / Строка 138: @@
 === JSON-модель тела ответа ===
-  <code>{
+  <{
     "entityId": "string"
-  }</code>
+  }
 == Пример ==
@@ Строка 148: / Строка 150: @@
 ==== Curl ====
-  <code>curl -X POST \
+  <curl -X POST \
     <nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/synthetic/locations</nowiki> \
     -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
@@ Строка 164: / Строка 166: @@
     ]
   }
-  '</code>
+  '
 ==== URL-адрес запроса ====
@@ Строка 170: / Строка 172: @@
 ==== Тело запроса ====
-  <code>{
+  <{
     "type": "PRIVATE",
     "name": "REST example - Linz",
@@ Строка 179: / Строка 181: @@
     "longitude": 14.287399,
     "nodes": ["93302281"]
-  }</code>
+  }
 ==== Тело ответа ====
-  <code>{
+  <{
     "entityId": "SYNTHETIC_LOCATION-8F419D1B53639A45"
-  }</code>
+  }
 ==== Код ответа ====