/

The AWS IoT Secure Tunneling multi-region endpoint

http://api.tunneling.iot.{region}.amazonaws.com

POST

Creates a new tunnel, and returns two client access tokens for clients to use to connect to the IoT Secure Tunneling proxy server.

Requires permission to access the OpenTunnel action.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http://api.tunneling.iot.{region}.amazonaws.com/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "string",
    "tags": [],
    "destinationConfig": {
        "thingName": "string",
        "services": []
    },
    "timeoutConfig": {
        "maxLifetimeTimeoutMinutes": 0
    }
}'

Response Example

200 - Example 1

{
    "tunnelId": "string",
    "tunnelArn": "string",
    "sourceAccessToken": "string",
    "destinationAccessToken": "string"
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480LimitExceededException

Modified at 2023-08-16 07:32:16