本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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。最多 8 個項目。
長度限制：長度上限為 128。
模式：
^arn:(aws|aws-cn|aws-us-gov|aws-eusc|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 金鑰的許可。如需詳細資訊，請參閱使用以自訂加密的服務受管秘密 AWS KMS key。
注意
您可以使用
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 儲存位置的身分驗證字符存放在 Secrets Manager 的純文字中。此組態包含秘密 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-eusc|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 的詳細資訊，請參閱下列內容：
