本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AddStorageSystem
為您希望 DataSync Discovery 收集相關AWS資訊的內部部署儲存系統建立資源。
請求語法
{
"AgentArns": [ "string" ],
"ClientToken": "string",
"CloudWatchLogGroupArn": "string",
"Credentials": {
"Password": "string",
"Username": "string"
},
"Name": "string",
"ServerConfiguration": {
"ServerHostname": "string",
"ServerPort": number
},
"SystemType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}請求參數
如需有關所有動作共用之參數的資訊，請參閱一般參數。
請求接受採用 JSON 格式的下列資料。
- AgentArns
-
指定連接到現場部署儲存系統的DataSync代理程式 Amazon Resource Name (ARN)。
類型：字串陣列
陣列成員：固定項目數為 1。
長度限制：長度上限為 128。
模式：
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$必要：是
- ClientToken
-
指定用戶端權杖，以確保使用此 API 作業的要求是冪等的。若您沒有指定用戶端權杖，DataSync會自動為您產生名稱。
類型：String
模式：
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}必要：是
- CloudWatchLogGroupArn
-
指定 Amazon CloudWatch 日誌群組的 ARN，以監控和記錄探索任務事件。
類型：字串
長長長限為 562。
模式：
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$必要：否
- Credentials
-
指定用於存取出內部部署儲存系統管理介面的使用者名稱和密碼。
類型：Credentials 物件
必要：是
- Name
-
指定內部部署儲存系統的熟悉名稱。
類型：字串
長度限制：長度下限為 1。長度上限為 256。
模式：
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$必要：否
- ServerConfiguration
-
指定與內部部署儲存系統的管理介面連線所需的伺服器名稱和網路連接埠。
類型：DiscoveryServerConfiguration 物件
必要：是
- SystemType
-
指定您希望DataSync探索收集相關資訊的內部部署儲存系統類型。
注意
DataSync探索目前支援執行 ON NetApp TAP 9.7 或更新版本的光纖連接儲存裝置 (FAS) 和全快閃 FAS (AFF) 系統。
類型：字串
有效值:
NetAppONTAP必要：是
- Tags
-
指定可協助您分類、篩選和搜尋 AWS 資源的標籤。建議您為內部署儲存系統建立至少一個名稱標籤。
類型：TagListEntry 物件陣列
陣列成員：項目數下限為 0。項目數上限為 50。
必要：否
回應語法
{
"StorageSystemArn": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- StorageSystemArn
-
可與DataSync探索搭配使用的內部部署儲存系統的 ARN。
類型：字串
長度限制：長度上限為 128。
模式：
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
錯誤
如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。
- InternalException
-
當在AWS DataSync服務中發生錯誤時，拋出此異常。
HTTP 狀態碼：500
- InvalidRequestException
-
當客戶端提交格式錯誤的請求時，拋出此異常。
HTTP 狀態碼：400
範例
請求範例
下列範例會將內部部署儲存系統新增至DataSync探索。
{ "ServerConfiguration": { "ServerHostname": "172.16.0.0", "ServerPort": 443 }, "SystemType": "NetAppONTAP", "AgentArns": [ "arn:aws:datasync:us-east-1:111222333444:agent/agent-012345abcde012345" ], "CloudWatchLogGroupArn": "arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync/discovery:*", "Tags": [ { "Key": "Migration Plan", "Value": "1" } ], "Name": "MyOnPremStorage", "Credentials": { "Username": "admin", "Password": "1234" } }
回應範例
回應會傳回您剛剛新增至DataSync探索之內部部署儲存系統的 ARN。
{ "StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890" }
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
