Skip to content

Output profile models

Request and response types for the Output profile API.

models

Classes:

AzureOutputFormat

Bases: str, Enum

Attributes:

AZURE class-attribute instance-attribute

AZURE = 'azure'

RAW class-attribute instance-attribute

RAW = 'raw'

CommonOuputProfileParams

Bases: BaseModelWithConfig

Attributes:

active class-attribute instance-attribute

active: bool | None = None

Defaults to true if not set

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 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_key instance-attribute

shared_access_key: str

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

name instance-attribute

name: str

rest_params class-attribute instance-attribute

rest_params: list[OutputProfileRestParams] | None = None

OutputProfileCreateResponse

Bases: BaseModelWithConfig

Attributes:

id instance-attribute

id: str

OutputProfileDevicesResponse

Bases: BaseModelWithConfig

Attributes:

deveui instance-attribute

deveui: str

error instance-attribute

error: str

response instance-attribute

response: bool

OutputProfileDevicesUpdate

Bases: BaseModelWithConfig

Attributes:

devices instance-attribute

devices: list[str] | None

OutputProfileDevicesUpdateResponse

Bases: BaseModelWithConfig

Attributes:

responses instance-attribute

OutputProfileEnvironment

Bases: str, Enum

Attributes:

DEVELOPMENT class-attribute instance-attribute

DEVELOPMENT = 'development'

PRODUCTION class-attribute instance-attribute

PRODUCTION = 'production'

STAGING class-attribute instance-attribute

STAGING = 'staging'

OutputProfileError

Bases: BaseModelWithConfig

Attributes:

response instance-attribute

response: bool

OutputProfileInstance

Bases: BaseModelWithConfig

Attributes:

aws_params class-attribute instance-attribute

aws_params: list[OutputProfileAWSParams] = Field(
    alias="AWSParams"
)

azure_params instance-attribute

id instance-attribute

id: str

mqtt_params instance-attribute

name instance-attribute

name: str

rest_params instance-attribute

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) –

SSL class-attribute instance-attribute

SSL: bool | None = None

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.

password instance-attribute

password: str

topic instance-attribute

topic: str

MQTT Topic (${DEVEUI} and ${FPORT} used as replacement variables)

username instance-attribute

username: str

OutputProfilePatch

Bases: BaseModelWithConfig

Attributes:

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

name class-attribute instance-attribute

name: str | None = None

rest_params class-attribute instance-attribute

rest_params: list[OutputProfileRestParams] | None = None

OutputProfileResponse

Bases: BaseModelWithConfig

Attributes:

output_profiles instance-attribute

output_profiles: list[OutputProfileInstance]

OutputProfileRestParams

Bases: CommonOuputProfileParams

Attributes:

output_format class-attribute instance-attribute

output_format: str = 'extended'

token_type class-attribute instance-attribute

token_type: str | None = None

token_value class-attribute instance-attribute

token_value: str | None = None

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 class-attribute instance-attribute

aws_params: list[OutputProfileAWSParams] | None = Field(
    default=None, alias="AWSParams"
)

azure_params instance-attribute

azure_params: list[OutputProfileAzureMQTTParams] | None

mqtt_params instance-attribute

mqtt_params: list[OutputProfileMQTTParams] | None

name instance-attribute

name: str

rest_params instance-attribute

rest_params: list[OutputProfileRestParams] | None