Основы Data Management API - Object Storage Service (OSS)
В OSS файлы сохраняются как объекты в buckets. В дополнение к обеспечению вашего приложения возможностью загружать данные широкой экосистемы Forge, он также предоставляет функциональные возможности для управления собственными buckets и объектами вашего приложения (в том числе создание, удаление, перечисление, загрузки и скачивания). Чтобы избежать произвольно долгих ответов API, OSS осуществляет разбиение на страницы при перечислении buckets и объектов.
Каждый bucket также имеет политику удержания , которая определяет время удерживания объекта:
- transient: кэш-подобное хранение данных, которое сохраняется в течение всего 24 часов, идеально подходит для эфемерных объектов
- temporary: хранение, которое сохраняется в течение 30 дней. Хорошо для данных, загруженных и доступных, но постоянно не необходимо
- persistent: хранение, которое сохраняется, пока не будет удалено
JSON-структура службы Project and Data
Все типы представлены как ресурсы JSON API и используют одинаковую структуру:
- {
- "type": "type",
- "id": "identifier",
- "attributes": {
- "extension": {
- "type": " "
- }
- },
- "relationships": {}
- }
Следует отметить, что части полного представления были опущены для простоты.
|
attributes |
используется для описания свойств ресурса (например, name, createTime) |
|
attributes.extension |
используется для представления расширений базовых типов Смотрите раздел Extension=Types для получения дополнительной информации. |
|
relationships |
описывает отношения между текущим ресурсом и другими ресурсами в рамках одних и тех же или других служб Например, отношение между элементом файла и папкой, которой он принадлежит, представлено в виде отношения типа parent . То, как возвращается объект relationships, зависит от того, является ли источник элементом той же службы (внутреннее отношение) или другой службы (внешнее отношение), а также является ли ее отношение 1-к-1 или 1-ко-многим. Объект relationships может состоять из трех частей: data: тип и идентификатор соответствующего ресурса (только для отношения 1-к-1) links: используется для доступа к ресурсам, связанных с внутренним отношением meta: прямая ссылка на соответствующий ресурс с внешним отношением |
Источник: https://developer.autodesk.com/en/docs/oauth/v2/overview/
Обсуждение: http://adn-cis.org/forum/index.php?topic=
Опубликовано 06.01.2017