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

Материал из Dynatrace
(Новая страница: «Получает параметры указанного местоположения. Запрос создает <code>application/json</code>полезную...»)
 
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
Получает параметры указанного местоположения.
Получает параметры указанного местоположения.


Запрос создает <code>application/json</code>полезную нагрузку.
Запрос создает в качестве полезной нагрузки <code>application/json</code> формат.
{| class="wikitable"
{| class="wikitable"
| rowspan="3" |ПОЛУЧИТЬ
| rowspan="2" |GET
|Удалось
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}</nowiki></code>
|-
|-
|SaaS
|Среда ActiveGate
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/locations/{locationId}</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}</nowiki></code>
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}</nowiki></code>
|}
|}
Строка 22: Строка 19:
!Тип
!Тип
!Описание
!Описание
!В
!In
!Необходимый
!Необходимость
|-
|-
|идентификатор местоположения
|locationId
|нить
|string
|Идентификатор объекта Dynatrace требуемого местоположения.
|Идентификатор объекта Dynatrace требуемого местоположения.
|дорожка
|path
|требуется
|требуется
|}
|}
Строка 42: Строка 39:
|-
|-
|200
|200
|Синтетическое местоположение
|SyntheticLocation
|Успех. Ответ содержит параметры синтетического местоположения.
|Успех. Ответ содержит параметры синтетического местоположения.
|}
|}
Строка 48: Строка 45:
=== Объекты тела ответа ===
=== Объекты тела ответа ===


==== Объект _ <code>SyntheticLocation</code> ====
==== Объект <code>SyntheticLocation</code> ====
Конфигурация синтетической локации.
Конфигурация синтетической локации.


Строка 59: Строка 56:
!Описание
!Описание
|-
|-
|идентификатор сущности
|entityId
|нить
|string
|Идентификатор объекта Dynatrace для местоположения.
|Идентификатор объекта Dynatrace для местоположения.
|-
|-
|тип
|type
|нить
|string
|Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
|Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:


Строка 77: Строка 74:
* <code>PUBLIC</code>
* <code>PUBLIC</code>
|-
|-
|имя
|name
|нить
|string
|Название локации.
|Название локации.
|-
|-
|код страны
|countryCode
|нить
|string
|Код страны местоположения.
|Код страны местоположения.


Используйте код alpha-2 стандарта ISO 3166-2 (например, <code>AT</code>для Австрии или <code>PL</code>Польши).
Используйте код alpha-2 стандарта ISO 3166-2 (например, <code>AT</code>для Австрии или <code>PL</code>Польши).
|-
|-
|код региона
|regionCode
|нить
|string
|Код региона локации.
|Код региона локации.


Строка 95: Строка 92:
Для остального мира используйте коды FIPS 10-4 .
Для остального мира используйте коды FIPS 10-4 .
|-
|-
|город
|city
|нить
|string
|Город локации.
|Город локации.
|-
|-
|широта
|latitude
|количество
|number
|Широта местоположения в <code>DDD.dddd</code>формате.
|Широта местоположения в <code>DDD.dddd</code>формате.
|-
|-
|долгота
|longitude
|количество
|number
|Долгота местоположения в <code>DDD.dddd</code>формате.
|Долгота местоположения в <code>DDD.dddd</code>формате.
|-
|-
|статус
|status
|нить
|string
|Статус локации:
|Статус локации:


Строка 121: Строка 118:
* <code>HIDDEN</code>
* <code>HIDDEN</code>
|-
|-
|идентификатор геолокации
|geoLocationId
|нить
|string
|Идентификатор местоположения Dynatrace GeoLocation.
|Идентификатор местоположения Dynatrace GeoLocation.
|}
|}
Строка 140: Строка 137:
  }</code>
  }</code>


== Пример - общественное место ==
== Пример - публичная локация ==
В этом примере запрос получает сведения об общедоступном расположении Amazon US East (Северная Вирджиния) с идентификатором SYNTHETIC_LOCATION-00000000000000064 .
В этом примере запрос получает сведения об общедоступном расположении Amazon US East (Северная Вирджиния) с идентификатором SYNTHETIC_LOCATION-00000000000000064 .


==== Завиток ====
==== Curl ====
  <code>curl -X GET \
  <code>curl -X GET \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-0000000000000064</nowiki> \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-0000000000000064</nowiki> \

Текущая версия на 15:26, 13 февраля 2023

Получает параметры указанного местоположения.

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

GET Managed https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}
Среда ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}

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

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

Параметры

Параметр Тип Описание In Необходимость
locationId string Идентификатор объекта Dynatrace требуемого местоположения. path требуется

Ответ

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

Коды ответов

Код Тип Описание
200 SyntheticLocation Успех. Ответ содержит параметры синтетического местоположения.

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

Объект SyntheticLocation

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

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

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

Элемент Тип Описание
entityId string Идентификатор объекта Dynatrace для местоположения.
type string Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
  • PUBLIC-> PublicSyntheticLocation
  • PRIVATE-> PrivateSyntheticLocation
  • CLUSTER-> PrivateSyntheticLocation

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

  • CLUSTER
  • PRIVATE
  • PUBLIC
name string Название локации.
countryCode string Код страны местоположения.

Используйте код alpha-2 стандарта ISO 3166-2 (например, ATдля Австрии или PLПольши).

regionCode string Код региона локации.

Для США или Канады используйте коды штатов ISO 3166-2 (без префикса US-или CA-), например, VAдля Вирджинии или ORОрегона.

Для остального мира используйте коды FIPS 10-4 .

city string Город локации.
latitude number Широта местоположения в DDD.ddddформате.
longitude number Долгота местоположения в DDD.ddddформате.
status string Статус локации:
  • ENABLED: местоположение отображается как активное в пользовательском интерфейсе. Вы можете назначить мониторы местоположению.
  • DISABLED: местоположение отображается как неактивное в пользовательском интерфейсе. Вы не можете назначить мониторы местоположению. Мониторы, уже назначенные местоположению, останутся там и будут выполняться из этого места.
  • HIDDEN: местоположение не отображается в пользовательском интерфейсе. Вы не можете назначить мониторы местоположению. Вы можете установить местоположение только тогда, HIDDENкогда ему не назначен ни один монитор.

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

  • DISABLED
  • ENABLED
  • HIDDEN
geoLocationId string Идентификатор местоположения Dynatrace GeoLocation.

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-00000000000000064 .

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 -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