ENetrebin в 15:46, 20 октября 2022

2022-10-20T15:46:40Z

← Предыдущая		Версия 15:46, 20 октября 2022
Строка 1:		Строка 1:
	Список всех местоположений, общедоступных и частных, и их параметров, доступных для вашей среды.		Список всех местоположений, общедоступных и частных, и их параметров, доступных для вашей среды.

	Запрос создает <code>application/json</code>~~полезную нагрузку~~.		Запрос создает в качестве полезной нагрузки<code>application/json</code> формат.
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|GET		\| rowspan="2" \|GET

ENetrebin в 15:43, 20 октября 2022

2022-10-20T15:43:50Z

Внесённые изменения

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

2022-10-20T13:44:01Z

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

Новая страница

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

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |ПОЛУЧИТЬ
|Удалось
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/locations</nowiki></code>
|-
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/synthetic/locations</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/synthetic/locations</nowiki></code>
|}

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

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

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

* <code>AWS</code>
* <code>AZURE</code>
* <code>ALIBABA</code>
* <code>GOOGLE_CLOUD</code>
* <code>OTHER</code>
|запрос
|по желанию
|-
|тип
|нить
|Отфильтровывает результирующий набор местоположений по определенному типу.

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

* <code>PUBLIC</code>
* <code>PRIVATE</code>
|запрос
|по желанию
|}

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|Синтетические локации
|Успех
|}

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

==== Объект _ <code>SyntheticLocations</code> ====
Список синтетических локаций.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|локации
|Элемент коллекции местоположения []
|Список синтетических локаций.
|}

==== Объект _ <code>LocationCollectionElement</code> ====
Синтетическая локация.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|имя
|нить
|Название локации.
|-
|идентификатор сущности
|нить
|Идентификатор объекта Dynatrace для местоположения.
|-
|тип
|нить
|Тип локации.

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

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

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

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

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

Применимо только к <code>PUBLIC</code>локациям.
|-
|сцена
|нить
|Стадия релиза локации.

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

* <code>BETA</code>
* <code>COMING_SOON</code>
* <code>DELETED</code>
* <code>GA</code>
|-
|статус
|нить
|Статус локации.

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

* <code>DISABLED</code>
* <code>ENABLED</code>
* <code>HIDDEN</code>
|-
|идентификатор геолокации
|нить
|Идентификатор местоположения Dynatrace GeoLocation.
|}

=== JSON-модель тела ответа ===
<code>{
"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"
}
]
}</code>

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

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

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

==== Завиток ====
<code>curl -X GET \
<nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>

==== URL-адрес запроса ====
<code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations</nowiki></code>

==== Тело ответа ====
<code>{
"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"
}
]
}</code>

==== Код ответа ====
200

GET все локации - История изменений

ENetrebin в 15:46, 20 октября 2022

ENetrebin в 15:43, 20 октября 2022

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