Получение списка всех окружений

Этот вызов API возвращает все существующие среды.

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

Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.

Конечная точка

/api/cluster/v2/environments

Параметры

Параметр	Тип	Описание	В	Обязательно
nextPageKey	string	Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа. Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey. Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса.	query	Нет
pageSize	integer	Количество сред в полезной нагрузке одного ответа. Максимально допустимый размер страницы — 1000. Если не установлено, используется 100.	query	Нет
sort	string	Порядок сортировки: 'name' (без кавычек): Упорядочить по названию по возрастанию. '-name' (без кавычек): Упорядочить по названию по убыванию. 'creationDate' (без кавычек): Сортировать по дате создания по возрастанию. '-creationDate' (без кавычек): Упорядочить по названию по убыванию.	query	Нет
filter	string	Указывает фильтр запроса. Вы можете установить один или несколько из следующих критериев: Name: name(string). Название может быть либо подстрокой, либо полным именем среды. Без учета регистра. Trial: trial(true) или trial(false). Включает только пробные среды, если указано значение true, или только непробные среды, если указано значение false. State: state(ENABLED) или state(DISABLED). Tag: tag(string). Чтобы отфильтровать по нескольким тегам, применяя логику ИЛИ, используйте tag(string1,string2). Чтобы отфильтровать по нескольким тегам, применяя логику И, используйте tag(string1),tag(string2). Чтобы задать несколько критериев, разделите их запятой (,). В ответ включаются только результаты, соответствующие всем критериям.	query	Нет
includeConsumptionInfo	boolean	Если true, информация о потреблении (лимиты, использование) возвращается для каждой среды. Возвращенное использование, как правило, до 1 часа назад. Чтобы получить более свежие данные, вы можете вместо этого использовать параметр includeUncachedConsumptionInfo.	query	Нет
includeStorageInfo	boolean	Если true, информация о хранилище (ограничения, использование) возвращается для каждой среды.	query	Нет
includeUncachedConsumptionInfo	boolean	Если true, для каждой среды возвращается некэшированная информация о потреблении (лимиты, использование). Будет рассчитан актуальный расход. Вычисление может занять много времени, поэтому вместо него рекомендуется использовать параметр includeConsummentInfo. Если установлены и этот параметр, и includeConsummentInfo, то includeUncachedConsumptionInfo будет иметь приоритет.	query	Нет

Ответ

Коды ответа

Код	Описание
200	Успешно

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

Объект EnvironmentList

Элемент	Тип	Описание
totalCount	integer	Общее количество записей в результате.
pageSize	integer	Количество записей на странице.
nextPageKey	string	Курсор для следующей страницы результатов. Имеет значение null на последней странице. Используйте его в параметре запроса nextPageKey для получения последующих страниц результата.
environments	Environment[]	Список сред.

Объект Environment

Элемент	Тип	Описание
name	string	Отображаемое имя среды.
id	string	Идентификатор среды. Должен соответствовать [a-zA-Z0-9_-]{1,70}
trial	boolean	Указывает, является ли среда пробной или непробной. Создание пробной среды возможно только в том случае, если это позволяет ваша лицензия. Значение по умолчанию — false (не пробная версия).
state	string	Указывает, включена или отключена среда (DISABLED, ENABLED). Значение по умолчанию — ENABLED
tags	string[]	Набор тегов, которые назначаются этой среде. Каждый тег может иметь максимальную длину 100 символов.
creationDate	string	Дата создания среды в формате ISO 8601 (гггг-ММ-дд'Т'ЧЧ:мм:сс.ССС'Z')
quotas	EnvironmentQuotas	Информация о потреблении на уровне среды и квотах. Возвращается только в том случае, если для параметра includeConsumptionInfo или includeUncachedConsumptionInfo установлено значение true. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.
storage	EnvironmentStorage	Использование хранилища на уровне среды и информация об ограничениях. Не возвращается, если параметр includeStorageInfo не равен true. Если пропустить при редактировании методом PUT, то уже установленные лимиты останутся.

Объект EnvironmentQuotas

Информация о потреблении на уровне среды и квотах. Возвращается только в том случае, если для параметра includeConsumptionInfo или includeUncachedConsumptionInfo установлено значение true. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.

Элемент	Тип	Описание
hostUnits	HostUnitQuota	Информация о потреблении хост-модулей и квотах на уровне среды. Если пропустить при редактировании методом PUT, то уже установленная квота останется.
demUnits	DemUnitsQuota	Потребление единиц DEM и информация о квотах на уровне среды. Не устанавливается (и не редактируется), если единицы ЦМР не включены. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.
syntheticMonitors	SyntheticQuota	Синтетика отслеживает потребление и информацию о квотах на уровне среды. Не устанавливается (и не редактируется), если не включены ни синтетические, ни цифровые единицы измерения. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.
customMetrics	CustomMetricsQuota	Использование пользовательских метрик и информация о квотах на уровне среды. Не задано (и недоступно для редактирования), если специальные показатели не включены. Не устанавливается (и не редактируется), если включены единицы данных Дейвиса. Если пропустить при редактировании методом PUT, то уже установленная квота останется.
aiDataUnits	AiDataUnitsQuota	Потребление единиц данных Дэвиса и информация о квотах на уровне среды. Не устанавливается (и не редактируется), если единицы данных Дэвиса не включены. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.
logMonitoring	LogMonitoringQuota	Журнал мониторинга потребления и информации о квотах на уровне среды. Не задано (и недоступно для редактирования), если мониторинг журналов не включен. Не задано (и недоступно для редактирования), если мониторинг журналов перенесен в данные ИИ на уровне лицензии. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.

Объект HostUnitQuota

Информация о потреблении хост-модулей и квотах на уровне среды. Если пропустить при редактировании методом PUT, то уже установленная квота останется.

Элемент	Тип	Описание
currentUsage	number	Текущее использование среды.
maxLimit	integer	Параллельная квота среды. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.

Объект DemUnitsQuota

Потребление единиц DEM и информация о квотах на уровне среды. Не устанавливается (и не редактируется), если единицы ЦМР не включены. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.

Элемент	Тип	Описание
consumedThisMonth	number	Ежемесячное потребление окружающей среды. Сбрасывается каждый календарный месяц.
consumedThisYear	number	Годовое потребление окружающей среды. Сбрасывается каждый год в годовщину создания лицензии.
monthlyLimit	integer	Ежемесячная квота окружающей среды. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.
annualLimit	integer	Годовая экологическая квота. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.

Объект SessionPropertiesQuota

User session properties consumption information on environment level.

Элемент	Тип	Описание
consumedThisMonth	number	Ежемесячное потребление окружающей среды. Сбрасывает каждый календарный месяц.
consumedThisYear	number	Годовое потребление окружающей среды. Сбрасывается каждый год в годовщину создания лицензии.

Объект SyntheticQuota

Синтетика отслеживает потребление и информацию о квотах на уровне среды. Не устанавливается (и не редактируется), если не включены ни синтетические, ни цифровые единицы измерения. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.

Элемент	Тип	Описание
consumedThisMonth	number	Ежемесячное потребление окружающей среды. Сбрасывает каждый календарный месяц.
consumedThisYear	number	Годовое потребление окружающей среды. Сбрасывается каждый год в годовщину создания лицензии.
monthlyLimit	integer	Ежемесячная квота окружающей среды. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.
annualLimit	integer	Годовая экологическая квота. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.

Объект CustomMetricsQuota

Использование пользовательских метрик и информация о квотах на уровне среды. Не задано (и недоступно для редактирования), если специальные показатели не включены. Не устанавливается (и не редактируется), если включены единицы данных Дейвиса. Если пропустить при редактировании методом PUT, то уже установленная квота останется.

Элемент	Тип	Описание
currentUsage	number	Текущее использование среды.
maxLimit	integer	Параллельная квота среды. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.

Объект AiDataUnitsQuota

Потребление единиц данных Дэвиса и информация о квотах на уровне среды. Не устанавливается (и не редактируется), если единицы данных Дейвиса не включены. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.

Элемент	Тип	Описание
consumedThisMonth	number	Ежемесячное потребление окружающей среды. Сбрасывает каждый календарный месяц.
consumedThisYear	number	Годовое потребление окружающей среды. Сбрасывается каждый год в годовщину создания лицензии.
monthlyLimit	integer	Ежемесячная квота окружающей среды. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.
annualLimit	integer	Годовая экологическая квота. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.

Объект LogMonitoringQuota object

Журнал мониторинга потребления и информации о квотах на уровне среды. Не задано (и недоступно для редактирования), если мониторинг журналов не включен. Не задано (и недоступно для редактирования), если мониторинг журналов перенесен в данные ИИ на уровне лицензии. Если пропустить при редактировании методом PUT, то уже установленные квоты останутся.

Элемент	Тип	Описание
consumedThisMonth	number	Ежемесячное потребление окружающей среды. Сбрасывает каждый календарный месяц.
consumedThisYear	number	Годовое потребление окружающей среды. Сбрасывается каждый год в годовщину создания лицензии.
monthlyLimit	integer	Ежемесячная квота окружающей среды. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.
annualLimit	integer	Годовая экологическая квота. Не устанавливается, если неограничен. При обновлении методом PUT пропуск этого поля приведет к неограниченной квоте.

Объект EnvironmentStorage object

Использование хранилища на уровне среды и информация об ограничениях. Не возвращается, если параметр includeStorageInfo не равен true. Если пропустить при редактировании методом PUT, то уже установленные лимиты останутся.

Элемент	Тип	Описание
transactionStorage	TransactionStorage	Использование хранилища транзакций и ограничение информации на уровне среды. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
symbolFilesFromMobileApps	SymbolFilesFromMobileApps	Файлы символов из хранилища мобильных приложений используют информацию об использовании и ограничениях на уровне среды. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
logMonitoringStorage	LogMonitoringStorage	Журнал мониторинга использования хранилища и информации об ограничениях на уровне среды. Недоступно для редактирования, если мониторинг журналов не разрешен лицензией или не настроен на уровне кластера. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
serviceRequestLevelRetention	ServiceRequestLevelRetention	Параметры хранения уровня запросов на обслуживание на уровне среды. Срок хранения на уровне сервисного кода не может быть больше, чем срок хранения на уровне сервисного запроса, и оба не могут превышать один год. Если пропустить при редактировании с помощью метода PUT, то уже установленное ограничение останется.
serviceCodeLevelRetention	ServiceCodeLevelRetention	Параметры хранения на уровне кода службы на уровне среды. Срок хранения на уровне сервисного кода не может быть больше, чем срок хранения на уровне сервисного запроса, и оба не могут превышать один год. Если пропустить при редактировании с помощью метода PUT, то уже установленное ограничение останется.
realUserMonitoringRetention	RealUserMonitoringRetention	Реальные параметры хранения мониторинга пользователей на уровне среды. Может быть установлено любое значение от 1 до 35 дней. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
syntheticMonitoringRetention	SyntheticMonitoringRetention	Настройки хранения синтетического мониторинга на уровне среды. Может быть установлено любое значение от 1 до 35 дней. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
logMonitoringRetention	LogMonitoringRetention	Параметры хранения мониторинга журнала на уровне среды. Недоступно для редактирования, если мониторинг журналов не разрешен лицензией или не настроен на уровне кластера. Может быть установлено любое значение от 5 до 90 дней. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
userActionsPerMinute	UserActionsPerMinute	Максимальное количество пользовательских действий, генерируемых в минуту на уровне среды. Можно установить любое значение от 1 до 2 147 483 646 или оставить без ограничений. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.
transactionTrafficQuota	TransactionTrafficQuota	Максимальное количество новых отслеживаемых точек входа PurePath, захваченных за процесс в минуту на уровне среды. Может быть установлено любое значение от 100 до 100000. Если пропустить при редактировании методом PUT, то останется уже установленный лимит.

Объект TransactionStorage

Использование хранилища транзакций и ограничение информации на уровне среды. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
retentionReductionPercentage	string	Процент усечения для новых данных.
retentionReductionReason	string	Причина усечения.
maxLimit	integer	Максимальный предел хранения [байт]
currentlyUsed	integer	Текущее используемое хранилище [байт]

Объект SymbolFilesFromMobileApps

Файлы символов из хранилища мобильных приложений используют информацию об использовании и ограничениях на уровне среды. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
maxLimit	integer	Максимальный предел хранения [байт]
currentlyUsed	integer	Текущее используемое хранилище [байт]

Объект LogMonitoringStorage

Журнал мониторинга использования хранилища и информации об ограничениях на уровне среды. Недоступно для редактирования, если мониторинг журналов не разрешен лицензией или не настроен на уровне кластера. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
maxLimit	integer	Максимальный предел хранения [байт]
currentlyUsed	integer	Текущее используемое хранилище [байт]

Объект ServiceRequestLevelRetention

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

Элемент	Тип	Описание
maxLimitInDays	integer	Максимальный срок хранения [дней]
currentlyUsedInMillis	integer	Текущий возраст данных [миллисекунды]
currentlyUsedInDays	integer	Текущий возраст данных [дни]

Объект ServiceCodeLevelRetention

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

Элемент	Тип	Описание
maxLimitInDays	integer	Максимальный срок хранения [дней]
currentlyUsedInMillis	integer	Текущий возраст данных [миллисекунды]
currentlyUsedInDays	integer	Текущий возраст данных [дни]

Объект RealUserMonitoringRetention

Реальные параметры хранения мониторинга пользователей на уровне среды. Может быть установлено любое значение от 1 до 35 дней. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
maxLimitInDays	integer	Максимальный срок хранения [дней]
currentlyUsedInMillis	integer	Текущий возраст данных [миллисекунды]
currentlyUsedInDays	integer	Текущий возраст данных [дни]

Объект SyntheticMonitoringRetention

Настройки хранения синтетического мониторинга на уровне среды. Может быть установлено любое значение от 1 до 35 дней. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
maxLimitInDays	integer	Максимальный срок хранения [дней]
currentlyUsedInMillis	integer	Текущий возраст данных [миллисекунды]
currentlyUsedInDays	integer	Текущий возраст данных [дни]

Объект LogMonitoringRetention

Параметры хранения мониторинга журнала на уровне среды. Недоступно для редактирования, если мониторинг журналов не разрешен лицензией или не настроен на уровне кластера. Может быть установлено любое значение от 5 до 90 дней. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
maxLimitInDays	integer	Максимальный срок хранения [дней]
currentlyUsedInMillis	integer	Текущий возраст данных [миллисекунды]
currentlyUsedInDays	integer	Текущий возраст данных [дни]

Объект UserActionsPerMinute

Максимальное количество пользовательских действий, генерируемых в минуту на уровне среды. Можно установить любое значение от 1 до 2 147 483 646 или оставить без ограничений. Если пропустить при редактировании методом PUT, то уже установленный лимит останется.

Элемент	Тип	Описание
maxLimit	integer	Максимальный трафик [единиц в минуту]

Объект TransactionTrafficQuota

Максимальное количество новых отслеживаемых точек входа PurePath, захваченных за процесс в минуту на уровне среды. Может быть установлено любое значение от 100 до 100000. Если пропустить при редактировании методом PUT, то останется уже установленный лимит.

Элемент	Тип	Описание
maxLimit	integer	Максимальный трафик [единиц в минуту]

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

<{
  "totalCount": 1,
  "pageSize": 1,
  "nextPageKey": "AQAAABQBAAAABQ==",
  "environments": [
    {
      "name": "example environment",
      "state": "ENABLED",
      "tags": [
        "tag1",
        "tag2"
      ],
      "trial": false
    }
  ]
}

Пример

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

Curl

curl -X GET "https://myManaged.cluster.com/api/cluster/v2/environments?pageSize=2&sort=-creationDate&filter=state%28ENABLED%29&includeConsumptionInfo=true" -H "accept: application/json; charset=utf-8" -H "Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890"

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

https://myManaged.cluster.com/api/cluster/v2/environments?pageSize=2&sort=-creationDate&filter=state%28ENABLED%29&includeConsumptionInfo=true

Тело ответа

<{
  "totalCount": 78,
  "pageSize": 2,
  "nextPageKey": "AAAAAQAAAAIBnldfkgldsjoeriKIDFL2AAABd3uuvIMBAA5zdGF0ZShFTkFCTEVEKQEADS1jcmVhdGlvbkRhdGU=",
  "environments": [
    {
      "name": "AndroidApps",
      "id": "be22c776-1414-00e0-a00a-00b0dcf56443321",
      "trial": false,
      "state": "ENABLED",
      "tags": [],
      "creationDate": "2021-02-09T11:03:17.732Z",
      "quotas": {
        "hostUnits": {
          "maxLimit": 10,
          "currentUsage": 0
        },
        "demUnits": {
          "monthlyLimit": 50001,
          "annualLimit": null,
          "consumedThisMonth": 0,
          "consumedThisYear": 0
        },
        "userSessions": {
          "totalMonthlyLimit": null,
          "totalAnnualLimit": null,
          "totalConsumedThisMonth": 0,
          "totalConsumedThisYear": 0,
          "consumedMobileSessionsThisMonth": 0,
          "consumedMobileSessionsThisYear": 0,
          "consumedUserSessionsWithWebSessionReplayThisMonth": 0,
          "consumedUserSessionsWithWebSessionReplayThisYear": 0,
          "consumedUserSessionsWithMobileSessionReplayThisMonth": 0,
          "consumedUserSessionsWithMobileSessionReplayThisYear": 0
        },
        "sessionProperties": {
          "consumedThisMonth": 0,
          "consumedThisYear": 0
        },
        "syntheticMonitors": {
          "monthlyLimit": null,
          "annualLimit": null,
          "consumedThisMonth": 0,
          "consumedThisYear": 0
        },
        "customMetrics": null,
        "aiDataUnits": {
          "monthlyLimit": 18162,
          "annualLimit": null,
          "consumedThisMonth": 0,
          "consumedThisYear": 0
        },
        "logMonitoring": null
      }
    },
    {
      "name": "Service Team",
      "id": "881c4134-0000-0a00-aa0a-5b03ab7a34ed",
      "trial": false,
      "state": "ENABLED",
      "tags": [],
      "creationDate": "2021-02-07T08:49:45.091Z",
      "quotas": {
        "hostUnits": {
          "maxLimit": null,
          "currentUsage": 0
        },
        "demUnits": {
          "monthlyLimit": null,
          "annualLimit": null,
          "consumedThisMonth": 0,
          "consumedThisYear": 62
        },
        "userSessions": {
          "totalMonthlyLimit": null,
          "totalAnnualLimit": null,
          "totalConsumedThisMonth": 0,
          "totalConsumedThisYear": 0,
          "consumedMobileSessionsThisMonth": 0,
          "consumedMobileSessionsThisYear": 0,
          "consumedUserSessionsWithWebSessionReplayThisMonth": 0,
          "consumedUserSessionsWithWebSessionReplayThisYear": 0,
          "consumedUserSessionsWithMobileSessionReplayThisMonth": 0,
          "consumedUserSessionsWithMobileSessionReplayThisYear": 0
        },
        "sessionProperties": {
          "consumedThisMonth": 0,
          "consumedThisYear": 0
        },
        "syntheticMonitors": {
          "monthlyLimit": null,
          "annualLimit": null,
          "consumedThisMonth": 0,
          "consumedThisYear": 62
        },
        "customMetrics": null,
        "aiDataUnits": {
          "monthlyLimit": null,
          "annualLimit": null,
          "consumedThisMonth": 0,
          "consumedThisYear": 0
        },
        "logMonitoring": null
      }
    }
  ]
}

Код ответа

200