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

ENetrebin в 10:32, 14 августа 2024

2024-08-14T10:32:38Z

← Предыдущая		Версия 10:32, 14 августа 2024
Строка 87:		Строка 87:
	\|string		\|string
	\|Код региона локации.		\|Код региона локации.

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

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

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

2022-10-20T15:55:15Z

← Предыдущая		Версия 15:55, 20 октября 2022
Строка 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~~		\|Среда АктивногоШлюза
	~~\|<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~~ требуемого местоположения.		\|Идентификатор объекта Ключ-АСТРОМ требуемого местоположения.
	\|~~дорожка~~		\|path
	\|требуется		\|требуется
	\|}		\|}
Строка 42:		Строка 39:
	\|-		\|-
	\|200		\|200
	\|~~Синтетическое местоположение~~		\|SyntheticLocation
	\|Успех. Ответ содержит параметры синтетического местоположения.		\|Успех. Ответ содержит параметры синтетического местоположения.
	\|}		\|}
Строка 48:		Строка 45:
	=== Объекты тела ответа ===		=== Объекты тела ответа ===

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

Строка 59:		Строка 56:
	!Описание		!Описание
	\|-		\|-
	\|~~идентификатор сущности~~		\|entityId
	\|~~нить~~		\|string
	\|Идентификатор объекта ~~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.		\|Идентификатор местоположения Ключ-АСТРОМ 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.ruscomtech.ru/api/v2/synthetic/locations/SYNTHETIC_LOCATION-0000000000000064</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>

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

	==== Тело ответа ====		==== Тело ответа ====
Строка 188:		Строка 185:
	==== Завиток ====		==== Завиток ====
	<code>curl -X GET \		<code>curl -X GET \
	<nowiki>https://mySampleEnv.live.~~dynatrace~~.~~com~~/api/v2/synthetic/locations/SYNTHETIC_LOCATION-BB5EE23C1D48AFF5</nowiki> \		<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/synthetic/locations/SYNTHETIC_LOCATION-BB5EE23C1D48AFF5</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>

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

	==== Тело ответа ====		==== Тело ответа ====

ENetrebin: Новая страница: «Получает параметры указанного местоположения. Запрос создает `application/json`полезную...»

2022-10-20T13:47:02Z

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

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

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

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |ПОЛУЧИТЬ
|Удалось
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/synthetic/locations/{locationId}</nowiki></code>
|-
|SaaS
|<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>syntheticLocations.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимый
|-
|идентификатор местоположения
|нить
|Идентификатор объекта Dynatrace требуемого местоположения.
|дорожка
|требуется
|}

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

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

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

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

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

Фактический набор полей зависит от типа местоположения. Найдите список актуальных объектов в описании поля типа или см. Синтетические локации API v2 — модели JSON .
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|идентификатор сущности
|нить
|Идентификатор объекта Dynatrace для местоположения.
|-
|тип
|нить
|Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:

* <code>PUBLIC</code>-> PublicSyntheticLocation
* <code>PRIVATE</code>-> PrivateSyntheticLocation
* <code>CLUSTER</code>-> PrivateSyntheticLocation

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

* <code>CLUSTER</code>
* <code>PRIVATE</code>
* <code>PUBLIC</code>
|-
|имя
|нить
|Название локации.
|-
|код страны
|нить
|Код страны местоположения.

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

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

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

* <code>ENABLED</code>: местоположение отображается как активное в пользовательском интерфейсе. Вы можете назначить мониторы местоположению.
* <code>DISABLED</code>: местоположение отображается как неактивное в пользовательском интерфейсе. Вы не можете назначить мониторы местоположению. Мониторы, уже назначенные местоположению, останутся там и будут выполняться из этого места.
* <code>HIDDEN</code>: местоположение не отображается в пользовательском интерфейсе. Вы не можете назначить мониторы местоположению. Вы можете установить местоположение только тогда, <code>HIDDEN</code>когда ему не назначен ни один монитор.

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

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

=== JSON-модель тела ответа ===
<code>{
"entityId": "string",
"type": "CLUSTER",
"name": "string",
"countryCode": "string",
"regionCode": "string",
"city": "string",
"latitude": 1,
"longitude": 1,
"status": "DISABLED",
"geoLocationId": "string"
}</code>

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

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

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

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

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

== Пример — частная локация ==
В этом примере запрос получает сведения о частном расположении HTTP в Линце с идентификатором SYNTHETIC_LOCATION-BB5EE23C1D48AFF5 .

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

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

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

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

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

ENetrebin в 10:32, 14 августа 2024

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

ENetrebin: Новая страница: «Получает параметры указанного местоположения. Запрос создает application/jsonполезную...»

ENetrebin: Новая страница: «Получает параметры указанного местоположения. Запрос создает `application/json`полезную...»