describeGatewayCapabilityConfiguration method

Future<DescribeGatewayCapabilityConfigurationResponse> describeGatewayCapabilityConfiguration({
  1. required String capabilityNamespace,
  2. required String gatewayId,
})

Each gateway capability defines data sources for a gateway. This is the namespace of the gateway capability.

. The namespace follows the format service:capability:version, where:

  • service - The service providing the capability, or iotsitewise.
  • capability - The specific capability type. Options include: opcuacollector for the OPC UA data source collector, or publisher for data publisher capability.
  • version - The version number of the capability. Option include 2 for Classic streams, V2 gateways, and 3 for MQTT-enabled, V3 gateways.
After updating a capability configuration, the sync status becomes OUT_OF_SYNC until the gateway processes the configuration.Use DescribeGatewayCapabilityConfiguration to check the sync status and verify the configuration was applied.

A gateway can have multiple capability configurations with different namespaces.

May throw InternalFailureException. May throw InvalidRequestException. May throw ResourceNotFoundException. May throw ThrottlingException.

Parameter capabilityNamespace : The namespace of the capability configuration. For example, if you configure OPC UA sources for an MQTT-enabled gateway, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:3.

Parameter gatewayId : The ID of the gateway that defines the capability configuration.

Implementation

Future<DescribeGatewayCapabilityConfigurationResponse>
    describeGatewayCapabilityConfiguration({
  required String capabilityNamespace,
  required String gatewayId,
}) async {
  final response = await _protocol.send(
    payload: null,
    method: 'GET',
    requestUri:
        '/20200301/gateways/${Uri.encodeComponent(gatewayId)}/capability/${Uri.encodeComponent(capabilityNamespace)}',
    hostPrefix: 'api.',
    exceptionFnMap: _exceptionFns,
  );
  return DescribeGatewayCapabilityConfigurationResponse.fromJson(response);
}