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.getConfig

Gets the configuration of a device.

HTTP request

GET https://cloudiotdevice.googleapis.com/v1beta1/{name=projects/*/locations/*/registries/*/devices/*}/config

The URL uses gRPC Transcoding syntax.

Each request must include a JWT in the header.

Path parameters

Parameters
name

string

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

Query parameters

Parameters
localVersion

string (int64 format)

If zero, returns the current device configuration from Cloud IoT Core. If nonzero, specifies the local version of the configuration on the device. The server returns config data only if a higher (newer) version is available from Cloud IoT Core. If this value is higher than the latest version available in Cloud IoT Core, returns an OUT_OF_RANGE error.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The device configuration obtained from Cloud IoT Core.

JSON representation 
{
  "version": string,
  "binaryData": string
}
Fields
version

string (int64 format)

The version of the configuration in Cloud IoT Core.

binaryData

string (bytes format)

Data in binary format.

A base64-encoded string.