本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon DCV Session Manager Amazon DCV 伺服器 - DNS 映射參考
<a name="dcv-server-dns-mapping"></a>

 Amazon DCV Connection Gateway 需要 Amazon DCV 伺服器的 DNS 名稱，才能連線至 DCV 伺服器執行個體。本節說明如何定義 JSON 檔案，其中包含每個 DCV 伺服器與其相關聯 DNS 名稱之間的映射。

## 檔案結構
<a name="file-structure"></a>

映射包含具有下列欄位的 JSON 物件清單：

```
[
	{
		“ServerIdType”: "Ip",
		“ServerId”: "192.168.0.1",
		“DnsNames”:
		{
			“InternalDnsName”: "internal"
		}
	},
	...
]
```

其中：

**`ServerIdType: `**  
識別值所指的 ID 類型；目前可用的值為 ipAddress、agentServerId 和 instanceId：    
**`Ip: `**  
適用於 Amazon EC2 和內部部署基礎設施；系統管理員可以使用 ifconfig (Linux/macOS) 或 ipconfig (Windows) 命令快速擷取。此資訊也可在 DescribeServers API 回應中使用。  
**`Id: `**  
適用於 Amazon EC2 和內部部署基礎設施；每次主機名稱或 IP 地址變更時，Session Manager Agent 都會建立新的 UUID。此資訊可在 DescribeServers API 回應中使用。  
**`Host.Aws.Ec2InstanceId: `**  
僅適用於 Amazon EC2 執行個體，它可唯一識別機器，執行個體重新啟動後不會變更。可透過聯絡 https：//http://169.254.169.254/latest/meta-data/instance-id 在主機上擷取。此資訊也可在 DescribeServers API 回應中使用。

**`ServerId: `**  
指定類型的 ID，可唯一識別網路中的每個 Amazon DCV 伺服器。

**`DnsNames: `**  
包含與此物件之 Amazon DCV 伺服器相關聯之 DNS 名稱的物件將包含：    
**`InternalDnsNames: `**  
Amazon DCV Connection Gateway 用來連線至執行個體的 DNS 名稱。

請使用 Session Manager Broker CLI 命令從檔案`register-server-dns-mapping`載入映射 （命令頁面參考： [register-server-dns-mapping](https://docs.aws.amazon.com/dcv/latest/sm-admin/register-server-dns-mappings.html))`describe-server-dns-mappings`，並列出 Session Manager Broker 中目前載入的映射 （命令頁面參考： [describe-server-dns-mappings](https://docs.aws.amazon.com/dcv/latest/sm-admin/describe-server-dns-mappings.html))。

## Persistence
<a name="persistence"></a>

我們強烈建議您啟用 Session Manager Broker 的持久性功能，以便在多個代理程式或整個叢集停機時防止映射遺失。如需啟用資料持久性的詳細資訊，請參閱[設定中介裝置持久性](https://docs.aws.amazon.com/dcv/latest/sm-admin/configure_broker_persistence.html)