/role-aliases/{roleAlias}

The AWS IoT Wireless multi-region endpoint

https://api.iotwireless.{region}.amazonaws.com

POST

Creates a role alias.

Requires permission to access the CreateRoleAlias action.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api.iotwireless.{region}.amazonaws.com/role-aliases/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "roleArn": "stringstringstringst",
    "credentialDurationSeconds": 900,
    "tags": [
        {
            "Key": "string",
            "Value": "string"
        }
    ]
}'

Response Example

200 - Example 1

{
    "roleAlias": "string",
    "roleAliasArn": "string"
}

Request

Path Params

roleAlias

string

required

The role alias that points to a role ARN. This allows you to change the role without having to update the device.

Body Params application/json

roleArn

string

required

The role ARN.

>= 20 characters<= 2048 characters

credentialDurationSeconds

integer

optional

How long (in seconds) the credentials will be valid. The default value is 3,600 seconds.

>= 900<= 43200

Responses

🟢200Success

application/json

Body

roleAlias

string

optional

The role alias.

>= 1 characters<= 128 characters

Match pattern:

[\w=,@-]+

roleAliasArn

string

optional

The role alias ARN.

>= 1 characters<= 2048 characters

🟠480ResourceAlreadyExistsException

🟠481InvalidRequestException

🟠482LimitExceededException

🟠483ThrottlingException

🟠484UnauthorizedException

🟠485ServiceUnavailableException

🟠486InternalFailureException

Modified at 2022-09-10 23:12:14

/provisioning-templates/{templateName}/versions

/role-aliases/{roleAlias}