AWS IoT Device Management endpoints and quotas - AWS General Reference

AWS IoT Device Management endpoints and quotas

The following are the service endpoints and service quotas for this service. To connect programmatically to an AWS service, you use an endpoint. In addition to the standard AWS endpoints, some AWS services offer FIPS endpoints in selected Regions. For more information, see AWS service endpoints. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your AWS account. For more information, see AWS service quotas.

Service Endpoints

Region Name Region Endpoint Protocol
US East (Ohio) us-east-2 iot.us-east-2.amazonaws.com HTTPS
US East (N. Virginia) us-east-1 iot.us-east-1.amazonaws.com HTTPS
US West (N. California) us-west-1 iot.us-west-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 iot.us-west-2.amazonaws.com HTTPS
Asia Pacific (Hong Kong) ap-east-1 iot.ap-east-1.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 iot.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 iot.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Singapore) ap-southeast-1 iot.ap-southeast-1.amazonaws.com HTTPS
Asia Pacific (Sydney) ap-southeast-2 iot.ap-southeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 iot.ap-northeast-1.amazonaws.com HTTPS
Canada (Central) ca-central-1 iot.ca-central-1.amazonaws.com HTTPS
China (Beijing) cn-north-1 iot.cn-north-1.amazonaws.com.cn HTTPS
China (Ningxia) cn-northwest-1 iot.cn-northwest-1.amazonaws.com.cn HTTPS
Europe (Frankfurt) eu-central-1 iot.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 iot.eu-west-1.amazonaws.com HTTPS
Europe (London) eu-west-2 iot.eu-west-2.amazonaws.com HTTPS
Europe (Paris) eu-west-3 iot.eu-west-3.amazonaws.com HTTPS
Europe (Stockholm) eu-north-1 iot.eu-north-1.amazonaws.com HTTPS
Middle East (Bahrain) me-south-1 iot.me-south-1.amazonaws.com HTTPS
South America (São Paulo) sa-east-1 iot.sa-east-1.amazonaws.com HTTPS
AWS GovCloud (US-East) us-gov-east-1 iot.us-gov-east-1.amazonaws.com HTTPS, MQTT
AWS GovCloud (US-West) us-gov-west-1 iot.us-gov-west-1.amazonaws.com HTTPS

For information about using AWS IoT in the AWS GovCloud (US) Regions, see AWS GovCloud (US) Endpoints.

For information about using AWS IoT in the China Regions, see:

AWS IoT Device Management supports additional endpoints for working with jobs. These endpoints add an account specific prefix to the endpoints already listed and can be used with both the MQTT and HTTPS protocols. To look up your account-specific prefix, use the describe-endpoint command:

Region Name Region Endpoint Protocol
US East (Ohio) us-east-2 prefix.iot.us-east-2.amazonaws.com MQTT
US East (N. Virginia) us-east-1 prefix.iot.us-east-1.amazonaws.com MQTT
US West (N. California) us-west-1 prefix.iot.us-west-1.amazonaws.com MQTT
US West (Oregon) us-west-2 prefix.iot.us-west-2.amazonaws.com MQTT
Asia Pacific (Hong Kong) ap-east-1 prefix.iot.ap-east-1.amazonaws.com MQTT
Asia Pacific (Mumbai) ap-south-1 prefix.iot.ap-south-1.amazonaws.com MQTT
Asia Pacific (Seoul) ap-northeast-2 prefix.iot.ap-northeast-2.amazonaws.com MQTT
Asia Pacific (Singapore) ap-southeast-1 prefix.iot.ap-southeast-1.amazonaws.com MQTT
Asia Pacific (Sydney) ap-southeast-2 prefix.iot.ap-southeast-2.amazonaws.com MQTT
Asia Pacific (Tokyo) ap-northeast-1 prefix.iot.ap-northeast-1.amazonaws.com MQTT
Canada (Central) ca-central-1 prefix.iot.ca-central-1.amazonaws.com MQTT
China (Beijing) cn-north-1 prefix.iot.cn-north-1.amazonaws.com.cn MQTT
China (Ningxia) cn-northwest-1 prefix.iot.cn-northwest-1.amazonaws.com.cn MQTT
Europe (Frankfurt) eu-central-1 prefix.iot.eu-central-1.amazonaws.com MQTT
Europe (Ireland) eu-west-1 prefix.iot.eu-west-1.amazonaws.com MQTT
Europe (London) eu-west-2 prefix.iot.eu-west-2.amazonaws.com MQTT
Europe (Paris) eu-west-3 prefix.iot.eu-west-3.amazonaws.com MQTT
Europe (Stockholm) eu-north-1 prefix.iot.eu-north-1.amazonaws.com MQTT
Middle East (Bahrain) me-south-1 prefix.iot.me-south-1.amazonaws.com MQTT
South America (São Paulo) sa-east-1 prefix.iot.sa-east-1.amazonaws.com MQTT
AWS GovCloud (US-East) us-gov-east-1 prefix.iot.us-gov-east-1.amazonaws.com MQTT
AWS GovCloud (US-West) us-gov-west-1 prefix.iot.us-gov-west-1.amazonaws.com MQTT
Region Name Region Endpoint Protocol
US East (Ohio) us-east-2 prefix.jobs.iot.us-east-2.amazonaws.com HTTPS
US East (N. Virginia) us-east-1 prefix.jobs.iot.us-east-1.amazonaws.com HTTPS
US West (N. California) us-west-1 prefix.jobs.iot.us-west-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 prefix.jobs.iot.us-west-2.amazonaws.com HTTPS
Asia Pacific (Hong Kong) ap-east-1 prefix.jobs.iot.ap-east-1.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 prefix.jobs.iot.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 prefix.jobs.iot.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Singapore) ap-southeast-1 prefix.jobs.iot.ap-southeast-1.amazonaws.com HTTPS
Asia Pacific (Sydney) ap-southeast-2 prefix.jobs.iot.ap-southeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 prefix.jobs.iot.ap-northeast-1.amazonaws.com HTTPS
Canada (Central) ca-central-1 prefix.jobs.iot.ca-central-1.amazonaws.com HTTPS
China (Beijing) cn-north-1 prefix.jobs.iot.cn-north-1.amazonaws.com.cn HTTPS
China (Ningxia) cn-northwest-1 prefix.jobs.iot.cn-northwest-1.amazonaws.com.cn HTTPS
Europe (Frankfurt) eu-central-1 prefix.jobs.iot.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 prefix.jobs.iot.eu-west-1.amazonaws.com HTTPS
Europe (London) eu-west-2 prefix.jobs.iot.eu-west-2.amazonaws.com HTTPS
Europe (Paris) eu-west-3 prefix.jobs.iot.eu-west-3.amazonaws.com HTTPS
Europe (Stockholm) eu-north-1 prefix.jobs.iot.eu-north-1.amazonaws.com HTTPS
Middle East (Bahrain) me-south-1 prefix.jobs.iot.me-south-1.amazonaws.com HTTPS
South America (São Paulo) sa-east-1 prefix.jobs.iot.sa-east-1.amazonaws.com HTTPS
AWS GovCloud (US-East) us-gov-east-1 prefix.jobs.iot.us-gov-east-1.amazonaws.com HTTPS
AWS GovCloud (US-West) us-gov-west-1 prefix.jobs.iot.us-gov-west-1.amazonaws.com HTTPS

AWS IoT supports additional endpoints for secure tunneling.

Secure Tunneling Management APIs Endpoints

Region Name Region Endpoint Protocol
US East (Ohio) us-east-2 api.tunneling.iot.us-east-2.amazonaws.com HTTPS
US East (N. Virginia) us-east-1 api.tunneling.iot.us-east-1.amazonaws.com HTTPS
US West (N. California) us-west-1 api.tunneling.iot.us-west-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 api.tunneling.iot.us-west-2.amazonaws.com HTTPS
Asia Pacific (Hong Kong) ap-east-1 api.tunneling.iot.ap-east-1.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 api.tunneling.iot.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 api.tunneling.iot.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Singapore) ap-southeast-1 api.tunneling.iot.ap-southeast-1.amazonaws.com HTTPS
Asia Pacific (Sydney) ap-southeast-2 api.tunneling.iot.ap-southeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 api.tunneling.iot.ap-northeast-1.amazonaws.com HTTPS
Canada (Central) ca-central-1 api.tunneling.iot.ca-central-1.amazonaws.com HTTPS
China (Beijing) cn-north-1 api.tunneling.iot.cn-north-1.amazonaws.com.cn HTTPS
China (Ningxia) cn-northwest-1 api.tunneling.iot.cn-northwest-1.amazonaws.com.cn HTTPS
Europe (Frankfurt) eu-central-1 api.tunneling.iot.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 api.tunneling.iot.eu-west-1.amazonaws.com HTTPS
Europe (London) eu-west-2 api.tunneling.iot.eu-west-2.amazonaws.com HTTPS
Europe (Paris) eu-west-3 api.tunneling.iot.eu-west-3.amazonaws.com HTTPS
Europe (Stockholm) eu-north-1 api.tunneling.iot.eu-north-1.amazonaws.com HTTPS
Middle East (Bahrain) me-south-1 api.tunneling.iot.me-south-1.amazonaws.com HTTPS
South America (São Paulo) sa-east-1 api.tunneling.iot.sa-east-1.amazonaws.com HTTPS
AWS GovCloud (US-East) us-gov-east-1 api.tunneling.iot.us-gov-east-1.amazonaws.com HTTPS
AWS GovCloud (US) us-gov-west-1 api.tunneling.iot.us-gov-west-1.amazonaws.com HTTPS

Secure Tunneling Device Connection Endpoints

Region Name Region Endpoint Protocol
US East (Ohio) us-east-2 wss://data.tunneling.iot.us-east-2.amazonaws.com HTTPS
US East (N. Virginia) us-east-1 wss://data.tunneling.iot.us-east-1.amazonaws.com HTTPS
US West (N. California) us-west-1 wss://data.tunneling.iot.us-west-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 wss://data.tunneling.iot.us-west-2.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 wss://data.tunneling.iot.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 wss://data.tunneling.iot.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Singapore) ap-southeast-1 wss://data.tunneling.iot.ap-southeast-1.amazonaws.com HTTPS
Asia Pacific (Sydney) ap-southeast-2 wss://data.tunneling.iot.ap-southeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 wss://data.tunneling.iot.ap-northeast-1.amazonaws.com HTTPS
Asia Pacific (Hong Kong) ap-east-1 wss://data.tunneling.iot.ap-east-1.amazonaws.com HTTPS
Canada (Central) ca-central-1 wss://data.tunneling.iot.ca-central-1.amazonaws.com HTTPS
China (Beijing) cn-north-1 wss://data.tunneling.iot.cn-north-1.amazonaws.com.cn HTTPS
China (Ningxia) cn-northwest-1 wss://data.tunneling.iot.cn-northwest-1.amazonaws.com.cn HTTPS
Europe (Frankfurt) eu-central-1 wss://data.tunneling.iot.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 wss://data.tunneling.iot.eu-west-1.amazonaws.com HTTPS
Europe (London) eu-west-2 wss://data.tunneling.iot.eu-west-2.amazonaws.com HTTPS
Europe (Paris) eu-west-3 wss://data.tunneling.iot.eu-west-3.amazonaws.com HTTPS
Europe (Stockholm) eu-north-1 wss://data.tunneling.iot.eu-north-1.amazonaws.com HTTPS
South America (São Paulo) sa-east-1 wss://data.tunneling.iot.sa-east-1.amazonaws.com HTTPS
Middle East (Bahrain) me-south-1 wss://data.tunneling.iot.me-south-1.amazonaws.com HTTPS
AWS GovCloud (US-East) us-gov-east-1 wss://data.tunneling.iot.us-gov-east-1.amazonaws.com HTTPS
AWS GovCloud (US-West) us-gov-west-1 wss://data.tunneling.iot.us-gov-west-1.amazonaws.com HTTPS

Service Quotas

Contents

AWS IoT Fleet Indexing

Resource Default Notes
Maximum length of a custom field name 1024
Maximum number of custom fields 5
Maximum number of dynamic groups in the fleet index 100
Maximum number of queries per second 15
Maximum number of query results 500
Maximum number of query terms per query 5
Maximum number of things in the fleet index Unlimited
Maximum number of * wildcard operators per query term 2
Maximum number of ? wildcard operators per query term 5
Maximum query length 1000 UTF-8 encoded characters.

AWS IoT Fleet Indexing Throttling

API Max Calls Per Second
DescribeIndex 10
GetCardinality 15
GetIndexingConfiguration 20
GetPercentiles 15
GetStatistics 15
ListIndices 5
SearchIndex 15
UpdateIndexingConfiguration 1

AWS IoT Jobs

Resource Minimum Maximum Notes
Active snapshot and continuous jobs 0 1000 The maximum number of active jobs is 1000 (both snapshot and continuous jobs contribute to the limit).
Data retention N/A 730 days Job data and job execution data for inactive jobs (jobs that aren't IN_PROGRESS) is purged after 730 days.
Job document variable substitution 0 10 Jobs allows variable substitution for up to 10 pre-signed URLs in the Job Doc. Only pre-signed URLs are supported as variables.
Comment N/A 2028 characters
Description N/A 2028 characters
Document N/A 32768 bytes The maximum size of a document that can be sent to an AWS IoT device is 32 KB.
DocumentSource N/A 1350 characters
ExpiresInSec 60 seconds 3600 seconds The lifetime of pre signed URLs must be configured greater than 60 seconds and less than 1 hour.
JobId 1 character 64 characters
MaximumJobExecutionsPerMinute 1 1000 Configures the roll out speed for a job.
MaxResults 1 250
StatusDetail map key size 1 character 128 characters
StatusDetail map key:value pairs 1 key:value pair 10 key:value pairs
StatusDetail map value size 1 character 1024 characters
Targets 1 100
DescribeJobExecution and GetPendingJobExectuions N/A 200 TPS per account If invoking one or more of these read APIs in the data plane causes the associated AWS account to exceed 200 read transactions per second (TPS) in total, then the offending API invocation is throttled to maintain the maximum allowed 200 read TPS per AWS account. Be aware that in the control plane, DescribeJobExecution has a quota of 10 TPS per invocation.
inProgressTimeoutInMinutes property of TimeoutConfig 1 10080 Values are in minutes (1 minute to 7 days).
StartNextPendingJobExecution and UpdateJobExecution N/A 200 TPS per account If invoking one or more of these write APIs in the data plane causes the associated AWS account to exceed 200 write transactions per second (TPS) in total, then the offending API invocation is throttled to maintain the maximum allowed 200 write TPS per AWS account.
stepTimeoutInMinutes value passed with UpdateJobExecution and StartNextPendingJobExecution 1 10080 Values are in minutes (1 minute to 7 days). A value of -1 is also valid when using the UpdateJobExecution API and discards a previously set timer.

For definitions of data plane and control plane, see What are the ways for accessing AWS IoT Core?

AWS IoT Secure Tunneling

Resource Quota
Maximum bandwidth per tunnel 800 kbps
Maximum connection rate 10 TPS
Maximum tunnel lifetime 12 hours
Tagging See Tag Restrictions in the Amazon EC2 User Guide.
API Transactions per Second
CloseTunnel 1
DescribeTunnel 10
ListTagsForResource 10
ListTunnels 10
OpenTunnel 1
TagResource 10
UntagResource 10