From 34ca6bc92b247bd86ba53eacf03b3ca179e88e01 Mon Sep 17 00:00:00 2001 From: Wouter Bouvy Date: Tue, 22 Oct 2024 10:39:37 +0200 Subject: [PATCH] 0.213.0 --- CHANGELOG.md | 59 ++++++ assignment.proto | 59 +++++- device.proto | 5 + docs/enum-json/organization.json | 3 +- docs/html/asset_service.html | 8 + docs/html/assignment.html | 160 ++++++++++++++- docs/html/currentuser.html | 12 +- docs/html/device.html | 16 ++ docs/html/device_service.html | 16 ++ docs/html/event.html | 186 +++++++++++++++++- docs/html/field_service.html | 8 + docs/html/map.html | 8 + docs/html/message.html | 8 + docs/html/modem.html | 20 +- docs/html/modem_alarm.html | 8 + docs/html/modem_message_body_parser.html | 8 + docs/html/organization.html | 12 +- docs/html/simulation_service.html | 8 + docs/html/testing.html | 8 + docs/html/token.html | 14 ++ docs/html/transfer_service.html | 20 +- docs/html/value_service.html | 27 ++- docs/md/asset_service.md | 1 + docs/md/assignment.md | 45 ++++- docs/md/currentuser.md | 3 +- docs/md/device.md | 2 + docs/md/device_service.md | 2 + docs/md/event.md | 42 +++- docs/md/field_service.md | 1 + docs/md/map.md | 1 + docs/md/message.md | 1 + docs/md/modem.md | 4 +- docs/md/modem_alarm.md | 1 + docs/md/modem_message_body_parser.md | 1 + docs/md/organization.md | 3 +- docs/md/simulation_service.md | 1 + docs/md/testing.md | 1 + docs/md/token.md | 2 + docs/md/transfer_service.md | 4 +- docs/md/value_service.md | 14 +- .../build-proto/dependencyUpdates/report.txt | 6 + modem.proto | 4 + organization.proto | 9 +- token.proto | 6 + value_service.proto | 11 +- 45 files changed, 782 insertions(+), 56 deletions(-) create mode 100644 home/wbouvy/hiber/ms-code/cli/devops/api/customer/build-proto/dependencyUpdates/report.txt diff --git a/CHANGELOG.md b/CHANGELOG.md index 15007f3..4e1695b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,64 @@ # Changelog Hiber API +### 0.213 (2024-10-22) + +##### AssetService + +- Fixed a bug where assets with the same name were allowed in an organization. + +##### AssignmentService + +- Added `DeleteAssignment` rpc to remove an assignment even if it has a `time_range`. + - Added `remove_time` flag in a new `time` `oneof` to `Unassign` to efffectively do a `DeleteAssignment` command in the `Unassign` command. +- Added `override_conflicting_assignments` to `Assign` to unassign any devices from assets that would conflict with the new assignment. + +##### ExportService + +- Fixed an issue where CSV exports might fail occasionally. + +##### OrganizationService + +- Added `ASSETS` and `ASSET_DASHBOARD` organization features. +- Removed unused `BI_TOOLING_BETA` organization feature. + +##### TokenService + +- Fixed a bug where a token could be created despite failing with a validation error. + +##### UserService + +- Fixed a bug where user deletion could produce errors. + +##### ValueService + +- Performance improvements and removed the requirement of setting a time range when selecting values. + +### 0.212 (2024-10-08) + +##### ValueService + +- Added `value_type` to `ByValueType` to select on `Value.Type` (i.e. `Value.Type.TEXT` or `Value.Type.ENUM`) + - Renamed `ByNumericValueType` in `ValueSelection` to `ByValueType` to make it reflect the extra option. + - Renamed `ValueSelection.numeric_value_type` to `value_type` to reflect the extra option. + +##### ValueService + +- Removed `optional` flag on `DownsampledValues.Request.selection`, since the API actually requires a selection. + +##### TokenService + +- Added option to limit impersionation (access to child organizations) on a token. + +##### DeviceService + +- Added `Device.numeric_value_types` to quickly see the primary numeric value types that this device produces. + - The device may produce other values (like battery level), but these are the primary value types. + +##### ModemService + +- Added `Modem.numeric_value_types` to quickly see the primary numeric value types that this device produces. + - The device may produce other values (like battery level), but these are the primary value types. + ### 0.211 (2024-10-01) ##### ValueService diff --git a/assignment.proto b/assignment.proto index a5d58c9..b0ac8eb 100644 --- a/assignment.proto +++ b/assignment.proto @@ -23,9 +23,12 @@ service AssignmentService { /* Assign something, like an alarm to a modem. */ rpc Assign (Assign.Request) returns (Assign.Response); - /* Remove an assignment, like an alarm to a modem. */ + /* End an assignment, like an alarm to a modem. */ rpc Unassign (Unassign.Request) returns (Unassign.Response); + /* Delete an assignment, even if it has a time range. */ + rpc Delete (DeleteAssignment.Request) returns (DeleteAssignment.Response); + /* List assets with the devices and tags they are assigned to. */ rpc AssetAssignments (ListAssetAssignments.Request) returns (ListAssetAssignments.Response); @@ -214,6 +217,12 @@ message Assign { */ optional Timestamp end_time = 11; + /* Instead of throwing an error when there are conflicting assignments, + * unassign the conflicting assignments with the given time (override_time or now) and + * then making the assignment. + */ + optional bool override_conflicting_assignments = 13; + reserved 3; } message Response { @@ -241,13 +250,21 @@ message Unassign { asset.AssetSelection from_assets = 11; } - /* Time that the assignment ended. - * This marks the assignment as ended at the given moment in the past, but would not have effect in the past - * for assignments like parsers and alarms (i.e. no alarm events are removed). - * It would however work for assets having access to device data. - * This is not allowed to be a value in the future at the moment. - */ - optional Timestamp override_time = 10; + oneof time { + /* Time that the assignment ended. + * This marks the assignment as ended at the given moment in the past, but would not have effect in the past + * for assignments like parsers and alarms (i.e. no alarm events are removed). + * It would however work for assets having access to device data. + * This is not allowed to be a value in the future at the moment. + */ + Timestamp override_time = 10; + + /* Remove time from the assignment, if any. + * Effectively deletes the assignment if it was set with a time. + * Setting this to true makes this identical to using the Delete rpc. + */ + bool remove_time = 12; + } reserved 3; } @@ -257,6 +274,32 @@ message Unassign { } } +message DeleteAssignment { + message Request { + /* Pick the organization to use (/impersonate). If unset, your default organization is used. */ + optional string organization = 1; + + oneof unassign { + modem.message.bodyparser.ModemMessageBodyParserSelection unassign_parsers = 2; + modem.alarm.ModemAlarmSelection unassign_alarms = 4; + modem.ModemSelection unassign_modems = 6; + asset.AssetSelection unassign_assets = 9; + } + + oneof from { + modem.ModemSelection from_modems = 5; + tag.TagSelection from_tags = 7; + asset.AssetSelection from_assets = 11; + } + + reserved 3; + } + message Response { + repeated Assignment deleted = 1; + Request request = 2; + } +} + message ListAssetAssignments { message Request { /* Pick the organization to use (/impersonate). If unset, your default organization is used. */ diff --git a/device.proto b/device.proto index 7173544..2dbf9aa 100644 --- a/device.proto +++ b/device.proto @@ -71,6 +71,11 @@ message Device { /* The DeviceType for this device. See DeviceType for more information. */ string sensor_brand = 18; + /* The numeric value types that this device produces. + * The device may produce other values (like battery level), but these are the primary value types. + */ + repeated value.Value.Numeric.Type numeric_value_types = 19; + /* Collection of data about the devices it is connected to. */ message Links { /* Other identifiers for this devices. Could include data like its MAC-address or otherwise unique identifier. */ diff --git a/docs/enum-json/organization.json b/docs/enum-json/organization.json index 832fc43..26f3ff8 100644 --- a/docs/enum-json/organization.json +++ b/docs/enum-json/organization.json @@ -8,6 +8,7 @@ , "MODEM_CREATION": "Required to manually create modems using the ModemService." , "EARLY_ACCESS": "Used for organizations that get early access to features." , "EXPERIMENTAL": "Used for organizations that get access to experimental features. e.g. feature work in progress." - , "BI_TOOLING_BETA": "Integrate BI tooling in the Mission Control interface." + , "ASSETS": "Access the list of assets in Mission Control." + , "ASSET_DASHBOARD": "Use the new assets as primary data owner in Mission Control dashboards." } }] \ No newline at end of file diff --git a/docs/html/asset_service.html b/docs/html/asset_service.html index d9d2396..99da9dd 100644 --- a/docs/html/asset_service.html +++ b/docs/html/asset_service.html @@ -4615,6 +4615,14 @@

Device

The DeviceType for this device. See DeviceType for more information.

+ + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

+ + diff --git a/docs/html/assignment.html b/docs/html/assignment.html index 8b6bef8..54b2733 100644 --- a/docs/html/assignment.html +++ b/docs/html/assignment.html @@ -214,6 +214,18 @@

Table of Contents

MAssignmentSelection.AssignmentTypes +
  • + MDeleteAssignment +
    • + +
  • + MDeleteAssignment.Request +
    • + +
  • + MDeleteAssignment.Response +
    • +
  • MListAlarmAssignments
    • @@ -1348,6 +1360,15 @@

    Assign.Request

    This is not allowed to be a value in the future at the moment.

    + + override_conflicting_assignments + bool + optional +

    Instead of throwing an error when there are conflicting assignments, +unassign the conflicting assignments with the given time (override_time or now) and +then making the assignment.

    + + @@ -1686,6 +1707,117 @@

    AssignmentSelection.As +

    DeleteAssignment

    +

    + + + + + +

    DeleteAssignment.Request

    +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    organizationstringoptional

    Pick the organization to use (/impersonate). If unset, your default organization is used.

    unassign_parsershiber.modem.message.bodyparser.ModemMessageBodyParserSelection

    unassign_alarmshiber.modem.alarm.ModemAlarmSelection

    unassign_modemshiber.modem.ModemSelection

    unassign_assetshiber.asset.AssetSelection

    from_modemshiber.modem.ModemSelection

    from_tagshiber.tag.TagSelection

    from_assetshiber.asset.AssetSelection

    + + + + + +

    DeleteAssignment.Response

    +

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    deletedAssignmentrepeated

    requestDeleteAssignment.Request

    + + + + +

    ListAlarmAssignments

    @@ -2730,7 +2862,7 @@

    Unassign.Request

    override_time hiber.Timestamp - optional +

    Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). @@ -2738,6 +2870,15 @@

    Unassign.Request

    This is not allowed to be a value in the future at the moment.

    + + remove_time + bool + +

    Remove time from the assignment, if any. +Effectively deletes the assignment if it was set with a time. +Setting this to true makes this identical to using the Delete rpc.

    + + @@ -2867,7 +3008,14 @@

    AssignmentService

    Unassign Unassign.Request Unassign.Response -

    Remove an assignment, like an alarm to a modem.

    +

    End an assignment, like an alarm to a modem.

    + + + + Delete + DeleteAssignment.Request + DeleteAssignment.Response +

    Delete an assignment, even if it has a time range.

    @@ -6336,6 +6484,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/currentuser.html b/docs/html/currentuser.html index 1c0770a..c8b8882 100644 --- a/docs/html/currentuser.html +++ b/docs/html/currentuser.html @@ -4597,9 +4597,15 @@

    Organization.Feature

    - BI_TOOLING_BETA - 8 -

    Integrate BI tooling in the Mission Control interface.

    + ASSETS + 10 +

    Access the list of assets in Mission Control.

    + + + + ASSET_DASHBOARD + 11 +

    Use the new assets as primary data owner in Mission Control dashboards.

    diff --git a/docs/html/device.html b/docs/html/device.html index 31bc819..2931d70 100644 --- a/docs/html/device.html +++ b/docs/html/device.html @@ -1063,6 +1063,14 @@

    Device

    The DeviceType for this device. See DeviceType for more information.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + @@ -5149,6 +5157,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/device_service.html b/docs/html/device_service.html index 2385078..c0ddcfa 100644 --- a/docs/html/device_service.html +++ b/docs/html/device_service.html @@ -3672,6 +3672,14 @@

    Device

    The DeviceType for this device. See DeviceType for more information.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + @@ -4895,6 +4903,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/event.html b/docs/html/event.html index 8066e7d..471d659 100644 --- a/docs/html/event.html +++ b/docs/html/event.html @@ -613,6 +613,18 @@

    Table of Contents

    MAssignmentSelection.AssignmentTypes +
  • + MDeleteAssignment +
    • + +
  • + MDeleteAssignment.Request +
    • + +
  • + MDeleteAssignment.Response +
    • +
  • MListAlarmAssignments
    • @@ -7888,6 +7900,15 @@

    Assign.Request

    This is not allowed to be a value in the future at the moment.

    + + override_conflicting_assignments + bool + optional +

    Instead of throwing an error when there are conflicting assignments, +unassign the conflicting assignments with the given time (override_time or now) and +then making the assignment.

    + + @@ -8226,6 +8247,117 @@

    AssignmentSelection.As +

    DeleteAssignment

    +

    + + + + + +

    DeleteAssignment.Request

    +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    organizationstringoptional

    Pick the organization to use (/impersonate). If unset, your default organization is used.

    unassign_parsershiber.modem.message.bodyparser.ModemMessageBodyParserSelection

    unassign_alarmshiber.modem.alarm.ModemAlarmSelection

    unassign_modemshiber.modem.ModemSelection

    unassign_assetshiber.asset.AssetSelection

    from_modemshiber.modem.ModemSelection

    from_tagshiber.tag.TagSelection

    from_assetshiber.asset.AssetSelection

    + + + + + +

    DeleteAssignment.Response

    +

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    deletedAssignmentrepeated

    requestDeleteAssignment.Request

    + + + + +

    ListAlarmAssignments

    @@ -9270,7 +9402,7 @@

    Unassign.Request

    override_time hiber.Timestamp - optional +

    Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). @@ -9278,6 +9410,15 @@

    Unassign.Request

    This is not allowed to be a value in the future at the moment.

    + + remove_time + bool + +

    Remove time from the assignment, if any. +Effectively deletes the assignment if it was set with a time. +Setting this to true makes this identical to using the Delete rpc.

    + + @@ -9407,7 +9548,14 @@

    AssignmentService

    Unassign Unassign.Request Unassign.Response -

    Remove an assignment, like an alarm to a modem.

    +

    End an assignment, like an alarm to a modem.

    + + + + Delete + DeleteAssignment.Request + DeleteAssignment.Response +

    Delete an assignment, even if it has a time range.

    @@ -15861,6 +16009,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + @@ -21922,9 +22078,15 @@

    Organization.Feature

    - BI_TOOLING_BETA - 8 -

    Integrate BI tooling in the Mission Control interface.

    + ASSETS + 10 +

    Access the list of assets in Mission Control.

    + + + + ASSET_DASHBOARD + 11 +

    Use the new assets as primary data owner in Mission Control dashboards.

    @@ -23257,6 +23419,13 @@

    CreateTokenRequest

    Optionally, attempt to minimize the token size as much as possible.

    + + limit_impersonation + hiber.Filter.ChildOrganizations + optional +

    Optionally, limit the organizations that the token is allowed to impersonate.

    + + @@ -23503,6 +23672,13 @@

    Token

    Set if the current request is made with this token.

    + + limit_impersonation + hiber.Filter.ChildOrganizations + optional +

    Optionally, limit the organizations that the token is allowed to impersonate.

    + + diff --git a/docs/html/field_service.html b/docs/html/field_service.html index fc2519d..e03dc47 100644 --- a/docs/html/field_service.html +++ b/docs/html/field_service.html @@ -6088,6 +6088,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/map.html b/docs/html/map.html index e0b32cb..419513f 100644 --- a/docs/html/map.html +++ b/docs/html/map.html @@ -4858,6 +4858,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/message.html b/docs/html/message.html index d6e6664..e71e0c2 100644 --- a/docs/html/message.html +++ b/docs/html/message.html @@ -4269,6 +4269,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/modem.html b/docs/html/modem.html index f7afdff..f1d84ee 100644 --- a/docs/html/modem.html +++ b/docs/html/modem.html @@ -1829,6 +1829,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + @@ -7083,9 +7091,15 @@

    Organization.Feature

    - BI_TOOLING_BETA - 8 -

    Integrate BI tooling in the Mission Control interface.

    + ASSETS + 10 +

    Access the list of assets in Mission Control.

    + + + + ASSET_DASHBOARD + 11 +

    Use the new assets as primary data owner in Mission Control dashboards.

    diff --git a/docs/html/modem_alarm.html b/docs/html/modem_alarm.html index 176de07..bb0b0ab 100644 --- a/docs/html/modem_alarm.html +++ b/docs/html/modem_alarm.html @@ -6033,6 +6033,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/modem_message_body_parser.html b/docs/html/modem_message_body_parser.html index 8d9c566..4833421 100644 --- a/docs/html/modem_message_body_parser.html +++ b/docs/html/modem_message_body_parser.html @@ -6247,6 +6247,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/organization.html b/docs/html/organization.html index 70d2ed3..a21e02a 100644 --- a/docs/html/organization.html +++ b/docs/html/organization.html @@ -1529,9 +1529,15 @@

    Organization.Feature

    - BI_TOOLING_BETA - 8 -

    Integrate BI tooling in the Mission Control interface.

    + ASSETS + 10 +

    Access the list of assets in Mission Control.

    + + + + ASSET_DASHBOARD + 11 +

    Use the new assets as primary data owner in Mission Control dashboards.

    diff --git a/docs/html/simulation_service.html b/docs/html/simulation_service.html index e7ee4f5..91abaed 100644 --- a/docs/html/simulation_service.html +++ b/docs/html/simulation_service.html @@ -4069,6 +4069,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/testing.html b/docs/html/testing.html index 49ad485..d3f3626 100644 --- a/docs/html/testing.html +++ b/docs/html/testing.html @@ -4715,6 +4715,14 @@

    Modem

    The expected transmission rate for this modem.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + diff --git a/docs/html/token.html b/docs/html/token.html index 3048cd1..14f50cf 100644 --- a/docs/html/token.html +++ b/docs/html/token.html @@ -584,6 +584,13 @@

    CreateTokenRequest

    Optionally, attempt to minimize the token size as much as possible.

    + + limit_impersonation + hiber.Filter.ChildOrganizations + optional +

    Optionally, limit the organizations that the token is allowed to impersonate.

    + + @@ -830,6 +837,13 @@

    Token

    Set if the current request is made with this token.

    + + limit_impersonation + hiber.Filter.ChildOrganizations + optional +

    Optionally, limit the organizations that the token is allowed to impersonate.

    + + diff --git a/docs/html/transfer_service.html b/docs/html/transfer_service.html index 8a6eb32..9959829 100644 --- a/docs/html/transfer_service.html +++ b/docs/html/transfer_service.html @@ -3244,6 +3244,14 @@

    Device

    The DeviceType for this device. See DeviceType for more information.

    + + numeric_value_types + hiber.value.Value.Numeric.Type + repeated +

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    + + @@ -4508,9 +4516,15 @@

    Organization.Feature

    - BI_TOOLING_BETA - 8 -

    Integrate BI tooling in the Mission Control interface.

    + ASSETS + 10 +

    Access the list of assets in Mission Control.

    + + + + ASSET_DASHBOARD + 11 +

    Use the new assets as primary data owner in Mission Control dashboards.

    diff --git a/docs/html/value_service.html b/docs/html/value_service.html index 478b81a..5a22634 100644 --- a/docs/html/value_service.html +++ b/docs/html/value_service.html @@ -235,7 +235,7 @@

    Table of Contents

  • - MValueSelection.ByNumericValueType + MValueSelection.ByValueType
    • @@ -851,7 +851,7 @@

    DownsampledValues.Request

    selection ValueSelection - optional +

    The values to downsample. When multiple modems are given, the data is downsampled separately and merged together in the response, sorted by time.

    @@ -1276,8 +1276,8 @@

    ValueSelection

    - numeric_value_type - ValueSelection.ByNumericValueType + value_type + ValueSelection.ByValueType

    Get the values that are of the given numeric value types.

    @@ -1369,8 +1369,8 @@

    ValueSelection.ByField

    -

    ValueSelection.ByNumericValueType

    -

    Select the data by numeric value type.

    If the list is empty, all values with a numeric value type are returned.

    +

    ValueSelection.ByValueType

    +

    Select the data by (numeric) value type.

    If the selection is empty, all values with all types are returned.

    @@ -1379,6 +1379,13 @@

    ValueSelection.ByNumericV

    + + + + + + + @@ -4875,6 +4882,14 @@

    Modem

    + + + + + + +
    value_typeValue.Typerepeated

    numeric_value_type Value.Numeric.Type

    The expected transmission rate for this modem.

    numeric_value_typeshiber.value.Value.Numeric.Typerepeated

    The numeric value types that this device produces. +The device may produce other values (like battery level), but these are the primary value types.

    diff --git a/docs/md/asset_service.md b/docs/md/asset_service.md index 28f9f37..b3573de 100644 --- a/docs/md/asset_service.md +++ b/docs/md/asset_service.md @@ -599,6 +599,7 @@ They have a unique device number in our system, used to identify them. | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this device. | | type | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | | sensor_brand | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.device.Device.Links diff --git a/docs/md/assignment.md b/docs/md/assignment.md index 0a4ae6b..7869b6d 100644 --- a/docs/md/assignment.md +++ b/docs/md/assignment.md @@ -19,6 +19,9 @@ - [Assignment.ModemMessageBodyParserAssignment](#assignmentmodemmessagebodyparserassignment) - [AssignmentSelection](#assignmentselection) - [AssignmentSelection.AssignmentTypes](#assignmentselectionassignmenttypes) + - [DeleteAssignment](#deleteassignment) + - [DeleteAssignment.Request](#deleteassignmentrequest) + - [DeleteAssignment.Response](#deleteassignmentresponse) - [ListAlarmAssignments](#listalarmassignments) - [ListAlarmAssignments.Request](#listalarmassignmentsrequest) - [ListAlarmAssignments.Response](#listalarmassignmentsresponse) @@ -248,7 +251,13 @@ Assign something, like an alarm to a modem. > **rpc** Unassign([Unassign.Request](#unassignrequest)) [Unassign.Response](#unassignresponse) -Remove an assignment, like an alarm to a modem. +End an assignment, like an alarm to a modem. + +### Delete +> **rpc** Delete([DeleteAssignment.Request](#deleteassignmentrequest)) + [DeleteAssignment.Response](#deleteassignmentresponse) + +Delete an assignment, even if it has a time range. ### AssetAssignments > **rpc** AssetAssignments([ListAssetAssignments.Request](#listassetassignmentsrequest)) @@ -305,6 +314,7 @@ Add assignments. | alarm_parameters | [map Assign.Request.AlarmParametersEntry](#assignrequestalarmparametersentry) | The alarm parameters, by alarm identifier, if any, overriding any default values in the alarm(s). | | **optional** override_time | [optional hiber.Timestamp](#hibertimestamp) | Time that the assignment should be active. This sets the assignment to start in the past, but would not have effect in the past for assignments like parsers and alarms (they will only be triggered for new messages / values). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | | **optional** end_time | [optional hiber.Timestamp](#hibertimestamp) | Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | +| **optional** override_conflicting_assignments | [optional bool](#bool) | Instead of throwing an error when there are conflicting assignments, unassign the conflicting assignments with the given time (override_time or now) and then making the assignment. | ### Assign.Request.AlarmParametersEntry @@ -399,6 +409,35 @@ Assignments that are no longer active (end time is in the past) and that no long | include | [repeated AssignmentType](#assignmenttype) | | | exclude | [repeated AssignmentType](#assignmenttype) | | +### DeleteAssignment + + + + +### DeleteAssignment.Request + + + +| Field | Type | Description | +| ----- | ---- | ----------- | +| **optional** organization | [optional string](#string) | Pick the organization to use (/impersonate). If unset, your default organization is used. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_parsers | [ hiber.modem.message.bodyparser.ModemMessageBodyParserSelection](#hibermodemmessagebodyparsermodemmessagebodyparserselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_alarms | [ hiber.modem.alarm.ModemAlarmSelection](#hibermodemalarmmodemalarmselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_modems | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_modems | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_tags | [ hiber.tag.TagSelection](#hibertagtagselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | | + +### DeleteAssignment.Response + + + +| Field | Type | Description | +| ----- | ---- | ----------- | +| deleted | [repeated Assignment](#assignment) | | +| request | [ DeleteAssignment.Request](#deleteassignmentrequest) | | + ### ListAlarmAssignments @@ -666,7 +705,8 @@ Remove a assignment. | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_modems | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_tags | [ hiber.tag.TagSelection](#hibertagtagselection) | | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | | -| **optional** override_time | [optional hiber.Timestamp](#hibertimestamp) | Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **time**.override_time | [ hiber.Timestamp](#hibertimestamp) | Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **time**.remove_time | [ bool](#bool) | Remove time from the assignment, if any. Effectively deletes the assignment if it was set with a time. Setting this to true makes this identical to using the Delete rpc. | ### Unassign.Response @@ -825,6 +865,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/currentuser.md b/docs/md/currentuser.md index 9598560..2884bcb 100644 --- a/docs/md/currentuser.md +++ b/docs/md/currentuser.md @@ -681,7 +681,8 @@ Note that the organization field specifies the organization, it is not used to u | MODEM_CREATION | Required to manually create modems using the ModemService. | 4 | | EARLY_ACCESS | Used for organizations that get early access to features. | 5 | | EXPERIMENTAL | Used for organizations that get access to experimental features. e.g. feature work in progress. | 6 | -| BI_TOOLING_BETA | Integrate BI tooling in the Mission Control interface. | 8 | +| ASSETS | Access the list of assets in Mission Control. | 10 | +| ASSET_DASHBOARD | Use the new assets as primary data owner in Mission Control dashboards. | 11 | diff --git a/docs/md/device.md b/docs/md/device.md index 6a4844d..31a511c 100644 --- a/docs/md/device.md +++ b/docs/md/device.md @@ -160,6 +160,7 @@ They have a unique device number in our system, used to identify them. | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this device. | | type | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | | sensor_brand | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### Device.Links @@ -380,6 +381,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/device_service.md b/docs/md/device_service.md index 7cac8fb..f3ddaea 100644 --- a/docs/md/device_service.md +++ b/docs/md/device_service.md @@ -312,6 +312,7 @@ They have a unique device number in our system, used to identify them. | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this device. | | type | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | | sensor_brand | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.device.Device.Links @@ -442,6 +443,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/event.md b/docs/md/event.md index 3a496c3..527b589 100644 --- a/docs/md/event.md +++ b/docs/md/event.md @@ -119,6 +119,9 @@ - [hiber.assign.Assignment.ModemMessageBodyParserAssignment](#hiberassignassignmentmodemmessagebodyparserassignment) - [hiber.assign.AssignmentSelection](#hiberassignassignmentselection) - [hiber.assign.AssignmentSelection.AssignmentTypes](#hiberassignassignmentselectionassignmenttypes) + - [hiber.assign.DeleteAssignment](#hiberassigndeleteassignment) + - [hiber.assign.DeleteAssignment.Request](#hiberassigndeleteassignmentrequest) + - [hiber.assign.DeleteAssignment.Response](#hiberassigndeleteassignmentresponse) - [hiber.assign.ListAlarmAssignments](#hiberassignlistalarmassignments) - [hiber.assign.ListAlarmAssignments.Request](#hiberassignlistalarmassignmentsrequest) - [hiber.assign.ListAlarmAssignments.Response](#hiberassignlistalarmassignmentsresponse) @@ -1782,6 +1785,7 @@ Add assignments. | alarm_parameters | [map hiber.assign.Assign.Request.AlarmParametersEntry](#hiberassignassignrequestalarmparametersentry) | The alarm parameters, by alarm identifier, if any, overriding any default values in the alarm(s). | | **optional** override_time | [optional hiber.Timestamp](#hibertimestamp) | Time that the assignment should be active. This sets the assignment to start in the past, but would not have effect in the past for assignments like parsers and alarms (they will only be triggered for new messages / values). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | | **optional** end_time | [optional hiber.Timestamp](#hibertimestamp) | Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | +| **optional** override_conflicting_assignments | [optional bool](#bool) | Instead of throwing an error when there are conflicting assignments, unassign the conflicting assignments with the given time (override_time or now) and then making the assignment. | ### hiber.assign.Assign.Request.AlarmParametersEntry @@ -1876,6 +1880,35 @@ Assignments that are no longer active (end time is in the past) and that no long | include | [repeated hiber.assign.AssignmentType](#hiberassignassignmenttype) | | | exclude | [repeated hiber.assign.AssignmentType](#hiberassignassignmenttype) | | +### hiber.assign.DeleteAssignment + + + + +### hiber.assign.DeleteAssignment.Request + + + +| Field | Type | Description | +| ----- | ---- | ----------- | +| **optional** organization | [optional string](#string) | Pick the organization to use (/impersonate). If unset, your default organization is used. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_parsers | [ hiber.modem.message.bodyparser.ModemMessageBodyParserSelection](#hibermodemmessagebodyparsermodemmessagebodyparserselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_alarms | [ hiber.modem.alarm.ModemAlarmSelection](#hibermodemalarmmodemalarmselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_modems | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **unassign**.unassign_assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_modems | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_tags | [ hiber.tag.TagSelection](#hibertagtagselection) | | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | | + +### hiber.assign.DeleteAssignment.Response + + + +| Field | Type | Description | +| ----- | ---- | ----------- | +| deleted | [repeated hiber.assign.Assignment](#hiberassignassignment) | | +| request | [ hiber.assign.DeleteAssignment.Request](#hiberassigndeleteassignmentrequest) | | + ### hiber.assign.ListAlarmAssignments @@ -2143,7 +2176,8 @@ Remove a assignment. | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_modems | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_tags | [ hiber.tag.TagSelection](#hibertagtagselection) | | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **from**.from_assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | | -| **optional** override_time | [optional hiber.Timestamp](#hibertimestamp) | Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **time**.override_time | [ hiber.Timestamp](#hibertimestamp) | Time that the assignment ended. This marks the assignment as ended at the given moment in the past, but would not have effect in the past for assignments like parsers and alarms (i.e. no alarm events are removed). It would however work for assets having access to device data. This is not allowed to be a value in the future at the moment. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **time**.remove_time | [ bool](#bool) | Remove time from the assignment, if any. Effectively deletes the assignment if it was set with a time. Setting this to true makes this identical to using the Delete rpc. | ### hiber.assign.Unassign.Response @@ -2950,6 +2984,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection @@ -4397,7 +4432,8 @@ Note that the organization field specifies the organization, it is not used to u | MODEM_CREATION | Required to manually create modems using the ModemService. | 4 | | EARLY_ACCESS | Used for organizations that get early access to features. | 5 | | EXPERIMENTAL | Used for organizations that get access to experimental features. e.g. feature work in progress. | 6 | -| BI_TOOLING_BETA | Integrate BI tooling in the Mission Control interface. | 8 | +| ASSETS | Access the list of assets in Mission Control. | 10 | +| ASSET_DASHBOARD | Use the new assets as primary data owner in Mission Control dashboards. | 11 | @@ -4608,6 +4644,7 @@ so not all messages listed here are referenced.) | **optional** roles | [optional hiber.Filter.Roles](#hiberfilterroles) | Roles the new token should get. | | **optional** for_user_id | [optional string](#string) | Optionally, if you have the USERS_MANAGE permission, you can make a token for another user. If you do, you cannot grant it permissions they do not have, not can you grant it any user permissions. | | **optional** minimize | [optional bool](#bool) | Optionally, attempt to minimize the token size as much as possible. | +| **optional** limit_impersonation | [optional hiber.Filter.ChildOrganizations](#hiberfilterchildorganizations) | Optionally, limit the organizations that the token is allowed to impersonate. | ### hiber.token.CreateTokenRequest.Response @@ -4670,6 +4707,7 @@ so not all messages listed here are referenced.) | type | [ hiber.token.Token.Type](#hibertokentokentype) | | | **optional** last_used | [optional hiber.Date](#hiberdate) | Date that the token was last used. | | used_for_this_call | [ bool](#bool) | Set if the current request is made with this token. | +| **optional** limit_impersonation | [optional hiber.Filter.ChildOrganizations](#hiberfilterchildorganizations) | Optionally, limit the organizations that the token is allowed to impersonate. | ### hiber.token.Token.UserDetails diff --git a/docs/md/field_service.md b/docs/md/field_service.md index 47cf206..cf1b6b9 100644 --- a/docs/md/field_service.md +++ b/docs/md/field_service.md @@ -730,6 +730,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/map.md b/docs/md/map.md index 81753aa..65247d3 100644 --- a/docs/md/map.md +++ b/docs/md/map.md @@ -404,6 +404,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/message.md b/docs/md/message.md index 17925a8..15121ce 100644 --- a/docs/md/message.md +++ b/docs/md/message.md @@ -269,6 +269,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/modem.md b/docs/md/modem.md index 92cbf16..32806f0 100644 --- a/docs/md/modem.md +++ b/docs/md/modem.md @@ -426,6 +426,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### Modem.ConnectedDeviceInfo @@ -1088,7 +1089,8 @@ Note that the organization field specifies the organization, it is not used to u | MODEM_CREATION | Required to manually create modems using the ModemService. | 4 | | EARLY_ACCESS | Used for organizations that get early access to features. | 5 | | EXPERIMENTAL | Used for organizations that get access to experimental features. e.g. feature work in progress. | 6 | -| BI_TOOLING_BETA | Integrate BI tooling in the Mission Control interface. | 8 | +| ASSETS | Access the list of assets in Mission Control. | 10 | +| ASSET_DASHBOARD | Use the new assets as primary data owner in Mission Control dashboards. | 11 | diff --git a/docs/md/modem_alarm.md b/docs/md/modem_alarm.md index 2225e86..4ec7e97 100644 --- a/docs/md/modem_alarm.md +++ b/docs/md/modem_alarm.md @@ -961,6 +961,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/modem_message_body_parser.md b/docs/md/modem_message_body_parser.md index 9a4cd9f..639aca8 100644 --- a/docs/md/modem_message_body_parser.md +++ b/docs/md/modem_message_body_parser.md @@ -850,6 +850,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/organization.md b/docs/md/organization.md index 956cacf..e0f252f 100644 --- a/docs/md/organization.md +++ b/docs/md/organization.md @@ -417,7 +417,8 @@ Note that the organization field specifies the organization, it is not used to u | MODEM_CREATION | Required to manually create modems using the ModemService. | 4 | | EARLY_ACCESS | Used for organizations that get early access to features. | 5 | | EXPERIMENTAL | Used for organizations that get access to experimental features. e.g. feature work in progress. | 6 | -| BI_TOOLING_BETA | Integrate BI tooling in the Mission Control interface. | 8 | +| ASSETS | Access the list of assets in Mission Control. | 10 | +| ASSET_DASHBOARD | Use the new assets as primary data owner in Mission Control dashboards. | 11 | diff --git a/docs/md/simulation_service.md b/docs/md/simulation_service.md index b5a4371..c239989 100644 --- a/docs/md/simulation_service.md +++ b/docs/md/simulation_service.md @@ -255,6 +255,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/testing.md b/docs/md/testing.md index 9063cbb..d79a9b4 100644 --- a/docs/md/testing.md +++ b/docs/md/testing.md @@ -435,6 +435,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/docs/md/token.md b/docs/md/token.md index 8d4f7c9..fec36f2 100644 --- a/docs/md/token.md +++ b/docs/md/token.md @@ -151,6 +151,7 @@ | **optional** roles | [optional hiber.Filter.Roles](#hiberfilterroles) | Roles the new token should get. | | **optional** for_user_id | [optional string](#string) | Optionally, if you have the USERS_MANAGE permission, you can make a token for another user. If you do, you cannot grant it permissions they do not have, not can you grant it any user permissions. | | **optional** minimize | [optional bool](#bool) | Optionally, attempt to minimize the token size as much as possible. | +| **optional** limit_impersonation | [optional hiber.Filter.ChildOrganizations](#hiberfilterchildorganizations) | Optionally, limit the organizations that the token is allowed to impersonate. | ### CreateTokenRequest.Response @@ -213,6 +214,7 @@ | type | [ Token.Type](#tokentype) | | | **optional** last_used | [optional hiber.Date](#hiberdate) | Date that the token was last used. | | used_for_this_call | [ bool](#bool) | Set if the current request is made with this token. | +| **optional** limit_impersonation | [optional hiber.Filter.ChildOrganizations](#hiberfilterchildorganizations) | Optionally, limit the organizations that the token is allowed to impersonate. | ### Token.UserDetails diff --git a/docs/md/transfer_service.md b/docs/md/transfer_service.md index 2debd76..ab123fe 100644 --- a/docs/md/transfer_service.md +++ b/docs/md/transfer_service.md @@ -239,6 +239,7 @@ They have a unique device number in our system, used to identify them. | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this device. | | type | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | | sensor_brand | [ string](#string) | The DeviceType for this device. See DeviceType for more information. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.device.Device.Links @@ -567,7 +568,8 @@ Note that the organization field specifies the organization, it is not used to u | MODEM_CREATION | Required to manually create modems using the ModemService. | 4 | | EARLY_ACCESS | Used for organizations that get early access to features. | 5 | | EXPERIMENTAL | Used for organizations that get access to experimental features. e.g. feature work in progress. | 6 | -| BI_TOOLING_BETA | Integrate BI tooling in the Mission Control interface. | 8 | +| ASSETS | Access the list of assets in Mission Control. | 10 | +| ASSET_DASHBOARD | Use the new assets as primary data owner in Mission Control dashboards. | 11 | diff --git a/docs/md/value_service.md b/docs/md/value_service.md index 92de3ae..099f89e 100644 --- a/docs/md/value_service.md +++ b/docs/md/value_service.md @@ -27,7 +27,7 @@ Messages are parsed to a number of values (depending on the parser), which can b - [ValueContext.ValueDurations](#valuecontextvaluedurations) - [ValueSelection](#valueselection) - [ValueSelection.ByField](#valueselectionbyfield) - - [ValueSelection.ByNumericValueType](#valueselectionbynumericvaluetype) + - [ValueSelection.ByValueType](#valueselectionbyvaluetype) - Enums - [ListValues.Sort](#listvaluessort) @@ -172,7 +172,7 @@ Request downsampled values, reducing the selected time range to a single value p | Field | Type | Description | | ----- | ---- | ----------- | | **optional** organization | [optional string](#string) | Pick the organization to use (/impersonate). If unset, your default organization is used. | -| **optional** selection | [optional ValueSelection](#valueselection) | The values to downsample. When multiple modems are given, the data is downsampled separately and merged together in the response, sorted by time. | +| selection | [ ValueSelection](#valueselection) | The values to downsample. When multiple modems are given, the data is downsampled separately and merged together in the response, sorted by time. | | **optional** points | [optional uint32](#uint32) | Downsample the values to the given amount of data points. | | **optional** pagination | [optional hiber.Pagination](#hiberpagination) | Paginate the downsampled values, if needed. | | sort | [ ListValues.Sort](#listvaluessort) | How to sort the downsampled values. | @@ -282,7 +282,7 @@ Select the values to return. | ----- | ---- | ----------- | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **owner_selection**.devices | [ hiber.modem.ModemSelection](#hibermodemmodemselection) | Select the devices(s) to get the values for. | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **owner_selection**.assets | [ hiber.asset.AssetSelection](#hiberassetassetselection) | Select the asset(s) to get the values for. | -| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **data_selection**.numeric_value_type | [ ValueSelection.ByNumericValueType](#valueselectionbynumericvaluetype) | Get the values that are of the given numeric value types. | +| [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **data_selection**.value_type | [ ValueSelection.ByValueType](#valueselectionbyvaluetype) | Get the values that are of the given numeric value types. | | [**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) **data_selection**.field | [ ValueSelection.ByField](#valueselectionbyfield) | Get the values for the selected fields. | | fields | [repeated string](#string) | Deprecated. Get the values for the selected fields. | | **optional** time_range | [optional hiber.TimeRange](#hibertimerange) | The time to view the values for. | @@ -298,13 +298,14 @@ If the list is empty, all fields are returned. | ----- | ---- | ----------- | | fields | [repeated string](#string) | | -### ValueSelection.ByNumericValueType +### ValueSelection.ByValueType -Select the data by numeric value type. -If the list is empty, all values with a numeric value type are returned. +Select the data by (numeric) value type. +If the selection is empty, all values with all types are returned. | Field | Type | Description | | ----- | ---- | ----------- | +| value_type | [repeated Value.Type](#valuetype) | | | numeric_value_type | [repeated Value.Numeric.Type](#valuenumerictype) | | @@ -449,6 +450,7 @@ when the modem is registered into the system or when a subscription is authorize | time_zone | [ string](#string) | The timezone configured for the modem. | | transmission_interval | [ hiber.Duration](#hiberduration) | The transmission interval for this modem, if configured. | | **optional** expected_transmission_rate | [optional hiber.value.Value.Numeric.Rate](#hibervaluevaluenumericrate) | The expected transmission rate for this modem. | +| numeric_value_types | [repeated hiber.value.Value.Numeric.Type](#hibervaluevaluenumerictype) | The numeric value types that this device produces. The device may produce other values (like battery level), but these are the primary value types. | ### hiber.modem.ModemSelection diff --git a/home/wbouvy/hiber/ms-code/cli/devops/api/customer/build-proto/dependencyUpdates/report.txt b/home/wbouvy/hiber/ms-code/cli/devops/api/customer/build-proto/dependencyUpdates/report.txt new file mode 100644 index 0000000..10971d0 --- /dev/null +++ b/home/wbouvy/hiber/ms-code/cli/devops/api/customer/build-proto/dependencyUpdates/report.txt @@ -0,0 +1,6 @@ +------------------------------------------------------------ +/home/wbouvy/hiber/ms-code/cli/devops/api/customer/proto + +------------------------------------------------------------ +:api:customer:proto Project Dependency Updates (report to plain text file) +------------------------------------------------------------ diff --git a/modem.proto b/modem.proto index ae38601..b55734e 100644 --- a/modem.proto +++ b/modem.proto @@ -135,6 +135,10 @@ message Modem { /* The expected transmission rate for this modem. */ optional hiber.value.Value.Numeric.Rate expected_transmission_rate = 34; + /* The numeric value types that this device produces. + * The device may produce other values (like battery level), but these are the primary value types. + */ + repeated value.Value.Numeric.Type numeric_value_types = 35; /* Additional information when this modem is a gateway. */ message GatewayInfo { diff --git a/organization.proto b/organization.proto index 24bf4ce..2790d7c 100644 --- a/organization.proto +++ b/organization.proto @@ -65,10 +65,13 @@ message Organization { /* Used for organizations that get access to experimental features. e.g. feature work in progress. */ EXPERIMENTAL = 6; - /* Integrate BI tooling in the Mission Control interface. */ - BI_TOOLING_BETA = 8; + /* Access the list of assets in Mission Control. */ + ASSETS = 10; - reserved 3, 7, 9; + /* Use the new assets as primary data owner in Mission Control dashboards. */ + ASSET_DASHBOARD = 11; + + reserved 3, 7, 8, 9; } /* The slug for this organization, used to identify organizations */ diff --git a/token.proto b/token.proto index c476783..32c6afe 100644 --- a/token.proto +++ b/token.proto @@ -48,6 +48,9 @@ message Token { /* Set if the current request is made with this token. */ bool used_for_this_call = 12; + /* Optionally, limit the organizations that the token is allowed to impersonate. */ + optional Filter.ChildOrganizations limit_impersonation = 14; + message UserDetails { string id = 1; string email = 2; @@ -105,6 +108,9 @@ message CreateTokenRequest { /* Optionally, attempt to minimize the token size as much as possible. */ optional bool minimize = 11; + /* Optionally, limit the organizations that the token is allowed to impersonate. */ + optional Filter.ChildOrganizations limit_impersonation = 12; + reserved 3, 7; } diff --git a/value_service.proto b/value_service.proto index c2f1f73..59bbb83 100644 --- a/value_service.proto +++ b/value_service.proto @@ -31,10 +31,11 @@ message ValueSelection { repeated string fields = 1; } - /* Select the data by numeric value type. - * If the list is empty, all values with a numeric value type are returned. + /* Select the data by (numeric) value type. + * If the selection is empty, all values with all types are returned. */ - message ByNumericValueType { + message ByValueType { + repeated Value.Type value_type = 2; repeated Value.Numeric.Type numeric_value_type = 1; } @@ -52,7 +53,7 @@ message ValueSelection { */ oneof data_selection { /* Get the values that are of the given numeric value types. */ - ByNumericValueType numeric_value_type = 8; + ByValueType value_type = 8; /* Get the values for the selected fields. */ ByField field = 9; @@ -172,7 +173,7 @@ message DownsampledValues { * When multiple modems are given, the data is downsampled separately and merged together in the response, * sorted by time. */ - optional ValueSelection selection = 2; + ValueSelection selection = 2; /* Downsample the values to the given amount of data points. */ optional uint32 points = 3;