package cs3.ocm.core.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

OCM Core API (deprecated and to be removed, use cs3/ocm/incoming/v1beta1/incoming_api.proto instead) This API is the mapping for the local system of the Open Cloud Mesh (OCM) sharing protocol. Implementations are expected to expose the `/ocm` endpoints according to the OCM API, and in response to those endpoints call the following API. Support for multi-protocol shares is included, if the remote sender supplies a multi-protocol share. The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119. The following are global requirements that apply to all methods: Any method MUST return CODE_OK on a succesful operation. Any method MAY return NOT_IMPLEMENTED. Any method MAY return INTERNAL. Any method MAY return UNKNOWN. Any method MAY return UNAUTHENTICATED.

• rpc CreateOCMCoreShare (CreateOCMCoreShareRequest, CreateOCMCoreShareResponse)

  ocm_core_api.proto:58

  Deprecated. Creates a new OCM share, in response to a call from the remote system

• rpc DeleteOCMCoreShare (DeleteOCMCoreShareRequest, DeleteOCMCoreShareResponse)

  ocm_core_api.proto:62

  Deprecated. Deletes an OCM share, in response to a notification from the remote system

• rpc UpdateOCMCoreShare (UpdateOCMCoreShareRequest, UpdateOCMCoreShareResponse)

  ocm_core_api.proto:60

  Deprecated. Updates an OCM share, in response to a notification from the remote system

Used as request type in: gateway.v1beta1.GatewayAPI.CreateOCMCoreShare, OcmCoreAPI.CreateOCMCoreShare

• optional types.v1beta1.Opaque opaque = 1

  OPTIONAL. Opaque information.

• string description = 2

  OPTIONAL. Description for the share.

• string name = 3

  REQUIRED. Name of the resource (file or folder).

• string resource_id = 4

  REQUIRED. Identifier to identify the resource at the provider side. This is unique per provider.

• optional identity.user.v1beta1.UserId owner = 5

  REQUIRED. Provider specific identifier of the owner of the resource.

• optional identity.user.v1beta1.UserId sender = 6

  REQUIRED. Provider specific identifier of the user that wants to share the resource.

• optional identity.user.v1beta1.UserId share_with = 7

  REQUIRED. Consumer specific identifier of the user or group the provider wants to share the resource with. This is known in advance, for example using the OCM invitation flow. Please note that the consumer service endpoint is known in advance as well, so this is no part of the request body. TODO: this field needs to represent either a user or group in the future, not only a user.

• storage.provider.v1beta1.ResourceType resource_type = 8

  REQUIRED. Resource type.

• sharing.ocm.v1beta1.ShareType share_type = 9

  REQUIRED. Recipient share type.

• optional types.v1beta1.Timestamp expiration = 10

  OPTIONAL. The expiration time for the OCM share.

• repeated sharing.ocm.v1beta1.Protocol protocols = 11

  REQUIRED. The protocols which are used to establish synchronisation, with their access rights. See also cs3/sharing/ocm/v1beta1/resources.proto for how to map this to the OCM share payload.

• string code = 12

  OPTIONAL. A nonce to be exchanged for a (potentially short-lived) bearer token.

Used as response type in: gateway.v1beta1.GatewayAPI.CreateOCMCoreShare, OcmCoreAPI.CreateOCMCoreShare

• optional rpc.v1beta1.Status status = 1

  REQUIRED. The response status.

• optional types.v1beta1.Opaque opaque = 2

  OPTIONAL. Opaque information.

• string id = 3

  REQUIRED. Unique ID to identify the share at the consumer side.

• optional types.v1beta1.Timestamp created = 4

  REQUIRED.

Used as request type in: gateway.v1beta1.GatewayAPI.DeleteOCMCoreShare, OcmCoreAPI.DeleteOCMCoreShare

• string id = 1

  REQUIRED. Unique ID to identify the share at the consumer side.

• optional types.v1beta1.Opaque opaque = 2

  OPTIONAL. Opaque information.

Used as response type in: gateway.v1beta1.GatewayAPI.DeleteOCMCoreShare, OcmCoreAPI.DeleteOCMCoreShare

• optional rpc.v1beta1.Status status = 1

  REQUIRED. The response status.

• optional types.v1beta1.Opaque opaque = 2

  OPTIONAL. Opaque information.

Used as request type in: gateway.v1beta1.GatewayAPI.UpdateOCMCoreShare, OcmCoreAPI.UpdateOCMCoreShare

• optional types.v1beta1.Opaque opaque = 1

  OPTIONAL. Opaque information.

• string ocm_share_id = 2

  REQUIRED. Unique ID to identify the share at the consumer side.

• string description = 3

  OPTIONAL. Description for the share.

• sharing.ocm.v1beta1.ShareType share_type = 5

  OPTIONAL. Recipient share type.

• optional types.v1beta1.Timestamp expiration = 6

  OPTIONAL. The expiration time for the OCM share.

• repeated sharing.ocm.v1beta1.Protocol protocols = 7

  OPTIONAL. The protocols which are used to establish synchronisation, with their access rights.

Used as response type in: gateway.v1beta1.GatewayAPI.UpdateOCMCoreShare, OcmCoreAPI.UpdateOCMCoreShare

• optional rpc.v1beta1.Status status = 1

  REQUIRED. The response status.

• optional types.v1beta1.Opaque opaque = 2

  OPTIONAL. Opaque information.