IRPCBackgroundOperationsAdmin.CheckAndRegisterMultiServerResponsibility
Administration API / specialized internal: not for applications admin session idempotent
Tells whether this server is the one in a multi-server vault that runs the reporting data exports, and claims that role if no server has it.
| Service | Background operations MFiles.IRPCBackgroundOperationsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCBackgroundOperationsAdmin/CheckAndRegisterMultiServerResponsibility |
| HTTP (mf-http-grpc) | POST /grpc/v1/check-and-register-multi-server-responsibility |
| Request | CheckAndRegisterMultiServerResponsibilityRequest |
| Response | CheckAndRegisterMultiServerResponsibilityResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
For M-Files components only. M-Files Reporting Data Services calls it so that only one server of a multi-server vault runs the data exports. Applications should not call it.
- Requires a vault session and the server right
manage_jobs(system administrator server role). - On a single server it always returns true. In multi-server mode only the operation ID
mfdataexportis accepted; other IDs fail with "The parameter is incorrect.".
Request: CheckAndRegisterMultiServerResponsibilityRequest
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
operation_id | string | ID of the operation to check. |
Response: CheckAndRegisterMultiServerResponsibilityResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
is_responsible | bool | Receives true if this server machine is responsible of requested operation. |