翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateLocationAzureBlob Microsoft Azure Blob Storage コンテナの転送*場所*を作成します。この場所を転送元または転送先として AWS DataSync 使用できます。コンテナに接続する [DataSync エージェント](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent)の有無にかかわらず、転送を行うことができます。 始める前に、必ず [DataSync がどのように Azure Blob Storage にアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access)し、[アクセス層](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)と [BLOB タイプ](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types)で動作するかを確認しておいてください。 ## リクエストの構文 ``` { "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" } ] } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) ** オブジェクトまたはファイルの転送先となるアクセス層を指定します。これは、その場所を転送先として使用する場合にのみ適用されます。詳細については、「[アクセス層](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)」を参照してください。 タイプ: 文字列 有効な値：`HOT | COOL | ARCHIVE` 必須：いいえ ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) ** (オプション) Azure Blob Storage コンテナに接続できる DataSync エージェントの Amazon リソースネーム (ARN) を指定します。エージェントレスクロスクラウド転送を設定する場合は、このパラメータの値を指定する必要はありません。 複数のエージェントを指定できます。詳細については、「[複数のエージェントを転送に使用](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html)」を参照してください。 初めてストレージの場所を作成する際は、必ずこのパラメータを正しく設定してください。作成後にストレージの場所からエージェントを追加または削除することはできません。 型: 文字列の配列 配列メンバー: 最小数は 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](#API_CreateLocationAzureBlob_RequestSyntax) ** DataSync が Azure Blob Storage にアクセスするために使用する認証方法を指定します。DataSync は、共有アクセス署名 (SAS) を使用して blob storage にアクセスできます。 タイプ: 文字列 有効な値：`SAS | NONE` 必須: はい ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) ** オブジェクトまたはファイルを Azure Blob Storage に転送するときに使用する BLOB のタイプを指定します。現在、DataSync は、ブロック blobs としての Azure Blob Storage へのデータの移動のみをサポートしています。BLOB のタイプの詳細については、「[Azure Blob Storage のドキュメント](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs)」を参照してください。 タイプ: 文字列 有効な値：`BLOCK` 必須：いいえ ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** DataSync が管理するシークレットの設定情報を指定します。これには、DataSync がカスタマーマネージド AWS KMS keyを使用して特定の AzureBlob ストレージの場所にアクセスするために使用する認証トークンが含まれます。 このパラメータを`CreateLocationAzureBlob`リクエストの一部として含める場合は、KMS キー ARN のみを指定します。DataSync は、この KMS キーを `SasConfiguration` に指定した認証トークンとともに使用して、場所のアクセス認証情報を保存する DataSync マネージドシークレットを作成します。 DataSync に、指定した KMS キーへのアクセス許可があることを確認します。詳細については、[「カスタムで暗号化されたサービスマネージドシークレットの使用 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key)」を参照してください。 `CmkSecretConfig` (`SasConfiguration` あり) または `CustomSecretConfig` (`SasConfiguration` なし) を使用して、`CreateLocationAzureBlob` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。 型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト 必須: いいえ ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) ** 転送に含まれる 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](#API_CreateLocationAzureBlob_RequestSyntax) ** AzureBlob ストレージロケーションの認証トークンが Secrets Manager にプレーンテキストで保存される、カスタマー管理の Secrets Manager シークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。詳細については、[「管理するシークレットの使用](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key)」を参照してください。 `CmkSecretConfig` (`SasConfiguration` あり) または `CustomSecretConfig` (`SasConfiguration` なし) を使用して、`CreateLocationAzureBlob` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。 型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト 必須: いいえ ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) ** DataSync を Azure Blob Storage にアクセスできるようにする SAS 設定を指定します。 `SasConfiguration` を使用して認証トークンを提供するが、`CmkSecretConfig` または `CustomSecretConfig` を使用してシークレット設定の詳細を指定しない場合、DataSync は AWS アカウントの Secrets Manager シークレットを使用してトークンを保存します。 型: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) オブジェクト 必須: いいえ ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) ** 転送をコンテナ内の仮想ディレクトリ (例: `/my/images`) に制限する場合は、パスセグメントを指定します。 タイプ: 文字列 長さの制約: 最大長は 1,024 です。 パターン: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` 必須: いいえ ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) ** AWS リソースの分類、フィルタリング、および検索に役立つラベルを指定します。少なくても転送場所の名前タグを作成することを推奨します。 タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。 必須: いいえ ## レスポンスの構文 ``` { "LocationArn": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) ** 作成した 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}$` ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InternalException ** この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。 HTTP ステータスコード: 500 ** InvalidRequestException ** この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob)