本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
為您希望 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"
}
]
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- AgentArns
-
指定 DataSync 代理程式的 Amazon Resource Name (ARN)，該代理程式會連接至現場部署儲存系統的管理界面並從中讀取。您只能指定一個 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 會自動為您產生權杖。
類型：字串
模式：
[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 Discovery 收集資訊的現場部署儲存系統類型。
注意
DataSync Discovery 目前支援執行 ONTAP 9.7 或更新版本的 NetApp Fabric 連接儲存體 (FAS) 和全快閃 FAS (AFF) 系統。
類型：字串
有效值:
NetAppONTAP必要：是
- Tags
-
指定可協助您分類、篩選和搜尋 AWS 資源的標籤。建議您為內部部署儲存系統建立至少一個名稱標籤。
類型：TagListEntry 物件陣列
陣列成員：項目數下限為 0。項目數上限為 50。
必要：否
回應語法
{
"StorageSystemArn": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- StorageSystemArn
-
您可以與 DataSync Discovery 搭配使用的內部部署儲存系統的 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 Discovery。
{
"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 Discovery 之內部部署儲存系統的 ARN。
{
"StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890"
}另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：
