GET все локации

Материал из Документация Ключ-АСТРОМ
Версия от 13:44, 20 октября 2022; ENetrebin (обсуждение | вклад) (Новая страница: «Список всех местоположений, общедоступных и частных, и их параметров, доступных для ваше...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

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

Запрос создает application/jsonполезную нагрузку.

ПОЛУЧИТЬ Удалось https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/locations
SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/locations
Окружающая среда ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/locations

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

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

Параметры

Параметр Тип Описание В Необходимый
облачная платформа нить Отфильтровывает результирующий набор местоположений на те, которые размещены на определенной облачной платформе.

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

  • AWS
  • AZURE
  • ALIBABA
  • GOOGLE_CLOUD
  • OTHER
запрос по желанию
тип нить Отфильтровывает результирующий набор местоположений по определенному типу.

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

  • PUBLIC
  • PRIVATE
запрос по желанию

Ответ

Коды ответов

Код Тип Описание
200 Синтетические локации Успех

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

Объект _ SyntheticLocations

Список синтетических локаций.

Элемент Тип Описание
локации Элемент коллекции местоположения [] Список синтетических локаций.

Объект _ LocationCollectionElement

Синтетическая локация.

Элемент Тип Описание
имя нить Название локации.
идентификатор сущности нить Идентификатор объекта Dynatrace для местоположения.
тип нить Тип локации.

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

  • CLUSTER
  • PRIVATE
  • PUBLIC
облачная платформа нить Облачный провайдер, у которого размещено местоположение.

Применимо только к PUBLICлокациям.

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

  • ALIBABA
  • AMAZON_EC2
  • AZURE
  • DYNATRACE_CLOUD
  • GOOGLE_CLOUD
  • INTEROUTE
  • OTHER
  • UNDEFINED
ips строка [] Список IP-адресов, присвоенных местоположению.

Применимо только к PUBLICлокациям.

сцена нить Стадия релиза локации.

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

  • BETA
  • COMING_SOON
  • DELETED
  • GA
статус нить Статус локации.

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

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

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

{
  "locations": [
    {
      "name": "Gdansk",
      "entityId": "SYNTHETIC_LOCATION-53F47ECB33907667",
      "geoLocationId": "GEOLOCATION-95196F3C9A4F4215",
      "type": "PUBLIC",
      "cloudPlatform": "AMAZON_EC2",
      "ips": [
        "134.189.153.97",
        "134.189.153.98"
      ],
      "stage": "GA",
      "status": "ENABLED",
      "capabilities": [
        "BROWSER",
        "HTTP"
      ]
    },
    {
      "name": "My private location",
      "entityId": "SYNTHETIC_LOCATION-53F47ECB33907667",
      "geoLocationId": "GEOLOCATION-95196F3C9A4F4215",
      "type": "PRIVATE",
      "status": "ENABLED"
    }
  ]
}

Пример

В этом примере в запросе перечислены все искусственные местоположения, доступные для среды mySampleEnv .

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

Результат усекается до трех записей.

Завиток

curl -X GET \
  https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

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

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

Тело ответа

{
  "locations": [
    {
      "name": "Amazon US East (N. Virginia)",
      "entityId": "SYNTHETIC_LOCATION-0000000000000004",
      "type": "PUBLIC",
      "cloudPlatform": "AMAZON_EC2",
      "ips": [
        "79.50.224.74",
        "96.124.117.100"
      ],
      "stage": "GA",
      "status": "ENABLED",
      "capabilities": [
        "BROWSER"
      ],
      "geoLocationId": "GEOLOCATION-95196F3C9A4F4215"
    },
    {
      "name": "Gdańsk",
      "entityId": "SYNTHETIC_LOCATION-0000000000000064",
      "type": "PUBLIC",
      "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",
      "status": "ENABLED",
      "capabilities": [
        "BROWSER",
        "HTTP"
      ],
      "geoLocationId": "GEOLOCATION-0A41430434C388A9"
    },
    {
      "name": "Linz HTTP",
      "entityId": "SYNTHETIC_LOCATION-BB5EE23C1D48AFF5",
      "type": "PRIVATE",
      "status": "ENABLED",
      "geoLocationId": "GEOLOCATION-427705B3488A4C45"
    }
  ]
}

Код ответа

200