Management API

Management API — публичная поверхность автоматизации, которой пользуются graphenectl и Studio. Одна дверь сервера обслуживает Connect, gRPC и gRPC-Web из одного protobuf-контракта.

Используйте generated clients из proto/management/v1, а не парсинг output CLI. Сейчас контракт содержит девять services и 34 methods; они перечислены в Методах. Transport, authentication, errors и streams описаны в Протоколе.

Контекст запроса

Каждый запрос передаёт:

Authorization: Bearer <token>
X-Graphene-Namespace: team-a

Namespace header опционален. Credential одного namespace действует в нём; installation-wide admin по умолчанию попадает в default и выбирает другой через header. В целевом namespace авторизация проверяется заново.

Browser-вызовы разрешены с любого origin, но cookies не принимаются, а каждый не-preflight запрос всё равно требует bearer token.

Resource-first форма

Большинство доменных объектов — записи с адресом kind/id. Create, read, list, delete, transfer и invoke идут через ResourcesAPI; schemas и commands открываются из записей kind/<name>. Dedicated services остаются только для bytes, streams, значения секрета или токена и данных caller/server.

Так клиент остаётся generic: принесённый пайплайном kind появляется без его пересборки. Перед своим клиентом прочитайте Ресурсы.

Совместимость

Generated code коммитится в репозиториях server и Studio. Опубликованного cross-version окна пока нет; генерируйте clients от ревизии целевого сервера и тестируйте вместе. См. Совместимость.