本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateLocationAzureBlob
建立 Microsoft Azure Blob Storage Container 的傳輸位置。 AWS DataSync 可以使用此位置做為傳輸來源或目的地。您可以使用或不使用連線至容器的 DataSync 代理程式來進行傳輸。
開始之前，請確定您知道 DataSync 如何存取 Azure Blob Storage，以及如何使用存取層和 Blob 類型。
請求語法
{
"AccessTier": "string",
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlobType": "string",
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"ContainerUrl": "string",
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"SasConfiguration": {
"Token": "string"
},
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- AccessTier
-
指定您希望物件或檔案傳輸到的存取層。這僅適用於使用位置做為傳輸目的地時。如需詳細資訊，請參閱存取層。
類型：字串
有效值:
HOT | COOL | ARCHIVE必要：否
- AgentArns
-
（選用） 指定可與 Azure Blob Storage 容器連線之 DataSync 代理程式的 Amazon Resource Name (ARN)。如果您要設定無代理程式跨雲端傳輸，則不需要為此參數指定值。
您可以指定多個代理程式。如需詳細資訊，請參閱使用多個客服人員進行轉接。
注意
首次建立儲存位置時，請務必正確設定此參數。您無法在建立代理程式之後，從儲存位置新增或移除代理程式。
類型：字串陣列
陣列成員：項目數下限為 1。最多 4 個項目。
長度限制：長度上限為 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}$必要：否
- AuthenticationType
-
指定 DataSync 用來存取 Azure Blob Storage 的身分驗證方法。DataSync 可以使用共用存取簽章 (SAS) 存取 Blob 儲存。
類型：字串
有效值:
SAS | NONE必要：是
- BlobType
-
指定您希望物件或檔案在傳輸到 Azure Blob Storage 時的 Blob 類型。目前，DataSync 僅支援將資料移至 Azure Blob Storage 做為區塊 Blob。如需 Blob 類型的詳細資訊，請參閱 Azure Blob Storage 文件
。 類型：字串
有效值:
BLOCK必要：否
- CmkSecretConfig
-
指定 DataSync 受管秘密的組態資訊，其中包含 DataSync 使用客戶受管存取特定 AzureBlob 儲存位置的身分驗證字符 AWS KMS key。
當您將此參數包含在
CreateLocationAzureBlob請求中時，您只需提供 KMS 金鑰 ARN。DataSync 會將此 KMS 金鑰與您為 指定的身分驗證字符搭配使用SasConfiguration，以建立 DataSync 受管秘密來存放位置存取憑證。請確定 DataSync 具有存取您指定 KMS 金鑰的許可。
注意
您可以使用
CmkSecretConfig（搭配SasConfiguration) 或CustomSecretConfig（不含SasConfiguration) 來提供CreateLocationAzureBlob請求的登入資料。請勿為相同的請求提供這兩個參數。類型：CmkSecretConfig 物件
必要：否
- ContainerUrl
-
指定傳輸所涉及 Azure Blob Storage 容器的 URL。
類型：字串
長度限制：長度上限為 325。
模式：
^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$必要：是
- CustomSecretConfig
-
指定客戶受管 Secrets Manager 秘密的組態資訊，其中 AzureBlob 儲存位置的身分驗證字符會以純文字儲存。此組態包含秘密 ARN，以及提供秘密存取權之 IAM 角色的 ARN。
注意
您可以使用
CmkSecretConfig（搭配SasConfiguration) 或CustomSecretConfig（不含SasConfiguration) 來提供CreateLocationAzureBlob請求的登入資料。請勿為相同的請求提供這兩個參數。類型：CustomSecretConfig 物件
必要：否
- SasConfiguration
-
指定允許 DataSync 存取 Azure Blob Storage 的 SAS 組態。
注意
如果您使用 提供身分驗證字符
SasConfiguration，但未使用CmkSecretConfig或 提供秘密組態詳細資訊CustomSecretConfig，則 DataSync 會使用您 AWS 帳戶的秘密管理員秘密來存放字符。類型：AzureBlobSasConfiguration 物件
必要：否
- Subdirectory
-
如果您想要將傳輸限制在容器中的虛擬目錄 （例如，)，請指定路徑區段
/my/images。類型：字串
長度限制：長度上限為 1024。
模式：
^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$必要：否
- Tags
-
指定可協助您分類、篩選和搜尋 AWS 資源的標籤。我們建議為您的傳輸位置建立至少一個名稱標籤。
類型：TagListEntry 物件陣列
陣列成員：項目數下限為 0。項目數上限為 50。
必要：否
回應語法
{
"LocationArn": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- LocationArn
-
您建立之 Azure Blob Storage 傳輸位置的 ARN。
類型：字串
長度限制：長度上限為 128。
模式：
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InternalException
-
當服務發生錯誤 AWS DataSync 時，就會擲出此例外狀況。
HTTP 狀態碼：500
- InvalidRequestException
-
當用戶端提交格式不正確的請求時，會擲回此例外狀況。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
