Method: projects.locations.registries.devices.configVersions.list

Lists the last few versions of the device configuration in descending order (i.e.: newest first).

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The name of the device. For example, projects/p0/locations/us-central1/registries/registry0/devices/device0 or projects/p0/locations/us-central1/registries/registry0/devices/{numId}.

Authorization requires the following Google IAM permission on the specified resource name:

  • cloudiot.devices.get

Query parameters



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.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListDeviceConfigVersionsResponse.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud IoT Core Documentation