list: project.locations.registies.devices.configVersions

Owned by Aaron Allsbrook
Last updated: Feb 22, 2024 by Jeff Slavin (Unlicensed)
1 min read

Lists the device configuration’s last few versions in descending order (i.e., newest first).

Note: This is a regional API.

You can find the URL, SystemKey, and token required in the call by clicking API Keys (key icon) at the top-right of the Registry Details page. Use the Registry Keys section.

HTTP request

GET {URL}/api/v/4/webhook/execute/{SystemKey}/cloudiot_devices_configVersions

Query parameters

Parameters

Parameters

name

string

The device’s name. For example, projects/p0/locations/us-central1/registries/registry0/devices/device0

or

projects/p0/locations/us-central1/registries/registry0/devices/{numId}.

The device’s name can be set to the deviceId or numId (i.e., without the project, location, and registry info. prepended).

numVersions

number

The number of versions to list. Versions are listed in decreasing order of the version number. The maximum number of versions retained is 10. If this value is zero, it will return all the versions available.

Header parameters

Parameters

Parameters

ClearBlade-UserToken

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

Request body

The request body must be empty.

Response status codes

Code

Meaning

Code

Meaning

200

Success

Response body

If successful, the response body contains a ListDeviceConfigVersionsResponse instance.