GET все локации

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

Запрос создает 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