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

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
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-West) 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 Adjustable
Maximum length of a custom field name 1024 Yes
Maximum number of custom fields in AWS things index 5 Yes
Maximum number of custom fields in AWS thing groups index 5 Yes
Maximum number of dynamic groups in the fleet index 100 Yes
Maximum number of queries per second 15 Yes
Maximum number of query results per query 500 No
Maximum number of query terms per query 5 Yes
Maximum number of things in the fleet index Unlimited No
Maximum number of * wildcard operators per query term 2 No
Maximum number of ? wildcard operators per query term 5 No
Maximum query length 1000 UTF-8 encoded characters. Yes

AWS IoT Fleet Indexing Throttling

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

AWS IoT Jobs

Resource Minimum Maximum Notes Adjustable
Active snapshot and continuous jobs 0 1000 The maximum number of active jobs is 1000 (both snapshot and continuous jobs contribute to the limit). Yes
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. No
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. No
Concurrent jobs being deleted 0 10 The maximum number of jobs that can have a DELETION_IN_PROGRESS status at the same time. Yes
Comment N/A 2028 characters No
Description N/A 2028 characters No
Document N/A 32768 bytes The maximum size of an S3 job document that can be sent to an AWS IoT device is 32 KB. Yes
DocumentSource N/A 1350 characters No
ExpiresInSec 60 seconds 3600 seconds The lifetime of pre signed URLs must be configured greater than 60 seconds and less than 1 hour. No
JobId 1 character 64 characters No
JobTemplateId 1 character 64 characters No
Job template description 1 character 2028 characters No
Job templates per account N/A 100 Yes
CreateJobTemplate N/A 10 TPS Yes
DescribeJobTemplate N/A 10 TPS Yes
DeleteJobTemplate N/A 10 TPS Yes
ListJobTemplates N/A 10 TPS Yes
MaximumJobExecutionsPerMinute 1 1000 Configures the roll out speed for a job. The minimum job execution roll rate must be 1 but the maximum roll rate for executing a job is adjustable. Yes
MaxResults 1 250 The maximum number of list results per page. No
StatusDetail map key size 1 character 128 characters No
StatusDetail map key:value pairs 1 key:value pair 10 key:value pairs No
StatusDetail map value size 1 character 1024 characters No
Targets 1 100 The maximum number of targets that you can assign to a job. No
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. No
inProgressTimeoutInMinutes property of TimeoutConfig 1 10080 Values are in minutes (1 minute to 7 days). No
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. No
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. No

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

AWS IoT Secure Tunneling

Resource Quota Notes Adjustable
Maximum bandwidth per tunnel 800 kbps No
Maximum services per tunnel 3 You can initiate 1, 2, or 3 services per tunnel. Yes
Maximum connection rate 10 TPS Yes
Maximum tunnel lifetime 12 hours No
Tagging See Tag Restrictions in the Amazon EC2 User Guide. No
API Transactions per second Adjustable
CloseTunnel 1 Yes
DescribeTunnel 10 Yes
ListTagsForResource 10 Yes
ListTunnels 10 Yes
OpenTunnel 1 Yes
TagResource 10 Yes
UntagResource 10 Yes

Fleet Hub for AWS IoT Device Management

Resource Quota Adjustable
Web applications 10 per Region per account Yes
Alarms 100 per Region per account Yes
CreateApplication 10 TPS Yes
DeleteApplication 10 TPS Yes
DescribeApplication 10 TPS Yes
ListApplications 10 TPS Yes
ListTagsForResource 10 TPS Yes
TagResource 10 TPS Yes
UntagResource 10 TPS Yes
UpdateApplication 10 TPS Yes