IotHub TALQ
  1. Device
IotHub TALQ
  • API
    • Guia
      • Vendor
        • Create a Guia Vendor
        • List Guia Vendors
        • Modify a Guia Vendor
        • Modify a Guia Photo Vendor
      • Devices
        • List Guia Devices
        • Get a Guia Device
        • Get a Guia Device Attribute History
        • List Guia Gateways
        • Modify devices
        • Modify device
        • Modify device function
        • Modify device - Set External Id
        • Modify device function attribute
        • Modify a Guia Change Asset Device
        • Create a Guia Device From Identified Material
        • Create a Guia Device Multiple From Identified Material
      • Device classes
        • List Guia Device Classes
        • Get a Guia Device Class
        • List Guia Device Class Functions
      • Functions
        • List Guia Functions
        • List Guia Function Attributes
        • List Guia Function Types
      • Attributes
        • List Guia Attributes get
        • List Guia Function Attributes
      • Groups
        • Create a Guia Group
        • List Guia Groups
        • Get a Guia Group
        • Get Count
        • Get a Guia Group Member Count
        • Update Groups
        • Update a Guia Group
        • Update a Guia Group Member
        • Delete a Guia Group
        • Delete a Guia Group Member
    • TALQ
      • Device Class
        • Create a Talq Device Class
        • Update Talq Device Class
        • Delete a Talq Device Class
        • Update a Talq Device Class
      • Device
        • Create a Talq Device
          POST
        • List Talq Devices
          GET
        • Modify a Talq Device
          PATCH
        • Update Talq Devices
          PUT
        • Delete a Talq Device
          DELETE
        • Get a Talq Device
          GET
        • Modify a Talq Device patch
          PATCH
        • Update a Talq Device
          PUT
        • Get a Talq Device Function
          GET
        • Get a Talq Device Attribute
          GET
      • Services
        • Create a Talq Service
      • Group
        • List Talq Groups
        • Get a Talq Group
    • Google Pub
      • Sub
        • List Pubsub Failed Messages
        • Get a Pubsub Failed Message
        • Delete a Pubsub Failed Message
        • Create a Pubsub Guia Device Multiple Devices Partial Update
        • Create a Pubsub Guia Device Partial Device Update
        • Create a Pubsub Guia Device Attribute Value Update
        • Create a Pubsub Guia Device Function Update
        • Create a Pubsub Guia Device Set External Id
        • Create a Pubsub Vendor Dispatcher Dispatch
    • Clients
      • Create a Client
      • Modify a Client Synchronize
    • Vendors
      • Create a Vendor
      • List Vendors
      • Create a Vendor Client Service Cod
      • Get a Vendor Client Service Cod
      • Delete a Vendor Client Service Cod
    • Health Check
      • List Health
  • Docs TALQ
    • Visão Geral do Projeto
    • Processo de Inicialização - Bootstrap Process
    • API TALQ
    • API GUIA
    • Tratamento de Erros
    • Configurações da instância
    • Sobreposição de comandos
  1. Device

Modify a Talq Device

PATCH
/talq/devices
Partially updates a list of devices. This operation can just update and add new functions/attribute values to the device, but it does not reduce its scope

Request

Query Params

Body Params application/json

Example
[
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    },
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    }
]

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request PATCH 'https://iot.exati.com.br/talq/devices?clientAddress={{gateway-uuid}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    },
    {
        "address": "{{gateway-uuid}}",
        "name": "TCTGateway",
        "class": "cls:Gateway",
        "functions": [
            {
                "type": "BasicFunction",
                "id": "fBasicFunction",
                "assetId": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439636Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "serial": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439779Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "hwType": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.439895Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "swVersion": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.438286Z",
                    "value": "SetByCertificationToolForTestPurpose"
                },
                "timeZone": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440045Z",
                    "value": "Europe/Madrid"
                }
            },
            {
                "type": "CommunicationFunction",
                "id": "fCommunicationFunction",
                "physicalAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:27.440239Z",
                    "value": "b0:76:8d:28:39:c0"
                },
                "parentAddress": {
                    "type": "AttributeString",
                    "timestamp": "2024-10-03T11:54:31.805247Z",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904/fCommunicationFunction"
                }
            },
            {
                "type": "GatewayFunction",
                "cmsUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440576Z",
                    "value": "https://iothub-app-homol.whiteisland-d9d6c2f4.brazilsouth.azurecontainerapps.io/talq/"
                },
                "cmsAddress": {
                    "type": "AttributeString",
                    "value": "3437d976-dfd4-417a-b537-3e15d614eb38"
                },
                "gatewayUri": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440611Z",
                    "value": "https://api.exati.talq-cert-tool.org:2543/talq.cms"
                },
                "gatewayAddress": {
                    "type": "AttributeString",
                    "value": "2187a2ef-1e15-4586-bc31-de2514032904"
                },
                "retryPeriod": {
                    "type": "AttributeFloat",
                    "timestamp": "2024-10-03T11:54:27.440597Z",
                    "value": 10.0
                },
                "crlUrn": {
                    "type": "AttributeUri",
                    "timestamp": "2024-10-03T11:54:27.440602Z",
                    "value": "http://crl.url.example.com"
                },
                "vendor": {
                    "type": "AttributeString",
                    "value": "TALQ Consortium"
                },
                "id": "fGatewayFunction"
            },
            {
                "type": "ElectricalMeterFunction",
                "id": "fElectricalMeterFunction"
            }
        ]
    }
]'

Responses

🟢200OK
application/json
The list of device is successfully updated
Body

Example
[
    {
        "address": "string",
        "name": "string",
        "class": "string",
        "functions": [
            {
                "id": "string",
                "type": "BasicFunction"
            }
        ]
    }
]
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠409409
🟠422Parameter Error
Modified at 2025-07-30 16:35:39
Previous
List Talq Devices
Next
Update Talq Devices