bazelbuild / bazelbuild/remote-apis

Clarification: Ordering of entries in BatchReadBlobsResponse

Open
#52 3 comments 0 reactions 1 assignee Claimed by @bergsieker View on GitHub
Dominant language
Go
Stars
445
Forks
141
PR merge metrics
No merged PRs in 30d

Description

The API allows a client to request a list of blobs using `BatchReadBlobs()`. That sends a `BatchReadBlobsRequest` with a list of digests to the server, which in turn replies with a `BatchReadBlobsResponse`.

That response will contain, in the best-case scenario, a list of blobs that the client asked for. Since the specification states that the blobs should be allowed to fail separately, it could happen that not all of the blobs requested are contained in the response, although there will be an entry for them in the reply with `status` set to an error code.

The current specification, however, does not specify what should happen with the ordering of the blobs contained in the `BatchReadBlobsResponse`.

Should there be any guarantees or expectations regarding the relation between the ordering of the blobs in the response and the order of their corresponding requests?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.