/

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

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠480LimitExceededException

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

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

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