/policies/{policyName}

The AWS IoT Wireless multi-region endpoint

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

POST

Creates an IoT policy.

The created policy is the default version for the policy. This operation creates a policy version with a version identifier of 1 and sets 1 as the policy's default version.

Requires permission to access the CreatePolicy action.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "policyName": "string",
    "policyArn": "string",
    "policyDocument": "string",
    "policyVersionId": "string"
}

Request

Path Params

policyName

string

required

The policy name.

Body Params application/json

policyDocument

string

required

The JSON document that describes the policy. policyDocument must have a minimum length of 1, with a maximum length of 2048, excluding whitespace.

Responses

🟢200Success

application/json

Body

The output from the CreatePolicy operation.

policyName

string

optional

The policy name.

>= 1 characters<= 128 characters

Match pattern:

[\w+=,.@-]+

policyArn

string

optional

The policy ARN.

policyDocument

string

optional

The JSON document that describes the policy.

policyVersionId

string

optional

The policy version ID.

Match pattern:

[0-9]+

🟠480ResourceAlreadyExistsException

🟠481MalformedPolicyException

🟠482InvalidRequestException

🟠483ThrottlingException

🟠484UnauthorizedException

🟠485ServiceUnavailableException

🟠486InternalFailureException

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

/otaUpdates/{otaUpdateId}

/policies/{policyName}