Output profile models
Request and response types for the Output profile API.
models
Classes:
-
AzureOutputFormat– -
CommonOuputProfileParams– -
OutputProfileAWSParams– -
OutputProfileAzureMQTTParams– -
OutputProfileCreate– -
OutputProfileCreateResponse– -
OutputProfileDevicesResponse– -
OutputProfileDevicesUpdate– -
OutputProfileDevicesUpdateResponse– -
OutputProfileEnvironment– -
OutputProfileError– -
OutputProfileInstance– -
OutputProfileMQTTParams– -
OutputProfilePatch– -
OutputProfileResponse– -
OutputProfileRestParams– -
OutputProfileUpdate–
AzureOutputFormat
CommonOuputProfileParams
Bases: BaseModelWithConfig
Attributes:
-
active(bool | None) –Defaults to true if not set
-
destination_id(str | None) –The unique destination identifier assigned by the MQ APIs after creation
-
environment(OutputProfileEnvironment | None) –The deployment environment of the destination. Indicates the criticality of the delivered messages
destination_id
class-attribute
instance-attribute
destination_id: str | None = None
The unique destination identifier assigned by the MQ APIs after creation
environment
class-attribute
instance-attribute
environment: OutputProfileEnvironment | None = None
The deployment environment of the destination. Indicates the criticality of the delivered messages and ensures that the MachineQ Engineering and Operations teams provide the appropriate level of support.
OutputProfileAWSParams
Bases: CommonOuputProfileParams
Attributes:
-
endpoint(str) –The IoT Core endpoint. Must be a valid URL in the form '{account-specific-prefix}.iot.{aws-region}.amazonaws.com'
-
private_key(str) –The x509 private key. Note: You'll need to replace newlines with `
-
x509_certificate(str) –The x509 certificate pem file. Note: You'll need to replace newlines with `
endpoint
instance-attribute
endpoint: str
The IoT Core endpoint. Must be a valid URL in the form '{account-specific-prefix}.iot.{aws-region}.amazonaws.com' and must not contain a port or scheme. (E.g., a3fhmgkt5lz2ij.iot.us-east-1.amazonaws.com)
private_key
instance-attribute
private_key: str
The x509 private key. Note: You'll need to replace newlines with .
x509_certificate
class-attribute
instance-attribute
x509_certificate: str = Field(
serialization_alias="x509Certificate",
validation_alias="x509Certificate",
)
The x509 certificate pem file. Note: You'll need to replace newlines with .
OutputProfileAzureMQTTParams
Bases: CommonOuputProfileParams
Attributes:
-
api_version(str) –The API Version which the latest is currently 2021-10-01. Previously 2021-04-12 and 2016-11-14.
-
host(str) –The IoT Hub hostname. Must be a valid URL in the form '{hubname}.azure-devices.net' and must not contain a scheme.
-
output_format(AzureOutputFormat) –Azure is the IoT Hub common Device to Cloud (D2C) format.
-
shared_access_key(str) – -
shared_access_policy_name(str) –The shared access policy name with Device access enabled.
api_version
instance-attribute
api_version: str
The API Version which the latest is currently 2021-10-01. Previously 2021-04-12 and 2016-11-14.
host
instance-attribute
host: str
The IoT Hub hostname. Must be a valid URL in the form '{hubname}.azure-devices.net' and must not contain a scheme. Specifying a port has been deprecated. The hostname for new destinations should not include a port.
output_format
class-attribute
instance-attribute
output_format: AzureOutputFormat = RAW
Azure is the IoT Hub common Device to Cloud (D2C) format.
shared_access_policy_name
instance-attribute
shared_access_policy_name: str
The shared access policy name with Device access enabled.
OutputProfileCreate
Bases: BaseModelWithConfig
Attributes:
-
aws_params(list[OutputProfileAWSParams] | None) – -
azure_params(list[OutputProfileAzureMQTTParams] | None) – -
mqtt_params(list[OutputProfileMQTTParams] | None) – -
name(str) – -
rest_params(list[OutputProfileRestParams] | None) –
aws_params
class-attribute
instance-attribute
aws_params: list[OutputProfileAWSParams] | None = Field(
default=None, alias="AWSParams"
)
azure_params
class-attribute
instance-attribute
azure_params: list[OutputProfileAzureMQTTParams] | None = (
None
)
mqtt_params
class-attribute
instance-attribute
mqtt_params: list[OutputProfileMQTTParams] | None = None
rest_params
class-attribute
instance-attribute
rest_params: list[OutputProfileRestParams] | None = None
OutputProfileCreateResponse
OutputProfileDevicesResponse
OutputProfileDevicesUpdate
OutputProfileDevicesUpdateResponse
OutputProfileEnvironment
Attributes:
-
DEVELOPMENT– -
PRODUCTION– -
STAGING–
DEVELOPMENT
class-attribute
instance-attribute
DEVELOPMENT = 'development'
PRODUCTION
class-attribute
instance-attribute
PRODUCTION = 'production'
STAGING
class-attribute
instance-attribute
STAGING = 'staging'
OutputProfileError
OutputProfileInstance
Bases: BaseModelWithConfig
Attributes:
-
aws_params(list[OutputProfileAWSParams]) – -
azure_params(list[OutputProfileAzureMQTTParams]) – -
id(str) – -
mqtt_params(list[OutputProfileMQTTParams]) – -
name(str) – -
rest_params(list[OutputProfileRestParams]) –
aws_params
class-attribute
instance-attribute
aws_params: list[OutputProfileAWSParams] = Field(
alias="AWSParams"
)
OutputProfileMQTTParams
Bases: CommonOuputProfileParams
Attributes:
-
SSL(bool | None) – -
client_id(str | None) –The custom client id to be used (${DEVEUI} and ${FPORT} used as replacement variables).
-
host(str) –The MQTT hostname including the port (E.g.,
machineq-dev.mqtt.net:8883). Must be a valid hostname -
password(str) – -
topic(str) –MQTT Topic (${DEVEUI} and ${FPORT} used as replacement variables)
-
username(str) –
client_id
class-attribute
instance-attribute
client_id: str | None = None
The custom client id to be used (${DEVEUI} and ${FPORT} used as replacement variables).
host
instance-attribute
host: str
The MQTT hostname including the port (E.g., machineq-dev.mqtt.net:8883). Must be a valid hostname
for a URL and not include a scheme (like mqtt:// or tcps://). Note: some ports are reserved.
Please refer to this Support Article article for more information.
topic
instance-attribute
topic: str
MQTT Topic (${DEVEUI} and ${FPORT} used as replacement variables)
OutputProfilePatch
Bases: BaseModelWithConfig
Attributes:
-
aws_params(list[OutputProfileAWSParams] | None) – -
azure_params(list[OutputProfileAzureMQTTParams] | None) – -
mqtt_params(list[OutputProfileMQTTParams] | None) – -
name(str | None) – -
rest_params(list[OutputProfileRestParams] | None) –
aws_params
class-attribute
instance-attribute
aws_params: list[OutputProfileAWSParams] | None = Field(
default=None, alias="AWSParams"
)
azure_params
class-attribute
instance-attribute
azure_params: list[OutputProfileAzureMQTTParams] | None = (
None
)
mqtt_params
class-attribute
instance-attribute
mqtt_params: list[OutputProfileMQTTParams] | None = None
rest_params
class-attribute
instance-attribute
rest_params: list[OutputProfileRestParams] | None = None
OutputProfileResponse
OutputProfileRestParams
Bases: CommonOuputProfileParams
Attributes:
-
output_format(str) – -
token_type(str | None) – -
token_value(str | None) – -
url(str) –The full URL to a REST service. Must be a valid HTTP URL that contains a scheme and an optional port (E.g., https://machineq.dev.net:6565)
url
class-attribute
instance-attribute
url: str = Field(
serialization_alias="URL", validation_alias="URL"
)
The full URL to a REST service. Must be a valid HTTP URL that contains a scheme and an optional port (E.g., https://machineq.dev.net:6565) Note: some port numbers are reserved. Please refer to this Support Article for more information.
OutputProfileUpdate
Bases: BaseModelWithConfig
Attributes:
-
aws_params(list[OutputProfileAWSParams] | None) – -
azure_params(list[OutputProfileAzureMQTTParams] | None) – -
mqtt_params(list[OutputProfileMQTTParams] | None) – -
name(str) – -
rest_params(list[OutputProfileRestParams] | None) –
aws_params
class-attribute
instance-attribute
aws_params: list[OutputProfileAWSParams] | None = Field(
default=None, alias="AWSParams"
)