本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Snowball Edge 上設定和啟動 Amazon S3 相容儲存
從 安裝和設定軟體工具 AWS 到您的本機環境，以與 Snowball Edge 裝置或裝置叢集以及 Snowball Edge 上的 Amazon S3 相容儲存體互動。然後，使用這些工具來設定 Snowball Edge 裝置或叢集，並在 Snowball Edge 上啟動 Amazon S3 相容儲存。
## 先決條件
Snowball Edge 上的 Amazon S3 相容儲存需要您將 Snowball Edge 用戶端和 AWS CLI 安裝到本機環境。您也可以使用 適用於 .NET 的 SDK 和 AWS Tools for Windows PowerShell，在 Snowball Edge 上使用 Amazon S3 相容儲存。 AWS 建議使用下列版本的這些工具：
+ **Snowball Edge 用戶端** – 使用最新版本。如需詳細資訊，請參閱本指南中的[下載並安裝 Snowball Edge 用戶端](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client)。
+ **AWS CLI** – 2.11.15 版或更新版本。如需詳細資訊，請參閱 AWS Command Line Interface 《 使用者指南》中的[安裝、更新和解除安裝 AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) 。
+ **適用於 .NET 的 SDK** – AWSSDK.S3Control 3.7.304.8 或更新版本。如需詳細資訊，請參閱[適用於 .NET 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-net)。
+ **AWS 適用於 Windows PowerShell 的工具** – 4.1.476 版或更新版本。如需詳細資訊，請參閱 [AWS Tools for PowerShell 使用者指南](https://docs.aws.amazon.com/powershell/latest/userguide/)。
## 設定您的本機環境
本節說明如何設定 Snowball Edge 用戶端和您的本機環境，以搭配 Snowball Edge 上的 Amazon S3 相容儲存體使用。
1. 下載並安裝 Snowball Edge 用戶端。如需詳細資訊，請參閱[下載並安裝 Snowball Edge 用戶端](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#download-the-client)。
1. 設定 Snowball Edge 用戶端的設定檔。如需詳細資訊，請參閱[設定 Snowball Edge 用戶端的設定檔](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#client-configuration)。
1. 如果您使用的是 適用於 .NET 的 SDK，請設定 `clientConfig.AuthenticationRegion` 參數值，如下所示：
```
clientConfig.AuthenticationRegion = "snow"
```
### 設定 Snowball Edge 裝置
#### 在 Snowball Edge 上設定 IAM
AWS Identity and Access Management (IAM) 可協助您精細存取在 Snowball Edge 裝置上執行 AWS 的資源。您可以使用 IAM 來控制能通過身分驗證 (登入) 和授權使用資源的 (具有許可) 的人員。
Snowball Edge 在本機支援 IAM。您可以使用本機 IAM 服務來建立角色，並將 IAM 政策連接到這些角色。您可以使用這些政策來允許執行指派任務所需的存取權。
下列範例允許完整存取 Amazon S3 API：
------
#### [ JSON ]
****
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "s3:*",
"Resource": "*"
}
]
}
```
------
如需更多 IAM 政策範例，請參閱 [AWS Snowball 邊緣 開發人員指南](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-local-iam.html#policy-examples)。
## 在 Snowball Edge 服務上啟動 Amazon S3 相容儲存
使用下列指示，在 Snowball Edge 裝置或叢集上啟動 Snowball Edge 服務上的 Amazon S3 相容儲存。
如果您偏好更易於使用的體驗，您可以在 Snowball Edge 服務上為使用 的獨立裝置或裝置叢集啟動 Amazon S3 相容儲存 AWS OpsHub。請參閱 [使用 在 Snowball Edge 上設定 Amazon S3 相容儲存 AWS OpsHub](s3-edge-snow-opshub.md)。
1. 執行下列命令，將您的 Snowball Edge 裝置或裝置叢集解鎖：
+ 對於單一裝置：
```
snowballEdge unlock-device --endpoint https://snow-device-ip
```
+ 對於叢集：
```
snowballEdge unlock-cluster
```
1. 執行下列命令，並確認 Snowball Edge 裝置或裝置叢集已解除鎖定：
+ 對於單一裝置：
```
snowballEdge describe-device --endpoint https://snow-device-ip
```
+ 對於叢集：
```
snowballEdge describe-cluster --device-ip-addresses [snow-device-1-ip] [snow-device-2-ip] /
[snow-device-3-ip] [snow-device-4-ip] [snow-device-5-ip] /
[snow-device-6-ip]
```
1. 對於每個裝置 （無論您有一個或叢集），若要在 Snowball Edge 上啟動 Amazon S3 相容儲存，請執行下列動作：
1. 執行下列`describe-device`命令`PhysicalNetworkInterfaceId`來擷取裝置的 ：
```
snowballEdge describe-device --endpoint https://snow-device-ip
```
1. 執行下列`create-virtual-network-interface`命令兩次，為 （適用於儲存貯體操作） 和 `s3control`（適用於物件操作） 端點建立虛擬網路介面 `s3api`(VNIs)。
```
snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --manifest-file manifest --physical-network-interface-id "PhysicalNetworkInterfaceId" --unlock-code unlockcode --endpoint https://snow-device-ip
```
該命令會傳回含有 IP 地址的 JSON 結構。記下該 IP 地址。
如需這些命令的詳細資訊，請參閱[在 Snowball Edge 上設定虛擬網路界面 (VNI)](https://docs.aws.amazon.com/snowball/latest/developer-guide/network-config-ec2.html#setup-vni)。
**注意**
在 Snowball Edge 上啟動 Amazon S3 相容儲存會使用裝置資源。
1. 執行下列`start-service`命令，在 Snowball Edge 服務上啟動 Amazon S3 相容儲存。 包含裝置的 IP 地址，以及您為 `s3control`和 `s3api`端點建立的 VNIs 的 Amazon Resource Name (ARNs)：
若要在單一裝置上啟動服務：
```
snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2
```
若要在叢集上啟動服務：
```
snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2 vni-arn-3 vni-arn-4 vni-arn-5 vni-arn-6
```
對於 `--virtual-network-interface-arns`，請包含您在上一個步驟中建立的所有 VNIs 的 ARNs。使用空格分隔每個 ARN。
1. 針對單一裝置執行下列`describe-service`命令：
```
snowballEdge describe-service --service-id s3-snow
```
等到服務狀態為 `Active`。
針對叢集執行下列`describe-service`命令：
```
snowballEdge describe-service --service-id s3-snow \
--device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip
```
## 檢視 Snowball Edge 端點上 Amazon S3 相容儲存體的相關資訊
當 Snowball Edge 服務上的 Amazon S3 相容儲存體執行時，您可以使用 `describe-service` Snowball Edge 用戶端命令來檢視與 s3control 和 s3api 端點相關聯的 IP 地址。
```
snowballEdge describe-service --service-id s3-snow --endpoint https://snow-device-ip-address --profile profile-name
```
**Example `describe-service` 命令的輸出**
在此範例中，s3control 端點的 IP 地址為 192.168.1.222，s3api 端點的 IP 地址為 192.168.1.152。
```
{
"ServiceId": "s3-snow",
"Autostart": true,
"Status": {
"State": "ACTIVATING",
"Details": "Attaching storage"
},
"ServiceCapacities": [
{
"Name": "S3 Storage",
"Unit": "Byte",
"Used": 148599705600,
"Available": 19351400294400
}
],
"Endpoints": [
{
"Protocol": "https",
"Port": 443,
"Host": "192.168.1.222",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/30c563f1124707705117f57f6c3accd42a4528ed6dba1e35c1822a391a717199d8c49973d3c0283494d987463e826f2c"
},
"Description": "s3-snow bucket API endpoint (for s3control SDK)",
"DeviceId": "JID-beta-207429000001-23-12-28-03-51-11",
"Status": {
"State": "ACTIVE"
}
},
{
"Protocol": "https",
"Port": 443,
"Host": "192.168.1.152",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/30c563f1124707705117f57f6c3accd42a4528ed6dba1e35c1822a391a717199d8c49973d3c0283494d987463e826f2c"
},
"Description": "s3-snow object & bucket API endpoint (for s3api SDK)",
"DeviceId": "JID-beta-207429000001-23-12-28-03-51-11",
"Status": {
"State": "ACTIVATING"
}
}
]
}
```