update_gateway_capability_configuration

update_gateway_capability_configuration(**kwargs)

Updates a gateway capability configuration or defines a new capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

See also: AWS API Documentation

Request Syntax

response = client.update_gateway_capability_configuration(
    gatewayId='string',
    capabilityNamespace='string',
    capabilityConfiguration='string'
)

Parameters

• gatewayId (string) --

  [REQUIRED]

  The ID of the gateway to be updated.

• capabilityNamespace (string) --

  [REQUIRED]

  The namespace of the gateway capability configuration to be updated. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version , where version is a number such as 1 .

• capabilityConfiguration (string) --

  [REQUIRED]

  The JSON document that defines the configuration for the gateway capability. For more information, see Configuring data sources (CLI) in the IoT SiteWise User Guide .

Return type

dict

Returns

Response Syntax

{
    'capabilityNamespace': 'string',
    'capabilitySyncStatus': 'IN_SYNC'|'OUT_OF_SYNC'|'SYNC_FAILED'|'UNKNOWN'
}

Response Structure

• (dict) --

  • capabilityNamespace (string) --

    The namespace of the gateway capability.

  • capabilitySyncStatus (string) --

    The synchronization status of the capability configuration. The sync status can be one of the following:

    • IN_SYNC – The gateway is running the capability configuration.
    • OUT_OF_SYNC – The gateway hasn't received the capability configuration.
    • SYNC_FAILED – The gateway rejected the capability configuration.

    After you update a capability configuration, its sync status is OUT_OF_SYNC until the gateway receives and applies or rejects the updated configuration.

Exceptions

• IoTSiteWise.Client.exceptions.InvalidRequestException
• IoTSiteWise.Client.exceptions.ResourceNotFoundException
• IoTSiteWise.Client.exceptions.ConflictingOperationException
• IoTSiteWise.Client.exceptions.InternalFailureException
• IoTSiteWise.Client.exceptions.ThrottlingException
• IoTSiteWise.Client.exceptions.LimitExceededException