GET объекты
Список объектов настроек, соответствующих заданным критериям.
Запрос создает в качестве полезной нагрузки application/json
формат.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/objects
|
Среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/objects
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение настроек ( settings.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
schemaIds | string | Список идентификаторов схем, разделенных запятыми, которым принадлежат запрошенные объекты.
Для загрузки первой страницы, когда nextPageKey не установлен, требуется либо этот параметр, либо области действия. Чтобы загрузить все объекты, принадлежащие данным идентификаторам схемы, оставьте параметр scopes пустым. |
query | по желанию |
scopes | string | Список разделенных запятыми областей, на которые нацелены запрошенные объекты.
Выбор соответствует только объектам, непосредственно нацеленным на указанные области. Например, Для загрузки первой страницы, когда nextPageKey не установлен, требуется либо этот параметр, либо schemaIds . Чтобы загрузить все объекты, принадлежащие заданным областям, оставьте параметр schemaIds пустым. |
query | по желанию |
fields | string | Список полей, которые должны быть включены в ответ. Предоставленный набор полей заменяет набор по умолчанию.
Укажите обязательные поля верхнего уровня через запятую (например, |
query | по желанию |
nextPageKey | string | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
query | по желанию |
pageSize | integer | Количество объектов настроек в полезной нагрузке одного ответа.
Максимально допустимый размер страницы – 500. Если не установлено, используется 100. |
query | по желанию |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | ObjectsList | Успех |
403 | ErrorEnvelope | Не удалось. Запрещенный. |
404 | ErrorEnvelope | Не удалось. Указанная схема или область не найдены. |
Объекты тела ответа
Объект ObjectsList
Список объектов настроек.
Элемент | Тип | Описание |
---|---|---|
pageSize | integer | Количество записей на странице. |
items | SettingsObject[] | Список объектов настроек. |
nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
totalCount | integer | Общее количество записей в результате. |
Объект SettingsObject
Объект настроек.
Элемент | Тип | Описание |
---|---|---|
schemaVersion | string | Версия схемы, на которой основан объект. |
updateToken | string | Токен обновления объекта. Вы можете использовать его для обнаружения одновременных изменений разными пользователями.
Генерируется при извлечении (запросы GET). Если установлено при обновлении (запрос PUT) или удалении, обновление/удаление будет разрешено только в том случае, если не было никаких изменений между получением и обновлением. Если опущено при обновлении/удалении, операция переопределяет текущее значение или удаляет его без каких-либо проверок. |
modified | integer | Отметка времени последней модификации. |
externalId | string | Внешний идентификатор объекта настроек. |
author | string | Пользователь (идентифицируемый по идентификатору пользователя или общедоступному идентификатору токена), выполнивший последнее изменение. |
schemaId | string | Схема, на которой основан объект. |
objectId | string | Идентификатор объекта настроек. |
created | integer | Отметка времени создания. |
scope | string | Область, на которую нацелен объект. |
summary | string | Кратко о настройках. |
value | SettingsValue | Значение настройки.
Он определяет фактические значения параметров настроек. Фактическое содержимое зависит от схемы объекта. |
Объект SettingsValue
Значение настройки.
Он определяет фактические значения параметров настроек.
Фактическое содержимое зависит от схемы объекта.
Объект не предоставляет никаких параметров.
JSON-модель тела ответа
{
"pageSize": 1,
"items": [
{
"schemaVersion": "1.0.0",
"updateToken": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ=",
"modified": 1,
"externalId": "string",
"author": "john.doe@example.com",
"schemaId": "builtin:container.built-in-monitoring-rule",
"objectId": "Y2ktaGdyb3VwLTEyMythZjhjOThlOS0wN2I0LTMyMGEtOTQzNi02NTEyMmVlNWY4NGQ=",
"created": 1,
"scope": "HOST-D3A3C5A146830A79",
"summary": "string",
"value": {
"autoMonitoring": true
}
}
],
"nextPageKey": "AQAAABQBAAAABQ==",
"totalCount": 1
}