Skip to content

Admin API v2: add IcebergService (GetIcebergStatus) for 26.2#76

Open
kbatuigas wants to merge 1 commit into
mainfrom
DOC-2265-admin-v2-iceberg
Open

Admin API v2: add IcebergService (GetIcebergStatus) for 26.2#76
kbatuigas wants to merge 1 commit into
mainfrom
DOC-2265-admin-v2-iceberg

Conversation

@kbatuigas

Copy link
Copy Markdown
Contributor

Regenerate admin/admin-v2.yaml from redpanda core v26.2.1-rc4, which adds the IcebergService/GetIcebergStatus endpoint (and the FeaturesService endpoints that also landed in 26.2). Add an IcebergService tag description and an "Added in v26.2" version badge for the new endpoint.

Regenerate admin/admin-v2.yaml from redpanda core v26.2.1-rc4, which adds
the IcebergService/GetIcebergStatus endpoint (and the FeaturesService
endpoints that also landed in 26.2). Add an IcebergService tag description
and an "Added in v26.2" version badge for the new endpoint.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@kbatuigas
kbatuigas requested a review from a team as a code owner July 17, 2026 04:01
@github-actions

Copy link
Copy Markdown

🤖 Admin API (branch: v2) API structural change detected

Preview documentation

Structural change details

Added (3)

  • POST /redpanda.core.admin.v2.FeaturesService/FinalizeUpgrade
  • POST /redpanda.core.admin.v2.FeaturesService/GetUpgradeStatus
  • POST /redpanda.core.admin.v2.IcebergService/GetIcebergStatus

Modified (5)

  • POST /redpanda.core.admin.v2.ShadowLinkService/CreateShadowLink
    • Content type modified: application/json
      • Property modified: shadowLink
        • Property modified: configurations
          • Property modified: schemaRegistrySyncOptions
          • Property added: roleSyncOptions
      • Property added: validateOnly
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: shadowLink
          • Properties modified: configurations, status
  • POST /redpanda.core.admin.v2.ShadowLinkService/FailOver
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: shadowLink
          • Properties modified: configurations, status
  • POST /redpanda.core.admin.v2.ShadowLinkService/GetShadowLink
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: shadowLink
          • Properties modified: configurations, status
  • POST /redpanda.core.admin.v2.ShadowLinkService/ListShadowLinks
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: shadowLinks
          • Properties modified: configurations, status
  • POST /redpanda.core.admin.v2.ShadowLinkService/UpdateShadowLink
    • Content type modified: application/json
      • Property modified: shadowLink
        • Property modified: configurations
          • Property modified: schemaRegistrySyncOptions
          • Property added: roleSyncOptions
    • Response modified: 200
      • Content type modified: application/json
        • Property modified: shadowLink
          • Properties modified: configurations, status
Powered by Bump.sh

@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The Admin API v2 specification adds upgrade-finalization and upgrade-status models and routes, Iceberg catalog/topic/partition status reporting, and new shadow-link role and Schema Registry synchronization configuration and status schemas. Shadow-link creation now supports validation-only requests. The Iceberg endpoint is versioned and tagged in overlays, and the OpenAPI metadata is updated.

Estimated code review effort: 4 (Complex) | ~45 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly matches the main change: adding IcebergService/GetIcebergStatus for Admin API v2.
Description check ✅ Passed The description is directly related and accurately mentions the Iceberg endpoint, related FeaturesService endpoints, and the tag/version updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch DOC-2265-admin-v2-iceberg

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@admin/v2-overlays/add-endpoint-versioning.yaml`:
- Around line 92-95: Extend the v26.2 endpoint updates in the overlay to include
the FeaturesService paths for FinalizeUpgrade and GetUpgradeStatus, assigning
each the same x-state value, “Added in v26.2,” as the existing IcebergService
endpoint.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: cc276840-b3c2-4ec7-b4e7-3a42013f11b6

📥 Commits

Reviewing files that changed from the base of the PR and between 3878f71 and 5dde91b.

📒 Files selected for processing (3)
  • admin/admin-v2.yaml
  • admin/v2-overlays/add-endpoint-versioning.yaml
  • admin/v2-overlays/create-and-update-tags.yaml

Comment on lines +92 to +95
# 26.2 endpoints
- target: "$.paths['/redpanda.core.admin.v2.IcebergService/GetIcebergStatus'].post"
update:
x-state: "Added in v26.2" No newline at end of file

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Version the new FeaturesService endpoints as v26.2 too.

FinalizeUpgrade and GetUpgradeStatus are also introduced at admin/admin-v2.yaml Lines 3335-3431, but only the Iceberg endpoint receives an x-state marker.

Proposed fix
 # 26.2 endpoints
+  - target: "$.paths['/redpanda.core.admin.v2.FeaturesService/FinalizeUpgrade'].post"
+    update:
+      x-state: "Added in v26.2"
+  - target: "$.paths['/redpanda.core.admin.v2.FeaturesService/GetUpgradeStatus'].post"
+    update:
+      x-state: "Added in v26.2"
   - target: "$.paths['/redpanda.core.admin.v2.IcebergService/GetIcebergStatus'].post"
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
# 26.2 endpoints
- target: "$.paths['/redpanda.core.admin.v2.IcebergService/GetIcebergStatus'].post"
update:
x-state: "Added in v26.2"
# 26.2 endpoints
- target: "$.paths['/redpanda.core.admin.v2.FeaturesService/FinalizeUpgrade'].post"
update:
x-state: "Added in v26.2"
- target: "$.paths['/redpanda.core.admin.v2.FeaturesService/GetUpgradeStatus'].post"
update:
x-state: "Added in v26.2"
- target: "$.paths['/redpanda.core.admin.v2.IcebergService/GetIcebergStatus'].post"
update:
x-state: "Added in v26.2"
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@admin/v2-overlays/add-endpoint-versioning.yaml` around lines 92 - 95, Extend
the v26.2 endpoint updates in the overlay to include the FeaturesService paths
for FinalizeUpgrade and GetUpgradeStatus, assigning each the same x-state value,
“Added in v26.2,” as the existing IcebergService endpoint.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant