Start connecting a Route 53 domain through a limited IAM role instead of an access key
start route53 role: reference page for this CustomDomain™ API operation in the connections group. Covers parameters, request body, responses and error codes.
Route 53 access role. For a domain whose DNS is in Amazon Route 53, the customer creates a limited IAM role in their own AWS account from the CustomDomain™ CloudFormation template instead of pasting an AWS access key. This call generates the connection's external ID (once: later calls return the same one), stores the hosted zone id when you pass one, and returns a CloudFormation quick-create link plus plain instructions. The role the link creates can be assumed by CustomDomain™ only with that external ID, can read only the chosen hosted zone, and can change only the records for the connected name. Idempotent. Answers 503 when this deployment has not set the rail up. Takes a widget JWT for the connection's own application or an API key for a connection of any application in its tenant (a member's key needs a role that operates apps), like route53-role:complete.
A widget token must be the connection's end user: a connection that names another end user than the token's end_user_ref, or names one while the token names none, answers 403 token_wrong_end_user before anything is read or changed, and a connection that names none is any token's. An API key, an app-scoped token and a delegated agent token are not limited by it.
Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/connections/string/route53-role:start" \ -H "Content-Type: application/json" \ -d '{}'{ "connection_id": "string", "quick_create_url": "http://example.com", "template_url": "http://example.com", "region": "string", "stack_name": "string", "role_name": "string", "external_id": "string", "trusted_principal_arn": "string", "record_name": "string", "hosted_zone_id": "string", "role_arn": "string", "instructions": [ "string" ]}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}