FOformancehq
Indexes

Get a single bucket-scoped index registry entry

Changed on

Returns the Index registry entry for a bucket-scoped index (Ledger == "", e.g. audit indexes). Ledger-scoped lookups go through GET /v3/{ledgerName}/indexes/{canonicalId} — the two keyspaces are distinct so a bucket-scoped lookup with the same canonical will NotFound if only the ledger-scoped entry exists. Requires ledger:ReadOps scope.

get/v3/_/indexes/{canonicalId}

Request

  • Base URL
    http://localhost:9000
  • URL
    http://localhost:9000/v3/_/indexes/{canonicalId}
  • Auth
    • HTTP bearer
    • or none

Path parameters

canonicalIdstring required

Canonical form of the target IndexID.

Headers

X-Consistency'linearizable' | 'stale'

Read consistency. linearizable (the default) runs a Raft ReadIndex barrier and waits for the receiving node to apply up to it. stale serves the read from the receiving node's own store, with no barrier and no forwarding to the leader, so the answer may lag the leader. Matching ignores case and surrounding whitespace. An unknown value, or a repeated or comma-joined header, returns 400 INVALID_REQUEST on every /v3 route, writes included; a valid value has no effect on writes. The gRPC equivalent is the x-consistency request metadata.

Response

Index retrieved successfully.

dataobject required

Index (protobuf JSON representation)

Changes

  • f5e817eca038Revision changes
    • info

      api operation id getBucketIndex removed and replaced with v3GetBucketIndex

  • 3da23d327316Revision changes
    • info

      added the media type text/plain for the response with the status

    • info

      added the media type text/plain for the response with the status