Amazon Lightsail is the easiest way to get started with Amazon Web Services (AWS) for developers who need to build websites or web applications. It includes everything you need to launch your project quickly - instances (virtual private servers), container services, managed databases, SSD-based block storage, static IP addresses, load balancers, content delivery network (CDN) distributions, DNS management of registered domains, and resource snapshots (backups) - for a low, predictable monthly price.
You can manage your Lightsail resources using the Lightsail console, Lightsail API, AWS Command Line Interface (AWS CLI), or SDKs. For more information about Lightsail concepts and tasks, see the Lightsail Dev Guide.
This API Reference provides detailed information about the actions, data types, parameters, and errors of the Lightsail service. For more information about the supported AWS Regions, endpoints, and service quotas of the Lightsail service, see Amazon Lightsail Endpoints and Quotas in the AWS General Reference.
lightsail(config = list())A client for the service. You can call the service's operations using
syntax like svc$operation(...), where svc is the name you've assigned
to the client. The available operations are listed in the
Operations section.
Optional configuration of credentials, endpoint, and/or region.
svc <- lightsail(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string"
),
endpoint = "string",
region = "string"
)
)
| allocate_static_ip | Allocates a static IP address |
| attach_certificate_to_distribution | Attaches an SSL/TLS certificate to your Amazon Lightsail content delivery network (CDN) distribution |
| attach_disk | Attaches a block storage disk to a running or stopped Lightsail instance and exposes it to the instance with the specified disk name |
| attach_instances_to_load_balancer | Attaches one or more Lightsail instances to a load balancer |
| attach_load_balancer_tls_certificate | Attaches a Transport Layer Security (TLS) certificate to your load balancer |
| attach_static_ip | Attaches a static IP address to a specific Amazon Lightsail instance |
| close_instance_public_ports | Closes ports for a specific Amazon Lightsail instance |
| copy_snapshot | Copies a manual snapshot of an instance or disk as another manual snapshot, or copies an automatic snapshot of an instance or disk as a manual snapshot |
| create_certificate | Creates an SSL/TLS certificate for a Amazon Lightsail content delivery network (CDN) distribution |
| create_cloud_formation_stack | Creates an AWS CloudFormation stack, which creates a new Amazon EC2 instance from an exported Amazon Lightsail snapshot |
| create_contact_method | Creates an email or SMS text message contact method |
| create_container_service | Creates an Amazon Lightsail container service |
| create_container_service_deployment | Creates a deployment for your Amazon Lightsail container service |
| create_container_service_registry_login | Creates a temporary set of log in credentials that you can use to log in to the Docker process on your local machine |
| create_disk | Creates a block storage disk that can be attached to an Amazon Lightsail instance in the same Availability Zone (e |
| create_disk_from_snapshot | Creates a block storage disk from a manual or automatic snapshot of a disk |
| create_disk_snapshot | Creates a snapshot of a block storage disk |
| create_distribution | Creates an Amazon Lightsail content delivery network (CDN) distribution |
| create_domain | Creates a domain resource for the specified domain (e |
| create_domain_entry | Creates one of the following domain name system (DNS) records in a domain DNS zone: Address (A), canonical name (CNAME), mail exchanger (MX), name server (NS), start of authority (SOA), service locator (SRV), or text (TXT) |
| create_instances | Creates one or more Amazon Lightsail instances |
| create_instances_from_snapshot | Creates one or more new instances from a manual or automatic snapshot of an instance |
| create_instance_snapshot | Creates a snapshot of a specific virtual private server, or instance |
| create_key_pair | Creates an SSH key pair |
| create_load_balancer | Creates a Lightsail load balancer |
| create_load_balancer_tls_certificate | Creates a Lightsail load balancer TLS certificate |
| create_relational_database | Creates a new database in Amazon Lightsail |
| create_relational_database_from_snapshot | Creates a new database from an existing database snapshot in Amazon Lightsail |
| create_relational_database_snapshot | Creates a snapshot of your database in Amazon Lightsail |
| delete_alarm | Deletes an alarm |
| delete_auto_snapshot | Deletes an automatic snapshot of an instance or disk |
| delete_certificate | Deletes an SSL/TLS certificate for your Amazon Lightsail content delivery network (CDN) distribution |
| delete_contact_method | Deletes a contact method |
| delete_container_image | Deletes a container image that is registered to your Amazon Lightsail container service |
| delete_container_service | Deletes your Amazon Lightsail container service |
| delete_disk | Deletes the specified block storage disk |
| delete_disk_snapshot | Deletes the specified disk snapshot |
| delete_distribution | Deletes your Amazon Lightsail content delivery network (CDN) distribution |
| delete_domain | Deletes the specified domain recordset and all of its domain records |
| delete_domain_entry | Deletes a specific domain entry |
| delete_instance | Deletes an Amazon Lightsail instance |
| delete_instance_snapshot | Deletes a specific snapshot of a virtual private server (or instance) |
| delete_key_pair | Deletes a specific SSH key pair |
| delete_known_host_keys | Deletes the known host key or certificate used by the Amazon Lightsail browser-based SSH or RDP clients to authenticate an instance |
| delete_load_balancer | Deletes a Lightsail load balancer and all its associated SSL/TLS certificates |
| delete_load_balancer_tls_certificate | Deletes an SSL/TLS certificate associated with a Lightsail load balancer |
| delete_relational_database | Deletes a database in Amazon Lightsail |
| delete_relational_database_snapshot | Deletes a database snapshot in Amazon Lightsail |
| detach_certificate_from_distribution | Detaches an SSL/TLS certificate from your Amazon Lightsail content delivery network (CDN) distribution |
| detach_disk | Detaches a stopped block storage disk from a Lightsail instance |
| detach_instances_from_load_balancer | Detaches the specified instances from a Lightsail load balancer |
| detach_static_ip | Detaches a static IP from the Amazon Lightsail instance to which it is attached |
| disable_add_on | Disables an add-on for an Amazon Lightsail resource |
| download_default_key_pair | Downloads the default SSH key pair from the user's account |
| enable_add_on | Enables or modifies an add-on for an Amazon Lightsail resource |
| export_snapshot | Exports an Amazon Lightsail instance or block storage disk snapshot to Amazon Elastic Compute Cloud (Amazon EC2) |
| get_active_names | Returns the names of all active (not deleted) resources |
| get_alarms | Returns information about the configured alarms |
| get_auto_snapshots | Returns the available automatic snapshots for an instance or disk |
| get_blueprints | Returns the list of available instance images, or blueprints |
| get_bundles | Returns the list of bundles that are available for purchase |
| get_certificates | Returns information about one or more Amazon Lightsail SSL/TLS certificates |
| get_cloud_formation_stack_records | Returns the CloudFormation stack record created as a result of the create cloud formation stack operation |
| get_contact_methods | Returns information about the configured contact methods |
| get_container_api_metadata | Returns information about Amazon Lightsail containers, such as the current version of the Lightsail Control (lightsailctl) plugin |
| get_container_images | Returns the container images that are registered to your Amazon Lightsail container service |
| get_container_log | Returns the log events of a container of your Amazon Lightsail container service |
| get_container_service_deployments | Returns the deployments for your Amazon Lightsail container service |
| get_container_service_metric_data | Returns the data points of a specific metric of your Amazon Lightsail container service |
| get_container_service_powers | Returns the list of powers that can be specified for your Amazon Lightsail container services |
| get_container_services | Returns information about one or more of your Amazon Lightsail container services |
| get_disk | Returns information about a specific block storage disk |
| get_disks | Returns information about all block storage disks in your AWS account and region |
| get_disk_snapshot | Returns information about a specific block storage disk snapshot |
| get_disk_snapshots | Returns information about all block storage disk snapshots in your AWS account and region |
| get_distribution_bundles | Returns the list bundles that can be applied to you Amazon Lightsail content delivery network (CDN) distributions |
| get_distribution_latest_cache_reset | Returns the timestamp and status of the last cache reset of a specific Amazon Lightsail content delivery network (CDN) distribution |
| get_distribution_metric_data | Returns the data points of a specific metric for an Amazon Lightsail content delivery network (CDN) distribution |
| get_distributions | Returns information about one or more of your Amazon Lightsail content delivery network (CDN) distributions |
| get_domain | Returns information about a specific domain recordset |
| get_domains | Returns a list of all domains in the user's account |
| get_export_snapshot_records | Returns the export snapshot record created as a result of the export snapshot operation |
| get_instance | Returns information about a specific Amazon Lightsail instance, which is a virtual private server |
| get_instance_access_details | Returns temporary SSH keys you can use to connect to a specific virtual private server, or instance |
| get_instance_metric_data | Returns the data points for the specified Amazon Lightsail instance metric, given an instance name |
| get_instance_port_states | Returns the firewall port states for a specific Amazon Lightsail instance, the IP addresses allowed to connect to the instance through the ports, and the protocol |
| get_instances | Returns information about all Amazon Lightsail virtual private servers, or instances |
| get_instance_snapshot | Returns information about a specific instance snapshot |
| get_instance_snapshots | Returns all instance snapshots for the user's account |
| get_instance_state | Returns the state of a specific instance |
| get_key_pair | Returns information about a specific key pair |
| get_key_pairs | Returns information about all key pairs in the user's account |
| get_load_balancer | Returns information about the specified Lightsail load balancer |
| get_load_balancer_metric_data | Returns information about health metrics for your Lightsail load balancer |
| get_load_balancers | Returns information about all load balancers in an account |
| get_load_balancer_tls_certificates | Returns information about the TLS certificates that are associated with the specified Lightsail load balancer |
| get_operation | Returns information about a specific operation |
| get_operations | Returns information about all operations |
| get_operations_for_resource | Gets operations for a specific resource (e |
| get_regions | Returns a list of all valid regions for Amazon Lightsail |
| get_relational_database | Returns information about a specific database in Amazon Lightsail |
| get_relational_database_blueprints | Returns a list of available database blueprints in Amazon Lightsail |
| get_relational_database_bundles | Returns the list of bundles that are available in Amazon Lightsail |
| get_relational_database_events | Returns a list of events for a specific database in Amazon Lightsail |
| get_relational_database_log_events | Returns a list of log events for a database in Amazon Lightsail |
| get_relational_database_log_streams | Returns a list of available log streams for a specific database in Amazon Lightsail |
| get_relational_database_master_user_password | Returns the current, previous, or pending versions of the master user password for a Lightsail database |
| get_relational_database_metric_data | Returns the data points of the specified metric for a database in Amazon Lightsail |
| get_relational_database_parameters | Returns all of the runtime parameters offered by the underlying database software, or engine, for a specific database in Amazon Lightsail |
| get_relational_databases | Returns information about all of your databases in Amazon Lightsail |
| get_relational_database_snapshot | Returns information about a specific database snapshot in Amazon Lightsail |
| get_relational_database_snapshots | Returns information about all of your database snapshots in Amazon Lightsail |
| get_static_ip | Returns information about a specific static IP |
| get_static_ips | Returns information about all static IPs in the user's account |
| import_key_pair | Imports a public SSH key from a specific key pair |
| is_vpc_peered | Returns a Boolean value indicating whether your Lightsail VPC is peered |
| open_instance_public_ports | Opens ports for a specific Amazon Lightsail instance, and specifies the IP addresses allowed to connect to the instance through the ports, and the protocol |
| peer_vpc | Tries to peer the Lightsail VPC with the user's default VPC |
| put_alarm | Creates or updates an alarm, and associates it with the specified metric |
| put_instance_public_ports | Opens ports for a specific Amazon Lightsail instance, and specifies the IP addresses allowed to connect to the instance through the ports, and the protocol |
| reboot_instance | Restarts a specific instance |
| reboot_relational_database | Restarts a specific database in Amazon Lightsail |
| register_container_image | Registers a container image to your Amazon Lightsail container service |
| release_static_ip | Deletes a specific static IP from your account |
| reset_distribution_cache | Deletes currently cached content from your Amazon Lightsail content delivery network (CDN) distribution |
| send_contact_method_verification | Sends a verification request to an email contact method to ensure it's owned by the requester |
| start_instance | Starts a specific Amazon Lightsail instance from a stopped state |
| start_relational_database | Starts a specific database from a stopped state in Amazon Lightsail |
| stop_instance | Stops a specific Amazon Lightsail instance that is currently running |
| stop_relational_database | Stops a specific database that is currently running in Amazon Lightsail |
| tag_resource | Adds one or more tags to the specified Amazon Lightsail resource |
| test_alarm | Tests an alarm by displaying a banner on the Amazon Lightsail console |
| unpeer_vpc | Attempts to unpeer the Lightsail VPC from the user's default VPC |
| untag_resource | Deletes the specified set of tag keys and their values from the specified Amazon Lightsail resource |
| update_container_service | Updates the configuration of your Amazon Lightsail container service, such as its power, scale, and public domain names |
| update_distribution | Updates an existing Amazon Lightsail content delivery network (CDN) distribution |
| update_distribution_bundle | Updates the bundle of your Amazon Lightsail content delivery network (CDN) distribution |
| update_domain_entry | Updates a domain recordset after it is created |
| update_load_balancer_attribute | Updates the specified attribute for a load balancer |
| update_relational_database | Allows the update of one or more attributes of a database in Amazon Lightsail |
| update_relational_database_parameters | Allows the update of one or more parameters of a database in Amazon Lightsail |
if (FALSE) {
svc <- lightsail()
svc$allocate_static_ip(
Foo = 123
)
}
Run the code above in your browser using DataLab