本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 访问 Lightsail
<a name="access-lightsail"></a>

您可以使用各种接口和服务终端节点访问 Amazon Lightsail。

**Topics**
+ [Lightsail 服务接口](#access-lightsail-interfaces)
+ [Lightsail 服务端点](#lightsail-endpoints)
+ [指定端点的示例](#specify-endpoint-examples)

## Lightsail 服务接口
<a name="access-lightsail-interfaces"></a>

您可以使用以下界面创建和管理 Lightsail 资源。

**亚马逊 Lightsail 游戏机**  
一个用于创建和管理 Lightsail 实例和资源的简单网页界面。如果您已注册 AWS 帐户，则可以直接访问 [Lightsail 控制台](https://lightsail.aws.amazon.com/)，也可以登录 AWS 管理控制台 并从主机主页选择 Lights **ail**。

**AWS Command Line Interface**  
使您能够使用命令行 shell 中的命令与 AWS 服务进行交互。它在 Windows、Mac 和 Linux 上受支持。有关更多信息 AWS CLI，请参阅《[AWS Command Line Interface 用户指南》](https://docs.aws.amazon.com/cli/latest/userguide/)。你可以在 [C AWS LI 命令参考的 Lightsail 部分找到 Lightsail](https://docs.aws.amazon.com/cli/latest/reference/lightsail/#cli-aws-lightsail) 命令。

**AWS CloudShell**  
CloudShell 是一个基于浏览器、经过预先验证的 shell，您可以直接从启动。 AWS 管理控制台您可以使用首选外壳运行 AWS CLI 命令，例如 Bash PowerShell、或 Z shell。有关如何使用 AWS CloudShell 来管理 Lightsail 资源的示例，请参阅。[使用管理 Lightsail 资源 AWS CloudShell](amazon-lightsail-cloudshell.md)

**查询 API**  
Lightsail 提供了一个查询 API。这些请求属于 HTTP 或 HTTPS 请求，需要使用 HTTP 动词 GET 或 POST 以及一个名为 `Action` 的查询参数。有关 Lightsail 的 API 操作的更多信息，请参阅《*亚马逊 Lightsail API 参考*》中的[操作](https://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_Operations.html)。

**AWS SDKs**  
如果您更喜欢使用特定语言构建应用程序， APIs 而不是通过 HTTP 或 HTTPS 提交请求，请为软件开发人员 AWS 提供库、示例代码、教程和其他资源。这些库文件提供可自动执行任务的基本功能，例如以加密方式对请求签名、重试请求和处理错误响应，以便您可以更轻松地上手。有关更多信息，请参阅[用于在 AWS上进行构建的工具](https://aws.amazon.com/developer/tools/)。

**AWS Tools for PowerShell**  
一组基于公开的功能构建的 PowerShell 模块 适用于 .NET 的 SDK。这些工具 PowerShell 使您能够通过 PowerShell 命令行编写 AWS 资源操作脚本。要开始使用，请参阅[《AWS Tools for PowerShell 用户指南》](https://docs.aws.amazon.com/powershell/latest/userguide/)。[你可以在 Cmdlet 参考中找到 Lightsail 的 cmdlet。AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/Index.html)

## Lightsail 服务端点
<a name="lightsail-endpoints"></a>

端点是用作 AWS Web 服务入口点的 URL。对于前面描述的接口中的编程访问方法，Lightsail 支持以下端点类型：
+ [IPv4 端点](#ipv4-endpoints)
+ [双栈端点](#dual-stack-endpoints)（同时支持 IPv4 和 IPv6）

当您发出请求时，您可以指定要使用的端点。如果您未指定终端节点，则默认使用该 IPv4 终端节点。要使用不同的端点类型，您必须在请求中指定。

### IPv4 端点
<a name="ipv4-endpoints"></a>

IPv4 端点仅支持 IPv4 流量。 IPv4 终端节点适用于所有区域。有关区域服务端点的详细信息，请参阅 [按区域划分的服务端点](#service-endpoints)。

IPv4 端点名称使用以下命名约定：
+ `service.region.amazonaws.com`

例如，该`us-east-2`区域的 IPv4 终端节点名称为`lightsail.us-east-2.amazonaws.com`。

### 双栈（IPv4 和 IPv6）端点
<a name="dual-stack-endpoints"></a>

双栈端点同时支持 IPv4 和 IPv6 流量。当您向双栈终端节点发出请求时，终端节点 URL 会解析为 IPv6 或 IPv4 地址，具体取决于您的网络和客户端使用的协议。
+ `lightsail.region.api.aws`

例如，`us-east-2` 区域的双堆栈端点名称是 `lightsail.us-east-2.api.aws`。

### 按区域划分的服务端点
<a name="service-endpoints"></a>

以下是 Lightsail 的服务端点。有关 Lightsail 可用区域的更多信息，请参阅。[Lightsail 的区域和可用区](understanding-regions-and-availability-zones-in-amazon-lightsail.md)

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/lightsail/latest/userguide/access-lightsail.html)

## 指定端点的示例
<a name="specify-endpoint-examples"></a>

本节提供了一些在发出请求时如何指定端点的示例。

**注意**  
如果您未指定终端节点，则默认使用该 IPv4 终端节点。

------
#### [ AWS CLI ]

以下示例显示在使用 AWS CLI时，如何为 `us-east-2` 区域指定端点。
+ **IPv4**

  ```
  aws lightsail get-regions --region us-east-2 --endpoint-url https://lightsail.us-east-2.amazonaws.com
  ```
+ **双堆栈**

  ```
  aws lightsail get-regions --region us-east-2 --endpoint-url https://lightsail.us-east-2.api.aws
  ```

------
#### [ AWS SDK for Java 2.x ]

以下示例显示在使用 AWS SDK for Java 2.x时，如何为 `us-east-2` 区域指定端点。
+ **IPv4**

  ```
  LightsailClient client = LightsailClient.builder()
      .region(Region.US_EAST_2)
      .endpointOverride(URI.create("https://lightsail.us-east-2.amazonaws.com"))
      .build();
  ```
+ **双堆栈**

  ```
  LightsailClient client = LightsailClient.builder()
      .region(Region.US_EAST_2)
      .endpointOverride(URI.create("https://lightsail.us-east-2.api.aws"))
      .build();
  ```

------
#### [ 适用于 Java 的 AWS SDK 1.x ]

以下示例说明如何使用 适用于 Java 的 AWS SDK 1.x 为该`us-east-2`区域指定终端节点。
+ **IPv4**

  ```
  AmazonLightsail lightsail = AmazonLightsailClientBuilder.standard()
       .withEndpointConfiguration(new EndpointConfiguration(
            "https://lightsail.us-east-2.amazonaws.com",
            "us-east-2"))
       .build();
  ```
+ **双堆栈**

  ```
  AmazonLightsail lightsail = AmazonLightsailClientBuilder.standard()
       .withEndpointConfiguration(new EndpointConfiguration(
            "https://lightsail.us-east-2.api.aws",
            "us-east-2"))
       .build();
  ```

------
#### [ AWS SDK for Go ]

以下示例显示在使用 适用于 Go 的 AWS SDK时，如何为 `us-east-2` 区域指定端点。
+ **IPv4**

  ```
  sess := session.Must(session.NewSession())
  svc := lightsail.New(sess, &aws.Config{
      Region: aws.String(endpoints.UsEast2RegionID),
      Endpoint: aws.String("https://lightsail.us-east-2.amazonaws.com")
  })
  ```
+ **双堆栈**

  ```
  sess := session.Must(session.NewSession())
  svc := lightsail.New(sess, &aws.Config{
      Region: aws.String(endpoints.UsEast2RegionID),
      Endpoint: aws.String("https://lightsail.us-east-2.api.aws")
  })
  ```

------