API таблицы лицензий клиента

Management API предоставляет read-only таблицу лицензий одного клиента для Vendor Console. Tenant определяется только authenticated context пользователя или service account.

GET /api/v1/customers/organizations/{organizationId}/licenses/table?offset=0&limit=50
Permission: customers.read

offset по умолчанию равен 0. limit по умолчанию равен 50 и принимает 1..200. Порядок фиксирован: createdAtUtc по убыванию, затем licenseId по возрастанию. Все сохранённые lifecycle и migration states остаются видимыми.

Каждая строка BC-LIC обогащается Product label того же Tenant, тарифом и commercial renewal state из VCM, device counts из DEV и availability из USG. Ожидаемое отсутствие или противоречие owner-data передаётся явными resolution statuses. Текущее usage-состояние — NotAvailable: все measurement fields присутствуют и равны null; значения не выводятся из устройств, Analytics или import receipts.

Недоступность authoritative owner, отсутствующий или дублированный результат, а также чужой License ID закрывают весь запрос ответом 503 с кодом customer_license_table_dependency_unavailable; частичный 200 не возвращается. Ошибочные identity/paging дают customer_license_table_invalid_request, а отсутствующий или wrong-Tenant клиент — customer_license_table_not_found.

Ответ не содержит plaintext keys, hashes, provider references и внутренних Product/License codes. Таблица информационная и не разрешает Runtime или Edge rights.