swagger: '2.0' info: version: 2020-08-01-preview title: Microsoft Azure AccessControlClient AccessConnector MqttBridgeConnector API schemes: - https tags: - name: MqttBridgeConnector paths: ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsMQ/mq/{mqName}/mqttBridgeConnector : get: operationId: microsoftAzureMqttbridgeconnectorListbymqresource tags: - MqttBridgeConnector description: List MqttBridgeConnectorResource resources by MqResource parameters: - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter - name: mqName in: path description: Name of MQ resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ responses: '200': description: Azure operation completed successfully. schema: $ref: '#/definitions/MqttBridgeConnectorResourceListResult' default: description: An unexpected error response. schema: $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse x-ms-examples: MqttBridgeConnector_ListByMqResource: $ref: ./examples/MqttBridgeConnector_ListByMqResource_MaximumSet_Gen.json x-ms-pageable: nextLinkName: nextLink summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsmq Mq Mqname Mqttbridgeconnector ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsMQ/mq/{mqName}/mqttBridgeConnector/{mqttBridgeConnectorName} : get: operationId: microsoftAzureMqttbridgeconnectorGet tags: - MqttBridgeConnector description: Get a MqttBridgeConnectorResource parameters: - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter - name: mqName in: path description: Name of MQ resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ - name: mqttBridgeConnectorName in: path description: Name of MQ mqttBridgeConnector resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ responses: '200': description: Azure operation completed successfully. schema: $ref: '#/definitions/MqttBridgeConnectorResource' default: description: An unexpected error response. schema: $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse x-ms-examples: MqttBridgeConnector_Get: $ref: ./examples/MqttBridgeConnector_Get_MaximumSet_Gen.json summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsmq Mq Mqname Mqttbridgeconnector Mqttbridgeconnectorname put: operationId: microsoftAzureMqttbridgeconnectorCreateorupdate tags: - MqttBridgeConnector description: Create a MqttBridgeConnectorResource parameters: - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter - name: mqName in: path description: Name of MQ resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ - name: mqttBridgeConnectorName in: path description: Name of MQ mqttBridgeConnector resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ - name: resource in: body description: Resource create parameters. required: true schema: $ref: '#/definitions/MqttBridgeConnectorResource' responses: '200': description: Resource 'MqttBridgeConnectorResource' update operation succeeded schema: $ref: '#/definitions/MqttBridgeConnectorResource' '201': description: Resource 'MqttBridgeConnectorResource' create operation succeeded schema: $ref: '#/definitions/MqttBridgeConnectorResource' headers: Retry-After: type: integer format: int32 description: The Retry-After header can indicate how long the client should wait before polling the operation status. default: description: An unexpected error response. schema: $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse x-ms-examples: MqttBridgeConnector_CreateOrUpdate: $ref: ./examples/MqttBridgeConnector_CreateOrUpdate_MaximumSet_Gen.json x-ms-long-running-operation-options: final-state-via: azure-async-operation x-ms-long-running-operation: true summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsmq Mq Mqname Mqttbridgeconnector Mqttbridgeconnectorname patch: operationId: microsoftAzureMqttbridgeconnectorUpdate tags: - MqttBridgeConnector description: Update a MqttBridgeConnectorResource parameters: - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter - name: mqName in: path description: Name of MQ resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ - name: mqttBridgeConnectorName in: path description: Name of MQ mqttBridgeConnector resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ - name: properties in: body description: The resource properties to be updated. required: true schema: $ref: '#/definitions/MqttBridgeConnectorResourceUpdate' responses: '200': description: Azure operation completed successfully. schema: $ref: '#/definitions/MqttBridgeConnectorResource' default: description: An unexpected error response. schema: $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse x-ms-examples: MqttBridgeConnector_Update: $ref: ./examples/MqttBridgeConnector_Update_MaximumSet_Gen.json summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsmq Mq Mqname Mqttbridgeconnector Mqttbridgeconnectorname delete: operationId: microsoftAzureMqttbridgeconnectorDelete tags: - MqttBridgeConnector description: Delete a MqttBridgeConnectorResource parameters: - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter - name: mqName in: path description: Name of MQ resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ - name: mqttBridgeConnectorName in: path description: Name of MQ mqttBridgeConnector resource required: true type: string pattern: ^[a-zA-Z0-9-]{3,24}$ responses: '202': description: Resource deletion accepted. headers: Location: type: string description: The Location header contains the URL where the status of the long running operation can be checked. Retry-After: type: integer format: int32 description: The Retry-After header can indicate how long the client should wait before polling the operation status. '204': description: Resource does not exist. default: description: An unexpected error response. schema: $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse x-ms-examples: MqttBridgeConnector_Delete: $ref: ./examples/MqttBridgeConnector_Delete_MaximumSet_Gen.json x-ms-long-running-operation-options: final-state-via: location x-ms-long-running-operation: true summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsmq Mq Mqname Mqttbridgeconnector Mqttbridgeconnectorname definitions: MqttBridgeRemoteBrokerAuthenticationMethodsUpdate: type: object description: MqttBridge RemoteBrokerConnection Authentication methods. NOTE - Enum only one is allowed to be passed. properties: x509: $ref: '#/definitions/MqttBridgeRemoteBrokerX509AuthenticationUpdate' description: X509 remote broker authentication method. systemAssignedManagedIdentity: $ref: '#/definitions/ManagedIdentityAuthenticationUpdate' description: Managed identity remote broker authentication method. MqttBridgeConnectorProperties: type: object description: MqttBridgeConnector Properties properties: bridgeInstances: type: integer format: int32 description: The number of instances to deploy for a bridge rollout. minimum: 0 maximum: 65535 clientIdPrefix: type: string description: The client id prefix of the dynamically generated client ids. image: $ref: '#/definitions/ContainerImage' description: The details of MqttBridge Docker Image. localBrokerConnection: $ref: '#/definitions/LocalBrokerConnectionSpec' description: The details for connecting with Local Broker. logLevel: type: string description: The log level of the Bridge Connector instances. nodeTolerations: $ref: '#/definitions/NodeTolerations' description: The Node Tolerations for the Bridge Connector pods. protocol: $ref: '#/definitions/MqttProtocol' description: The protocol to use for connecting with Brokers. provisioningState: $ref: '#/definitions/ProvisioningState' description: The status of the last operation. readOnly: true remoteBrokerConnection: $ref: '#/definitions/MqttBridgeRemoteBrokerConnectionSpec' description: The details for connecting with Remote Broker. required: - image - protocol - remoteBrokerConnection MqttBridgeRemoteBrokerX509Authentication: type: object description: MqttBridge RemoteBroker X509 Authentication properties. properties: keyVault: $ref: '#/definitions/KeyVaultCertificateProperties' description: Keyvault X509 secret properties. secretName: type: string description: Secret where cert details are stored. KeyVaultCredentialsPropertiesUpdate: type: object description: KeyVault credentials properties. NOTE - Future this will be ENUM. properties: servicePrincipalLocalSecretName: type: string description: KeyVault service principal local secret name. MqttBridgeRemoteBrokerConnectionSpec: type: object description: MqttBridge RemoteBrokerConnectionSpec details properties: authentication: $ref: '#/definitions/MqttBridgeRemoteBrokerAuthenticationMethods' description: The remote broker authentication methods. NOTE - Enum only one method is allowed to be passed. endpoint: type: string description: The endpoint of remote broker to connect to. protocol: type: string description: Protocol for remote connection. default: mqtt enum: - mqtt - webSocket x-ms-enum: name: MqttBridgeRemoteBrokerProtocol modelAsString: true values: - name: mqtt value: mqtt description: MQTT protocol. - name: webSocket value: webSocket description: MQTT over WebSocket protocol. tls: $ref: '#/definitions/MqttBridgeRemoteBrokerConnectionTls' description: TLS details for Remote broker Connection. required: - authentication - endpoint - tls MqttBridgeConnectorResource: type: object description: MQ mqttBridgeConnector resource properties: properties: $ref: '#/definitions/MqttBridgeConnectorProperties' description: The resource-specific properties for this resource. x-ms-client-flatten: true x-ms-mutability: - read - create extendedLocation: $ref: '#/definitions/ExtendedLocationProperty' description: Extended Location x-ms-mutability: - read - create required: - extendedLocation allOf: - $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/TrackedResource KeyVaultSecretObjectUpdate: type: object description: KeyVault secret object properties properties: name: type: string description: KeyVault secret name. version: type: string description: KeyVault secret version. KeyVaultCertificateProperties: type: object description: KeyVault certificate properties properties: vault: $ref: '#/definitions/KeyVaultConnectionProperties' description: KeyVault properties. vaultCaChainSecret: $ref: '#/definitions/KeyVaultSecretObject' description: KeyVault CA chain secret details. vaultCert: $ref: '#/definitions/KeyVaultSecretObject' description: KeyVault Cert secret details. required: - vault - vaultCert MqttProtocol: type: string description: Mqtt Protocol types enum: - v3 - v5 x-ms-enum: name: MqttProtocol modelAsString: true values: - name: v3 value: v3 description: Mqttv3 - name: v5 value: v5 description: Mqttv5 LocalBrokerConnectionSpec: type: object description: Mqtt Local Broker ConnectionSpec details properties: authentication: $ref: '#/definitions/LocalBrokerAuthenticationMethods' description: The authentication methods for LocalBroker connection. NOTE - Enum only one method at a time is supported. endpoint: type: string description: The endpoint of local broker to connect to. default: aio-mq-dmqtt-frontend:1883 tls: $ref: '#/definitions/LocalBrokerConnectionTls' description: TLS details for Local broker Connection. ExtendedLocationProperty: type: object description: ExtendedLocation properties properties: name: type: string description: The name of the extended location. type: $ref: '#/definitions/ExtendedLocationType' description: Type of ExtendedLocation. required: - name - type KeyVaultCredentialsProperties: type: object description: KeyVault credentials properties. NOTE - Future this will be ENUM. properties: servicePrincipalLocalSecretName: type: string description: KeyVault service principal local secret name. required: - servicePrincipalLocalSecretName LocalBrokerConnectionTls: type: object description: Mqtt Local Broker Connection TLS details properties: tlsEnabled: type: boolean description: Tls Enabled on Local Broker Connection. default: false trustedCaCertificateConfigMap: type: string description: Trusted CA certificate config map name for Local Broker. MqttBridgeRemoteBrokerConnectionTlsUpdate: type: object description: MqttBridge RemoteBrokerConnection TLS details properties: tlsEnabled: type: boolean description: Tls Enabled on Remote Broker Connection. trustedCaCertificateConfigMap: type: string description: Trusted CA certificate name for Remote Broker. LocalBrokerAuthenticationMethodsUpdate: type: object description: Mqtt Local Broker Authentication details. Only one method at a time is supported. Default - kubernetes authentication properties: kubernetes: $ref: '#/definitions/LocalBrokerKubernetesAuthentication' description: Kubernetes local broker authentication method. MqttBridgeRemoteBrokerConnectionSpecUpdate: type: object description: MqttBridge RemoteBrokerConnectionSpec details properties: authentication: $ref: '#/definitions/MqttBridgeRemoteBrokerAuthenticationMethodsUpdate' description: The remote broker authentication methods. NOTE - Enum only one method is allowed to be passed. endpoint: type: string description: The endpoint of remote broker to connect to. protocol: type: string description: Protocol for remote connection. default: mqtt enum: - mqtt - webSocket x-ms-enum: name: MqttBridgeRemoteBrokerProtocol modelAsString: true values: - name: mqtt value: mqtt description: MQTT protocol. - name: webSocket value: webSocket description: MQTT over WebSocket protocol. tls: $ref: '#/definitions/MqttBridgeRemoteBrokerConnectionTlsUpdate' description: TLS details for Remote broker Connection. MqttBridgeConnectorResourceListResult: type: object description: The response of a MqttBridgeConnectorResource list operation. properties: value: type: array description: The MqttBridgeConnectorResource items on this page items: $ref: '#/definitions/MqttBridgeConnectorResource' nextLink: type: string format: uri description: The link to the next page of items required: - value MqttBridgeRemoteBrokerAuthenticationMethods: type: object description: MqttBridge RemoteBrokerConnection Authentication methods. NOTE - Enum only one is allowed to be passed. properties: x509: $ref: '#/definitions/MqttBridgeRemoteBrokerX509Authentication' description: X509 remote broker authentication method. systemAssignedManagedIdentity: $ref: '#/definitions/ManagedIdentityAuthentication' description: Managed identity remote broker authentication method. LocalBrokerConnectionSpecUpdate: type: object description: Mqtt Local Broker ConnectionSpec details properties: authentication: $ref: '#/definitions/LocalBrokerAuthenticationMethodsUpdate' description: The authentication methods for LocalBroker connection. NOTE - Enum only one method at a time is supported. endpoint: type: string description: The endpoint of local broker to connect to. default: aio-mq-dmqtt-frontend:1883 tls: $ref: '#/definitions/LocalBrokerConnectionTls' description: TLS details for Local broker Connection. KeyVaultConnectionProperties: type: object description: KeyVault properties properties: credentials: $ref: '#/definitions/KeyVaultCredentialsProperties' description: KeyVault credentials. directoryId: type: string description: KeyVault directoryId. name: type: string description: KeyVault name. required: - credentials - directoryId - name MqttBridgeRemoteBrokerConnectionTls: type: object description: MqttBridge RemoteBrokerConnection TLS details properties: tlsEnabled: type: boolean description: Tls Enabled on Remote Broker Connection. trustedCaCertificateConfigMap: type: string description: Trusted CA certificate name for Remote Broker. required: - tlsEnabled ManagedIdentityAuthenticationUpdate: type: object description: Managed identity authentication details. properties: audience: type: string description: Token audience. extensionName: type: string description: Arc Extension name. ContainerImageUpdate: type: object description: Defines the Docker image details properties: pullPolicy: type: string description: Image pull policy. pullSecrets: type: string description: Image pull secrets. repository: type: string description: The Docker image name. tag: type: string description: The Docker image tag. NodeTolerationsUpdate: type: object description: Defines the Node Tolerations details properties: effect: type: string description: Toleration effect. key: type: string description: Toleration key. operator: type: string description: Toleration operator like 'Exists', 'Equal' etc. value: type: string description: Toleration Value. LocalBrokerAuthenticationMethods: type: object description: Mqtt Local Broker Authentication details. Only one method at a time is supported. Default - kubernetes authentication properties: kubernetes: $ref: '#/definitions/LocalBrokerKubernetesAuthentication' description: Kubernetes local broker authentication method. required: - kubernetes KeyVaultConnectionPropertiesUpdate: type: object description: KeyVault properties properties: credentials: $ref: '#/definitions/KeyVaultCredentialsPropertiesUpdate' description: KeyVault credentials. directoryId: type: string description: KeyVault directoryId. name: type: string description: KeyVault name. ContainerImage: type: object description: Defines the Docker image details properties: pullPolicy: type: string description: Image pull policy. pullSecrets: type: string description: Image pull secrets. repository: type: string description: The Docker image name. tag: type: string description: The Docker image tag. required: - repository - tag NodeTolerations: type: object description: Defines the Node Tolerations details properties: effect: type: string description: Toleration effect. key: type: string description: Toleration key. operator: type: string description: Toleration operator like 'Exists', 'Equal' etc. value: type: string description: Toleration Value. required: - effect - key - operator - value MqttBridgeConnectorResourceUpdate: type: object description: The type used for update operations of the MqttBridgeConnectorResource. properties: tags: type: object description: Resource tags. additionalProperties: type: string properties: $ref: '#/definitions/MqttBridgeConnectorResourceUpdateProperties' x-ms-client-flatten: true ManagedIdentityAuthentication: type: object description: Managed identity authentication details. properties: audience: type: string description: Token audience. extensionName: type: string description: Arc Extension name. required: - audience KeyVaultSecretObject: type: object description: KeyVault secret object properties properties: name: type: string description: KeyVault secret name. version: type: string description: KeyVault secret version. required: - name MqttBridgeRemoteBrokerX509AuthenticationUpdate: type: object description: MqttBridge RemoteBroker X509 Authentication properties. properties: keyVault: $ref: '#/definitions/KeyVaultCertificatePropertiesUpdate' description: Keyvault X509 secret properties. secretName: type: string description: Secret where cert details are stored. LocalBrokerKubernetesAuthentication: type: object description: Local Broker Kubernetes Authentication properties: secretPath: type: string description: Secret Path where SAT is mounted. default: /var/run/serviceaccount/localbroker serviceAccountTokenName: type: string description: Token name where SAT is mounted on secret path. default: sat ProvisioningState: type: string description: The enum defining status of resource. enum: - Succeeded - Failed - Canceled - Provisioning - Updating - Deleting - Accepted x-ms-enum: name: ProvisioningState modelAsString: true values: - name: Succeeded value: Succeeded description: Resource has been created. - name: Failed value: Failed description: Resource creation failed. - name: Canceled value: Canceled description: Resource creation was canceled. - name: Provisioning value: Provisioning description: Resource is getting provisioned. - name: Updating value: Updating description: Resource is Updating. - name: Deleting value: Deleting description: Resource is Deleting. - name: Accepted value: Accepted description: Resource has been Accepted. MqttBridgeConnectorResourceUpdateProperties: type: object description: The updatable properties of the MqttBridgeConnectorResource. properties: bridgeInstances: type: integer format: int32 description: The number of instances to deploy for a bridge rollout. minimum: 0 maximum: 65535 clientIdPrefix: type: string description: The client id prefix of the dynamically generated client ids. image: $ref: '#/definitions/ContainerImageUpdate' description: The details of MqttBridge Docker Image. localBrokerConnection: $ref: '#/definitions/LocalBrokerConnectionSpecUpdate' description: The details for connecting with Local Broker. logLevel: type: string description: The log level of the Bridge Connector instances. nodeTolerations: $ref: '#/definitions/NodeTolerationsUpdate' description: The Node Tolerations for the Bridge Connector pods. protocol: $ref: '#/definitions/MqttProtocol' description: The protocol to use for connecting with Brokers. remoteBrokerConnection: $ref: '#/definitions/MqttBridgeRemoteBrokerConnectionSpecUpdate' description: The details for connecting with Remote Broker. ExtendedLocationType: type: string description: The enum defining type of ExtendedLocation accepted. enum: - CustomLocation x-ms-enum: name: ExtendedLocationType modelAsString: true values: - name: CustomLocation value: CustomLocation description: CustomLocation type KeyVaultCertificatePropertiesUpdate: type: object description: KeyVault certificate properties properties: vault: $ref: '#/definitions/KeyVaultConnectionPropertiesUpdate' description: KeyVault properties. vaultCaChainSecret: $ref: '#/definitions/KeyVaultSecretObjectUpdate' description: KeyVault CA chain secret details. vaultCert: $ref: '#/definitions/KeyVaultSecretObjectUpdate' description: KeyVault Cert secret details. x-ms-parameterized-host: hostTemplate: '{endpoint}' useSchemePrefix: false parameters: - $ref: '#/parameters/Endpoint'