Gets the configuration of a device.
HTTP request
GET https://cloudiotdevice.googleapis.com/v1/{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 |
The name of the device. For example, |
Query parameters
Parameters | |
---|---|
localVersion |
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 |
gatewayInfo |
Set only if the message is sent through a gateway or a gateway is making the request on behalf of a device. |
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 |
The version of the configuration in Cloud IoT Core. |
binaryData |
Data in binary format. A base64-encoded string. |