Package types (2.1.0)

API documentation for iot_v1.types package.

Classes

BindDeviceToGatewayRequest

Request for BindDeviceToGateway. .. attribute:: parent

Required. The name of the registry. For example, projects/example-project/locations/us-central1/registries/my-registry.

:type: str

BindDeviceToGatewayResponse

Response for BindDeviceToGateway.

CreateDeviceRegistryRequest

Request for CreateDeviceRegistry. .. attribute:: parent

Required. The project and cloud region where this device registry must be created. For example, projects/example-project/locations/us-central1.

:type: str

CreateDeviceRequest

Request for CreateDevice. .. attribute:: parent

Required. The name of the device registry where this device should be created. For example, projects/example-project/locations/us-central1/registries/my-registry.

:type: str

DeleteDeviceRegistryRequest

Request for DeleteDeviceRegistry. .. attribute:: name

Required. The name of the device registry. For example, projects/example-project/locations/us-central1/registries/my-registry.

:type: str

DeleteDeviceRequest

Request for DeleteDevice. .. attribute:: name

Required. 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/{num_id}.

:type: str

Device

The device resource. .. attribute:: id

The user-defined device identifier. The device ID must be unique within a device registry.

:type: str

DeviceConfig

The device configuration. Eventually delivered to devices. .. attribute:: version

[Output only] The version of this update. The version number is assigned by the server, and is always greater than 0 after device creation. The version must be 0 on the CreateDevice request if a config is specified; the response of CreateDevice will always have a value of 1.

:type: int

DeviceCredential

A server-stored device credential used for authentication. .. attribute:: public_key

A public key used to verify the signature of JSON Web Tokens (JWTs). When adding a new device credential, either via device creation or via modifications, this public key credential may be required to be signed by one of the registry level certificates. More specifically, if the registry contains at least one certificate, any new device credential must be signed by one of the registry certificates. As a result, when the registry contains certificates, only X.509 certificates are accepted as device credentials. However, if the registry does not contain a certificate, self-signed certificates and public keys will be accepted. New device credentials must be different from every registry-level certificate.

:type: google.cloud.iot_v1.types.PublicKeyCredential

DeviceRegistry

A container for a group of devices. .. attribute:: id

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

:type: str

DeviceState

The device state, as reported by the device. .. attribute:: update_time

[Output only] The time at which this state version was updated in Cloud IoT Core.

:type: google.protobuf.timestamp_pb2.Timestamp

EventNotificationConfig

The configuration for forwarding telemetry events. .. attribute:: subfolder_matches

If the subfolder name matches this string exactly, this configuration will be used. The string must not include the leading '/' character. If empty, all strings are matched. This field is used only for telemetry events; subfolders are not supported for state changes.

:type: str

GatewayAuthMethod

The gateway authorization/authentication method. This setting determines how Cloud IoT Core authorizes/authenticate devices to access the gateway.

GatewayConfig

Gateway-related configuration and state. .. attribute:: gateway_type

Indicates whether the device is a gateway.

:type: google.cloud.iot_v1.types.GatewayType

GatewayListOptions

Options for limiting the list based on gateway type and associations.

GatewayType

Gateway type.

GetDeviceRegistryRequest

Request for GetDeviceRegistry. .. attribute:: name

Required. The name of the device registry. For example, projects/example-project/locations/us-central1/registries/my-registry.

:type: str

GetDeviceRequest

Request for GetDevice. .. attribute:: name

Required. 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/{num_id}.

:type: str

HttpConfig

The configuration of the HTTP bridge for a device registry. .. attribute:: http_enabled_state

If enabled, allows devices to use DeviceService via the HTTP protocol. Otherwise, any requests to DeviceService will fail for this registry.

:type: google.cloud.iot_v1.types.HttpState

HttpState

Indicates whether DeviceService (HTTP) is enabled or disabled for the registry. See the field description for details.

ListDeviceConfigVersionsRequest

Request for ListDeviceConfigVersions. .. attribute:: name

Required. 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/{num_id}.

:type: str

ListDeviceConfigVersionsResponse

Response for ListDeviceConfigVersions. .. attribute:: device_configs

The device configuration for the last few versions. Versions are listed in decreasing order, starting from the most recent one.

:type: Sequence[google.cloud.iot_v1.types.DeviceConfig]

ListDeviceRegistriesRequest

Request for ListDeviceRegistries. .. attribute:: parent

Required. The project and cloud region path. For example, projects/example-project/locations/us-central1.

:type: str

ListDeviceRegistriesResponse

Response for ListDeviceRegistries. .. attribute:: device_registries

The registries that matched the query.

:type: Sequence[google.cloud.iot_v1.types.DeviceRegistry]

ListDeviceStatesRequest

Request for ListDeviceStates. .. attribute:: name

Required. 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/{num_id}.

:type: str

ListDeviceStatesResponse

Response for ListDeviceStates. .. attribute:: device_states

The last few device states. States are listed in descending order of server update time, starting from the most recent one.

:type: Sequence[google.cloud.iot_v1.types.DeviceState]

ListDevicesRequest

Request for ListDevices. .. attribute:: parent

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

:type: str

ListDevicesResponse

Response for ListDevices. .. attribute:: devices

The devices that match the request.

:type: Sequence[google.cloud.iot_v1.types.Device]

LogLevel

Beta Feature

The logging verbosity for device activity. Specifies which events should be written to logs. For example, if the LogLevel is ERROR, only events that terminate in errors will be logged. LogLevel is inclusive; enabling INFO logging will also enable ERROR logging.

ModifyCloudToDeviceConfigRequest

Request for ModifyCloudToDeviceConfig. .. attribute:: name

Required. 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/{num_id}.

:type: str

MqttConfig

The configuration of MQTT for a device registry. .. attribute:: mqtt_enabled_state

If enabled, allows connections using the MQTT protocol. Otherwise, MQTT connections to this registry will fail.

:type: google.cloud.iot_v1.types.MqttState

MqttState

Indicates whether an MQTT connection is enabled or disabled. See the field description for details.

PublicKeyCertificate

A public key certificate format and data. .. attribute:: format

The certificate format.

:type: google.cloud.iot_v1.types.PublicKeyCertificateFormat

PublicKeyCertificateFormat

The supported formats for the public key.

PublicKeyCredential

A public key format and data. .. attribute:: format

The format of the key.

:type: google.cloud.iot_v1.types.PublicKeyFormat

PublicKeyFormat

The supported formats for the public key.

RegistryCredential

A server-stored registry credential used to validate device credentials.

SendCommandToDeviceRequest

Request for SendCommandToDevice. .. attribute:: name

Required. 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/{num_id}.

:type: str

SendCommandToDeviceResponse

Response for SendCommandToDevice.

StateNotificationConfig

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

UnbindDeviceFromGatewayRequest

Request for UnbindDeviceFromGateway. .. attribute:: parent

Required. The name of the registry. For example, projects/example-project/locations/us-central1/registries/my-registry.

:type: str

UnbindDeviceFromGatewayResponse

Response for UnbindDeviceFromGateway.

UpdateDeviceRegistryRequest

Request for UpdateDeviceRegistry. .. attribute:: device_registry

Required. The new values for the device registry. The id field must be empty, and the name field must indicate the path of the resource. For example, projects/example-project/locations/us-central1/registries/my-registry.

:type: google.cloud.iot_v1.types.DeviceRegistry

UpdateDeviceRequest

Request for UpdateDevice. .. attribute:: device

Required. The new values for the device. The id and num_id fields must be empty, and the field name must specify the name path. For example, projects/p0/locations/us-central1/registries/registry0/devices/device0\ or projects/p0/locations/us-central1/registries/registry0/devices/{num_id}.

:type: google.cloud.iot_v1.types.Device

X509CertificateDetails

Details of an X.509 certificate. For informational purposes only.