// M-Files Server gRPC API 26.11. Generated from the M-Files Server IDL; do not edit.
// Documentation: https://developer.m-files.com/APIs/gRPC-API/
syntax = "proto3";

package MFiles;

import "mfiles/api/annotations.proto";
import "mfiles/structs.proto";

option csharp_namespace = "MFiles.Grpc";
option go_package = "github.com/M-Files/mfiles-grpc-api/go/mfiles;mfiles";
option java_multiple_files = true;
option java_package = "com.mfiles.grpc";
option objc_class_prefix = "MF_";

// Gets the identity of the server in M-Files Manage, for client features that call M-Files cloud
// services.
//
// Provides methods for working with the Cloud Management API.
//
// **For M-Files components only.** The M-Files desktop client reads the value when it sets up
// document comparison. Applications should not call it.
//
// The only method,
// [GetCloudManagementApiConfiguration](mfiles:MFiles.IRPCCloudManagementApiOperations.GetCloudManagementApiConfiguration),
// needs a vault session and no special rights.
service IRPCCloudManagementApiOperations {
	option (mfiles.api.service) = { book: "admin" level: LEVEL_SPECIALIZED title: "Cloud management" };

	// Gets the server's ID in M-Files Manage.
	//
	// **For M-Files components only.** The M-Files desktop client uses it for document comparison.
	// Applications should not call it.
	// - Requires a vault session; no special vault rights. A
	//   server-level session fails with "Login required.".
	// - `server_guid` is filled only on on-premises servers that are connected to M-Files Manage. It
	//   is empty on servers in M-Files Cloud containers (by design) and on servers without the
	//   connection.
	rpc GetCloudManagementApiConfiguration( GetCloudManagementApiConfigurationRequest ) returns ( GetCloudManagementApiConfigurationResponse ) {
		option (mfiles.api.method) = { session: SESSION_REQUIREMENT_SESSION internal: true };
	}
}

// The request of GetCloudManagementApiConfiguration.
message GetCloudManagementApiConfigurationRequest {
}

// The response of GetCloudManagementApiConfiguration.
message GetCloudManagementApiConfigurationResponse {

	// The server's M-Files Manage ID in `server_guid`, or empty. See [CloudManagementApiConfiguration](mfiles:MFiles.CloudManagementApiConfiguration).
	CloudManagementApiConfiguration configuration = 1;
}