Google Cloud IoT Core V1 Client - Class DeviceRegistry (1.5.12)

Reference documentation and code samples for the Google Cloud IoT Core V1 Client class DeviceRegistry.

A container for a group of devices.

Generated from protobuf message google.cloud.iot.v1.DeviceRegistry

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ id string

The identifier of this device registry. For example, myRegistry.

↳ name string

The resource path name. For example, projects/example-project/locations/us-central1/registries/my-registry.

↳ event_notification_configs array<Google\Cloud\Iot\V1\EventNotificationConfig>

The configuration for notification of telemetry events received from the device. All telemetry events that were successfully published by the device and acknowledged by Cloud IoT Core are guaranteed to be delivered to Cloud Pub/Sub. If multiple configurations match a message, only the first matching configuration is used. If you try to publish a device telemetry event using MQTT without specifying a Cloud Pub/Sub topic for the device's registry, the connection closes automatically. If you try to do so using an HTTP connection, an error is returned. Up to 10 configurations may be provided.

↳ state_notification_config Google\Cloud\Iot\V1\StateNotificationConfig

The configuration for notification of new states received from the device. State updates are guaranteed to be stored in the state history, but notifications to Cloud Pub/Sub are not guaranteed. For example, if permissions are misconfigured or the specified topic doesn't exist, no notification will be published but the state will still be stored in Cloud IoT Core.

↳ mqtt_config Google\Cloud\Iot\V1\MqttConfig

The MQTT configuration for this device registry.

↳ http_config Google\Cloud\Iot\V1\HttpConfig

The DeviceService (HTTP) configuration for this device registry.

↳ log_level int

Beta Feature The default logging verbosity for activity from devices in this registry. The verbosity level can be overridden by Device.log_level.

↳ credentials array<Google\Cloud\Iot\V1\RegistryCredential>

The credentials used to verify the device credentials. No more than 10 credentials can be bound to a single registry at a time. The verification process occurs at the time of device creation or update. If this field is empty, no verification is performed. Otherwise, the credentials of a newly created device or added credentials of an updated device should be signed with one of these registry credentials. Note, however, that existing devices will never be affected by modifications to this list of credentials: after a device has been successfully created in a registry, it should be able to connect even if its registry credentials are revoked, deleted, or modified.

getId

The identifier of this device registry. For example, myRegistry.

Returns
TypeDescription
string

setId

The identifier of this device registry. For example, myRegistry.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getName

The resource path name. For example, projects/example-project/locations/us-central1/registries/my-registry.

Returns
TypeDescription
string

setName

The resource path name. For example, projects/example-project/locations/us-central1/registries/my-registry.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEventNotificationConfigs

The configuration for notification of telemetry events received from the device. All telemetry events that were successfully published by the device and acknowledged by Cloud IoT Core are guaranteed to be delivered to Cloud Pub/Sub. If multiple configurations match a message, only the first matching configuration is used. If you try to publish a device telemetry event using MQTT without specifying a Cloud Pub/Sub topic for the device's registry, the connection closes automatically. If you try to do so using an HTTP connection, an error is returned. Up to 10 configurations may be provided.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setEventNotificationConfigs

The configuration for notification of telemetry events received from the device. All telemetry events that were successfully published by the device and acknowledged by Cloud IoT Core are guaranteed to be delivered to Cloud Pub/Sub. If multiple configurations match a message, only the first matching configuration is used. If you try to publish a device telemetry event using MQTT without specifying a Cloud Pub/Sub topic for the device's registry, the connection closes automatically. If you try to do so using an HTTP connection, an error is returned. Up to 10 configurations may be provided.

Parameter
NameDescription
var array<Google\Cloud\Iot\V1\EventNotificationConfig>
Returns
TypeDescription
$this

getStateNotificationConfig

The configuration for notification of new states received from the device.

State updates are guaranteed to be stored in the state history, but notifications to Cloud Pub/Sub are not guaranteed. For example, if permissions are misconfigured or the specified topic doesn't exist, no notification will be published but the state will still be stored in Cloud IoT Core.

Returns
TypeDescription
Google\Cloud\Iot\V1\StateNotificationConfig|null

hasStateNotificationConfig

clearStateNotificationConfig

setStateNotificationConfig

The configuration for notification of new states received from the device.

State updates are guaranteed to be stored in the state history, but notifications to Cloud Pub/Sub are not guaranteed. For example, if permissions are misconfigured or the specified topic doesn't exist, no notification will be published but the state will still be stored in Cloud IoT Core.

Parameter
NameDescription
var Google\Cloud\Iot\V1\StateNotificationConfig
Returns
TypeDescription
$this

getMqttConfig

The MQTT configuration for this device registry.

Returns
TypeDescription
Google\Cloud\Iot\V1\MqttConfig|null

hasMqttConfig

clearMqttConfig

setMqttConfig

The MQTT configuration for this device registry.

Parameter
NameDescription
var Google\Cloud\Iot\V1\MqttConfig
Returns
TypeDescription
$this

getHttpConfig

The DeviceService (HTTP) configuration for this device registry.

Returns
TypeDescription
Google\Cloud\Iot\V1\HttpConfig|null

hasHttpConfig

clearHttpConfig

setHttpConfig

The DeviceService (HTTP) configuration for this device registry.

Parameter
NameDescription
var Google\Cloud\Iot\V1\HttpConfig
Returns
TypeDescription
$this

getLogLevel

Beta Feature The default logging verbosity for activity from devices in this registry.

The verbosity level can be overridden by Device.log_level.

Returns
TypeDescription
int

setLogLevel

Beta Feature The default logging verbosity for activity from devices in this registry.

The verbosity level can be overridden by Device.log_level.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getCredentials

The credentials used to verify the device credentials. No more than 10 credentials can be bound to a single registry at a time. The verification process occurs at the time of device creation or update. If this field is empty, no verification is performed. Otherwise, the credentials of a newly created device or added credentials of an updated device should be signed with one of these registry credentials.

Note, however, that existing devices will never be affected by modifications to this list of credentials: after a device has been successfully created in a registry, it should be able to connect even if its registry credentials are revoked, deleted, or modified.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setCredentials

The credentials used to verify the device credentials. No more than 10 credentials can be bound to a single registry at a time. The verification process occurs at the time of device creation or update. If this field is empty, no verification is performed. Otherwise, the credentials of a newly created device or added credentials of an updated device should be signed with one of these registry credentials.

Note, however, that existing devices will never be affected by modifications to this list of credentials: after a device has been successfully created in a registry, it should be able to connect even if its registry credentials are revoked, deleted, or modified.

Parameter
NameDescription
var array<Google\Cloud\Iot\V1\RegistryCredential>
Returns
TypeDescription
$this