IRPCQueryVersion.QueryVersion

View as Markdown

Vault API / core read no session idempotent

Gets the server version and the oldest client version the server accepts.

ServiceServer version MFiles.IRPCQueryVersion
gRPC method/MFiles.IRPCQueryVersion/QueryVersion
HTTP (mf-http-grpc)POST /grpc/v1/query-version
RequestQueryVersionRequest
ResponseQueryVersionResponse
Book and levelVault API, core
Kindread
SessionNot needed: the call can be made before logging in.
Idempotentyes
Returns metadata structure versionno
Streamingnone (unary)

Remarks

Needs no session and no mfiles-session-id-bin header. The response is the same for every caller, so the result can be cached for the lifetime of the connection.

All four fields are 64-bit packed versions: major << 48 | minor << 32 | build << 16 | patch. For example 7318397729964032 is 26.11.16645.0. Unpack them with shifts, not by formatting the decimal number.

Over gRPC all three "oldest compatible" fields carry the same value: the oldest client version the gRPC interface supports.

Request: QueryVersionRequest

No fields.

Response: QueryVersionResponse

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
server_versionuint64The server version, packed as major << 48 | minor << 32 | build << 16 | patch.
oldest_compatible_client_versionuint64The oldest client version that the server accepts over gRPC, packed like server_version.
oldest_compatible_admin_client_versionuint64The oldest admin client version that the server accepts, packed like server_version. Over gRPC this equals oldest_compatible_client_version.
oldest_compatible_replica_server_versionuint64The oldest replica server version that the server accepts, packed like server_version. Over gRPC this equals oldest_compatible_client_version.