Upload
others
View
23
Download
0
Embed Size (px)
Citation preview
Amazon LightsailAPI Reference
API Version 2016-11-28
Amazon Lightsail API Reference
Amazon Lightsail: API ReferenceCopyright © 2020 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
Amazon's trademarks and trade dress may not be used in connection with any product or service that is notAmazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages ordiscredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who mayor may not be affiliated with, connected to, or sponsored by Amazon.
Amazon Lightsail API Reference
Table of ContentsWelcome .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Actions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
AllocateStaticIp .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
AttachCertificateToDistribution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
AttachDisk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
AttachInstancesToLoadBalancer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
AttachLoadBalancerTlsCertificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
AttachStaticIp .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
CloseInstancePublicPorts ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
CopySnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
API Version 2016-11-28iii
Amazon Lightsail API Reference
Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Examples .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
CreateCertificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
CreateCloudFormationStack .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
CreateContactMethod .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
CreateDisk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
CreateDiskFromSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
CreateDiskSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
CreateDistribution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
CreateDomain .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
API Version 2016-11-28iv
Amazon Lightsail API Reference
Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
CreateDomainEntry .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
CreateInstances .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
CreateInstancesFromSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
CreateInstanceSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
CreateKeyPair ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
CreateLoadBalancer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
CreateLoadBalancerTlsCertificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
CreateRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
API Version 2016-11-28v
Amazon Lightsail API Reference
Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
CreateRelationalDatabaseFromSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
CreateRelationalDatabaseSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
DeleteAlarm ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
DeleteAutoSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
DeleteCertificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
DeleteContactMethod .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
DeleteDisk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
DeleteDiskSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
API Version 2016-11-28vi
Amazon Lightsail API Reference
Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
DeleteDistribution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
DeleteDomain .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
DeleteDomainEntry .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DeleteInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
DeleteInstanceSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
DeleteKeyPair ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
DeleteKnownHostKeys .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
DeleteLoadBalancer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
API Version 2016-11-28vii
Amazon Lightsail API Reference
See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144DeleteLoadBalancerTlsCertificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
DeleteRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
DeleteRelationalDatabaseSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
DetachCertificateFromDistribution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
DetachDisk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
DetachInstancesFromLoadBalancer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
DetachStaticIp .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
DisableAddOn .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
API Version 2016-11-28viii
Amazon Lightsail API Reference
DownloadDefaultKeyPair ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
EnableAddOn .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
ExportSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
GetActiveNames .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
GetAlarms .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
GetAutoSnapshots .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
GetBlueprints ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
GetBundles .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
GetCertificates .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
API Version 2016-11-28ix
Amazon Lightsail API Reference
Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
GetCloudFormationStackRecords .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
GetContactMethods .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
GetDisk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
GetDisks .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
GetDiskSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
GetDiskSnapshots .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
GetDistributionBundles .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
GetDistributionLatestCacheReset .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
API Version 2016-11-28x
Amazon Lightsail API Reference
See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218GetDistributionMetricData .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
GetDistributions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
GetDomain .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
GetDomains .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
GetExportSnapshotRecords .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
GetInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
GetInstanceAccessDetails ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
GetInstanceMetricData .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
API Version 2016-11-28xi
Amazon Lightsail API Reference
GetInstancePortStates .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
GetInstances .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
GetInstanceSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
GetInstanceSnapshots .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
GetInstanceState .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
GetKeyPair ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
GetKeyPairs ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
GetLoadBalancer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
GetLoadBalancerMetricData .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
API Version 2016-11-28xii
Amazon Lightsail API Reference
Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
GetLoadBalancers ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
GetLoadBalancerTlsCertificates .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
GetOperation .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
GetOperations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
GetOperationsForResource .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
GetRegions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
GetRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
GetRelationalDatabaseBlueprints ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
API Version 2016-11-28xiii
Amazon Lightsail API Reference
Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
GetRelationalDatabaseBundles .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
GetRelationalDatabaseEvents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
GetRelationalDatabaseLogEvents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
GetRelationalDatabaseLogStreams .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
GetRelationalDatabaseMasterUserPassword .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
GetRelationalDatabaseMetricData .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
GetRelationalDatabaseParameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
GetRelationalDatabases .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
API Version 2016-11-28xiv
Amazon Lightsail API Reference
Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
GetRelationalDatabaseSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
GetRelationalDatabaseSnapshots .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
GetStaticIp .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
GetStaticIps .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
ImportKeyPair ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
IsVpcPeered .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
OpenInstancePublicPorts ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
PeerVpc .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
PutAlarm ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
API Version 2016-11-28xv
Amazon Lightsail API Reference
Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
PutInstancePublicPorts ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
RebootInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
RebootRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
ReleaseStaticIp .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
ResetDistributionCache .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
SendContactMethodVerification .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
StartInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
StartRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
API Version 2016-11-28xvi
Amazon Lightsail API Reference
Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
StopInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
StopRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
TagResource .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
TestAlarm ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
UnpeerVpc .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
UntagResource .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
UpdateDistribution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
UpdateDistributionBundle .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
API Version 2016-11-28xvii
Amazon Lightsail API Reference
Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
UpdateDomainEntry .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
UpdateLoadBalancerAttribute .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
UpdateRelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
UpdateRelationalDatabaseParameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Data Types .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423AddOn .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
AddOnRequest ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
Alarm ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
AttachedDisk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
AutoSnapshotAddOnRequest ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
AutoSnapshotDetails ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
AvailabilityZone .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
Blueprint ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
Bundle .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
API Version 2016-11-28xviii
Amazon Lightsail API Reference
See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440CacheBehavior ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
CacheBehaviorPerPath .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
CacheSettings .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
Certificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
CertificateSummary .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
CloudFormationStackRecord .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
CloudFormationStackRecordSourceInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
ContactMethod .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
CookieObject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
DestinationInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Disk .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
DiskInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
DiskMap .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
DiskSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
DiskSnapshotInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
DistributionBundle .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
Domain .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
DomainEntry .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
DomainValidationRecord .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
API Version 2016-11-28xix
Amazon Lightsail API Reference
See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472ExportSnapshotRecord .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
ExportSnapshotRecordSourceInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
HeaderObject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
HostKeyAttributes .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
InputOrigin .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
Instance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
InstanceAccessDetails ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
InstanceEntry .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
InstanceHardware .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
InstanceHealthSummary .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
InstanceNetworking .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
InstancePortInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
InstancePortState .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
InstanceSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
InstanceSnapshotInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
InstanceState .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
KeyPair ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
LightsailDistribution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
LoadBalancer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
API Version 2016-11-28xx
Amazon Lightsail API Reference
See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511LoadBalancerTlsCertificate .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
LoadBalancerTlsCertificateDomainValidationOption .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
LoadBalancerTlsCertificateDomainValidationRecord .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
LoadBalancerTlsCertificateRenewalSummary .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
LoadBalancerTlsCertificateSummary .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
LogEvent .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
MetricDatapoint ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
MonitoredResourceInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
MonthlyTransfer ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
Operation .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
Origin .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
PasswordData .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
PendingMaintenanceAction .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
PendingModifiedRelationalDatabaseValues .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
PortInfo .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
QueryStringObject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
Region .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
RelationalDatabase .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
RelationalDatabaseBlueprint ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
API Version 2016-11-28xxi
Amazon Lightsail API Reference
See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545RelationalDatabaseBundle .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
RelationalDatabaseEndpoint ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
RelationalDatabaseEvent .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
RelationalDatabaseHardware .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
RelationalDatabaseParameter ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
RelationalDatabaseSnapshot .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
RenewalSummary .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
ResourceLocation .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
ResourceRecord .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
StaticIp .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
Tag .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
Common Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564Common Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
API Version 2016-11-28xxii
Amazon Lightsail API Reference
WelcomeAmazon Lightsail is the easiest way to get started with Amazon Web Services (AWS) for developerswho need to build websites or web applications. It includes everything you need to launch your projectquickly – instances (virtual private servers), managed databases, SSD-based block storage, static IPaddresses, load balancers, content delivery network (CDN) distributions, DNS management of registereddomains, and snapshots (backups) – for a low, predictable monthly price.
You can manage your Lightsail resources using the Lightsail console, Lightsail API, AWS Command LineInterface (AWS CLI), or SDKs. For more information about Lightsail concepts and tasks, see the LightsailDev Guide.
This API Reference provides detailed information about the actions, data types, parameters, and errorsof the Lightsail service. For more information about the supported AWS Regions, endpoints, andservice quotas for the Lightsail service, see Amazon Lightsail Endpoints and Quotas in the AWS GeneralReference.
This document was last published on October 7, 2020.
API Version 2016-11-281
Amazon Lightsail API Reference
ActionsThe following actions are supported:
• AllocateStaticIp (p. 5)• AttachCertificateToDistribution (p. 8)• AttachDisk (p. 11)• AttachInstancesToLoadBalancer (p. 14)• AttachLoadBalancerTlsCertificate (p. 17)• AttachStaticIp (p. 20)• CloseInstancePublicPorts (p. 23)• CopySnapshot (p. 26)• CreateCertificate (p. 32)• CreateCloudFormationStack (p. 36)• CreateContactMethod (p. 39)• CreateDisk (p. 42)• CreateDiskFromSnapshot (p. 46)• CreateDiskSnapshot (p. 51)• CreateDistribution (p. 55)• CreateDomain (p. 60)• CreateDomainEntry (p. 63)• CreateInstances (p. 66)• CreateInstancesFromSnapshot (p. 70)• CreateInstanceSnapshot (p. 75)• CreateKeyPair (p. 78)• CreateLoadBalancer (p. 82)• CreateLoadBalancerTlsCertificate (p. 86)• CreateRelationalDatabase (p. 90)• CreateRelationalDatabaseFromSnapshot (p. 95)• CreateRelationalDatabaseSnapshot (p. 100)• DeleteAlarm (p. 103)• DeleteAutoSnapshot (p. 106)• DeleteCertificate (p. 109)• DeleteContactMethod (p. 112)• DeleteDisk (p. 115)• DeleteDiskSnapshot (p. 118)• DeleteDistribution (p. 121)• DeleteDomain (p. 124)• DeleteDomainEntry (p. 127)• DeleteInstance (p. 130)• DeleteInstanceSnapshot (p. 133)• DeleteKeyPair (p. 136)• DeleteKnownHostKeys (p. 139)• DeleteLoadBalancer (p. 142)
API Version 2016-11-282
Amazon Lightsail API Reference
• DeleteLoadBalancerTlsCertificate (p. 145)• DeleteRelationalDatabase (p. 148)• DeleteRelationalDatabaseSnapshot (p. 151)• DetachCertificateFromDistribution (p. 154)• DetachDisk (p. 157)• DetachInstancesFromLoadBalancer (p. 160)• DetachStaticIp (p. 163)• DisableAddOn (p. 166)• DownloadDefaultKeyPair (p. 169)• EnableAddOn (p. 171)• ExportSnapshot (p. 174)• GetActiveNames (p. 177)• GetAlarms (p. 180)• GetAutoSnapshots (p. 184)• GetBlueprints (p. 187)• GetBundles (p. 190)• GetCertificates (p. 193)• GetCloudFormationStackRecords (p. 197)• GetContactMethods (p. 200)• GetDisk (p. 203)• GetDisks (p. 206)• GetDiskSnapshot (p. 209)• GetDiskSnapshots (p. 212)• GetDistributionBundles (p. 215)• GetDistributionLatestCacheReset (p. 217)• GetDistributionMetricData (p. 220)• GetDistributions (p. 225)• GetDomain (p. 229)• GetDomains (p. 232)• GetExportSnapshotRecords (p. 235)• GetInstance (p. 238)• GetInstanceAccessDetails (p. 242)• GetInstanceMetricData (p. 245)• GetInstancePortStates (p. 250)• GetInstances (p. 253)• GetInstanceSnapshot (p. 257)• GetInstanceSnapshots (p. 260)• GetInstanceState (p. 264)• GetKeyPair (p. 267)• GetKeyPairs (p. 270)• GetLoadBalancer (p. 273)• GetLoadBalancerMetricData (p. 276)• GetLoadBalancers (p. 282)• GetLoadBalancerTlsCertificates (p. 285)• GetOperation (p. 288)• GetOperations (p. 291)
API Version 2016-11-283
Amazon Lightsail API Reference
• GetOperationsForResource (p. 294)• GetRegions (p. 297)• GetRelationalDatabase (p. 300)• GetRelationalDatabaseBlueprints (p. 303)• GetRelationalDatabaseBundles (p. 306)• GetRelationalDatabaseEvents (p. 309)• GetRelationalDatabaseLogEvents (p. 312)• GetRelationalDatabaseLogStreams (p. 316)• GetRelationalDatabaseMasterUserPassword (p. 318)• GetRelationalDatabaseMetricData (p. 321)• GetRelationalDatabaseParameters (p. 326)• GetRelationalDatabases (p. 329)• GetRelationalDatabaseSnapshot (p. 333)• GetRelationalDatabaseSnapshots (p. 336)• GetStaticIp (p. 339)• GetStaticIps (p. 342)• ImportKeyPair (p. 345)• IsVpcPeered (p. 348)• OpenInstancePublicPorts (p. 350)• PeerVpc (p. 353)• PutAlarm (p. 355)• PutInstancePublicPorts (p. 361)• RebootInstance (p. 364)• RebootRelationalDatabase (p. 367)• ReleaseStaticIp (p. 370)• ResetDistributionCache (p. 373)• SendContactMethodVerification (p. 376)• StartInstance (p. 379)• StartRelationalDatabase (p. 382)• StopInstance (p. 385)• StopRelationalDatabase (p. 388)• TagResource (p. 391)• TestAlarm (p. 394)• UnpeerVpc (p. 397)• UntagResource (p. 399)• UpdateDistribution (p. 402)• UpdateDistributionBundle (p. 406)• UpdateDomainEntry (p. 409)• UpdateLoadBalancerAttribute (p. 412)• UpdateRelationalDatabase (p. 415)• UpdateRelationalDatabaseParameters (p. 420)
API Version 2016-11-284
Amazon Lightsail API ReferenceAllocateStaticIp
AllocateStaticIpAllocates a static IP address.
Request Syntax{ "staticIpName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
staticIpName (p. 5)
The name of the static IP address.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-285
Amazon Lightsail API ReferenceErrors
operations (p. 5)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-286
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-287
Amazon Lightsail API ReferenceAttachCertificateToDistribution
AttachCertificateToDistributionAttaches an SSL/TLS certificate to your Amazon Lightsail content delivery network (CDN) distribution.
After the certificate is attached, your distribution accepts HTTPS traffic for all of the domains that areassociated with the certificate.
Use the CreateCertificate action to create a certificate that you can attach to your distribution.
ImportantOnly certificates created in the us-east-1 AWS Region can be attached to Lightsaildistributions. Lightsail distributions are global resources that can reference an origin in any AWSRegion, and distribute its content globally. However, all distributions are located in the us-east-1 Region.
Request Syntax{ "certificateName": "string", "distributionName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateName (p. 8)
The name of the certificate to attach to a distribution.
Only certificates with a status of ISSUED can be attached to a distribution.
Use the GetCertificates action to get a list of certificate names that you can specify.
NoteThis is the name of the certificate resource type and is used only to reference the certificatein other API actions. It can be different than the domain name of the certificate. Forexample, your certificate name might be WordPress-Blog-Certificate and the domainname of the certificate might be example.com.
Type: String
Pattern: \w[\w\-]*\w
Required: YesdistributionName (p. 8)
The name of the distribution that the certificate will be attached to.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
API Version 2016-11-288
Amazon Lightsail API ReferenceResponse Syntax
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 9)
An object that describes the result of the action, such as the status of the request, the timestamp ofthe request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-289
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2810
Amazon Lightsail API ReferenceAttachDisk
AttachDiskAttaches a block storage disk to a running or stopped Lightsail instance and exposes it to the instancewith the specified disk name.
The attach disk operation supports tag-based access control via resource tags applied to the resourceidentified by disk name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "diskName": "string", "diskPath": "string", "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskName (p. 11)
The unique Lightsail disk name (e.g., my-disk).
Type: String
Pattern: \w[\w\-]*\w
Required: YesdiskPath (p. 11)
The disk path to expose to the instance (e.g., /dev/xvdf).
Type: String
Pattern: .*\S.*
Required: YesinstanceName (p. 11)
The name of the Lightsail instance where you want to utilize the storage disk.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{
API Version 2016-11-2811
Amazon Lightsail API ReferenceResponse Elements
"operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 11)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-2812
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2813
Amazon Lightsail API ReferenceAttachInstancesToLoadBalancer
AttachInstancesToLoadBalancerAttaches one or more Lightsail instances to a load balancer.
After some time, the instances are attached to the load balancer and the health check status is available.
The attach instances to load balancer operation supports tag-based access control viaresource tags applied to the resource identified by load balancer name. For more information, seethe Lightsail Dev Guide.
Request Syntax{ "instanceNames": [ "string" ], "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceNames (p. 14)
An array of strings representing the instance name(s) you want to attach to your load balancer.
An instance must be running before you can attach it to your load balancer.
There are no additional limits on the number of instances you can attach to your load balancer, asidefrom the limit of Lightsail instances you can create in your account (20).
Type: Array of strings
Pattern: \w[\w\-]*\w
Required: YesloadBalancerName (p. 14)
The name of the load balancer.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string",
API Version 2016-11-2814
Amazon Lightsail API ReferenceResponse Elements
"errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 14)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-2815
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2816
Amazon Lightsail API ReferenceAttachLoadBalancerTlsCertificate
AttachLoadBalancerTlsCertificateAttaches a Transport Layer Security (TLS) certificate to your load balancer. TLS is just an updated, moresecure version of Secure Socket Layer (SSL).
Once you create and validate your certificate, you can attach it to your load balancer. You can also usethis API to rotate the certificates on your account. Use the AttachLoadBalancerTlsCertificateaction with the non-attached certificate, and it will replace the existing one and become the attachedcertificate.
The AttachLoadBalancerTlsCertificate operation supports tag-based access control via resourcetags applied to the resource identified by load balancer name. For more information, see theLightsail Dev Guide.
Request Syntax{ "certificateName": "string", "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateName (p. 17)
The name of your SSL/TLS certificate.
Type: String
Pattern: \w[\w\-]*\w
Required: YesloadBalancerName (p. 17)
The name of the load balancer to which you want to associate the SSL/TLS certificate.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string",
API Version 2016-11-2817
Amazon Lightsail API ReferenceResponse Elements
"isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 17)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
These SSL/TLS certificates are only usable by Lightsail load balancers. You can't get the certificateand use it for another purpose.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-2818
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2819
Amazon Lightsail API ReferenceAttachStaticIp
AttachStaticIpAttaches a static IP address to a specific Amazon Lightsail instance.
Request Syntax{ "instanceName": "string", "staticIpName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 20)
The instance name to which you want to attach the static IP address.
Type: String
Pattern: \w[\w\-]*\w
Required: YesstaticIpName (p. 20)
The name of the static IP.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string",
API Version 2016-11-2820
Amazon Lightsail API ReferenceResponse Elements
"statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 20)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-2821
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2822
Amazon Lightsail API ReferenceCloseInstancePublicPorts
CloseInstancePublicPortsCloses ports for a specific Amazon Lightsail instance.
The CloseInstancePublicPorts action supports tag-based access control via resource tags appliedto the resource identified by instanceName. For more information, see the Lightsail Dev Guide.
Request Syntax{ "instanceName": "string", "portInfo": { "cidrListAliases": [ "string" ], "cidrs": [ "string" ], "fromPort": number, "protocol": "string", "toPort": number }}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 23)
The name of the instance for which to close ports.
Type: String
Pattern: \w[\w\-]*\w
Required: YesportInfo (p. 23)
An object to describe the ports to close for the specified instance.
Type: PortInfo (p. 536) object
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string"
API Version 2016-11-2823
Amazon Lightsail API ReferenceResponse Elements
}, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 23)
An object that describes the result of the action, such as the status of the request, the timestamp ofthe request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-2824
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2825
Amazon Lightsail API ReferenceCopySnapshot
CopySnapshotCopies a manual snapshot of an instance or disk as another manual snapshot, or copies an automaticsnapshot of an instance or disk as a manual snapshot. This operation can also be used to copy a manualor automatic snapshot of an instance or a disk from one AWS Region to another in Amazon Lightsail.
When copying a manual snapshot, be sure to define the source region, source snapshot name,and target snapshot name parameters.
When copying an automatic snapshot, be sure to define the source region, source resourcename, target snapshot name, and either the restore date or the use latest restorableauto snapshot parameters.
Request Syntax{ "restoreDate": "string", "sourceRegion": "string", "sourceResourceName": "string", "sourceSnapshotName": "string", "targetSnapshotName": "string", "useLatestRestorableAutoSnapshot": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
restoreDate (p. 26)
The date of the source automatic snapshot to copy. Use the get auto snapshots operation toidentify the dates of the available automatic snapshots.
Constraints:• Must be specified in YYYY-MM-DD format.• This parameter cannot be defined together with the use latest restorable autosnapshot parameter. The restore date and use latest restorable auto snapshotparameters are mutually exclusive.
• Define this parameter only when copying an automatic snapshot as a manual snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: String
Required: NosourceRegion (p. 26)
The AWS Region where the source manual or automatic snapshot is located.
Type: String
Valid Values: us-east-1 | us-east-2 | us-west-1 | us-west-2 | eu-west-1 |eu-west-2 | eu-west-3 | eu-central-1 | ca-central-1 | ap-south-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | ap-northeast-2
API Version 2016-11-2826
Amazon Lightsail API ReferenceResponse Syntax
Required: YessourceResourceName (p. 26)
The name of the source instance or disk from which the source automatic snapshot was created.
Constraint:• Define this parameter only when copying an automatic snapshot as a manual snapshot. For more
information, see the Lightsail Dev Guide.
Type: String
Required: NosourceSnapshotName (p. 26)
The name of the source manual snapshot to copy.
Constraint:• Define this parameter only when copying a manual snapshot as another manual snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: NotargetSnapshotName (p. 26)
The name of the new manual snapshot to be created as a copy.
Type: String
Pattern: \w[\w\-]*\w
Required: YesuseLatestRestorableAutoSnapshot (p. 26)
A Boolean value to indicate whether to use the latest available automatic snapshot of the specifiedsource instance or disk.
Constraints:• This parameter cannot be defined together with the restore date parameter. The use latestrestorable auto snapshot and restore date parameters are mutually exclusive.
• Define this parameter only when copying an automatic snapshot as a manual snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: Boolean
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string",
API Version 2016-11-2827
Amazon Lightsail API ReferenceResponse Elements
"isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 27)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-2828
Amazon Lightsail API ReferenceExamples
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
ExamplesIn the following example or examples, the Authorization header contents (AUTHPARAMS) must bereplaced with an AWS Signature Version 4 signature. For more information about creating thesesignatures, see Signature Version 4 Signing Process in the AWS General Reference.
You need to learn how to sign HTTP requests only if you intend to manually create them. When you usethe AWS Command Line Interface (AWS CLI) or one of the AWS SDKs to make requests to AWS, thesetools automatically sign the requests for you with the access key that you specify when you configure thetools. When you use these tools, you don't need to learn how to sign requests yourself.
Copy an automatic snapshotThe following example creates a new manual snapshot named CopiedAutoSnapshot-2019-09-25 asa copy of the existing automatic snapshot named 2019-09-25 from the WordPress-1 instance in theus-west-2 AWS Region.
Sample Request
POST / HTTP/1.1Host: lightsail.us-west-2.amazonaws.comAccept-Encoding: identityX-Amz-Target: Lightsail_20161128.CopySnapshotContent-Type: application/x-amz-json-1.1User-Agent: aws-cli/1.16.223 Python/3.6.0 Windows/10 botocore/1.12.213X-Amz-Date: 20190927T194244ZAuthorization: AUTHPARAMSContent-Length: 150
{ "sourceResourceName": "WordPress-1", "restoreDate": "2019-09-25", "targetSnapshotName": "CopiedAutoSnapshot-2019-09-25", "sourceRegion": "us-west-2"}
Sample Response
HTTP/1.1 200 OKServer: ServerDate: Fri, 27 Sep 2019 19:42:46 GMT
API Version 2016-11-2829
Amazon Lightsail API ReferenceExamples
Content-Type: application/x-amz-json-1.1Content-Length: 380x-amzn-RequestId: 69449102-9023-431e-8a00-746f29d76970Connection: keep-alive
{ "operations": [{ "createdAt": 1.56961336589E9, "id": "0710de23-b848-4146-887d-ec12093c049d", "isTerminal": false, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "operationDetails": "us-west-2:WordPress-1", "operationType": "CopySnapshot", "resourceName": "CopiedAutoSnapshot-2019-09-25", "resourceType": "InstanceSnapshot", "status": "Started", "statusChangedAt": 1.56961336589E9 }]}
Copy a manual snapshotThe following example creates a new manual snapshot named CopiedManualSnapshot-2019-09-25as a copy of the existing manual snapshot named WordPress-1-1569608575 in the us-west-2 AWSRegion.
Sample Request
POST / HTTP/1.1Host: lightsail.us-west-2.amazonaws.comAccept-Encoding: identityX-Amz-Target: Lightsail_20161128.CopySnapshotContent-Type: application/x-amz-json-1.1User-Agent: aws-cli/1.16.223 Python/3.6.0 Windows/10 botocore/1.12.213X-Amz-Date: 20190927T195200ZAuthorization: AUTHPARAMSContent-Length: 134
{ "sourceSnapshotName": "WordPress-1-1569608575", "targetSnapshotName": "CopiedManualSnapshot-2019-09-25", "sourceRegion": "us-west-2"}
Sample Response
HTTP/1.1 200 OKServer: ServerDate: Fri, 27 Sep 2019 19:52:01 GMTContent-Type: application/x-amz-json-1.1Content-Length: 395x-amzn-RequestId: 5e3e211b-0afe-439e-bead-8a960573b3c8Connection: keep-alive
{ "operations": [{ "createdAt": 1.569613921044E9, "id": "0d4f2d2a-78ce-44d1-82fe-33588af9afa0",
API Version 2016-11-2830
Amazon Lightsail API ReferenceSee Also
"isTerminal": false, "location": { "availabilityZone": "all", "regionName": "us-west-2" }, "operationDetails": "us-west-2:WordPress-1-1569608575", "operationType": "CopySnapshot", "resourceName": "CopiedManualSnapshot-2019-09-25", "resourceType": "InstanceSnapshot", "status": "Started", "statusChangedAt": 1.569613921044E9 }]}
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2831
Amazon Lightsail API ReferenceCreateCertificate
CreateCertificateCreates an SSL/TLS certificate for a Amazon Lightsail content delivery network (CDN) distribution.
After the certificate is created, use the AttachCertificateToDistribution action to attach thecertificate to your distribution.
ImportantOnly certificates created in the us-east-1 AWS Region can be attached to Lightsaildistributions. Lightsail distributions are global resources that can reference an origin in any AWSRegion, and distribute its content globally. However, all distributions are located in the us-east-1 Region.
Request Syntax{ "certificateName": "string", "domainName": "string", "subjectAlternativeNames": [ "string" ], "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateName (p. 32)
The name for the certificate.
Type: String
Required: YesdomainName (p. 32)
The domain name (e.g., example.com) for the certificate.
Type: String
Required: YessubjectAlternativeNames (p. 32)
An array of strings that specify the alternate domains (e.g., example2.com) and subdomains (e.g.,blog.example.com) for the certificate.
You can specify a maximum of nine alternate domains (in addition to the primary domain name).
Wildcard domain entries (e.g., *.example.com) are not supported.
Type: Array of strings
API Version 2016-11-2832
Amazon Lightsail API ReferenceResponse Syntax
Required: Notags (p. 32)
The tag keys and optional values to add to the certificate during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "certificate": { "certificateArn": "string", "certificateDetail": { "arn": "string", "createdAt": number, "domainName": "string", "domainValidationRecords": [ { "domainName": "string", "resourceRecord": { "name": "string", "type": "string", "value": "string" } } ], "eligibleToRenew": "string", "inUseResourceCount": number, "issuedAt": number, "issuerCA": "string", "keyAlgorithm": "string", "name": "string", "notAfter": number, "notBefore": number, "renewalSummary": { "domainValidationRecords": [ { "domainName": "string", "resourceRecord": { "name": "string", "type": "string", "value": "string" } } ], "renewalStatus": "string", "renewalStatusReason": "string", "updatedAt": number }, "requestFailureReason": "string", "revocationReason": "string", "revokedAt": number, "serialNumber": "string", "status": "string", "subjectAlternativeNames": [ "string" ], "supportCode": "string", "tags": [ {
API Version 2016-11-2833
Amazon Lightsail API ReferenceResponse Elements
"key": "string", "value": "string" } ] }, "certificateName": "string", "domainName": "string", "tags": [ { "key": "string", "value": "string" } ] }, "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
certificate (p. 33)
An object that describes the certificate created.
Type: CertificateSummary (p. 450) objectoperations (p. 33)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
API Version 2016-11-2834
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2835
Amazon Lightsail API ReferenceCreateCloudFormationStack
CreateCloudFormationStackCreates an AWS CloudFormation stack, which creates a new Amazon EC2 instance from an exportedAmazon Lightsail snapshot. This operation results in a CloudFormation stack record that can be usedto track the AWS CloudFormation stack created. Use the get cloud formation stack recordsoperation to get a list of the CloudFormation stacks created.
ImportantWait until after your new Amazon EC2 instance is created before running the create cloudformation stack operation again with the same export snapshot record.
Request Syntax{ "instances": [ { "availabilityZone": "string", "instanceType": "string", "portInfoSource": "string", "sourceName": "string", "userData": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instances (p. 36)
An array of parameters that will be used to create the new Amazon EC2 instance. You can only passone instance entry at a time in this array. You will get an invalid parameter error if you pass morethan one instance entry in this array.
Type: Array of InstanceEntry (p. 487) objects
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" },
API Version 2016-11-2836
Amazon Lightsail API ReferenceResponse Elements
"operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 36)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-2837
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2838
Amazon Lightsail API ReferenceCreateContactMethod
CreateContactMethodCreates an email or SMS text message contact method.
A contact method is used to send you notifications about your Amazon Lightsail resources. You can addone email address and one mobile phone number contact method in each AWS Region. However, SMStext messaging is not supported in some AWS Regions, and SMS text messages cannot be sent to somecountries/regions. For more information, see Notifications in Amazon Lightsail.
Request Syntax{ "contactEndpoint": "string", "protocol": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
contactEndpoint (p. 39)
The destination of the contact method, such as an email address or a mobile phone number.
Use the E.164 format when specifying a mobile phone number. E.164 is a standard for the phonenumber structure used for international telecommunication. Phone numbers that follow this formatcan have a maximum of 15 digits, and they are prefixed with the plus character (+) and the countrycode. For example, a U.S. phone number in E.164 format would be specified as +1XXX5550100. Formore information, see E.164 on Wikipedia.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 256.
Required: Yesprotocol (p. 39)
The protocol of the contact method, such as Email or SMS (text messaging).
The SMS protocol is supported only in the following AWS Regions.• US East (N. Virginia) (us-east-1)• US West (Oregon) (us-west-2)• Europe (Ireland) (eu-west-1)• Asia Pacific (Tokyo) (ap-northeast-1)• Asia Pacific (Singapore) (ap-southeast-1)• Asia Pacific (Sydney) (ap-southeast-2)
For a list of countries/regions where SMS text messages can be sent, and the latest AWS Regionswhere SMS text messaging is supported, see Supported Regions and Countries in the Amazon SNSDeveloper Guide.
For more information about notifications in Amazon Lightsail, see Notifications in Amazon Lightsail.
API Version 2016-11-2839
Amazon Lightsail API ReferenceResponse Syntax
Type: String
Valid Values: Email | SMS
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 40)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-2840
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2841
Amazon Lightsail API ReferenceCreateDisk
CreateDiskCreates a block storage disk that can be attached to an Amazon Lightsail instance in the sameAvailability Zone (e.g., us-east-2a).
The create disk operation supports tag-based access control via request tags. For more information,see the Lightsail Dev Guide.
Request Syntax{ "addOns": [ { "addOnType": "string", "autoSnapshotAddOnRequest": { "snapshotTimeOfDay": "string" } } ], "availabilityZone": "string", "diskName": "string", "sizeInGb": number, "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
addOns (p. 42)
An array of objects that represent the add-ons to enable for the new disk.
Type: Array of AddOnRequest (p. 427) objects
Required: NoavailabilityZone (p. 42)
The Availability Zone where you want to create the disk (e.g., us-east-2a). Use the sameAvailability Zone as the Lightsail instance to which you want to attach the disk.
Use the get regions operation to list the Availability Zones where Lightsail is currently available.
Type: String
Pattern: .*\S.*
Required: YesdiskName (p. 42)
The unique Lightsail disk name (e.g., my-disk).
API Version 2016-11-2842
Amazon Lightsail API ReferenceResponse Syntax
Type: String
Pattern: \w[\w\-]*\w
Required: YessizeInGb (p. 42)
The size of the disk in GB (e.g., 32).
Type: Integer
Required: Yestags (p. 42)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 43)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
API Version 2016-11-2843
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-2844
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2845
Amazon Lightsail API ReferenceCreateDiskFromSnapshot
CreateDiskFromSnapshotCreates a block storage disk from a manual or automatic snapshot of a disk. The resulting disk can beattached to an Amazon Lightsail instance in the same Availability Zone (e.g., us-east-2a).
The create disk from snapshot operation supports tag-based access control via request tags andresource tags applied to the resource identified by disk snapshot name. For more information, seethe Lightsail Dev Guide.
Request Syntax{ "addOns": [ { "addOnType": "string", "autoSnapshotAddOnRequest": { "snapshotTimeOfDay": "string" } } ], "availabilityZone": "string", "diskName": "string", "diskSnapshotName": "string", "restoreDate": "string", "sizeInGb": number, "sourceDiskName": "string", "tags": [ { "key": "string", "value": "string" } ], "useLatestRestorableAutoSnapshot": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
addOns (p. 46)
An array of objects that represent the add-ons to enable for the new disk.
Type: Array of AddOnRequest (p. 427) objects
Required: NoavailabilityZone (p. 46)
The Availability Zone where you want to create the disk (e.g., us-east-2a). Choose the sameAvailability Zone as the Lightsail instance where you want to create the disk.
Use the GetRegions operation to list the Availability Zones where Lightsail is currently available.
Type: String
Pattern: .*\S.*
API Version 2016-11-2846
Amazon Lightsail API ReferenceRequest Parameters
Required: YesdiskName (p. 46)
The unique Lightsail disk name (e.g., my-disk).
Type: String
Pattern: \w[\w\-]*\w
Required: YesdiskSnapshotName (p. 46)
The name of the disk snapshot (e.g., my-snapshot) from which to create the new storage disk.
Constraint:• This parameter cannot be defined together with the source disk name parameter. The disksnapshot name and source disk name parameters are mutually exclusive.
Type: String
Pattern: \w[\w\-]*\w
Required: NorestoreDate (p. 46)
The date of the automatic snapshot to use for the new disk. Use the get auto snapshotsoperation to identify the dates of the available automatic snapshots.
Constraints:• Must be specified in YYYY-MM-DD format.• This parameter cannot be defined together with the use latest restorable autosnapshot parameter. The restore date and use latest restorable auto snapshotparameters are mutually exclusive.
• Define this parameter only when creating a new disk from an automatic snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: String
Required: NosizeInGb (p. 46)
The size of the disk in GB (e.g., 32).
Type: Integer
Required: YessourceDiskName (p. 46)
The name of the source disk from which the source automatic snapshot was created.
Constraints:• This parameter cannot be defined together with the disk snapshot name parameter. Thesource disk name and disk snapshot name parameters are mutually exclusive.
• Define this parameter only when creating a new disk from an automatic snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: String
API Version 2016-11-2847
Amazon Lightsail API ReferenceResponse Syntax
Required: Notags (p. 46)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: NouseLatestRestorableAutoSnapshot (p. 46)
A Boolean value to indicate whether to use the latest available automatic snapshot.
Constraints:• This parameter cannot be defined together with the restore date parameter. The use latestrestorable auto snapshot and restore date parameters are mutually exclusive.
• Define this parameter only when creating a new disk from an automatic snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: Boolean
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 48)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
API Version 2016-11-2848
Amazon Lightsail API ReferenceErrors
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++
API Version 2016-11-2849
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2850
Amazon Lightsail API ReferenceCreateDiskSnapshot
CreateDiskSnapshotCreates a snapshot of a block storage disk. You can use snapshots for backups, to make copies of disks,and to save data before shutting down a Lightsail instance.
You can take a snapshot of an attached disk that is in use; however, snapshots only capture data thathas been written to your disk at the time the snapshot command is issued. This may exclude any datathat has been cached by any applications or the operating system. If you can pause any file systems onthe disk long enough to take a snapshot, your snapshot should be complete. Nevertheless, if you cannotpause all file writes to the disk, you should unmount the disk from within the Lightsail instance, issuethe create disk snapshot command, and then remount the disk to ensure a consistent and completesnapshot. You may remount and use your disk while the snapshot status is pending.
You can also use this operation to create a snapshot of an instance's system volume. You might want todo this, for example, to recover data from the system volume of a botched instance or to create a backupof the system volume like you would for a block storage disk. To create a snapshot of a system volume,just define the instance name parameter when issuing the snapshot command, and a snapshot of thedefined instance's system volume will be created. After the snapshot is available, you can create a blockstorage disk from the snapshot and attach it to a running instance to access the data on the disk.
The create disk snapshot operation supports tag-based access control via request tags. For moreinformation, see the Lightsail Dev Guide.
Request Syntax{ "diskName": "string", "diskSnapshotName": "string", "instanceName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskName (p. 51)
The unique name of the source disk (e.g., Disk-Virginia-1).
NoteThis parameter cannot be defined together with the instance name parameter. The diskname and instance name parameters are mutually exclusive.
Type: String
Pattern: \w[\w\-]*\w
Required: No
API Version 2016-11-2851
Amazon Lightsail API ReferenceResponse Syntax
diskSnapshotName (p. 51)
The name of the destination disk snapshot (e.g., my-disk-snapshot) based on the source disk.
Type: String
Pattern: \w[\w\-]*\w
Required: YesinstanceName (p. 51)
The unique name of the source instance (e.g., Amazon_Linux-512MB-Virginia-1). When this isdefined, a snapshot of the instance's system volume is created.
NoteThis parameter cannot be defined together with the disk name parameter. The instancename and disk name parameters are mutually exclusive.
Type: String
Pattern: \w[\w\-]*\w
Required: Notags (p. 51)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-2852
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
operations (p. 52)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-2853
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2854
Amazon Lightsail API ReferenceCreateDistribution
CreateDistributionCreates an Amazon Lightsail content delivery network (CDN) distribution.
A distribution is a globally distributed network of caching servers that improve the performance of yourwebsite or web application hosted on a Lightsail instance. For more information, see Content deliverynetworks in Amazon Lightsail.
Request Syntax{ "bundleId": "string", "cacheBehaviors": [ { "behavior": "string", "path": "string" } ], "cacheBehaviorSettings": { "allowedHTTPMethods": "string", "cachedHTTPMethods": "string", "defaultTTL": number, "forwardedCookies": { "cookiesAllowList": [ "string" ], "option": "string" }, "forwardedHeaders": { "headersAllowList": [ "string" ], "option": "string" }, "forwardedQueryStrings": { "option": boolean, "queryStringsAllowList": [ "string" ] }, "maximumTTL": number, "minimumTTL": number }, "defaultCacheBehavior": { "behavior": "string" }, "distributionName": "string", "origin": { "name": "string", "protocolPolicy": "string", "regionName": "string" }, "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
API Version 2016-11-2855
Amazon Lightsail API ReferenceRequest Parameters
bundleId (p. 55)
The bundle ID to use for the distribution.
A distribution bundle describes the specifications of your distribution, such as the monthly cost andmonthly network transfer quota.
Use the GetDistributionBundles action to get a list of distribution bundle IDs that you canspecify.
Type: String
Required: Yes
cacheBehaviors (p. 55)
An array of objects that describe the per-path cache behavior for the distribution.
Type: Array of CacheBehaviorPerPath (p. 442) objects
Required: No
cacheBehaviorSettings (p. 55)
An object that describes the cache behavior settings for the distribution.
Type: CacheSettings (p. 444) object
Required: No
defaultCacheBehavior (p. 55)
An object that describes the default cache behavior for the distribution.
Type: CacheBehavior (p. 441) object
Required: Yes
distributionName (p. 55)
The name for the distribution.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
origin (p. 55)
An object that describes the origin resource for the distribution, such as a Lightsail instance or loadbalancer.
The distribution pulls, caches, and serves content from the origin.
Type: InputOrigin (p. 480) object
Required: Yes
tags (p. 55)
The tag keys and optional values to add to the distribution during create.
Use the TagResource action to tag a resource after it's created.
API Version 2016-11-2856
Amazon Lightsail API ReferenceResponse Syntax
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "distribution": { "ableToUpdateBundle": boolean, "alternativeDomainNames": [ "string" ], "arn": "string", "bundleId": "string", "cacheBehaviors": [ { "behavior": "string", "path": "string" } ], "cacheBehaviorSettings": { "allowedHTTPMethods": "string", "cachedHTTPMethods": "string", "defaultTTL": number, "forwardedCookies": { "cookiesAllowList": [ "string" ], "option": "string" }, "forwardedHeaders": { "headersAllowList": [ "string" ], "option": "string" }, "forwardedQueryStrings": { "option": boolean, "queryStringsAllowList": [ "string" ] }, "maximumTTL": number, "minimumTTL": number }, "certificateName": "string", "createdAt": number, "defaultCacheBehavior": { "behavior": "string" }, "domainName": "string", "isEnabled": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "origin": { "name": "string", "protocolPolicy": "string", "regionName": "string", "resourceType": "string" }, "originPublicDNS": "string", "resourceType": "string", "status": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string"
API Version 2016-11-2857
Amazon Lightsail API ReferenceResponse Elements
} ] }, "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
distribution (p. 57)
An object that describes the distribution created.
Type: LightsailDistribution (p. 505) objectoperation (p. 57)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-2858
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2859
Amazon Lightsail API ReferenceCreateDomain
CreateDomainCreates a domain resource for the specified domain (e.g., example.com).
The create domain operation supports tag-based access control via request tags. For moreinformation, see the Lightsail Dev Guide.
Request Syntax{ "domainName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
domainName (p. 60)
The domain name to manage (e.g., example.com).
NoteYou cannot register a new domain name using Lightsail. You must register a domain nameusing Amazon Route 53 or another domain name registrar. If you have already registeredyour domain, you can enter its name in this parameter to manage the DNS records for thatdomain.
Type: String
Required: Yestags (p. 60)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string",
API Version 2016-11-2860
Amazon Lightsail API ReferenceResponse Elements
"id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 60)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-2861
Amazon Lightsail API ReferenceSee Also
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2862
Amazon Lightsail API ReferenceCreateDomainEntry
CreateDomainEntryCreates one of the following entry records associated with the domain: Address (A), canonical name(CNAME), mail exchanger (MX), name server (NS), start of authority (SOA), service locator (SRV), or text(TXT).
The create domain entry operation supports tag-based access control via resource tags applied tothe resource identified by domain name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "domainEntry": { "id": "string", "isAlias": boolean, "name": "string", "options": { "string" : "string" }, "target": "string", "type": "string" }, "domainName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
domainEntry (p. 63)
An array of key-value pairs containing information about the domain entry request.
Type: DomainEntry (p. 470) object
Required: YesdomainName (p. 63)
The domain name (e.g., example.com) for which you want to create the domain entry.
Type: String
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean,
API Version 2016-11-2863
Amazon Lightsail API ReferenceResponse Elements
"location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 63)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-2864
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2865
Amazon Lightsail API ReferenceCreateInstances
CreateInstancesCreates one or more Amazon Lightsail instances.
The create instances operation supports tag-based access control via request tags. For moreinformation, see the Lightsail Dev Guide.
Request Syntax{ "addOns": [ { "addOnType": "string", "autoSnapshotAddOnRequest": { "snapshotTimeOfDay": "string" } } ], "availabilityZone": "string", "blueprintId": "string", "bundleId": "string", "customImageName": "string", "instanceNames": [ "string" ], "keyPairName": "string", "tags": [ { "key": "string", "value": "string" } ], "userData": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
addOns (p. 66)
An array of objects representing the add-ons to enable for the new instance.
Type: Array of AddOnRequest (p. 427) objects
Required: NoavailabilityZone (p. 66)
The Availability Zone in which to create your instance. Use the following format: us-east-2a (casesensitive). You can get a list of Availability Zones by using the get regions operation. Be sure to addthe include Availability Zones parameter to your request.
Type: String
Required: YesblueprintId (p. 66)
The ID for a virtual private server image (e.g., app_wordpress_4_4 or app_lamp_7_0). Use theget blueprints operation to return a list of available images (or blueprints).
API Version 2016-11-2866
Amazon Lightsail API ReferenceRequest Parameters
NoteUse active blueprints when creating new instances. Inactive blueprints are listed to supportcustomers with existing instances and are not necessarily available to create new instances.Blueprints are marked inactive when they become outdated due to operating systemupdates or new application releases.
Type: String
Pattern: .*\S.*
Required: YesbundleId (p. 66)
The bundle of specification information for your virtual private server (or instance), including thepricing plan (e.g., micro_1_0).
Type: String
Pattern: .*\S.*
Required: YescustomImageName (p. 66)
(Deprecated) The name for your custom image.
NoteIn releases prior to June 12, 2017, this parameter was ignored by the API. It is nowdeprecated.
Type: String
Pattern: \w[\w\-]*\w
Required: NoinstanceNames (p. 66)
The names to use for your new Lightsail instances. Separate multiple values using quotation marksand commas, for example: ["MyFirstInstance","MySecondInstance"]
Type: Array of strings
Required: YeskeyPairName (p. 66)
The name of your key pair.
Type: String
Pattern: \w[\w\-]*\w
Required: Notags (p. 66)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
API Version 2016-11-2867
Amazon Lightsail API ReferenceResponse Syntax
userData (p. 66)
A launch script you can create that configures a server with additional user data. For example, youmight want to run apt-get -y update.
NoteDepending on the machine image you choose, the command to get software on yourinstance varies. Amazon Linux and CentOS use yum, Debian and Ubuntu use apt-get, andFreeBSD uses pkg. For a complete list, see the Dev Guide.
Type: String
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 68)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
API Version 2016-11-2868
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2869
Amazon Lightsail API ReferenceCreateInstancesFromSnapshot
CreateInstancesFromSnapshotCreates one or more new instances from a manual or automatic snapshot of an instance.
The create instances from snapshot operation supports tag-based access control via requesttags and resource tags applied to the resource identified by instance snapshot name. For moreinformation, see the Lightsail Dev Guide.
Request Syntax
{ "addOns": [ { "addOnType": "string", "autoSnapshotAddOnRequest": { "snapshotTimeOfDay": "string" } } ], "attachedDiskMapping": { "string" : [ { "newDiskName": "string", "originalDiskPath": "string" } ] }, "availabilityZone": "string", "bundleId": "string", "instanceNames": [ "string" ], "instanceSnapshotName": "string", "keyPairName": "string", "restoreDate": "string", "sourceInstanceName": "string", "tags": [ { "key": "string", "value": "string" } ], "useLatestRestorableAutoSnapshot": boolean, "userData": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
addOns (p. 70)
An array of objects representing the add-ons to enable for the new instance.
Type: Array of AddOnRequest (p. 427) objects
Required: No
API Version 2016-11-2870
Amazon Lightsail API ReferenceRequest Parameters
attachedDiskMapping (p. 70)
An object containing information about one or more disk mappings.
Type: String to array of DiskMap (p. 462) objects map
Key Pattern: \w[\w\-]*\w
Required: No
availabilityZone (p. 70)
The Availability Zone where you want to create your instances. Use the following formatting: us-east-2a (case sensitive). You can get a list of Availability Zones by using the get regions operation.Be sure to add the include Availability Zones parameter to your request.
Type: String
Required: Yes
bundleId (p. 70)
The bundle of specification information for your virtual private server (or instance), including thepricing plan (e.g., micro_1_0).
Type: String
Pattern: .*\S.*
Required: Yes
instanceNames (p. 70)
The names for your new instances.
Type: Array of strings
Required: Yes
instanceSnapshotName (p. 70)
The name of the instance snapshot on which you are basing your new instances. Use the get instancesnapshots operation to return information about your existing snapshots.
Constraint:
• This parameter cannot be defined together with the source instance name parameter. Theinstance snapshot name and source instance name parameters are mutually exclusive.
Type: String
Pattern: \w[\w\-]*\w
Required: No
keyPairName (p. 70)
The name for your key pair.
Type: String
Pattern: \w[\w\-]*\w
Required: No
API Version 2016-11-2871
Amazon Lightsail API ReferenceRequest Parameters
restoreDate (p. 70)
The date of the automatic snapshot to use for the new instance. Use the get auto snapshotsoperation to identify the dates of the available automatic snapshots.
Constraints:
• Must be specified in YYYY-MM-DD format.
• This parameter cannot be defined together with the use latest restorable autosnapshot parameter. The restore date and use latest restorable auto snapshotparameters are mutually exclusive.
• Define this parameter only when creating a new instance from an automatic snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: String
Required: No
sourceInstanceName (p. 70)
The name of the source instance from which the source automatic snapshot was created.
Constraints:
• This parameter cannot be defined together with the instance snapshot name parameter. Thesource instance name and instance snapshot name parameters are mutually exclusive.
• Define this parameter only when creating a new instance from an automatic snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: String
Required: No
tags (p. 70)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
useLatestRestorableAutoSnapshot (p. 70)
A Boolean value to indicate whether to use the latest available automatic snapshot.
Constraints:
• This parameter cannot be defined together with the restore date parameter. The use latestrestorable auto snapshot and restore date parameters are mutually exclusive.
• Define this parameter only when creating a new instance from an automatic snapshot. For moreinformation, see the Lightsail Dev Guide.
Type: Boolean
Required: No
userData (p. 70)
You can create a launch script that configures a server with additional user data. For example, apt-get -y update.
API Version 2016-11-2872
Amazon Lightsail API ReferenceResponse Syntax
NoteDepending on the machine image you choose, the command to get software on yourinstance varies. Amazon Linux and CentOS use yum, Debian and Ubuntu use apt-get, andFreeBSD uses pkg. For a complete list, see the Dev Guide.
Type: String
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 73)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400
API Version 2016-11-2873
Amazon Lightsail API ReferenceSee Also
AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2874
Amazon Lightsail API ReferenceCreateInstanceSnapshot
CreateInstanceSnapshotCreates a snapshot of a specific virtual private server, or instance. You can use a snapshot to create a newinstance that is based on that snapshot.
The create instance snapshot operation supports tag-based access control via request tags. Formore information, see the Lightsail Dev Guide.
Request Syntax
{ "instanceName": "string", "instanceSnapshotName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 75)
The Lightsail instance on which to base your snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
instanceSnapshotName (p. 75)
The name for your new snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
tags (p. 75)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
API Version 2016-11-2875
Amazon Lightsail API ReferenceResponse Syntax
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 76)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400
AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-2876
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2877
Amazon Lightsail API ReferenceCreateKeyPair
CreateKeyPairCreates an SSH key pair.
The create key pair operation supports tag-based access control via request tags. For moreinformation, see the Lightsail Dev Guide.
Request Syntax
{ "keyPairName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
keyPairName (p. 78)
The name for your new key pair.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
tags (p. 78)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax
{ "keyPair": { "arn": "string", "createdAt": number, "fingerprint": "string", "location": { "availabilityZone": "string",
API Version 2016-11-2878
Amazon Lightsail API ReferenceResponse Elements
"regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }, "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }, "privateKeyBase64": "string", "publicKeyBase64": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
keyPair (p. 78)
An array of key-value pairs containing information about the new key pair you just created.
Type: KeyPair (p. 503) object
operation (p. 78)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
privateKeyBase64 (p. 78)
A base64-encoded RSA private key.
Type: String
publicKeyBase64 (p. 78)
A base64-encoded public key of the ssh-rsa type.
Type: String
API Version 2016-11-2879
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-2880
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2881
Amazon Lightsail API ReferenceCreateLoadBalancer
CreateLoadBalancerCreates a Lightsail load balancer. To learn more about deciding whether to load balance your application,see Configure your Lightsail instances for load balancing. You can create up to 5 load balancers per AWSRegion in your account.
When you create a load balancer, you can specify a unique name and port settings. To change additionalload balancer settings, use the UpdateLoadBalancerAttribute operation.
The create load balancer operation supports tag-based access control via request tags. For moreinformation, see the Lightsail Dev Guide.
Request Syntax{ "certificateAlternativeNames": [ "string" ], "certificateDomainName": "string", "certificateName": "string", "healthCheckPath": "string", "instancePort": number, "loadBalancerName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateAlternativeNames (p. 82)
The optional alternative domains and subdomains to use with your SSL/TLS certificate (e.g.,www.example.com, example.com, m.example.com, blog.example.com).
Type: Array of strings
Required: NocertificateDomainName (p. 82)
The domain name with which your certificate is associated (e.g., example.com).
If you specify certificateDomainName, then certificateName is required (and vice-versa).
Type: String
Required: NocertificateName (p. 82)
The name of the SSL/TLS certificate.
If you specify certificateName, then certificateDomainName is required (and vice-versa).
API Version 2016-11-2882
Amazon Lightsail API ReferenceResponse Syntax
Type: String
Pattern: \w[\w\-]*\w
Required: NohealthCheckPath (p. 82)
The path you provided to perform the load balancer health check. If you didn't specify a healthcheck path, Lightsail uses the root path of your website (e.g., "/").
You may want to specify a custom health check path other than the root of your application if yourhome page loads slowly or has a lot of media or scripting on it.
Type: String
Required: NoinstancePort (p. 82)
The instance port where you're creating your load balancer.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: YesloadBalancerName (p. 82)
The name of your load balancer.
Type: String
Pattern: \w[\w\-]*\w
Required: Yestags (p. 82)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string",
API Version 2016-11-2883
Amazon Lightsail API ReferenceResponse Elements
"operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 83)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-2884
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2885
Amazon Lightsail API ReferenceCreateLoadBalancerTlsCertificate
CreateLoadBalancerTlsCertificateCreates a Lightsail load balancer TLS certificate.
TLS is just an updated, more secure version of Secure Socket Layer (SSL).
The CreateLoadBalancerTlsCertificate operation supports tag-based access control via resourcetags applied to the resource identified by load balancer name. For more information, see theLightsail Dev Guide.
Request Syntax{ "certificateAlternativeNames": [ "string" ], "certificateDomainName": "string", "certificateName": "string", "loadBalancerName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateAlternativeNames (p. 86)
An array of strings listing alternative domains and subdomains for your SSL/TLS certificate. Lightsailwill de-dupe the names for you. You can have a maximum of 9 alternative names (in addition to the1 primary domain). We do not support wildcards (e.g., *.example.com).
Type: Array of strings
Required: NocertificateDomainName (p. 86)
The domain name (e.g., example.com) for your SSL/TLS certificate.
Type: String
Required: YescertificateName (p. 86)
The SSL/TLS certificate name.
You can have up to 10 certificates in your account at one time. Each Lightsail load balancer can haveup to 2 certificates associated with it at one time. There is also an overall limit to the number ofcertificates that can be issue in a 365-day period. For more information, see Limits.
Type: String
API Version 2016-11-2886
Amazon Lightsail API ReferenceResponse Syntax
Pattern: \w[\w\-]*\w
Required: YesloadBalancerName (p. 86)
The load balancer name where you want to create the SSL/TLS certificate.
Type: String
Pattern: \w[\w\-]*\w
Required: Yestags (p. 86)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 87)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
API Version 2016-11-2887
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-2888
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2889
Amazon Lightsail API ReferenceCreateRelationalDatabase
CreateRelationalDatabaseCreates a new database in Amazon Lightsail.
The create relational database operation supports tag-based access control via request tags. Formore information, see the Lightsail Dev Guide.
Request Syntax{ "availabilityZone": "string", "masterDatabaseName": "string", "masterUsername": "string", "masterUserPassword": "string", "preferredBackupWindow": "string", "preferredMaintenanceWindow": "string", "publiclyAccessible": boolean, "relationalDatabaseBlueprintId": "string", "relationalDatabaseBundleId": "string", "relationalDatabaseName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
availabilityZone (p. 90)
The Availability Zone in which to create your new database. Use the us-east-2a case-sensitiveformat.
You can get a list of Availability Zones by using the get regions operation. Be sure to add theinclude relational database Availability Zones parameter to your request.
Type: String
Required: NomasterDatabaseName (p. 90)
The name of the master database created when the Lightsail database resource is created.
Constraints:• Must contain from 1 to 64 alphanumeric characters.• Cannot be a word reserved by the specified database engine
Type: String
Required: Yes
API Version 2016-11-2890
Amazon Lightsail API ReferenceRequest Parameters
masterUsername (p. 90)
The master user name for your new database.
Constraints:• Master user name is required.• Must contain from 1 to 16 alphanumeric characters.• The first character must be a letter.• Cannot be a reserved word for the database engine you choose.
For more information about reserved words in MySQL 5.6 or 5.7, see the Keywords and ReservedWords articles for MySQL 5.6 or MySQL 5.7 respectively.
Type: String
Required: YesmasterUserPassword (p. 90)
The password for the master user of your new database. The password can include any printableASCII character except "/", """, or "@".
Constraints: Must contain 8 to 41 characters.
Type: String
Required: NopreferredBackupWindow (p. 90)
The daily time range during which automated backups are created for your new database ifautomated backups are enabled.
The default is a 30-minute window selected at random from an 8-hour block of time for each AWSRegion. For more information about the preferred backup window time blocks for each region,see the Working With Backups guide in the Amazon Relational Database Service (Amazon RDS)documentation.
Constraints:• Must be in the hh24:mi-hh24:mi format.
Example: 16:00-16:30• Specified in Coordinated Universal Time (UTC).• Must not conflict with the preferred maintenance window.• Must be at least 30 minutes.
Type: String
Required: NopreferredMaintenanceWindow (p. 90)
The weekly time range during which system maintenance can occur on your new database.
The default is a 30-minute window selected at random from an 8-hour block of time for each AWSRegion, occurring on a random day of the week.
Constraints:• Must be in the ddd:hh24:mi-ddd:hh24:mi format.
API Version 2016-11-2891
Amazon Lightsail API ReferenceRequest Parameters
• Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.• Must be at least 30 minutes.• Specified in Coordinated Universal Time (UTC).• Example: Tue:17:00-Tue:17:30
Type: String
Required: NopubliclyAccessible (p. 90)
Specifies the accessibility options for your new database. A value of true specifies a database that isavailable to resources outside of your Lightsail account. A value of false specifies a database that isavailable only to your Lightsail resources in the same region as your database.
Type: Boolean
Required: NorelationalDatabaseBlueprintId (p. 90)
The blueprint ID for your new database. A blueprint describes the major engine version of adatabase.
You can get a list of database blueprints IDs by using the get relational databaseblueprints operation.
Type: String
Required: YesrelationalDatabaseBundleId (p. 90)
The bundle ID for your new database. A bundle describes the performance specifications for yourdatabase.
You can get a list of database bundle IDs by using the get relational database bundlesoperation.
Type: String
Required: YesrelationalDatabaseName (p. 90)
The name to use for your new database.
Constraints:• Must contain from 2 to 255 alphanumeric characters, or hyphens.• The first and last character must be a letter or number.
Type: String
Pattern: \w[\w\-]*\w
Required: Yestags (p. 90)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
API Version 2016-11-2892
Amazon Lightsail API ReferenceResponse Syntax
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 93)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400
AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
API Version 2016-11-2893
Amazon Lightsail API ReferenceSee Also
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2894
Amazon Lightsail API ReferenceCreateRelationalDatabaseFromSnapshot
CreateRelationalDatabaseFromSnapshotCreates a new database from an existing database snapshot in Amazon Lightsail.
You can create a new database from a snapshot in if something goes wrong with your original database,or to change it to a different plan, such as a high availability or standard plan.
The create relational database from snapshot operation supports tag-basedaccess control via request tags and resource tags applied to the resource identified byrelationalDatabaseSnapshotName. For more information, see the Lightsail Dev Guide.
Request Syntax{ "availabilityZone": "string", "publiclyAccessible": boolean, "relationalDatabaseBundleId": "string", "relationalDatabaseName": "string", "relationalDatabaseSnapshotName": "string", "restoreTime": number, "sourceRelationalDatabaseName": "string", "tags": [ { "key": "string", "value": "string" } ], "useLatestRestorableTime": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
availabilityZone (p. 95)
The Availability Zone in which to create your new database. Use the us-east-2a case-sensitiveformat.
You can get a list of Availability Zones by using the get regions operation. Be sure to add theinclude relational database Availability Zones parameter to your request.
Type: String
Required: NopubliclyAccessible (p. 95)
Specifies the accessibility options for your new database. A value of true specifies a database that isavailable to resources outside of your Lightsail account. A value of false specifies a database that isavailable only to your Lightsail resources in the same region as your database.
Type: Boolean
Required: No
API Version 2016-11-2895
Amazon Lightsail API ReferenceRequest Parameters
relationalDatabaseBundleId (p. 95)
The bundle ID for your new database. A bundle describes the performance specifications for yourdatabase.
You can get a list of database bundle IDs by using the get relational database bundlesoperation.
When creating a new database from a snapshot, you cannot choose a bundle that is smaller than thebundle of the source database.
Type: String
Required: NorelationalDatabaseName (p. 95)
The name to use for your new database.
Constraints:• Must contain from 2 to 255 alphanumeric characters, or hyphens.• The first and last character must be a letter or number.
Type: String
Pattern: \w[\w\-]*\w
Required: YesrelationalDatabaseSnapshotName (p. 95)
The name of the database snapshot from which to create your new database.
Type: String
Pattern: \w[\w\-]*\w
Required: NorestoreTime (p. 95)
The date and time to restore your database from.
Constraints:• Must be before the latest restorable time for the database.• Cannot be specified if the use latest restorable time parameter is true.• Specified in Coordinated Universal Time (UTC).• Specified in the Unix time format.
For example, if you wish to use a restore time of October 1, 2018, at 8 PM UTC, then you input1538424000 as the restore time.
Type: Timestamp
Required: NosourceRelationalDatabaseName (p. 95)
The name of the source database.
Type: String
Pattern: \w[\w\-]*\w
API Version 2016-11-2896
Amazon Lightsail API ReferenceResponse Syntax
Required: Notags (p. 95)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
Type: Array of Tag (p. 563) objects
Required: NouseLatestRestorableTime (p. 95)
Specifies whether your database is restored from the latest backup time. A value of true restoresfrom the latest backup time.
Default: false
Constraints: Cannot be specified if the restore time parameter is provided.
Type: Boolean
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 97)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
API Version 2016-11-2897
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-2898
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-2899
Amazon Lightsail API ReferenceCreateRelationalDatabaseSnapshot
CreateRelationalDatabaseSnapshotCreates a snapshot of your database in Amazon Lightsail. You can use snapshots for backups, to makecopies of a database, and to save data before deleting a database.
The create relational database snapshot operation supports tag-based access control viarequest tags. For more information, see the Lightsail Dev Guide.
Request Syntax{ "relationalDatabaseName": "string", "relationalDatabaseSnapshotName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseName (p. 100)
The name of the database on which to base your new snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
relationalDatabaseSnapshotName (p. 100)
The name for your new database snapshot.
Constraints:
• Must contain from 2 to 255 alphanumeric characters, or hyphens.
• The first and last character must be a letter or number.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
tags (p. 100)
The tag keys and optional values to add to the resource during create.
Use the TagResource action to tag a resource after it's created.
API Version 2016-11-28100
Amazon Lightsail API ReferenceResponse Syntax
Type: Array of Tag (p. 563) objects
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 101)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400
AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
API Version 2016-11-28101
Amazon Lightsail API ReferenceSee Also
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28102
Amazon Lightsail API ReferenceDeleteAlarm
DeleteAlarmDeletes an alarm.
An alarm is used to monitor a single metric for one of your resources. When a metric condition is met,the alarm can notify you by email, SMS text message, and a banner displayed on the Amazon Lightsailconsole. For more information, see Alarms in Amazon Lightsail.
Request Syntax
{ "alarmName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
alarmName (p. 103)
The name of the alarm to delete.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax
{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28103
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 103)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28104
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28105
Amazon Lightsail API ReferenceDeleteAutoSnapshot
DeleteAutoSnapshotDeletes an automatic snapshot of an instance or disk. For more information, see the Lightsail Dev Guide.
Request Syntax{ "date": "string", "resourceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
date (p. 106)
The date of the automatic snapshot to delete in YYYY-MM-DD format. Use the get autosnapshots operation to get the available automatic snapshots for a resource.
Type: String
Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Required: YesresourceName (p. 106)
The name of the source instance or disk from which to delete the automatic snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string",
API Version 2016-11-28106
Amazon Lightsail API ReferenceResponse Elements
"status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 106)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
API Version 2016-11-28107
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28108
Amazon Lightsail API ReferenceDeleteCertificate
DeleteCertificateDeletes an SSL/TLS certificate for your Amazon Lightsail content delivery network (CDN) distribution.
Certificates that are currently attached to a distribution cannot be deleted. Use theDetachCertificateFromDistribution action to detach a certificate from a distribution.
Request Syntax{ "certificateName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateName (p. 109)
The name of the certificate to delete.
Use the GetCertificates action to get a list of certificate names that you can specify.
Type: String
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28109
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
operations (p. 109)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-28110
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28111
Amazon Lightsail API ReferenceDeleteContactMethod
DeleteContactMethodDeletes a contact method.
A contact method is used to send you notifications about your Amazon Lightsail resources. You can addone email address and one mobile phone number contact method in each AWS Region. However, SMStext messaging is not supported in some AWS Regions, and SMS text messages cannot be sent to somecountries/regions. For more information, see Notifications in Amazon Lightsail.
Request Syntax{ "protocol": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
protocol (p. 112)
The protocol that will be deleted, such as Email or SMS (text messaging).
NoteTo delete an Email and an SMS contact method if you added both, you must run separateDeleteContactMethod actions to delete each protocol.
Type: String
Valid Values: Email | SMS
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number
API Version 2016-11-28112
Amazon Lightsail API ReferenceResponse Elements
} ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 112)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28113
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28114
Amazon Lightsail API ReferenceDeleteDisk
DeleteDiskDeletes the specified block storage disk. The disk must be in the available state (not attached to aLightsail instance).
NoteThe disk may remain in the deleting state for several minutes.
The delete disk operation supports tag-based access control via resource tags applied to the resourceidentified by disk name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "diskName": "string", "forceDeleteAddOns": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskName (p. 115)
The unique name of the disk you want to delete (e.g., my-disk).
Type: String
Pattern: \w[\w\-]*\w
Required: YesforceDeleteAddOns (p. 115)
A Boolean value to indicate whether to delete the enabled add-ons for the disk.
Type: Boolean
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" },
API Version 2016-11-28115
Amazon Lightsail API ReferenceResponse Elements
"operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 115)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-28116
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28117
Amazon Lightsail API ReferenceDeleteDiskSnapshot
DeleteDiskSnapshotDeletes the specified disk snapshot.
When you make periodic snapshots of a disk, the snapshots are incremental, and only the blocks onthe device that have changed since your last snapshot are saved in the new snapshot. When you deletea snapshot, only the data not needed for any other snapshot is removed. So regardless of which priorsnapshots have been deleted, all active snapshots will have access to all the information needed torestore the disk.
The delete disk snapshot operation supports tag-based access control via resource tags applied tothe resource identified by disk snapshot name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "diskSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskSnapshotName (p. 118)
The name of the disk snapshot you want to delete (e.g., my-disk-snapshot).
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number
API Version 2016-11-28118
Amazon Lightsail API ReferenceResponse Elements
} ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 118)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28119
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28120
Amazon Lightsail API ReferenceDeleteDistribution
DeleteDistributionDeletes your Amazon Lightsail content delivery network (CDN) distribution.
Request Syntax{ "distributionName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
distributionName (p. 121)
The name of the distribution to delete.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
Required: No
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28121
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
operation (p. 121)
An object that describes the result of the action, such as the status of the request, the timestamp ofthe request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET
API Version 2016-11-28122
Amazon Lightsail API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28123
Amazon Lightsail API ReferenceDeleteDomain
DeleteDomainDeletes the specified domain recordset and all of its domain records.
The delete domain operation supports tag-based access control via resource tags applied to theresource identified by domain name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "domainName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
domainName (p. 124)
The specific domain name to delete.
Type: String
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28124
Amazon Lightsail API ReferenceErrors
operation (p. 124)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28125
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28126
Amazon Lightsail API ReferenceDeleteDomainEntry
DeleteDomainEntryDeletes a specific domain entry.
The delete domain entry operation supports tag-based access control via resource tags applied tothe resource identified by domain name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "domainEntry": { "id": "string", "isAlias": boolean, "name": "string", "options": { "string" : "string" }, "target": "string", "type": "string" }, "domainName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
domainEntry (p. 127)
An array of key-value pairs containing information about your domain entries.
Type: DomainEntry (p. 470) object
Required: YesdomainName (p. 127)
The name of the domain entry to delete.
Type: String
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string",
API Version 2016-11-28127
Amazon Lightsail API ReferenceResponse Elements
"regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 127)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28128
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28129
Amazon Lightsail API ReferenceDeleteInstance
DeleteInstanceDeletes an Amazon Lightsail instance.
The delete instance operation supports tag-based access control via resource tags applied to theresource identified by instance name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "forceDeleteAddOns": boolean, "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
forceDeleteAddOns (p. 130)
A Boolean value to indicate whether to delete the enabled add-ons for the disk.
Type: Boolean
Required: NoinstanceName (p. 130)
The name of the instance to delete.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string",
API Version 2016-11-28130
Amazon Lightsail API ReferenceResponse Elements
"status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 130)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
API Version 2016-11-28131
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28132
Amazon Lightsail API ReferenceDeleteInstanceSnapshot
DeleteInstanceSnapshotDeletes a specific snapshot of a virtual private server (or instance).
The delete instance snapshot operation supports tag-based access control via resource tagsapplied to the resource identified by instance snapshot name. For more information, see theLightsail Dev Guide.
Request Syntax
{ "instanceSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceSnapshotName (p. 133)
The name of the snapshot to delete.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax
{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28133
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 133)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28134
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28135
Amazon Lightsail API ReferenceDeleteKeyPair
DeleteKeyPairDeletes a specific SSH key pair.
The delete key pair operation supports tag-based access control via resource tags applied to theresource identified by key pair name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "keyPairName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
keyPairName (p. 136)
The name of the key pair to delete.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28136
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
operation (p. 136)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28137
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28138
Amazon Lightsail API ReferenceDeleteKnownHostKeys
DeleteKnownHostKeysDeletes the known host key or certificate used by the Amazon Lightsail browser-based SSH or RDPclients to authenticate an instance. This operation enables the Lightsail browser-based SSH or RDPclients to connect to the instance after a host key mismatch.
ImportantPerform this operation only if you were expecting the host key or certificate mismatch or ifyou are familiar with the new host key or certificate on the instance. For more information, seeTroubleshooting connection issues when using the Amazon Lightsail browser-based SSH or RDPclient.
Request Syntax{ "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 139)
The name of the instance for which you want to reset the host key or certificate.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }
API Version 2016-11-28139
Amazon Lightsail API ReferenceResponse Elements
]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 139)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28140
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28141
Amazon Lightsail API ReferenceDeleteLoadBalancer
DeleteLoadBalancerDeletes a Lightsail load balancer and all its associated SSL/TLS certificates. Once the load balanceris deleted, you will need to create a new load balancer, create a new certificate, and verify domainownership again.
The delete load balancer operation supports tag-based access control via resource tags applied tothe resource identified by load balancer name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
loadBalancerName (p. 142)
The name of the load balancer you want to delete.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28142
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 142)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28143
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28144
Amazon Lightsail API ReferenceDeleteLoadBalancerTlsCertificate
DeleteLoadBalancerTlsCertificateDeletes an SSL/TLS certificate associated with a Lightsail load balancer.
The DeleteLoadBalancerTlsCertificate operation supports tag-based access control via resourcetags applied to the resource identified by load balancer name. For more information, see theLightsail Dev Guide.
Request Syntax{ "certificateName": "string", "force": boolean, "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateName (p. 145)
The SSL/TLS certificate name.
Type: String
Pattern: \w[\w\-]*\w
Required: Yesforce (p. 145)
When true, forces the deletion of an SSL/TLS certificate.
There can be two certificates associated with a Lightsail load balancer: the primary and the backup.The force parameter is required when the primary SSL/TLS certificate is in use by an instanceattached to the load balancer.
Type: Boolean
Required: NoloadBalancerName (p. 145)
The load balancer name.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{
API Version 2016-11-28145
Amazon Lightsail API ReferenceResponse Elements
"operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 145)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-28146
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28147
Amazon Lightsail API ReferenceDeleteRelationalDatabase
DeleteRelationalDatabaseDeletes a database in Amazon Lightsail.
The delete relational database operation supports tag-based access control via resource tagsapplied to the resource identified by relationalDatabaseName. For more information, see the LightsailDev Guide.
Request Syntax{ "finalRelationalDatabaseSnapshotName": "string", "relationalDatabaseName": "string", "skipFinalSnapshot": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
finalRelationalDatabaseSnapshotName (p. 148)
The name of the database snapshot created if skip final snapshot is false, which is thedefault value for that parameter.
NoteSpecifying this parameter and also specifying the skip final snapshot parameter totrue results in an error.
Constraints:• Must contain from 2 to 255 alphanumeric characters, or hyphens.• The first and last character must be a letter or number.
Type: String
Pattern: \w[\w\-]*\w
Required: NorelationalDatabaseName (p. 148)
The name of the database that you are deleting.
Type: String
Pattern: \w[\w\-]*\w
Required: YesskipFinalSnapshot (p. 148)
Determines whether a final database snapshot is created before your database is deleted. If trueis specified, no database snapshot is created. If false is specified, a database snapshot is createdbefore your database is deleted.
You must specify the final relational database snapshot name parameter if the skipfinal snapshot parameter is false.
API Version 2016-11-28148
Amazon Lightsail API ReferenceResponse Syntax
Default: false
Type: Boolean
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 149)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
API Version 2016-11-28149
Amazon Lightsail API ReferenceSee Also
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28150
Amazon Lightsail API ReferenceDeleteRelationalDatabaseSnapshot
DeleteRelationalDatabaseSnapshotDeletes a database snapshot in Amazon Lightsail.
The delete relational database snapshot operation supports tag-based access control viaresource tags applied to the resource identified by relationalDatabaseName. For more information, seethe Lightsail Dev Guide.
Request Syntax
{ "relationalDatabaseSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseSnapshotName (p. 151)
The name of the database snapshot that you are deleting.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax
{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28151
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 151)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28152
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28153
Amazon Lightsail API ReferenceDetachCertificateFromDistribution
DetachCertificateFromDistributionDetaches an SSL/TLS certificate from your Amazon Lightsail content delivery network (CDN) distribution.
After the certificate is detached, your distribution stops accepting traffic for all of the domains that areassociated with the certificate.
Request Syntax{ "distributionName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
distributionName (p. 154)
The name of the distribution from which to detach the certificate.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28154
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
operation (p. 154)
An object that describes the result of the action, such as the status of the request, the timestamp ofthe request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET
API Version 2016-11-28155
Amazon Lightsail API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28156
Amazon Lightsail API ReferenceDetachDisk
DetachDiskDetaches a stopped block storage disk from a Lightsail instance. Make sure to unmount any file systemson the device within your operating system before stopping the instance and detaching the disk.
The detach disk operation supports tag-based access control via resource tags applied to the resourceidentified by disk name. For more information, see the Lightsail Dev Guide.
Request Syntax
{ "diskName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskName (p. 157)
The unique name of the disk you want to detach from your instance (e.g., my-disk).
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax
{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28157
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 157)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28158
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28159
Amazon Lightsail API ReferenceDetachInstancesFromLoadBalancer
DetachInstancesFromLoadBalancerDetaches the specified instances from a Lightsail load balancer.
This operation waits until the instances are no longer needed before they are detached from the loadbalancer.
The detach instances from load balancer operation supports tag-based access control viaresource tags applied to the resource identified by load balancer name. For more information, seethe Lightsail Dev Guide.
Request Syntax{ "instanceNames": [ "string" ], "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceNames (p. 160)
An array of strings containing the names of the instances you want to detach from the load balancer.
Type: Array of strings
Pattern: \w[\w\-]*\w
Required: YesloadBalancerName (p. 160)
The name of the Lightsail load balancer.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string",
API Version 2016-11-28160
Amazon Lightsail API ReferenceResponse Elements
"regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 160)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28161
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28162
Amazon Lightsail API ReferenceDetachStaticIp
DetachStaticIpDetaches a static IP from the Amazon Lightsail instance to which it is attached.
Request Syntax{ "staticIpName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
staticIpName (p. 163)
The name of the static IP to detach from the instance.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28163
Amazon Lightsail API ReferenceErrors
operations (p. 163)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28164
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28165
Amazon Lightsail API ReferenceDisableAddOn
DisableAddOnDisables an add-on for an Amazon Lightsail resource. For more information, see the Lightsail Dev Guide.
Request Syntax{ "addOnType": "string", "resourceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
addOnType (p. 166)
The add-on type to disable.
Type: String
Valid Values: AutoSnapshot
Required: YesresourceName (p. 166)
The name of the source resource for which to disable the add-on.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string",
API Version 2016-11-28166
Amazon Lightsail API ReferenceResponse Elements
"statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 166)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28167
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28168
Amazon Lightsail API ReferenceDownloadDefaultKeyPair
DownloadDefaultKeyPairDownloads the default SSH key pair from the user's account.
Response Syntax{ "privateKeyBase64": "string", "publicKeyBase64": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
privateKeyBase64 (p. 169)
A base64-encoded RSA private key.
Type: StringpublicKeyBase64 (p. 169)
A base64-encoded public key of the ssh-rsa type.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-28169
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28170
Amazon Lightsail API ReferenceEnableAddOn
EnableAddOnEnables or modifies an add-on for an Amazon Lightsail resource. For more information, see the LightsailDev Guide.
Request Syntax{ "addOnRequest": { "addOnType": "string", "autoSnapshotAddOnRequest": { "snapshotTimeOfDay": "string" } }, "resourceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
addOnRequest (p. 171)
An array of strings representing the add-on to enable or modify.
Type: AddOnRequest (p. 427) object
Required: YesresourceName (p. 171)
The name of the source resource for which to enable or modify the add-on.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string",
API Version 2016-11-28171
Amazon Lightsail API ReferenceResponse Elements
"operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 171)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28172
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28173
Amazon Lightsail API ReferenceExportSnapshot
ExportSnapshotExports an Amazon Lightsail instance or block storage disk snapshot to Amazon Elastic Compute Cloud(Amazon EC2). This operation results in an export snapshot record that can be used with the createcloud formation stack operation to create new Amazon EC2 instances.
Exported instance snapshots appear in Amazon EC2 as Amazon Machine Images (AMIs), and the instancesystem disk appears as an Amazon Elastic Block Store (Amazon EBS) volume. Exported disk snapshotsappear in Amazon EC2 as Amazon EBS volumes. Snapshots are exported to the same Amazon WebServices Region in Amazon EC2 as the source Lightsail snapshot.
The export snapshot operation supports tag-based access control via resource tags applied to theresource identified by source snapshot name. For more information, see the Lightsail Dev Guide.
NoteUse the get instance snapshots or get disk snapshots operations to get a list ofsnapshots that you can export to Amazon EC2.
Request Syntax{ "sourceSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
sourceSnapshotName (p. 174)
The name of the instance or disk snapshot to be exported to Amazon EC2.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string",
API Version 2016-11-28174
Amazon Lightsail API ReferenceResponse Elements
"operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 174)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-28175
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28176
Amazon Lightsail API ReferenceGetActiveNames
GetActiveNamesReturns the names of all active (not deleted) resources.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 177)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetActiveNames request. If your results are paginated,the response will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "activeNames": [ "string" ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
activeNames (p. 177)
The list of active names returned by the get active names request.
Type: Array of stringsnextPageToken (p. 177)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetActiveNames request and specify the nextpage token using the pageToken parameter.
API Version 2016-11-28177
Amazon Lightsail API ReferenceErrors
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++
API Version 2016-11-28178
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28179
Amazon Lightsail API ReferenceGetAlarms
GetAlarmsReturns information about the configured alarms. Specify an alarm name in your request to returninformation about a specific alarm, or specify a monitored resource name to return information about allalarms for a specific resource.
An alarm is used to monitor a single metric for one of your resources. When a metric condition is met,the alarm can notify you by email, SMS text message, and a banner displayed on the Amazon Lightsailconsole. For more information, see Alarms in Amazon Lightsail.
Request Syntax{ "alarmName": "string", "monitoredResourceName": "string", "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
alarmName (p. 180)
The name of the alarm.
Specify an alarm name to return information about a specific alarm.
Type: String
Pattern: \w[\w\-]*\w
Required: NomonitoredResourceName (p. 180)
The name of the Lightsail resource being monitored by the alarm.
Specify a monitored resource name to return information about all alarms for a specific resource.
Type: String
Pattern: \w[\w\-]*\w
Required: NopageToken (p. 180)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetAlarms request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
API Version 2016-11-28180
Amazon Lightsail API ReferenceResponse Syntax
Required: No
Response Syntax{ "alarms": [ { "arn": "string", "comparisonOperator": "string", "contactProtocols": [ "string" ], "createdAt": number, "datapointsToAlarm": number, "evaluationPeriods": number, "location": { "availabilityZone": "string", "regionName": "string" }, "metricName": "string", "monitoredResourceInfo": { "arn": "string", "name": "string", "resourceType": "string" }, "name": "string", "notificationEnabled": boolean, "notificationTriggers": [ "string" ], "period": number, "resourceType": "string", "state": "string", "statistic": "string", "supportCode": "string", "threshold": number, "treatMissingData": "string", "unit": "string" } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
alarms (p. 181)
An array of objects that describe the alarms.
Type: Array of Alarm (p. 428) objectsnextPageToken (p. 181)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetAlarms request and specify the next pagetoken using the pageToken parameter.
Type: String
API Version 2016-11-28181
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28182
Amazon Lightsail API ReferenceSee Also
API Version 2016-11-28183
Amazon Lightsail API ReferenceGetAutoSnapshots
GetAutoSnapshotsReturns the available automatic snapshots for an instance or disk. For more information, see the LightsailDev Guide.
Request Syntax
{ "resourceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
resourceName (p. 184)
The name of the source instance or disk from which to get automatic snapshot information.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax
{ "autoSnapshots": [ { "createdAt": number, "date": "string", "fromAttachedDisks": [ { "path": "string", "sizeInGb": number } ], "status": "string" } ], "resourceName": "string", "resourceType": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28184
Amazon Lightsail API ReferenceErrors
autoSnapshots (p. 184)
An array of objects that describe the automatic snapshots that are available for the specified sourceinstance or disk.
Type: Array of AutoSnapshotDetails (p. 434) objectsresourceName (p. 184)
The name of the source instance or disk for the automatic snapshots.
Type: String
Pattern: \w[\w\-]*\wresourceType (p. 184)
The resource type (e.g., Instance or Disk).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
API Version 2016-11-28185
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28186
Amazon Lightsail API ReferenceGetBlueprints
GetBlueprintsReturns the list of available instance images, or blueprints. You can use a blueprint to create a newinstance already running a specific operating system, as well as a preinstalled app or development stack.The software each instance is running depends on the blueprint image you choose.
NoteUse active blueprints when creating new instances. Inactive blueprints are listed to supportcustomers with existing instances and are not necessarily available to create new instances.Blueprints are marked inactive when they become outdated due to operating system updates ornew application releases.
Request Syntax{ "includeInactive": boolean, "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
includeInactive (p. 187)
A Boolean value indicating whether to include inactive results in your request.
Type: Boolean
Required: NopageToken (p. 187)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetBlueprints request. If your results are paginated,the response will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "blueprints": [ { "blueprintId": "string", "description": "string", "group": "string", "isActive": boolean, "licenseUrl": "string",
API Version 2016-11-28187
Amazon Lightsail API ReferenceResponse Elements
"minPower": number, "name": "string", "platform": "string", "productUrl": "string", "type": "string", "version": "string", "versionCode": "string" } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
blueprints (p. 187)
An array of key-value pairs that contains information about the available blueprints.
Type: Array of Blueprint (p. 436) objectsnextPageToken (p. 187)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetBlueprints request and specify the next pagetoken using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-28188
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28189
Amazon Lightsail API ReferenceGetBundles
GetBundlesReturns the list of bundles that are available for purchase. A bundle describes the specs for your virtualprivate server (or instance).
Request Syntax{ "includeInactive": boolean, "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
includeInactive (p. 190)
A Boolean value that indicates whether to include inactive bundle results in your request.
Type: Boolean
Required: NopageToken (p. 190)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetBundles request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "bundles": [ { "bundleId": "string", "cpuCount": number, "diskSizeInGb": number, "instanceType": "string", "isActive": boolean, "name": "string", "power": number, "price": number, "ramSizeInGb": number, "supportedPlatforms": [ "string" ], "transferPerMonthInGb": number } ],
API Version 2016-11-28190
Amazon Lightsail API ReferenceResponse Elements
"nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
bundles (p. 190)
An array of key-value pairs that contains information about the available bundles.
Type: Array of Bundle (p. 439) objectsnextPageToken (p. 190)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetBundles request and specify the next pagetoken using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28191
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28192
Amazon Lightsail API ReferenceGetCertificates
GetCertificatesReturns information about one or more Amazon Lightsail SSL/TLS certificates.
NoteTo get a summary of a certificate, ommit includeCertificateDetails from your request.The response will include only the certificate Amazon Resource Name (ARN), certificate name,domain name, and tags.
Request Syntax{ "certificateName": "string", "certificateStatuses": [ "string" ], "includeCertificateDetails": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
certificateName (p. 193)
The name for the certificate for which to return information.
When omitted, the response includes all of your certificates in the AWS region where the request ismade.
Type: String
Required: No
certificateStatuses (p. 193)
The status of the certificates for which to return information.
For example, specify ISSUED to return only certificates with an ISSUED status.
When omitted, the response includes all of your certificates in the AWS region where the request ismade, regardless of their current status.
Type: Array of strings
Valid Values: PENDING_VALIDATION | ISSUED | INACTIVE | EXPIRED |VALIDATION_TIMED_OUT | REVOKED | FAILED
Required: No
includeCertificateDetails (p. 193)
Indicates whether to include detailed information about the certificates in the response.
When omitted, the response includes only the certificate names, Amazon Resource Names (ARNs),domain names, and tags.
API Version 2016-11-28193
Amazon Lightsail API ReferenceResponse Syntax
Type: Boolean
Required: No
Response Syntax{ "certificates": [ { "certificateArn": "string", "certificateDetail": { "arn": "string", "createdAt": number, "domainName": "string", "domainValidationRecords": [ { "domainName": "string", "resourceRecord": { "name": "string", "type": "string", "value": "string" } } ], "eligibleToRenew": "string", "inUseResourceCount": number, "issuedAt": number, "issuerCA": "string", "keyAlgorithm": "string", "name": "string", "notAfter": number, "notBefore": number, "renewalSummary": { "domainValidationRecords": [ { "domainName": "string", "resourceRecord": { "name": "string", "type": "string", "value": "string" } } ], "renewalStatus": "string", "renewalStatusReason": "string", "updatedAt": number }, "requestFailureReason": "string", "revocationReason": "string", "revokedAt": number, "serialNumber": "string", "status": "string", "subjectAlternativeNames": [ "string" ], "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }, "certificateName": "string", "domainName": "string",
API Version 2016-11-28194
Amazon Lightsail API ReferenceResponse Elements
"tags": [ { "key": "string", "value": "string" } ] } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
certificates (p. 194)
An object that describes certificates.
Type: Array of CertificateSummary (p. 450) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28195
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28196
Amazon Lightsail API ReferenceGetCloudFormationStackRecords
GetCloudFormationStackRecordsReturns the CloudFormation stack record created as a result of the create cloud formation stackoperation.
An AWS CloudFormation stack is used to create a new Amazon EC2 instance from an exported Lightsailsnapshot.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 197)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetClouFormationStackRecords request. If your resultsare paginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: No
Response Syntax{ "cloudFormationStackRecords": [ { "arn": "string", "createdAt": number, "destinationInfo": { "id": "string", "service": "string" }, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "sourceInfo": [ { "arn": "string", "name": "string", "resourceType": "string" }
API Version 2016-11-28197
Amazon Lightsail API ReferenceResponse Elements
], "state": "string" } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
cloudFormationStackRecords (p. 197)
A list of objects describing the CloudFormation stack records.
Type: Array of CloudFormationStackRecord (p. 451) objectsnextPageToken (p. 197)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetCloudFormationStackRecords request andspecify the next page token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-28198
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28199
Amazon Lightsail API ReferenceGetContactMethods
GetContactMethodsReturns information about the configured contact methods. Specify a protocol in your request to returninformation about a specific contact method.
A contact method is used to send you notifications about your Amazon Lightsail resources. You can addone email address and one mobile phone number contact method in each AWS Region. However, SMStext messaging is not supported in some AWS Regions, and SMS text messages cannot be sent to somecountries/regions. For more information, see Notifications in Amazon Lightsail.
Request Syntax{ "protocols": [ "string" ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
protocols (p. 200)
The protocols used to send notifications, such as Email, or SMS (text messaging).
Specify a protocol in your request to return information about a specific contact method protocol.
Type: Array of strings
Valid Values: Email | SMS
Required: No
Response Syntax{ "contactMethods": [ { "arn": "string", "contactEndpoint": "string", "createdAt": number, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "protocol": "string", "resourceType": "string", "status": "string", "supportCode": "string" } ]}
API Version 2016-11-28200
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
contactMethods (p. 200)
An array of objects that describe the contact methods.
Type: Array of ContactMethod (p. 454) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28201
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28202
Amazon Lightsail API ReferenceGetDisk
GetDiskReturns information about a specific block storage disk.
Request Syntax{ "diskName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskName (p. 203)
The name of the disk (e.g., my-disk).
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "disk": { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string", "attachedTo": "string", "attachmentState": "string", "createdAt": number, "gbInUse": number, "iops": number, "isAttached": boolean, "isSystemDisk": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "path": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string",
API Version 2016-11-28203
Amazon Lightsail API ReferenceResponse Elements
"tags": [ { "key": "string", "value": "string" } ] }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
disk (p. 203)
An object containing information about the disk.
Type: Disk (p. 458) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
API Version 2016-11-28204
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28205
Amazon Lightsail API ReferenceGetDisks
GetDisksReturns information about all block storage disks in your AWS account and region.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 206)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetDisks request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "disks": [ { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string", "attachedTo": "string", "attachmentState": "string", "createdAt": number, "gbInUse": number, "iops": number, "isAttached": boolean, "isSystemDisk": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "path": "string", "resourceType": "string",
API Version 2016-11-28206
Amazon Lightsail API ReferenceResponse Elements
"sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
disks (p. 206)
An array of objects containing information about all block storage disks.
Type: Array of Disk (p. 458) objectsnextPageToken (p. 206)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetDisks request and specify the next page tokenusing the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
API Version 2016-11-28207
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28208
Amazon Lightsail API ReferenceGetDiskSnapshot
GetDiskSnapshotReturns information about a specific block storage disk snapshot.
Request Syntax{ "diskSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
diskSnapshotName (p. 209)
The name of the disk snapshot (e.g., my-disk-snapshot).
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "diskSnapshot": { "arn": "string", "createdAt": number, "fromDiskArn": "string", "fromDiskName": "string", "fromInstanceArn": "string", "fromInstanceName": "string", "isFromAutoSnapshot": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "progress": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }}
API Version 2016-11-28209
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
diskSnapshot (p. 209)
An object containing information about the disk snapshot.
Type: DiskSnapshot (p. 463) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28210
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28211
Amazon Lightsail API ReferenceGetDiskSnapshots
GetDiskSnapshotsReturns information about all block storage disk snapshots in your AWS account and region.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 212)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetDiskSnapshots request. If your results are paginated,the response will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "diskSnapshots": [ { "arn": "string", "createdAt": number, "fromDiskArn": "string", "fromDiskName": "string", "fromInstanceArn": "string", "fromInstanceName": "string", "isFromAutoSnapshot": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "progress": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ]
API Version 2016-11-28212
Amazon Lightsail API ReferenceResponse Elements
} ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
diskSnapshots (p. 212)
An array of objects containing information about all block storage disk snapshots.
Type: Array of DiskSnapshot (p. 463) objectsnextPageToken (p. 212)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetDiskSnapshots request and specify the nextpage token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-28213
Amazon Lightsail API ReferenceSee Also
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28214
Amazon Lightsail API ReferenceGetDistributionBundles
GetDistributionBundlesReturns the list bundles that can be applied to you Amazon Lightsail content delivery network (CDN)distributions.
A distribution bundle specifies the monthly network transfer quota and monthly cost of yourdsitribution.
Response Syntax{ "bundles": [ { "bundleId": "string", "isActive": boolean, "name": "string", "price": number, "transferPerMonthInGb": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
bundles (p. 215)
An object that describes a distribution bundle.
Type: Array of DistributionBundle (p. 467) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-28215
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28216
Amazon Lightsail API ReferenceGetDistributionLatestCacheReset
GetDistributionLatestCacheResetReturns the timestamp and status of the last cache reset of a specific Amazon Lightsail content deliverynetwork (CDN) distribution.
Request Syntax{ "distributionName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
distributionName (p. 217)
The name of the distribution for which to return the timestamp of the last cache reset.
Use the GetDistributions action to get a list of distribution names that you can specify.
When omitted, the response includes the latest cache reset timestamp of all your distributions.
Type: String
Pattern: \w[\w\-]*\w
Required: No
Response Syntax{ "createTime": number, "status": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
createTime (p. 217)
The timestamp of the last cache reset (e.g., 1479734909.17) in Unix time format.
Type: Timestampstatus (p. 217)
The status of the last cache reset.
API Version 2016-11-28217
Amazon Lightsail API ReferenceErrors
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3
API Version 2016-11-28218
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28219
Amazon Lightsail API ReferenceGetDistributionMetricData
GetDistributionMetricDataReturns the data points of a specific metric for an Amazon Lightsail content delivery network (CDN)distribution.
Metrics report the utilization of your resources, and the error counts generated by them. Monitor andcollect metric data regularly to maintain the reliability, availability, and performance of your resources.
Request Syntax{ "distributionName": "string", "endTime": number, "metricName": "string", "period": number, "startTime": number, "statistics": [ "string" ], "unit": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
distributionName (p. 220)
The name of the distribution for which to get metric data.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
Required: YesendTime (p. 220)
The end of the time interval for which to get metric data.
Constraints:• Specified in Coordinated Universal Time (UTC).• Specified in the Unix time format.
For example, if you wish to use an end time of October 1, 2018, at 9 PM UTC, specify 1538427600as the end time.
You can convert a human-friendly time to Unix time format using a converter like Epoch converter.
Type: Timestamp
Required: YesmetricName (p. 220)
The metric for which you want to return information.
API Version 2016-11-28220
Amazon Lightsail API ReferenceRequest Parameters
Valid distribution metric names are listed below, along with the most useful statistics to includein your request, and the published unit value.• Requests - The total number of viewer requests received by your Lightsail distribution, for all
HTTP methods, and for both HTTP and HTTPS requests.
Statistics: The most useful statistic is Sum.
Unit: The published unit is None.• BytesDownloaded - The number of bytes downloaded by viewers for GET, HEAD, and OPTIONS
requests.
Statistics: The most useful statistic is Sum.
Unit: The published unit is None.• BytesUploaded - The number of bytes uploaded to your origin by your Lightsail distribution,
using POST and PUT requests.
Statistics: The most useful statistic is Sum.
Unit: The published unit is None.• TotalErrorRate - The percentage of all viewer requests for which the response's HTTP status
code was 4xx or 5xx.
Statistics: The most useful statistic is Average.
Unit: The published unit is Percent.• 4xxErrorRate - The percentage of all viewer requests for which the response's HTTP status cod
was 4xx. In these cases, the client or client viewer may have made an error. For example, a statuscode of 404 (Not Found) means that the client requested an object that could not be found.
Statistics: The most useful statistic is Average.
Unit: The published unit is Percent.• 5xxErrorRate - The percentage of all viewer requests for which the response's HTTP status code
was 5xx. In these cases, the origin server did not satisfy the requests. For example, a status code of503 (Service Unavailable) means that the origin server is currently unavailable.
Statistics: The most useful statistic is Average.
Unit: The published unit is Percent.
Type: String
Valid Values: Requests | BytesDownloaded | BytesUploaded | TotalErrorRate |Http4xxErrorRate | Http5xxErrorRate
Required: Yesperiod (p. 220)
The granularity, in seconds, for the metric data points that will be returned.
Type: Integer
Valid Range: Minimum value of 60. Maximum value of 86400.
Required: YesstartTime (p. 220)
The start of the time interval for which to get metric data.
API Version 2016-11-28221
Amazon Lightsail API ReferenceResponse Syntax
Constraints:• Specified in Coordinated Universal Time (UTC).• Specified in the Unix time format.
For example, if you wish to use a start time of October 1, 2018, at 8 PM UTC, specify 1538424000as the start time.
You can convert a human-friendly time to Unix time format using a converter like Epoch converter.
Type: Timestamp
Required: Yesstatistics (p. 220)
The statistic for the metric.
The following statistics are available:• Minimum - The lowest value observed during the specified period. Use this value to determine low
volumes of activity for your application.• Maximum - The highest value observed during the specified period. Use this value to determine
high volumes of activity for your application.• Sum - All values submitted for the matching metric added together. You can use this statistic to
determine the total volume of a metric.• Average - The value of Sum / SampleCount during the specified period. By comparing this
statistic with the Minimum and Maximum values, you can determine the full scope of a metric andhow close the average use is to the Minimum and Maximum values. This comparison helps you toknow when to increase or decrease your resources.
• SampleCount - The count, or number, of data points used for the statistical calculation.
Type: Array of strings
Valid Values: Minimum | Maximum | Sum | Average | SampleCount
Required: Yesunit (p. 220)
The unit for the metric data request.
Valid units depend on the metric data being requested. For the valid units with each available metric,see the metricName parameter.
Type: String
Valid Values: Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |Megabytes | Gigabytes | Terabytes | Bits | Kilobits | Megabits | Gigabits| Terabits | Percent | Count | Bytes/Second | Kilobytes/Second | Megabytes/Second | Gigabytes/Second | Terabytes/Second | Bits/Second | Kilobits/Second| Megabits/Second | Gigabits/Second | Terabits/Second | Count/Second | None
Required: Yes
Response Syntax{ "metricData": [
API Version 2016-11-28222
Amazon Lightsail API ReferenceResponse Elements
{ "average": number, "maximum": number, "minimum": number, "sampleCount": number, "sum": number, "timestamp": number, "unit": "string" } ], "metricName": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
metricData (p. 222)
An array of objects that describe the metric data returned.
Type: Array of MetricDatapoint (p. 524) objectsmetricName (p. 222)
The name of the metric returned.
Type: String
Valid Values: Requests | BytesDownloaded | BytesUploaded | TotalErrorRate |Http4xxErrorRate | Http5xxErrorRate
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-28223
Amazon Lightsail API ReferenceSee Also
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28224
Amazon Lightsail API ReferenceGetDistributions
GetDistributionsReturns information about one or more of your Amazon Lightsail content delivery network (CDN)distributions.
Request Syntax{ "distributionName": "string", "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
distributionName (p. 225)
The name of the distribution for which to return information.
Use the GetDistributions action to get a list of distribution names that you can specify.
When omitted, the response includes all of your distributions in the AWS Region where the requestis made.
Type: String
Pattern: \w[\w\-]*\w
Required: NopageToken (p. 225)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetDistributions request. If your results are paginated,the response will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "distributions": [ { "ableToUpdateBundle": boolean, "alternativeDomainNames": [ "string" ], "arn": "string", "bundleId": "string", "cacheBehaviors": [ { "behavior": "string",
API Version 2016-11-28225
Amazon Lightsail API ReferenceResponse Elements
"path": "string" } ], "cacheBehaviorSettings": { "allowedHTTPMethods": "string", "cachedHTTPMethods": "string", "defaultTTL": number, "forwardedCookies": { "cookiesAllowList": [ "string" ], "option": "string" }, "forwardedHeaders": { "headersAllowList": [ "string" ], "option": "string" }, "forwardedQueryStrings": { "option": boolean, "queryStringsAllowList": [ "string" ] }, "maximumTTL": number, "minimumTTL": number }, "certificateName": "string", "createdAt": number, "defaultCacheBehavior": { "behavior": "string" }, "domainName": "string", "isEnabled": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "origin": { "name": "string", "protocolPolicy": "string", "regionName": "string", "resourceType": "string" }, "originPublicDNS": "string", "resourceType": "string", "status": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
distributions (p. 225)
An array of objects that describe your distributions.
API Version 2016-11-28226
Amazon Lightsail API ReferenceErrors
Type: Array of LightsailDistribution (p. 505) objectsnextPageToken (p. 225)
The token to advance to the next page of results from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetDistributions request and specify the nextpage token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28227
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28228
Amazon Lightsail API ReferenceGetDomain
GetDomainReturns information about a specific domain recordset.
Request Syntax{ "domainName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
domainName (p. 229)
The domain name for which your want to return information about.
Type: String
Required: Yes
Response Syntax{ "domain": { "arn": "string", "createdAt": number, "domainEntries": [ { "id": "string", "isAlias": boolean, "name": "string", "options": { "string" : "string" }, "target": "string", "type": "string" } ], "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }
API Version 2016-11-28229
Amazon Lightsail API ReferenceResponse Elements
}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
domain (p. 229)
An array of key-value pairs containing information about your get domain request.
Type: Domain (p. 468) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
API Version 2016-11-28230
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28231
Amazon Lightsail API ReferenceGetDomains
GetDomainsReturns a list of all domains in the user's account.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 232)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetDomains request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "domains": [ { "arn": "string", "createdAt": number, "domainEntries": [ { "id": "string", "isAlias": boolean, "name": "string", "options": { "string" : "string" }, "target": "string", "type": "string" } ], "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string", "tags": [ {
API Version 2016-11-28232
Amazon Lightsail API ReferenceResponse Elements
"key": "string", "value": "string" } ] } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
domains (p. 232)
An array of key-value pairs containing information about each of the domain entries in the user'saccount.
Type: Array of Domain (p. 468) objectsnextPageToken (p. 232)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetDomains request and specify the next pagetoken using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-28233
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28234
Amazon Lightsail API ReferenceGetExportSnapshotRecords
GetExportSnapshotRecordsReturns the export snapshot record created as a result of the export snapshot operation.
An export snapshot record can be used to create a new Amazon EC2 instance and its related resourceswith the create cloud formation stack operation.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 235)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetExportSnapshotRecords request. If your results arepaginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: No
Response Syntax{ "exportSnapshotRecords": [ { "arn": "string", "createdAt": number, "destinationInfo": { "id": "string", "service": "string" }, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "sourceInfo": { "arn": "string", "createdAt": number, "diskSnapshotInfo": { "sizeInGb": number }, "fromResourceArn": "string",
API Version 2016-11-28235
Amazon Lightsail API ReferenceResponse Elements
"fromResourceName": "string", "instanceSnapshotInfo": { "fromBlueprintId": "string", "fromBundleId": "string", "fromDiskInfo": [ { "isSystemDisk": boolean, "name": "string", "path": "string", "sizeInGb": number } ] }, "name": "string", "resourceType": "string" }, "state": "string" } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
exportSnapshotRecords (p. 235)
A list of objects describing the export snapshot records.
Type: Array of ExportSnapshotRecord (p. 473) objectsnextPageToken (p. 235)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetExportSnapshotRecords request and specifythe next page token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
API Version 2016-11-28236
Amazon Lightsail API ReferenceSee Also
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28237
Amazon Lightsail API ReferenceGetInstance
GetInstanceReturns information about a specific Amazon Lightsail instance, which is a virtual private server.
Request Syntax{ "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 238)
The name of the instance.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "instance": { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string", "blueprintId": "string", "blueprintName": "string", "bundleId": "string", "createdAt": number, "hardware": { "cpuCount": number, "disks": [ { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string",
API Version 2016-11-28238
Amazon Lightsail API ReferenceResponse Syntax
"attachedTo": "string", "attachmentState": "string", "createdAt": number, "gbInUse": number, "iops": number, "isAttached": boolean, "isSystemDisk": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "path": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "ramSizeInGb": number }, "ipv6Address": "string", "isStaticIp": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "networking": { "monthlyTransfer": { "gbPerMonthAllocated": number }, "ports": [ { "accessDirection": "string", "accessFrom": "string", "accessType": "string", "cidrListAliases": [ "string" ], "cidrs": [ "string" ], "commonName": "string", "fromPort": number, "protocol": "string", "toPort": number } ] }, "privateIpAddress": "string", "publicIpAddress": "string", "resourceType": "string", "sshKeyName": "string", "state": { "code": number, "name": "string" }, "supportCode": "string", "tags": [ { "key": "string", "value": "string" }
API Version 2016-11-28239
Amazon Lightsail API ReferenceResponse Elements
], "username": "string" }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
instance (p. 238)
An array of key-value pairs containing information about the specified instance.
Type: Instance (p. 481) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28240
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28241
Amazon Lightsail API ReferenceGetInstanceAccessDetails
GetInstanceAccessDetailsReturns temporary SSH keys you can use to connect to a specific virtual private server, or instance.
The get instance access details operation supports tag-based access control via resource tagsapplied to the resource identified by instance name. For more information, see the Lightsail DevGuide.
Request Syntax{ "instanceName": "string", "protocol": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 242)
The name of the instance to access.
Type: String
Pattern: \w[\w\-]*\w
Required: Yesprotocol (p. 242)
The protocol to use to connect to your instance. Defaults to ssh.
Type: String
Valid Values: ssh | rdp
Required: No
Response Syntax{ "accessDetails": { "certKey": "string", "expiresAt": number, "hostKeys": [ { "algorithm": "string", "fingerprintSHA1": "string", "fingerprintSHA256": "string", "notValidAfter": number, "notValidBefore": number, "publicKey": "string",
API Version 2016-11-28242
Amazon Lightsail API ReferenceResponse Elements
"witnessedAt": number } ], "instanceName": "string", "ipAddress": "string", "password": "string", "passwordData": { "ciphertext": "string", "keyPairName": "string" }, "privateKey": "string", "protocol": "string", "username": "string" }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
accessDetails (p. 242)
An array of key-value pairs containing information about a get instance access request.
Type: InstanceAccessDetails (p. 485) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-28243
Amazon Lightsail API ReferenceSee Also
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28244
Amazon Lightsail API ReferenceGetInstanceMetricData
GetInstanceMetricDataReturns the data points for the specified Amazon Lightsail instance metric, given an instance name.
Metrics report the utilization of your resources, and the error counts generated by them. Monitor andcollect metric data regularly to maintain the reliability, availability, and performance of your resources.
Request Syntax{ "endTime": number, "instanceName": "string", "metricName": "string", "period": number, "startTime": number, "statistics": [ "string" ], "unit": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
endTime (p. 245)
The end time of the time period.
Type: Timestamp
Required: YesinstanceName (p. 245)
The name of the instance for which you want to get metrics data.
Type: String
Pattern: \w[\w\-]*\w
Required: YesmetricName (p. 245)
The metric for which you want to return information.
Valid instance metric names are listed below, along with the most useful statistics to include inyour request, and the published unit value.• BurstCapacityPercentage - The percentage of CPU performance available for your instance
to burst above its baseline. Your instance continuously accrues and consumes burst capacity. Burstcapacity stops accruing when your instance's BurstCapacityPercentage reaches 100%. Formore information, see Viewing instance burst capacity in Amazon Lightsail.
Statistics: The most useful statistics are Maximum and Average.
Unit: The published unit is Percent.
API Version 2016-11-28245
Amazon Lightsail API ReferenceRequest Parameters
• BurstCapacityTime - The available amount of time for your instance to burst at 100% CPUutilization. Your instance continuously accrues and consumes burst capacity. Burst capacity timestops accruing when your instance's BurstCapacityPercentage metric reaches 100%.
Burst capacity time is consumed at the full rate only when your instance operates at 100% CPUutilization. For example, if your instance operates at 50% CPU utilization in the burstable zonefor a 5-minute period, then it consumes CPU burst capacity minutes at a 50% rate in that period.Your instance consumed 2 minutes and 30 seconds of CPU burst capacity minutes in the 5-minuteperiod. For more information, see Viewing instance burst capacity in Amazon Lightsail.
Statistics: The most useful statistics are Maximum and Average.
Unit: The published unit is Seconds.
• CPUUtilization - The percentage of allocated compute units that are currently in use on theinstance. This metric identifies the processing power to run the applications on the instance. Toolsin your operating system can show a lower percentage than Lightsail when the instance is notallocated a full processor core.
Statistics: The most useful statistics are Maximum and Average.
Unit: The published unit is Percent.
• NetworkIn - The number of bytes received on all network interfaces by the instance. This metricidentifies the volume of incoming network traffic to the instance. The number reported is thenumber of bytes received during the period. Because this metric is reported in 5-minute intervals,divide the reported number by 300 to find Bytes/second.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Bytes.
• NetworkOut - The number of bytes sent out on all network interfaces by the instance. Thismetric identifies the volume of outgoing network traffic from the instance. The number reportedis the number of bytes sent during the period. Because this metric is reported in 5-minuteintervals, divide the reported number by 300 to find Bytes/second.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Bytes.
• StatusCheckFailed - Reports whether the instance passed or failed both the instance statuscheck and the system status check. This metric can be either 0 (passed) or 1 (failed). This metricdata is available in 1-minute (60 seconds) granularity.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Count.
• StatusCheckFailed_Instance - Reports whether the instance passed or failed the instancestatus check. This metric can be either 0 (passed) or 1 (failed). This metric data is available in 1-minute (60 seconds) granularity.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Count.
• StatusCheckFailed_System - Reports whether the instance passed or failed the system statuscheck. This metric can be either 0 (passed) or 1 (failed). This metric data is available in 1-minute(60 seconds) granularity.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Count.
API Version 2016-11-28246
Amazon Lightsail API ReferenceRequest Parameters
Type: String
Valid Values: CPUUtilization | NetworkIn | NetworkOut | StatusCheckFailed |StatusCheckFailed_Instance | StatusCheckFailed_System | BurstCapacityTime |BurstCapacityPercentage
Required: Yesperiod (p. 245)
The granularity, in seconds, of the returned data points.
The StatusCheckFailed, StatusCheckFailed_Instance, and StatusCheckFailed_Systeminstance metric data is available in 1-minute (60 seconds) granularity. All other instance metric datais available in 5-minute (300 seconds) granularity.
Type: Integer
Valid Range: Minimum value of 60. Maximum value of 86400.
Required: YesstartTime (p. 245)
The start time of the time period.
Type: Timestamp
Required: Yesstatistics (p. 245)
The statistic for the metric.
The following statistics are available:• Minimum - The lowest value observed during the specified period. Use this value to determine low
volumes of activity for your application.• Maximum - The highest value observed during the specified period. Use this value to determine
high volumes of activity for your application.• Sum - All values submitted for the matching metric added together. You can use this statistic to
determine the total volume of a metric.• Average - The value of Sum / SampleCount during the specified period. By comparing this
statistic with the Minimum and Maximum values, you can determine the full scope of a metric andhow close the average use is to the Minimum and Maximum values. This comparison helps you toknow when to increase or decrease your resources.
• SampleCount - The count, or number, of data points used for the statistical calculation.
Type: Array of strings
Valid Values: Minimum | Maximum | Sum | Average | SampleCount
Required: Yesunit (p. 245)
The unit for the metric data request. Valid units depend on the metric data being requested. For thevalid units to specify with each available metric, see the metricName parameter.
Type: String
Valid Values: Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |Megabytes | Gigabytes | Terabytes | Bits | Kilobits | Megabits | Gigabits| Terabits | Percent | Count | Bytes/Second | Kilobytes/Second | Megabytes/
API Version 2016-11-28247
Amazon Lightsail API ReferenceResponse Syntax
Second | Gigabytes/Second | Terabytes/Second | Bits/Second | Kilobits/Second| Megabits/Second | Gigabits/Second | Terabits/Second | Count/Second | None
Required: Yes
Response Syntax{ "metricData": [ { "average": number, "maximum": number, "minimum": number, "sampleCount": number, "sum": number, "timestamp": number, "unit": "string" } ], "metricName": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
metricData (p. 248)
An array of objects that describe the metric data returned.
Type: Array of MetricDatapoint (p. 524) objectsmetricName (p. 248)
The name of the metric returned.
Type: String
Valid Values: CPUUtilization | NetworkIn | NetworkOut | StatusCheckFailed |StatusCheckFailed_Instance | StatusCheckFailed_System | BurstCapacityTime |BurstCapacityPercentage
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
API Version 2016-11-28248
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28249
Amazon Lightsail API ReferenceGetInstancePortStates
GetInstancePortStatesReturns the firewall port states for a specific Amazon Lightsail instance, the IP addresses allowed toconnect to the instance through the ports, and the protocol.
Request Syntax{ "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 250)
The name of the instance for which to return firewall port states.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "portStates": [ { "cidrListAliases": [ "string" ], "cidrs": [ "string" ], "fromPort": number, "protocol": "string", "state": "string", "toPort": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
portStates (p. 250)
An array of objects that describe the firewall port states for the specified instance.
Type: Array of InstancePortState (p. 496) objects
API Version 2016-11-28250
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-28251
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28252
Amazon Lightsail API ReferenceGetInstances
GetInstancesReturns information about all Amazon Lightsail virtual private servers, or instances.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 253)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetInstances request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "instances": [ { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string", "blueprintId": "string", "blueprintName": "string", "bundleId": "string", "createdAt": number, "hardware": { "cpuCount": number, "disks": [ { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string"
API Version 2016-11-28253
Amazon Lightsail API ReferenceResponse Syntax
} ], "arn": "string", "attachedTo": "string", "attachmentState": "string", "createdAt": number, "gbInUse": number, "iops": number, "isAttached": boolean, "isSystemDisk": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "path": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "ramSizeInGb": number }, "ipv6Address": "string", "isStaticIp": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "networking": { "monthlyTransfer": { "gbPerMonthAllocated": number }, "ports": [ { "accessDirection": "string", "accessFrom": "string", "accessType": "string", "cidrListAliases": [ "string" ], "cidrs": [ "string" ], "commonName": "string", "fromPort": number, "protocol": "string", "toPort": number } ] }, "privateIpAddress": "string", "publicIpAddress": "string", "resourceType": "string", "sshKeyName": "string", "state": { "code": number, "name": "string" }, "supportCode": "string", "tags": [ {
API Version 2016-11-28254
Amazon Lightsail API ReferenceResponse Elements
"key": "string", "value": "string" } ], "username": "string" } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
instances (p. 253)
An array of key-value pairs containing information about your instances.
Type: Array of Instance (p. 481) objectsnextPageToken (p. 253)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetInstances request and specify the next pagetoken using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-28255
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28256
Amazon Lightsail API ReferenceGetInstanceSnapshot
GetInstanceSnapshotReturns information about a specific instance snapshot.
Request Syntax{ "instanceSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceSnapshotName (p. 257)
The name of the snapshot for which you are requesting information.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "instanceSnapshot": { "arn": "string", "createdAt": number, "fromAttachedDisks": [ { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string", "attachedTo": "string", "attachmentState": "string", "createdAt": number, "gbInUse": number, "iops": number, "isAttached": boolean, "isSystemDisk": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "path": "string", "resourceType": "string",
API Version 2016-11-28257
Amazon Lightsail API ReferenceResponse Elements
"sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "fromBlueprintId": "string", "fromBundleId": "string", "fromInstanceArn": "string", "fromInstanceName": "string", "isFromAutoSnapshot": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "progress": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
instanceSnapshot (p. 257)
An array of key-value pairs containing information about the results of your get instance snapshotrequest.
Type: InstanceSnapshot (p. 498) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
API Version 2016-11-28258
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28259
Amazon Lightsail API ReferenceGetInstanceSnapshots
GetInstanceSnapshotsReturns all instance snapshots for the user's account.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 260)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetInstanceSnapshots request. If your results arepaginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: No
Response Syntax{ "instanceSnapshots": [ { "arn": "string", "createdAt": number, "fromAttachedDisks": [ { "addOns": [ { "name": "string", "nextSnapshotTimeOfDay": "string", "snapshotTimeOfDay": "string", "status": "string" } ], "arn": "string", "attachedTo": "string", "attachmentState": "string", "createdAt": number, "gbInUse": number, "iops": number, "isAttached": boolean, "isSystemDisk": boolean, "location": { "availabilityZone": "string", "regionName": "string"
API Version 2016-11-28260
Amazon Lightsail API ReferenceResponse Elements
}, "name": "string", "path": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "fromBlueprintId": "string", "fromBundleId": "string", "fromInstanceArn": "string", "fromInstanceName": "string", "isFromAutoSnapshot": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "progress": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
instanceSnapshots (p. 260)
An array of key-value pairs containing information about the results of your get instance snapshotsrequest.
Type: Array of InstanceSnapshot (p. 498) objectsnextPageToken (p. 260)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetInstanceSnapshots request and specify thenext page token using the pageToken parameter.
Type: String
API Version 2016-11-28261
Amazon Lightsail API ReferenceErrors
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript
API Version 2016-11-28262
Amazon Lightsail API ReferenceSee Also
• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28263
Amazon Lightsail API ReferenceGetInstanceState
GetInstanceStateReturns the state of a specific instance. Works on one instance at a time.
Request Syntax{ "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 264)
The name of the instance to get state information about.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "state": { "code": number, "name": "string" }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
state (p. 264)
The state of the instance.
Type: InstanceState (p. 502) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
API Version 2016-11-28264
Amazon Lightsail API ReferenceSee Also
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28265
Amazon Lightsail API ReferenceSee Also
API Version 2016-11-28266
Amazon Lightsail API ReferenceGetKeyPair
GetKeyPairReturns information about a specific key pair.
Request Syntax{ "keyPairName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
keyPairName (p. 267)
The name of the key pair for which you are requesting information.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "keyPair": { "arn": "string", "createdAt": number, "fingerprint": "string", "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28267
Amazon Lightsail API ReferenceErrors
keyPair (p. 267)
An array of key-value pairs containing information about the key pair.
Type: KeyPair (p. 503) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface
API Version 2016-11-28268
Amazon Lightsail API ReferenceSee Also
• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28269
Amazon Lightsail API ReferenceGetKeyPairs
GetKeyPairsReturns information about all key pairs in the user's account.
Request Syntax
{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 270)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetKeyPairs request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax
{ "keyPairs": [ { "arn": "string", "createdAt": number, "fingerprint": "string", "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ], "nextPageToken": "string"}
API Version 2016-11-28270
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
keyPairs (p. 270)
An array of key-value pairs containing information about the key pairs.
Type: Array of KeyPair (p. 503) objectsnextPageToken (p. 270)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetKeyPairs request and specify the next pagetoken using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-28271
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28272
Amazon Lightsail API ReferenceGetLoadBalancer
GetLoadBalancerReturns information about the specified Lightsail load balancer.
Request Syntax{ "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
loadBalancerName (p. 273)
The name of the load balancer.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "loadBalancer": { "arn": "string", "configurationOptions": { "string" : "string" }, "createdAt": number, "dnsName": "string", "healthCheckPath": "string", "instanceHealthSummary": [ { "instanceHealth": "string", "instanceHealthReason": "string", "instanceName": "string" } ], "instancePort": number, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "protocol": "string", "publicPorts": [ number ], "resourceType": "string", "state": "string", "supportCode": "string", "tags": [
API Version 2016-11-28273
Amazon Lightsail API ReferenceResponse Elements
{ "key": "string", "value": "string" } ], "tlsCertificateSummaries": [ { "isAttached": boolean, "name": "string" } ] }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
loadBalancer (p. 273)
An object containing information about your load balancer.
Type: LoadBalancer (p. 509) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28274
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28275
Amazon Lightsail API ReferenceGetLoadBalancerMetricData
GetLoadBalancerMetricDataReturns information about health metrics for your Lightsail load balancer.
Metrics report the utilization of your resources, and the error counts generated by them. Monitor andcollect metric data regularly to maintain the reliability, availability, and performance of your resources.
Request Syntax{ "endTime": number, "loadBalancerName": "string", "metricName": "string", "period": number, "startTime": number, "statistics": [ "string" ], "unit": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
endTime (p. 276)
The end time of the period.
Type: Timestamp
Required: YesloadBalancerName (p. 276)
The name of the load balancer.
Type: String
Pattern: \w[\w\-]*\w
Required: YesmetricName (p. 276)
The metric for which you want to return information.
Valid load balancer metric names are listed below, along with the most useful statistics toinclude in your request, and the published unit value.• ClientTLSNegotiationErrorCount - The number of TLS connections initiated by the client
that did not establish a session with the load balancer due to a TLS error generated by the loadbalancer. Possible causes include a mismatch of ciphers or protocols.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Count.• HealthyHostCount - The number of target instances that are considered healthy.
API Version 2016-11-28276
Amazon Lightsail API ReferenceRequest Parameters
Statistics: The most useful statistic are Average, Minimum, and Maximum.
Unit: The published unit is Count.• HTTPCode_Instance_2XX_Count - The number of HTTP 2XX response codes generated by the
target instances. This does not include any response codes generated by the load balancer.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• HTTPCode_Instance_3XX_Count - The number of HTTP 3XX response codes generated by the
target instances. This does not include any response codes generated by the load balancer.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• HTTPCode_Instance_4XX_Count - The number of HTTP 4XX response codes generated by the
target instances. This does not include any response codes generated by the load balancer.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• HTTPCode_Instance_5XX_Count - The number of HTTP 5XX response codes generated by the
target instances. This does not include any response codes generated by the load balancer.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• HTTPCode_LB_4XX_Count - The number of HTTP 4XX client error codes that originated from
the load balancer. Client errors are generated when requests are malformed or incomplete. Theserequests were not received by the target instance. This count does not include response codesgenerated by the target instances.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• HTTPCode_LB_5XX_Count - The number of HTTP 5XX server error codes that originated from
the load balancer. This does not include any response codes generated by the target instance. Thismetric is reported if there are no healthy instances attached to the load balancer, or if the requestrate exceeds the capacity of the instances (spillover) or the load balancer.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• InstanceResponseTime - The time elapsed, in seconds, after the request leaves the load
balancer until a response from the target instance is received.
Statistics: The most useful statistic is Average.
Unit: The published unit is Seconds.• RejectedConnectionCount - The number of connections that were rejected because the load
balancer had reached its maximum number of connections.
API Version 2016-11-28277
Amazon Lightsail API ReferenceRequest Parameters
Statistics: The most useful statistic is Sum.
Unit: The published unit is Count.• RequestCount - The number of requests processed over IPv4. This count includes only the
requests with a response generated by a target instance of the load balancer.
Statistics: The most useful statistic is Sum. Note that Minimum, Maximum, and Average allreturn 1.
Unit: The published unit is Count.• UnhealthyHostCount - The number of target instances that are considered unhealthy.
Statistics: The most useful statistic are Average, Minimum, and Maximum.
Unit: The published unit is Count.
Type: String
Valid Values: ClientTLSNegotiationErrorCount | HealthyHostCount |UnhealthyHostCount | HTTPCode_LB_4XX_Count | HTTPCode_LB_5XX_Count| HTTPCode_Instance_2XX_Count | HTTPCode_Instance_3XX_Count |HTTPCode_Instance_4XX_Count | HTTPCode_Instance_5XX_Count |InstanceResponseTime | RejectedConnectionCount | RequestCount
Required: Yesperiod (p. 276)
The granularity, in seconds, of the returned data points.
Type: Integer
Valid Range: Minimum value of 60. Maximum value of 86400.
Required: YesstartTime (p. 276)
The start time of the period.
Type: Timestamp
Required: Yesstatistics (p. 276)
The statistic for the metric.
The following statistics are available:• Minimum - The lowest value observed during the specified period. Use this value to determine low
volumes of activity for your application.• Maximum - The highest value observed during the specified period. Use this value to determine
high volumes of activity for your application.• Sum - All values submitted for the matching metric added together. You can use this statistic to
determine the total volume of a metric.• Average - The value of Sum / SampleCount during the specified period. By comparing this
statistic with the Minimum and Maximum values, you can determine the full scope of a metric andhow close the average use is to the Minimum and Maximum values. This comparison helps you toknow when to increase or decrease your resources.
• SampleCount - The count, or number, of data points used for the statistical calculation.
API Version 2016-11-28278
Amazon Lightsail API ReferenceResponse Syntax
Type: Array of strings
Valid Values: Minimum | Maximum | Sum | Average | SampleCount
Required: Yesunit (p. 276)
The unit for the metric data request. Valid units depend on the metric data being requested. For thevalid units with each available metric, see the metricName parameter.
Type: String
Valid Values: Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |Megabytes | Gigabytes | Terabytes | Bits | Kilobits | Megabits | Gigabits| Terabits | Percent | Count | Bytes/Second | Kilobytes/Second | Megabytes/Second | Gigabytes/Second | Terabytes/Second | Bits/Second | Kilobits/Second| Megabits/Second | Gigabits/Second | Terabits/Second | Count/Second | None
Required: Yes
Response Syntax{ "metricData": [ { "average": number, "maximum": number, "minimum": number, "sampleCount": number, "sum": number, "timestamp": number, "unit": "string" } ], "metricName": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
metricData (p. 279)
An array of objects that describe the metric data returned.
Type: Array of MetricDatapoint (p. 524) objectsmetricName (p. 279)
The name of the metric returned.
Type: String
Valid Values: ClientTLSNegotiationErrorCount | HealthyHostCount |UnhealthyHostCount | HTTPCode_LB_4XX_Count | HTTPCode_LB_5XX_Count| HTTPCode_Instance_2XX_Count | HTTPCode_Instance_3XX_Count |
API Version 2016-11-28279
Amazon Lightsail API ReferenceErrors
HTTPCode_Instance_4XX_Count | HTTPCode_Instance_5XX_Count |InstanceResponseTime | RejectedConnectionCount | RequestCount
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++
API Version 2016-11-28280
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28281
Amazon Lightsail API ReferenceGetLoadBalancers
GetLoadBalancersReturns information about all load balancers in an account.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 282)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetLoadBalancers request. If your results are paginated,the response will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "loadBalancers": [ { "arn": "string", "configurationOptions": { "string" : "string" }, "createdAt": number, "dnsName": "string", "healthCheckPath": "string", "instanceHealthSummary": [ { "instanceHealth": "string", "instanceHealthReason": "string", "instanceName": "string" } ], "instancePort": number, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "protocol": "string", "publicPorts": [ number ], "resourceType": "string",
API Version 2016-11-28282
Amazon Lightsail API ReferenceResponse Elements
"state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ], "tlsCertificateSummaries": [ { "isAttached": boolean, "name": "string" } ] } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
loadBalancers (p. 282)
An array of LoadBalancer objects describing your load balancers.
Type: Array of LoadBalancer (p. 509) objectsnextPageToken (p. 282)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetLoadBalancers request and specify the nextpage token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-28283
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28284
Amazon Lightsail API ReferenceGetLoadBalancerTlsCertificates
GetLoadBalancerTlsCertificatesReturns information about the TLS certificates that are associated with the specified Lightsail loadbalancer.
TLS is just an updated, more secure version of Secure Socket Layer (SSL).
You can have a maximum of 2 certificates associated with a Lightsail load balancer. One is active and theother is inactive.
Request Syntax{ "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
loadBalancerName (p. 285)
The name of the load balancer you associated with your SSL/TLS certificate.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "tlsCertificates": [ { "arn": "string", "createdAt": number, "domainName": "string", "domainValidationRecords": [ { "domainName": "string", "name": "string", "type": "string", "validationStatus": "string", "value": "string" } ], "failureReason": "string", "isAttached": boolean, "issuedAt": number, "issuer": "string", "keyAlgorithm": "string", "loadBalancerName": "string",
API Version 2016-11-28285
Amazon Lightsail API ReferenceResponse Elements
"location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "notAfter": number, "notBefore": number, "renewalSummary": { "domainValidationOptions": [ { "domainName": "string", "validationStatus": "string" } ], "renewalStatus": "string" }, "resourceType": "string", "revocationReason": "string", "revokedAt": number, "serial": "string", "signatureAlgorithm": "string", "status": "string", "subject": "string", "subjectAlternativeNames": [ "string" ], "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
tlsCertificates (p. 285)
An array of LoadBalancerTlsCertificate objects describing your SSL/TLS certificates.
Type: Array of LoadBalancerTlsCertificate (p. 512) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
API Version 2016-11-28286
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28287
Amazon Lightsail API ReferenceGetOperation
GetOperationReturns information about a specific operation. Operations include events such as when you create aninstance, allocate a static IP, attach a static IP, and so on.
Request Syntax{ "operationId": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
operationId (p. 288)
A GUID used to identify the operation.
Type: String
Pattern: .*\S.*
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28288
Amazon Lightsail API ReferenceErrors
operation (p. 288)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28289
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28290
Amazon Lightsail API ReferenceGetOperations
GetOperationsReturns information about all operations.
Results are returned from oldest to newest, up to a maximum of 200. Results can be paged by makingeach subsequent call to GetOperations use the maximum (last) statusChangedAt value from theprevious request.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 291)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetOperations request. If your results are paginated,the response will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "nextPageToken": "string", "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]
API Version 2016-11-28291
Amazon Lightsail API ReferenceResponse Elements
}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextPageToken (p. 291)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetOperations request and specify the next pagetoken using the pageToken parameter.
Type: Stringoperations (p. 291)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28292
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28293
Amazon Lightsail API ReferenceGetOperationsForResource
GetOperationsForResourceGets operations for a specific resource (e.g., an instance or a static IP).
Request Syntax{ "pageToken": "string", "resourceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 294)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetOperationsForResource request. If your results arepaginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: NoresourceName (p. 294)
The name of the resource for which you are requesting information.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "nextPageCount": "string", "nextPageToken": "string", "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" },
API Version 2016-11-28294
Amazon Lightsail API ReferenceResponse Elements
"operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextPageCount (p. 294)
(Deprecated) Returns the number of pages of results that remain.
NoteIn releases prior to June 12, 2017, this parameter returned null by the API. It is nowdeprecated, and the API returns the next page token parameter instead.
Type: StringnextPageToken (p. 294)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetOperationsForResource request and specifythe next page token using the pageToken parameter.
Type: Stringoperations (p. 294)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
API Version 2016-11-28295
Amazon Lightsail API ReferenceSee Also
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28296
Amazon Lightsail API ReferenceGetRegions
GetRegionsReturns a list of all valid regions for Amazon Lightsail. Use the include availability zonesparameter to also return the Availability Zones in a region.
Request Syntax{ "includeAvailabilityZones": boolean, "includeRelationalDatabaseAvailabilityZones": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
includeAvailabilityZones (p. 297)
A Boolean value indicating whether to also include Availability Zones in your get regions request.Availability Zones are indicated with a letter: e.g., us-east-2a.
Type: Boolean
Required: NoincludeRelationalDatabaseAvailabilityZones (p. 297)
>A Boolean value indicating whether to also include Availability Zones for databases in your getregions request. Availability Zones are indicated with a letter (e.g., us-east-2a).
Type: Boolean
Required: No
Response Syntax{ "regions": [ { "availabilityZones": [ { "state": "string", "zoneName": "string" } ], "continentCode": "string", "description": "string", "displayName": "string", "name": "string", "relationalDatabaseAvailabilityZones": [ { "state": "string", "zoneName": "string" }
API Version 2016-11-28297
Amazon Lightsail API ReferenceResponse Elements
] } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
regions (p. 297)
An array of key-value pairs containing information about your get regions request.
Type: Array of Region (p. 539) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28298
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28299
Amazon Lightsail API ReferenceGetRelationalDatabase
GetRelationalDatabaseReturns information about a specific database in Amazon Lightsail.
Request Syntax{ "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseName (p. 300)
The name of the database that you are looking up.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "relationalDatabase": { "arn": "string", "backupRetentionEnabled": boolean, "caCertificateIdentifier": "string", "createdAt": number, "engine": "string", "engineVersion": "string", "hardware": { "cpuCount": number, "diskSizeInGb": number, "ramSizeInGb": number }, "latestRestorableTime": number, "location": { "availabilityZone": "string", "regionName": "string" }, "masterDatabaseName": "string", "masterEndpoint": { "address": "string", "port": number }, "masterUsername": "string", "name": "string", "parameterApplyStatus": "string", "pendingMaintenanceActions": [ {
API Version 2016-11-28300
Amazon Lightsail API ReferenceResponse Elements
"action": "string", "currentApplyDate": number, "description": "string" } ], "pendingModifiedValues": { "backupRetentionEnabled": boolean, "engineVersion": "string", "masterUserPassword": "string" }, "preferredBackupWindow": "string", "preferredMaintenanceWindow": "string", "publiclyAccessible": boolean, "relationalDatabaseBlueprintId": "string", "relationalDatabaseBundleId": "string", "resourceType": "string", "secondaryAvailabilityZone": "string", "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
relationalDatabase (p. 300)
An object describing the specified database.
Type: RelationalDatabase (p. 541) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-28301
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28302
Amazon Lightsail API ReferenceGetRelationalDatabaseBlueprints
GetRelationalDatabaseBlueprintsReturns a list of available database blueprints in Amazon Lightsail. A blueprint describes the majorengine version of a database.
You can use a blueprint ID to create a new database that runs a specific database engine.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 303)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetRelationalDatabaseBlueprints request. If yourresults are paginated, the response will return a next page token that you can specify as the pagetoken in a subsequent request.
Type: String
Required: No
Response Syntax{ "blueprints": [ { "blueprintId": "string", "engine": "string", "engineDescription": "string", "engineVersion": "string", "engineVersionDescription": "string", "isEngineDefault": boolean } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28303
Amazon Lightsail API ReferenceErrors
blueprints (p. 303)
An object describing the result of your get relational database blueprints request.
Type: Array of RelationalDatabaseBlueprint (p. 545) objectsnextPageToken (p. 303)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetRelationalDatabaseBlueprints requestand specify the next page token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
API Version 2016-11-28304
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28305
Amazon Lightsail API ReferenceGetRelationalDatabaseBundles
GetRelationalDatabaseBundlesReturns the list of bundles that are available in Amazon Lightsail. A bundle describes the performancespecifications for a database.
You can use a bundle ID to create a new database with explicit performance specifications.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 306)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetRelationalDatabaseBundles request. If your resultsare paginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: No
Response Syntax{ "bundles": [ { "bundleId": "string", "cpuCount": number, "diskSizeInGb": number, "isActive": boolean, "isEncrypted": boolean, "name": "string", "price": number, "ramSizeInGb": number, "transferPerMonthInGb": number } ], "nextPageToken": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28306
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
bundles (p. 306)
An object describing the result of your get relational database bundles request.
Type: Array of RelationalDatabaseBundle (p. 547) objectsnextPageToken (p. 306)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetRelationalDatabaseBundles request andspecify the next page token using the pageToken parameter.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28307
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28308
Amazon Lightsail API ReferenceGetRelationalDatabaseEvents
GetRelationalDatabaseEventsReturns a list of events for a specific database in Amazon Lightsail.
Request Syntax{ "durationInMinutes": number, "pageToken": "string", "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
durationInMinutes (p. 309)
The number of minutes in the past from which to retrieve events. For example, to get all events fromthe past 2 hours, enter 120.
Default: 60
The minimum is 1 and the maximum is 14 days (20160 minutes).
Type: Integer
Required: NopageToken (p. 309)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetRelationalDatabaseEvents request. If your resultsare paginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: NorelationalDatabaseName (p. 309)
The name of the database from which to get events.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{
API Version 2016-11-28309
Amazon Lightsail API ReferenceResponse Elements
"nextPageToken": "string", "relationalDatabaseEvents": [ { "createdAt": number, "eventCategories": [ "string" ], "message": "string", "resource": "string" } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextPageToken (p. 309)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetRelationalDatabaseEvents request andspecify the next page token using the pageToken parameter.
Type: StringrelationalDatabaseEvents (p. 309)
An object describing the result of your get relational database events request.
Type: Array of RelationalDatabaseEvent (p. 550) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-28310
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28311
Amazon Lightsail API ReferenceGetRelationalDatabaseLogEvents
GetRelationalDatabaseLogEventsReturns a list of log events for a database in Amazon Lightsail.
Request Syntax{ "endTime": number, "logStreamName": "string", "pageToken": "string", "relationalDatabaseName": "string", "startFromHead": boolean, "startTime": number}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
endTime (p. 312)
The end of the time interval from which to get log events.
Constraints:• Specified in Coordinated Universal Time (UTC).• Specified in the Unix time format.
For example, if you wish to use an end time of October 1, 2018, at 8 PM UTC, then you input1538424000 as the end time.
Type: Timestamp
Required: NologStreamName (p. 312)
The name of the log stream.
Use the get relational database log streams operation to get a list of available logstreams.
Type: String
Required: YespageToken (p. 312)
The token to advance to the next or previous page of results from your request.
To get a page token, perform an initial GetRelationalDatabaseLogEvents request. If yourresults are paginated, the response will return a next forward token and/or next backward tokenthat you can specify as the page token in a subsequent request.
Type: String
Required: No
API Version 2016-11-28312
Amazon Lightsail API ReferenceResponse Syntax
relationalDatabaseName (p. 312)
The name of your database for which to get log events.
Type: String
Pattern: \w[\w\-]*\w
Required: YesstartFromHead (p. 312)
Parameter to specify if the log should start from head or tail. If true is specified, the log eventstarts from the head of the log. If false is specified, the log event starts from the tail of the log.
NoteFor PostgreSQL, the default value of false is the only option available.
Type: Boolean
Required: NostartTime (p. 312)
The start of the time interval from which to get log events.
Constraints:• Specified in Coordinated Universal Time (UTC).• Specified in the Unix time format.
For example, if you wish to use a start time of October 1, 2018, at 8 PM UTC, then you input1538424000 as the start time.
Type: Timestamp
Required: No
Response Syntax{ "nextBackwardToken": "string", "nextForwardToken": "string", "resourceLogEvents": [ { "createdAt": number, "message": "string" } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextBackwardToken (p. 313)
A token used for advancing to the previous page of results from your get relational database logevents request.
API Version 2016-11-28313
Amazon Lightsail API ReferenceErrors
Type: StringnextForwardToken (p. 313)
A token used for advancing to the next page of results from your get relational database log eventsrequest.
Type: StringresourceLogEvents (p. 313)
An object describing the result of your get relational database log events request.
Type: Array of LogEvent (p. 523) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28314
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28315
Amazon Lightsail API ReferenceGetRelationalDatabaseLogStreams
GetRelationalDatabaseLogStreamsReturns a list of available log streams for a specific database in Amazon Lightsail.
Request Syntax{ "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseName (p. 316)
The name of your database for which to get log streams.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "logStreams": [ "string" ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
logStreams (p. 316)
An object describing the result of your get relational database log streams request.
Type: Array of strings
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
API Version 2016-11-28316
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28317
Amazon Lightsail API ReferenceGetRelationalDatabaseMasterUserPassword
GetRelationalDatabaseMasterUserPasswordReturns the current, previous, or pending versions of the master user password for a Lightsail database.
The GetRelationalDatabaseMasterUserPassword operation supports tag-based access control viaresource tags applied to the resource identified by relationalDatabaseName.
Request Syntax{ "passwordVersion": "string", "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
passwordVersion (p. 318)
The password version to return.
Specifying CURRENT or PREVIOUS returns the current or previous passwords respectively. SpecifyingPENDING returns the newest version of the password that will rotate to CURRENT. After thePENDING password rotates to CURRENT, the PENDING password is no longer available.
Default: CURRENT
Type: String
Valid Values: CURRENT | PREVIOUS | PENDING
Required: NorelationalDatabaseName (p. 318)
The name of your database for which to get the master user password.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "createdAt": number, "masterUserPassword": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28318
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
createdAt (p. 318)
The timestamp when the specified version of the master user password was created.
Type: TimestampmasterUserPassword (p. 318)
The master user password for the password version specified.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28319
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28320
Amazon Lightsail API ReferenceGetRelationalDatabaseMetricData
GetRelationalDatabaseMetricDataReturns the data points of the specified metric for a database in Amazon Lightsail.
Metrics report the utilization of your resources, and the error counts generated by them. Monitor andcollect metric data regularly to maintain the reliability, availability, and performance of your resources.
Request Syntax{ "endTime": number, "metricName": "string", "period": number, "relationalDatabaseName": "string", "startTime": number, "statistics": [ "string" ], "unit": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
endTime (p. 321)
The end of the time interval from which to get metric data.
Constraints:
• Specified in Coordinated Universal Time (UTC).
• Specified in the Unix time format.
For example, if you wish to use an end time of October 1, 2018, at 8 PM UTC, then you input1538424000 as the end time.
Type: Timestamp
Required: Yes
metricName (p. 321)
The metric for which you want to return information.
Valid relational database metric names are listed below, along with the most useful statisticsto include in your request, and the published unit value. All relational database metric data isavailable in 1-minute (60 seconds) granularity.
• CPUUtilization - The percentage of CPU utilization currently in use on the database.
Statistics: The most useful statistics are Maximum and Average.
Unit: The published unit is Percent.
• DatabaseConnections - The number of database connections in use.
Statistics: The most useful statistics are Maximum and Sum.
API Version 2016-11-28321
Amazon Lightsail API ReferenceRequest Parameters
Unit: The published unit is Count.• DiskQueueDepth - The number of outstanding IOs (read/write requests) that are waiting to
access the disk.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Count.• FreeStorageSpace - The amount of available storage space.
Statistics: The most useful statistic is Sum.
Unit: The published unit is Bytes.• NetworkReceiveThroughput - The incoming (Receive) network traffic on the database,
including both customer database traffic and AWS traffic used for monitoring and replication.
Statistics: The most useful statistic is Average.
Unit: The published unit is Bytes/Second.• NetworkTransmitThroughput - The outgoing (Transmit) network traffic on the database,
including both customer database traffic and AWS traffic used for monitoring and replication.
Statistics: The most useful statistic is Average.
Unit: The published unit is Bytes/Second.
Type: String
Valid Values: CPUUtilization | DatabaseConnections | DiskQueueDepth |FreeStorageSpace | NetworkReceiveThroughput | NetworkTransmitThroughput
Required: Yesperiod (p. 321)
The granularity, in seconds, of the returned data points.
All relational database metric data is available in 1-minute (60 seconds) granularity.
Type: Integer
Valid Range: Minimum value of 60. Maximum value of 86400.
Required: YesrelationalDatabaseName (p. 321)
The name of your database from which to get metric data.
Type: String
Pattern: \w[\w\-]*\w
Required: YesstartTime (p. 321)
The start of the time interval from which to get metric data.
Constraints:• Specified in Coordinated Universal Time (UTC).• Specified in the Unix time format.
API Version 2016-11-28322
Amazon Lightsail API ReferenceResponse Syntax
For example, if you wish to use a start time of October 1, 2018, at 8 PM UTC, then you input1538424000 as the start time.
Type: Timestamp
Required: Yesstatistics (p. 321)
The statistic for the metric.
The following statistics are available:• Minimum - The lowest value observed during the specified period. Use this value to determine low
volumes of activity for your application.• Maximum - The highest value observed during the specified period. Use this value to determine
high volumes of activity for your application.• Sum - All values submitted for the matching metric added together. You can use this statistic to
determine the total volume of a metric.• Average - The value of Sum / SampleCount during the specified period. By comparing this
statistic with the Minimum and Maximum values, you can determine the full scope of a metric andhow close the average use is to the Minimum and Maximum values. This comparison helps you toknow when to increase or decrease your resources.
• SampleCount - The count, or number, of data points used for the statistical calculation.
Type: Array of strings
Valid Values: Minimum | Maximum | Sum | Average | SampleCount
Required: Yesunit (p. 321)
The unit for the metric data request. Valid units depend on the metric data being requested. For thevalid units with each available metric, see the metricName parameter.
Type: String
Valid Values: Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |Megabytes | Gigabytes | Terabytes | Bits | Kilobits | Megabits | Gigabits| Terabits | Percent | Count | Bytes/Second | Kilobytes/Second | Megabytes/Second | Gigabytes/Second | Terabytes/Second | Bits/Second | Kilobits/Second| Megabits/Second | Gigabits/Second | Terabits/Second | Count/Second | None
Required: Yes
Response Syntax{ "metricData": [ { "average": number, "maximum": number, "minimum": number, "sampleCount": number, "sum": number, "timestamp": number, "unit": "string" }
API Version 2016-11-28323
Amazon Lightsail API ReferenceResponse Elements
], "metricName": "string"}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
metricData (p. 323)
An array of objects that describe the metric data returned.
Type: Array of MetricDatapoint (p. 524) objectsmetricName (p. 323)
The name of the metric returned.
Type: String
Valid Values: CPUUtilization | DatabaseConnections | DiskQueueDepth |FreeStorageSpace | NetworkReceiveThroughput | NetworkTransmitThroughput
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28324
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28325
Amazon Lightsail API ReferenceGetRelationalDatabaseParameters
GetRelationalDatabaseParametersReturns all of the runtime parameters offered by the underlying database software, or engine, for aspecific database in Amazon Lightsail.
In addition to the parameter names and values, this operation returns other information about eachparameter. This information includes whether changes require a reboot, whether the parameter ismodifiable, the allowed values, and the data types.
Request Syntax{ "pageToken": "string", "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 326)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetRelationalDatabaseParameters request. If yourresults are paginated, the response will return a next page token that you can specify as the pagetoken in a subsequent request.
Type: String
Required: NorelationalDatabaseName (p. 326)
The name of your database for which to get parameters.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "nextPageToken": "string", "parameters": [ { "allowedValues": "string", "applyMethod": "string", "applyType": "string", "dataType": "string", "description": "string",
API Version 2016-11-28326
Amazon Lightsail API ReferenceResponse Elements
"isModifiable": boolean, "parameterName": "string", "parameterValue": "string" } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextPageToken (p. 326)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetRelationalDatabaseParameters requestand specify the next page token using the pageToken parameter.
Type: Stringparameters (p. 326)
An object describing the result of your get relational database parameters request.
Type: Array of RelationalDatabaseParameter (p. 552) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-28327
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28328
Amazon Lightsail API ReferenceGetRelationalDatabases
GetRelationalDatabasesReturns information about all of your databases in Amazon Lightsail.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 329)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetRelationalDatabases request. If your results arepaginated, the response will return a next page token that you can specify as the page token in asubsequent request.
Type: String
Required: No
Response Syntax{ "nextPageToken": "string", "relationalDatabases": [ { "arn": "string", "backupRetentionEnabled": boolean, "caCertificateIdentifier": "string", "createdAt": number, "engine": "string", "engineVersion": "string", "hardware": { "cpuCount": number, "diskSizeInGb": number, "ramSizeInGb": number }, "latestRestorableTime": number, "location": { "availabilityZone": "string", "regionName": "string" }, "masterDatabaseName": "string", "masterEndpoint": { "address": "string", "port": number },
API Version 2016-11-28329
Amazon Lightsail API ReferenceResponse Elements
"masterUsername": "string", "name": "string", "parameterApplyStatus": "string", "pendingMaintenanceActions": [ { "action": "string", "currentApplyDate": number, "description": "string" } ], "pendingModifiedValues": { "backupRetentionEnabled": boolean, "engineVersion": "string", "masterUserPassword": "string" }, "preferredBackupWindow": "string", "preferredMaintenanceWindow": "string", "publiclyAccessible": boolean, "relationalDatabaseBlueprintId": "string", "relationalDatabaseBundleId": "string", "resourceType": "string", "secondaryAvailabilityZone": "string", "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextPageToken (p. 329)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetRelationalDatabases request and specifythe next page token using the pageToken parameter.
Type: String
relationalDatabases (p. 329)
An object describing the result of your get relational databases request.
Type: Array of RelationalDatabase (p. 541) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
API Version 2016-11-28330
Amazon Lightsail API ReferenceSee Also
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28331
Amazon Lightsail API ReferenceSee Also
API Version 2016-11-28332
Amazon Lightsail API ReferenceGetRelationalDatabaseSnapshot
GetRelationalDatabaseSnapshotReturns information about a specific database snapshot in Amazon Lightsail.
Request Syntax{ "relationalDatabaseSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseSnapshotName (p. 333)
The name of the database snapshot for which to get information.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "relationalDatabaseSnapshot": { "arn": "string", "createdAt": number, "engine": "string", "engineVersion": "string", "fromRelationalDatabaseArn": "string", "fromRelationalDatabaseBlueprintId": "string", "fromRelationalDatabaseBundleId": "string", "fromRelationalDatabaseName": "string", "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" } ] }}
API Version 2016-11-28333
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
relationalDatabaseSnapshot (p. 333)
An object describing the specified database snapshot.
Type: RelationalDatabaseSnapshot (p. 554) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28334
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28335
Amazon Lightsail API ReferenceGetRelationalDatabaseSnapshots
GetRelationalDatabaseSnapshotsReturns information about all of your database snapshots in Amazon Lightsail.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 336)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetRelationalDatabaseSnapshots request. If yourresults are paginated, the response will return a next page token that you can specify as the pagetoken in a subsequent request.
Type: String
Required: No
Response Syntax{ "nextPageToken": "string", "relationalDatabaseSnapshots": [ { "arn": "string", "createdAt": number, "engine": "string", "engineVersion": "string", "fromRelationalDatabaseArn": "string", "fromRelationalDatabaseBlueprintId": "string", "fromRelationalDatabaseBundleId": "string", "fromRelationalDatabaseName": "string", "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "sizeInGb": number, "state": "string", "supportCode": "string", "tags": [ { "key": "string", "value": "string" }
API Version 2016-11-28336
Amazon Lightsail API ReferenceResponse Elements
] } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
nextPageToken (p. 336)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetRelationalDatabaseSnapshots requestand specify the next page token using the pageToken parameter.
Type: StringrelationalDatabaseSnapshots (p. 336)
An object describing the result of your get relational database snapshots request.
Type: Array of RelationalDatabaseSnapshot (p. 554) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-28337
Amazon Lightsail API ReferenceSee Also
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28338
Amazon Lightsail API ReferenceGetStaticIp
GetStaticIpReturns information about a specific static IP.
Request Syntax{ "staticIpName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
staticIpName (p. 339)
The name of the static IP in Lightsail.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "staticIp": { "arn": "string", "attachedTo": "string", "createdAt": number, "ipAddress": "string", "isAttached": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string" }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
staticIp (p. 339)
An array of key-value pairs containing information about the requested static IP.
API Version 2016-11-28339
Amazon Lightsail API ReferenceErrors
Type: StaticIp (p. 561) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++
API Version 2016-11-28340
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28341
Amazon Lightsail API ReferenceGetStaticIps
GetStaticIpsReturns information about all static IPs in the user's account.
Request Syntax{ "pageToken": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
pageToken (p. 342)
The token to advance to the next page of results from your request.
To get a page token, perform an initial GetStaticIps request. If your results are paginated, theresponse will return a next page token that you can specify as the page token in a subsequentrequest.
Type: String
Required: No
Response Syntax{ "nextPageToken": "string", "staticIps": [ { "arn": "string", "attachedTo": "string", "createdAt": number, "ipAddress": "string", "isAttached": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "name": "string", "resourceType": "string", "supportCode": "string" } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28342
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
nextPageToken (p. 342)
The token to advance to the next page of resutls from your request.
A next page token is not returned if there are no more results to display.
To get the next page of results, perform another GetStaticIps request and specify the next pagetoken using the pageToken parameter.
Type: StringstaticIps (p. 342)
An array of key-value pairs containing information about your get static IPs request.
Type: Array of StaticIp (p. 561) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28343
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28344
Amazon Lightsail API ReferenceImportKeyPair
ImportKeyPairImports a public SSH key from a specific key pair.
Request Syntax{ "keyPairName": "string", "publicKeyBase64": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
keyPairName (p. 345)
The name of the key pair for which you want to import the public key.
Type: String
Pattern: \w[\w\-]*\w
Required: YespublicKeyBase64 (p. 345)
A base64-encoded public key of the ssh-rsa type.
Type: String
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
API Version 2016-11-28345
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 345)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28346
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28347
Amazon Lightsail API ReferenceIsVpcPeered
IsVpcPeeredReturns a Boolean value indicating whether your Lightsail VPC is peered.
Response Syntax{ "isPeered": boolean}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
isPeered (p. 348)
Returns true if the Lightsail VPC is peered; otherwise, false.
Type: Boolean
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28348
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28349
Amazon Lightsail API ReferenceOpenInstancePublicPorts
OpenInstancePublicPortsOpens ports for a specific Amazon Lightsail instance, and specifies the IP addresses allowed to connectto the instance through the ports, and the protocol.
The OpenInstancePublicPorts action supports tag-based access control via resource tags applied tothe resource identified by instanceName. For more information, see the Lightsail Dev Guide.
Request Syntax{ "instanceName": "string", "portInfo": { "cidrListAliases": [ "string" ], "cidrs": [ "string" ], "fromPort": number, "protocol": "string", "toPort": number }}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 350)
The name of the instance for which to open ports.
Type: String
Pattern: \w[\w\-]*\w
Required: YesportInfo (p. 350)
An object to describe the ports to open for the specified instance.
Type: PortInfo (p. 536) object
Required: Yes
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string",
API Version 2016-11-28350
Amazon Lightsail API ReferenceResponse Elements
"regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 350)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28351
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28352
Amazon Lightsail API ReferencePeerVpc
PeerVpcTries to peer the Lightsail VPC with the user's default VPC.
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 353)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-28353
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28354
Amazon Lightsail API ReferencePutAlarm
PutAlarmCreates or updates an alarm, and associates it with the specified metric.
An alarm is used to monitor a single metric for one of your resources. When a metric condition is met,the alarm can notify you by email, SMS text message, and a banner displayed on the Amazon Lightsailconsole. For more information, see Alarms in Amazon Lightsail.
When this action creates an alarm, the alarm state is immediately set to INSUFFICIENT_DATA. Thealarm is then evaluated and its state is set appropriately. Any actions associated with the new state arethen executed.
When you update an existing alarm, its state is left unchanged, but the update completely overwrites theprevious configuration of the alarm. The alarm is then evaluated with the updated configuration.
Request Syntax{ "alarmName": "string", "comparisonOperator": "string", "contactProtocols": [ "string" ], "datapointsToAlarm": number, "evaluationPeriods": number, "metricName": "string", "monitoredResourceName": "string", "notificationEnabled": boolean, "notificationTriggers": [ "string" ], "threshold": number, "treatMissingData": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
alarmName (p. 355)
The name for the alarm. Specify the name of an existing alarm to update, and overwrite theprevious configuration of the alarm.
Type: String
Pattern: \w[\w\-]*\w
Required: YescomparisonOperator (p. 355)
The arithmetic operation to use when comparing the specified statistic to the threshold. Thespecified statistic value is used as the first operand.
Type: String
Valid Values: GreaterThanOrEqualToThreshold | GreaterThanThreshold |LessThanThreshold | LessThanOrEqualToThreshold
Required: Yes
API Version 2016-11-28355
Amazon Lightsail API ReferenceRequest Parameters
contactProtocols (p. 355)
The contact protocols to use for the alarm, such as Email, SMS (text messaging), or both.
A notification is sent via the specified contact protocol if notifications are enabled for the alarm, andwhen the alarm is triggered.
A notification is not sent if a contact protocol is not specified, if the specified contact protocolis not configured in the AWS Region, or if notifications are not enabled for the alarm using thenotificationEnabled paramater.
Use the CreateContactMethod action to configure a contact protocol in an AWS Region.
Type: Array of strings
Valid Values: Email | SMS
Required: NodatapointsToAlarm (p. 355)
The number of data points that must be not within the specified threshold to trigger the alarm. Ifyou are setting an "M out of N" alarm, this value (datapointsToAlarm) is the M.
Type: Integer
Required: NoevaluationPeriods (p. 355)
The number of most recent periods over which data is compared to the specified threshold. If youare setting an "M out of N" alarm, this value (evaluationPeriods) is the N.
If you are setting an alarm that requires that a number of consecutive data points be breaching totrigger the alarm, this value specifies the rolling period of time in which data points are evaluated.
Each evaluation period is five minutes long. For example, specify an evaluation period of 24 toevaluate a metric over a rolling period of two hours.
You can specify a minimum valuation period of 1 (5 minutes), and a maximum evaluation period of288 (24 hours).
Type: Integer
Required: YesmetricName (p. 355)
The name of the metric to associate with the alarm.
You can configure up to two alarms per metric.
The following metrics are available for each resource type:• Instances: BurstCapacityPercentage, BurstCapacityTime, CPUUtilization,NetworkIn, NetworkOut, StatusCheckFailed, StatusCheckFailed_Instance, andStatusCheckFailed_System.
• Load balancers: ClientTLSNegotiationErrorCount, HealthyHostCount,UnhealthyHostCount, HTTPCode_LB_4XX_Count, HTTPCode_LB_5XX_Count,HTTPCode_Instance_2XX_Count, HTTPCode_Instance_3XX_Count,HTTPCode_Instance_4XX_Count, HTTPCode_Instance_5XX_Count,InstanceResponseTime, RejectedConnectionCount, and RequestCount.
• Relational databases: CPUUtilization, DatabaseConnections, DiskQueueDepth,FreeStorageSpace, NetworkReceiveThroughput, and NetworkTransmitThroughput.
API Version 2016-11-28356
Amazon Lightsail API ReferenceRequest Parameters
For more information about these metrics, see Metrics available in Lightsail.
Type: String
Valid Values: CPUUtilization | NetworkIn | NetworkOut | StatusCheckFailed| StatusCheckFailed_Instance | StatusCheckFailed_System |ClientTLSNegotiationErrorCount | HealthyHostCount | UnhealthyHostCount |HTTPCode_LB_4XX_Count | HTTPCode_LB_5XX_Count | HTTPCode_Instance_2XX_Count| HTTPCode_Instance_3XX_Count | HTTPCode_Instance_4XX_Count |HTTPCode_Instance_5XX_Count | InstanceResponseTime | RejectedConnectionCount| RequestCount | DatabaseConnections | DiskQueueDepth | FreeStorageSpace |NetworkReceiveThroughput | NetworkTransmitThroughput | BurstCapacityTime |BurstCapacityPercentage
Required: YesmonitoredResourceName (p. 355)
The name of the Lightsail resource that will be monitored.
Instances, load balancers, and relational databases are the only Lightsail resources that can currentlybe monitored by alarms.
Type: String
Pattern: \w[\w\-]*\w
Required: YesnotificationEnabled (p. 355)
Indicates whether the alarm is enabled.
Notifications are enabled by default if you don't specify this parameter.
Type: Boolean
Required: NonotificationTriggers (p. 355)
The alarm states that trigger a notification.
An alarm has the following possible states:• ALARM - The metric is outside of the defined threshold.• INSUFFICIENT_DATA - The alarm has just started, the metric is not available, or not enough data
is available for the metric to determine the alarm state.• OK - The metric is within the defined threshold.
When you specify a notification trigger, the ALARM state must be specified. TheINSUFFICIENT_DATA and OK states can be specified in addition to the ALARM state.• If you specify OK as an alarm trigger, a notification is sent when the alarm switches from an ALARM
or INSUFFICIENT_DATA alarm state to an OK state. This can be thought of as an all clear alarmnotification.
• If you specify INSUFFICIENT_DATA as the alarm trigger, a notification is sent when the alarmswitches from an OK or ALARM alarm state to an INSUFFICIENT_DATA state.
The notification trigger defaults to ALARM if you don't specify this parameter.
Type: Array of strings
Valid Values: OK | ALARM | INSUFFICIENT_DATA
API Version 2016-11-28357
Amazon Lightsail API ReferenceResponse Syntax
Required: Nothreshold (p. 355)
The value against which the specified statistic is compared.
Type: Double
Required: YestreatMissingData (p. 355)
Sets how this alarm will handle missing data points.
An alarm can treat missing data in the following ways:• breaching - Assume the missing data is not within the threshold. Missing data counts towards
the number of times the metric is not within the threshold.• notBreaching - Assume the missing data is within the threshold. Missing data does not count
towards the number of times the metric is not within the threshold.• ignore - Ignore the missing data. Maintains the current alarm state.• missing - Missing data is treated as missing.
If treatMissingData is not specified, the default behavior of missing is used.
Type: String
Valid Values: breaching | notBreaching | ignore | missing
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28358
Amazon Lightsail API ReferenceErrors
operations (p. 358)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go
API Version 2016-11-28359
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28360
Amazon Lightsail API ReferencePutInstancePublicPorts
PutInstancePublicPortsOpens ports for a specific Amazon Lightsail instance, and specifies the IP addresses allowed to connectto the instance through the ports, and the protocol. This action also closes all currently open ports thatare not included in the request. Include all of the ports and the protocols you want to open in yourPutInstancePublicPortsrequest. Or use the OpenInstancePublicPorts action to open portswithout closing currently open ports.
The PutInstancePublicPorts action supports tag-based access control via resource tags applied tothe resource identified by instanceName. For more information, see the Lightsail Dev Guide.
Request Syntax{ "instanceName": "string", "portInfos": [ { "cidrListAliases": [ "string" ], "cidrs": [ "string" ], "fromPort": number, "protocol": "string", "toPort": number } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 361)
The name of the instance for which to open ports.
Type: String
Pattern: \w[\w\-]*\w
Required: YesportInfos (p. 361)
An array of objects to describe the ports to open for the specified instance.
Type: Array of PortInfo (p. 536) objects
Required: Yes
Response Syntax{ "operation": { "createdAt": number,
API Version 2016-11-28361
Amazon Lightsail API ReferenceResponse Elements
"errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 361)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-28362
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28363
Amazon Lightsail API ReferenceRebootInstance
RebootInstanceRestarts a specific instance.
The reboot instance operation supports tag-based access control via resource tags applied to theresource identified by instance name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 364)
The name of the instance to reboot.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
API Version 2016-11-28364
Amazon Lightsail API ReferenceErrors
The following data is returned in JSON format by the service.
operations (p. 364)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28365
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28366
Amazon Lightsail API ReferenceRebootRelationalDatabase
RebootRelationalDatabaseRestarts a specific database in Amazon Lightsail.
The reboot relational database operation supports tag-based access control via resource tagsapplied to the resource identified by relationalDatabaseName. For more information, see the LightsailDev Guide.
Request Syntax
{ "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseName (p. 367)
The name of your database to reboot.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax
{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28367
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 367)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28368
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28369
Amazon Lightsail API ReferenceReleaseStaticIp
ReleaseStaticIpDeletes a specific static IP from your account.
Request Syntax{ "staticIpName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
staticIpName (p. 370)
The name of the static IP to delete.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28370
Amazon Lightsail API ReferenceErrors
operations (p. 370)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28371
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28372
Amazon Lightsail API ReferenceResetDistributionCache
ResetDistributionCacheDeletes currently cached content from your Amazon Lightsail content delivery network (CDN)distribution.
After resetting the cache, the next time a content request is made, your distribution pulls, serves, andcaches it from the origin.
Request Syntax{ "distributionName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
distributionName (p. 373)
The name of the distribution for which to reset cache.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
Required: No
Response Syntax{ "createTime": number, "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }, "status": "string"}
API Version 2016-11-28373
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
createTime (p. 373)
The timestamp of the reset cache request (e.g., 1479734909.17) in Unix time format.
Type: Timestampoperation (p. 373)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) objectstatus (p. 373)
The status of the reset cache request.
Type: String
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28374
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28375
Amazon Lightsail API ReferenceSendContactMethodVerification
SendContactMethodVerificationSends a verification request to an email contact method to ensure it's owned by the requester. SMScontact methods don't need to be verified.
A contact method is used to send you notifications about your Amazon Lightsail resources. You can addone email address and one mobile phone number contact method in each AWS Region. However, SMStext messaging is not supported in some AWS Regions, and SMS text messages cannot be sent to somecountries/regions. For more information, see Notifications in Amazon Lightsail.
A verification request is sent to the contact method when you initially create it. Use this action to sendanother verification request if a previous verification request was deleted, or has expired.
ImportantNotifications are not sent to an email contact method until after it is verified, and confirmed asvalid.
Request Syntax{ "protocol": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
protocol (p. 376)
The protocol to verify, such as Email or SMS (text messaging).
Type: String
Valid Values: Email
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string",
API Version 2016-11-28376
Amazon Lightsail API ReferenceResponse Elements
"resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 376)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
API Version 2016-11-28377
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28378
Amazon Lightsail API ReferenceStartInstance
StartInstanceStarts a specific Amazon Lightsail instance from a stopped state. To restart an instance, use the rebootinstance operation.
NoteWhen you start a stopped instance, Lightsail assigns a new public IP address to the instance. Touse the same IP address after stopping and starting an instance, create a static IP address andattach it to the instance. For more information, see the Lightsail Dev Guide.
The start instance operation supports tag-based access control via resource tags applied to theresource identified by instance name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
instanceName (p. 379)
The name of the instance (a virtual private server) to start.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number
API Version 2016-11-28379
Amazon Lightsail API ReferenceResponse Elements
} ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 379)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28380
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28381
Amazon Lightsail API ReferenceStartRelationalDatabase
StartRelationalDatabaseStarts a specific database from a stopped state in Amazon Lightsail. To restart a database, use thereboot relational database operation.
The start relational database operation supports tag-based access control via resource tagsapplied to the resource identified by relationalDatabaseName. For more information, see the LightsailDev Guide.
Request Syntax{ "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseName (p. 382)
The name of your database to start.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
API Version 2016-11-28382
Amazon Lightsail API ReferenceResponse Elements
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 382)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
API Version 2016-11-28383
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28384
Amazon Lightsail API ReferenceStopInstance
StopInstanceStops a specific Amazon Lightsail instance that is currently running.
NoteWhen you start a stopped instance, Lightsail assigns a new public IP address to the instance. Touse the same IP address after stopping and starting an instance, create a static IP address andattach it to the instance. For more information, see the Lightsail Dev Guide.
The stop instance operation supports tag-based access control via resource tags applied to theresource identified by instance name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "force": boolean, "instanceName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
force (p. 385)
When set to True, forces a Lightsail instance that is stuck in a stopping state to stop.
ImportantOnly use the force parameter if your instance is stuck in the stopping state. In anyother state, your instance should stop normally without adding this parameter to your APIrequest.
Type: Boolean
Required: NoinstanceName (p. 385)
The name of the instance (a virtual private server) to stop.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string",
API Version 2016-11-28385
Amazon Lightsail API ReferenceResponse Elements
"id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 385)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400
API Version 2016-11-28386
Amazon Lightsail API ReferenceSee Also
OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28387
Amazon Lightsail API ReferenceStopRelationalDatabase
StopRelationalDatabaseStops a specific database that is currently running in Amazon Lightsail.
The stop relational database operation supports tag-based access control via resource tagsapplied to the resource identified by relationalDatabaseName. For more information, see the LightsailDev Guide.
Request Syntax{ "relationalDatabaseName": "string", "relationalDatabaseSnapshotName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
relationalDatabaseName (p. 388)
The name of your database to stop.
Type: String
Pattern: \w[\w\-]*\w
Required: YesrelationalDatabaseSnapshotName (p. 388)
The name of your new database snapshot to be created before stopping your database.
Type: String
Pattern: \w[\w\-]*\w
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string",
API Version 2016-11-28388
Amazon Lightsail API ReferenceResponse Elements
"operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 388)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400
API Version 2016-11-28389
Amazon Lightsail API ReferenceSee Also
ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28390
Amazon Lightsail API ReferenceTagResource
TagResourceAdds one or more tags to the specified Amazon Lightsail resource. Each resource can have a maximum of50 tags. Each tag consists of a key and an optional value. Tag keys must be unique per resource. For moreinformation about tags, see the Lightsail Dev Guide.
The tag resource operation supports tag-based access control via request tags and resource tagsapplied to the resource identified by resource name. For more information, see the Lightsail DevGuide.
Request Syntax{ "resourceArn": "string", "resourceName": "string", "tags": [ { "key": "string", "value": "string" } ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
resourceArn (p. 391)
The Amazon Resource Name (ARN) of the resource to which you want to add a tag.
Type: String
Pattern: ^arn:(aws[^:]*):([a-zA-Z0-9-]+):([a-z0-9-]+):([0-9]+):([a-zA-Z]+)/([a-zA-Z0-9-]+)$
Required: NoresourceName (p. 391)
The name of the resource to which you are adding tags.
Type: String
Pattern: \w[\w\-]*\w
Required: Yestags (p. 391)
The tag key and optional value.
Type: Array of Tag (p. 563) objects
Required: Yes
API Version 2016-11-28391
Amazon Lightsail API ReferenceResponse Syntax
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 392)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400
AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-28392
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28393
Amazon Lightsail API ReferenceTestAlarm
TestAlarmTests an alarm by displaying a banner on the Amazon Lightsail console. If a notification trigger isconfigured for the specified alarm, the test also sends a notification to the notification protocol (Emailand/or SMS) configured for the alarm.
An alarm is used to monitor a single metric for one of your resources. When a metric condition is met,the alarm can notify you by email, SMS text message, and a banner displayed on the Amazon Lightsailconsole. For more information, see Alarms in Amazon Lightsail.
Request Syntax{ "alarmName": "string", "state": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
alarmName (p. 394)
The name of the alarm to test.
Type: String
Pattern: \w[\w\-]*\w
Required: Yesstate (p. 394)
The alarm state to test.
An alarm has the following possible states that can be tested:• ALARM - The metric is outside of the defined threshold.• INSUFFICIENT_DATA - The alarm has just started, the metric is not available, or not enough data
is available for the metric to determine the alarm state.• OK - The metric is within the defined threshold.
Type: String
Valid Values: OK | ALARM | INSUFFICIENT_DATA
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number,
API Version 2016-11-28394
Amazon Lightsail API ReferenceResponse Elements
"errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 394)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28395
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28396
Amazon Lightsail API ReferenceUnpeerVpc
UnpeerVpcAttempts to unpeer the Lightsail VPC from the user's default VPC.
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 397)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-28397
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28398
Amazon Lightsail API ReferenceUntagResource
UntagResourceDeletes the specified set of tag keys and their values from the specified Amazon Lightsail resource.
The untag resource operation supports tag-based access control via request tags and resource tagsapplied to the resource identified by resource name. For more information, see the Lightsail DevGuide.
Request Syntax{ "resourceArn": "string", "resourceName": "string", "tagKeys": [ "string" ]}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
resourceArn (p. 399)
The Amazon Resource Name (ARN) of the resource from which you want to remove a tag.
Type: String
Pattern: ^arn:(aws[^:]*):([a-zA-Z0-9-]+):([a-z0-9-]+):([0-9]+):([a-zA-Z]+)/([a-zA-Z0-9-]+)$
Required: NoresourceName (p. 399)
The name of the resource from which you are removing a tag.
Type: String
Pattern: \w[\w\-]*\w
Required: YestagKeys (p. 399)
The tag keys to delete from the specified resource.
Type: Array of strings
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number,
API Version 2016-11-28399
Amazon Lightsail API ReferenceResponse Elements
"errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 399)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
API Version 2016-11-28400
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28401
Amazon Lightsail API ReferenceUpdateDistribution
UpdateDistributionUpdates an existing Amazon Lightsail content delivery network (CDN) distribution.
Use this action to update the configuration of your existing distribution
Request Syntax{ "cacheBehaviors": [ { "behavior": "string", "path": "string" } ], "cacheBehaviorSettings": { "allowedHTTPMethods": "string", "cachedHTTPMethods": "string", "defaultTTL": number, "forwardedCookies": { "cookiesAllowList": [ "string" ], "option": "string" }, "forwardedHeaders": { "headersAllowList": [ "string" ], "option": "string" }, "forwardedQueryStrings": { "option": boolean, "queryStringsAllowList": [ "string" ] }, "maximumTTL": number, "minimumTTL": number }, "defaultCacheBehavior": { "behavior": "string" }, "distributionName": "string", "isEnabled": boolean, "origin": { "name": "string", "protocolPolicy": "string", "regionName": "string" }}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
cacheBehaviors (p. 402)
An array of objects that describe the per-path cache behavior for the distribution.
Type: Array of CacheBehaviorPerPath (p. 442) objects
Required: No
API Version 2016-11-28402
Amazon Lightsail API ReferenceResponse Syntax
cacheBehaviorSettings (p. 402)
An object that describes the cache behavior settings for the distribution.
NoteThe cacheBehaviorSettings specified in your UpdateDistributionRequest willreplace your distribution's existing settings.
Type: CacheSettings (p. 444) object
Required: NodefaultCacheBehavior (p. 402)
An object that describes the default cache behavior for the distribution.
Type: CacheBehavior (p. 441) object
Required: NodistributionName (p. 402)
The name of the distribution to update.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
Required: YesisEnabled (p. 402)
Indicates whether to enable the distribution.
Type: Boolean
Required: Noorigin (p. 402)
An object that describes the origin resource for the distribution, such as a Lightsail instance or loadbalancer.
The distribution pulls, caches, and serves content from the origin.
Type: InputOrigin (p. 480) object
Required: No
Response Syntax{ "operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string"
API Version 2016-11-28403
Amazon Lightsail API ReferenceResponse Elements
}, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 403)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500
API Version 2016-11-28404
Amazon Lightsail API ReferenceSee Also
UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28405
Amazon Lightsail API ReferenceUpdateDistributionBundle
UpdateDistributionBundleUpdates the bundle of your Amazon Lightsail content delivery network (CDN) distribution.
A distribution bundle specifies the monthly network transfer quota and monthly cost of yourdsitribution.
Update your distribution's bundle if your distribution is going over its monthly network transfer quotaand is incurring an overage fee.
You can update your distribution's bundle only one time within your monthly AWS billing cycle. Todetermine if you can update your distribution's bundle, use the GetDistributions action. TheableToUpdateBundle parameter in the result will indicate whether you can currently update yourdistribution's bundle.
Request Syntax{ "bundleId": "string", "distributionName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
bundleId (p. 406)
The bundle ID of the new bundle to apply to your distribution.
Use the GetDistributionBundles action to get a list of distribution bundle IDs that you canspecify.
Type: String
Required: NodistributionName (p. 406)
The name of the distribution for which to update the bundle.
Use the GetDistributions action to get a list of distribution names that you can specify.
Type: String
Pattern: \w[\w\-]*\w
Required: No
Response Syntax{
API Version 2016-11-28406
Amazon Lightsail API ReferenceResponse Elements
"operation": { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number }}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operation (p. 406)
Describes the API operation.
Type: Operation (p. 528) object
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28407
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28408
Amazon Lightsail API ReferenceUpdateDomainEntry
UpdateDomainEntryUpdates a domain recordset after it is created.
The update domain entry operation supports tag-based access control via resource tags applied tothe resource identified by domain name. For more information, see the Lightsail Dev Guide.
Request Syntax{ "domainEntry": { "id": "string", "isAlias": boolean, "name": "string", "options": { "string" : "string" }, "target": "string", "type": "string" }, "domainName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
domainEntry (p. 409)
An array of key-value pairs containing information about the domain entry.
Type: DomainEntry (p. 470) object
Required: YesdomainName (p. 409)
The name of the domain recordset to update.
Type: String
Required: Yes
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string",
API Version 2016-11-28409
Amazon Lightsail API ReferenceResponse Elements
"regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 409)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
API Version 2016-11-28410
Amazon Lightsail API ReferenceSee Also
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28411
Amazon Lightsail API ReferenceUpdateLoadBalancerAttribute
UpdateLoadBalancerAttributeUpdates the specified attribute for a load balancer. You can only update one attribute at a time.
The update load balancer attribute operation supports tag-based access control via resourcetags applied to the resource identified by load balancer name. For more information, see theLightsail Dev Guide.
Request Syntax{ "attributeName": "string", "attributeValue": "string", "loadBalancerName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
attributeName (p. 412)
The name of the attribute you want to update. Valid values are below.
Type: String
Valid Values: HealthCheckPath | SessionStickinessEnabled |SessionStickiness_LB_CookieDurationSeconds
Required: YesattributeValue (p. 412)
The value that you want to specify for the attribute name.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 256.
Required: YesloadBalancerName (p. 412)
The name of the load balancer that you want to modify (e.g., my-load-balancer.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
Response Syntax{
API Version 2016-11-28412
Amazon Lightsail API ReferenceResponse Elements
"operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 412)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400
API Version 2016-11-28413
Amazon Lightsail API ReferenceSee Also
NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28414
Amazon Lightsail API ReferenceUpdateRelationalDatabase
UpdateRelationalDatabaseAllows the update of one or more attributes of a database in Amazon Lightsail.
Updates are applied immediately, or in cases where the updates could result in an outage, are appliedduring the database's predefined maintenance window.
The update relational database operation supports tag-based access control via resource tagsapplied to the resource identified by relationalDatabaseName. For more information, see the LightsailDev Guide.
Request Syntax{ "applyImmediately": boolean, "caCertificateIdentifier": "string", "disableBackupRetention": boolean, "enableBackupRetention": boolean, "masterUserPassword": "string", "preferredBackupWindow": "string", "preferredMaintenanceWindow": "string", "publiclyAccessible": boolean, "relationalDatabaseName": "string", "rotateMasterUserPassword": boolean}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
applyImmediately (p. 415)
When true, applies changes immediately. When false, applies changes during the preferredmaintenance window. Some changes may cause an outage.
Default: false
Type: Boolean
Required: NocaCertificateIdentifier (p. 415)
Indicates the certificate that needs to be associated with the database.
Type: String
Required: NodisableBackupRetention (p. 415)
When true, disables automated backup retention for your database.
Disabling backup retention deletes all automated database backups. Before disabling this, you maywant to create a snapshot of your database using the create relational database snapshotoperation.
API Version 2016-11-28415
Amazon Lightsail API ReferenceRequest Parameters
Updates are applied during the next maintenance window because this can result in an outage.
Type: Boolean
Required: NoenableBackupRetention (p. 415)
When true, enables automated backup retention for your database.
Updates are applied during the next maintenance window because this can result in an outage.
Type: Boolean
Required: NomasterUserPassword (p. 415)
The password for the master user of your database. The password can include any printable ASCIIcharacter except "/", """, or "@".
Constraints: Must contain 8 to 41 characters.
Type: String
Required: NopreferredBackupWindow (p. 415)
The daily time range during which automated backups are created for your database if automatedbackups are enabled.
Constraints:• Must be in the hh24:mi-hh24:mi format.
Example: 16:00-16:30• Specified in Coordinated Universal Time (UTC).• Must not conflict with the preferred maintenance window.• Must be at least 30 minutes.
Type: String
Required: NopreferredMaintenanceWindow (p. 415)
The weekly time range during which system maintenance can occur on your database.
The default is a 30-minute window selected at random from an 8-hour block of time for each AWSRegion, occurring on a random day of the week.
Constraints:• Must be in the ddd:hh24:mi-ddd:hh24:mi format.• Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.• Must be at least 30 minutes.• Specified in Coordinated Universal Time (UTC).• Example: Tue:17:00-Tue:17:30
Type: String
Required: No
API Version 2016-11-28416
Amazon Lightsail API ReferenceResponse Syntax
publiclyAccessible (p. 415)
Specifies the accessibility options for your database. A value of true specifies a database that isavailable to resources outside of your Lightsail account. A value of false specifies a database that isavailable only to your Lightsail resources in the same region as your database.
Type: Boolean
Required: NorelationalDatabaseName (p. 415)
The name of your database to update.
Type: String
Pattern: \w[\w\-]*\w
Required: YesrotateMasterUserPassword (p. 415)
When true, the master user password is changed to a new strong password generated by Lightsail.
Use the get relational database master user password operation to get the newpassword.
Type: Boolean
Required: No
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
API Version 2016-11-28417
Amazon Lightsail API ReferenceErrors
operations (p. 417)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28418
Amazon Lightsail API ReferenceSee Also
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28419
Amazon Lightsail API ReferenceUpdateRelationalDatabaseParameters
UpdateRelationalDatabaseParametersAllows the update of one or more parameters of a database in Amazon Lightsail.
Parameter updates don't cause outages; therefore, their application is not subject to the preferredmaintenance window. However, there are two ways in which parameter updates are applied: dynamic orpending-reboot. Parameters marked with a dynamic apply type are applied immediately. Parametersmarked with a pending-reboot apply type are applied only after the database is rebooted using thereboot relational database operation.
The update relational database parameters operation supports tag-based access control viaresource tags applied to the resource identified by relationalDatabaseName. For more information, seethe Lightsail Dev Guide.
Request Syntax
{ "parameters": [ { "allowedValues": "string", "applyMethod": "string", "applyType": "string", "dataType": "string", "description": "string", "isModifiable": boolean, "parameterName": "string", "parameterValue": "string" } ], "relationalDatabaseName": "string"}
Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 564).
The request accepts the following data in JSON format.
parameters (p. 420)
The database parameters to update.
Type: Array of RelationalDatabaseParameter (p. 552) objects
Required: Yes
relationalDatabaseName (p. 420)
The name of your database for which to update parameters.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
API Version 2016-11-28420
Amazon Lightsail API ReferenceResponse Syntax
Response Syntax{ "operations": [ { "createdAt": number, "errorCode": "string", "errorDetails": "string", "id": "string", "isTerminal": boolean, "location": { "availabilityZone": "string", "regionName": "string" }, "operationDetails": "string", "operationType": "string", "resourceName": "string", "resourceType": "string", "status": "string", "statusChangedAt": number } ]}
Response ElementsIf the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
operations (p. 421)
An array of objects that describe the result of the action, such as the status of the request, thetimestamp of the request, and the resources affected by the request.
Type: Array of Operation (p. 528) objects
ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 566).
AccessDeniedException
Lightsail throws this exception when the user cannot be authenticated or uses invalid credentials toaccess a resource.
HTTP Status Code: 400
AccountSetupInProgressException
Lightsail throws this exception when an account is still in the setup in progress state.
HTTP Status Code: 400
InvalidInputException
Lightsail throws this exception when user input does not conform to the validation rules of an inputfield.
API Version 2016-11-28421
Amazon Lightsail API ReferenceSee Also
NoteDomain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set yourAWS Region configuration to us-east-1 to create, view, or edit these resources.
HTTP Status Code: 400NotFoundException
Lightsail throws this exception when it cannot find a resource.
HTTP Status Code: 400OperationFailureException
Lightsail throws this exception when an operation fails to execute.
HTTP Status Code: 400ServiceException
A general service exception.
HTTP Status Code: 500UnauthenticatedException
Lightsail throws this exception when the user has not been authenticated.
HTTP Status Code: 400
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V3
API Version 2016-11-28422
Amazon Lightsail API Reference
Data TypesThe Amazon Lightsail API contains several data types that various actions use. This section describeseach data type in detail.
NoteThe order of each element in a data type structure is not guaranteed. Applications should notassume a particular order.
The following data types are supported:
• AddOn (p. 425)• AddOnRequest (p. 427)• Alarm (p. 428)• AttachedDisk (p. 432)• AutoSnapshotAddOnRequest (p. 433)• AutoSnapshotDetails (p. 434)• AvailabilityZone (p. 435)• Blueprint (p. 436)• Bundle (p. 439)• CacheBehavior (p. 441)• CacheBehaviorPerPath (p. 442)• CacheSettings (p. 444)• Certificate (p. 446)• CertificateSummary (p. 450)• CloudFormationStackRecord (p. 451)• CloudFormationStackRecordSourceInfo (p. 453)• ContactMethod (p. 454)• CookieObject (p. 456)• DestinationInfo (p. 457)• Disk (p. 458)• DiskInfo (p. 461)• DiskMap (p. 462)• DiskSnapshot (p. 463)• DiskSnapshotInfo (p. 466)• DistributionBundle (p. 467)• Domain (p. 468)• DomainEntry (p. 470)• DomainValidationRecord (p. 472)• ExportSnapshotRecord (p. 473)• ExportSnapshotRecordSourceInfo (p. 475)• HeaderObject (p. 477)• HostKeyAttributes (p. 478)• InputOrigin (p. 480)• Instance (p. 481)• InstanceAccessDetails (p. 485)
API Version 2016-11-28423
Amazon Lightsail API Reference
• InstanceEntry (p. 487)• InstanceHardware (p. 489)• InstanceHealthSummary (p. 490)• InstanceNetworking (p. 492)• InstancePortInfo (p. 493)• InstancePortState (p. 496)• InstanceSnapshot (p. 498)• InstanceSnapshotInfo (p. 501)• InstanceState (p. 502)• KeyPair (p. 503)• LightsailDistribution (p. 505)• LoadBalancer (p. 509)• LoadBalancerTlsCertificate (p. 512)• LoadBalancerTlsCertificateDomainValidationOption (p. 517)• LoadBalancerTlsCertificateDomainValidationRecord (p. 518)• LoadBalancerTlsCertificateRenewalSummary (p. 520)• LoadBalancerTlsCertificateSummary (p. 522)• LogEvent (p. 523)• MetricDatapoint (p. 524)• MonitoredResourceInfo (p. 526)• MonthlyTransfer (p. 527)• Operation (p. 528)• Origin (p. 531)• PasswordData (p. 533)• PendingMaintenanceAction (p. 534)• PendingModifiedRelationalDatabaseValues (p. 535)• PortInfo (p. 536)• QueryStringObject (p. 538)• Region (p. 539)• RelationalDatabase (p. 541)• RelationalDatabaseBlueprint (p. 545)• RelationalDatabaseBundle (p. 547)• RelationalDatabaseEndpoint (p. 549)• RelationalDatabaseEvent (p. 550)• RelationalDatabaseHardware (p. 551)• RelationalDatabaseParameter (p. 552)• RelationalDatabaseSnapshot (p. 554)• RenewalSummary (p. 557)• ResourceLocation (p. 559)• ResourceRecord (p. 560)• StaticIp (p. 561)• Tag (p. 563)
API Version 2016-11-28424
Amazon Lightsail API ReferenceAddOn
AddOnDescribes an add-on that is enabled for an Amazon Lightsail resource.
Contentsname
The name of the add-on.
Type: String
Required: NonextSnapshotTimeOfDay
The next daily time an automatic snapshot will be created.
The time shown is in HH:00 format, and in Coordinated Universal Time (UTC).
The snapshot is automatically created between the time shown and up to 45 minutes after.
Type: String
Pattern: ^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$
Required: NosnapshotTimeOfDay
The daily time when an automatic snapshot is created.
The time shown is in HH:00 format, and in Coordinated Universal Time (UTC).
The snapshot is automatically created between the time shown and up to 45 minutes after.
Type: String
Pattern: ^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$
Required: Nostatus
The status of the add-on.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28425
Amazon Lightsail API ReferenceSee Also
API Version 2016-11-28426
Amazon Lightsail API ReferenceAddOnRequest
AddOnRequestDescribes a request to enable, modify, or disable an add-on for an Amazon Lightsail resource.
NoteAn additional cost may be associated with enabling add-ons. For more information, see theLightsail pricing page.
ContentsaddOnType
The add-on type.
Type: String
Valid Values: AutoSnapshot
Required: YesautoSnapshotAddOnRequest
An object that represents additional parameters when enabling or modifying the automaticsnapshot add-on.
Type: AutoSnapshotAddOnRequest (p. 433) object
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28427
Amazon Lightsail API ReferenceAlarm
AlarmDescribes an alarm.
An alarm is a way to monitor your Amazon Lightsail resource metrics. For more information, see Alarmsin Amazon Lightsail.
Contentsarn
The Amazon Resource Name (ARN) of the alarm.
Type: String
Pattern: .*\S.*
Required: NocomparisonOperator
The arithmetic operation used when comparing the specified statistic and threshold.
Type: String
Valid Values: GreaterThanOrEqualToThreshold | GreaterThanThreshold |LessThanThreshold | LessThanOrEqualToThreshold
Required: NocontactProtocols
The contact protocols for the alarm, such as Email, SMS (text messaging), or both.
Type: Array of strings
Valid Values: Email | SMS
Required: NocreatedAt
The timestamp when the alarm was created.
Type: Timestamp
Required: NodatapointsToAlarm
The number of data points that must not within the specified threshold to trigger the alarm.
Type: Integer
Required: NoevaluationPeriods
The number of periods over which data is compared to the specified threshold.
Type: Integer
Required: No
API Version 2016-11-28428
Amazon Lightsail API ReferenceContents
location
An object that lists information about the location of the alarm.
Type: ResourceLocation (p. 559) object
Required: NometricName
The name of the metric associated with the alarm.
Type: String
Valid Values: CPUUtilization | NetworkIn | NetworkOut | StatusCheckFailed| StatusCheckFailed_Instance | StatusCheckFailed_System |ClientTLSNegotiationErrorCount | HealthyHostCount | UnhealthyHostCount |HTTPCode_LB_4XX_Count | HTTPCode_LB_5XX_Count | HTTPCode_Instance_2XX_Count| HTTPCode_Instance_3XX_Count | HTTPCode_Instance_4XX_Count |HTTPCode_Instance_5XX_Count | InstanceResponseTime | RejectedConnectionCount| RequestCount | DatabaseConnections | DiskQueueDepth | FreeStorageSpace |NetworkReceiveThroughput | NetworkTransmitThroughput | BurstCapacityTime |BurstCapacityPercentage
Required: NomonitoredResourceInfo
An object that lists information about the resource monitored by the alarm.
Type: MonitoredResourceInfo (p. 526) object
Required: Noname
The name of the alarm.
Type: String
Pattern: \w[\w\-]*\w
Required: NonotificationEnabled
Indicates whether the alarm is enabled.
Type: Boolean
Required: NonotificationTriggers
The alarm states that trigger a notification.
Type: Array of strings
Valid Values: OK | ALARM | INSUFFICIENT_DATA
Required: Noperiod
The period, in seconds, over which the statistic is applied.
Type: Integer
API Version 2016-11-28429
Amazon Lightsail API ReferenceContents
Valid Range: Minimum value of 60. Maximum value of 86400.
Required: NoresourceType
The Lightsail resource type (e.g., Alarm).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: Nostate
The current state of the alarm.
An alarm has the following possible states:• ALARM - The metric is outside of the defined threshold.• INSUFFICIENT_DATA - The alarm has just started, the metric is not available, or not enough data
is available for the metric to determine the alarm state.• OK - The metric is within the defined threshold.
Type: String
Valid Values: OK | ALARM | INSUFFICIENT_DATA
Required: Nostatistic
The statistic for the metric associated with the alarm.
The following statistics are available:• Minimum - The lowest value observed during the specified period. Use this value to determine low
volumes of activity for your application.• Maximum - The highest value observed during the specified period. Use this value to determine
high volumes of activity for your application.• Sum - All values submitted for the matching metric added together. You can use this statistic to
determine the total volume of a metric.• Average - The value of Sum / SampleCount during the specified period. By comparing this
statistic with the Minimum and Maximum values, you can determine the full scope of a metric andhow close the average use is to the Minimum and Maximum values. This comparison helps you toknow when to increase or decrease your resources.
• SampleCount - The count, or number, of data points used for the statistical calculation.
Type: String
Valid Values: Minimum | Maximum | Sum | Average | SampleCount
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about yourLightsail alarm. This code enables our support team to look up your Lightsail information moreeasily.
API Version 2016-11-28430
Amazon Lightsail API ReferenceSee Also
Type: String
Required: Nothreshold
The value against which the specified statistic is compared.
Type: Double
Required: NotreatMissingData
Specifies how the alarm handles missing data points.
An alarm can treat missing data in the following ways:• breaching - Assume the missing data is not within the threshold. Missing data counts towards
the number of times the metric is not within the threshold.• notBreaching - Assume the missing data is within the threshold. Missing data does not count
towards the number of times the metric is not within the threshold.• ignore - Ignore the missing data. Maintains the current alarm state.• missing - Missing data is treated as missing.
Type: String
Valid Values: breaching | notBreaching | ignore | missing
Required: Nounit
The unit of the metric associated with the alarm.
Type: String
Valid Values: Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |Megabytes | Gigabytes | Terabytes | Bits | Kilobits | Megabits | Gigabits| Terabits | Percent | Count | Bytes/Second | Kilobytes/Second | Megabytes/Second | Gigabytes/Second | Terabytes/Second | Bits/Second | Kilobits/Second| Megabits/Second | Gigabits/Second | Terabits/Second | Count/Second | None
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28431
Amazon Lightsail API ReferenceAttachedDisk
AttachedDiskDescribes a block storage disk that is attached to an instance, and is included in an automatic snapshot.
Contentspath
The path of the disk (e.g., /dev/xvdf).
Type: String
Required: NosizeInGb
The size of the disk in GB.
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28432
Amazon Lightsail API ReferenceAutoSnapshotAddOnRequest
AutoSnapshotAddOnRequestDescribes a request to enable or modify the automatic snapshot add-on for an Amazon Lightsail instanceor disk.
When you modify the automatic snapshot time for a resource, it is typically effective immediately exceptunder the following conditions:
• If an automatic snapshot has been created for the current day, and you change the snapshot time to alater time of day, then the new snapshot time will be effective the following day. This ensures that twosnapshots are not created for the current day.
• If an automatic snapshot has not yet been created for the current day, and you change the snapshottime to an earlier time of day, then the new snapshot time will be effective the following day and asnapshot is automatically created at the previously set time for the current day. This ensures that asnapshot is created for the current day.
• If an automatic snapshot has not yet been created for the current day, and you change the snapshottime to a time that is within 30 minutes from your current time, then the new snapshot time will beeffective the following day and a snapshot is automatically created at the previously set time for thecurrent day. This ensures that a snapshot is created for the current day, because 30 minutes is requiredbetween your current time and the new snapshot time that you specify.
• If an automatic snapshot is scheduled to be created within 30 minutes from your current time andyou change the snapshot time, then the new snapshot time will be effective the following day and asnapshot is automatically created at the previously set time for the current day. This ensures that asnapshot is created for the current day, because 30 minutes is required between your current time andthe new snapshot time that you specify.
ContentssnapshotTimeOfDay
The daily time when an automatic snapshot will be created.
Constraints:• Must be in HH:00 format, and in an hourly increment.• Specified in Coordinated Universal Time (UTC).• The snapshot will be automatically created between the time specified and up to 45 minutes after.
Type: String
Pattern: ^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28433
Amazon Lightsail API ReferenceAutoSnapshotDetails
AutoSnapshotDetailsDescribes an automatic snapshot.
ContentscreatedAt
The timestamp when the automatic snapshot was created.
Type: Timestamp
Required: Nodate
The date of the automatic snapshot in YYYY-MM-DD format.
Type: String
Required: NofromAttachedDisks
An array of objects that describe the block storage disks attached to the instance when theautomatic snapshot was created.
Type: Array of AttachedDisk (p. 432) objects
Required: Nostatus
The status of the automatic snapshot.
Type: String
Valid Values: Success | Failed | InProgress | NotFound
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28434
Amazon Lightsail API ReferenceAvailabilityZone
AvailabilityZoneDescribes an Availability Zone.
Contentsstate
The state of the Availability Zone.
Type: String
Pattern: .*\S.*
Required: NozoneName
The name of the Availability Zone. The format is us-east-2a (case-sensitive).
Type: String
Pattern: .*\S.*
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28435
Amazon Lightsail API ReferenceBlueprint
BlueprintDescribes a blueprint (a virtual private server image).
ContentsblueprintId
The ID for the virtual private server image (e.g., app_wordpress_4_4 or app_lamp_7_0).
Type: String
Pattern: .*\S.*
Required: Nodescription
The description of the blueprint.
Type: String
Required: Nogroup
The group name of the blueprint (e.g., amazon-linux).
Type: String
Pattern: .*\S.*
Required: NoisActive
A Boolean value indicating whether the blueprint is active. Inactive blueprints are listed to supportcustomers with existing instances but are not necessarily available for launch of new instances.Blueprints are marked inactive when they become outdated due to operating system updates or newapplication releases.
Type: Boolean
Required: NolicenseUrl
The end-user license agreement URL for the image or blueprint.
Type: String
Required: NominPower
The minimum bundle power required to run this blueprint. For example, you need a bundle with apower value of 500 or more to create an instance that uses a blueprint with a minimum power valueof 500. 0 indicates that the blueprint runs on all instance sizes.
Type: Integer
Required: No
API Version 2016-11-28436
Amazon Lightsail API ReferenceSee Also
name
The friendly name of the blueprint (e.g., Amazon Linux).
Type: String
Pattern: \w[\w\-]*\w
Required: Noplatform
The operating system platform (either Linux/Unix-based or Windows Server-based) of the blueprint.
Type: String
Valid Values: LINUX_UNIX | WINDOWS
Required: NoproductUrl
The product URL to learn more about the image or blueprint.
Type: String
Required: Notype
The type of the blueprint (e.g., os or app).
Type: String
Valid Values: os | app
Required: Noversion
The version number of the operating system, application, or stack (e.g., 2016.03.0).
Type: String
Required: NoversionCode
The version code.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28437
Amazon Lightsail API ReferenceSee Also
API Version 2016-11-28438
Amazon Lightsail API ReferenceBundle
BundleDescribes a bundle, which is a set of specs describing your virtual private server (or instance).
ContentsbundleId
The bundle ID (e.g., micro_1_0).
Type: String
Pattern: .*\S.*
Required: NocpuCount
The number of vCPUs included in the bundle (e.g., 2).
Type: Integer
Required: NodiskSizeInGb
The size of the SSD (e.g., 30).
Type: Integer
Required: NoinstanceType
The Amazon EC2 instance type (e.g., t2.micro).
Type: String
Required: NoisActive
A Boolean value indicating whether the bundle is active.
Type: Boolean
Required: Noname
A friendly name for the bundle (e.g., Micro).
Type: String
Required: Nopower
A numeric value that represents the power of the bundle (e.g., 500). You can use the bundle's powervalue in conjunction with a blueprint's minimum power value to determine whether the blueprintwill run on the bundle. For example, you need a bundle with a power value of 500 or more to createan instance that uses a blueprint with a minimum power value of 500.
Type: Integer
API Version 2016-11-28439
Amazon Lightsail API ReferenceSee Also
Required: Noprice
The price in US dollars (e.g., 5.0) of the bundle.
Type: Float
Required: NoramSizeInGb
The amount of RAM in GB (e.g., 2.0).
Type: Float
Required: NosupportedPlatforms
The operating system platform (Linux/Unix-based or Windows Server-based) that the bundlesupports. You can only launch a WINDOWS bundle on a blueprint that supports the WINDOWSplatform. LINUX_UNIX blueprints require a LINUX_UNIX bundle.
Type: Array of strings
Valid Values: LINUX_UNIX | WINDOWS
Required: NotransferPerMonthInGb
The data transfer rate per month in GB (e.g., 2000).
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28440
Amazon Lightsail API ReferenceCacheBehavior
CacheBehaviorDescribes the default cache behavior of an Amazon Lightsail content delivery network (CDN) distribution.
Contentsbehavior
The cache behavior of the distribution.
The following cache behaviors can be specified:• cache - This option is best for static sites. When specified, your distribution caches and serves
your entire website as static content. This behavior is ideal for websites with static content thatdoesn't change depending on who views it, or for websites that don't use cookies, headers, orquery strings to personalize content.
• dont-cache - This option is best for sites that serve a mix of static and dynamic content. Whenspecified, your distribution caches and serve only the content that is specified in the distribution'sCacheBehaviorPerPath parameter. This behavior is ideal for websites or web applications thatuse cookies, headers, and query strings to personalize content for individual users.
Type: String
Valid Values: dont-cache | cache
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28441
Amazon Lightsail API ReferenceCacheBehaviorPerPath
CacheBehaviorPerPathDescribes the per-path cache behavior of an Amazon Lightsail content delivery network (CDN)distribution.
A per-path cache behavior is used to override, or add an exception to, the default cache behavior ofa distribution. For example, if the cacheBehavior is set to cache, then a per-path cache behaviorcan be used to specify a directory, file, or file type that your distribution will cache. Alternately, if thedistribution's cacheBehavior is dont-cache, then a per-path cache behavior can be used to specify adirectory, file, or file type that your distribution will not cache.
if the cacheBehavior's behavior is set to 'cache', then
Contentsbehavior
The cache behavior for the specified path.
You can specify one of the following per-path cache behaviors:• cache - This behavior caches the specified path.• dont-cache - This behavior doesn't cache the specified path.
Type: String
Valid Values: dont-cache | cache
Required: Nopath
The path to a directory or file to cached, or not cache. Use an asterisk symbol to specify wildcarddirectories (path/to/assets/*), and file types (*.html, *jpg, *js). Directories and file pathsare case-sensitive.
Examples:• Specify the following to cache all files in the document root of an Apache web server running on a
Lightsail instance.
var/www/html/
• Specify the following file to cache only the index page in the document root of an Apache webserver.
var/www/html/index.html
• Specify the following to cache only the .html files in the document root of an Apache web server.
var/www/html/*.html
• Specify the following to cache only the .jpg, .png, and .gif files in the images sub-directory of thedocument root of an Apache web server.
var/www/html/images/*.jpg
var/www/html/images/*.png
var/www/html/images/*.gif
Specify the following to cache all files in the images sub-directory of the document root of anApache web server.
API Version 2016-11-28442
Amazon Lightsail API ReferenceSee Also
var/www/html/images/
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28443
Amazon Lightsail API ReferenceCacheSettings
CacheSettingsDescribes the cache settings of an Amazon Lightsail content delivery network (CDN) distribution.
These settings apply only to your distribution's cacheBehaviors (including thedefaultCacheBehavior) that have a behavior of cache.
ContentsallowedHTTPMethods
The HTTP methods that are processed and forwarded to the distribution's origin.
You can specify the following options:• GET,HEAD - The distribution forwards the GET and HEAD methods.• GET,HEAD,OPTIONS - The distribution forwards the GET, HEAD, and OPTIONS methods.• GET,HEAD,OPTIONS,PUT,PATCH,POST,DELETE - The distribution forwards the GET, HEAD,OPTIONS, PUT, PATCH, POST, and DELETE methods.
If you specify the third option, you might need to restrict access to your distribution's origin so userscan't perform operations that you don't want them to. For example, you might not want users tohave permission to delete objects from your origin.
Type: String
Pattern: .*\S.*
Required: NocachedHTTPMethods
The HTTP method responses that are cached by your distribution.
You can specify the following options:• GET,HEAD - The distribution caches responses to the GET and HEAD methods.• GET,HEAD,OPTIONS - The distribution caches responses to the GET, HEAD, and OPTIONS
methods.
Type: String
Pattern: .*\S.*
Required: NodefaultTTL
The default amount of time that objects stay in the distribution's cache before the distributionforwards another request to the origin to determine whether the content has been updated.
NoteThe value specified applies only when the origin does not add HTTP headers such asCache-Control max-age, Cache-Control s-maxage, and Expires to objects.
Type: Long
Required: NoforwardedCookies
An object that describes the cookies that are forwarded to the origin. Your content is cached basedon the cookies that are forwarded.
API Version 2016-11-28444
Amazon Lightsail API ReferenceSee Also
Type: CookieObject (p. 456) object
Required: NoforwardedHeaders
An object that describes the headers that are forwarded to the origin. Your content is cached basedon the headers that are forwarded.
Type: HeaderObject (p. 477) object
Required: NoforwardedQueryStrings
An object that describes the query strings that are forwarded to the origin. Your content is cachedbased on the query strings that are forwarded.
Type: QueryStringObject (p. 538) object
Required: NomaximumTTL
The maximum amount of time that objects stay in the distribution's cache before the distributionforwards another request to the origin to determine whether the object has been updated.
The value specified applies only when the origin adds HTTP headers such as Cache-Control max-age, Cache-Control s-maxage, and Expires to objects.
Type: Long
Required: NominimumTTL
The minimum amount of time that objects stay in the distribution's cache before the distributionforwards another request to the origin to determine whether the object has been updated.
A value of 0 must be specified for minimumTTL if the distribution is configured to forward allheaders to the origin.
Type: Long
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28445
Amazon Lightsail API ReferenceCertificate
CertificateDescribes the full details of an Amazon Lightsail SSL/TLS certificate.
NoteTo get a summary of a certificate, use the GetCertificates action and ommitincludeCertificateDetails from your request. The response will include only thecertificate Amazon Resource Name (ARN), certificate name, domain name, and tags.
Contentsarn
The Amazon Resource Name (ARN) of the certificate.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The timestamp when the certificate was created.
Type: Timestamp
Required: NodomainName
The domain name of the certificate.
Type: String
Required: NodomainValidationRecords
An array of objects that describe the domain validation records of the certificate.
Type: Array of DomainValidationRecord (p. 472) objects
Required: NoeligibleToRenew
The renewal eligibility of the certificate.
Type: String
Required: NoinUseResourceCount
The number of Lightsail resources that the certificate is attached to.
Type: Integer
Required: NoissuedAt
The timestamp when the certificate was issued.
API Version 2016-11-28446
Amazon Lightsail API ReferenceContents
Type: Timestamp
Required: NoissuerCA
The certificate authority that issued the certificate.
Type: String
Required: NokeyAlgorithm
The algorithm used to generate the key pair (the public and private key) of the certificate.
Type: String
Required: Noname
The name of the certificate (e.g., my-certificate).
Type: String
Required: NonotAfter
The timestamp when the certificate expires.
Type: Timestamp
Required: NonotBefore
The timestamp when the certificate is first valid.
Type: Timestamp
Required: NorenewalSummary
An object that describes the status of the certificate renewal managed by Lightsail.
Type: RenewalSummary (p. 557) object
Required: NorequestFailureReason
The validation failure reason, if any, of the certificate.
The following failure reasons are possible:• NO_AVAILABLE_CONTACTS - This failure applies to email validation, which is not available for
Lightsail certificates.• ADDITIONAL_VERIFICATION_REQUIRED - Lightsail requires additional information to process
this certificate request. This can happen as a fraud-protection measure, such as when the domainranks within the Alexa top 1000 websites. To provide the required information, use the AWSSupport Center to contact AWS Support.
NoteYou cannot request a certificate for Amazon-owned domain names such as those endingin amazonaws.com, cloudfront.net, or elasticbeanstalk.com.
API Version 2016-11-28447
Amazon Lightsail API ReferenceContents
• DOMAIN_NOT_ALLOWED - One or more of the domain names in the certificate request wasreported as an unsafe domain by VirusTotal. To correct the problem, search for your domain nameon the VirusTotal website. If your domain is reported as suspicious, see Google Help for HackedWebsites to learn what you can do.
If you believe that the result is a false positive, notify the organization that is reporting thedomain. VirusTotal is an aggregate of several antivirus and URL scanners and cannot remove yourdomain from a block list itself. After you correct the problem and the VirusTotal registry has beenupdated, request a new certificate.
If you see this error and your domain is not included in the VirusTotal list, visit the AWS SupportCenter and create a case.
• INVALID_PUBLIC_DOMAIN - One or more of the domain names in the certificate request is notvalid. Typically, this is because a domain name in the request is not a valid top-level domain.Try to request a certificate again, correcting any spelling errors or typos that were in the failedrequest, and ensure that all domain names in the request are for valid top-level domains. Forexample, you cannot request a certificate for example.invalidpublicdomain becauseinvalidpublicdomain is not a valid top-level domain.
• OTHER - Typically, this failure occurs when there is a typographical error in one or more of thedomain names in the certificate request. Try to request a certificate again, correcting any spellingerrors or typos that were in the failed request.
Type: String
Required: NorevocationReason
The reason the certificate was revoked. This value is present only when the certificate status isREVOKED.
Type: String
Required: NorevokedAt
The timestamp when the certificate was revoked. This value is present only when the certificatestatus is REVOKED.
Type: Timestamp
Required: NoserialNumber
The serial number of the certificate.
Type: String
Required: Nostatus
The validation status of the certificate.
Type: String
Valid Values: PENDING_VALIDATION | ISSUED | INACTIVE | EXPIRED |VALIDATION_TIMED_OUT | REVOKED | FAILED
Required: No
API Version 2016-11-28448
Amazon Lightsail API ReferenceSee Also
subjectAlternativeNames
An array of strings that specify the alternate domains (e.g., example2.com) and subdomains (e.g.,blog.example.com) of the certificate.
Type: Array of strings
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about yourLightsail certificate. This code enables our support team to look up your Lightsail information moreeasily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28449
Amazon Lightsail API ReferenceCertificateSummary
CertificateSummaryDescribes an Amazon Lightsail SSL/TLS certificate.
ContentscertificateArn
The Amazon Resource Name (ARN) of the certificate.
Type: String
Pattern: .*\S.*
Required: NocertificateDetail
An object that describes a certificate in detail.
Type: Certificate (p. 446) object
Required: NocertificateName
The name of the certificate.
Type: String
Required: NodomainName
The domain name of the certificate.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28450
Amazon Lightsail API ReferenceCloudFormationStackRecord
CloudFormationStackRecordDescribes a CloudFormation stack record created as a result of the create cloud formation stackoperation.
A CloudFormation stack record provides information about the AWS CloudFormation stack used to createa new Amazon Elastic Compute Cloud instance from an exported Lightsail instance snapshot.
Contentsarn
The Amazon Resource Name (ARN) of the CloudFormation stack record.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The date when the CloudFormation stack record was created.
Type: Timestamp
Required: NodestinationInfo
A list of objects describing the destination service, which is AWS CloudFormation, and the AmazonResource Name (ARN) of the AWS CloudFormation stack.
Type: DestinationInfo (p. 457) object
Required: Nolocation
A list of objects describing the Availability Zone and AWS Region of the CloudFormation stackrecord.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the CloudFormation stack record. It starts with CloudFormationStackRecordfollowed by a GUID.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The Lightsail resource type (e.g., CloudFormationStackRecord).
Type: String
API Version 2016-11-28451
Amazon Lightsail API ReferenceSee Also
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosourceInfo
A list of objects describing the source of the CloudFormation stack record.
Type: Array of CloudFormationStackRecordSourceInfo (p. 453) objects
Required: Nostate
The current state of the CloudFormation stack record.
Type: String
Valid Values: Started | Succeeded | Failed
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28452
Amazon Lightsail API ReferenceCloudFormationStackRecordSourceInfo
CloudFormationStackRecordSourceInfoDescribes the source of a CloudFormation stack record (i.e., the export snapshot record).
Contentsarn
The Amazon Resource Name (ARN) of the export snapshot record.
Type: String
Pattern: .*\S.*
Required: Noname
The name of the record.
Type: String
Pattern: .*\S.*
Required: NoresourceType
The Lightsail resource type (e.g., ExportSnapshotRecord).
Type: String
Valid Values: ExportSnapshotRecord
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28453
Amazon Lightsail API ReferenceContactMethod
ContactMethodDescribes a contact method.
A contact method is a way to send you notifications. For more information, see Notifications in AmazonLightsail.
Contentsarn
The Amazon Resource Name (ARN) of the contact method.
Type: String
Pattern: .*\S.*
Required: NocontactEndpoint
The destination of the contact method, such as an email address or a mobile phone number.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The timestamp when the contact method was created.
Type: Timestamp
Required: Nolocation
Describes the resource location.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the contact method.
Type: String
Pattern: \w[\w\-]*\w
Required: Noprotocol
The protocol of the contact method, such as email or SMS (text messaging).
Type: String
Valid Values: Email | SMS
Required: No
API Version 2016-11-28454
Amazon Lightsail API ReferenceSee Also
resourceType
The Lightsail resource type (e.g., ContactMethod).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: Nostatus
The current status of the contact method.
A contact method has the following possible status:• PendingVerification - The contact method has not yet been verified, and the verification has
not yet expired.• Valid - The contact method has been verified.• InValid - An attempt was made to verify the contact method, but the verification has expired.
Type: String
Valid Values: PendingVerification | Valid | Invalid
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about yourLightsail contact method. This code enables our support team to look up your Lightsail informationmore easily.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28455
Amazon Lightsail API ReferenceCookieObject
CookieObjectDescribes whether an Amazon Lightsail content delivery network (CDN) distribution forwards cookies tothe origin and, if so, which ones.
For the cookies that you specify, your distribution caches separate versions of the specified contentbased on the cookie values in viewer requests.
ContentscookiesAllowList
The specific cookies to forward to your distribution's origin.
Type: Array of strings
Required: Nooption
Specifies which cookies to forward to the distribution's origin for a cache behavior: all, none, orallow-list to forward only the cookies specified in the cookiesAllowList parameter.
Type: String
Valid Values: none | allow-list | all
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28456
Amazon Lightsail API ReferenceDestinationInfo
DestinationInfoDescribes the destination of a record.
Contentsid
The ID of the resource created at the destination.
Type: String
Pattern: .*\S.*
Required: Noservice
The destination service of the record.
Type: String
Pattern: .*\S.*
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28457
Amazon Lightsail API ReferenceDisk
DiskDescribes a system disk or a block storage disk.
ContentsaddOns
An array of objects representing the add-ons enabled on the disk.
Type: Array of AddOn (p. 425) objects
Required: Noarn
The Amazon Resource Name (ARN) of the disk.
Type: String
Pattern: .*\S.*
Required: NoattachedTo
The resources to which the disk is attached.
Type: String
Pattern: \w[\w\-]*\w
Required: NoattachmentState
(Deprecated) The attachment state of the disk.
NoteIn releases prior to November 14, 2017, this parameter returned attached for systemdisks in the API response. It is now deprecated, but still included in the response. UseisAttached instead.
Type: String
Required: NocreatedAt
The date when the disk was created.
Type: Timestamp
Required: NogbInUse
(Deprecated) The number of GB in use by the disk.
NoteIn releases prior to November 14, 2017, this parameter was not included in the APIresponse. It is now deprecated.
Type: Integer
API Version 2016-11-28458
Amazon Lightsail API ReferenceContents
Required: Noiops
The input/output operations per second (IOPS) of the disk.
Type: Integer
Required: NoisAttached
A Boolean value indicating whether the disk is attached.
Type: Boolean
Required: NoisSystemDisk
A Boolean value indicating whether this disk is a system disk (has an operating system loaded on it).
Type: Boolean
Required: Nolocation
The AWS Region and Availability Zone where the disk is located.
Type: ResourceLocation (p. 559) object
Required: Noname
The unique name of the disk.
Type: String
Pattern: \w[\w\-]*\w
Required: Nopath
The disk path.
Type: String
Required: NoresourceType
The Lightsail resource type (e.g., Disk).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: No
API Version 2016-11-28459
Amazon Lightsail API ReferenceSee Also
sizeInGb
The size of the disk in GB.
Type: Integer
Required: Nostate
Describes the status of the disk.
Type: String
Valid Values: pending | error | available | in-use | unknown
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28460
Amazon Lightsail API ReferenceDiskInfo
DiskInfoDescribes a disk.
ContentsisSystemDisk
A Boolean value indicating whether this disk is a system disk (has an operating system loaded on it).
Type: Boolean
Required: Noname
The disk name.
Type: String
Required: Nopath
The disk path.
Type: String
Pattern: .*\S.*
Required: NosizeInGb
The size of the disk in GB (e.g., 32).
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28461
Amazon Lightsail API ReferenceDiskMap
DiskMapDescribes a block storage disk mapping.
ContentsnewDiskName
The new disk name (e.g., my-new-disk).
Type: String
Pattern: \w[\w\-]*\w
Required: NooriginalDiskPath
The original disk path exposed to the instance (for example, /dev/sdh).
Type: String
Pattern: .*\S.*
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28462
Amazon Lightsail API ReferenceDiskSnapshot
DiskSnapshotDescribes a block storage disk snapshot.
Contentsarn
The Amazon Resource Name (ARN) of the disk snapshot.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The date when the disk snapshot was created.
Type: Timestamp
Required: NofromDiskArn
The Amazon Resource Name (ARN) of the source disk from which the disk snapshot was created.
Type: String
Pattern: .*\S.*
Required: NofromDiskName
The unique name of the source disk from which the disk snapshot was created.
Type: String
Pattern: \w[\w\-]*\w
Required: NofromInstanceArn
The Amazon Resource Name (ARN) of the source instance from which the disk (system volume)snapshot was created.
Type: String
Pattern: .*\S.*
Required: NofromInstanceName
The unique name of the source instance from which the disk (system volume) snapshot was created.
Type: String
Pattern: \w[\w\-]*\w
Required: No
API Version 2016-11-28463
Amazon Lightsail API ReferenceContents
isFromAutoSnapshot
A Boolean value indicating whether the snapshot was created from an automatic snapshot.
Type: Boolean
Required: Nolocation
The AWS Region and Availability Zone where the disk snapshot was created.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the disk snapshot (e.g., my-disk-snapshot).
Type: String
Pattern: \w[\w\-]*\w
Required: Noprogress
The progress of the disk snapshot operation.
Type: String
Required: NoresourceType
The Lightsail resource type (e.g., DiskSnapshot).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosizeInGb
The size of the disk in GB.
Type: Integer
Required: Nostate
The status of the disk snapshot operation.
Type: String
Valid Values: pending | completed | error | unknown
Required: No
API Version 2016-11-28464
Amazon Lightsail API ReferenceSee Also
supportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28465
Amazon Lightsail API ReferenceDiskSnapshotInfo
DiskSnapshotInfoDescribes a disk snapshot.
ContentssizeInGb
The size of the disk in GB (e.g., 32).
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28466
Amazon Lightsail API ReferenceDistributionBundle
DistributionBundleDescribes the specifications of a distribution bundle.
ContentsbundleId
The ID of the bundle.
Type: String
Required: NoisActive
Indicates whether the bundle is active, and can be specified for a new distribution.
Type: Boolean
Required: Noname
The name of the distribution bundle.
Type: String
Required: Noprice
The monthly price, in US dollars, of the bundle.
Type: Float
Required: NotransferPerMonthInGb
The monthly network transfer quota of the bundle.
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28467
Amazon Lightsail API ReferenceDomain
DomainDescribes a domain where you are storing recordsets in Lightsail.
Contentsarn
The Amazon Resource Name (ARN) of the domain recordset (e.g.,arn:aws:lightsail:global:123456789101:Domain/824cede0-abc7-4f84-8dbc-12345EXAMPLE).
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The date when the domain recordset was created.
Type: Timestamp
Required: NodomainEntries
An array of key-value pairs containing information about the domain entries.
Type: Array of DomainEntry (p. 470) objects
Required: Nolocation
The AWS Region and Availability Zones where the domain recordset was created.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the domain.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The resource type.
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
API Version 2016-11-28468
Amazon Lightsail API ReferenceSee Also
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28469
Amazon Lightsail API ReferenceDomainEntry
DomainEntryDescribes a domain recordset entry.
Contentsid
The ID of the domain recordset entry.
Type: String
Pattern: .*\S.*
Required: NoisAlias
When true, specifies whether the domain entry is an alias used by the Lightsail load balancer. Youcan include an alias (A type) record in your request, which points to a load balancer DNS name androutes traffic to your load balancer
Type: Boolean
Required: Noname
The name of the domain.
Type: String
Required: Nooptions
(Deprecated) The options for the domain entry.
NoteIn releases prior to November 29, 2017, this parameter was not included in the APIresponse. It is now deprecated.
Type: String to string map
Required: Notarget
The target AWS name server (e.g., ns-111.awsdns-22.com.).
For Lightsail load balancers, the value looks likeab1234c56789c6b86aba6fb203d443bc-123456789.us-east-2.elb.amazonaws.com. Besure to also set isAlias to true when setting up an A record for a load balancer.
Type: String
Required: Notype
The type of domain entry, such as address (A), canonical name (CNAME), mail exchanger (MX), nameserver (NS), start of authority (SOA), service locator (SRV), or text (TXT).
API Version 2016-11-28470
Amazon Lightsail API ReferenceSee Also
The following domain entry types can be used:• A
• CNAME
• MX
• NS
• SOA
• SRV
• TXT
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28471
Amazon Lightsail API ReferenceDomainValidationRecord
DomainValidationRecordDescribes the domain validation records of an Amazon Lightsail SSL/TLS certificate.
ContentsdomainName
The domain name of the certificate validation record. For example, example.com orwww.example.com.
Type: String
Required: NoresourceRecord
An object that describes the DNS records to add to your domain's DNS to validate it for thecertificate.
Type: ResourceRecord (p. 560) object
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28472
Amazon Lightsail API ReferenceExportSnapshotRecord
ExportSnapshotRecordDescribes an export snapshot record.
Contentsarn
The Amazon Resource Name (ARN) of the export snapshot record.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The date when the export snapshot record was created.
Type: Timestamp
Required: NodestinationInfo
A list of objects describing the destination of the export snapshot record.
Type: DestinationInfo (p. 457) object
Required: Nolocation
The AWS Region and Availability Zone where the export snapshot record is located.
Type: ResourceLocation (p. 559) object
Required: Noname
The export snapshot record name.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The Lightsail resource type (e.g., ExportSnapshotRecord).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: No
API Version 2016-11-28473
Amazon Lightsail API ReferenceSee Also
sourceInfo
A list of objects describing the source of the export snapshot record.
Type: ExportSnapshotRecordSourceInfo (p. 475) object
Required: Nostate
The state of the export snapshot record.
Type: String
Valid Values: Started | Succeeded | Failed
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28474
Amazon Lightsail API ReferenceExportSnapshotRecordSourceInfo
ExportSnapshotRecordSourceInfoDescribes the source of an export snapshot record.
Contentsarn
The Amazon Resource Name (ARN) of the source instance or disk snapshot.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The date when the source instance or disk snapshot was created.
Type: Timestamp
Required: NodiskSnapshotInfo
A list of objects describing a disk snapshot.
Type: DiskSnapshotInfo (p. 466) object
Required: NofromResourceArn
The Amazon Resource Name (ARN) of the snapshot's source instance or disk.
Type: String
Pattern: .*\S.*
Required: NofromResourceName
The name of the snapshot's source instance or disk.
Type: String
Pattern: .*\S.*
Required: NoinstanceSnapshotInfo
A list of objects describing an instance snapshot.
Type: InstanceSnapshotInfo (p. 501) object
Required: Noname
The name of the source instance or disk snapshot.
API Version 2016-11-28475
Amazon Lightsail API ReferenceSee Also
Type: String
Pattern: .*\S.*
Required: NoresourceType
The Lightsail resource type (e.g., InstanceSnapshot or DiskSnapshot).
Type: String
Valid Values: InstanceSnapshot | DiskSnapshot
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28476
Amazon Lightsail API ReferenceHeaderObject
HeaderObjectDescribes the request headers that a Lightsail distribution bases caching on.
For the headers that you specify, your distribution caches separate versions of the specified contentbased on the header values in viewer requests. For example, suppose viewer requests for logo.jpgcontain a custom product header that has a value of either acme or apex, and you configure yourdistribution to cache your content based on values in the product header. Your distribution forwardsthe product header to the origin and caches the response from the origin once for each header value.
ContentsheadersAllowList
The specific headers to forward to your distribution's origin.
Type: Array of strings
Valid Values: Accept | Accept-Charset | Accept-Datetime | Accept-Encoding |Accept-Language | Authorization | CloudFront-Forwarded-Proto | CloudFront-Is-Desktop-Viewer | CloudFront-Is-Mobile-Viewer | CloudFront-Is-SmartTV-Viewer | CloudFront-Is-Tablet-Viewer | CloudFront-Viewer-Country | Host |Origin | Referer
Required: Nooption
The headers that you want your distribution to forward to your origin and base caching on.
You can configure your distribution to do one of the following:• all - Forward all headers to your origin.• none - Forward only the default headers.• allow-list - Forward only the headers you specify using the headersAllowList parameter.
Type: String
Valid Values: none | allow-list | all
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28477
Amazon Lightsail API ReferenceHostKeyAttributes
HostKeyAttributesDescribes the public SSH host keys or the RDP certificate.
Contentsalgorithm
The SSH host key algorithm or the RDP certificate format.
For SSH host keys, the algorithm may be ssh-rsa, ecdsa-sha2-nistp256, ssh-ed25519, etc. ForRDP certificates, the algorithm is always x509-cert.
Type: String
Required: NofingerprintSHA1
The SHA-1 fingerprint of the returned SSH host key or RDP certificate.• Example of an SHA-1 SSH fingerprint:
SHA1:1CHH6FaAaXjtFOsR/t83vf91SR0
• Example of an SHA-1 RDP fingerprint:
af:34:51:fe:09:f0:e0:da:b8:4e:56:ca:60:c2:10:ff:38:06:db:45
Type: String
Required: NofingerprintSHA256
The SHA-256 fingerprint of the returned SSH host key or RDP certificate.• Example of an SHA-256 SSH fingerprint:
SHA256:KTsMnRBh1IhD17HpdfsbzeGA4jOijm5tyXsMjKVbB8o
• Example of an SHA-256 RDP fingerprint:
03:9b:36:9f:4b:de:4e:61:70:fc:7c:c9:78:e7:d2:1a:1c:25:a8:0c:91:f6:7c:e4:d6:a0:85:c8:b4:53:99:68
Type: String
Required: NonotValidAfter
The returned RDP certificate is not valid after this point in time.
This value is listed only for RDP certificates.
Type: Timestamp
Required: NonotValidBefore
The returned RDP certificate is valid after this point in time.
This value is listed only for RDP certificates.
API Version 2016-11-28478
Amazon Lightsail API ReferenceSee Also
Type: Timestamp
Required: NopublicKey
The public SSH host key or the RDP certificate.
Type: String
Required: NowitnessedAt
The time that the SSH host key or RDP certificate was recorded by Lightsail.
Type: Timestamp
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28479
Amazon Lightsail API ReferenceInputOrigin
InputOriginDescribes the origin resource of an Amazon Lightsail content delivery network (CDN) distribution.
An origin can be a Lightsail instance or load balancer. A distribution pulls content from an origin, cachesit, and serves it to viewers via a worldwide network of edge servers.
Contentsname
The name of the origin resource.
Type: String
Pattern: \w[\w\-]*\w
Required: NoprotocolPolicy
The protocol that your Amazon Lightsail distribution uses when establishing a connection with yourorigin to pull content.
Type: String
Valid Values: http-only | https-only
Required: NoregionName
The AWS Region name of the origin resource.
Type: String
Valid Values: us-east-1 | us-east-2 | us-west-1 | us-west-2 | eu-west-1 |eu-west-2 | eu-west-3 | eu-central-1 | ca-central-1 | ap-south-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | ap-northeast-2
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28480
Amazon Lightsail API ReferenceInstance
InstanceDescribes an instance (a virtual private server).
ContentsaddOns
An array of objects representing the add-ons enabled on the instance.
Type: Array of AddOn (p. 425) objects
Required: Noarn
The Amazon Resource Name (ARN) of the instance (e.g., arn:aws:lightsail:us-east-2:123456789101:Instance/244ad76f-8aad-4741-809f-12345EXAMPLE).
Type: String
Pattern: .*\S.*
Required: NoblueprintId
The blueprint ID (e.g., os_amlinux_2016_03).
Type: String
Pattern: .*\S.*
Required: NoblueprintName
The friendly name of the blueprint (e.g., Amazon Linux).
Type: String
Pattern: .*\S.*
Required: NobundleId
The bundle for the instance (e.g., micro_1_0).
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The timestamp when the instance was created (e.g., 1479734909.17) in Unix time format.
Type: Timestamp
Required: No
API Version 2016-11-28481
Amazon Lightsail API ReferenceContents
hardware
The size of the vCPU and the amount of RAM for the instance.
Type: InstanceHardware (p. 489) object
Required: Noipv6Address
The IPv6 address of the instance.
Type: String
Pattern: ([A-F0-9]{1,4}:){7}[A-F0-9]{1,4}
Required: NoisStaticIp
A Boolean value indicating whether this instance has a static IP assigned to it.
Type: Boolean
Required: Nolocation
The region name and Availability Zone where the instance is located.
Type: ResourceLocation (p. 559) object
Required: Noname
The name the user gave the instance (e.g., Amazon_Linux-1GB-Ohio-1).
Type: String
Pattern: \w[\w\-]*\w
Required: Nonetworking
Information about the public ports and monthly data transfer rates for the instance.
Type: InstanceNetworking (p. 492) object
Required: NoprivateIpAddress
The private IP address of the instance.
Type: String
Pattern: ([0-9]{1,3}\.){3}[0-9]{1,3}
Required: NopublicIpAddress
The public IP address of the instance.
Type: String
API Version 2016-11-28482
Amazon Lightsail API ReferenceContents
Pattern: ([0-9]{1,3}\.){3}[0-9]{1,3}
Required: NoresourceType
The type of resource (usually Instance).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosshKeyName
The name of the SSH key being used to connect to the instance (e.g.,LightsailDefaultKeyPair).
Type: String
Pattern: \w[\w\-]*\w
Required: Nostate
The status code and the state (e.g., running) for the instance.
Type: InstanceState (p. 502) object
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: Nousername
The user name for connecting to the instance (e.g., ec2-user).
Type: String
Pattern: .*\S.*
Required: No
API Version 2016-11-28483
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28484
Amazon Lightsail API ReferenceInstanceAccessDetails
InstanceAccessDetailsThe parameters for gaining temporary access to one of your Amazon Lightsail instances.
ContentscertKey
For SSH access, the public key to use when accessing your instance For OpenSSH clients (e.g.,command line SSH), you should save this value to tempkey-cert.pub.
Type: String
Required: NoexpiresAt
For SSH access, the date on which the temporary keys expire.
Type: Timestamp
Required: NohostKeys
Describes the public SSH host keys or the RDP certificate.
Type: Array of HostKeyAttributes (p. 478) objects
Required: NoinstanceName
The name of this Amazon Lightsail instance.
Type: String
Pattern: \w[\w\-]*\w
Required: NoipAddress
The public IP address of the Amazon Lightsail instance.
Type: String
Pattern: ([0-9]{1,3}\.){3}[0-9]{1,3}
Required: Nopassword
For RDP access, the password for your Amazon Lightsail instance. Password will be an empty stringif the password for your new instance is not ready yet. When you create an instance, it can take up to15 minutes for the instance to be ready.
NoteIf you create an instance using any key pair other than the default(LightsailDefaultKeyPair), password will always be an empty string.If you change the Administrator password on the instance, Lightsail will continue to returnthe original password value. When accessing the instance using RDP, you need to manuallyenter the Administrator password after changing it from the default.
API Version 2016-11-28485
Amazon Lightsail API ReferenceSee Also
Type: String
Required: NopasswordData
For a Windows Server-based instance, an object with the data you can use to retrieve your password.This is only needed if password is empty and the instance is not new (and therefore the passwordis not ready yet). When you create an instance, it can take up to 15 minutes for the instance to beready.
Type: PasswordData (p. 533) object
Required: NoprivateKey
For SSH access, the temporary private key. For OpenSSH clients (e.g., command line SSH), youshould save this value to tempkey).
Type: String
Required: Noprotocol
The protocol for these Amazon Lightsail instance access details.
Type: String
Valid Values: ssh | rdp
Required: Nousername
The user name to use when logging in to the Amazon Lightsail instance.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28486
Amazon Lightsail API ReferenceInstanceEntry
InstanceEntryDescribes the Amazon Elastic Compute Cloud instance and related resources to be created using thecreate cloud formation stack operation.
ContentsavailabilityZone
The Availability Zone for the new Amazon EC2 instance.
Type: String
Required: YesinstanceType
The instance type (e.g., t2.micro) to use for the new Amazon EC2 instance.
Type: String
Pattern: .*\S.*
Required: YesportInfoSource
The port configuration to use for the new Amazon EC2 instance.
The following configuration options are available:• DEFAULT - Use the default firewall settings from the Lightsail instance blueprint.• INSTANCE - Use the configured firewall settings from the source Lightsail instance.• NONE - Use the default Amazon EC2 security group.• CLOSED - All ports closed.
NoteIf you configured lightsail-connect as a cidrListAliases on your instance, or if youchose to allow the Lightsail browser-based SSH or RDP clients to connect to your instance,that configuration is not carried over to your new Amazon EC2 instance.
Type: String
Valid Values: DEFAULT | INSTANCE | NONE | CLOSED
Required: YessourceName
The name of the export snapshot record, which contains the exported Lightsail instance snapshotthat will be used as the source of the new Amazon EC2 instance.
Use the get export snapshot records operation to get a list of export snapshot records thatyou can use to create a CloudFormation stack.
Type: String
Pattern: \w[\w\-]*\w
Required: Yes
API Version 2016-11-28487
Amazon Lightsail API ReferenceSee Also
userData
A launch script you can create that configures a server with additional user data. For example, youmight want to run apt-get -y update.
NoteDepending on the machine image you choose, the command to get software on yourinstance varies. Amazon Linux and CentOS use yum, Debian and Ubuntu use apt-get, andFreeBSD uses pkg.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28488
Amazon Lightsail API ReferenceInstanceHardware
InstanceHardwareDescribes the hardware for the instance.
ContentscpuCount
The number of vCPUs the instance has.
Type: Integer
Required: Nodisks
The disks attached to the instance.
Type: Array of Disk (p. 458) objects
Required: NoramSizeInGb
The amount of RAM in GB on the instance (e.g., 1.0).
Type: Float
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28489
Amazon Lightsail API ReferenceInstanceHealthSummary
InstanceHealthSummaryDescribes information about the health of the instance.
ContentsinstanceHealth
Describes the overall instance health. Valid values are below.
Type: String
Valid Values: initial | healthy | unhealthy | unused | draining | unavailable
Required: NoinstanceHealthReason
More information about the instance health. If the instanceHealth is healthy, then aninstanceHealthReason value is not provided.
If instanceHealth is initial, the instanceHealthReason value can be one of the following:• Lb.RegistrationInProgress - The target instance is in the process of being registered with
the load balancer.• Lb.InitialHealthChecking - The Lightsail load balancer is still sending the target instance
the minimum number of health checks required to determine its health status.
If instanceHealth is unhealthy, the instanceHealthReason value can be one of thefollowing:• Instance.ResponseCodeMismatch - The health checks did not return an expected HTTP code.• Instance.Timeout - The health check requests timed out.• Instance.FailedHealthChecks - The health checks failed because the connection to the
target instance timed out, the target instance response was malformed, or the target instancefailed the health check for an unknown reason.
• Lb.InternalError - The health checks failed due to an internal error.
If instanceHealth is unused, the instanceHealthReason value can be one of the following:• Instance.NotRegistered - The target instance is not registered with the target group.• Instance.NotInUse - The target group is not used by any load balancer, or the target instance
is in an Availability Zone that is not enabled for its load balancer.• Instance.IpUnusable - The target IP address is reserved for use by a Lightsail load balancer.• Instance.InvalidState - The target is in the stopped or terminated state.
If instanceHealth is draining, the instanceHealthReason value can be one of thefollowing:• Instance.DeregistrationInProgress - The target instance is in the process of being
deregistered and the deregistration delay period has not expired.
Type: String
Valid Values: Lb.RegistrationInProgress | Lb.InitialHealthChecking |Lb.InternalError | Instance.ResponseCodeMismatch | Instance.Timeout |Instance.FailedHealthChecks | Instance.NotRegistered | Instance.NotInUse| Instance.DeregistrationInProgress | Instance.InvalidState |Instance.IpUnusable
API Version 2016-11-28490
Amazon Lightsail API ReferenceSee Also
Required: NoinstanceName
The name of the Lightsail instance for which you are requesting health check data.
Type: String
Pattern: \w[\w\-]*\w
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28491
Amazon Lightsail API ReferenceInstanceNetworking
InstanceNetworkingDescribes monthly data transfer rates and port information for an instance.
ContentsmonthlyTransfer
The amount of data in GB allocated for monthly data transfers.
Type: MonthlyTransfer (p. 527) object
Required: Noports
An array of key-value pairs containing information about the ports on the instance.
Type: Array of InstancePortInfo (p. 493) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28492
Amazon Lightsail API ReferenceInstancePortInfo
InstancePortInfoDescribes information about ports for an Amazon Lightsail instance.
ContentsaccessDirection
The access direction (inbound or outbound).
NoteLightsail currently supports only inbound access direction.
Type: String
Valid Values: inbound | outbound
Required: NoaccessFrom
The location from which access is allowed. For example, Anywhere (0.0.0.0/0), or Custom if aspecific IP address or range of IP addresses is allowed.
Type: String
Required: NoaccessType
The type of access (Public or Private).
Type: String
Valid Values: Public | Private
Required: NocidrListAliases
An alias that defines access for a preconfigured range of IP addresses.
The only alias currently supported is lightsail-connect, which allows IP addresses of thebrowser-based RDP/SSH client in the Lightsail console to connect to your instance.
Type: Array of strings
Required: Nocidrs
The IP address, or range of IP addresses in CIDR notation, that are allowed to connect to an instancethrough the ports, and the protocol. Lightsail supports IPv4 addresses.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
Type: Array of strings
Required: NocommonName
The common name of the port information.
API Version 2016-11-28493
Amazon Lightsail API ReferenceContents
Type: String
Required: NofromPort
The first port in a range of open ports on an instance.
Allowed ports:• TCP and UDP - 0 to 65535• ICMP - The ICMP type. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: Noprotocol
The IP protocol name.
The name can be one of the following:• tcp - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery
of streamed data between applications running on hosts communicating by an IP network. If youhave an application that doesn't require reliable data stream service, use UDP instead.
• all - All transport layer protocol types. For more general information, see Transport layer onWikipedia.
• udp - With User Datagram Protocol (UDP), computer applications can send messages (ordatagrams) to other hosts on an Internet Protocol (IP) network. Prior communications arenot required to set up transmission channels or data paths. Applications that don't requirereliable data stream service can use UDP, which provides a connectionless datagram service thatemphasizes reduced latency over reliability. If you do require reliable data stream service, use TCPinstead.
• icmp - Internet Control Message Protocol (ICMP) is used to send error messages and operationalinformation indicating success or failure when communicating with an instance. For example,an error is indicated when an instance could not be reached. When you specify icmp as theprotocol, you must specify the ICMP type using the fromPort parameter, and ICMP code usingthe toPort parameter.
Type: String
Valid Values: tcp | all | udp | icmp
Required: NotoPort
The last port in a range of open ports on an instance.
Allowed ports:• TCP and UDP - 0 to 65535• ICMP - The ICMP code. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: No
API Version 2016-11-28494
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28495
Amazon Lightsail API ReferenceInstancePortState
InstancePortStateDescribes open ports on an instance, the IP addresses allowed to connect to the instance through theports, and the protocol.
ContentscidrListAliases
An alias that defines access for a preconfigured range of IP addresses.
The only alias currently supported is lightsail-connect, which allows IP addresses of thebrowser-based RDP/SSH client in the Lightsail console to connect to your instance.
Type: Array of strings
Required: Nocidrs
The IP address, or range of IP addresses in CIDR notation, that are allowed to connect to an instancethrough the ports, and the protocol. Lightsail supports IPv4 addresses.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
Type: Array of strings
Required: NofromPort
The first port in a range of open ports on an instance.
Allowed ports:• TCP and UDP - 0 to 65535• ICMP - The ICMP type. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: Noprotocol
The IP protocol name.
The name can be one of the following:• tcp - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery
of streamed data between applications running on hosts communicating by an IP network. If youhave an application that doesn't require reliable data stream service, use UDP instead.
• all - All transport layer protocol types. For more general information, see Transport layer onWikipedia.
• udp - With User Datagram Protocol (UDP), computer applications can send messages (ordatagrams) to other hosts on an Internet Protocol (IP) network. Prior communications arenot required to set up transmission channels or data paths. Applications that don't requirereliable data stream service can use UDP, which provides a connectionless datagram service that
API Version 2016-11-28496
Amazon Lightsail API ReferenceSee Also
emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCPinstead.
• icmp - Internet Control Message Protocol (ICMP) is used to send error messages and operationalinformation indicating success or failure when communicating with an instance. For example,an error is indicated when an instance could not be reached. When you specify icmp as theprotocol, you must specify the ICMP type using the fromPort parameter, and ICMP code usingthe toPort parameter.
Type: String
Valid Values: tcp | all | udp | icmp
Required: Nostate
Specifies whether the instance port is open or closed.
NoteThe port state for Lightsail instances is always open.
Type: String
Valid Values: open | closed
Required: NotoPort
The last port in a range of open ports on an instance.
Allowed ports:• TCP and UDP - 0 to 65535• ICMP - The ICMP code. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28497
Amazon Lightsail API ReferenceInstanceSnapshot
InstanceSnapshotDescribes an instance snapshot.
Contentsarn
The Amazon Resource Name (ARN) of the snapshot (e.g., arn:aws:lightsail:us-east-2:123456789101:InstanceSnapshot/d23b5706-3322-4d83-81e5-12345EXAMPLE).
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The timestamp when the snapshot was created (e.g., 1479907467.024).
Type: Timestamp
Required: NofromAttachedDisks
An array of disk objects containing information about all block storage disks.
Type: Array of Disk (p. 458) objects
Required: NofromBlueprintId
The blueprint ID from which you created the snapshot (e.g., os_debian_8_3). A blueprint is avirtual private server (or instance) image used to create instances quickly.
Type: String
Required: NofromBundleId
The bundle ID from which you created the snapshot (e.g., micro_1_0).
Type: String
Required: NofromInstanceArn
The Amazon Resource Name (ARN) of the instance from which the snapshot was created(e.g., arn:aws:lightsail:us-east-2:123456789101:Instance/64b8404c-ccb1-430b-8daf-12345EXAMPLE).
Type: String
Pattern: .*\S.*
Required: NofromInstanceName
The instance from which the snapshot was created.
API Version 2016-11-28498
Amazon Lightsail API ReferenceContents
Type: String
Pattern: \w[\w\-]*\w
Required: NoisFromAutoSnapshot
A Boolean value indicating whether the snapshot was created from an automatic snapshot.
Type: Boolean
Required: Nolocation
The region name and Availability Zone where you created the snapshot.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: Noprogress
The progress of the snapshot.
Type: String
Required: NoresourceType
The type of resource (usually InstanceSnapshot).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosizeInGb
The size in GB of the SSD.
Type: Integer
Required: Nostate
The state the snapshot is in.
Type: String
API Version 2016-11-28499
Amazon Lightsail API ReferenceSee Also
Valid Values: pending | error | available
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28500
Amazon Lightsail API ReferenceInstanceSnapshotInfo
InstanceSnapshotInfoDescribes an instance snapshot.
ContentsfromBlueprintId
The blueprint ID from which the source instance (e.g., os_debian_8_3).
Type: String
Pattern: .*\S.*
Required: NofromBundleId
The bundle ID from which the source instance was created (e.g., micro_1_0).
Type: String
Pattern: .*\S.*
Required: NofromDiskInfo
A list of objects describing the disks that were attached to the source instance.
Type: Array of DiskInfo (p. 461) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28501
Amazon Lightsail API ReferenceInstanceState
InstanceStateDescribes the virtual private server (or instance) status.
Contentscode
The status code for the instance.
Type: Integer
Required: Noname
The state of the instance (e.g., running or pending).
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28502
Amazon Lightsail API ReferenceKeyPair
KeyPairDescribes the SSH key pair.
Contentsarn
The Amazon Resource Name (ARN) of the key pair (e.g., arn:aws:lightsail:us-east-2:123456789101:KeyPair/05859e3d-331d-48ba-9034-12345EXAMPLE).
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The timestamp when the key pair was created (e.g., 1479816991.349).
Type: Timestamp
Required: Nofingerprint
The RSA fingerprint of the key pair.
Type: String
Required: Nolocation
The region name and Availability Zone where the key pair was created.
Type: ResourceLocation (p. 559) object
Required: Noname
The friendly name of the SSH key pair.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The resource type (usually KeyPair).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
API Version 2016-11-28503
Amazon Lightsail API ReferenceSee Also
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28504
Amazon Lightsail API ReferenceLightsailDistribution
LightsailDistributionDescribes an Amazon Lightsail content delivery network (CDN) distribution.
ContentsableToUpdateBundle
Indicates whether the bundle that is currently applied to your distribution, specified using thedistributionName parameter, can be changed to another bundle.
Use the UpdateDistributionBundle action to change your distribution's bundle.
Type: Boolean
Required: NoalternativeDomainNames
The alternate domain names of the distribution.
Type: Array of strings
Required: Noarn
The Amazon Resource Name (ARN) of the distribution.
Type: String
Pattern: .*\S.*
Required: NobundleId
The ID of the bundle currently applied to the distribution.
Type: String
Required: NocacheBehaviors
An array of objects that describe the per-path cache behavior of the distribution.
Type: Array of CacheBehaviorPerPath (p. 442) objects
Required: NocacheBehaviorSettings
An object that describes the cache behavior settings of the distribution.
Type: CacheSettings (p. 444) object
Required: NocertificateName
The name of the SSL/TLS certificate attached to the distribution, if any.
Type: String
API Version 2016-11-28505
Amazon Lightsail API ReferenceContents
Pattern: \w[\w\-]*\w
Required: NocreatedAt
The timestamp when the distribution was created.
Type: Timestamp
Required: NodefaultCacheBehavior
An object that describes the default cache behavior of the distribution.
Type: CacheBehavior (p. 441) object
Required: NodomainName
The domain name of the distribution.
Type: String
Required: NoisEnabled
Indicates whether the distribution is enabled.
Type: Boolean
Required: Nolocation
An object that describes the location of the distribution, such as the AWS Region and AvailabilityZone.
NoteLightsail distributions are global resources that can reference an origin in any AWS Region,and distribute its content globally. However, all distributions are located in the us-east-1Region.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the distribution.
Type: String
Pattern: \w[\w\-]*\w
Required: Noorigin
An object that describes the origin resource of the distribution, such as a Lightsail instance or loadbalancer.
The distribution pulls, caches, and serves content from the origin.
API Version 2016-11-28506
Amazon Lightsail API ReferenceSee Also
Type: Origin (p. 531) object
Required: NooriginPublicDNS
The public DNS of the origin.
Type: String
Required: NoresourceType
The Lightsail resource type (e.g., Distribution).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: Nostatus
The status of the distribution.
Type: String
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about yourLightsail distribution. This code enables our support team to look up your Lightsail information moreeasily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28507
Amazon Lightsail API ReferenceSee Also
API Version 2016-11-28508
Amazon Lightsail API ReferenceLoadBalancer
LoadBalancerDescribes the Lightsail load balancer.
Contentsarn
The Amazon Resource Name (ARN) of the load balancer.
Type: String
Pattern: .*\S.*
Required: NoconfigurationOptions
A string to string map of the configuration options for your load balancer. Valid values are listedbelow.
Type: String to string map
Valid Keys: HealthCheckPath | SessionStickinessEnabled |SessionStickiness_LB_CookieDurationSeconds
Required: NocreatedAt
The date when your load balancer was created.
Type: Timestamp
Required: NodnsName
The DNS name of your Lightsail load balancer.
Type: String
Pattern: .*\S.*
Required: NohealthCheckPath
The path you specified to perform your health checks. If no path is specified, the load balancer triesto make a request to the default (root) page.
Type: String
Pattern: .*\S.*
Required: NoinstanceHealthSummary
An array of InstanceHealthSummary objects describing the health of the load balancer.
Type: Array of InstanceHealthSummary (p. 490) objects
API Version 2016-11-28509
Amazon Lightsail API ReferenceContents
Required: NoinstancePort
The port where the load balancer will direct traffic to your Lightsail instances. For HTTP traffic, it'sport 80. For HTTPS traffic, it's port 443.
Type: Integer
Required: Nolocation
The AWS Region where your load balancer was created (e.g., us-east-2a). Lightsail automaticallycreates your load balancer across Availability Zones.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the load balancer (e.g., my-load-balancer).
Type: String
Pattern: \w[\w\-]*\w
Required: Noprotocol
The protocol you have enabled for your load balancer. Valid values are below.
You can't just have HTTP_HTTPS, but you can have just HTTP.
Type: String
Valid Values: HTTP_HTTPS | HTTP
Required: NopublicPorts
An array of public port settings for your load balancer. For HTTP, use port 80. For HTTPS, use port443.
Type: Array of integers
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: NoresourceType
The resource type (e.g., LoadBalancer.
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: No
API Version 2016-11-28510
Amazon Lightsail API ReferenceSee Also
state
The status of your load balancer. Valid values are below.
Type: String
Valid Values: active | provisioning | active_impaired | failed | unknown
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about yourLightsail load balancer. This code enables our support team to look up your Lightsail informationmore easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: NotlsCertificateSummaries
An array of LoadBalancerTlsCertificateSummary objects that provide additional information aboutthe SSL/TLS certificates. For example, if true, the certificate is attached to the load balancer.
Type: Array of LoadBalancerTlsCertificateSummary (p. 522) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28511
Amazon Lightsail API ReferenceLoadBalancerTlsCertificate
LoadBalancerTlsCertificateDescribes a load balancer SSL/TLS certificate.
TLS is just an updated, more secure version of Secure Socket Layer (SSL).
Contentsarn
The Amazon Resource Name (ARN) of the SSL/TLS certificate.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The time when you created your SSL/TLS certificate.
Type: Timestamp
Required: NodomainName
The domain name for your SSL/TLS certificate.
Type: String
Required: NodomainValidationRecords
An array of LoadBalancerTlsCertificateDomainValidationRecord objects describing the records.
Type: Array of LoadBalancerTlsCertificateDomainValidationRecord (p. 518) objects
Required: NofailureReason
The validation failure reason, if any, of the certificate.
The following failure reasons are possible:• NO_AVAILABLE_CONTACTS - This failure applies to email validation, which is not available for
Lightsail certificates.• ADDITIONAL_VERIFICATION_REQUIRED - Lightsail requires additional information to process
this certificate request. This can happen as a fraud-protection measure, such as when the domainranks within the Alexa top 1000 websites. To provide the required information, use the AWSSupport Center to contact AWS Support.
NoteYou cannot request a certificate for Amazon-owned domain names such as those endingin amazonaws.com, cloudfront.net, or elasticbeanstalk.com.
• DOMAIN_NOT_ALLOWED - One or more of the domain names in the certificate request wasreported as an unsafe domain by VirusTotal. To correct the problem, search for your domain nameon the VirusTotal website. If your domain is reported as suspicious, see Google Help for HackedWebsites to learn what you can do.
API Version 2016-11-28512
Amazon Lightsail API ReferenceContents
If you believe that the result is a false positive, notify the organization that is reporting thedomain. VirusTotal is an aggregate of several antivirus and URL scanners and cannot remove yourdomain from a block list itself. After you correct the problem and the VirusTotal registry has beenupdated, request a new certificate.
If you see this error and your domain is not included in the VirusTotal list, visit the AWS SupportCenter and create a case.
• INVALID_PUBLIC_DOMAIN - One or more of the domain names in the certificate request is notvalid. Typically, this is because a domain name in the request is not a valid top-level domain.Try to request a certificate again, correcting any spelling errors or typos that were in the failedrequest, and ensure that all domain names in the request are for valid top-level domains. Forexample, you cannot request a certificate for example.invalidpublicdomain becauseinvalidpublicdomain is not a valid top-level domain.
• OTHER - Typically, this failure occurs when there is a typographical error in one or more of thedomain names in the certificate request. Try to request a certificate again, correcting any spellingerrors or typos that were in the failed request.
Type: String
Valid Values: NO_AVAILABLE_CONTACTS | ADDITIONAL_VERIFICATION_REQUIRED |DOMAIN_NOT_ALLOWED | INVALID_PUBLIC_DOMAIN | OTHER
Required: NoisAttached
When true, the SSL/TLS certificate is attached to the Lightsail load balancer.
Type: Boolean
Required: NoissuedAt
The time when the SSL/TLS certificate was issued.
Type: Timestamp
Required: Noissuer
The issuer of the certificate.
Type: String
Pattern: .*\S.*
Required: NokeyAlgorithm
The algorithm used to generate the key pair (the public and private key).
Type: String
Pattern: .*\S.*
Required: NoloadBalancerName
The load balancer name where your SSL/TLS certificate is attached.
API Version 2016-11-28513
Amazon Lightsail API ReferenceContents
Type: String
Pattern: \w[\w\-]*\w
Required: Nolocation
The AWS Region and Availability Zone where you created your certificate.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the SSL/TLS certificate (e.g., my-certificate).
Type: String
Pattern: \w[\w\-]*\w
Required: NonotAfter
The timestamp when the SSL/TLS certificate expires.
Type: Timestamp
Required: NonotBefore
The timestamp when the SSL/TLS certificate is first valid.
Type: Timestamp
Required: NorenewalSummary
An object that describes the status of the certificate renewal managed by Lightsail.
Type: LoadBalancerTlsCertificateRenewalSummary (p. 520) object
Required: NoresourceType
The resource type (e.g., LoadBalancerTlsCertificate).• Instance - A Lightsail instance (a virtual private server)• StaticIp - A static IP address• KeyPair - The key pair used to connect to a Lightsail instance• InstanceSnapshot - A Lightsail instance snapshot• Domain - A DNS zone• PeeredVpc - A peered VPC• LoadBalancer - A Lightsail load balancer• LoadBalancerTlsCertificate - An SSL/TLS certificate associated with a Lightsail load
balancer• Disk - A Lightsail block storage disk• DiskSnapshot - A block storage disk snapshot
API Version 2016-11-28514
Amazon Lightsail API ReferenceContents
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NorevocationReason
The reason the certificate was revoked. This value is present only when the certificate status isREVOKED.
Type: String
Valid Values: UNSPECIFIED | KEY_COMPROMISE | CA_COMPROMISE |AFFILIATION_CHANGED | SUPERCEDED | CESSATION_OF_OPERATION | CERTIFICATE_HOLD| REMOVE_FROM_CRL | PRIVILEGE_WITHDRAWN | A_A_COMPROMISE
Required: NorevokedAt
The timestamp when the certificate was revoked. This value is present only when the certificatestatus is REVOKED.
Type: Timestamp
Required: Noserial
The serial number of the certificate.
Type: String
Pattern: .*\S.*
Required: NosignatureAlgorithm
The algorithm that was used to sign the certificate.
Type: String
Pattern: .*\S.*
Required: Nostatus
The validation status of the SSL/TLS certificate. Valid values are below.
Type: String
Valid Values: PENDING_VALIDATION | ISSUED | INACTIVE | EXPIRED |VALIDATION_TIMED_OUT | REVOKED | FAILED | UNKNOWN
Required: Nosubject
The name of the entity that is associated with the public key contained in the certificate.
API Version 2016-11-28515
Amazon Lightsail API ReferenceSee Also
Type: String
Pattern: .*\S.*
Required: NosubjectAlternativeNames
An array of strings that specify the alternate domains (e.g., example2.com) and subdomains (e.g.,blog.example.com) for the certificate.
Type: Array of strings
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about yourLightsail load balancer or SSL/TLS certificate. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28516
Amazon Lightsail API ReferenceLoadBalancerTlsCertificateDomainValidationOption
LoadBalancerTlsCertificateDomainValidationOptionContains information about the domain names on an SSL/TLS certificate that you will use to validatedomain ownership.
ContentsdomainName
The fully qualified domain name in the certificate request.
Type: String
Required: NovalidationStatus
The status of the domain validation. Valid values are listed below.
Type: String
Valid Values: PENDING_VALIDATION | FAILED | SUCCESS
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28517
Amazon Lightsail API ReferenceLoadBalancerTlsCertificateDomainValidationRecord
LoadBalancerTlsCertificateDomainValidationRecordDescribes the validation record of each domain name in the SSL/TLS certificate.
ContentsdomainName
The domain name against which your SSL/TLS certificate was validated.
Type: String
Required: Noname
A fully qualified domain name in the certificate. For example, example.com.
Type: String
Pattern: .*\S.*
Required: Notype
The type of validation record. For example, CNAME for domain validation.
Type: String
Pattern: .*\S.*
Required: NovalidationStatus
The validation status. Valid values are listed below.
Type: String
Valid Values: PENDING_VALIDATION | FAILED | SUCCESS
Required: Novalue
The value for that type.
Type: String
Pattern: .*\S.*
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go
API Version 2016-11-28518
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28519
Amazon Lightsail API ReferenceLoadBalancerTlsCertificateRenewalSummary
LoadBalancerTlsCertificateRenewalSummaryContains information about the status of Lightsail's managed renewal for the certificate.
The renewal status of the certificate.
The following renewal status are possible:
• PendingAutoRenewal - Lightsail is attempting to automatically validate the domain names in thecertificate. No further action is required.
• PendingValidation - Lightsail couldn't automatically validate one or more domain names in thecertificate. You must take action to validate these domain names or the certificate won't be renewed. Ifyou used DNS validation, check to make sure your certificate's domain validation records exist in yourdomain's DNS, and that your certificate remains in use.
• Success - All domain names in the certificate are validated, and Lightsail renewed the certificate. Nofurther action is required.
• Failed - One or more domain names were not validated before the certificate expired, and Lightsaildid not renew the certificate. You can request a new certificate using the CreateCertificate action.
ContentsdomainValidationOptions
Contains information about the validation of each domain name in the certificate, as it pertains toLightsail's managed renewal. This is different from the initial validation that occurs as a result of theRequestCertificate request.
Type: Array of LoadBalancerTlsCertificateDomainValidationOption (p. 517) objects
Required: No
renewalStatus
The renewal status of the certificate.
The following renewal status are possible:
• PendingAutoRenewal - Lightsail is attempting to automatically validate the domain names ofthe certificate. No further action is required.
• PendingValidation - Lightsail couldn't automatically validate one or more domain names ofthe certificate. You must take action to validate these domain names or the certificate won't berenewed. Check to make sure your certificate's domain validation records exist in your domain'sDNS, and that your certificate remains in use.
• Success - All domain names in the certificate are validated, and Lightsail renewed the certificate.No further action is required.
• Failed - One or more domain names were not validated before the certificate expired,and Lightsail did not renew the certificate. You can request a new certificate using theCreateCertificate action.
Type: String
Valid Values: PENDING_AUTO_RENEWAL | PENDING_VALIDATION | SUCCESS | FAILED
Required: No
API Version 2016-11-28520
Amazon Lightsail API ReferenceSee Also
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28521
Amazon Lightsail API ReferenceLoadBalancerTlsCertificateSummary
LoadBalancerTlsCertificateSummaryProvides a summary of SSL/TLS certificate metadata.
ContentsisAttached
When true, the SSL/TLS certificate is attached to the Lightsail load balancer.
Type: Boolean
Required: Noname
The name of the SSL/TLS certificate.
Type: String
Pattern: \w[\w\-]*\w
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28522
Amazon Lightsail API ReferenceLogEvent
LogEventDescribes a database log event.
ContentscreatedAt
The timestamp when the database log event was created.
Type: Timestamp
Required: Nomessage
The message of the database log event.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28523
Amazon Lightsail API ReferenceMetricDatapoint
MetricDatapointDescribes the metric data point.
Contentsaverage
The average.
Type: Double
Required: Nomaximum
The maximum.
Type: Double
Required: Nominimum
The minimum.
Type: Double
Required: NosampleCount
The sample count.
Type: Double
Required: Nosum
The sum.
Type: Double
Required: Notimestamp
The timestamp (e.g., 1479816991.349).
Type: Timestamp
Required: Nounit
The unit.
Type: String
Valid Values: Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |Megabytes | Gigabytes | Terabytes | Bits | Kilobits | Megabits | Gigabits| Terabits | Percent | Count | Bytes/Second | Kilobytes/Second | Megabytes/
API Version 2016-11-28524
Amazon Lightsail API ReferenceSee Also
Second | Gigabytes/Second | Terabytes/Second | Bits/Second | Kilobits/Second| Megabits/Second | Gigabits/Second | Terabits/Second | Count/Second | None
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28525
Amazon Lightsail API ReferenceMonitoredResourceInfo
MonitoredResourceInfoDescribes resource being monitored by an alarm.
An alarm is a way to monitor your Amazon Lightsail resource metrics. For more information, see Alarmsin Amazon Lightsail.
Contentsarn
The Amazon Resource Name (ARN) of the resource being monitored.
Type: String
Pattern: ^arn:(aws[^:]*):([a-zA-Z0-9-]+):([a-z0-9-]+):([0-9]+):([a-zA-Z]+)/([a-zA-Z0-9-]+)$
Required: Noname
The name of the Lightsail resource being monitored.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The Lightsail resource type of the resource being monitored.
Instances, load balancers, and relational databases are the only Lightsail resources that can currentlybe monitored by alarms.
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28526
Amazon Lightsail API ReferenceMonthlyTransfer
MonthlyTransferDescribes the monthly data transfer in and out of your virtual private server (or instance).
ContentsgbPerMonthAllocated
The amount allocated per month (in GB).
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28527
Amazon Lightsail API ReferenceOperation
OperationDescribes the API operation.
ContentscreatedAt
The timestamp when the operation was initialized (e.g., 1479816991.349).
Type: Timestamp
Required: NoerrorCode
The error code.
Type: String
Required: NoerrorDetails
The error details.
Type: String
Required: Noid
The ID of the operation.
Type: String
Pattern: .*\S.*
Required: NoisTerminal
A Boolean value indicating whether the operation is terminal.
Type: Boolean
Required: Nolocation
The AWS Region and Availability Zone.
Type: ResourceLocation (p. 559) object
Required: NooperationDetails
Details about the operation (e.g., Debian-1GB-Ohio-1).
Type: String
Required: No
API Version 2016-11-28528
Amazon Lightsail API ReferenceContents
operationType
The type of operation.
Type: String
Valid Values: DeleteKnownHostKeys | DeleteInstance | CreateInstance |StopInstance | StartInstance | RebootInstance | OpenInstancePublicPorts| PutInstancePublicPorts | CloseInstancePublicPorts | AllocateStaticIp |ReleaseStaticIp | AttachStaticIp | DetachStaticIp | UpdateDomainEntry |DeleteDomainEntry | CreateDomain | DeleteDomain | CreateInstanceSnapshot| DeleteInstanceSnapshot | CreateInstancesFromSnapshot |CreateLoadBalancer | DeleteLoadBalancer | AttachInstancesToLoadBalancer| DetachInstancesFromLoadBalancer | UpdateLoadBalancerAttribute |CreateLoadBalancerTlsCertificate | DeleteLoadBalancerTlsCertificate| AttachLoadBalancerTlsCertificate | CreateDisk | DeleteDisk |AttachDisk | DetachDisk | CreateDiskSnapshot | DeleteDiskSnapshot |CreateDiskFromSnapshot | CreateRelationalDatabase | UpdateRelationalDatabase| DeleteRelationalDatabase | CreateRelationalDatabaseFromSnapshot |CreateRelationalDatabaseSnapshot | DeleteRelationalDatabaseSnapshot| UpdateRelationalDatabaseParameters | StartRelationalDatabase| RebootRelationalDatabase | StopRelationalDatabase |EnableAddOn | DisableAddOn | PutAlarm | GetAlarms | DeleteAlarm| TestAlarm | CreateContactMethod | GetContactMethods |SendContactMethodVerification | DeleteContactMethod | CreateDistribution| UpdateDistribution | DeleteDistribution | ResetDistributionCache |AttachCertificateToDistribution | DetachCertificateFromDistribution |UpdateDistributionBundle | CreateCertificate | DeleteCertificate
Required: NoresourceName
The resource name.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The resource type.
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: Nostatus
The status of the operation.
Type: String
Valid Values: NotStarted | Started | Failed | Completed | Succeeded
API Version 2016-11-28529
Amazon Lightsail API ReferenceSee Also
Required: NostatusChangedAt
The timestamp when the status was changed (e.g., 1479816991.349).
Type: Timestamp
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28530
Amazon Lightsail API ReferenceOrigin
OriginDescribes the origin resource of an Amazon Lightsail content delivery network (CDN) distribution.
An origin can be a Lightsail instance or load balancer. A distribution pulls content from an origin, cachesit, and serves it to viewers via a worldwide network of edge servers.
Contentsname
The name of the origin resource.
Type: String
Pattern: \w[\w\-]*\w
Required: NoprotocolPolicy
The protocol that your Amazon Lightsail distribution uses when establishing a connection with yourorigin to pull content.
Type: String
Valid Values: http-only | https-only
Required: NoregionName
The AWS Region name of the origin resource.
Type: String
Valid Values: us-east-1 | us-east-2 | us-west-1 | us-west-2 | eu-west-1 |eu-west-2 | eu-west-3 | eu-central-1 | ca-central-1 | ap-south-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | ap-northeast-2
Required: NoresourceType
The resource type of the origin resource (e.g., Instance).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28531
Amazon Lightsail API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28532
Amazon Lightsail API ReferencePasswordData
PasswordDataThe password data for the Windows Server-based instance, including the ciphertext and the key pairname.
Contentsciphertext
The encrypted password. Ciphertext will be an empty string if access to your new instance is notready yet. When you create an instance, it can take up to 15 minutes for the instance to be ready.
NoteIf you use the default key pair (LightsailDefaultKeyPair), the decrypted password willbe available in the password field.If you are using a custom key pair, you need to use your own means of decryption.If you change the Administrator password on the instance, Lightsail will continue to returnthe original ciphertext value. When accessing the instance using RDP, you need to manuallyenter the Administrator password after changing it from the default.
Type: String
Required: NokeyPairName
The name of the key pair that you used when creating your instance. If no key pairname was specified when creating the instance, Lightsail uses the default key pair(LightsailDefaultKeyPair).
If you are using a custom key pair, you need to use your own means of decrypting your passwordusing the ciphertext. Lightsail creates the ciphertext by encrypting your password with the publickey part of this key pair.
Type: String
Pattern: \w[\w\-]*\w
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28533
Amazon Lightsail API ReferencePendingMaintenanceAction
PendingMaintenanceActionDescribes a pending database maintenance action.
Contentsaction
The type of pending database maintenance action.
Type: String
Pattern: .*\S.*
Required: NocurrentApplyDate
The effective date of the pending database maintenance action.
Type: Timestamp
Required: Nodescription
Additional detail about the pending database maintenance action.
Type: String
Pattern: .*\S.*
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28534
Amazon Lightsail API ReferencePendingModifiedRelationalDatabaseValues
PendingModifiedRelationalDatabaseValuesDescribes a pending database value modification.
ContentsbackupRetentionEnabled
A Boolean value indicating whether automated backup retention is enabled.
Type: Boolean
Required: NoengineVersion
The database engine version.
Type: String
Required: NomasterUserPassword
The password for the master user of the database.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28535
Amazon Lightsail API ReferencePortInfo
PortInfoDescribes ports to open on an instance, the IP addresses allowed to connect to the instance through theports, and the protocol.
ContentscidrListAliases
An alias that defines access for a preconfigured range of IP addresses.
The only alias currently supported is lightsail-connect, which allows IP addresses of thebrowser-based RDP/SSH client in the Lightsail console to connect to your instance.
Type: Array of strings
Required: Nocidrs
The IP address, or range of IP addresses in CIDR notation, that are allowed to connect to an instancethrough the ports, and the protocol. Lightsail supports IPv4 addresses.
Examples:• To allow the IP address 192.0.2.44, specify 192.0.2.44 or 192.0.2.44/32.• To allow the IP addresses 192.0.2.0 to 192.0.2.255, specify 192.0.2.0/24.
For more information about CIDR block notation, see Classless Inter-Domain Routing on Wikipedia.
Type: Array of strings
Required: NofromPort
The first port in a range of open ports on an instance.
Allowed ports:• TCP and UDP - 0 to 65535• ICMP - The ICMP type. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: Noprotocol
The IP protocol name.
The name can be one of the following:• tcp - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery
of streamed data between applications running on hosts communicating by an IP network. If youhave an application that doesn't require reliable data stream service, use UDP instead.
• all - All transport layer protocol types. For more general information, see Transport layer onWikipedia.
API Version 2016-11-28536
Amazon Lightsail API ReferenceSee Also
• udp - With User Datagram Protocol (UDP), computer applications can send messages (ordatagrams) to other hosts on an Internet Protocol (IP) network. Prior communications arenot required to set up transmission channels or data paths. Applications that don't requirereliable data stream service can use UDP, which provides a connectionless datagram service thatemphasizes reduced latency over reliability. If you do require reliable data stream service, use TCPinstead.
• icmp - Internet Control Message Protocol (ICMP) is used to send error messages and operationalinformation indicating success or failure when communicating with an instance. For example,an error is indicated when an instance could not be reached. When you specify icmp as theprotocol, you must specify the ICMP type using the fromPort parameter, and ICMP code usingthe toPort parameter.
Type: String
Valid Values: tcp | all | udp | icmp
Required: NotoPort
The last port in a range of open ports on an instance.
Allowed ports:• TCP and UDP - 0 to 65535• ICMP - The ICMP code. For example, specify 8 as the fromPort (ICMP type), and -1 as the toPort
(ICMP code), to enable ICMP Ping. For more information, see Control Messages on Wikipedia.
Type: Integer
Valid Range: Minimum value of -1. Maximum value of 65535.
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28537
Amazon Lightsail API ReferenceQueryStringObject
QueryStringObjectDescribes the query string parameters that an Amazon Lightsail content delivery network (CDN)distribution to bases caching on.
For the query strings that you specify, your distribution caches separate versions of the specified contentbased on the query string values in viewer requests.
Contentsoption
Indicates whether the distribution forwards and caches based on query strings.
Type: Boolean
Required: NoqueryStringsAllowList
The specific query strings that the distribution forwards to the origin.
Your distribution will cache content based on the specified query strings.
If the option parameter is true, then your distribution forwards all query strings, regardless of whatyou specify using the queryStringsAllowList parameter.
Type: Array of strings
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28538
Amazon Lightsail API ReferenceRegion
RegionDescribes the AWS Region.
ContentsavailabilityZones
The Availability Zones. Follows the format us-east-2a (case-sensitive).
Type: Array of AvailabilityZone (p. 435) objects
Required: NocontinentCode
The continent code (e.g., NA, meaning North America).
Type: String
Required: Nodescription
The description of the AWS Region (e.g., This region is recommended to serve users inthe eastern United States and eastern Canada).
Type: String
Required: NodisplayName
The display name (e.g., Ohio).
Type: String
Required: Noname
The region name (e.g., us-east-2).
Type: String
Valid Values: us-east-1 | us-east-2 | us-west-1 | us-west-2 | eu-west-1 |eu-west-2 | eu-west-3 | eu-central-1 | ca-central-1 | ap-south-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | ap-northeast-2
Required: NorelationalDatabaseAvailabilityZones
The Availability Zones for databases. Follows the format us-east-2a (case-sensitive).
Type: Array of AvailabilityZone (p. 435) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
API Version 2016-11-28539
Amazon Lightsail API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28540
Amazon Lightsail API ReferenceRelationalDatabase
RelationalDatabaseDescribes a database.
Contentsarn
The Amazon Resource Name (ARN) of the database.
Type: String
Pattern: .*\S.*
Required: NobackupRetentionEnabled
A Boolean value indicating whether automated backup retention is enabled for the database.
Type: Boolean
Required: NocaCertificateIdentifier
The certificate associated with the database.
Type: String
Required: NocreatedAt
The timestamp when the database was created. Formatted in Unix time.
Type: Timestamp
Required: Noengine
The database software (for example, MySQL).
Type: String
Pattern: .*\S.*
Required: NoengineVersion
The database engine version (for example, 5.7.23).
Type: String
Pattern: .*\S.*
Required: Nohardware
Describes the hardware of the database.
Type: RelationalDatabaseHardware (p. 551) object
API Version 2016-11-28541
Amazon Lightsail API ReferenceContents
Required: NolatestRestorableTime
The latest point in time to which the database can be restored. Formatted in Unix time.
Type: Timestamp
Required: Nolocation
The Region name and Availability Zone where the database is located.
Type: ResourceLocation (p. 559) object
Required: NomasterDatabaseName
The name of the master database created when the Lightsail database resource is created.
Type: String
Required: NomasterEndpoint
The master endpoint for the database.
Type: RelationalDatabaseEndpoint (p. 549) object
Required: NomasterUsername
The master user name of the database.
Type: String
Pattern: .*\S.*
Required: Noname
The unique name of the database resource in Lightsail.
Type: String
Pattern: \w[\w\-]*\w
Required: NoparameterApplyStatus
The status of parameter updates for the database.
Type: String
Pattern: .*\S.*
Required: NopendingMaintenanceActions
Describes the pending maintenance actions for the database.
API Version 2016-11-28542
Amazon Lightsail API ReferenceContents
Type: Array of PendingMaintenanceAction (p. 534) objects
Required: NopendingModifiedValues
Describes pending database value modifications.
Type: PendingModifiedRelationalDatabaseValues (p. 535) object
Required: NopreferredBackupWindow
The daily time range during which automated backups are created for the database (for example,16:00-16:30).
Type: String
Pattern: .*\S.*
Required: NopreferredMaintenanceWindow
The weekly time range during which system maintenance can occur on the database.
In the format ddd:hh24:mi-ddd:hh24:mi. For example, Tue:17:00-Tue:17:30.
Type: String
Pattern: .*\S.*
Required: NopubliclyAccessible
A Boolean value indicating whether the database is publicly accessible.
Type: Boolean
Required: NorelationalDatabaseBlueprintId
The blueprint ID for the database. A blueprint describes the major engine version of a database.
Type: String
Pattern: .*\S.*
Required: NorelationalDatabaseBundleId
The bundle ID for the database. A bundle describes the performance specifications for yourdatabase.
Type: String
Pattern: .*\S.*
Required: NoresourceType
The Lightsail resource type for the database (for example, RelationalDatabase).
API Version 2016-11-28543
Amazon Lightsail API ReferenceSee Also
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosecondaryAvailabilityZone
Describes the secondary Availability Zone of a high availability database.
The secondary database is used for failover support of a high availability database.
Type: String
Required: Nostate
Describes the current state of the database.
Type: String
Pattern: .*\S.*
Required: NosupportCode
The support code for the database. Include this code in your email to support when you havequestions about a database in Lightsail. This code enables our support team to look up your Lightsailinformation more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28544
Amazon Lightsail API ReferenceRelationalDatabaseBlueprint
RelationalDatabaseBlueprintDescribes a database image, or blueprint. A blueprint describes the major engine version of a database.
ContentsblueprintId
The ID for the database blueprint.
Type: String
Required: Noengine
The database software of the database blueprint (for example, MySQL).
Type: String
Valid Values: mysql
Required: NoengineDescription
The description of the database engine for the database blueprint.
Type: String
Required: NoengineVersion
The database engine version for the database blueprint (for example, 5.7.23).
Type: String
Required: NoengineVersionDescription
The description of the database engine version for the database blueprint.
Type: String
Required: NoisEngineDefault
A Boolean value indicating whether the engine version is the default for the database blueprint.
Type: Boolean
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++
API Version 2016-11-28545
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28546
Amazon Lightsail API ReferenceRelationalDatabaseBundle
RelationalDatabaseBundleDescribes a database bundle. A bundle describes the performance specifications of the database.
ContentsbundleId
The ID for the database bundle.
Type: String
Required: NocpuCount
The number of virtual CPUs (vCPUs) for the database bundle.
Type: Integer
Required: NodiskSizeInGb
The size of the disk for the database bundle.
Type: Integer
Required: NoisActive
A Boolean value indicating whether the database bundle is active.
Type: Boolean
Required: NoisEncrypted
A Boolean value indicating whether the database bundle is encrypted.
Type: Boolean
Required: Noname
The name for the database bundle.
Type: String
Required: Noprice
The cost of the database bundle in US currency.
Type: Float
Required: NoramSizeInGb
The amount of RAM in GB (for example, 2.0) for the database bundle.
API Version 2016-11-28547
Amazon Lightsail API ReferenceSee Also
Type: Float
Required: NotransferPerMonthInGb
The data transfer rate per month in GB for the database bundle.
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28548
Amazon Lightsail API ReferenceRelationalDatabaseEndpoint
RelationalDatabaseEndpointDescribes an endpoint for a database.
Contentsaddress
Specifies the DNS address of the database.
Type: String
Pattern: .*\S.*
Required: Noport
Specifies the port that the database is listening on.
Type: Integer
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28549
Amazon Lightsail API ReferenceRelationalDatabaseEvent
RelationalDatabaseEventDescribes an event for a database.
ContentscreatedAt
The timestamp when the database event was created.
Type: Timestamp
Required: NoeventCategories
The category that the database event belongs to.
Type: Array of strings
Required: Nomessage
The message of the database event.
Type: String
Required: Noresource
The database that the database event relates to.
Type: String
Pattern: \w[\w\-]*\w
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28550
Amazon Lightsail API ReferenceRelationalDatabaseHardware
RelationalDatabaseHardwareDescribes the hardware of a database.
ContentscpuCount
The number of vCPUs for the database.
Type: Integer
Required: NodiskSizeInGb
The size of the disk for the database.
Type: Integer
Required: NoramSizeInGb
The amount of RAM in GB for the database.
Type: Float
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28551
Amazon Lightsail API ReferenceRelationalDatabaseParameter
RelationalDatabaseParameterDescribes the parameters of a database.
ContentsallowedValues
Specifies the valid range of values for the parameter.
Type: String
Required: NoapplyMethod
Indicates when parameter updates are applied.
Can be immediate or pending-reboot.
Type: String
Required: NoapplyType
Specifies the engine-specific parameter type.
Type: String
Required: NodataType
Specifies the valid data type for the parameter.
Type: String
Required: Nodescription
Provides a description of the parameter.
Type: String
Required: NoisModifiable
A Boolean value indicating whether the parameter can be modified.
Type: Boolean
Required: NoparameterName
Specifies the name of the parameter.
Type: String
Required: No
API Version 2016-11-28552
Amazon Lightsail API ReferenceSee Also
parameterValue
Specifies the value of the parameter.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28553
Amazon Lightsail API ReferenceRelationalDatabaseSnapshot
RelationalDatabaseSnapshotDescribes a database snapshot.
Contentsarn
The Amazon Resource Name (ARN) of the database snapshot.
Type: String
Pattern: .*\S.*
Required: NocreatedAt
The timestamp when the database snapshot was created.
Type: Timestamp
Required: Noengine
The software of the database snapshot (for example, MySQL)
Type: String
Pattern: .*\S.*
Required: NoengineVersion
The database engine version for the database snapshot (for example, 5.7.23).
Type: String
Pattern: .*\S.*
Required: NofromRelationalDatabaseArn
The Amazon Resource Name (ARN) of the database from which the database snapshot was created.
Type: String
Pattern: .*\S.*
Required: NofromRelationalDatabaseBlueprintId
The blueprint ID of the database from which the database snapshot was created. A blueprintdescribes the major engine version of a database.
Type: String
Required: No
API Version 2016-11-28554
Amazon Lightsail API ReferenceContents
fromRelationalDatabaseBundleId
The bundle ID of the database from which the database snapshot was created.
Type: String
Required: NofromRelationalDatabaseName
The name of the source database from which the database snapshot was created.
Type: String
Pattern: .*\S.*
Required: Nolocation
The Region name and Availability Zone where the database snapshot is located.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the database snapshot.
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The Lightsail resource type.
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosizeInGb
The size of the disk in GB (for example, 32) for the database snapshot.
Type: Integer
Required: Nostate
The state of the database snapshot.
Type: String
Pattern: .*\S.*
API Version 2016-11-28555
Amazon Lightsail API ReferenceSee Also
Required: NosupportCode
The support code for the database snapshot. Include this code in your email to support when youhave questions about a database snapshot in Lightsail. This code enables our support team to lookup your Lightsail information more easily.
Type: String
Required: Notags
The tag keys and optional values for the resource. For more information about tags in Lightsail, seethe Lightsail Dev Guide.
Type: Array of Tag (p. 563) objects
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28556
Amazon Lightsail API ReferenceRenewalSummary
RenewalSummaryDescribes the status of a SSL/TLS certificate renewal managed by Amazon Lightsail.
ContentsdomainValidationRecords
An array of objects that describe the domain validation records of the certificate.
Type: Array of DomainValidationRecord (p. 472) objects
Required: NorenewalStatus
The renewal status of the certificate.
The following renewal status are possible:• PendingAutoRenewal - Lightsail is attempting to automatically validate the domain names of
the certificate. No further action is required.• PendingValidation - Lightsail couldn't automatically validate one or more domain names of
the certificate. You must take action to validate these domain names or the certificate won't berenewed. Check to make sure your certificate's domain validation records exist in your domain'sDNS, and that your certificate remains in use.
• Success - All domain names in the certificate are validated, and Lightsail renewed the certificate.No further action is required.
• Failed - One or more domain names were not validated before the certificate expired,and Lightsail did not renew the certificate. You can request a new certificate using theCreateCertificate action.
Type: String
Valid Values: PendingAutoRenewal | PendingValidation | Success | Failed
Required: NorenewalStatusReason
The reason for the renewal status of the certificate.
Type: String
Required: NoupdatedAt
The timestamp when the certificate was last updated.
Type: Timestamp
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++
API Version 2016-11-28557
Amazon Lightsail API ReferenceSee Also
• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28558
Amazon Lightsail API ReferenceResourceLocation
ResourceLocationDescribes the resource location.
ContentsavailabilityZone
The Availability Zone. Follows the format us-east-2a (case-sensitive).
Type: String
Required: NoregionName
The AWS Region name.
Type: String
Valid Values: us-east-1 | us-east-2 | us-west-1 | us-west-2 | eu-west-1 |eu-west-2 | eu-west-3 | eu-central-1 | ca-central-1 | ap-south-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | ap-northeast-2
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28559
Amazon Lightsail API ReferenceResourceRecord
ResourceRecordDescribes the domain name system (DNS) records to add to your domain's DNS to validate it for anAmazon Lightsail certificate.
Contentsname
The name of the record.
Type: String
Required: Notype
The DNS record type.
Type: String
Required: Novalue
The value for the DNS record.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28560
Amazon Lightsail API ReferenceStaticIp
StaticIpDescribes the static IP.
Contentsarn
The Amazon Resource Name (ARN) of the static IP (e.g., arn:aws:lightsail:us-east-2:123456789101:StaticIp/9cbb4a9e-f8e3-4dfe-b57e-12345EXAMPLE).
Type: String
Pattern: .*\S.*
Required: NoattachedTo
The instance where the static IP is attached (e.g., Amazon_Linux-1GB-Ohio-1).
Type: String
Pattern: \w[\w\-]*\w
Required: NocreatedAt
The timestamp when the static IP was created (e.g., 1479735304.222).
Type: Timestamp
Required: NoipAddress
The static IP address.
Type: String
Pattern: ([0-9]{1,3}\.){3}[0-9]{1,3}
Required: NoisAttached
A Boolean value indicating whether the static IP is attached.
Type: Boolean
Required: Nolocation
The region and Availability Zone where the static IP was created.
Type: ResourceLocation (p. 559) object
Required: Noname
The name of the static IP (e.g., StaticIP-Ohio-EXAMPLE).
API Version 2016-11-28561
Amazon Lightsail API ReferenceSee Also
Type: String
Pattern: \w[\w\-]*\w
Required: NoresourceType
The resource type (usually StaticIp).
Type: String
Valid Values: Instance | StaticIp | KeyPair | InstanceSnapshot | Domain |PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot| RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord| CloudFormationStackRecord | Alarm | ContactMethod | Distribution |Certificate
Required: NosupportCode
The support code. Include this code in your email to support when you have questions about aninstance or another resource in Lightsail. This code enables our support team to look up yourLightsail information more easily.
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28562
Amazon Lightsail API ReferenceTag
TagDescribes a tag key and optional value assigned to an Amazon Lightsail resource.
For more information about tags in Lightsail, see the Lightsail Dev Guide.
Contentskey
The key of the tag.
Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the followingcharacters: + - = . _ : / @
Type: String
Required: Novalue
The value of the tag.
Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the followingcharacters: + - = . _ : / @
Type: String
Required: No
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V3
API Version 2016-11-28563
Amazon Lightsail API Reference
Common ParametersThe following list contains the parameters that all actions use for signing Signature Version 4 requestswith a query string. Any action-specific parameters are listed in the topic for that action. For moreinformation about Signature Version 4, see Signature Version 4 Signing Process in the Amazon WebServices General Reference.
Action
The action to be performed.
Type: string
Required: YesVersion
The API version that the request is written for, expressed in the format YYYY-MM-DD.
Type: string
Required: YesX-Amz-Algorithm
The hash algorithm that you used to create the request signature.
Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.
Type: string
Valid Values: AWS4-HMAC-SHA256
Required: ConditionalX-Amz-Credential
The credential scope value, which is a string that includes your access key, the date, the region youare targeting, the service you are requesting, and a termination string ("aws4_request"). The value isexpressed in the following format: access_key/YYYYMMDD/region/service/aws4_request.
For more information, see Task 2: Create a String to Sign for Signature Version 4 in the Amazon WebServices General Reference.
Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.
Type: string
Required: ConditionalX-Amz-Date
The date that is used to create the signature. The format must be ISO 8601 basic format(YYYYMMDD'T'HHMMSS'Z'). For example, the following date time is a valid X-Amz-Date value:20120325T120000Z.
Condition: X-Amz-Date is optional for all requests; it can be used to override the date used forsigning requests. If the Date header is specified in the ISO 8601 basic format, X-Amz-Date is
API Version 2016-11-28564
Amazon Lightsail API Reference
not required. When X-Amz-Date is used, it always overrides the value of the Date header. Formore information, see Handling Dates in Signature Version 4 in the Amazon Web Services GeneralReference.
Type: string
Required: ConditionalX-Amz-Security-Token
The temporary security token that was obtained through a call to AWS Security Token Service (AWSSTS). For a list of services that support temporary security credentials from AWS Security TokenService, go to AWS Services That Work with IAM in the IAM User Guide.
Condition: If you're using temporary security credentials from the AWS Security Token Service, youmust include the security token.
Type: string
Required: ConditionalX-Amz-Signature
Specifies the hex-encoded signature that was calculated from the string to sign and the derivedsigning key.
Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.
Type: string
Required: ConditionalX-Amz-SignedHeaders
Specifies all the HTTP headers that were included as part of the canonical request. For moreinformation about specifying signed headers, see Task 1: Create a Canonical Request For SignatureVersion 4 in the Amazon Web Services General Reference.
Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.
Type: string
Required: Conditional
API Version 2016-11-28565
Amazon Lightsail API Reference
Common ErrorsThis section lists the errors common to the API actions of all AWS services. For errors specific to an APIaction for this service, see the topic for that API action.
AccessDeniedException
You do not have sufficient access to perform this action.
HTTP Status Code: 400IncompleteSignature
The request signature does not conform to AWS standards.
HTTP Status Code: 400InternalFailure
The request processing has failed because of an unknown error, exception or failure.
HTTP Status Code: 500InvalidAction
The action or operation requested is invalid. Verify that the action is typed correctly.
HTTP Status Code: 400InvalidClientTokenId
The X.509 certificate or AWS access key ID provided does not exist in our records.
HTTP Status Code: 403InvalidParameterCombination
Parameters that must not be used together were used together.
HTTP Status Code: 400InvalidParameterValue
An invalid or out-of-range value was supplied for the input parameter.
HTTP Status Code: 400InvalidQueryParameter
The AWS query string is malformed or does not adhere to AWS standards.
HTTP Status Code: 400MalformedQueryString
The query string contains a syntax error.
HTTP Status Code: 404MissingAction
The request is missing an action or a required parameter.
HTTP Status Code: 400
API Version 2016-11-28566
Amazon Lightsail API Reference
MissingAuthenticationToken
The request must contain either a valid (registered) AWS access key ID or X.509 certificate.
HTTP Status Code: 403MissingParameter
A required parameter for the specified action is not supplied.
HTTP Status Code: 400OptInRequired
The AWS access key ID needs a subscription for the service.
HTTP Status Code: 403RequestExpired
The request reached the service more than 15 minutes after the date stamp on the request or morethan 15 minutes after the request expiration date (such as for pre-signed URLs), or the date stampon the request is more than 15 minutes in the future.
HTTP Status Code: 400ServiceUnavailable
The request has failed due to a temporary failure of the server.
HTTP Status Code: 503ThrottlingException
The request was denied due to request throttling.
HTTP Status Code: 400ValidationError
The input fails to satisfy the constraints specified by an AWS service.
HTTP Status Code: 400
API Version 2016-11-28567