本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 取代您的 AWS DataSync 代理程式
若要取代 AWS DataSync 客服人員，您必須建立新的客服人員，並更新任何使用舊客服人員的轉接位置。
## 建立新的代理程式
若要建立新的 DataSync 代理程式，請在建立舊代理程式時遵循相同的程序：
1. 在您的儲存環境中[部署代理程式](deploy-agents.md)。
1. [選擇代理程式用來與之通訊的服務端點](choose-service-endpoint.md) AWS。
1. [設定您的網路](datasync-network.md)，以便客服人員可以與您的儲存體和 通訊 AWS。
1. [啟用您的代理程式](activate-agent.md)。
1. 啟用後，記下客服人員的 Amazon Resource Name (ARN)。
更新 DataSync 位置以使用新的代理程式時，您需要此 ARN。
## 使用新的代理程式更新您的位置
建立新的代理程式後，您可以更新現有的 DataSync 位置以使用此代理程式。在大多數情況下，您也必須重新輸入存取憑證才能更新位置。這是因為 DataSync 以只有您的代理程式可以使用的方式存放位置登入資料。
### 使用 DataSync 主控台
下列指示說明如何使用 DataSync 主控台，以新的代理程式更新位置。
------
#### [ NFS ]
1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。
1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**位置**。
1. 選擇您要更新的位置，然後選擇**編輯**。
1. 針對**客服人員**，選擇您的新客服人員。
如果您要為某個位置取代[多個客服人員，您可以選擇多個客服人員](do-i-need-datasync-agent.md#multiple-agents)。
1. 選擇 **Save changes** (儲存變更)。
------
#### [ SMB ]
1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。
1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**位置**。
1. 選擇您要更新的位置，然後選擇**編輯**。
1. 針對**客服人員**，選擇您的新客服人員。
如果您要為某個位置取代[多個客服人員，您可以選擇多個客服人員](do-i-need-datasync-agent.md#multiple-agents)。
1. 針對**密碼**，輸入可掛載 SMB 檔案伺服器且具有許可存取傳輸中涉及之檔案和資料夾的使用者密碼。
1. 選擇 **Save changes** (儲存變更)。
------
#### [ HDFS ]
1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。
1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**位置**。
1. 選擇您要更新的位置，然後選擇**編輯**。
1. 針對**客服人員**，選擇您的新客服人員。
如果您要為某個位置取代[多個客服人員，您可以選擇多個客服人員](do-i-need-datasync-agent.md#multiple-agents)。
1. 如果您使用 Kerberos 身分驗證，請上傳您的 **Keytab 檔案**和 **Kerberos 組態檔案**。
1. 選擇 **Save changes** (儲存變更)。
------
#### [ Object storage ]
1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。
1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**位置**。
1. 選擇您要更新的位置，然後選擇**編輯**。
1. 針對**客服人員**，選擇您的新客服人員。
如果您要為某個位置取代[多個客服人員，您可以選擇多個客服人員](do-i-need-datasync-agent.md#multiple-agents)。
1. 如果您的位置需要登入資料，請輸入允許 DataSync 存取物件儲存貯體的**私密金鑰**。
1. 選擇 **Save changes** (儲存變更)。
------
#### [ Azure Blob 儲存體 ]
執行下列動作以更新您的Microsoft Azure Blob Storage位置：
1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。
1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**位置**。
1. 選擇您要更新的位置，然後選擇**編輯**。
1. 針對**客服人員**，選擇您的新客服人員。
如果您要為某個位置取代[多個客服人員，您可以選擇多個客服人員](do-i-need-datasync-agent.md#multiple-agents)。
1. 針對 **SAS 字符**，輸入允許 DataSync 存取 Blob 儲存體的[共用存取簽章 (SAS) 字符](creating-azure-blob-location.md#azure-blob-sas-tokens)。
1. 選擇 **Save changes** (儲存變更)。
------
### 使用 AWS CLI
下列指示說明如何使用 更新位置與新的代理程式 AWS CLI。（您也可以使用 [DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html) 來執行此操作。)
------
#### [ NFS ]
1. 複製下列 [update-location-nfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html) 命令：
```
aws datasync update-location-nfs \
--location-arn datasync-nfs-location-arn \
--on-prem-config AgentArns=new-datasync-agent-arn
```
1. 針對 `--location-arn` 參數，指定您要更新的 NFS 位置 ARN。
1. 針對 `--on-prem-config` 參數`AgentArns`的選項，指定新代理程式的 ARN。
如果您要為某個位置取代[多個客服人員](do-i-need-datasync-agent.md#multiple-agents)，您可以指定多個 ARN。
1. 執行 `update-location-nfs`命令以更新位置。
------
#### [ SMB ]
1. 複製下列 [update-location-smb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html) 命令：
```
aws datasync update-location-smb \
--location-arn datasync-smb-location-arn \
--agent-arns new-datasync-agent-arn \
--password smb-file-server-password
```
1. 針對 `--location-arn` 參數，指定您要更新之 SMB 位置的 ARN。
1. 針對 `--agent-arns` 參數，指定新代理程式的 ARN。
如果您要為某個位置取代[多個客服人員](do-i-need-datasync-agent.md#multiple-agents)，您可以指定多個 ARN。
1. 針對 `--password` 參數，指定可掛載 SMB 檔案伺服器，並具有許可可存取傳輸中涉及之檔案和資料夾的使用者密碼。
1. 執行 `update-location-smb`命令以更新位置。
------
#### [ HDFS ]
1. 複製下列 [update-location-hdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html) 命令：
```
aws datasync update-location-hdfs \
--location-arn datasync-hdfs-location-arn \
--agent-arns new-datasync-agent-arn \
--kerberos-keytab keytab-file \
--kerberos-krb5-conf krb5-conf-file
```
1. 針對 `--location-arn` 參數，指定您要更新的 HDFS 位置 ARN。
1. 針對 `--agent-arns` 參數，指定新代理程式的 ARN。
如果您要為某個位置取代[多個客服人員](do-i-need-datasync-agent.md#multiple-agents)，您可以指定多個 ARN。
1. 如果您使用 Kerberos 身分驗證，請包含 `--kerberos-keytab`和 `--kerberos-krb5-conf` 參數：
+ 針對 `--kerberos-keytab` 參數，指定 Kerberos 金鑰資料表 (keytab)，其中包含已定義 Kerberos 主體和加密金鑰之間的映射。
您可以提供檔案的地址來指定 keytab 檔案。
+ 針對 `--kerberos-krb5-conf` 參數，指定包含 Kerberos 領域組態的檔案。
您可以提供`krb5.conf`檔案的地址來指定檔案。
如果您使用的是簡單的身分驗證，則不需要在命令中包含這些 Kerberos 相關參數。
1. 執行 `update-location-hdfs`命令以更新位置。
------
#### [ Object storage ]
1. 複製下列 [update-location-object-storage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html) 命令：
```
aws datasync update-location-object-storage \
--location-arn datasync-object-storage-location-arn \
--agent-arns new-datasync-agent-arn \
--secret-key bucket-secret-key
```
1. 針對 `--location-arn` 參數，指定您要更新之物件儲存位置的 ARN。
1. 針對 `--agent-arns` 參數，指定新代理程式的 ARN。
如果您要為某個位置取代[多個客服人員](do-i-need-datasync-agent.md#multiple-agents)，您可以指定多個 ARN。
1. 根據您的物件儲存位置是否需要存取憑證，執行下列動作：
+ **如果您的位置需要登入**資料 – 針對 `--secret-key` 參數，請指定允許 DataSync 存取物件儲存貯體的私密金鑰。
+ **如果您的位置需要登入資料** – 為 `--access-key`和 `--secret-key` 參數指定空字串。以下是範例命令：
```
aws datasync update-location-object-storage \
--location-arn arn:aws:datasync:us-east-2:111122223333:location/loc-abcdef01234567890 \
--agent-arns arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0 \
--access-key "" \
--secret-key ""
```
1. 執行 `update-location-object-storage`命令以更新位置。
------
#### [ Azure Blob 儲存體 ]
1. 複製下列 [update-location-azure-blob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html) 命令：
```
aws datasync update-location-azure-blob \
--location-arn datasync-azure-blob-storage-location-arn \
--agent-arns new-datasync-agent-arn \
--sas-configuration '{
"Token": "sas-token-for-azure-blob-storage"
}'
```
1. 針對 `--location-arn` 參數，指定您要更新Azure Blob Storage的位置的 ARN。
1. 針對 `--agent-arns` 參數，指定新代理程式的 ARN。
如果您要為某個位置取代[多個客服人員](do-i-need-datasync-agent.md#multiple-agents)，您可以指定多個 ARN。
1. 針對 `--sas-configuration` 參數`Token`的選項，指定允許 DataSync 存取 Blob 儲存體的 [SAS 權杖](creating-azure-blob-location.md#azure-blob-sas-tokens)。
1. 執行 `update-location-azure-blob`命令以更新位置。
------
## 後續步驟
1. [刪除舊的代理程式](clean-up.md#deleting-agent)。如果您有任何使用此代理程式的執行中 DataSync 任務，請等到這些任務完成再將其刪除。
1. 如果您需要取代多個位置的客服人員，請重複上述步驟。
1. 完成後，您可以繼續[執行任務](run-task.md)。
**注意**
**取代排程任務的客服人員** – 如果您取代[排程任務](task-scheduling.md)的客服人員，且新客服人員使用與舊客服人員不同的[服務端點](choose-service-endpoint.md)類型，則必須手動啟動該任務。如果您在下一次排程執行之前未手動執行任務，任務會失敗。
例如，如果您的舊代理程式使用公有服務端點，但新代理程式使用 VPC 端點，請使用 主控台或 `StartTaskExecution`操作手動啟動該任務。之後，您的任務會繼續依排程執行。