package mesos.v1.resource_provider

Get desktop application:
View/edit binary Protocol Buffers messages

NOTE: For the time being, this API is subject to change and the related feature is experimental.

• optional ResourceProviderID resource_provider_id = 1

  Identifies who generated this call. The 'ResourceProviderManager' assigns a resource provider ID when a new resource provider subscribes for the first time. Once assigned, the resource provider must set the 'resource_provider_id' here and within its 'ResourceProviderInfo' (in any further 'SUBSCRIBE' calls). This allows the 'ResourceProviderManager' to identify a resource provider correctly across disconnections, failovers, etc.

• optional Call.Type type = 2

• optional Call.Subscribe subscribe = 3

• optional Call.UpdateOperationStatus update_operation_status = 4

• optional Call.UpdateState update_state = 5

• optional Call.UpdatePublishResourcesStatus update_publish_resources_status = 6

Request to subscribe with the master.

Used in: Call

• required ResourceProviderInfo resource_provider_info = 1

Used in: Call

• UNKNOWN = 0

  This must be the first enum value in this list, to ensure that if 'type' is not set, the default value is UNKNOWN. This enables enum values to be added in a backwards-compatible way. See: MESOS-4997.

• SUBSCRIBE = 1

  See 'Subscribe'.

• UPDATE_OPERATION_STATUS = 2

  See 'UpdateOperationStatus'.

• UPDATE_STATE = 3

  See 'UpdateState'.

• UPDATE_PUBLISH_RESOURCES_STATUS = 4

  See 'UpdatePublishResourcesStatus'.

Notify the master about the status of an operation.

Used in: Call

• optional FrameworkID framework_id = 1

• required OperationStatus status = 2

• optional OperationStatus latest_status = 3

• required UUID operation_uuid = 4

  This is the internal UUID for the operation, which is kept independently from the framework-specified operation ID, which is optional.

Used in: Call

• required UUID uuid = 1

• required UpdatePublishResourcesStatus.Status status = 2

Used in: UpdatePublishResourcesStatus

• UNKNOWN = 0

• OK = 1

• FAILED = 2

Notify the master about the total resources and pending operations.

Used in: Call

• repeated Operation operations = 1

  This includes pending operations and those that have unacknowledged statuses.

• repeated Resource resources = 2

  The total resources provided by this resource provider.

• required UUID resource_version_uuid = 3

  Used to establish the relationship between the operation and the resources that the operation is operating on. Each resource provider will keep a resource version UUID, and change it when it believes that the resources from this resource provider are out of sync from the master's view. The master will keep track of the last known resource version UUID for each resource provider, and attach the resource version UUID in each operation it sends out. The resource provider should reject operations that have a different resource version UUID than that it maintains, because this means the operation is operating on resources that might have already been invalidated.

NOTE: For the time being, this API is subject to change and the related feature is experimental.

• optional Event.Type type = 1

• optional Event.Subscribed subscribed = 2

• optional Event.ApplyOperation apply_operation = 3

• optional Event.PublishResources publish_resources = 4

• optional Event.AcknowledgeOperationStatus acknowledge_operation_status = 5

• optional Event.ReconcileOperations reconcile_operations = 6

Received when an operation status update is being acknowledged. Acknowledgements may be generated either by a framework or by the master.

Used in: Event

• required UUID status_uuid = 1

  The UUID from the `OperationStatus` being acknowledged.

• required UUID operation_uuid = 2

  The UUID from the relevant `Operation`.

Received when the master wants to send an operation to the resource provider.

Used in: Event

• optional FrameworkID framework_id = 1

• required Offer.Operation info = 2

• required UUID operation_uuid = 3

  This is the internal UUID for the operation, which is kept independently from the framework-specified operation ID, which is optional.

• required UUID resource_version_uuid = 4

  Used to establish the relationship between the operation and the resources that the operation is operating on. Each resource provider will keep a resource version UUID, and change it when it believes that the resources from this resource provider are out of sync from the master's view. The master will keep track of the last known resource version UUID for each resource provider, and attach the resource version UUID in each operation it sends out. The resource provider should reject operations that have a different resource version UUID than that it maintains, because this means the operation is operating on resources that might have already been invalidated.

Received when the master wants to launch a task using resources of this resource provider.

Used in: Event

• required UUID uuid = 1

• repeated Resource resources = 2

Received when the resource provider manager wants to reconcile its view of the resource provider's operation state. The resource provider should generate operation status updates for any operation UUIDs in this message which are unknown to the resource provider.

Used in: Event

• repeated UUID operation_uuids = 1

First event received by the resource provider when it subscribes to the master.

Used in: Event

• required ResourceProviderID provider_id = 1

Used in: Event

• UNKNOWN = 0

  This must be the first enum value in this list, to ensure that if 'type' is not set, the default value is UNKNOWN. This enables enum values to be added in a backwards-compatible way. See: MESOS-4997.

• SUBSCRIBED = 1

  See 'Subscribed' below.

• APPLY_OPERATION = 2

  See 'ApplyOperation' below.

• PUBLISH_RESOURCES = 3

  See 'PublishResources' below.

• ACKNOWLEDGE_OPERATION_STATUS = 4

  See 'AcknowledgeOperationStatus' below.

• RECONCILE_OPERATIONS = 5

  See 'ReconcileOperations' below.