Introduction
A device share represents the sharing of streaming data from a device into multiple databases. A database which is the primary device subscriber may share the data with one or many other databases.
Important Legal and Cost Considerations:
  • Legal and cost implications: Data sharing carries legal and potential cost implications for both parties
  • Authorization required: All participants must be authorized to act on behalf of their respective organizations to establish the integration for the purposes of sharing data to or receiving data from other databases
  • Fees may apply: Consult your reseller or account manager before proceeding
  • Termination rights: Either party may terminate the share at any time by removing the DeviceShare entity
  • Acknowledgment: Programmatic invocation of the Add or Set API methods constitutes explicit acknowledgment of these terms on behalf of the caller's organization and is recorded in the system audit log
Properties

AcceptedDateTime

The date that the DeviceShare was accepted.

DateTime

The date time of when the DeviceShare was created.

ExpirationDateTime

When the DeviceShare is set to expire.

Id

The unique identifier for the specific Entity object in the Geotab system. See Id.

MyAdminId

The Int32 id that MyAdmin associates with this DeviceShare.

Name

The name of this entity which identifies it and is used when displaying this entity.

Options

The DeviceShareOptions of this DeviceShare.

SerialNumber

The String serial number of the device associated with this DeviceShare.

ShareStatus

The DeviceShareStatus of this DeviceShare.

ShareType

The DeviceShareType of this DeviceShare.

SourceDatabaseName

The name of the source database for this device share. This is the database that owns the device and is allowing the sharing to occur.

TargetDatabaseName

The name of the target database for this device share. This is the database that the device's data is being shared to, and does not own the device.

TerminatedDateTime

The date that the DeviceShare was terminated.

UpdatedDateTime

The date time of when the DeviceShare status was updated. This is when the share request was accepted/rejected by a target-database user or cancelled by a source-database user.

Version

The version of the entity.
Rate limits
MethodDescriptionLimitPeriodStatus
GetLimit of 800 Get requests per 1m.8001mInactive
SetLimit of 250 Set requests per 1m.2501mNot specified
AddLimit of 250 Add requests per 1m.2501mNot specified
GetCountOfLimit of 250 GetCountOf requests per 1m.2501mNot specified
GetFeedLimit of 250 GetFeed requests per 1m.2501mActive
RemoveLimit of 250 Remove requests per 1m.2501mNot specified
Timeout Limit
MethodDescriptionLimitStatus
GetFeedTimeout of 180 seconds for GetFeed per request.180Active

Loading API Runner...