Каждый объект, который вы создаете внутри проекта — будь то база данных или секрет — представлен записью ресурса. Ресурсы дают каждому объекту единую идентичность: уникальный id, временные метки жизненного цикла и флаг is_active. Поскольку все объекты имеют эту общую структуру, вы можете управлять ими через единый API ресурсов независимо от их типа, а также организовывать их с помощью тегов.
Поля ресурса
| Поле | Тип | Описание |
|---|---|---|
id | hex-string | Уникальный идентификатор ресурса на платформе. Это resource_id, на который ссылаются базы данных и секреты. |
project_id | hex-string | Проект, к которому принадлежит ресурс. |
is_active | boolean | Активен ли ресурс. Деактивация ресурса помечает его как неактивный для последующего удаления. |
resource_type | string | Тип ресурса, например database или secret. |
created_at | timestamp | Дата и время создания ресурса. |
updated_at | timestamp | Дата и время последнего обновления ресурса. |
Теги
Теги — это метки в формате ключ-значение, которые вы прикрепляете к отдельным ресурсам. Вы используете их для организации, фильтрации и аннотирования ваших баз данных и секретов — например, помечая базу данных тегом env=production или team=backend.
Поля тега
| Поле | Тип | Описание |
|---|---|---|
id | integer | Уникальный идентификатор тега. |
project_id | hex-string | Проект, к которому принадлежит тег. |
tag_key | string | Ключ метки, например env. |
tag_value | string | Значение метки, например production. |
color | string | null | Опциональный HEX-код цвета для отображения. |
is_system | boolean | Был ли этот тег создан автоматически платформой Sb0rka. |
Системные теги
Sb0rka автоматически создает системные теги при создании определенных ресурсов. Вы не можете создавать системные теги самостоятельно.
Самый распространенный системный тег создается при создании базы данных:
| Ключ тега | Значение тега | Прикрепляется к |
|---|---|---|
database_resource_id | <database_resource_id> | Как к ресурсу базы данных, так и к связанному с ней секрету с паролем. |
Именно этот тег позволяет эндпоинту URI базы данных находить правильный секрет с учетными данными для конкретной базы данных. И база данных, и ее секрет имеют одинаковый тег database_resource_id, что упрощает поиск всех ресурсов, относящихся к конкретной базе данных.
Системные теги имеют is_system: true. Вы можете читать и просматривать их, но относитесь к ним как к предназначенным только для чтения.