источники

обновленный

Источник представляет собой источник данных из службы. Например, учетная запись iCloud является источником службы iCloud.

Источники могут иметь дочерние источники, которые раскрывают только определенную часть родительского источника. Примером этого является дочерний источник резервной копии iCloud, который, если на него указывают запросы данных, будет возвращать только данные, полученные из этой конкретной резервной копии.

Атрибуты

название тип описание
id идентификатор источника Идентификатор ресурса.
resource строка, всегда source Спецификатор типа ресурса.
user Идентификатор пользователя Пользователь, связанный с этим источником.
type строка Зависит от службы подложки. Например, iCloud имеет icloud_account источника icloud_account .
identifier строка Уникальный идентификатор источника в рамках его службы поддержки.
parent необязательно, идентификатор источника Заполняется, если источник является дочерним от другого.
children необязательно, список исходных ресурсов Любые подисточники источника.
state строка Один из: не unvalidated , active , deactivated , blocked , locked .
date_created Дата и время Когда ресурс был создан.

Типы

В настоящее время поддерживаются следующие типы:

  • icloud.account , первоисточник службы iCloud.
  • icloud.backup , дочерний источник icloud.account .
  • rirelay.instance , первоисточник службы rirelay. Соответствует экземпляру приложения Reincubate Relay.
  • rirelay.source , дочерний источник rirelay.instance . Соответствует устройству, к которому родительское приложение Reincubate Relay имеет доступ.

Идентификатор

Значение атрибута идентификатора источника identifier его уникально в пределах его службы. Для учетной записи iCloud это будет имя пользователя. Для экземпляра приложения Reincubate Relay это будет идентификатор экземпляра.

родитель

Если источник является дочерним источником, это поле будет указывать на его родительский исходный объект. Верхний источник в этой иерархии называется основным источником.

Дочерний источник не может быть создан напрямую через API, но автоматически создается API при создании соответствующего опроса. Например, после инициализации сеанса для источника icloud.account можно создать опрос типа info который будет извлекать информацию об учетной записи, включая любую информацию о существующих резервных копиях iCloud, связанных с этой учетной записью, и создавать соответствующие дочерние источники для них. , Дочерние источники могут быть направлены непосредственно для извлечения данных с помощью отдельных опросов.

состояния

unvalidated
сеанс никогда не был успешно создан для этого источника, поэтому API не может определить, является ли он допустимым источником.
active
источник был проверен и готов к использованию.
deactivated
доступ к источнику был запрещен организацией-владельцем.
blocked
доступ к источнику был запрещен администратором API.
locked
доступ к источнику был временно ограничен внешней службой.

Получить GET /sources/{source ID}

Использование cURL

curl https://ricloud-api.reincubate.com/sources/<source ID> \
  -H 'Authorization: Token <your key_token>'

Использование ricloud-py

import ricloud

source = ricloud.Source.create(<source ID>)

Список GET /sources

название тип описание
organisation супер, идентификатор организации Для администраторов API для фильтрации по организации.
user Идентификатор пользователя Фильтровать по связанному пользователю.
type строка Фильтр по типу источника.
identifier строка Фильтр по идентификатору источника.
state строка Фильтр по состоянию источника.
date_created фильтр даты и времени Фильтр по дате создания ресурса.

Использование cURL

curl https://ricloud-api.reincubate.com/sources \
  -H 'Authorization: Token <your key_token>'

Использование ricloud-py

import ricloud

sources = ricloud.Source.list()

Обновить POST /sources/{source ID}

название тип описание
state строка Обновите исходное состояние.

Использование cURL

curl https://ricloud-api.reincubate.com/sources/<source ID> \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "state": "deactivated"
}'

Использование ricloud-py

import ricloud

source = ricloud.Source.update_with_id(<source ID>, state='deactivated')

# OR

source = ricloud.Source.retrieve(<source ID>)

source.update(state='deactivated')

Как мы можем помочь?

Наша служба поддержки здесь, чтобы помочь!

Наш офис работает с понедельника по пятницу с 9:00 до 17:00 по Гринвичу. Время в настоящее время 2:16 ДП с GMT.

Мы стремимся отвечать на все сообщения в течение одного рабочего дня.

Перейти в раздел поддержки › Связаться с командой предприятия ›
Наша отличная команда поддержки

© 2008 - 2019 Reincubate Ltd. Все права защищены. Зарегистрировано в Англии и Уэльсе #5189175, VAT GB151788978. Reincubate® является зарегистрированным товарным знаком. Защита & Условия. Мы рекомендуем 2FA. Построен с в Лондоне.