Получение свойств указанных локаций (GET локация)
Этот вызов API получает параметры указанного местоположения. Запрос создает полезную нагрузку application/json
.
Аутентификация
Для выполнения этого запроса вам необходимо разрешение одной из областей API (ServiceProviderAPI)
, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.
Конечная точка
/api/cluster/v2/synthetic/locations
Параметры
Параметр | Тип | Описание | В | Обязательно |
---|---|---|---|---|
locationId | string | Идентификатор объекта требуемого местоположения. | path | Да |
Ответ
Коды ответа
Код | Тип | Описание |
---|---|---|
200 | SyntheticLocation | Успешно. Ответ содержит параметры синтетического местоположения. |
Объекты тела ответа
Объект SyntheticLocation
Элемент | Тип | Описание |
---|---|---|
entityId | string | Идентификатор объекта для местоположения. |
type | string | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
|
name | string | Название локации. |
countryCode | string | Код страны местоположения.
Используйте код alpha-2 стандарта ISO 3166-2 (например, |
regionCode | string | Код региона локации. |
city | string | Город локации. |
latitude | number | Широта местоположения в формате DDD.dddd .
|
longitude | number | Долгота местоположения в формате DDD.dddd .
|
status | string | Статус локации:
|
geoLocationId | string | Идентификатор местоположения. |
JSON-модель тела ответа
{
"entityId": "string",
"type": "CLUSTER",
"name": "string",
"countryCode": "string",
"regionCode": "string",
"city": "string",
"latitude": 1,
"longitude": 1,
"status": "DISABLED",
"geoLocationId": "string"
}
Пример (публичная локация)
В этом примере запрос получает сведения об общедоступном расположении Amazon US East (Северная Вирджиния) с идентификатором SYNTHETIC_LOCATION-0000000000000064
.
Curl
curl -X GET \ https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-0000000000000064 \ -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-0000000000000064
Тело ответа
{
"entityId": "SYNTHETIC_LOCATION-0000000000000064",
"type": "PUBLIC",
"name": "Gdańsk",
"countryCode": "PL",
"regionCode": "EU",
"city": "Gdańsk",
"latitude": 54.399078,
"longitude": 18.576557,
"status": "ENABLED",
"cloudPlatform": "OTHER",
"ips": [
"120.157.221.247",
"172.158.6.93",
"197.136.70.30",
"227.53.205.237",
"131.123.197.12"
],
"stage": "GA",
"browserType": "Chrome",
"browserVersion": "83.0.4103.61",
"capabilities": [
"BROWSER",
"HTTP"
],
"geoLocationId": "GEOLOCATION-0A41430434C388A9"
}
Код ответа
200
Пример (частная локация)
В этом примере запрос получает сведения о частном расположении HTTP в Линце с идентификатором SYNTHETIC_LOCATION-BB5EE23C1D48AFF5
.
Curl
curl -X GET \ https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-BB5EE23C1D48AFF5 \ -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-BB5EE23C1D48AFF5
Тело ответа
{
"entityId": "SYNTHETIC_LOCATION-BB5EE23C1D48AFF5",
"type": "PRIVATE",
"name": "Linz HTTP",
"countryCode": "AT",
"regionCode": "04",
"city": "Linz",
"latitude": 48.306351,
"longitude": 14.287399,
"status": "ENABLED",
"nodes": [
"137829320"
],
"availabilityLocationOutage": false,
"availabilityNodeOutage": false,
"locationNodeOutageDelayInMillis": 3000,
"geoLocationId": "GEOLOCATION-427705B3488A4C45"
}
Код ответа
200