Google Cloud IoT Core is being retired on August 16, 2023. Contact your Google Cloud account team for more information.

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

Stay organized with collections Save and categorize content based on your preferences.

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.