Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 25 Next »

Creates a device registry.

Note: This is an admin API.

The URL, systemKey, and token this endpoint requires are obtained differently than others. To get those, do the following:

  1. Click the Select project drop-down at the top of the IoT Core UI.

  2. Click the Edit icon (pencil) next to the desired project.

  3. Go to the SERVICE ACCOUNTS tab.

  4. If a service account already exists, select it and choose DOWNLOAD CREDENTIALS. If a service account does not exist, create it and select DOWNLOAD CREDENTIALS.

  5. A JSON file will be downloaded to your local machine. Open the file with an editor. Use the systemKey, token, and URL from the file as needed below.

HTTP request

POST {url}/api/v/4/webhook/execute/{systemKey}/cloudiot

Query parameters

Parameters

parent

string

The project and cloud region path. For example, projects/example-project/locations/us-central1.

Header parameters

Parameters

ClearBlade-UserToken

See the note at the start of this document on where to find the token.

Request body

The request body contains a DeviceRegistry instance.

Response status codes

Code

Meaning

200

Success

Response body

If successful, the response body contains a newly created DeviceRegistry instance.

Example curl:

curl 'https://iot.clearblade.com/api/v/4/webhook/execute/aae9b9b30c8aa4e49081c7eeb9bb07/cloudiot?parent=projects/iot-core-test-363819/locations/us-central1' -H 'ClearBlade-UserToken: {token}' -d '{ "id": "two", "eventNotificationConfigs": [], stateNotificationConfig": {}, "mqttConfig": {}, "httpConfig": {}, "logLevel": "NONE", "credentials": [] }'


Using the instructions at the start of this document, replace the following: https://iot.clearblade.com with your URL. aae9b9b30c8aa4e49081c7eeb9bb07 with your systemKey. {token} with your token.

This example’s body contains a registry object with name and id “two.” Replace the registry object with your own.

  • No labels