Создание новой частной синтетической локации (POST локация)

Этот вызов API создает новую синтетическую локацию. Запрос потребляет и создает полезную нагрузку application/json.

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

Для выполнения этого запроса вам необходимо разрешение одной из областей API (ServiceProviderAPI), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.

Конечная точка

/api/cluster/v2/synthetic/locations

Параметры

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

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

Объект SyntheticLocation

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

Элемент	Тип	Описание
nodes	string[]	Список синтетических узлов, принадлежащих локации. Вы можете получить список доступных узлов с помощью вызова GET all nodes.	optional
availabilityLocationOutage	boolean	Предупреждение об отключении местоположения включено (true) или отключено (false).	optional
availabilityNodeOutage	boolean	Оповещение об отключении узла включено (true) или отключено (false). Если включено, сбой любого узла в локации вызывает оповещение.	optional
locationNodeOutageDelayInMinutes	integer	Оповещение, если сбой местоположения или узла длится дольше X минут. Применимо только в том случае, если для параметра availabilityLocationOutage или availabilityNodeOutage задано значение true.	optional
availabilityNotificationsEnabled	boolean	Уведомления о сбое местоположения и узла включены (true) или отключены (false).	optional
deploymentType	string	Тип развертывания местоположения: STANDARD: Локация развернута в Windows или Linux. KUBERNETES: Локация развернута в Kubernetes.	optional
minAGCount	integer	Минимальное количество АктивныхШлюзов, развернутых для локации (требуется для локации Kubernetes).	optional
maxAGCount	integer	Максимальное количество АктивныхШлюзов, развернутых для локации (требуется для локации Kubernetes).	optional
nodeSize	string	Размер контейнерного узла, развернутого для расположения (требуется для расположения Kubernetes): XS: Extra small S: Small M: Medium	optional
autoUpdateChromium	boolean	Автоматическое обновление Chromium включено (true) или отключено (false).	optional

Ответ

Коды ответа

Код	Тип	Описание
201	SyntheticLocationIdsDto	Success. The private location has been created. The response contains the ID of the new location.

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

Объект SyntheticLocationIdsDto

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

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

{
  "entityId": "string",
  "geoLocationId": "string"
}

Пример

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

Токен API передается в заголовке Authorization.

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

Curl

curl -L -X POST 'https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations' \ -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ -H 'Content-Type: application/json' \ --data-raw '{ "type": "PRIVATE", "name": "REST example - Linz", "countryCode": "AT", "city": "Linz", "status": "ENABLED", "latitude": 48.306351, "longitude": 14.287399, "nodes": [ "290433380" ], "availabilityLocationOutage": false, "availabilityNodeOutage": false, "locationNodeOutageDelayInMillis": 5000 } '

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

https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations

Тело запроса

{
  "type": "PRIVATE",
  "name": "REST example - Linz",
  "countryCode": "AT",
  "city": "Linz",
  "status": "ENABLED",
  "latitude": 48.306351,
  "longitude": 14.287399,
  "nodes": ["290433380"],
  "availabilityLocationOutage": false,
  "availabilityNodeOutage": false,
  "locationNodeOutageDelayInMillis": 5000
}

Тело ответа

{
  "entityId": "SYNTHETIC_LOCATION-493122BFA29674DC",
  "geoLocationId": "GEOLOCATION-96B57899C9B5A3C7"
}

Код ответа

200