翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS DataSync API
<a name="API_Reference"></a>

 AWS マネジメントコンソール および に加えて AWS CLI、 AWS DataSync API を使用して [AWS SDKs](https://aws.amazon.com/developer/tools/) で DataSync を設定および管理できます。

**Topics**
+ [

# アクション
](API_Operations.md)
+ [

# データ型
](API_Types.md)
+ [

# 共通エラー
](CommonErrors.md)
+ [

# 共通パラメータ
](CommonParameters.md)

# アクション
<a name="API_Operations"></a>

以下のアクションがサポートされています:
+  [CancelTaskExecution](API_CancelTaskExecution.md) 
+  [CreateAgent](API_CreateAgent.md) 
+  [CreateLocationAzureBlob](API_CreateLocationAzureBlob.md) 
+  [CreateLocationEfs](API_CreateLocationEfs.md) 
+  [CreateLocationFsxLustre](API_CreateLocationFsxLustre.md) 
+  [CreateLocationFsxOntap](API_CreateLocationFsxOntap.md) 
+  [CreateLocationFsxOpenZfs](API_CreateLocationFsxOpenZfs.md) 
+  [CreateLocationFsxWindows](API_CreateLocationFsxWindows.md) 
+  [CreateLocationHdfs](API_CreateLocationHdfs.md) 
+  [CreateLocationNfs](API_CreateLocationNfs.md) 
+  [CreateLocationObjectStorage](API_CreateLocationObjectStorage.md) 
+  [CreateLocationS3](API_CreateLocationS3.md) 
+  [CreateLocationSmb](API_CreateLocationSmb.md) 
+  [CreateTask](API_CreateTask.md) 
+  [DeleteAgent](API_DeleteAgent.md) 
+  [DeleteLocation](API_DeleteLocation.md) 
+  [DeleteTask](API_DeleteTask.md) 
+  [DescribeAgent](API_DescribeAgent.md) 
+  [DescribeLocationAzureBlob](API_DescribeLocationAzureBlob.md) 
+  [DescribeLocationEfs](API_DescribeLocationEfs.md) 
+  [DescribeLocationFsxLustre](API_DescribeLocationFsxLustre.md) 
+  [DescribeLocationFsxOntap](API_DescribeLocationFsxOntap.md) 
+  [DescribeLocationFsxOpenZfs](API_DescribeLocationFsxOpenZfs.md) 
+  [DescribeLocationFsxWindows](API_DescribeLocationFsxWindows.md) 
+  [DescribeLocationHdfs](API_DescribeLocationHdfs.md) 
+  [DescribeLocationNfs](API_DescribeLocationNfs.md) 
+  [DescribeLocationObjectStorage](API_DescribeLocationObjectStorage.md) 
+  [DescribeLocationS3](API_DescribeLocationS3.md) 
+  [DescribeLocationSmb](API_DescribeLocationSmb.md) 
+  [DescribeTask](API_DescribeTask.md) 
+  [DescribeTaskExecution](API_DescribeTaskExecution.md) 
+  [ListAgents](API_ListAgents.md) 
+  [ListLocations](API_ListLocations.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ListTaskExecutions](API_ListTaskExecutions.md) 
+  [ListTasks](API_ListTasks.md) 
+  [StartTaskExecution](API_StartTaskExecution.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateAgent](API_UpdateAgent.md) 
+  [UpdateLocationAzureBlob](API_UpdateLocationAzureBlob.md) 
+  [UpdateLocationEfs](API_UpdateLocationEfs.md) 
+  [UpdateLocationFsxLustre](API_UpdateLocationFsxLustre.md) 
+  [UpdateLocationFsxOntap](API_UpdateLocationFsxOntap.md) 
+  [UpdateLocationFsxOpenZfs](API_UpdateLocationFsxOpenZfs.md) 
+  [UpdateLocationFsxWindows](API_UpdateLocationFsxWindows.md) 
+  [UpdateLocationHdfs](API_UpdateLocationHdfs.md) 
+  [UpdateLocationNfs](API_UpdateLocationNfs.md) 
+  [UpdateLocationObjectStorage](API_UpdateLocationObjectStorage.md) 
+  [UpdateLocationS3](API_UpdateLocationS3.md) 
+  [UpdateLocationSmb](API_UpdateLocationSmb.md) 
+  [UpdateTask](API_UpdateTask.md) 
+  [UpdateTaskExecution](API_UpdateTaskExecution.md) 

# CancelTaskExecution
<a name="API_CancelTaskExecution"></a>

進行中の AWS DataSync タスク実行を停止します。一部のファイルの転送が突然中断されます。宛先に転送されるファイルの内容が不完全であるか、ソースファイルと矛盾している可能性があります。

ただし、同じタスクを使用して新しいタスクの実行を開始し、終了できるようにすると、転送先のファイルコンテンツは完全で一貫性のあるものになります。これは、タスクの実行を中断する他の予期しない障害にも当てはまります。これらのすべての場合において、次のタスク実行を開始すると、DataSync は転送を正常に完了します。

## リクエストの構文
<a name="API_CancelTaskExecution_RequestSyntax"></a>

```
{
   "TaskExecutionArn": "string"
}
```

## リクエストパラメーター
<a name="API_CancelTaskExecution_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) **   <a name="DataSync-CancelTaskExecution-request-TaskExecutionArn"></a>
停止するタスク実行の Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
必須: はい

## レスポンス要素
<a name="API_CancelTaskExecution_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_CancelTaskExecution_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CancelTaskExecution_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) 

# CreateAgent
<a name="API_CreateAgent"></a>

ストレージ環境にデプロイする AWS DataSync エージェントをアクティブ化します。アクティベーションプロセスは、エージェントを に関連付けます AWS アカウント。

エージェントをまだデプロイしていない場合は、[「Do I need a DataSync agent?」を参照してください。](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html)

## リクエストの構文
<a name="API_CreateAgent_RequestSyntax"></a>

```
{
   "ActivationKey": "string",
   "AgentName": "string",
   "SecurityGroupArns": [ "string" ],
   "SubnetArns": [ "string" ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VpcEndpointId": "string"
}
```

## リクエストパラメーター
<a name="API_CreateAgent_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
DataSync エージェントのアクティベーションキーを指定します。アクティベーションキーがない場合は、「[Activating your agent](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 29 です。  
パターン: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
必須: はい

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
エージェントの名前を指定します。覚えやすい名前を指定することをお勧めします。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
エージェントと VPC サービスエンドポイント間のトラフィックを許可するセキュリティグループの Amazon リソースネーム (ARN) を指定します。指定できる ARN は 1 つだけです。  
タイプ: 文字列の配列  
配列メンバー: 1 項目の定数です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: いいえ

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
VPC サービスエンドポイントがあるサブネットの ARN を指定します。指定できる ARN は 1 つだけです。  
タイプ: 文字列の配列  
配列メンバー: 1 項目の定数です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
必須: いいえ

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
 AWS リソースの分類、フィルタリング、検索に役立つラベルを指定します。エージェントには、少なくとも 1 つのタグを作成することをお勧めします。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
使用している [VPC サービスエンドポイント](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc)の ID を指定します。たとえば、VPC エンドポイント ID は `vpce-01234d5aff67890e1` のようになります。  
使用する VPC サービスエンドポイントには、DataSync サービス名 (例: `com.amazonaws.us-east-2.datasync`) が含まれている必要があります。
タイプ: 文字列  
パターン: `^vpce-[0-9a-f]{17}$`   
必須: いいえ

## レスポンスの構文
<a name="API_CreateAgent_ResponseSyntax"></a>

```
{
   "AgentArn": "string"
}
```

## レスポンス要素
<a name="API_CreateAgent_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
上記でアクティブ化したエージェントの ARN。[ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html) オペレーションを使用して、 AWS アカウント および のエージェントのリストを返します AWS リージョン。  
タイプ: 文字列  
長さの制約: 最大長は 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}$` 

## エラー
<a name="API_CreateAgent_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_CreateAgent_Examples"></a>

### リクエスト例
<a name="API_CreateAgent_Example_1"></a>

次の例では、DataSync エージェントをアクティブ化します。

```
{
    "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE",
    "AgentName": "MyAgent",
    "Tags": [{
        "Key": "Job",
        "Value": "TransferJob-1"
    }]
}
```

### レスポンス例
<a name="API_CreateAgent_Example_2"></a>

レスポンスは、アクティブ化されたエージェントの ARN を返します。

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3"
}
```

## 以下の資料も参照してください。
<a name="API_CreateAgent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent) 

# CreateLocationAzureBlob
<a name="API_CreateLocationAzureBlob"></a>

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)で動作するかを確認しておいてください。

## リクエストの構文
<a name="API_CreateLocationAzureBlob_RequestSyntax"></a>

```
{
   "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"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationAzureBlob_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AccessTier"></a>
オブジェクトまたはファイルの転送先となるアクセス層を指定します。これは、その場所を転送先として使用する場合にのみ適用されます。詳細については、「[アクセス層](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)」を参照してください。  
タイプ: 文字列  
有効な値：`HOT | COOL | ARCHIVE`  
必須：いいえ

 ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AgentArns"></a>
(オプション) 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) **   <a name="DataSync-CreateLocationAzureBlob-request-AuthenticationType"></a>
DataSync が Azure Blob Storage にアクセスするために使用する認証方法を指定します。DataSync は、共有アクセス署名 (SAS) を使用して blob storage にアクセスできます。  
タイプ: 文字列  
有効な値：`SAS | NONE`  
必須: はい

 ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-BlobType"></a>
オブジェクトまたはファイルを 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) **   <a name="DataSync-CreateLocationAzureBlob-request-CmkSecretConfig"></a>
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) **   <a name="DataSync-CreateLocationAzureBlob-request-ContainerUrl"></a>
転送に含まれる 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) **   <a name="DataSync-CreateLocationAzureBlob-request-CustomSecretConfig"></a>
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) **   <a name="DataSync-CreateLocationAzureBlob-request-SasConfiguration"></a>
DataSync を Azure Blob Storage にアクセスできるようにする SAS 設定を指定します。  
`SasConfiguration` を使用して認証トークンを提供するが、`CmkSecretConfig` または `CustomSecretConfig` を使用してシークレット設定の詳細を指定しない場合、DataSync は AWS アカウントの Secrets Manager シークレットを使用してトークンを保存します。
型: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) オブジェクト  
必須: いいえ

 ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Subdirectory"></a>
転送をコンテナ内の仮想ディレクトリ (例: `/my/images`) に制限する場合は、パスセグメントを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 1,024 です。  
パターン: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
必須: いいえ

 ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Tags"></a>
 AWS リソースの分類、フィルタリング、および検索に役立つラベルを指定します。少なくても転送場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationAzureBlob_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationAzureBlob_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-CreateLocationAzureBlob-response-LocationArn"></a>
作成した 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}$` 

## エラー
<a name="API_CreateLocationAzureBlob_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationAzureBlob_SeeAlso"></a>

言語固有の 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) 

# CreateLocationEfs
<a name="API_CreateLocationEfs"></a>

Amazon EFS ファイルシステムの転送*場所*を作成します。 AWS DataSync は、この場所をデータ転送のソースまたは転送先として使用できます。

始める前に、必ず DataSync がどのように [Amazon EFS ファイルシステムにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access)するのかを理解してください。

## リクエストの構文
<a name="API_CreateLocationEfs_RequestSyntax"></a>

```
{
   "AccessPointArn": "string",
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "EfsFilesystemArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationEfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-AccessPointArn"></a>
DataSync が Amazon EFS ファイルシステムにアクセスするために使用するアクセスポイントの Amazon リソースネーム (ARN) を指定します。  
詳細については、「[Accessing restricted file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$`   
必須: いいえ

 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Ec2Config"></a>
DataSync が Amazon EFS ファイルシステムの[マウントターゲット](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)に接続するために使用する、サブネットとセキュリティグループを指定します。  
タイプ: [Ec2Config](API_Ec2Config.md) オブジェクト  
必須: はい

 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-EfsFilesystemArn"></a>
Amazon EFS ファイルシステムの ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$`   
必須: はい

 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-FileSystemAccessRoleArn"></a>
DataSync が Amazon EFS ファイルシステムにアクセスできるようにする AWS Identity and Access Management (IAM) ロールを指定します。  
このロールの作成については、「[Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
必須: いいえ

 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-InTransitEncryption"></a>
DataSync が Amazon EFS ファイルシステムとの間でデータを転送するときに、Transport Layer Security (TLS) 1.2 暗号化を使用するかどうかを指定します。  
`AccessPointArn` または `FileSystemAccessRoleArn` を使用した IAM ロールを使用してアクセスポイントを指定する場合、このパラメータを `TLS1_2` に設定する必要があります。  
タイプ: 文字列  
有効な値：`NONE | TLS1_2`  
必須: いいえ

 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Subdirectory"></a>
Amazon EFS ファイルシステムのマウントパスを指定します。これは、DataSync がファイルシステム上のデータの読み取りまたは書き込み (送信元の場所か送信先の場所かによって異なります) を行う場所です。  
デフォルトで、DataSync はルートディレクトリ (または `AccessPointArn` を使用して指定する[アクセスポイント](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html)) を使用します。フォワードスラッシュ (例: `/path/to/folder`) を使用してサブディレクトリを含めることもできます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

 ** [Tags](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Tags"></a>
リソースに追加するタグを表すキーと値のペアを指定します。値は空の文字列とすることができます。この値は、リソースの管理、フィルタリング、検索に役立ちます。場所の名前タグを作成することをお勧めします。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationEfs_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationEfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) **   <a name="DataSync-CreateLocationEfs-response-LocationArn"></a>
作成する Amazon EFS ファイルシステムの場所の Amazon リソースネーム (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}$` 

## エラー
<a name="API_CreateLocationEfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_CreateLocationEfs_Examples"></a>

### リクエスト例
<a name="API_CreateLocationEfs_Example_1"></a>

次の例では、Amazon EFS ファイルシステムの場所を作成します。

```
{
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2"
        ]
    },
    "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### リクエスト例: 制限付きの Amazon EFS ファイルシステムの場所の作成
<a name="API_CreateLocationEfs_Example_2"></a>

次の例では、アクセスが制限された Amazon EFS ファイルシステムの場所を作成します。このようなシナリオでは、リクエストで `AccessPointArn`、`FileSystemAccessRoleArn`、`InTransitEncryption` の値を指定しなければならない場合があります。

```
{
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### レスポンス例
<a name="API_CreateLocationEfs_Example_3"></a>

レスポンスは、Amazon EFS ファイルシステムの場所の ARN を返します。

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

## 以下の資料も参照してください。
<a name="API_CreateLocationEfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs) 

# CreateLocationFsxLustre
<a name="API_CreateLocationFsxLustre"></a>

Amazon FSx for Lustre ファイルシステムの転送*場所*を作成します。この場所をデータ転送のソースまたは送信先として AWS DataSync 使用できます。

始める前に、必ず DataSync がどのように [FSx for Lustre ファイルシステムにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access)するのかを理解してください。

## リクエストの構文
<a name="API_CreateLocationFsxLustre_RequestSyntax"></a>

```
{
   "FsxFilesystemArn": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationFsxLustre_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-FsxFilesystemArn"></a>
FSx for Lustre ファイルシステムの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
必須: はい

 ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-SecurityGroupArns"></a>
FSx for Lustre ファイルシステムへのアクセスを提供するセキュリティグループ (最大 5 つ) の Amazon リソースネーム (ARN) を指定します。  
セキュリティグループはファイルシステムのポートにアクセスできる必要があります。ファイルシステムはセキュリティグループからのアクセスを許可する必要もあります。ファイルシステムアクセスの詳細については、「[https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html)」を参照してください。  
型: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Subdirectory"></a>
FSx for Lustre ファイルシステムのマウントパスを指定します。パスにはサブディレクトリを含めることができます。  
場所が送信元として使用される場合、DataSync はマウントパスからデータを読み込みます。場所が送信先として使用される場合、DataSync はデータをマウントパスに書き込みます。このパラメータを含めない場合、DataSync はファイルシステムのルートディレクトリ (`/`) を使用します。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

 ** [Tags](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Tags"></a>
 AWS リソースの分類、フィルタリング、および検索に役立つラベルを指定します。少なくても場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationFsxLustre_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationFsxLustre_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxLustre-response-LocationArn"></a>
作成した FSx for Lustre ファイルシステムの場所の Amazon リソースネーム (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}$` 

## エラー
<a name="API_CreateLocationFsxLustre_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationFsxLustre_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) 

# CreateLocationFsxOntap
<a name="API_CreateLocationFsxOntap"></a>

Amazon FSx for NetApp ONTAP ファイルシステムの転送*場所*を作成します。この場所をデータ転送のソースまたは送信先として AWS DataSync 使用できます。

始める前に、必ず DataSync がどのように [FSx for ONTAP ファイルシステムにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)するのかを理解してください。

## リクエストの構文
<a name="API_CreateLocationFsxOntap_RequestSyntax"></a>

```
{
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationFsxOntap_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Protocol"></a>
 AWS DataSync が Amazon FSx ファイルシステムにアクセスするために使用するデータ転送プロトコルを指定します。  
型: [FsxProtocol](API_FsxProtocol.md) オブジェクト  
必須: はい

 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-SecurityGroupArns"></a>
ファイルシステムの優先サブネットへのアクセスを提供する Amazon EC2 セキュリティグループを指定します。  
次のポートでアウトバウンドトラフィックを許可するようにセキュリティグループを設定する必要があります (使用しているプロトコルによって異なります)。  
+  **ネットワークファイルシステム (NFS)**: TCP ポート 111、635、2049
+  **サーバーメッセージブロック (SMB)**: TCP ポート 445
ファイルシステムのセキュリティグループは、同じポートでのインバウンドトラフィックも許可する必要があります。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: はい

 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-StorageVirtualMachineArn"></a>
データのコピーのやり取りをするファイルシステム上のストレージ仮想マシン (SVM) の ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 162 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Subdirectory"></a>
データ転送先またはデータ転送元の SVM 内のファイル共有へのパスを指定します。  
ジャンクションパス (マウントポイントとも呼ばれます)、qtree パス (NFS ファイル共有用)、または共有名 (SMB ファイル共有用) を指定できます。例えば、マウントパスは `/vol1`、`/vol1/tree1`、または `/share1` かもしれません。  
SVM のルートボリューム内にはジャンクションパスを指定しないでください。詳細については、「*Amazon FSx for NetApp ONTAP ユーザーガイド*」の「[Managing FSx for ONTAP storage virtual machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html)」を参照してください。
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
必須: いいえ

 ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Tags"></a>
 AWS リソースの分類、フィルタリング、および検索に役立つラベルを指定します。少なくても場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationFsxOntap_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationFsxOntap_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOntap-response-LocationArn"></a>
作成したFSx for ONTAP ファイルシステムの場所の 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}$` 

## エラー
<a name="API_CreateLocationFsxOntap_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationFsxOntap_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) 

# CreateLocationFsxOpenZfs
<a name="API_CreateLocationFsxOpenZfs"></a>

Amazon FSx for OpenZFS ファイルシステムの転送*場所*を作成します。この場所をデータ転送のソースまたは送信先として AWS DataSync 使用できます。

始める前に、必ず DataSync がどのように [FSx for OpenZFS ファイルシステムにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access)するのかを理解してください。

**注記**  
`SMB` に関連するリクエストパラメータは `CreateLocationFsxOpenZfs` オペレーションではサポートされていません。

## リクエストの構文
<a name="API_CreateLocationFsxOpenZfs_RequestSyntax"></a>

```
{
   "FsxFilesystemArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationFsxOpenZfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-FsxFilesystemArn"></a>
FSx for OpenZFS ファイルシステムの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
必須: はい

 ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Protocol"></a>
 AWS DataSync がファイルシステムにアクセスするために使用するプロトコルのタイプ。  
型: [FsxProtocol](API_FsxProtocol.md) オブジェクト  
必須: はい

 ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-SecurityGroupArns"></a>
FSx for OpenZFS ファイルシステムの設定に使用するセキュリティグループの ARN。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Subdirectory"></a>
`/fsx` で始まる必要がある場所のパス内のサブディレクトリ。DataSync は、このサブディレクトリを使用してデータを読み書きします (ファイルシステムがソースまたは送信先の場所であるかどうかに応じて)。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$`   
必須: いいえ

 ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Tags"></a>
リソースに追加するタグを表すキーと値のペア。値は空の文字列とすることができます。この値は、リソースの管理、フィルタリング、検索に役立ちます。場所の名前タグを作成することをお勧めします。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationFsxOpenZfs_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationFsxOpenZfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-response-LocationArn"></a>
作成した FSx for OpenZFS ファイルシステムの場所の 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}$` 

## エラー
<a name="API_CreateLocationFsxOpenZfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationFsxOpenZfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 

# CreateLocationFsxWindows
<a name="API_CreateLocationFsxWindows"></a>

Amazon FSx for Windows File Server ファイルシステムの転送*場所*を作成します。この場所をデータ転送のソースまたは送信先として AWS DataSync 使用できます。

始める前に、必ず DataSync がどのように [FSx for Windows File Server ファイルシステムにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access)するのかを理解してください。

## リクエストの構文
<a name="API_CreateLocationFsxWindows_RequestSyntax"></a>

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "FsxFilesystemArn": "string",
   "Password": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

## リクエストパラメーター
<a name="API_CreateLocationFsxWindows_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CmkSecretConfig"></a>
DataSync が管理するシークレットの設定情報を指定します。これには、DataSync がカスタマーマネージドで特定の FSx Windows ストレージの場所にアクセスするために使用するパスワードが含まれます AWS KMS key。  
このパラメータを`CreateLocationFsxWindows`リクエストの一部として含める場合は、KMS キー ARN のみを指定します。DataSync は、この KMS キーを に`Password`指定した とともに使用して、ロケーションアクセス認証情報を保存する DataSync マネージドシークレットを作成します。  
DataSync に、指定した KMS キーへのアクセス許可があることを確認します。詳細については、[「カスタムで暗号化されたサービスマネージドシークレットの使用 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`Password` あり) または `CustomSecretConfig` (`Password` なし) を使用して、`CreateLocationFsxWindows` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CustomSecretConfig"></a>
FSx for Windows File Server ストレージの場所のパスワードが Secrets Manager のプレーンテキストで保存される、カスタマー管理の Secrets Manager シークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。詳細については、[「管理するシークレットの使用](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`Password` あり) または `CustomSecretConfig` (`Password` なし) を使用して、`CreateLocationFsxWindows` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Domain"></a>
FSx for Windows ファイルサーバーシステムが属する Windows ドメインの名前を指定します。  
環境内に複数の Active Directory ドメインがある場合、このパラメータを設定することで、DataSync が適切なファイルシステムに接続できるようになります。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
必須: いいえ

 ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-FsxFilesystemArn"></a>
FSx for Windows File Server ファイルシステムの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
必須: はい

 ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Password"></a>
FSx for Windows File Server ファイルシステム内のファイル、フォルダ、ファイルメタデータをマウントしてアクセスできるアクセス許可を持つユーザーのパスワードを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^.{0,104}$`   
必須: いいえ

 ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-SecurityGroupArns"></a>
ファイルシステムの優先サブネットへのアクセスを提供する Amazon EC2 セキュリティグループの ARN を指定します。  
指定したセキュリティグループは、ファイルシステムのセキュリティグループと通信できる必要があります。セキュリティグループの設定については、「[https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html)」を参照してください。  
内部からの接続を許可しないセキュリティグループを選択した場合は、次のいずれかの操作を行います。  
+ セキュリティグループをセキュリティグループ内で通信できるように設定します。
+ マウントターゲットのセキュリティグループと通信できる、別のセキュリティグループを選択します。
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Subdirectory"></a>
スラッシュを使用して、ファイルシステムのマウントパスを指定します。これは、DataSync がデータを読み書きする場所です (送信元あるいは送信先の場所によって異なります)。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

 ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Tags"></a>
 AWS リソースの分類、フィルタリング、および検索に役立つラベルを指定します。少なくても場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-User"></a>
FSx for Windows File Server ファイルシステム内のファイル、フォルダ、ファイルメタデータをマウントしてアクセスできるアクセス許可を持つユーザーを指定します。  
転送に適したアクセスレベルのユーザーを選択する方法については、FSx for Windows File Server の場所に「[required permissions](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
必須: はい

## レスポンスの構文
<a name="API_CreateLocationFsxWindows_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationFsxWindows_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxWindows-response-LocationArn"></a>
作成した FSx for Windows File Server ファイルシステムの場所の 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}$` 

## エラー
<a name="API_CreateLocationFsxWindows_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationFsxWindows_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows) 

# CreateLocationHdfs
<a name="API_CreateLocationHdfs"></a>

Hadoop Distributed File System (HDFS) の転送*場所*を作成します。 AWS DataSync は、この場所をデータ転送のソースまたは送信先として使用できます。

始める前に、必ず DataSync がどのように [HDFS クラスターにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs)するかを理解してください。

## リクエストの構文
<a name="API_CreateLocationHdfs_RequestSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationHdfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
HDFS クラスターに接続できる DataSync エージェントの Amazon リソースネーム (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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
ユーザーの ID を決定するために使用される認証のタイプ。  
タイプ: 文字列  
有効な値：`SIMPLE | KERBEROS`  
必須: はい

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
HDFS クラスターに書き込むデータブロックのサイズ。ブロックサイズは 512 バイトの倍数にする必要があります。デフォルトのブロックサイズは 128 メガバイト (MiB) です。  
タイプ: 整数  
有効範囲: 最小値 は 1,048,576 です。最大値は 1,073,741,824 です。  
必須: いいえ

 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
DataSync が管理するシークレットの設定情報を指定します。これには、DataSync がカスタマーマネージドで特定の Hadoop Distributed File System (HDFS) ストレージの場所にアクセスするために使用する Kerberos キータブが含まれます AWS KMS key。  
このパラメータを`CreateLocationHdfs`リクエストの一部として含める場合は、KMS キー ARN のみを指定します。DataSync は、この KMS キーを に`KerberosKeytab`指定した とともに使用して、ロケーションアクセス認証情報を保存する DataSync マネージドシークレットを作成します。  
DataSync に、指定した KMS キーへのアクセス許可があることを確認します。詳細については、[「カスタムで暗号化されたサービスマネージドシークレットの使用 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`KerberosKeytab` あり) または `CustomSecretConfig` (`KerberosKeytab` なし) を使用して、`CreateLocationHdfs` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
HDFS ストレージの場所の Kerberos キータブが Secrets Manager のバイナリに保存されている、カスタマー管理の Secrets Manager シークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。詳細については、[「管理するシークレットの使用](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`KerberosKeytab` あり) または `CustomSecretConfig` (`KerberosKeytab` なし) を使用して、`CreateLocationHdfs` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
定義された Kerberos プリンシパルと暗号化キー間のマッピングを含む Kerberos キーテーブル (キータブ)。ファイルのアドレスを指定して、ファイルからキータブをロードできます。  
`KERBEROS` を `AuthenticationType` に指定した場合、このパラメータが必要です。
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 65,536 です。  
必須: いいえ

 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
Kerberos 構成情報を含む `krb5.conf` ファイル。ファイルのアドレスを指定して、`krb5.conf` ファイルをロードできます。 AWS CLIを使用している場合は、base64 エンコードが実行されます。それ以外の場合は、base64 でエンコードされたテキストを指定します。  
`KERBEROS` を `AuthenticationType` に指定した場合、このパラメータが必要です。
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 131,072 です。  
必須: いいえ

 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。  
`KERBEROS` を `AuthenticationType` に指定した場合、このパラメータが必要です。
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$`   
必須: いいえ

 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
HDFS クラスターのキー管理サーバー (KMS) の URI。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
必須: いいえ

 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
HDFS 名前空間を管理する NameNode。NameNode は、ファイルやディレクトリのオープン、クローズ、名前の変更などの操作を実行します。NameNode には、データのブロックを DataNode にマップするための情報が含まれています。NameNode は 1 つのみを使用できます。  
タイプ: [HdfsNameNode](API_HdfsNameNode.md) オブジェクトの配列  
配列メンバー: 最小数は 1 項目です。  
必須: はい

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
保護の品質 (QOP) 設定では、Hadoop 分散ファイルシステム (HDFS) クラスターで構成されたリモートプロシージャコール (RPC) とデータ転送保護の設定を指定します。`QopConfiguration` が指定されなかった場合、`RpcProtection` および `DataTransferProtection` は `PRIVACY` をデフォルトにします。`RpcProtection` または `DataTransferProtection` を設定した場合、もう一方のパラメータは同じ値を想定します。  
タイプ: [QopConfiguration](API_QopConfiguration.md) オブジェクト  
必須: いいえ

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
HDFS クラスターへの書き込み時にデータをレプリケートする DataNode の数。デフォルトでは、データは 3 つの DataNode にレプリケートされます。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 512 です。  
必須: いいえ

 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
ホストオペレーティングシステム上のクライアントを識別するために使用されるユーザー名。  
`SIMPLE` を `AuthenticationType` に指定した場合、このパラメータが必要です。
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
必須: いいえ

 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
HDFS クラスター内のサブディレクトリ。このサブディレクトリは、HDFS クラスターからデータを読み取り、または HDFS クラスターにデータを書き込むために使用されます。サブディレクトリが指定されていない場合、デフォルトの `/` になります。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
場所に追加するタグを表すキーと値のペア。値は空の文字列とすることができます。タグを使用してリソースに名前を付けることをお勧めします。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationHdfs_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationHdfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
作成されたソース HDFS クラスターの場所の 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}$` 

## エラー
<a name="API_CreateLocationHdfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationHdfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) 

# CreateLocationNfs
<a name="API_CreateLocationNfs"></a>

Network File System (NFS) ファイルサーバーの転送*場所*を作成します。この場所をデータ転送のソースまたは送信先として AWS DataSync 使用できます。

始める前に、必ず DataSync がどのように [NFS ファイルサーバーにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)するかを理解してください。

## リクエストの構文
<a name="API_CreateLocationNfs_RequestSyntax"></a>

```
{
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationNfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-MountOptions"></a>
DataSync が NFS ファイルサーバーをマウントするのに使用できるオプションを指定します。  
タイプ: [NfsMountOptions](API_NfsMountOptions.md) オブジェクト  
必須: いいえ

 ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-OnPremConfig"></a>
NFS ファイルサーバーに接続する DataSync エージェントの Amazon リソースネーム (ARN) を指定します。  
複数のエージェントを指定できます。詳細については、「[Using multiple DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents)」を参照してください。  
タイプ: [OnPremConfig](API_OnPremConfig.md) オブジェクト  
必須: はい

 ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-ServerHostname"></a>
DataSync エージェントが接続する NFS ファイルサーバーの DNS 名または IP アドレス (IPv4 または IPv6) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Subdirectory"></a>
DataSync がマウントする NFS ファイルサーバーのエクスポートパスを指定します。  
このパス (またはパスのサブディレクトリ) は、DataSync のデータ転送先または転送元となる場所です。DataSync のエクスポートの構成については、「[NFS ファイルサーバーへのアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
必須: はい

 ** [Tags](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Tags"></a>
 AWS リソースの分類、フィルタリング、検索に役立つラベルを指定します。少なくとも場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationNfs_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationNfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) **   <a name="DataSync-CreateLocationNfs-response-LocationArn"></a>
NFS ファイルサーバー用に作成した転送場所の 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}$` 

## エラー
<a name="API_CreateLocationNfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_CreateLocationNfs_Examples"></a>

### 例
<a name="API_CreateLocationNfs_Example_1"></a>

次の例では、NFS ファイルサーバー用の DataSync 転送場所を作成します。

#### リクエスト例
<a name="API_CreateLocationNfs_Example_1_Request"></a>

```
{
  "MountOptions": {
     "Version": : "NFS4_0"
     },
  "OnPremConfig": {
    "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
          },
          
           "ServerHostname": "MyServer@amazon.com",
           "Subdirectory": "/MyFolder",
           "Tags": [
              {
                "Key": "Name",
                "Value": "FileSystem-1"
              }
           ]
}
```

### 例
<a name="API_CreateLocationNfs_Example_2"></a>

レスポンスは NFS の場所の ARN を返します。

#### レスポンス例
<a name="API_CreateLocationNfs_Example_2_Response"></a>

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
```

## 以下の資料も参照してください。
<a name="API_CreateLocationNfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs) 

# CreateLocationObjectStorage
<a name="API_CreateLocationObjectStorage"></a>

オブジェクトストレージシステムの転送*場所*を作成します。 AWS DataSync は、この場所をデータ転送のソースまたは送信先として使用できます。[DataSync エージェント](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required)の有無にかかわらず転送を行うことができます。

始める前に、DataSync がオブジェクトストレージシステムで動作するための[前提条件](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites)を理解していることを確認してください。

## リクエストの構文
<a name="API_CreateLocationObjectStorage_RequestSyntax"></a>

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "BucketName": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationObjectStorage_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AccessKey"></a>
オブジェクトストレージサーバーとの認証に認証情報が必要な場合、アクセスキー (ユーザー名など) を指定します。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 200 です。  
パターン: `^.*$`   
必須: いいえ

 ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AgentArns"></a>
(オプション) オブジェクトストレージシステムに接続できる DataSync エージェントの Amazon リソースネーム (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}$`   
必須: いいえ

 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-BucketName"></a>
転送に関係するオブジェクトストレージバケットの名前を指定します。  
タイプ: 文字列  
長さの制約: 最小長は 3 です。最大長は 63 です。  
パターン: `^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$`   
必須: はい

 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CmkSecretConfig"></a>
DataSync が管理するシークレットの設定情報を指定します。これには、DataSync が特定のオブジェクトストレージの場所にアクセスするために使用する `SecretKey` と、カスタマー管理の AWS KMS keyが含まれます。  
このパラメータを`CreateLocationObjectStorage`リクエストの一部として含める場合は、KMS キー ARN のみを指定します。DataSync は、`SecretKey` パラメータに指定された値とともにこの KMS キーを使用して、DataSync が管理するシークレットを作成し、場所にアクセスするための認証情報を保存します。  
DataSync に、指定した KMS キーへのアクセス許可があることを確認します。詳細については、[「カスタムで暗号化されたサービスマネージドシークレットの使用 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`SecretKey` あり) または `CustomSecretConfig` (`SecretKey` なし) を使用して、`CreateLocationObjectStorage` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CustomSecretConfig"></a>
特定のオブジェクトストレージの場所のシークレットキーが Secrets Manager のプレーンテキストで保存される、カスタマー管理の Secrets Manager シークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。詳細については、[「管理するシークレットの使用](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`SecretKey` あり) または `CustomSecretConfig` (`SecretKey` なし) を使用して、`CreateLocationObjectStorage` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-SecretKey"></a>
オブジェクトストレージサーバーとの認証に認証情報が必要な場合、秘密鍵 (パスワードなど) を指定します。  
を使用してシークレットを指定し`SecretKey`、 `CmkSecretConfig`または を使用してシークレット設定の詳細を指定しない場合`CustomSecretConfig`、DataSync は AWS アカウントの Secrets Manager シークレットを使用してトークンを保存します。
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 200 です。  
パターン: `^.*$`   
必須: いいえ

 ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerCertificate"></a>
オブジェクトストレージシステムがプライベートまたは自己署名の認証機関 (CA) を使用する場合、DataSync がそのシステムで認証するための証明書チェーンを指定します。完全な証明書チェーンを持つ `.pem` ファイルを 1 つ指定する必要があります (例: `file:///home/user/.ssh/object_storage_certificates.pem`)。  
証明書チェーンには以下が含まれます。  
+ オブジェクトストレージシステムの証明書
+ すべての中間証明書 (存在する場合)
+ 署名 CA のルート証明書
証明書を `.pem` ファイルに連結できます (base64 エンコーディングの前は最大 32,768 バイトまで可能)。次の `cat` コマンド例では、3 つの証明書を含む `object_storage_certificates.pem` ファイルを作成します。  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
このパラメータを使用するには、`ServerProtocol` を `HTTPS` に構成します。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 32,768 です。  
必須: いいえ

 ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerHostname"></a>
DataSync エージェントが接続するオブジェクトストレージサーバーのドメイン名または IP アドレス (IPv4 または IPv6) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: はい

 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerPort"></a>
オブジェクトストレージサーバーがインバウンドネットワークトラフィックを受け入れるポート (ポート 443 など) を指定します。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 65,536 です。  
必須: いいえ

 ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerProtocol"></a>
オブジェクトストレージサーバーが通信に使用するプロトコルを指定します。指定されなかった場合、デフォルト値は `HTTPS` です。  
型: 文字列  
有効な値：`HTTPS | HTTP`  
必須: いいえ

 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Subdirectory"></a>
オブジェクトストレージサーバーのオブジェクトプレフィックスを指定します。これがソースの場所である場合、DataSync はこのプレフィックスを持つオブジェクトのみをコピーします。これが送信先の場所である場合、DataSync は、このプレフィックスを持つすべてのオブジェクトを書き込みます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Tags"></a>
リソースに追加するタグを表すキーと値のペアを指定します。タグは、リソースの管理、フィルタリング、検索に役立ちます。場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationObjectStorage_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationObjectStorage_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-CreateLocationObjectStorage-response-LocationArn"></a>
作成するオブジェクトストレージシステムの場所の 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}$` 

## エラー
<a name="API_CreateLocationObjectStorage_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationObjectStorage_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) 

# CreateLocationS3
<a name="API_CreateLocationS3"></a>

Amazon S3 バケットの転送*場所*を作成します。 AWS DataSync は、この場所をデータ転送のソースまたは転送先として使用できます。

**重要**  
始める前に、次のトピックをお読みください。  
 [Amazon S3 場所のストレージクラスに関する考慮事項](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [DataSync を使用する場合の S3 リクエストコストの評価](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

 詳細については、「[Configuring transfers with Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html)」を参照してください。

## リクエストの構文
<a name="API_CreateLocationS3_RequestSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "S3BucketArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationS3_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArns](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-AgentArns"></a>
(Amazon S3 on Outposts のみ) Outpost 上の DataSync エージェントの Amazon リソースネーム (ARN) を指定します。  
詳細については、[DataSync エージェントをデプロイする AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent)」を参照してください。  
型: 文字列の配列  
配列メンバー: 最小数は 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}$`   
必須: いいえ

 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3BucketArn"></a>
場所として使用する S3 バケットの ARN を指定します。(後で DataSync タスクを作成するときは、この場所がソースの場所か転送先かを指定します)。  
S3 バケットが AWS Outposts リソースにある場合は、Amazon S3 アクセスポイントを指定する必要があります。詳細については、「*Amazon S3 ユーザーガイド*」の「[Amazon S3 Access Points を使用したデータアクセスの管理](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 268 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
必須: はい

 ** [S3Config](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3Config"></a>
DataSync が S3 バケットにアクセスするために使用する AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN) を指定します。  
詳細については、「[Providing DataSync access to S3 buckets](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)」を参照してください。  
型: [S3Config](API_S3Config.md) オブジェクト  
必須: はい

 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3StorageClass"></a>
Amazon S3 が転送先である場合にオブジェクトで使用するストレージクラスを指定します。  
のバケットの場合 AWS リージョン、ストレージクラスはデフォルトで になります`STANDARD`。上のバケットの場合 AWS Outposts、ストレージクラスはデフォルトで になります`OUTPOSTS`。  
詳細については、「[Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。  
タイプ: 文字列  
有効な値：`STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`  
必須: いいえ

 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Subdirectory"></a>
DataSync が読み書きする S3 バケットのプレフィックスを指定します (バケットがソースまたは送信先の場所であるかどうかに応じて)。  
DataSync は、スラッシュ (`/`) で始まるプレフィックス、または `//`、`/./`、または `/../` パターンを含むプレフィックスを持つオブジェクトを転送できません。例えば、次のようになります。  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

 ** [Tags](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Tags"></a>
 AWS リソースの分類、フィルタリング、検索に役立つラベルを指定します。少なくても転送場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationS3_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationS3_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) **   <a name="DataSync-CreateLocationS3-response-LocationArn"></a>
作成した S3 の場所の 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}$` 

## エラー
<a name="API_CreateLocationS3_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateLocationS3_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) 

# CreateLocationSmb
<a name="API_CreateLocationSmb"></a>

サーバーメッセージブロック (SMB) ファイルサーバーの転送*場所*を作成します。 AWS DataSync は、この場所をデータ転送のソースまたは送信先として使用できます。

始める前に、必ず DataSync がどのように SMB ファイルサーバーにアクセスするかを理解してください。詳細については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。

## リクエストの構文
<a name="API_CreateLocationSmb_RequestSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "Password": "string",
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

## リクエストパラメーター
<a name="API_CreateLocationSmb_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AgentArns"></a>
SMB ファイルサーバーに接続可能な DataSync エージェント (1 つまたは複数) を指定します。エージェントは、Amazon リソースネーム (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](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AuthenticationType"></a>
DataSync が SMB ファイルサーバーへの接続に使用する認証プロトコルを指定します。DataSync は `NTLM` (デフォルト) と `KERBEROS` 認証をサポートしています。  
詳細については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。  
型: 文字列  
有効な値：`NTLM | KERBEROS`  
必須：いいえ

 ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CmkSecretConfig"></a>
DataSync が管理するシークレットの設定情報を指定します`KerberosKeytab`。DataSync がカスタマー管理の特定の SMB ストレージの場所にアクセスするために使用する `Password`または `NTLM` (デフォルト) および`KERBEROS`認証タイプのいずれかです AWS KMS key。  
このパラメータを`CreateLocationSmbRequest`リクエストの一部として含める場合は、KMS キー ARN のみを指定します。DataSync は、この KMS キーを `Password`または `KerberosKeytab` のいずれかとともに使用して、ロケーションアクセス認証情報を保存する DataSync マネージドシークレットを作成します。  
DataSync に、指定した KMS キーへのアクセス許可があることを確認します。詳細については、[「カスタムで暗号化されたサービスマネージドシークレットの使用 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key)」を参照してください。  
( `Password`または のいずれか`CmkSecretConfig`を使用`KerberosKeytab`) または `CustomSecretConfig` ( `Password`および なし`KerberosKeytab`) を使用して、`CreateLocationSmbRequest`リクエストの認証情報を指定できます。同じリクエストに パラメータ`CmkSecretConfig`と `CustomSecretConfig`パラメータの両方を指定しないでください。
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CustomSecretConfig"></a>
SMB ストレージの場所の認証情報が Secrets Manager にプレーンテキスト ( の場合`Password`) またはバイナリ ( の場合) として保存される、カスタマー管理の Secrets Manager シークレットの設定情報を指定します`KerberosKeytab`。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。詳細については、[「管理するシークレットの使用](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`SasConfiguration` あり) または `CustomSecretConfig` (`SasConfiguration` なし) を使用して、`CreateLocationSmbRequest` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-DnsIpAddresses"></a>
SMB ファイルサーバーが属する DNS サーバーの IPv4 または IPv6 アドレスを指定します。このパラメータは、`AuthenticationType` が `KERBEROS` に設定されている場合にのみ適用されます。  
環境内に複数のドメインがある場合、このパラメータを構成することで、DataSync が適切な SMB ファイルサーバーに接続できるようになります。  
型: 文字列の配列  
配列メンバー: 最大数は 2 項目です。  
長さの制限: 最小長は 7 です。最大長は 39 です。  
パターン: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z`   
必須: いいえ

 ** [Domain](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Domain"></a>
SMB ファイルサーバーが属する Windows ドメイン名を指定します。このパラメータは、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
環境内に複数のドメインがある場合、このパラメータを構成することで、DataSync が適切なファイルサーバーに接続できるようになります。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
必須: いいえ

 ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKeytab"></a>
Kerberos キーテーブル (keytab) ファイルを指定します。これには、Kerberos プリンシパルと暗号化キー間のマッピングが含まれます。  
タスク実行エラーを回避するには、キータブファイルの作成に使用する Kerberos プリンシパルが、`KerberosPrincipal` に指定した内容と正確に一致していることを確認します。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 65,536 です。  
必須: いいえ

 ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKrb5Conf"></a>
Kerberos 領域設定を定義する Kerberos 設定ファイル (`krb5.conf`) を指定します。  
ファイルは base64 でエンコードされている必要があります。を使用している場合は AWS CLI、エンコードが自動的に行われます。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 131,072 です。  
必須: いいえ

 ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosPrincipal"></a>
Kerberos プリンシパルを指定します。これは、SMB ファイルサーバーのファイル、フォルダ、ファイルメタデータにアクセスする権限を持つ Kerberos 領域内の ID です。  
Kerberos プリンシパルは `HOST/kerberosuser@MYDOMAIN.ORG` のようになります。  
プリンシパル名では大文字と小文字が区別されます。このパラメータに指定したプリンシパルが、キータブファイルの作成に使用するプリンシパルと完全に一致しない場合、DataSync タスク実行は失敗します。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$`   
必須: いいえ

 ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-MountOptions"></a>
DataSync が SMB ファイルサーバーにアクセスするために使用する SMB プロトコルのバージョンを指定します。  
タイプ: [SmbMountOptions](API_SmbMountOptions.md) オブジェクト  
必須: いいえ

 ** [Password](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Password"></a>
SMB ファイルサーバーをマウントでき、転送するファイルとフォルダにアクセスできるユーザーのパスワード。このパラメータは、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^.{0,104}$`   
必須: いいえ

 ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-ServerHostname"></a>
DataSync エージェントが接続する SMB ファイルサーバーのドメイン名または IP アドレス (IPv4 または IPv6) を指定します。  
Kerberos 認証を使用している場合は、ドメイン名を指定する必要があります。
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Subdirectory"></a>
DataSync がデータを読み書記する SMB ファイルサーバーによってエクスポートされる共有の名前を指定します。共有パスにはサブディレクトリ (例: `/path/to/subdirectory`) を含めることができます。ネットワーク内の他の SMB クライアントもこのパスをマウントできることを確認してください。  
サブディレクトリ内のすべてのデータをコピーするには、DataSync が SMB 共有をマウントし、そのすべてのデータにアクセスできる必要があります。詳細については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: はい

 ** [Tags](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Tags"></a>
 AWS リソースの分類、フィルタリング、および検索に役立つラベルを指定します。少なくても場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

 ** [User](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-User"></a>
SMB ファイルサーバー内のファイル、フォルダ、ファイルメタデータをマウントしてアクセスできるユーザーを指定します。このパラメータは、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
転送に適したアクセスレベルを持つユーザーを選択する方法については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationSmb_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationSmb_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationSmb_ResponseSyntax) **   <a name="DataSync-CreateLocationSmb-response-LocationArn"></a>
作成した SMB の場所の 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}$` 

## エラー
<a name="API_CreateLocationSmb_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_CreateLocationSmb_Examples"></a>

### リクエスト例
<a name="API_CreateLocationSmb_Example_1"></a>

次の例では、SMB ファイルサーバーの場所を作成します。

```
{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3"
   ],
   "Domain":"AMAZON",
   "MountOptions":{
      "Version":"SMB3"
   },
   "Password":"string",
   "ServerHostname":"MyServer.amazon.com",
   "Subdirectory":"share",
   "Tags":[
      {
         "Key":"department",
         "Value":"finance"
      }
   ],
   "User":"user-1"
}
```

### レスポンス例
<a name="API_CreateLocationSmb_Example_2"></a>

レスポンスが、SMB ファイルサーバーの場所 ARN を返します。

```
{
    "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

## 以下の資料も参照してください。
<a name="API_CreateLocationSmb_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb) 

# CreateTask
<a name="API_CreateTask"></a>

 AWS DataSync がデータを転送する場所と方法を定義する*タスク*を設定します。

タスクには、ソースの場所、転送先の場所、およびデータを転送する方法 (帯域幅制限、スケジュールなど) が含まれます。

**重要**  
Amazon S3 ロケーションとの間でデータを転送する予定がある場合は、開始する前に [DataSync が S3 リクエスト料金にどのような影響を与えるか](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests)について、および [DataSync 料金ページ](https://aws.amazon.com/datasync/pricing/)を確認してください。

## リクエストの構文
<a name="API_CreateTask_RequestSyntax"></a>

```
{
   "CloudWatchLogGroupArn": "string",
   "DestinationLocationArn": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "SourceLocationArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## リクエストパラメーター
<a name="API_CreateTask_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-CloudWatchLogGroupArn"></a>
タスクをモニタリングするための Amazon CloudWatch ロググループの Amazon リソースネーム (ARN) を指定します。  
拡張モードタスクの場合、何も指定する必要はありません。DataSync は、`/aws/datasync` という名前の CloudWatch ロググループにログを自動的に送信します。  
詳細については、「[Monitoring data transfers with Amazon CloudWatch Logs](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 562 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
必須: いいえ

 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-DestinationLocationArn"></a>
転送時の場所の 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}$`   
必須: はい

 ** [Excludes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Excludes"></a>
DataSync に転送してほしくないソースの場所内のファイル、オブジェクト、フォルダを定義する除外フィルターを指定します。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。  
必須: いいえ

 ** [Includes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Includes"></a>
包含フィルターを指定して、DataSync が転送するソースの場所内のファイル、オブジェクト、フォルダを定義します。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。  
必須: いいえ

 ** [ManifestConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-ManifestConfig"></a>
DataSync が転送するファイルまたはオブジェクトのリストであるマニフェストを設定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。  
このパラメータを使用する場合、発信者 ID (DataSync を使用しているロール) には `iam:PassRole` アクセス許可が必要です。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) ポリシーには、このアクセス許可が含まれています。  
タイプ: [ManifestConfig](API_ManifestConfig.md) オブジェクト  
必須: いいえ

 ** [Name](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Name"></a>
タスクの名前を指定します。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

 ** [Options](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Options"></a>
ファイルメタデータの保存、データ整合性の検証など、タスクの設定を指定します。  
タイプ: [Options](API_Options.md) オブジェクト  
必須: いいえ

 ** [Schedule](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Schedule"></a>
タスクを実行するスケジュールを指定します。詳細については、「[タスクのスケジュール](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)」を参照してください。  
タイプ: [TaskSchedule](API_TaskSchedule.md) オブジェクト  
必須: いいえ

 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-SourceLocationArn"></a>
転送時のソースの場所の 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}$`   
必須: はい

 ** [Tags](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Tags"></a>
タスクに適用するタグを指定します。  
 *タグ*は、DataSync リソースの管理、フィルタリング、検索に役立つキーバリューペアです。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

 ** [TaskMode](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskMode"></a>
データ転送用に次のいずれかのタスクモードを指定します。  
+  `ENHANCED` - 基本モードよりも高いパフォーマンスでオブジェクトを事実上無制限に転送します。拡張モードタスクは、データの一覧表示、準備、転送、検証を並行して行うことで、データ転送プロセスを最適化します。拡張モードは現在、Amazon S3 ロケーション間の転送、エージェントなしでの Azure Blob と Amazon S3 間の転送、エージェントなしでの他のクラウドと Amazon S3 間の転送に使用できます。
**注記**  
拡張モードタスクを作成するには、`CreateTask` オペレーションの呼び出しに使用する IAM ロールに `iam:CreateServiceLinkedRole` アクセス許可が必要です。
+  `BASIC` (デフォルト) - AWS ストレージと他のサポートされているすべての DataSync ロケーション間でファイルまたはオブジェクトを転送します。基本モードタスクは、データセット内のファイル、オブジェクト、ディレクトリの数に対する[クォータ](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html)の対象となります。基本モードはデータの準備、転送、検証を順に実行するため、ほとんどのワークロードで拡張モードよりも速度は遅くなります。
詳細については、[「Understanding task mode differences](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)」を参照してください。  
型: 文字列  
有効な値：`BASIC | ENHANCED`  
必須：いいえ

 ** [TaskReportConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskReportConfig"></a>
DataSync 転送に関する詳細情報を提供するタスクレポートの設定方法を指定します。詳細については、「[Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
このパラメータを使用する場合、発信者 ID (DataSync を使用しているロール) には `iam:PassRole` アクセス許可が必要です。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) ポリシーには、このアクセス許可が含まれています。  
タイプ: [TaskReportConfig](API_TaskReportConfig.md) オブジェクト  
必須: いいえ

## レスポンスの構文
<a name="API_CreateTask_ResponseSyntax"></a>

```
{
   "TaskArn": "string"
}
```

## レスポンス要素
<a name="API_CreateTask_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [TaskArn](#API_CreateTask_ResponseSyntax) **   <a name="DataSync-CreateTask-response-TaskArn"></a>
タスクの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 

## エラー
<a name="API_CreateTask_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_CreateTask_Examples"></a>

### 拡張モードタスクのリクエスト例
<a name="API_CreateTask_Example_1"></a>

次の例では、拡張モードを使用する DataSync タスクを作成します。

基本モードタスクを作成する場合とは異なり、Amazon CloudWatch ロググループを指定する必要はありません。拡張モードタスクでは、DataSync はタスクログを `/aws/datasync` という名前のロググループに自動的に送信します。そのロググループが に存在しない場合 AWS リージョン、DataSync はタスクの作成時にユーザーに代わってロググループを作成します。

```
{
  "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3",
  "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2",
  "Name": "My Enhanced mode task",
  "TaskMode": "ENHANCED",
  "Options": {
    "TransferMode": "CHANGED",
    "VerifyMode": "ONLY_FILES_TRANSFERRED",
    "ObjectTags": "PRESERVE",
    "LogLevel": "TRANSFER"
  }
}
```

### 基本モードタスクのリクエスト例
<a name="API_CreateTask_Example_2"></a>

次の例では、基本モードを使用する DataSync タスクを作成します。

```
{
    "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3",
    "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2",
    "Name": "My Basic mode task",
    "TaskMode": "BASIC",
    "Options": {
        "Atime": "BEST_EFFORT",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "ONLY_FILES_TRANSFERRED"
    },
    "Schedule": {
        "ScheduleExpression": "0 12 ? * SUN,WED *"
    },
    "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*",
    "Tags": [
        {
            "Key": "Name",
            "Value": "Migration-wave-1"
        }
    ]
}
```

### レスポンス例
<a name="API_CreateTask_Example_3"></a>

次のレスポンスには、作成されたタスクの ARN が含まれます。

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

## 以下の資料も参照してください。
<a name="API_CreateTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask) 

# DeleteAgent
<a name="API_DeleteAgent"></a>

から AWS DataSync エージェントリソースを削除します AWS アカウント。

この操作 (元に戻すことはできませんでは、エージェントの仮想マシン (VM) や Amazon EC2 インスタンスはストレージ環境から削除されないことに注意してください。次のステップでは、VM またはインスタンスをストレージ環境から削除するか、再利用して[新しいエージェントを有効化できます](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)。

## リクエストの構文
<a name="API_DeleteAgent_RequestSyntax"></a>

```
{
   "AgentArn": "string"
}
```

## リクエストパラメーター
<a name="API_DeleteAgent_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArn](#API_DeleteAgent_RequestSyntax) **   <a name="DataSync-DeleteAgent-request-AgentArn"></a>
削除するエージェントの Amazon リソースネーム (ARN)。`ListAgents` オペレーションを使用して、アカウントのエージェントと のリストを返します AWS リージョン。  
タイプ: 文字列  
長さの制約: 最大長は 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}$`   
必須: はい

## レスポンス要素
<a name="API_DeleteAgent_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_DeleteAgent_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DeleteAgent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) 

# DeleteLocation
<a name="API_DeleteLocation"></a>

転送場所リソースを削除します AWS DataSync。

## リクエストの構文
<a name="API_DeleteLocation_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DeleteLocation_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DeleteLocation_RequestSyntax) **   <a name="DataSync-DeleteLocation-request-LocationArn"></a>
削除する場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンス要素
<a name="API_DeleteLocation_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_DeleteLocation_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DeleteLocation_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) 

# DeleteTask
<a name="API_DeleteTask"></a>

転送タスクリソースを削除します AWS DataSync。

## リクエストの構文
<a name="API_DeleteTask_RequestSyntax"></a>

```
{
   "TaskArn": "string"
}
```

## リクエストパラメーター
<a name="API_DeleteTask_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [TaskArn](#API_DeleteTask_RequestSyntax) **   <a name="DataSync-DeleteTask-request-TaskArn"></a>
削除するタスクの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
必須: はい

## レスポンス要素
<a name="API_DeleteTask_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_DeleteTask_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DeleteTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) 

# DescribeAgent
<a name="API_DescribeAgent"></a>

エージェントの名前、サービスエンドポイントタイプ、ステータスなど、 AWS DataSync エージェントに関する情報を返します。

## リクエストの構文
<a name="API_DescribeAgent_RequestSyntax"></a>

```
{
   "AgentArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeAgent_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArn](#API_DescribeAgent_RequestSyntax) **   <a name="DataSync-DescribeAgent-request-AgentArn"></a>
情報を取得する DataSync エージェントの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeAgent_ResponseSyntax"></a>

```
{
   "AgentArn": "string",
   "CreationTime": number,
   "EndpointType": "string",
   "LastConnectionTime": number,
   "Name": "string",
   "Platform": { 
      "Version": "string"
   },
   "PrivateLinkConfig": { 
      "PrivateLinkEndpoint": "string",
      "SecurityGroupArns": [ "string" ],
      "SubnetArns": [ "string" ],
      "VpcEndpointId": "string"
   },
   "Status": "string"
}
```

## レスポンス要素
<a name="API_DescribeAgent_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AgentArn](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-AgentArn"></a>
エージェントの ARN。  
タイプ: 文字列  
長さの制約: 最大長は 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}$` 

 ** [CreationTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-CreationTime"></a>
エージェントが[アクティブ化](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)された時刻。  
タイプ: タイムスタンプ

 ** [EndpointType](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-EndpointType"></a>
エージェントが接続されている[サービスエンドポイント](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html)のタイプ。  
タイプ: 文字列  
有効な値：`PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK`

 ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-LastConnectionTime"></a>
エージェントが最後に DataSync サービスと通信した時刻。  
タイプ: タイムスタンプ

 ** [Name](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Name"></a>
エージェントの名前。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Platform](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Platform"></a>
バージョン番号など、エージェントに関するプラットフォーム関連の詳細。  
タイプ: [Platform](API_Platform.md) オブジェクト

 ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-PrivateLinkConfig"></a>
[VPC サービスエンドポイント](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc)に接続するときにエージェントが使用するネットワーク設定。  
タイプ: [PrivateLinkConfig](API_PrivateLinkConfig.md) オブジェクト

 ** [Status](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Status"></a>
エージェントのステータス。  
+ ステータスが `ONLINE` の場合、エージェントは適切に構成されており、使用可能です。
+ ステータスが `OFFLINE` の場合、エージェントは DataSync と 5 分以上通信していません。これは、いくつかの理由で発生する可能性があります。詳細については、「[エージェントがオフラインの場合の対処方法](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline)」を参照してください。
タイプ: 文字列  
有効な値：`ONLINE | OFFLINE`

## エラー
<a name="API_DescribeAgent_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeAgent_Examples"></a>

### リクエスト例
<a name="API_DescribeAgent_Example_1"></a>

次の例では、リクエストで指定されたエージェントに関する情報を返します。

```
{
  "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0"
}
```

### レスポンス例
<a name="API_DescribeAgent_Example_2"></a>

次のレスポンス例は、パブリックサービスエンドポイントを使用するエージェントについて説明しています。

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0",
    "Name": "Data center migration agent",
    "Status": "ONLINE",
    "LastConnectionTime": "2022-10-17T17:21:35.540000+00:00",
    "CreationTime": "2022-10-05T20:52:29.499000+00:00",
    "EndpointType": "PUBLIC",
    "Platform": {
        "Version": "2"
    }
}
```

## 以下の資料も参照してください。
<a name="API_DescribeAgent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeAgent) 

# DescribeLocationAzureBlob
<a name="API_DescribeLocationAzureBlob"></a>

Microsoft Azure Blob Storage の AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationAzureBlob_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationAzureBlob_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationAzureBlob_RequestSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-request-LocationArn"></a>
Azure Blob Storage の転送場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationAzureBlob_ResponseSyntax"></a>

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   }
}
```

## レスポンス要素
<a name="API_DescribeLocationAzureBlob_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AccessTier"></a>
オブジェクトまたはファイルの転送先となるアクセス層。これは、その場所を転送先として使用する場合にのみ適用されます。詳細については、「[アクセス層](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)」を参照してください。  
タイプ: 文字列  
有効な値：`HOT | COOL | ARCHIVE`

 ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AgentArns"></a>
Azure Blob Storage コンテナに接続できる DataSync エージェントの 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](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AuthenticationType"></a>
DataSync が Azure Blob Storage にアクセスするために使用する認証方法です。DataSync は、共有アクセス署名 (SAS) を使用して blob storage にアクセスできます。  
タイプ: 文字列  
有効な値：`SAS | NONE`

 ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-BlobType"></a>
オブジェクトやファイルを Azure Blob Storage に転送するときに使用したいブロブのタイプ。現在、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_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CmkSecretConfig"></a>
DataSync が特定のストレージの場所にアクセスするために使用する認証トークンなど、DataSync が管理するシークレットと、カスタマー管理の AWS KMS keyの設定情報について説明します。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト

 ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CreationTime"></a>
Azure Blob storage 転送場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CustomSecretConfig"></a>
DataSync が特定のストレージロケーションにアクセスするために使用する認証トークンなど、カスタマーマネージドシークレットの設定情報と、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールについて説明します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト

 ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationArn"></a>
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}$` 

 ** [LocationUri](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationUri"></a>
転送に関係する Azure Blob storage コンテナーの URL。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-ManagedSecretConfig"></a>
DataSync が特定のストレージの場所にアクセスするために使用する認証トークンなど、DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。  
型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト

## エラー
<a name="API_DescribeLocationAzureBlob_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationAzureBlob_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) 

# DescribeLocationEfs
<a name="API_DescribeLocationEfs"></a>

Amazon EFS ファイルシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationEfs_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationEfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) **   <a name="DataSync-DescribeLocationEfs-request-LocationArn"></a>
情報を取得する Amazon EFS ファイルシステムの場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationEfs_ResponseSyntax"></a>

```
{
   "AccessPointArn": "string",
   "CreationTime": number,
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "LocationUri": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationEfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-AccessPointArn"></a>
DataSync が Amazon EFS ファイルシステムにアクセスするために使用するアクセスポイントの ARN。  
詳細については、「[Accessing restricted file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` 

 ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-CreationTime"></a>
場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-Ec2Config"></a>
 AWS DataSync が Amazon EFS ファイルシステムの[マウントターゲット](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)の 1 つに接続するために使用するサブネットとセキュリティグループ。  
型: [Ec2Config](API_Ec2Config.md) オブジェクト

 ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-FileSystemAccessRoleArn"></a>
DataSync が Amazon EFS ファイルシステムにアクセスできるようにする AWS Identity and Access Management (IAM) ロール。  
詳細については、「[Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 

 ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-InTransitEncryption"></a>
DataSync が Amazon EFS ファイルシステムとの間でデータを転送するときに、Transport Layer Security (TLS) 暗号化を使用するかどうかを示します。  
タイプ: 文字列  
有効な値：`NONE | TLS1_2`

 ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationArn"></a>
Amazon EFS ファイルシステムの場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationUri"></a>
Amazon EFS ファイルシステムの場所の URL。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

## エラー
<a name="API_DescribeLocationEfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeLocationEfs_Examples"></a>

### リクエスト例
<a name="API_DescribeLocationEfs_Example_1"></a>

次の例は、特定の Amazon EFS ファイルシステムの場所に関する情報を取得する方法を示しています。

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

### レスポンス例
<a name="API_DescribeLocationEfs_Example_2"></a>

次の例は、Amazon EFS ファイルシステムに関する場所の詳細を返します。

```
{
    "CreationTime": 1653319021.353,
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/"
}
```

### レスポンス例: 制限付きの Amazon EFS ファイルシステムの場所の説明
<a name="API_DescribeLocationEfs_Example_3"></a>

次の例では、アクセスが制限されている Amazon EFS ファイルシステムの場所の詳細 (`AccessPointArn`、`FileSystemAccessRoleArn`、`InTransitEncryption` 要素など) を返します。

```
{
    "CreationTime": 1653319021.353,
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

## 以下の資料も参照してください。
<a name="API_DescribeLocationEfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs) 

# DescribeLocationFsxLustre
<a name="API_DescribeLocationFsxLustre"></a>

Amazon FSx for Lustre ファイルシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationFsxLustre_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationFsxLustre_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationFsxLustre_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-request-LocationArn"></a>
説明する FSx for Lustre の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationFsxLustre_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "SecurityGroupArns": [ "string" ]
}
```

## レスポンス要素
<a name="API_DescribeLocationFsxLustre_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-CreationTime"></a>
FSx for Lustre の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationArn"></a>
説明された FSx for Lustre の場所の Amazon リソースネーム (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}$` 

 ** [LocationUri](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationUri"></a>
説明された FSx for Lustre の場所の URI。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-SecurityGroupArns"></a>
FSx for Lustre ファイル システムに設定されるセキュリティ グループのAmazon リソースネーム (ARN)。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

## エラー
<a name="API_DescribeLocationFsxLustre_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationFsxLustre_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) 

# DescribeLocationFsxOntap
<a name="API_DescribeLocationFsxOntap"></a>

Amazon FSx for NetApp ONTAP ファイルシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。

**注記**  
場所に SMB が使用されている場合、`DescribeLocationFsxOntap` オペレーションは実際には `Password` を返しません。

## リクエストの構文
<a name="API_DescribeLocationFsxOntap_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationFsxOntap_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationFsxOntap_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-request-LocationArn"></a>
情報を取得する FSx for ONTAP ファイルシステム上の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationFsxOntap_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "FsxFilesystemArn": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationFsxOntap_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-CreationTime"></a>
場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-FsxFilesystemArn"></a>
FSx for ONTAP ファイルシステムの ARN。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` 

 ** [LocationArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-LocationArn"></a>
指定された場所にある FSx for ONTAP ファイルシステムの 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}$` 

 ** [LocationUri](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-LocationUri"></a>
FSx for ONTAP ファイル システムの場所の統一資源識別子 (URI)。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-Protocol"></a>
 AWS DataSync が Amazon FSx ファイルシステムにアクセスするために使用するデータ転送プロトコルを指定します。  
型: [FsxProtocol](API_FsxProtocol.md) オブジェクト

 ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-SecurityGroupArns"></a>
DataSync が FSx for ONTAP ファイルシステムにアクセスするために使用するセキュリティグループ。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

 ** [StorageVirtualMachineArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-StorageVirtualMachineArn"></a>
データのコピーのやり取りをする FSx for ONTAP ファイル システム上のストレージ仮想マシン (SVM) の ARN。  
タイプ: 文字列  
長さの制約: 最大長は 162 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` 

## エラー
<a name="API_DescribeLocationFsxOntap_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationFsxOntap_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) 

# DescribeLocationFsxOpenZfs
<a name="API_DescribeLocationFsxOpenZfs"></a>

Amazon FSx for OpenZFS ファイルシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。

**注記**  
`SMB` に関連するレスポンス要素は `DescribeLocationFsxOpenZfs` オペレーションではサポートされていません。

## リクエストの構文
<a name="API_DescribeLocationFsxOpenZfs_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationFsxOpenZfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-request-LocationArn"></a>
説明する FSx for OpenZFS の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationFsxOpenZfs_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ]
}
```

## レスポンス要素
<a name="API_DescribeLocationFsxOpenZfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-CreationTime"></a>
FSx for OpenZFS の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationArn"></a>
説明された FSx for OpenZFS の場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationUri"></a>
説明された FSx for OpenZFS の場所の統一資源識別子 (URI)。  
例: `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder`   
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-Protocol"></a>
 AWS DataSync がファイルシステムにアクセスするために使用するプロトコルのタイプ。  
型: [FsxProtocol](API_FsxProtocol.md) オブジェクト

 ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-SecurityGroupArns"></a>
FSx for OpenZFS ファイルシステム用に構成するセキュリティグループの ARN。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

## エラー
<a name="API_DescribeLocationFsxOpenZfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationFsxOpenZfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 

# DescribeLocationFsxWindows
<a name="API_DescribeLocationFsxWindows"></a>

Amazon FSx for Windows File Server ファイルシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationFsxWindows_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationFsxWindows_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationFsxWindows_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-request-LocationArn"></a>
FSx for Windows File Server の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationFsxWindows_ResponseSyntax"></a>

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "SecurityGroupArns": [ "string" ],
   "User": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationFsxWindows_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CmkSecretConfig"></a>
DataSync が特定のストレージロケーションへのアクセスに使用する など、`Password`DataSync が管理するシークレットの設定情報をカスタマー管理で記述します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト

 ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CreationTime"></a>
FSx for Windows File Server の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CustomSecretConfig"></a>
DataSync `Password`が特定のストレージロケーションにアクセスするために使用する など、カスタマーマネージドシークレットの設定情報を、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールで記述します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト

 ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-Domain"></a>
FSx for Windows File Server ファイルシステムが属する Microsoft Active Directory ドメインの名前。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [LocationArn](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationArn"></a>
FSx for Windows File Server の場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationUri"></a>
FSx for Windows File Server の場所の統一資源識別子 (URI) 。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-ManagedSecretConfig"></a>
DataSync が特定のストレージロケーションにアクセスするために使用する など、`Password`DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。  
型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト

 ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-SecurityGroupArns"></a>
ファイルシステムの優先サブネットへのアクセスを提供する Amazon EC2 セキュリティグループの ARN。  
ファイルシステムアクセスのセキュリティグループの設定については、「[https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html)」を参照してください。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

 ** [User](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-User"></a>
FSx for Windows File Server ファイルシステムをマウントし、アクセスするためのアクセス許可を持つユーザー。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## エラー
<a name="API_DescribeLocationFsxWindows_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationFsxWindows_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) 

# DescribeLocationHdfs
<a name="API_DescribeLocationHdfs"></a>

Hadoop Distributed File System (HDFS) の AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationHdfs_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationHdfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) **   <a name="DataSync-DescribeLocationHdfs-request-LocationArn"></a>
HDFS の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationHdfs_ResponseSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationHdfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AgentArns"></a>
HDFS クラスターに安全に接続できる DataSync エージェントの 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](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AuthenticationType"></a>
ユーザーの ID を決定するために使用される認証のタイプ。  
タイプ: 文字列  
有効な値：`SIMPLE | KERBEROS`

 ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-BlockSize"></a>
HDFS クラスターに書き込むデータブロックのサイズ。  
タイプ: 整数  
有効範囲: 最小値 は 1,048,576 です。最大値は 1,073,741,824 です。

 ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CmkSecretConfig"></a>
DataSync が特定のストレージロケーションへのアクセスに使用する など、`KerberosKeytab`DataSync が管理するシークレットの設定情報をカスタマー管理で記述します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト

 ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CreationTime"></a>
HDFS の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CustomSecretConfig"></a>
DataSync `KerberosKeytab`が特定のストレージロケーションにアクセスするために使用する など、カスタマーマネージドシークレットの設定情報を、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールで記述します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト

 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KerberosPrincipal"></a>
HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。`AuthenticationType` を `KERBEROS` と定義するとき、このパラメータが使用されます。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$` 

 ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KmsKeyProviderUri"></a>
 HDFS クラスターのキー管理サーバー (KMS) の URI。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` 

 ** [LocationArn](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationArn"></a>
HDFS の場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationUri"></a>
HDFS の場所の URI。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ManagedSecretConfig"></a>
DataSync が特定のストレージロケーションにアクセスするために使用する など、`KerberosKeytab`DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。  
型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト

 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-NameNodes"></a>
HDFS 名前空間を管理する NameNode。  
タイプ: [HdfsNameNode](API_HdfsNameNode.md) オブジェクトの配列  
配列メンバー: 最小数は 1 項目です。

 ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-QopConfiguration"></a>
保護の品質 (QOP) 設定は、HDFS クラスターで設定されたリモートプロシージャコール (RPC) とデータ転送保護の設定を指定します。  
タイプ: [QopConfiguration](API_QopConfiguration.md) オブジェクト

 ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ReplicationFactor"></a>
HDFS クラスターへの書き込み時にデータをレプリケートする DataNode の数。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 512 です。

 ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-SimpleUser"></a>
ホストオペレーティングシステム上のクライアントを識別するためのユーザー名。`AuthenticationType` を `SIMPLE` と定義するとき、このパラメータが使用されます。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 

## エラー
<a name="API_DescribeLocationHdfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationHdfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) 

# DescribeLocationNfs
<a name="API_DescribeLocationNfs"></a>

Network File System (NFS) ファイルサーバーの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationNfs_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationNfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationNfs_RequestSyntax) **   <a name="DataSync-DescribeLocationNfs-request-LocationArn"></a>
情報が必要な NFS の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationNfs_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   }
}
```

## レスポンス要素
<a name="API_DescribeLocationNfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-CreationTime"></a>
NFS の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationArn"></a>
NFS の場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationUri"></a>
NFS の場所の URI。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-MountOptions"></a>
DataSync が NFS ファイルサーバーをマウントする際に使用するマウントオプション。  
型: [NfsMountOptions](API_NfsMountOptions.md) オブジェクト

 ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-OnPremConfig"></a>
Network File System (NFS) ファイルサーバーに接続できる AWS DataSync エージェント。  
型: [OnPremConfig](API_OnPremConfig.md) オブジェクト

## エラー
<a name="API_DescribeLocationNfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeLocationNfs_Examples"></a>

### 例
<a name="API_DescribeLocationNfs_Example_1"></a>

次の例では、サンプルリクエストで指定された NFS の場所に関する情報を返します。

#### リクエスト例
<a name="API_DescribeLocationNfs_Example_1_Request"></a>

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
```

### 例
<a name="API_DescribeLocationNfs_Example_2"></a>

この例は、DescribeLocationNfs の使用方法を 1 つ示しています。

#### レスポンス例
<a name="API_DescribeLocationNfs_Example_2_Response"></a>

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa",
   "LocationUri": "hostname.amazon.com",
   "OnPremConfig": { 
      "AgentArns": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
   }
}
```

## 以下の資料も参照してください。
<a name="API_DescribeLocationNfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationNfs) 

# DescribeLocationObjectStorage
<a name="API_DescribeLocationObjectStorage"></a>

オブジェクトストレージシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationObjectStorage_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationObjectStorage_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationObjectStorage_RequestSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-request-LocationArn"></a>
オブジェクトストレージの場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationObjectStorage_ResponseSyntax"></a>

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "ServerCertificate": blob,
   "ServerPort": number,
   "ServerProtocol": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationObjectStorage_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AccessKey"></a>
オブジェクトストレージシステムとの認証に必要なアクセスキー (たとえば、ユーザー名など) 。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 200 です。  
パターン: `^.*$` 

 ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AgentArns"></a>
オブジェクトストレージシステムに接続できる DataSync エージェントの 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}$` 

 ** [CmkSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CmkSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセットなど、DataSync が管理するシークレットと、カスタマー管理の AWS KMS keyの設定情報について説明します。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト

 ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CreationTime"></a>
場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセット、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報について説明します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト

 ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationArn"></a>
オブジェクトストレージシステムの場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationUri"></a>
オブジェクトストレージシステムの場所の URI。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ManagedSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセットなど、DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。  
型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト

 ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerCertificate"></a>
システムがプライベートまたは自己署名の認証機関 (CA) を使用する場合、DataSync がオブジェクトストレージシステムで認証するための証明書チェーン。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 32,768 です。

 ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerPort"></a>
オブジェクトストレージサーバーがインバウンドネットワークトラフィックを受け入れるポート (たとえば、ポート 443 など)  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 65,536 です。

 ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerProtocol"></a>
オブジェクトストレージシステムが通信に使用するプロトコル。  
タイプ: 文字列  
有効な値：`HTTPS | HTTP`

## エラー
<a name="API_DescribeLocationObjectStorage_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DescribeLocationObjectStorage_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) 

# DescribeLocationS3
<a name="API_DescribeLocationS3"></a>

S3 バケットの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationS3_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationS3_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) **   <a name="DataSync-DescribeLocationS3-request-LocationArn"></a>
Amazon S3 の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationS3_ResponseSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationS3_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AgentArns](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-AgentArns"></a>
Amazon S3 on Outposts の使用と作業時に Outpost にデプロイされた DataSync エージェントの ARN。  
詳細については、[DataSync エージェントをデプロイする AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent)」を参照してください。  
型: 文字列の配列  
配列メンバー: 最小数は 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}$` 

 ** [CreationTime](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-CreationTime"></a>
Amazon S3 の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationArn"></a>
Amazon S3 の場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationUri"></a>
記述された Amazon S3 の場所の URL。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3Config"></a>
DataSync が S3 バケットにアクセスするために使用する AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN) を指定します。  
詳細については、「[Providing DataSync access to S3 buckets](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)」を参照してください。  
型: [S3Config](API_S3Config.md) オブジェクト

 ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3StorageClass"></a>
Amazon S3 が送信先の場所の場合、これはオブジェクト用に選択したストレージクラスです。  
一部のストレージクラスの動作は、Amazon S3 のストレージコストに影響する場合があります。詳細については、「[Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。  
タイプ: 文字列  
有効な値：`STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`

## エラー
<a name="API_DescribeLocationS3_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeLocationS3_Examples"></a>

### 例
<a name="API_DescribeLocationS3_Example_1"></a>

次の例では、サンプルリクエストで指定された Amazon S3 の場所に関する情報を返します。

#### リクエスト例
<a name="API_DescribeLocationS3_Example_1_Request"></a>

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}
```

### 例
<a name="API_DescribeLocationS3_Example_2"></a>

この例は、DescribeLocationS3 の使用方法を 1 つ示しています。

#### レスポンス例
<a name="API_DescribeLocationS3_Example_2_Response"></a>

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
   "LocationUri": "s3://amzn-s3-demo-bucket",
   "S3Config": { 
      "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
   }
    "S3StorageClass": "STANDARD"
}
```

## 以下の資料も参照してください。
<a name="API_DescribeLocationS3_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3) 

# DescribeLocationSmb
<a name="API_DescribeLocationSmb"></a>

Server Message Block (SMB) ファイルサーバーの AWS DataSync 転送場所の設定方法の詳細を提供します。

## リクエストの構文
<a name="API_DescribeLocationSmb_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeLocationSmb_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
情報が必要な SMB の場所の Amazon リソースネーム (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}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeLocationSmb_ResponseSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "MountOptions": { 
      "Version": "string"
   },
   "User": "string"
}
```

## レスポンス要素
<a name="API_DescribeLocationSmb_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
SMB ファイルサーバーに接続できる DataSync エージェントの 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](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AuthenticationType"></a>
DataSync が SMB ファイルサーバーへの接続に使用する認証プロトコルを指定します。  
型: 文字列  
有効な値：`NTLM | KERBEROS`

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
DataSync が特定のストレージロケーションへのアクセスに使用する `Password`や など、`KerberosKeytab`DataSync が管理するシークレットの設定情報をカスタマー管理で記述します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
SMB の場所が作成された時刻。  
タイプ: タイムスタンプ

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
DataSync `KerberosKeytab`が特定のストレージロケーションにアクセスするために使用する `Password`や など、カスタマーマネージドシークレットの設定情報を、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールで記述します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
SMB ファイルサーバーが属する DNS サーバーの IPv4 または IPv6 アドレス。この要素は、`AuthenticationType` が `KERBEROS` に設定されている場合にのみ適用されます。  
型: 文字列の配列  
配列メンバー: 最大数は 2 項目です。  
長さの制限: 最小長は 7 です。最大長は 39 です。  
パターン: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 

 ** [Domain](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-Domain"></a>
SMB ファイルサーバーが属する Windows ドメインの名前。この要素は、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
SMB ファイルサーバーのファイル、フォルダ、ファイルメタデータにアクセスするためのアクセス許可を持つ Kerberos プリンシパル。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$` 

 ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
SMB の場所の 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}$` 

 ** [LocationUri](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationUri"></a>
SMB の場所の URI。  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
DataSync が特定のストレージロケーションにアクセスするために使用する `Password`や など、`KerberosKeytab`DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。  
型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
DataSync が SMB ファイルサーバーにアクセスするために使用する SMB プロトコルバージョン。  
型: [SmbMountOptions](API_SmbMountOptions.md) オブジェクト

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
SMB ファイルサーバー内のファイル、フォルダ、ファイルメタデータをマウントしてアクセスできるユーザー。この要素は、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## エラー
<a name="API_DescribeLocationSmb_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeLocationSmb_Examples"></a>

### 例
<a name="API_DescribeLocationSmb_Example_1"></a>

この例は、DescribeLocationSmb の使用方法を 1 つ示しています。

#### リクエスト例
<a name="API_DescribeLocationSmb_Example_1_Request"></a>

```
{
  "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

### 例
<a name="API_DescribeLocationSmb_Example_2"></a>

この例は、DescribeLocationSmb の使用方法を 1 つ示しています。

#### レスポンス例
<a name="API_DescribeLocationSmb_Example_2_Response"></a>

```
{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
   ],
   "CreationTime":"1532660733.39",
   "Domain":"AMAZON",
   "LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
   "LocationUri":"smb://hostname.amazon.com/share",
   "MountOptions":{
      "Version":"SMB3"
   },
   "User":"user-1"
}
```

## 以下の資料も参照してください。
<a name="API_DescribeLocationSmb_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb) 

# DescribeTask
<a name="API_DescribeTask"></a>

 AWS DataSync がデータを転送する場所と方法を定義する*タスク*に関する情報を提供します。

## リクエストの構文
<a name="API_DescribeTask_RequestSyntax"></a>

```
{
   "TaskArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeTask_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [TaskArn](#API_DescribeTask_RequestSyntax) **   <a name="DataSync-DescribeTask-request-TaskArn"></a>
情報が必要な転送タスクの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeTask_ResponseSyntax"></a>

```
{
   "CloudWatchLogGroupArn": "string",
   "CreationTime": number,
   "CurrentTaskExecutionArn": "string",
   "DestinationLocationArn": "string",
   "DestinationNetworkInterfaceArns": [ "string" ],
   "ErrorCode": "string",
   "ErrorDetail": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "ScheduleDetails": { 
      "DisabledBy": "string",
      "DisabledReason": "string",
      "StatusUpdateTime": number
   },
   "SourceLocationArn": "string",
   "SourceNetworkInterfaceArns": [ "string" ],
   "Status": "string",
   "TaskArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## レスポンス要素
<a name="API_DescribeTask_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CloudWatchLogGroupArn"></a>
タスクをモニタリングするための Amazon CloudWatch ロググループの Amazon リソースネーム (ARN)。  
詳細については、「[Monitoring data transfers with Amazon CloudWatch Logs](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 562 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 

 ** [CreationTime](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CreationTime"></a>
タスクが作成された時刻。  
タイプ: タイムスタンプ

 ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CurrentTaskExecutionArn"></a>
最新のタスク実行の ARN。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [DestinationLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationLocationArn"></a>
転送時に送信先の場所の 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}$` 

 ** [DestinationNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationNetworkInterfaceArns"></a>
DataSync が送信先用に作成された[ネットワークインターフェイス](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces)の ARN。  
タイプ: 文字列の配列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` 

 ** [ErrorCode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorCode"></a>
タスクに問題がある場合は、エラーコードを使用して問題のトラブルシューティングに役立てることができます。詳細については、「[Troubleshooting issues with DataSync transfers](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)」を参照してください。  
タイプ: 文字列

 ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorDetail"></a>
タスクに問題がある場合は、エラーの詳細を使用して問題のトラブルシューティングに役立てることができます。詳細については、「[Troubleshooting issues with DataSync transfers](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)」を参照してください。  
タイプ: 文字列

 ** [Excludes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Excludes"></a>
DataSync に転送してほしくないソースの場所内のファイル、オブジェクト、フォルダを定義する除外フィルター。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

 ** [Includes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Includes"></a>
DataSync が転送するソースの場所内のファイル、オブジェクト、フォルダを定義するフィルターが含まれます。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

 ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ManifestConfig"></a>
DataSync の転送を希望するファイルまたはオブジェクトを一覧表示するマニフェストを設定します。詳細については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。  
タイプ: [ManifestConfig](API_ManifestConfig.md) オブジェクト

 ** [Name](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Name"></a>
タスクの名前。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Options](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Options"></a>
タスクの設定。例えば、どのファイルメタデータが保持されるか、転送終了時にデータ整合性がどのように検証されるか、帯域幅の制限などです。  
タイプ: [Options](API_Options.md) オブジェクト

 ** [Schedule](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Schedule"></a>
タスクを実行するタイミングのスケジュール。詳細については、「[タスクのスケジュール](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)」を参照してください。  
タイプ: [TaskSchedule](API_TaskSchedule.md) オブジェクト

 ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ScheduleDetails"></a>
[タスクスケジュール](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)の詳細。  
タイプ: [TaskScheduleDetails](API_TaskScheduleDetails.md) オブジェクト

 ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceLocationArn"></a>
転送時のソースの場所の 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}$` 

 ** [SourceNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceNetworkInterfaceArns"></a>
DataSync がソースの場所用に作成した[ネットワークインターフェイス](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces)の ARNs。  
タイプ: 文字列の配列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` 

 ** [Status](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Status"></a>
タスクのステータス。各ステータスの意味については、「[Task statuses](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses)」を参照してください。  
タイプ: 文字列  
有効な値：`AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE`

 ** [TaskArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskArn"></a>
タスクの ARN。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskMode"></a>
使用しているタスクモード。詳細については、「[Choosing a task mode for your data transfer](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)」を参照してください。  
型: 文字列  
有効な値：`BASIC | ENHANCED`

 ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskReportConfig"></a>
DataSync 転送に関する詳細情報を提供するタスクレポートの設定。詳細については、「[Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
タイプ: [TaskReportConfig](API_TaskReportConfig.md) オブジェクト

## エラー
<a name="API_DescribeTask_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeTask_Examples"></a>

### リクエスト例
<a name="API_DescribeTask_Example_1"></a>

次の例では、情報を取得する DataSync タスクの ARN を指定します。

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

### レスポンス例
<a name="API_DescribeTask_Example_2"></a>

以下は `DescribeTask` レスポンスの例です。

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026",
  "Name": "MyTask",
  "TaskMode": "BASIC",
  "Status": "RUNNING",
  "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3",
  "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2",
  "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f",
  "CreationTime": 1532660733.39,
  "Options": { 
    "Atime": "BEST_EFFORT",
    "BytesPerSecond": 1000,
    "Gid": "NONE",
    "Mtime": "PRESERVE",
    "PosixPermissions": "PRESERVE",
    "PreserveDevices": "NONE",
    "PreserveDeletedFiles": "PRESERVE",
    "Uid": "NONE",
    "VerifyMode": "POINT_IN_TIME_CONSISTENT"
  },
  "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*"
}
```

## 以下の資料も参照してください。
<a name="API_DescribeTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask) 

# DescribeTaskExecution
<a name="API_DescribeTaskExecution"></a>

 AWS DataSync タスクの実行に関する情報を提供します。このオペレーションを使用すると、行われているデータ転送の進行状況を監視したり、転送の結果を確認したりできます。

**注記**  
一部の `DescribeTaskExecution` レスポンス要素は、特定のタスクモードにのみ関係します。詳細については、「[Understanding task mode differences](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)」および[「Understanding data transfer performance counters](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html)」を参照してください。

## リクエストの構文
<a name="API_DescribeTaskExecution_RequestSyntax"></a>

```
{
   "TaskExecutionArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeTaskExecution_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **   <a name="DataSync-DescribeTaskExecution-request-TaskExecutionArn"></a>
情報が必要なタスク実行の Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeTaskExecution_ResponseSyntax"></a>

```
{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EndTime": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToDelete": number,
   "EstimatedFilesToTransfer": number,
   "EstimatedFoldersToDelete": number,
   "EstimatedFoldersToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesDeleted": number,
   "FilesFailed": { 
      "Delete": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FilesListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FilesPrepared": number,
   "FilesSkipped": number,
   "FilesTransferred": number,
   "FilesVerified": number,
   "FoldersDeleted": number,
   "FoldersFailed": { 
      "Delete": number,
      "List": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FoldersListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FoldersPrepared": number,
   "FoldersSkipped": number,
   "FoldersTransferred": number,
   "FoldersVerified": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "LaunchTime": number,
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "ReportResult": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "Status": "string"
   },
   "Result": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "PrepareDuration": number,
      "PrepareStatus": "string",
      "TotalDuration": number,
      "TransferDuration": number,
      "TransferStatus": "string",
      "VerifyDuration": number,
      "VerifyStatus": "string"
   },
   "StartTime": number,
   "Status": "string",
   "TaskExecutionArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## レスポンス要素
<a name="API_DescribeTaskExecution_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesCompressed"></a>
圧縮が適用された後にネットワーク上で DataSync が転送した物理バイト数 (圧縮可能な場合)。データが圧縮可能でない限り、この数値は通常 [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred) よりも小さくなります。  
タイプ: Long

 ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesTransferred"></a>
圧縮前に DataSync がネットワークに送信するバイト数 (圧縮可能な場合)。ネットワーク経由で転送されるバイト数については、「[BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed)」を参照してください。  
タイプ: 長整数

 ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesWritten"></a>
DataSync が転送先の場所に実際に書き込んだ論理バイト数。  
タイプ: Long

 ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EndTime"></a>
転送タスクが終了した時刻。  
タイプ: タイムスタンプ

 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedBytesToTransfer"></a>
DataSync が転送先の場所に書き込む論理バイト数の予定。  
タイプ: 長整数

 ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToDelete"></a>
DataSync が転送先の場所で削除する予定のファイル、オブジェクト、およびディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete) にカウントされます。
タイプ: Long

 ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToTransfer"></a>
DataSync がネットワーク経由で転送する予定のファイル、オブジェクト、およびディレクトリの数。この値は、DataSync が転送を[準備](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)している間に計算されます。  
これがどのように計算されるかは、主にタスクの[転送モード](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)の設定によって異なります。  
+ `TranserMode` が `CHANGED` に設定されている場合 - この計算は、ソースと転送先の内容の比較と、転送する必要がある差の特定に基づいて実行されます。相違点は次のとおりです。
  + ソースの場所で追加または変更されたもの。
  + 両方の場所にあり、最初の転送後に転送先で変更されたもの ([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) が `NEVER` に設定されている場合を除く)。
  +  **(基本タスクモードのみ)** DataSync が削除する予定の項目の数 ([PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) が `REMOVE` に設定されている場合)。
+ `TranserMode` が `ALL` に設定されている場合 - 計算は DataSync がソースの場所で検出した項目のみに基づいています。
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer) にカウントされます。
タイプ: Long

 ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete"></a>
DataSync が送信先ロケーションで削除する予定のディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer"></a>
DataSync がネットワーク経由で転送することを期待するディレクトリの数。この値は、DataSync が転送するディレクトリ[を準備する](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)ときに計算されます。  
これがどのように計算されるかは、主にタスクの[転送モード](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)の設定によって異なります。  
+ `TranserMode` が `CHANGED` に設定されている場合 - この計算は、ソースと転送先の内容の比較と、転送する必要がある差の特定に基づいて実行されます。相違点は次のとおりです。
  + ソースの場所で追加または変更されたもの。
  + 両方の場所にあり、最初の転送後に転送先で変更されたもの ([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) が `NEVER` に設定されている場合を除く)。
+ `TranserMode` が `ALL` に設定されている場合 - 計算は DataSync がソースの場所で検出した項目のみに基づいています。
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Excludes"></a>
転送中に特定のデータを除外するフィルタルールのリスト。詳細と例については、「[DataSync によって転送されるデータのフィルタリング](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

 ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesDeleted"></a>
DataSync が転送先の場所で実際に削除したファイル、オブジェクト、およびディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted) にカウントされます。
タイプ: Long

 ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesFailed"></a>
タスクの実行中に DataSync が準備、転送、検証、削除に失敗したファイルまたはオブジェクトの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) オブジェクト

 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesListed"></a>
DataSync がお客様の場所で見つけたファイルまたはオブジェクトの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) オブジェクト

 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesPrepared"></a>
送信元と送信先の場所を比較した後に DataSync が転送を試みるファイルまたはオブジェクトの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
このカウンターは、[すべてのデータを転送する](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)ようにタスクを設定している場合には適用されません。この場合、DataSync は、場所間の違いを比較せずに、送信元から送信先にすべてコピーします。  
タイプ: Long

 ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesSkipped"></a>
転送中に DataSync がスキップするファイル、オブジェクト、およびディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped) にカウントされます。
タイプ: Long

 ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesTransferred"></a>
DataSync がネットワーク経由で実際に転送したファイル、オブジェクト、およびディレクトリの数。この値は、タスクの実行中に送信元から何かが読み取られ、ネットワーク経由で送信されたときに定期的に更新されます。  
DataSync が何かを転送できない場合、この値は `EstimatedFilesToTransfer` より小さくなる可能性があります。場合によっては、この値は `EstimatedFilesToTransfer` より大きくなることもあります。一部の場所タイプではこの要素は実装固有であるため、何が送信されているかを正確に把握するためのインジケータとして、あるいはタスク実行をモニタリングする目的では、これを使用しないでください。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred) にカウントされます。
タイプ: Long

 ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesVerified"></a>
転送中に DataSync が検証するファイル、オブジェクト、およびディレクトリの数。  
[転送されたデータのみを検証](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html)するようにタスクを設定すると、DataSync は状況によってはディレクトリを検証せず、また転送に失敗したファイルを検証しません。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified) にカウントされます。
タイプ: Long

 ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersDeleted"></a>
DataSync が送信先ロケーションで実際に削除するディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersFailed"></a>
タスクの実行中に DataSync がリスト、準備、転送、検証、削除に失敗したディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) オブジェクト

 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersListed"></a>
DataSync がお客様のロケーションで見つけたディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) オブジェクト

 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersPrepared"></a>
送信元と送信先の場所を比較した後に DataSync が転送を試みるディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
このカウンターは、[すべてのデータを転送する](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)ようにタスクを設定している場合には適用されません。この場合、DataSync は、場所間の違いを比較せずに、送信元から送信先にすべてコピーします。  
タイプ: Long

 ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersSkipped"></a>
転送中に DataSync がスキップするディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersTransferred"></a>
DataSync がネットワーク経由で実際に転送するディレクトリの数。この値は、タスクの実行中に送信元から何かが読み取られ、ネットワーク経由で送信されたときに定期的に更新されます。  
DataSync が何かを転送できない場合、この値は `EstimatedFoldersToTransfer` より小さくなる可能性があります。場合によっては、この値は `EstimatedFoldersToTransfer` より大きくなることもあります。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersVerified"></a>
転送中に DataSync が検証するディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Includes"></a>
転送中に特定のデータを含めるフィルタルールのリスト。詳細と例については、「[DataSync によって転送されるデータのフィルタリング](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

 ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-LaunchTime"></a>
タスク実行が実際に開始された時刻。キューに入れられていないタスクの場合、`LaunchTime` と `StartTime` は通常同じになります。キューに入れられたタスクの場合、`LaunchTime` は通常 `StartTime` よりも後になります。これは、新しいタスクを開始する前に、以前にキューに入れられたタスクの実行を完了する必要があるためです。  
タイプ: タイムスタンプ

 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ManifestConfig"></a>
転送するファイルまたはオブジェクトを一覧表示するマニフェストの設定。詳細については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。  
タイプ: [ManifestConfig](API_ManifestConfig.md) オブジェクト

 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Options"></a>
転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。  
各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。  
これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。  
タイプ: [Options](API_Options.md) オブジェクト

 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ReportResult"></a>
DataSync が転送に関する完全な[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)を生成したかどうかを示します。  
タイプ: [ReportResult](API_ReportResult.md) オブジェクト

 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Result"></a>
タスク実行の 結果。  
型: [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) オブジェクト

 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-StartTime"></a>
DataSync がタスク実行を開始するためのリクエストを送信した時刻。キューに入れられていないタスクの場合、`LaunchTime` と `StartTime` は通常同じになります。キューに入れられたタスクの場合、`LaunchTime` は通常 `StartTime` よりも後になります。これは、新しいタスクを開始する前に、以前にキューに入れられたタスクの実行を完了する必要があるためです。  
タイプ: タイムスタンプ

 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Status"></a>
タスク実行のステータス。  
タスク実行ステータスの詳細については、「[タスクの実行ステータス](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
タイプ: 文字列  
有効な値：`QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`

 ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskExecutionArn"></a>
ユーザーが情報を必要としたタスク実行の ARN。`TaskExecutionArn` は階層的であり、実行されたタスクの `TaskArn` を含みます。  
たとえば、ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2` でタスクを実行した ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` と `TaskExecution` の値です。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskMode"></a>
使用しているタスクモード。詳細については、「[Choosing a task mode for your data transfer](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)」を参照してください。  
型: 文字列  
有効な値：`BASIC | ENHANCED`

 ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskReportConfig"></a>
DataSync 転送に関する詳細情報を提供するタスクレポートの設定。詳細については、「[タスクレポートの作成](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
タイプ: [TaskReportConfig](API_TaskReportConfig.md) オブジェクト

## エラー
<a name="API_DescribeTaskExecution_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeTaskExecution_Examples"></a>

### リクエスト例
<a name="API_DescribeTaskExecution_Example_1"></a>

この例は `DescribeTaskExecution` リクエストを示しています。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1"
}
```

### 拡張モードでのタスク実行のレスポンス例 1
<a name="API_DescribeTaskExecution_Example_2"></a>

次の例では、拡張モードを使用する DataSync タスク実行について説明します。実行では、除外フィルターと包含フィルターを使用して特定のデータも転送されます。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "BASIC",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/archive-files"
    }],
    "Includes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/files"
    }],
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "EstimatedFilesToTransfer": 7,
    "EstimatedFoldersToTransfer": 2,
    "EstimatedBytesToTransfer": 30,
    "FilesTransferred": 7,
    "FoldersTransferred": 2,
    "BytesWritten": 30,
    "BytesTransferred": 30,
    "BytesCompressed": 30,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3310,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 7,
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 7,
    "FilesListed": {
        "AtSource": 7,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 2,
    "FoldersPrepared": 2,
    "FoldersListed": {
        "AtSource": 2,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
}
```

### 拡張モードでのタスク実行のレスポンス例 2
<a name="API_DescribeTaskExecution_Example_3"></a>

次の例では、拡張モードを使用する別の DataSync タスク実行について説明します。この場合、実行ではフィルターの代わりにマニフェストを使用して特定のデータが転送されます。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "TRANSFER",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [],
    "Includes": [],
    "ManifestConfig": {
        "Action": "TRANSFER",
        "Format": "CSV",
        "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess",
        "S3Bucket": "arn:aws:s3:::manifests-datasync",
        "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG",
        "Source": {
            "S3": {
                "ManifestObjectPath": "manifest-folder/manifest-versioned-files",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess",
                "S3BucketArn": "arn:aws:s3:::manifests-datasync",
                "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG"
            }
        }
    },
    "StartTime": "2024-10-16T09:29:56.757000-04:00",
    "EstimatedFilesToTransfer": 1,
    "EstimatedFoldersToTransfer": 0,
    "EstimatedBytesToTransfer": 6,
    "FilesTransferred": 1,
    "FoldersTransferred": 1,
    "BytesWritten": 6,
    "BytesTransferred": 6,
    "BytesCompressed": 6,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3089,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "Subdirectory": "reports/",
                "S3BucketArn": "arn:aws:s3:::my-task-report",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess"
            }
        },
        "OutputType": "STANDARD",
        "ReportLevel": "SUCCESSES_AND_ERRORS",
        "ObjectVersionIds": "INCLUDE"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 1,
    "ReportResult": {
        "Status": "SUCCESS"
    },
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 1,
    "FilesListed": {
        "AtSource": 1,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 0,
    "FoldersPrepared": 0,
    "FoldersListed": {
        "AtSource": 0,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
  }
```

### 基本モードでのタスク実行のレスポンス例
<a name="API_DescribeTaskExecution_Example_4"></a>

次の例では、基本モードを使用する DataSync タスク実行について説明します。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "BytesCompressed": 3500,
    "BytesTransferred": 5000,
    "BytesWritten": 5000,
    "EstimatedBytesToTransfer": 5000,
    "EstimatedFilesToDelete": 10,
    "EstimatedFilesToTransfer": 100,
    "FilesDeleted": 10,
    "FilesSkipped": 0,
    "FilesTransferred": 100,
    "FilesVerified": 100,
    "Result": {
        "PrepareDuration": 100,
        "PrepareStatus": "SUCCESS",
        "TransferDuration": 60,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 30,
        "VerifyStatus": "SUCCESS"
    },
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "Status": "SUCCESS",
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": "1000",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role",
                "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*",
                "Subdirectory": "reports"
            }
        },
        "ObjectVersionIds": "INCLUDE",
        "OutputType": "STANDARD",
        "Overrides": {
            "Deleted": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Skipped": {
                "ReportLevel": "SUCCESSES_AND_ERRORS"
            },
            "Transferred": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Verified": {
                "ReportLevel": "ERRORS_ONLY"
            }
        },
        "ReportLevel": "ERRORS_ONLY"
    }
}
```

## 以下の資料も参照してください。
<a name="API_DescribeTaskExecution_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution) 

# ListAgents
<a name="API_ListAgents"></a>

リクエストで AWS リージョン 指定された AWS アカウント の に属する AWS DataSync エージェントのリストを返します。

ページネーションにより、レスポンスで返されるエージェントの数を減らすことができます。レスポンスで返された数を超えるエージェントがある場合、レスポンスはマーカーを含んでおり、次のリクエストで指定してエージェントの次のページを取得できます。

 `ListAgents`の結果整合性 つまり、オペレーションを実行した結果には、エージェントを作成または削除したばかりであることが反映されません。たとえば、[CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html) を使用してエージェントを作成して、 `ListAgents` を直ちに実行した場合、そのエージェントはすぐにはリストに表示されない場合があります。このような状況では、[DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html) を使用してエージェントが作成 (または削除) されたかどうかをいつでも確認できます。

## リクエストの構文
<a name="API_ListAgents_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## リクエストパラメーター
<a name="API_ListAgents_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [MaxResults](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-MaxResults"></a>
レスポンスでリストする DataSync エージェントの最大数を指定します。デフォルトでは、レスポンスには最大 100 のエージェントが表示されます。  
タイプ: 整数  
有効範囲: 最小値 は 0 です。最大値は 100 です。  
必須: いいえ

 ** [NextToken](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-NextToken"></a>
リソースの次の結果のリストの開始位置を示す不明瞭な文字列を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+`   
必須: いいえ

## レスポンスの構文
<a name="API_ListAgents_ResponseSyntax"></a>

```
{
   "Agents": [ 
      { 
         "AgentArn": "string",
         "Name": "string",
         "Platform": { 
            "Version": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## レスポンス要素
<a name="API_ListAgents_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [Agents](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-Agents"></a>
リクエスト AWS アカウント で AWS リージョン 指定された の 内の DataSync エージェントのリスト。リストはエージェントの Amazon リソースネーム (ARN) 順に並べられています。  
タイプ: [AgentListEntry](API_AgentListEntry.md) オブジェクトの配列

 ** [NextToken](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-NextToken"></a>
リソースの次の結果のリストの開始位置を示す不明瞭な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+` 

## エラー
<a name="API_ListAgents_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_ListAgents_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) 

# ListLocations
<a name="API_ListLocations"></a>

送信元と送信先の場所のリストを返します。

レスポンスで返された数よりも多くの場所がある場合（つまり、レスポンスがエージェントの省略されたリストのみを返す場合)、レスポンスに含まれているトークンを次のリクエストで指定することで、場所の次のページを取得することができます。

## リクエストの構文
<a name="API_ListLocations_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## リクエストパラメーター
<a name="API_ListLocations_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [Filters](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-Filters"></a>
API フィルターを使用して、`ListLocations` によって返されるリソースのリストを絞り込むことができます。たとえば、特定のソースの場所にあるすべてのタスクを取得するには、フィルター名 `LocationType S3` および `Operator Equals` で `ListLocations` を使用できます。  
タイプ: [LocationFilter](API_LocationFilter.md) オブジェクトの配列  
必須: いいえ

 ** [MaxResults](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-MaxResults"></a>
返される場所の最大数。  
タイプ: 整数  
有効範囲: 最小値 は 0 です。最大値は 100 です。  
必須: いいえ

 ** [NextToken](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-NextToken"></a>
場所の次のリストの開始位置を示す不明瞭な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+`   
必須: いいえ

## レスポンスの構文
<a name="API_ListLocations_ResponseSyntax"></a>

```
{
   "Locations": [ 
      { 
         "LocationArn": "string",
         "LocationUri": "string"
      }
   ],
   "NextToken": "string"
}
```

## レスポンス要素
<a name="API_ListLocations_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [Locations](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-Locations"></a>
場所のリストを含む配列。  
タイプ: [LocationListEntry](API_LocationListEntry.md) オブジェクトの配列

 ** [NextToken](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-NextToken"></a>
場所の次のリストを返す開始位置を示す不透明な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+` 

## エラー
<a name="API_ListLocations_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_ListLocations_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

 AWS リソースに関連付けられているすべてのタグを返します。

## リクエストの構文
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string",
   "ResourceArn": "string"
}
```

## リクエストパラメーター
<a name="API_ListTagsForResource_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [MaxResults](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-MaxResults"></a>
レスポンスに含める結果の数を指定します。  
タイプ: 整数  
有効範囲: 最小値 は 0 です。最大値は 100 です。  
必須: いいえ

 ** [NextToken](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-NextToken"></a>
リソースの次の結果のリストの開始位置を示す不明瞭な文字列を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+`   
必須: いいえ

 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-ResourceArn"></a>
タグ情報が必要なリソースの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
必須: はい

## レスポンスの構文
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_ListTagsForResource_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [NextToken](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-NextToken"></a>
リソースの次の結果のリストの開始位置を示す不明瞭な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+` 

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-Tags"></a>
指定された EFS リソースのタグの配列。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 55 項目です。

## エラー
<a name="API_ListTagsForResource_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_ListTagsForResource_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) 

# ListTaskExecutions
<a name="API_ListTaskExecutions"></a>

 AWS DataSync 転送タスクの実行のリストを返します。

## リクエストの構文
<a name="API_ListTaskExecutions_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string",
   "TaskArn": "string"
}
```

## リクエストパラメーター
<a name="API_ListTaskExecutions_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-MaxResults"></a>
レスポンスに含める結果の数を指定します。  
タイプ: 整数  
有効範囲: 最小値 は 0 です。最大値は 100 です。  
必須: いいえ

 ** [NextToken](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-NextToken"></a>
レスポンスの次の結果リストの開始位置を示す不明瞭な文字列を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+`   
必須: いいえ

 ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-TaskArn"></a>
タスク実行の情報が必要な Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
必須: いいえ

## レスポンスの構文
<a name="API_ListTaskExecutions_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "TaskExecutions": [ 
      { 
         "Status": "string",
         "TaskExecutionArn": "string",
         "TaskMode": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_ListTaskExecutions_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-NextToken"></a>
リソースの次の結果のリストの開始位置を示す不明瞭な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+` 

 ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-TaskExecutions"></a>
タスク実行のリスト。  
タイプ: [TaskExecutionListEntry](API_TaskExecutionListEntry.md) オブジェクトの配列

## エラー
<a name="API_ListTaskExecutions_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_ListTaskExecutions_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) 

# ListTasks
<a name="API_ListTasks"></a>

作成した AWS DataSync タスクのリストを返します。

## リクエストの構文
<a name="API_ListTasks_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## リクエストパラメーター
<a name="API_ListTasks_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [Filters](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-Filters"></a>
API フィルターを使用して、`ListTasks` によって返されるリソースのリストを絞り込むことができます。たとえば、特定のソースの場所にあるすべてのタスクを取得するには、フィルター名 `LocationId` そして `Operator Equals` 付きの `ListTasks` と場所の ARN を使用できます。  
タイプ: [TaskFilter](API_TaskFilter.md) オブジェクトの配列  
必須: いいえ

 ** [MaxResults](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-MaxResults"></a>
返されるタスクの最大数。  
タイプ: 整数  
有効範囲: 最小値 は 0 です。最大値は 100 です。  
必須: いいえ

 ** [NextToken](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-NextToken"></a>
タスクの次のリストの開始位置を示す不明瞭な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+`   
必須: いいえ

## レスポンスの構文
<a name="API_ListTasks_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "Tasks": [ 
      { 
         "Name": "string",
         "Status": "string",
         "TaskArn": "string",
         "TaskMode": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_ListTasks_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [NextToken](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-NextToken"></a>
タスクの次のリストを返し、開始位置を示す不明瞭な文字列。  
タイプ: 文字列  
長さの制約: 最大長は 65,535 です。  
パターン: `[a-zA-Z0-9=_-]+` 

 ** [Tasks](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-Tasks"></a>
返されるすべてのタスクのリスト。  
タイプ: [TaskListEntry](API_TaskListEntry.md) オブジェクトの配列

## エラー
<a name="API_ListTasks_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_ListTasks_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) 

# StartTaskExecution
<a name="API_StartTaskExecution"></a>

 AWS DataSync 転送タスクを開始します。各タスクでは、一度に 1 つのタスク実行しか実行できません。

タスク実行には複数のステップがあります。詳細については、「[タスクの実行ステータス](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses)」を参照してください。

**重要**  
Amazon S3 ロケーションとの間でデータを転送する予定がある場合は、開始する前に [DataSync が S3 リクエスト料金にどのような影響を与えるか](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests)について、および [DataSync 料金ページ](https://aws.amazon.com/datasync/pricing/)を確認してください。

## リクエストの構文
<a name="API_StartTaskExecution_RequestSyntax"></a>

```
{
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "OverrideOptions": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskArn": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## リクエストパラメーター
<a name="API_StartTaskExecution_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [Excludes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Excludes"></a>
タスクから除外するファイルを決定するフィルター規則のリストを指定します。リストには、除外するパターンで構成される 1 つのフィルター文字列が含まれています。パターンは「\$1」(パイプ) で区切られます (例: `"/folder1|/folder2"`)。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。  
必須: いいえ

 ** [Includes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Includes"></a>
タスクを実行するときに含めるファイルを決定するフィルター規則のリストを指定します。パターンには、インクルードするパターンで構成される 1 つのフィルター文字列が含まれる必要があります。パターンは「\$1」(パイプ) で区切られます (例: `"/folder1|/folder2"`)。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。  
必須: いいえ

 ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-ManifestConfig"></a>
DataSync が転送するファイルまたはオブジェクトのリストであるマニフェストを設定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。  
このパラメータを使用する場合、発信者 ID (DataSync を使用しているロール) には `iam:PassRole` アクセス許可が必要です。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) ポリシーには、このアクセス許可が含まれています。  
マニフェスト設定を削除するには、このパラメータを空の値で指定します。  
タイプ: [ManifestConfig](API_ManifestConfig.md) オブジェクト  
必須: いいえ

 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-OverrideOptions"></a>
転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。  
各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。  
これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。  
タイプ: [Options](API_Options.md) オブジェクト  
必須: いいえ

 ** [Tags](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Tags"></a>
タスク実行を表す Amazon リソースネーム (ARN) に適用するタグを指定します。  
 *タグ*は、DataSync リソースの管理、フィルタリング、検索に役立つキーと値のペアです。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskArn"></a>
開始するタスクの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
必須: はい

 ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskReportConfig"></a>
DataSync 転送に関する詳細情報を提供するタスクレポートの構成方法を指定します。詳細については、「[Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
このパラメータを使用する場合、発信者 ID (DataSync を使用しているロール) には `iam:PassRole` アクセス許可が必要です。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) ポリシーには、このアクセス許可が含まれています。  
タスクレポート設定を削除するには、このパラメータを空として指定します。  
タイプ: [TaskReportConfig](API_TaskReportConfig.md) オブジェクト  
必須: いいえ

## レスポンスの構文
<a name="API_StartTaskExecution_ResponseSyntax"></a>

```
{
   "TaskExecutionArn": "string"
}
```

## レスポンス要素
<a name="API_StartTaskExecution_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) **   <a name="DataSync-StartTaskExecution-response-TaskExecutionArn"></a>
進行中のタスク実行の ARN。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

## エラー
<a name="API_StartTaskExecution_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_StartTaskExecution_Examples"></a>

### リクエスト例
<a name="API_StartTaskExecution_Example_1"></a>

次の例では、指定したタスクのデフォルトオプションを使用してタスクの実行を開始します。

```
{
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": 1000,
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

### レスポンス例
<a name="API_StartTaskExecution_Example_2"></a>

この例は、StartTaskExecution 使用方法を 1 つ示しています。

```
{
  "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}
```

## 以下の資料も参照してください。
<a name="API_StartTaskExecution_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution) 

# TagResource
<a name="API_TagResource"></a>

 AWS リソースに*タグ*を適用します。タグは、リソースの管理、フィルタリング、検索に役立つキーと値のペアです。

これには、場所、タスク、タスク実行などの AWS DataSync リソースが含まれます。

## リクエストの構文
<a name="API_TagResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_TagResource_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-ResourceArn"></a>
タグを適用するリソースの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
必須: はい

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-Tags"></a>
リソースに適用するタグを指定します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: はい

## レスポンス要素
<a name="API_TagResource_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_TagResource_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_TagResource_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

 AWS リソースからタグを削除します。

## リクエストの構文
<a name="API_UntagResource_RequestSyntax"></a>

```
{
   "Keys": [ "string" ],
   "ResourceArn": "string"
}
```

## リクエストパラメーター
<a name="API_UntagResource_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [Keys](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-Keys"></a>
削除するタグのキーを指定します。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 50 項目です。  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:/-]+$`   
必須: はい

 ** [ResourceArn](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-ResourceArn"></a>
タグを削除するリソースの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
必須: はい

## レスポンス要素
<a name="API_UntagResource_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UntagResource_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UntagResource_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) 

# UpdateAgent
<a name="API_UpdateAgent"></a>

 AWS DataSync エージェントの名前を更新します。

## リクエストの構文
<a name="API_UpdateAgent_RequestSyntax"></a>

```
{
   "AgentArn": "string",
   "Name": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateAgent_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArn](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-AgentArn"></a>
更新するエージェントの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 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}$`   
必須: はい

 ** [Name](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-Name"></a>
エージェントの設定に使用する名前。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateAgent_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateAgent_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateAgent_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) 

# UpdateLocationAzureBlob
<a name="API_UpdateLocationAzureBlob"></a>

で使用している Microsoft Azure Blob Storage 転送場所の次の設定を変更します AWS DataSync。

詳細については、「[Configuring transfers with Microsoft Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationAzureBlob_RequestSyntax"></a>

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SasConfiguration": { 
      "Token": "string"
   },
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationAzureBlob_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AccessTier](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AccessTier"></a>
オブジェクトまたはファイルの転送先となるアクセス層を指定します。これは、その場所を転送先として使用する場合にのみ適用されます。詳細については、「[アクセス層](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)」を参照してください。  
タイプ: 文字列  
有効な値：`HOT | COOL | ARCHIVE`  
必須：いいえ

 ** [AgentArns](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AgentArns"></a>
(オプション) 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_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AuthenticationType"></a>
DataSync が Azure Blob Storage にアクセスするために使用する認証方法を指定します。DataSync は、共有アクセス署名 (SAS) を使用して blob storage にアクセスできます。  
タイプ: 文字列  
有効な値：`SAS | NONE`  
必須: いいえ

 ** [BlobType](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-BlobType"></a>
オブジェクトまたはファイルを 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_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CmkSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセットなど、DataSync が管理するシークレットと、カスタマー管理の AWS KMS keyの設定情報を指定します。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセット、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報を指定します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-LocationArn"></a>
更新する Azure Blob ストレージの転送場所の 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}$`   
必須: はい

 ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-SasConfiguration"></a>
DataSync を Azure Blob Storage にアクセスできるようにする SAS 設定を指定します。  
タイプ: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) オブジェクト  
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-Subdirectory"></a>
転送をコンテナ内の仮想ディレクトリ (例: `/my/images`) に制限する場合は、パスセグメントを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 1,024 です。  
パターン: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationAzureBlob_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationAzureBlob_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationAzureBlob_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) 

# UpdateLocationEfs
<a name="API_UpdateLocationEfs"></a>

使用している Amazon EFS 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring AWS DataSync transfers with Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationEfs_RequestSyntax"></a>

```
{
   "AccessPointArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationEfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-AccessPointArn"></a>
DataSync が Amazon EFS ファイルシステムにアクセスするために使用するアクセスポイントの Amazon リソースネーム (ARN) を指定します。  
詳細については、「[Accessing restricted file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$)|(^$)`   
必須: いいえ

 ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-FileSystemAccessRoleArn"></a>
DataSync が Amazon EFS ファイルシステムにアクセスできるようにする AWS Identity and Access Management (IAM) ロールを指定します。  
このロールの作成については、「[Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)`   
必須: いいえ

 ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-InTransitEncryption"></a>
DataSync が Amazon EFS ファイルシステムとの間でデータを転送するときに、Transport Layer Security (TLS) 1.2 暗号化を使用するかどうかを指定します。  
`AccessPointArn` または `FileSystemAccessRoleArn` を使用した IAM ロールを使用してアクセスポイントを指定する場合、このパラメータを `TLS1_2` に設定する必要があります。  
タイプ: 文字列  
有効な値：`NONE | TLS1_2`  
必須：いいえ

 ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-LocationArn"></a>
更新する Amazon EFS 転送場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-Subdirectory"></a>
Amazon EFS ファイルシステムのマウントパスを指定します。これは、DataSync がファイルシステム上のデータの読み取りまたは書き込み (送信元の場所か送信先の場所かによって異なります) を行う場所です。  
デフォルトで、DataSync はルートディレクトリ (または `AccessPointArn` を使用して指定する[アクセスポイント](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html)) を使用します。フォワードスラッシュ (例: `/path/to/folder`) を使用してサブディレクトリを含めることもできます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationEfs_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationEfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationEfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) 

# UpdateLocationFsxLustre
<a name="API_UpdateLocationFsxLustre"></a>

で使用している Amazon FSx for Lustre 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring DataSync transfers with FSx for Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationFsxLustre_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationFsxLustre_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-LocationArn"></a>
更新する FSx for Lustre 転送場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-Subdirectory"></a>
FSx for Lustre ファイルシステムのマウントパスを指定します。パスにはサブディレクトリを含めることができます。  
場所が送信元として使用される場合、DataSync はマウントパスからデータを読み込みます。場所が送信先として使用される場合、DataSync はデータをマウントパスに書き込みます。このパラメータを含めない場合、DataSync はファイルシステムのルートディレクトリ (`/`) を使用します。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationFsxLustre_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationFsxLustre_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationFsxLustre_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) 

# UpdateLocationFsxOntap
<a name="API_UpdateLocationFsxOntap"></a>

で使用している Amazon FSx for NetApp ONTAP 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring transfers with Amazon FSx for NetApp ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationFsxOntap_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationFsxOntap_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-LocationArn"></a>
更新する FSx for ONTAP 転送場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Protocol"></a>
DataSync が Amazon FSx ファイルシステムにアクセスするために使用するデータ転送プロトコルを指定します。  
型: [FsxUpdateProtocol](API_FsxUpdateProtocol.md) オブジェクト  
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Subdirectory"></a>
データの転送先または転送元となるストレージ仮想マシン (SVM) のファイル共有へのパスを指定します。  
ジャンクションパス (マウントポイントとも呼ばれます)、qtree パス (NFS ファイル共有用)、または共有名 (SMB ファイル共有用) を指定できます。例えば、マウントパスは `/vol1`、`/vol1/tree1`、または `/share1` かもしれません。  
SVM のルートボリューム内にはジャンクションパスを指定しないでください。詳細については、「*Amazon FSx for NetApp ONTAP ユーザーガイド*」の「[Managing FSx for ONTAP storage virtual machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html)」を参照してください。
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationFsxOntap_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationFsxOntap_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationFsxOntap_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) 

# UpdateLocationFsxOpenZfs
<a name="API_UpdateLocationFsxOpenZfs"></a>

で使用している Amazon FSx for OpenZFS 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring DataSync transfers with Amazon FSx for OpenZFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html)」を参照してください。

**注記**  
`SMB` に関連するリクエストパラメータは `UpdateLocationFsxOpenZfs` オペレーションではサポートされていません。

## リクエストの構文
<a name="API_UpdateLocationFsxOpenZfs_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationFsxOpenZfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-LocationArn"></a>
更新する FSx for OpenZFS 転送場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Protocol"></a>
 AWS DataSync が Amazon FSx ファイルシステムにアクセスするために使用するデータ転送プロトコルを指定します。  
型: [FsxProtocol](API_FsxProtocol.md) オブジェクト  
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Subdirectory"></a>
`/fsx` で始まる必要がある場所のパス内のサブディレクトリを指定します。DataSync は、このサブディレクトリを使用してデータを読み書きします (ファイルシステムがソースまたは送信先の場所であるかどうかに応じて)。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationFsxOpenZfs_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationFsxOpenZfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationFsxOpenZfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 

# UpdateLocationFsxWindows
<a name="API_UpdateLocationFsxWindows"></a>

で使用している Amazon FSx for Windows File Server 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring transfers with FSx for Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationFsxWindows_RequestSyntax"></a>

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "LocationArn": "string",
   "Password": "string",
   "Subdirectory": "string",
   "User": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationFsxWindows_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CmkSecretConfig"></a>
DataSync が特定の転送場所へのアクセスに使用する `Password`または認証情報のセット、およびカスタマーマネージドなど、DataSync が管理するシークレットの設定情報を指定します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する `Password`または一連の認証情報、およびシークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報を指定します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Domain"></a>
FSx for Windows ファイルサーバーシステムが属する Windows ドメインの名前を指定します。  
環境内に複数の Active Directory ドメインがある場合、このパラメータを設定することで、DataSync が適切なファイルシステムに接続できるようになります。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
必須: いいえ

 ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-LocationArn"></a>
更新する FSx for Windows File Server 転送場所の 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}$`   
必須: はい

 ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Password"></a>
FSx for Windows File Server ファイルシステム内のファイル、フォルダ、ファイルメタデータをマウントしてアクセスできるアクセス許可を持つユーザーのパスワードを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^.{0,104}$`   
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Subdirectory"></a>
スラッシュを使用して、ファイルシステムのマウントパスを指定します。DataSync は、このサブディレクトリを使用してデータを読み書きします (ファイルシステムがソースまたは送信先の場所であるかどうかに応じて)。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

 ** [User](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-User"></a>
FSx for Windows File Server ファイルシステム内のファイル、フォルダ、ファイルメタデータをマウントしてアクセスできるアクセス許可を持つユーザーを指定します。  
転送に適したアクセスレベルのユーザーを選択する方法については、FSx for Windows File Server の場所に「[required permissions](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationFsxWindows_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationFsxWindows_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationFsxWindows_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) 

# UpdateLocationHdfs
<a name="API_UpdateLocationHdfs"></a>

使用している Hadoop Distributed File System (HDFS) 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring AWS DataSync transfers with an HDFS cluster](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationHdfs_RequestSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationHdfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AgentArns"></a>
HDFS クラスターに接続できる DataSync エージェントの Amazon リソースネーム (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](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AuthenticationType"></a>
ユーザーの ID を決定するために使用される認証のタイプ。  
タイプ: 文字列  
有効な値：`SIMPLE | KERBEROS`  
必須: いいえ

 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-BlockSize"></a>
HDFS クラスターに書き込むデータブロックのサイズ。  
タイプ: 整数  
有効範囲: 最小値 は 1,048,576 です。最大値は 1,073,741,824 です。  
必須: いいえ

 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CmkSecretConfig"></a>
DataSync が特定の転送場所へのアクセスに使用する `KerberosKeytab`または認証情報のセット、およびカスタマーマネージドなど、DataSync が管理するシークレットの設定情報を指定します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する `KerberosKeytab`または一連の認証情報、およびシークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報を指定します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKeytab"></a>
定義された Kerberos プリンシパルと暗号化キー間のマッピングを含む Kerberos キーテーブル (キータブ)。ファイルのアドレスを指定して、ファイルからキータブをロードできます。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 65,536 です。  
必須: いいえ

 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKrb5Conf"></a>
Kerberos 構成情報を含む `krb5.conf` ファイル。ファイルのアドレスを指定して、`krb5.conf` ファイルをロードできます。 AWS CLIを使用している場合は、base64 エンコードが実行されます。それ以外の場合は、base64 でエンコードされたテキストを指定します。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 131,072 です。  
必須: いいえ

 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosPrincipal"></a>
HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$`   
必須: いいえ

 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KmsKeyProviderUri"></a>
HDFS クラスターのキー管理サーバー (KMS) の URI。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
必須: いいえ

 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-LocationArn"></a>
ソース HDFS クラスターの場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-NameNodes"></a>
HDFS 名前空間を管理する NameNode。NameNode は、ファイルやディレクトリのオープン、クローズ、名前の変更などの操作を実行します。NameNode には、データのブロックを DataNode にマップするための情報が含まれています。NameNode は 1 つのみを使用できます。  
タイプ: [HdfsNameNode](API_HdfsNameNode.md) オブジェクトの配列  
配列メンバー: 最小数は 1 項目です。  
必須: いいえ

 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-QopConfiguration"></a>
保護の品質 (QOP) 設定では、Hadoop Distributed File System (HDFS) クラスターで構成されたリモートプロシージャコール (RPC) とデータ転送のプライバシー設定を指定します。  
タイプ: [QopConfiguration](API_QopConfiguration.md) オブジェクト  
必須: いいえ

 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-ReplicationFactor"></a>
HDFS クラスターへの書き込み時にデータをレプリケートする DataNode の数。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 512 です。  
必須: いいえ

 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-SimpleUser"></a>
ホストオペレーティングシステム上のクライアントを識別するために使用されるユーザー名。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-Subdirectory"></a>
HDFS クラスター内のサブディレクトリ。このサブディレクトリは、HDFS クラスターからデータを読み取り、または HDFS クラスターにデータを書き込むために使用されます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationHdfs_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationHdfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationHdfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) 

# UpdateLocationNfs
<a name="API_UpdateLocationNfs"></a>

で使用しているネットワークファイルシステム (NFS) 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring AWS DataSync transfers with an NFS file server](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationNfs_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationNfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-LocationArn"></a>
更新する NFS 転送場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-MountOptions"></a>
DataSync が NFS プロトコルを使用して場所にアクセスする方法を指定します。  
タイプ: [NfsMountOptions](API_NfsMountOptions.md) オブジェクト  
必須: いいえ

 ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-OnPremConfig"></a>
Network File System (NFS) ファイルサーバーに接続できる AWS DataSync エージェント。  
型: [OnPremConfig](API_OnPremConfig.md) オブジェクト  
必須: いいえ

 ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-ServerHostname"></a>
DataSync エージェントが接続する NFS ファイルサーバーの DNS 名または IP アドレス (IPv4 または IPv6) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-Subdirectory"></a>
DataSync がマウントする NFS ファイルサーバーのエクスポートパスを指定します。  
このパス (またはパスのサブディレクトリ) は、DataSync のデータ転送先または転送元となる場所です。DataSync のエクスポートの構成については、「[NFS ファイルサーバーへのアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationNfs_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationNfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationNfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) 

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

で使用しているオブジェクトストレージ転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring DataSync transfers with an object storage system](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationObjectStorage_RequestSyntax"></a>

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationObjectStorage_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
オブジェクトストレージサーバーとの認証に認証情報が必要な場合、アクセスキー (ユーザー名など) を指定します。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 200 です。  
パターン: `^.*$`   
必須: いいえ

 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(オプション) オブジェクトストレージシステムに接続できる DataSync エージェントの Amazon リソースネーム (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}$`   
必須: いいえ

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセットなど、DataSync が管理するシークレットと、カスタマー管理の AWS KMS keyの設定情報を指定します。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセット、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報を指定します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
更新するオブジェクトストレージシステムの場所の 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}$`   
必須: はい

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
オブジェクトストレージサーバーとの認証に認証情報が必要な場合、秘密鍵 (パスワードなど) を指定します。  
を使用してシークレットを指定し`SecretKey`、 `CmkSecretConfig`または を使用してシークレット設定の詳細を指定しない場合`CustomSecretConfig`、DataSync は AWS アカウントの Secrets Manager シークレットを使用してトークンを保存します。
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 200 です。  
パターン: `^.*$`   
必須: いいえ

 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
オブジェクトストレージシステムがプライベートまたは自己署名の認証機関 (CA) を使用する場合、DataSync がそのシステムで認証するための証明書チェーンを指定します。完全な証明書チェーンを持つ `.pem` ファイルを 1 つ指定する必要があります (例: `file:///home/user/.ssh/object_storage_certificates.pem`)。  
証明書チェーンには以下が含まれます。  
+ オブジェクトストレージシステムの証明書
+ すべての中間証明書 (存在する場合)
+ 署名 CA のルート証明書
証明書を `.pem` ファイルに連結できます (base64 エンコーディングの前は最大 32,768 バイトまで可能)。次の `cat` コマンド例では、3 つの証明書を含む `object_storage_certificates.pem` ファイルを作成します。  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
このパラメータを使用するには、`ServerProtocol` を `HTTPS` に構成します。  
このパラメータの更新によって、進行中のタスクが妨げられることはありません。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 32,768 です。  
必須: いいえ

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
DataSync エージェントが接続するオブジェクトストレージサーバーのドメイン名または IP アドレス (IPv4 または IPv6) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: いいえ

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
オブジェクトストレージサーバーがインバウンドネットワークトラフィックを受け入れるポート (ポート 443 など) を指定します。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 65,536 です。  
必須: いいえ

 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
オブジェクトストレージサーバーが通信に使用するプロトコルを指定します。  
タイプ: 文字列  
有効な値：`HTTPS | HTTP`  
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
オブジェクトストレージサーバーのオブジェクトプレフィックスを指定します。これがソースの場所である場合、DataSync はこのプレフィックスを持つオブジェクトのみをコピーします。これが送信先の場所である場合、DataSync は、このプレフィックスを持つすべてのオブジェクトを書き込みます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationObjectStorage_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationObjectStorage_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationObjectStorage_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) 

# UpdateLocationS3
<a name="API_UpdateLocationS3"></a>

使用している Amazon S3 転送場所の次の設定パラメータを変更します AWS DataSync。

**重要**  
始める前に、次のトピックをお読みください。  
 [Amazon S3 場所のストレージクラスに関する考慮事項](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [DataSync を使用する場合の S3 リクエストコストの評価](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

## リクエストの構文
<a name="API_UpdateLocationS3_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationS3_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-LocationArn"></a>
更新する Amazon S3 転送場所の Amazon リソースネーム (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}$`   
必須: はい

 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3Config"></a>
DataSync が S3 バケットにアクセスするために使用する AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN) を指定します。  
詳細については、「[Providing DataSync access to S3 buckets](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)」を参照してください。  
型: [S3Config](API_S3Config.md) オブジェクト  
必須: いいえ

 ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3StorageClass"></a>
Amazon S3 が転送先である場合にオブジェクトで使用するストレージクラスを指定します。  
のバケットの場合 AWS リージョン、ストレージクラスはデフォルトで になります`STANDARD`。上のバケットの場合 AWS Outposts、ストレージクラスはデフォルトで になります`OUTPOSTS`。  
詳細については、「[Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。  
タイプ: 文字列  
有効な値：`STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`  
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-Subdirectory"></a>
DataSync が読み書きする S3 バケットのプレフィックスを指定します (バケットがソースまたは送信先の場所であるかどうかに応じて)。  
DataSync は、スラッシュ (`/`) で始まるプレフィックス、または `//`、`/./`、または `/../` パターンを含むプレフィックスを持つオブジェクトを転送できません。例えば、次のようになります。  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationS3_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationS3_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationS3_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) 

# UpdateLocationSmb
<a name="API_UpdateLocationSmb"></a>

で使用しているサーバーメッセージブロック (SMB) 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring AWS DataSync transfers with an SMB file server](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html)」を参照してください。

## リクエストの構文
<a name="API_UpdateLocationSmb_RequestSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "Password": "string",
   "ServerHostname": "string",
   "Subdirectory": "string",
   "User": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateLocationSmb_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AgentArns"></a>
SMB ファイルサーバーに接続可能な DataSync エージェント (1 つまたは複数) を指定します。エージェントは、Amazon リソースネーム (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](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AuthenticationType"></a>
DataSync が SMB ファイルサーバーへの接続に使用する認証プロトコルを指定します。DataSync は `NTLM` (デフォルト) と `KERBEROS` 認証をサポートしています。  
詳細については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。  
型: 文字列  
有効な値：`NTLM | KERBEROS`  
必須：いいえ

 ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CmkSecretConfig"></a>
DataSync が特定の転送場所へのアクセスに使用する `Password``KerberosKeytab`または 認証情報のセット、およびカスタマーマネージドなど、DataSync が管理するシークレットの設定情報を指定します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する `Password``KerberosKeytab`または 認証情報のセット、およびシークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報を指定します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-DnsIpAddresses"></a>
SMB ファイルサーバーが属する DNS サーバーの IP アドレス (IPv4 または IPv6) を指定します。このパラメータは、`AuthenticationType` が `KERBEROS` に設定されている場合にのみ適用されます。  
環境内に複数のドメインがある場合、このパラメータを構成することで、DataSync が適切な SMB ファイルサーバーに接続できるようになります。  
型: 文字列の配列  
配列メンバー: 最大数は 2 項目です。  
長さの制限: 最小長は 7 です。最大長は 39 です。  
パターン: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z`   
必須: いいえ

 ** [Domain](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Domain"></a>
SMB ファイルサーバーが属する Windows ドメイン名を指定します。このパラメータは、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
環境内に複数のドメインがある場合、このパラメータを構成することで、DataSync が適切なファイルサーバーに接続できるようになります。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
必須: いいえ

 ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKeytab"></a>
Kerberos キーテーブル (keytab) ファイルを指定します。これには、Kerberos プリンシパルと暗号化キー間のマッピングが含まれます。  
タスク実行エラーを回避するには、キータブファイルの作成に使用する Kerberos プリンシパルが、`KerberosPrincipal` に指定した内容と正確に一致していることを確認します。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 65,536 です。  
必須: いいえ

 ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKrb5Conf"></a>
Kerberos 領域設定を定義する Kerberos 設定ファイル (`krb5.conf`) を指定します。  
ファイルは base64 でエンコードされている必要があります。を使用している場合は AWS CLI、エンコードが自動的に行われます。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 131,072 です。  
必須: いいえ

 ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosPrincipal"></a>
Kerberos プリンシパルを指定します。これは、SMB ファイルサーバーのファイル、フォルダ、ファイルメタデータにアクセスする権限を持つ Kerberos 領域内の ID です。  
Kerberos プリンシパルは `HOST/kerberosuser@MYDOMAIN.ORG` のようになります。  
プリンシパル名では大文字と小文字が区別されます。このパラメータに指定したプリンシパルが、キータブファイルの作成に使用するプリンシパルと完全に一致しない場合、DataSync タスク実行は失敗します。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$`   
必須: いいえ

 ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-LocationArn"></a>
更新する SMB の場所の 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}$`   
必須: はい

 ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-MountOptions"></a>
が SMB ファイルサーバーにアクセス AWS DataSync するために使用するサーバーメッセージブロック (SMB) プロトコルのバージョンを指定します。  
型: [SmbMountOptions](API_SmbMountOptions.md) オブジェクト  
必須: いいえ

 ** [Password](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Password"></a>
SMB ファイルサーバーをマウントでき、転送するファイルとフォルダにアクセスできるユーザーのパスワード。このパラメータは、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^.{0,104}$`   
必須: いいえ

 ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-ServerHostname"></a>
DataSync エージェントが接続する SMB ファイルサーバーのドメイン名または IP アドレス (IPv4 または IPv6) を指定します。  
Kerberos 認証を使用している場合は、ドメイン名を指定する必要があります。
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Subdirectory"></a>
DataSync がデータを読み書記する SMB ファイルサーバーによってエクスポートされる共有の名前を指定します。共有パスにはサブディレクトリ (例: `/path/to/subdirectory`) を含めることができます。ネットワーク内の他の SMB クライアントもこのパスをマウントできることを確認してください。  
指定したサブディレクトリ内のすべてのデータをコピーするには、DataSync が SMB 共有をマウントして、そのすべてのデータにアクセスできる必要があります。詳細については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

 ** [User](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-User"></a>
SMB ファイルサーバーをマウントでき、転送に関係するファイルやフォルダにアクセスする権限を持つユーザー名を指定します。このパラメータは、`AuthenticationType` が `NTLM` に設定されている場合にのみ適用されます。  
転送に適したアクセスレベルを持つユーザーを選択する方法については、「[Providing DataSync access to SMB file servers](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
必須: いいえ

## レスポンス要素
<a name="API_UpdateLocationSmb_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateLocationSmb_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateLocationSmb_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) 

# UpdateTask
<a name="API_UpdateTask"></a>

*タスク*の設定を更新し、 AWS DataSync がデータを転送する場所と方法を定義します。

## リクエストの構文
<a name="API_UpdateTask_RequestSyntax"></a>

```
{
   "CloudWatchLogGroupArn": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "TaskArn": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## リクエストパラメーター
<a name="API_UpdateTask_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-CloudWatchLogGroupArn"></a>
タスクをモニタリングするための Amazon CloudWatch ロググループの Amazon リソースネーム (ARN) を指定します。  
拡張モードタスクでは、ロググループ名として `/aws/datasync` を使用する必要があります。例えば、次のようになります。  
 `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`   
詳細については、「[Monitoring data transfers with Amazon CloudWatch Logs](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 562 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
必須: いいえ

 ** [Excludes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Excludes"></a>
DataSync に転送してほしくないソースの場所内のファイル、オブジェクト、フォルダを定義する除外フィルターを指定します。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。  
必須: いいえ

 ** [Includes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Includes"></a>
包含フィルターを指定して、DataSync が転送するソースの場所内のファイル、オブジェクト、フォルダを定義します。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。  
必須: いいえ

 ** [ManifestConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-ManifestConfig"></a>
DataSync が転送するファイルまたはオブジェクトのリストであるマニフェストを設定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。  
このパラメータを使用する場合、発信者 ID (DataSync を使用している IAM ロール) には `iam:PassRole` アクセス許可が必要です。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) ポリシーには、このアクセス許可が含まれています。  
マニフェスト設定を削除するには、このパラメータを空として指定します。  
タイプ: [ManifestConfig](API_ManifestConfig.md) オブジェクト  
必須: いいえ

 ** [Name](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Name"></a>
タスクの名前を指定します。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

 ** [Options](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Options"></a>
転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。  
各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。  
これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。  
タイプ: [Options](API_Options.md) オブジェクト  
必須: いいえ

 ** [Schedule](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Schedule"></a>
タスクを実行するスケジュールを指定します。詳細については、「[タスクのスケジュール](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)」を参照してください。  
タイプ: [TaskSchedule](API_TaskSchedule.md) オブジェクト  
必須: いいえ

 ** [TaskArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskArn"></a>
更新したいタスクの ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
必須: はい

 ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskReportConfig"></a>
DataSync 転送に関する詳細情報を提供するタスクレポートの構成方法を指定します。詳細については、「[Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
このパラメータを使用する場合、発信者 ID (DataSync を使用している IAM ロール) には `iam:PassRole` アクセス許可が必要です。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) ポリシーには、このアクセス許可が含まれています。  
タスクレポート設定を削除するには、このパラメータを空として指定します。  
タイプ: [TaskReportConfig](API_TaskReportConfig.md) オブジェクト  
必須: いいえ

## レスポンス要素
<a name="API_UpdateTask_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateTask_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateTask_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) 

# UpdateTaskExecution
<a name="API_UpdateTaskExecution"></a>

実行中の AWS DataSync タスク実行の設定を更新します。

**注記**  
現在、`UpdateTaskExecution` で変更できる `Option` は ` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) ` のみで、これは実行中またはキューに入っているタスク実行の帯域幅を調整します。

## リクエストの構文
<a name="API_UpdateTaskExecution_RequestSyntax"></a>

```
{
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "TaskExecutionArn": "string"
}
```

## リクエストパラメーター
<a name="API_UpdateTaskExecution_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [Options](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-Options"></a>
転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。  
各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。  
これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。  
タイプ: [Options](API_Options.md) オブジェクト  
必須: はい

 ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-TaskExecutionArn"></a>
更新するタスク実行の Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
必須: はい

## レスポンス要素
<a name="API_UpdateTaskExecution_ResponseElements"></a>

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

## エラー
<a name="API_UpdateTaskExecution_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateTaskExecution_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) 

# データ型
<a name="API_Types"></a>

以下のデータ型 (タイプ) がサポートされています。
+  [AgentListEntry](API_AgentListEntry.md) 
+  [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) 
+  [CmkSecretConfig](API_CmkSecretConfig.md) 
+  [CustomSecretConfig](API_CustomSecretConfig.md) 
+  [Ec2Config](API_Ec2Config.md) 
+  [FilterRule](API_FilterRule.md) 
+  [FsxProtocol](API_FsxProtocol.md) 
+  [FsxProtocolNfs](API_FsxProtocolNfs.md) 
+  [FsxProtocolSmb](API_FsxProtocolSmb.md) 
+  [FsxUpdateProtocol](API_FsxUpdateProtocol.md) 
+  [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) 
+  [HdfsNameNode](API_HdfsNameNode.md) 
+  [LocationFilter](API_LocationFilter.md) 
+  [LocationListEntry](API_LocationListEntry.md) 
+  [ManagedSecretConfig](API_ManagedSecretConfig.md) 
+  [ManifestConfig](API_ManifestConfig.md) 
+  [NfsMountOptions](API_NfsMountOptions.md) 
+  [OnPremConfig](API_OnPremConfig.md) 
+  [Options](API_Options.md) 
+  [Platform](API_Platform.md) 
+  [PrivateLinkConfig](API_PrivateLinkConfig.md) 
+  [QopConfiguration](API_QopConfiguration.md) 
+  [ReportDestination](API_ReportDestination.md) 
+  [ReportDestinationS3](API_ReportDestinationS3.md) 
+  [ReportOverride](API_ReportOverride.md) 
+  [ReportOverrides](API_ReportOverrides.md) 
+  [ReportResult](API_ReportResult.md) 
+  [S3Config](API_S3Config.md) 
+  [S3ManifestConfig](API_S3ManifestConfig.md) 
+  [SmbMountOptions](API_SmbMountOptions.md) 
+  [SourceManifestConfig](API_SourceManifestConfig.md) 
+  [TagListEntry](API_TagListEntry.md) 
+  [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) 
+  [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) 
+  [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) 
+  [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) 
+  [TaskExecutionListEntry](API_TaskExecutionListEntry.md) 
+  [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) 
+  [TaskFilter](API_TaskFilter.md) 
+  [TaskListEntry](API_TaskListEntry.md) 
+  [TaskReportConfig](API_TaskReportConfig.md) 
+  [TaskSchedule](API_TaskSchedule.md) 
+  [TaskScheduleDetails](API_TaskScheduleDetails.md) 

# AgentListEntry
<a name="API_AgentListEntry"></a>

[ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html) オペレーションを呼び出すときに、 AWS DataSync エージェントのリスト (または配列) 内の 1 つのエントリを表します。

## 内容
<a name="API_AgentListEntry_Contents"></a>

 ** AgentArn **   <a name="DataSync-Type-AgentListEntry-AgentArn"></a>
DataSync エージェントの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 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}$`   
必須: いいえ

 ** Name **   <a name="DataSync-Type-AgentListEntry-Name"></a>
エージェントの名前。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

 ** Platform **   <a name="DataSync-Type-AgentListEntry-Platform"></a>
バージョン番号など、エージェントに関するプラットフォーム関連の詳細。  
型: [Platform](API_Platform.md) オブジェクト  
必須: いいえ

 ** Status **   <a name="DataSync-Type-AgentListEntry-Status"></a>
エージェントのステータス。  
+ ステータスが `ONLINE` の場合、エージェントは適切に構成されており、使用可能です。
+ ステータスが `OFFLINE` の場合、エージェントは DataSync と 5 分以上通信していません。これは、いくつかの理由で発生する可能性があります。詳細については、「[エージェントがオフラインの場合の対処方法](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline)」を参照してください。
タイプ: 文字列  
有効な値：`ONLINE | OFFLINE`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_AgentListEntry_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) 

# AzureBlobSasConfiguration
<a name="API_AzureBlobSasConfiguration"></a>

AWS DataSync が Microsoft Azure Blob ストレージへのアクセスを許可する共有アクセス署名 (SAS) 構成。

詳細については、「Azure Blob ストレージにアクセスするための [SAS トークン](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens)」を参照してください。

## 内容
<a name="API_AzureBlobSasConfiguration_Contents"></a>

 ** Token **   <a name="DataSync-Type-AzureBlobSasConfiguration-Token"></a>
Azure Blob ストレージにアクセスするためのアクセス許可を提供する SAS トークンを指定します。  
このトークンは、ストレージリソース URI と疑問符の後の SAS URI 文字列の一部です。トークンは以下のようになります。  
 `sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D`   
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `^.+$`   
必須: はい

## 以下の資料も参照してください。
<a name="API_AzureBlobSasConfiguration_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) 

# CmkSecretConfig
<a name="API_CmkSecretConfig"></a>

DataSync が特定のストレージロケーションへのアクセスに使用する認証トークン、シークレットキー、パスワード、Kerberos キータブなど、DataSync が管理するシークレットの設定情報をカスタマーマネージドで指定します AWS KMS key。

**注記**  
`CmkSecretConfig` または `CustomSecretConfig` を使用して、`CreateLocation` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。

## 内容
<a name="API_CmkSecretConfig_Contents"></a>

 ** KmsKeyArn **   <a name="DataSync-Type-CmkSecretConfig-KmsKeyArn"></a>
DataSync が に保存 AWS KMS key されている DataSync 管理シークレットを暗号化するために使用するカスタマー管理の ARN を指定します`SecretArn`。DataSync はこのキーを に提供します AWS Secrets Manager。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$`   
必須: いいえ

 ** SecretArn **   <a name="DataSync-Type-CmkSecretConfig-SecretArn"></a>
特定のストレージロケーションへのアクセスに使用される DataSync マネージド AWS Secrets Manager シークレットの ARN を指定します。このプロパティは DataSync によって生成され、読み取り専用です。DataSync は、`KmsKeyArn` に指定した KMS キーを使用してこのシークレットを暗号化します。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_CmkSecretConfig_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) 

# CustomSecretConfig
<a name="API_CustomSecretConfig"></a>

ストレージロケーション認証情報が Secrets Manager にプレーンテキスト (認証トークン、シークレットキー、またはパスワードの場合) またはバイナリ (Kerberos キータブの場合) として保存されている、カスタマー管理の Secrets Manager シークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。

**注記**  
`CmkSecretConfig` または `CustomSecretConfig` を使用して、`CreateLocation` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。

## 内容
<a name="API_CustomSecretConfig_Contents"></a>

 ** SecretAccessRoleArn **   <a name="DataSync-Type-CustomSecretConfig-SecretAccessRoleArn"></a>
DataSync が に指定されたシークレットにアクセスするために使用する AWS Identity and Access Management ロールの ARN を指定します`SecretArn`。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$`   
必須: いいえ

 ** SecretArn **   <a name="DataSync-Type-CustomSecretConfig-SecretArn"></a>
 AWS Secrets Manager シークレットの ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_CustomSecretConfig_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) 

# Ec2Config
<a name="API_Ec2Config"></a>

 AWS DataSync が Amazon EFS ファイルシステムの[マウントターゲット](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)の 1 つに接続するために使用するサブネットとセキュリティグループ。

## 内容
<a name="API_Ec2Config_Contents"></a>

 ** SecurityGroupArns **   <a name="DataSync-Type-Ec2Config-SecurityGroupArns"></a>
Amazon EFS ファイルシステムのマウントターゲットに関連付けられているセキュリティグループの Amazon リソースネーム (ARN) を指定します。  
型: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大数は 5 項目です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: はい

 ** SubnetArn **   <a name="DataSync-Type-Ec2Config-SubnetArn"></a>
DataSync が転送中のトラフィックを管理するために作成する[ネットワークインターフェース](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces)の場所となるサブネットの ARN を指定します。  
サブネットは次の場所にある必要があります。  
+ Amazon EFS ファイルシステムと同じ仮想プライベートクラウド (VPC) 内。
+ Amazon EFS ファイルシステムのマウントターゲットの少なくとも 1 つと同じアベイラビリティーゾーン内。
ファイルシステムのマウントターゲットが含まれるサブネットを指定する必要はありません。
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
必須: はい

## 以下の資料も参照してください。
<a name="API_Ec2Config_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) 

# FilterRule
<a name="API_FilterRule"></a>

ソースから転送先にファイルを転送するときに、どのファイル、フォルダ、オブジェクトを含めるか、または除外するかを指定します。

## 内容
<a name="API_FilterRule_Contents"></a>

 ** FilterType **   <a name="DataSync-Type-FilterRule-FilterType"></a>
適用するフィルタールールのタイプ。AWS DataSyncは、SIMPLE\$1PATTERN ルールタイプのみをサポートします。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^[A-Z0-9_]+$`   
有効な値：`SIMPLE_PATTERN`  
必須：いいえ

 ** Value **   <a name="DataSync-Type-FilterRule-Value"></a>
含めるまたは除外するパターンから構成される単一のフィルター文字列。パターンは「\$1」(パイプ) で区切られます。例えば: `/folder1|/folder2`   
   
タイプ: 文字列  
長さの制限: 最大長は102400です。  
パターン: `^[^\x00]+$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FilterRule_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) 

# FsxProtocol
<a name="API_FsxProtocol"></a>

AWS DataSync が Amazon FSx ファイルシステムにアクセスするために使用するデータ転送プロトコルを指定します。

## 内容
<a name="API_FsxProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxProtocol-NFS"></a>
DataSync が FSx for OpenZFS ファイル システムまたは FSx for ONTAP ファイル システムのストレージ仮想マシン (SVM) にアクセスするために使用するネットワーク ファイル システム (NFS) プロトコル構成を指定します。  
型: [FsxProtocolNfs](API_FsxProtocolNfs.md) オブジェクト  
必須: いいえ

 ** SMB **   <a name="DataSync-Type-FsxProtocol-SMB"></a>
DataSync が FSx for ONTAP ファイルシステム上の SVM にアクセスするために使用する Server Message Block (SMB) プロトコル構成を指定します。  
型: [FsxProtocolSmb](API_FsxProtocolSmb.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FsxProtocol_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) 

# FsxProtocolNfs
<a name="API_FsxProtocolNfs"></a>

DataSync が FSx for OpenZFS ファイル システムまたは FSx for ONTAP ファイル システムのストレージ仮想マシン (SVM) にアクセスするために使用するネットワーク ファイル システム (NFS) プロトコル構成を指定します。

## 内容
<a name="API_FsxProtocolNfs_Contents"></a>

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolNfs-MountOptions"></a>
DataSync が NFS プロトコルを使用して場所にアクセスする方法を指定します。  
タイプ: [NfsMountOptions](API_NfsMountOptions.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FsxProtocolNfs_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) 

# FsxProtocolSmb
<a name="API_FsxProtocolSmb"></a>

が Amazon FSx for NetApp ONTAP ファイルシステムのストレージ仮想マシン (SVM) にアクセス AWS DataSync するために使用するサーバーメッセージブロック (SMB) プロトコル設定を指定します。詳細については、「[Providing DataSync access to FSx for ONTAP file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)」を参照してください。

## 内容
<a name="API_FsxProtocolSmb_Contents"></a>

 ** User **   <a name="DataSync-Type-FsxProtocolSmb-User"></a>
マウントし、SVM で必要なファイル、フォルダ、およびメタデータにアクセスできるユーザーを指定します。  
転送に適したアクセスレベルを持つユーザーを選択する方法については、「[Using the SMB protocol](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
必須: はい

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CmkSecretConfig"></a>
DataSync が管理するシークレットの設定情報を指定します。これには、DataSync がカスタマー管理の特定の FSx for ONTAP ストレージロケーション (SMB を使用) にアクセスするために使用するパスワードが含まれます AWS KMS key。  
このパラメータを`CreateLocationFsxOntap`リクエストの一部として含める場合は、KMS キー ARN のみを指定します。DataSync は、この KMS キーを に`Password`指定した とともに使用して、ロケーションアクセス認証情報を保存する DataSync マネージドシークレットを作成します。  
DataSync に、指定した KMS キーへのアクセス許可があることを確認します。詳細については、[「カスタムで暗号化されたサービスマネージドシークレットの使用 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`Password` あり) または `CustomSecretConfig` (`Password` なし) を使用して、`CreateLocationFsxOntap` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CustomSecretConfig"></a>
FSx for ONTAP ストレージの場所 (SMB を使用) のパスワードが Secrets Manager にプレーンテキストで保存される、カスタマー管理の Secrets Manager シークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。詳細については、[「管理するシークレットの使用](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key)」を参照してください。  
`CmkSecretConfig` (`Password` あり) または `CustomSecretConfig` (`Password` なし) を使用して、`CreateLocationFsxOntap` リクエストの認証情報を指定できます。同じリクエストに対して両方のパラメータを指定しないでください。
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** Domain **   <a name="DataSync-Type-FsxProtocolSmb-Domain"></a>
ストレージ仮想マシン (SVM) が属する Windows ドメインの名前を指定します。  
環境内に複数のドメインがある場合、この設定を構成すると、DataSync が正しい SVM に接続されるようになります。  
環境内に複数の Active Directory ドメインがある場合、このパラメータを構成することで、DataSync が適切な SVM に接続できるようになります。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
必須: いいえ

 ** ManagedSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-ManagedSecretConfig"></a>
DataSync が特定のストレージロケーションにアクセスするために使用する など、`Password`DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。  
`CreateLocation` これをリクエストに指定しないでください。 `ManagedSecretConfig`は ReadOnly プロパティであり、`DescribeLocation`レスポンスにのみ入力されます。
型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト  
必須: いいえ

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolSmb-MountOptions"></a>
が SMB ファイルサーバーにアクセス AWS DataSync するために使用するサーバーメッセージブロック (SMB) プロトコルのバージョンを指定します。  
型: [SmbMountOptions](API_SmbMountOptions.md) オブジェクト  
必須: いいえ

 ** Password **   <a name="DataSync-Type-FsxProtocolSmb-Password"></a>
SVM にアクセスする権限を持つユーザーのパスワードを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^.{0,104}$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FsxProtocolSmb_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) 

# FsxUpdateProtocol
<a name="API_FsxUpdateProtocol"></a>

AWS DataSync が Amazon FSx ファイルシステムにアクセスするために使用するデータ転送プロトコルを指定します。

**注記**  
FSx for ONTAP ロケーションのネットワークファイルシステム (NFS) プロトコル構成を更新することはできません。DataSync は現在、このロケーションタイプで NFS バージョン 3 のみをサポートしています。

## 内容
<a name="API_FsxUpdateProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxUpdateProtocol-NFS"></a>
DataSync が FSx for OpenZFS ファイル システムまたは FSx for ONTAP ファイル システムのストレージ仮想マシン (SVM) にアクセスするために使用するネットワーク ファイル システム (NFS) プロトコル構成を指定します。  
型: [FsxProtocolNfs](API_FsxProtocolNfs.md) オブジェクト  
必須: いいえ

 ** SMB **   <a name="DataSync-Type-FsxUpdateProtocol-SMB"></a>
DataSync が FSx for ONTAP ファイルシステム上のストレージ仮想マシン (SVM) にアクセスするために使用する Server Message Block (SMB) プロトコル構成を指定します。  
型: [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FsxUpdateProtocol_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) 

# FsxUpdateProtocolSmb
<a name="API_FsxUpdateProtocolSmb"></a>

が Amazon FSx for NetApp ONTAP ファイルシステムのストレージ仮想マシン (SVM) にアクセス AWS DataSync するために使用するサーバーメッセージブロック (SMB) プロトコル設定を指定します。詳細については、「[Providing DataSync access to FSx for ONTAP file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)」を参照してください。

## 内容
<a name="API_FsxUpdateProtocolSmb_Contents"></a>

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CmkSecretConfig"></a>
DataSync が特定の転送場所へのアクセスに使用する `Password`または認証情報のセット、およびカスタマーマネージドなど、DataSync が管理するシークレットの設定情報を指定します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する `Password`または一連の認証情報など、カスタマーマネージドシークレットの設定情報を指定します。この設定には、シークレット ARN、およびシークレットへのアクセスを提供する IAM ロールの ARN が含まれます。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** Domain **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Domain"></a>
ストレージ仮想マシン (SVM) が属する Windows ドメインの名前を指定します。  
環境内に複数の Active Directory ドメインがある場合、このパラメータを構成することで、DataSync が適切な SVM に接続できるようになります。  
タイプ: 文字列  
長さの制約: 最大長は 253 です。  
パターン: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
必須: いいえ

 ** MountOptions **   <a name="DataSync-Type-FsxUpdateProtocolSmb-MountOptions"></a>
が SMB ファイルサーバーにアクセス AWS DataSync するために使用するサーバーメッセージブロック (SMB) プロトコルのバージョンを指定します。  
型: [SmbMountOptions](API_SmbMountOptions.md) オブジェクト  
必須: いいえ

 ** Password **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Password"></a>
SVM にアクセスする権限を持つユーザーのパスワードを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^.{0,104}$`   
必須: いいえ

 ** User **   <a name="DataSync-Type-FsxUpdateProtocolSmb-User"></a>
マウントし、SVM で必要なファイル、フォルダ、およびメタデータにアクセスできるユーザーを指定します。  
転送に適したアクセスレベルを持つユーザーを選択する方法については、「[Using the SMB protocol](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 104 です。  
パターン: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_FsxUpdateProtocolSmb_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) 

# HdfsNameNode
<a name="API_HdfsNameNode"></a>

Hadoop 分散ファイルシステム (HDFS) のネームノード。ネームノード は、ファイルシステムの名前空間を管理します。ネームノード は、ファイルやディレクトリのオープン、クローズ、名前の変更などの操作を実行します。ネームノード には、データのブロックを データノード にマップするための情報が含まれています。

## 内容
<a name="API_HdfsNameNode_Contents"></a>

 ** Hostname **   <a name="DataSync-Type-HdfsNameNode-Hostname"></a>
HDFS クラスター内の ネームノード のホスト名。この値は、ネームノードの IP アドレスまたはドメインネームサービス (DNS) 名です。オンプレミスにインストールされたエージェントは、このホスト名を使用してネットワーク内の ネームノード と通信します。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$`   
必須: はい

 ** Port **   <a name="DataSync-Type-HdfsNameNode-Port"></a>
ネームノード がクライアントの要求をリッスンするために使用するポート。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 65,536 です。  
必須: はい

## 以下の資料も参照してください。
<a name="API_HdfsNameNode_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) 

# LocationFilter
<a name="API_LocationFilter"></a>

`ListLocations` が返すリソースのリストを絞り込みます。たとえば、Amazon S3 のすべてのロケーションを表示するには、`"Name": "LocationType"`、`"Operator": "Equals"`、`"Values": "S3"`を使用してフィルターを作成します。

詳細については、「[リソースのフィルタリング](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html)」を参照してください。

## 内容
<a name="API_LocationFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-LocationFilter-Name"></a>
使用されているフィルタの名前。各 API コールでは、使用可能なフィルタのリストがサポートされています（たとえば、`LocationType`にとって`ListLocations`)。  
型: 文字列  
有効な値：`LocationUri | LocationType | CreationTime`  
必須: はい

 ** Operator **   <a name="DataSync-Type-LocationFilter-Operator"></a>
フィルタ値の比較に使用される演算子 (たとえば、`Equals`または`Contains`)。  
型: 文字列  
有効な値：`Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`  
必須: はい

 ** Values **   <a name="DataSync-Type-LocationFilter-Values"></a>
フィルタする値。たとえば、Amazon S3 ロケーションのみを表示することができます。  
型: 文字列の配列  
長さの制限：最小長 1、最大長は 255 です。  
パターン: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
必須: はい

## 以下の資料も参照してください。
<a name="API_LocationFilter_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) 

# LocationListEntry
<a name="API_LocationListEntry"></a>

ロケーションのリスト内にある単一のエントリを表します。[ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)オペレーションが呼び出されると、`LocationListEntry`はロケーションのリストを含む配列を返します。

## 内容
<a name="API_LocationListEntry_Contents"></a>

 ** LocationArn **   <a name="DataSync-Type-LocationListEntry-LocationArn"></a>
そのロケーションの Amazon リソースネーム (ARN)。ネットワークファイルシステム (NFS) または Amazon EFS の場合、ロケーションはエクスポートパスです。 Amazon S3の場合、ロケーションは、マウントしてルートとして使用するプレフィックスパスです。  
タイプ: 文字列  
長さの制約: 最大長は 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}$`   
必須: いいえ

 ** LocationUri **   <a name="DataSync-Type-LocationListEntry-LocationUri"></a>
ロケーションの URI のリストを表します。[ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)オペレーションが呼び出されると、`LocationUri` はロケーションのリストを含む配列を返します。  
形式: `TYPE://GLOBAL_ID/SUBDIR`。  
TYPE はロケーションのタイプ (たとえば `nfs`、または `s3`) を指定します。  
GLOBAL\$1ID は、ロケーションをバックアップするリソースのグローバルに一意の識別子です。EFSの例は`us-east-2.fs-abcd1234`のとおりです。Amazon S3 の例としては、`myBucket`のようなバケット名があります。NFS の例には、有効な IPv4 もしくは IPv6 アドレス、または DNS に準拠したホスト名があります。  
SUBDIR は有効なファイルシステムパスで、\$1nix の規則に従ってスラッシュで区切られます。NFS および Amazon EFS の場合、ロケーションをマウントするためのエクスポートパスです。 Amazon S3の場合、マウント先のプレフィックスパスであり、ロケーションのルートとして扱います。  
  
タイプ: 文字列  
長さの制約: 最大長は 4,360 です。  
パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_LocationListEntry_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) 

# ManagedSecretConfig
<a name="API_ManagedSecretConfig"></a>

DataSync が特定の転送場所にアクセスするために使用する認証トークンや認証情報のセットなど、DataSync が管理するシークレットの設定情報を指定します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。

## 内容
<a name="API_ManagedSecretConfig_Contents"></a>

 ** SecretArn **   <a name="DataSync-Type-ManagedSecretConfig-SecretArn"></a>
 AWS Secrets Manager シークレットの ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ManagedSecretConfig_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) 

# ManifestConfig
<a name="API_ManifestConfig"></a>

AWS DataSync に転送してほしいファイルまたはオブジェクトのリストであるマニフェストを設定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。

## 内容
<a name="API_ManifestConfig_Contents"></a>

 ** Action **   <a name="DataSync-Type-ManifestConfig-Action"></a>
DataSync がマニフェストを使用するものを指定します。  
型: 文字列  
有効な値：`TRANSFER`  
必須: いいえ

 ** Format **   <a name="DataSync-Type-ManifestConfig-Format"></a>
マニフェストのファイル形式を指定します。詳細については、「[マニフェストファイル作成](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create)」を参照してください。  
型: 文字列  
有効な値：`CSV`  
必須: いいえ

 ** Source **   <a name="DataSync-Type-ManifestConfig-Source"></a>
DataSync で使用するマニフェストと、それがホストされている場所を指定します。  
2024 年 2 月 7 日以降に新しいマニフェストを設定する場合は、このパラメータを指定する必要があります。  
そうしないと、マニフェストをホストしている S3 バケットにアクセスするための DataSync の IAM ロールが欠落していることを示す 400 のステータスコードと `ValidationException` エラーが表示されます。詳細については、「[Providing DataSync access to your manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access)」を参照してください。
型: [SourceManifestConfig](API_SourceManifestConfig.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ManifestConfig_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) 

# NfsMountOptions
<a name="API_NfsMountOptions"></a>

DataSync が NFS プロトコルを使用して場所にアクセスする方法を指定します。

## 内容
<a name="API_NfsMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-NfsMountOptions-Version"></a>
NFS 共有をマウントするときに、DataSync が使用する NFS バージョンを指定します。サーバーが指定されたバージョンの使用を拒否すると、同期は失敗します。  
以下のオプションを指定できます。  
+  `AUTOMATIC` (デフォルト): DataSync は NFS バージョン 4.1 を選択します。
+  `NFS3`: サーバーへの非同期書き込みを可能にするステートレスのプロトコルバージョン。
+  `NFSv4_0`: 委任と擬似ファイルシステムをサポートする、ステートフルファイアウォール対応プロトコルバージョン。
+  `NFSv4_1`: セッション、ディレクトリ委任、並列データ処理をサポートする、ステートフルのプロトコルバージョン。NFS バージョン 4.1 には、バージョン 4.0 で利用できるすべての機能も含まれています。
DataSync は現在、Amazon FSx for NetApp ONTAP ロケーションにおいて NFS バージョン 3 のみをサポートしています。
型: 文字列  
有効な値：`AUTOMATIC | NFS3 | NFS4_0 | NFS4_1`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_NfsMountOptions_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) 

# OnPremConfig
<a name="API_OnPremConfig"></a>

ネットワークファイルシステム (NFS) ファイルサーバーに接続できる AWS DataSync エージェント。

## 内容
<a name="API_OnPremConfig_Contents"></a>

 ** AgentArns **   <a name="DataSync-Type-OnPremConfig-AgentArns"></a>
NFS ファイルサーバーに接続できる DataSync エージェントの Amazon リソースネーム (ARN)。  
複数のエージェントを指定できます。詳細については、「[Using multiple DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents)」を参照してください。  
型: 文字列の配列  
配列メンバー: 最小数は 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}$`   
必須: はい

## 以下の資料も参照してください。
<a name="API_OnPremConfig_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) 

# Options
<a name="API_Options"></a>

転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。

各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。

これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。

## 内容
<a name="API_Options_Contents"></a>

 ** Atime **   <a name="DataSync-Type-Options-Atime"></a>
ファイルに読み取りまたは書き込みが行われた最終日時を示すメタデータを保存するかどうかを指定します。  
ただし、`Atime` の動作はプラットフォーム間の完全な標準ではないため、DataSync はあくまでベストエフォートベースでこれを行います。
+  `BEST_EFFORT` (デフォルト) - DataSync はすべてのソースファイルで元の `Atime` 属性を保持しようとします (つまり、タスク実行の `PREPARING` ステップより前のバージョン)。このオプションは推奨されています。
+  `NONE` - `Atime` を無視します。
`Atime` が `BEST_EFFORT` に設定されている場合は `Mtime` は `PRESERVE` に設定する必要があります。  
`Atime` が `NONE` に設定されている場合は `Mtime` も `NONE` に設定する必要があります。
型: 文字列  
有効な値：`NONE | BEST_EFFORT`  
必須: いいえ

 ** BytesPerSecond **   <a name="DataSync-Type-Options-BytesPerSecond"></a>
DataSync タスクで使用される帯域幅を制限します。例えば、DataSync で最大 1 MB を使用する場合は、この値を `1048576` (`=1024*1024`) に設定します。  
型: 長整数  
有効な範囲: 最小値は -1 です。  
必須: いいえ

 ** Gid **   <a name="DataSync-Type-Options-Gid"></a>
ファイル所有者の POSIX グループ ID (GID) を指定します。  
+  `INT_VALUE` (デフォルト) - ユーザー ID (UID) と GID の整数値を保持します (推奨)。
+  `NONE` - UID と GID を無視します。
詳細については、「[Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)」を参照してください。  
型: 文字列  
有効な値：`NONE | INT_VALUE | NAME | BOTH`  
必須: いいえ

 ** LogLevel **   <a name="DataSync-Type-Options-LogLevel"></a>
DataSync が Amazon CloudWatch Logs ロググループに公開する、ログのタイプを指定します。ロググループを指定するには、「[CloudWatchLogGroupAn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn)」を参照してください。  
+  `BASIC` - 基本情報 (転送エラーなど) のみを含むログを発行します。
+  `TRANSFER` - DataSync タスクが転送するすべてのファイルまたはオブジェクトのログを発行し、データ整合性チェックを実行します。
+  `OFF` - ログは公開されません。
型: 文字列  
有効な値：`OFF | BASIC | TRANSFER`  
必須：いいえ

 ** Mtime **   <a name="DataSync-Type-Options-Mtime"></a>
タスク実行の `PREPARING` ステップより前にファイルに書き込みが行われた日時を示すメタデータを保存するかどうかを指定します。このオプションは、タスクを複数回実行する必要がある場合に必要です。  
+  `PRESERVE` (デフォルト) - 元の `Mtime` を保持します (推奨)。
+  `NONE` - `Mtime` を無視。
`Mtime` が `PRESERVE` に設定されている場合は `Atime` は `BEST_EFFORT` に設定する必要があります。  
`Mtime` が `NONE` に設定されている場合は `Atime` も `NONE` に設定する必要があります。
型: 文字列  
有効な値：`NONE | PRESERVE`  
必須: いいえ

 ** ObjectTags **   <a name="DataSync-Type-Options-ObjectTags"></a>
オブジェクトストレージシステム間でデータを転送するときに DataSync を `PRESERVE` オブジェクトタグ (デフォルトの動作) にするかどうかを指定します。DataSync タスクでオブジェクトタグを無視する場合は、`NONE` 値を指定します。  
型: 文字列  
有効な値：`PRESERVE | NONE`  
必須: いいえ

 ** OverwriteMode **   <a name="DataSync-Type-Options-OverwriteMode"></a>
DataSync が送信先のデータを上書きするか保存するかを指定します。  
+  `ALWAYS` (デフォルト) - ソースデータ (メタデータを含む) が変更されると、DataSync が送信先の場所のデータを変更します。

  DataSync がオブジェクトを上書きする場合、特定の Amazon S3 ストレージクラスに対して追加料金が発生する可能性があります (例えば、取得や早期削除など)。詳細については、「[Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。
+  `NEVER` - DataSync は、ソースデータが変更された場合でも、送信先の場所のデータを上書きしません。このオプションを使用して、送信先のファイルまたはオブジェクトに加えらえた変更の上書きがされないように保護できます。
型: 文字列  
有効な値：`ALWAYS | NEVER`  
必須: いいえ

 ** PosixPermissions **   <a name="DataSync-Type-Options-PosixPermissions"></a>
ファイルの読み取り、書き込み、実行などの特定の目的でファイルにアクセスできるユーザーまたはグループを指定します。  
詳細については、「[Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)」を参照してください。  
+  `PRESERVE` (デフォルト) - POSIX スタイルのアクセス許可を保持します (推奨)。
+  `NONE` - POSIX スタイルのアクセス許可を無視します。
DataSync は、ソースの場所の現存のアクセス許可を保持できます。
型: 文字列  
有効な値：`NONE | PRESERVE`  
必須: いいえ

 ** PreserveDeletedFiles **   <a name="DataSync-Type-Options-PreserveDeletedFiles"></a>
ソースに存在しない宛先の場所にあるファイルを保存するかどうかを指定します。このオプションは、Amazon S3 ストレージのコストに影響します。タスクでオブジェクトを削除すると、特定のストレージクラスに対して最小ストレージ期間料金が発生する可能性があります。詳細については、「[Considerations when working with Amazon S3 storage classes in DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。  
+  `PRESERVE` (デフォルト) - このような送信先ファイルを無視します (推奨)。
+  `REMOVE` - ソース内に存在しない送信先ファイルを削除します。
このパラメータを `REMOVE` に設定した場合、`TransferMode` を `ALL` に設定することはできません。すべてのデータを転送すると、DataSync は送信先の場所をスキャンしないため、何を削除すればよいかわかりません。
型: 文字列  
有効な値：`PRESERVE | REMOVE`  
必須: いいえ

 ** PreserveDevices **   <a name="DataSync-Type-Options-PreserveDevices"></a>
DataSync がソースの場所にブロックデバイスとキャラクターデバイスのメタデータを保存し、そのデバイス名とメタデータを使用して宛先にファイルを再作成するかどうかを指定します。DataSync は、そのようなデバイスの名前とメタデータのみをコピーします。  
DataSync は、こうしたデバイスの実際のコンテンツをコピーすることはできません。これらは非終端であり、ファイルの終わり (EOF) マーカーを返さないためです。
+  `NONE` (デフォルト) - 特殊デバイスを無視します (推奨)。
+  `PRESERVE` - キャラクターとブロックデバイスのメタデータを保持します。このオプションは、Amazon EFS では現在サポートされていません。
型: 文字列  
有効な値：`NONE | PRESERVE`  
必須: いいえ

 ** SecurityDescriptorCopyFlags **   <a name="DataSync-Type-Options-SecurityDescriptorCopyFlags"></a>
SMB セキュリティ記述子のどのコンポーネントをソースオブジェクトから送信先オブジェクトにコピーするかを決定する値。  
この値は、SMB と Amazon FSx for Windows File Server の場所との間、または 2 つの FSx for Windows File Server の場所との間の転送にのみ使用されます。詳細については、「[Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)」を参照してください。  
+  `OWNER_DACL` (デフォルト) - DataSync は、コピーされたオブジェクトごとに、次のメタデータをコピーします。
  + オブジェクトの所有者
  + NTFS 任意アクセスコントロールリスト (DACLs) は、オブジェクトへのアクセスを許可するかどうかを決定します。

    このオプションでは DataSync は NTFS システムアクセス制御リスト (SACL) をコピーしません。
+  `OWNER_DACL_SACL` - DataSync は、コピーされたオブジェクトごとに、次のメタデータをコピーします。
  + オブジェクトの所有者
  + NTFS 任意アクセスコントロールリスト (DACLs) は、オブジェクトへのアクセスを許可するかどうかを決定します。
  + SACL は管理者が保護されたオブジェクトへのアクセス試行を記録するために使用します。

    SACL をコピーするには、DataSync が SMB ロケーションにアクセスするために使用する Windows ユーザーに追加のアクセス許可を付与する必要があります。適切なアクセス許可を持つユーザーを選択する方法については、[SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)、[FSx for Windows File Server ](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)、または [FSx for ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) に必要なアクセス許可を参照してください (転送の場所のタイプによって異なります)。
+  `NONE` - SMB セキュリティ記述子コンポーネントはコピーされません。デスティネーションオブジェクトは、送信先の場所にアクセスするために提供されたユーザーが所有します。DACLs と SACLs は、送信先サーバーの設定に基づいて設定されます。
型: 文字列  
有効な値：`NONE | OWNER_DACL | OWNER_DACL_SACL`  
必須: いいえ

 ** TaskQueueing **   <a name="DataSync-Type-Options-TaskQueueing"></a>
[複数のタスクを実行する](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks)特定のシナリオで、転送タスクをキューに入れるかどうかを指定します。デフォルトでは、`ENABLED` です。  
型: 文字列  
有効な値：`ENABLED | DISABLED`  
必須：いいえ

 ** TransferMode **   <a name="DataSync-Type-Options-TransferMode"></a>
DataSync が、タスクを実行するたびに、最初のコピー後に場所間で異なるデータ (メタデータを含む) のみを転送するか、すべてのデータを転送するかを指定します。定期的に転送を行う予定の場合は、前回のタスク実行以降に変更されたもののみを転送することをお勧めします。  
+  `CHANGED` (デフォルト) - 最初の完全転送後、DataSync は送信元と送信先の場所で異なるデータとメタデータのみをコピーします。
+  `ALL` - DataSync は、場所間の違いを比較せずに、ソースのすべてを送信先にコピーします。
型: 文字列  
有効な値：`CHANGED | ALL`  
必須: いいえ

 ** Uid **   <a name="DataSync-Type-Options-Uid"></a>
ファイル所有者の POSIX ユーザー ID (UID) を指定します。  
+  `INT_VALUE` (デフォルト) - UID とグループ ID (GID) の整数値を保持します (推奨)。
+  `NONE` - UID と GID を無視します。
詳細については、「[Metadata copied by DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied)」を参照してください。  
型: 文字列  
有効な値：`NONE | INT_VALUE | NAME | BOTH`  
必須：いいえ

 ** VerifyMode **   <a name="DataSync-Type-Options-VerifyMode"></a>
DataSync が転送終了時にデータの整合性をチェックするかどうかと、その方法を指定します。  
+  `ONLY_FILES_TRANSFERRED` (推奨) – DataSync は、送信元の場所で転送されたデータ (メタデータを含む) のチェックサムを計算します。転送終了時に、DataSync はこのチェックサムを送信先のデータで計算されたチェックサムと比較します。
**注記**  
これは[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)のデフォルトのオプションです。

  S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive ストレージクラスに転送する場合は、このオプションをお勧めします。詳細については、「[Storage class considerations with Amazon S3 locations](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。
+  `POINT_IN_TIME_CONSISTENT` - 転送の終了時に、DataSync は送信元全体と送信先全体をチェックし、両方の場所が完全に同期されていることを確認します。
**注記**  
これは[基本モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)のデフォルトオプションであり、現在拡張モードタスクではサポートされていません。

  [マニフェスト](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)を使用する場合、DataSync はマニフェストにリストされているもののみをスキャンおよび検証します。

  S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive ストレージクラスに転送する場合は、このオプションは使用できません。詳細については、「[Storage class considerations with Amazon S3 locations](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。
+  `NONE` - DataSync は転送中にのみデータ整合性チェックを実行します。他のオプションとは異なり、転送の終了時に追加の検証はありません。
型: 文字列  
有効な値：`POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_Options_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) 

# Platform
<a name="API_Platform"></a>

バージョン番号など、AWS DataSync エージェントに関するプラットフォーム関連の詳細。

## 内容
<a name="API_Platform_Contents"></a>

 ** Version **   <a name="DataSync-Type-Platform-Version"></a>
DataSync エージェントのバージョン。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_Platform_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) 

# PrivateLinkConfig
<a name="API_PrivateLinkConfig"></a>

Virtual [Private Cloud (VPC) サービスエンドポイント](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc) AWS を使用して AWS DataSync エージェントが に接続する方法を指定します。VPC エンドポイントを使用するエージェントは、パブリックインターネット経由でアクセスできません。

## 内容
<a name="API_PrivateLinkConfig_Contents"></a>

 ** PrivateLinkEndpoint **   <a name="DataSync-Type-PrivateLinkConfig-PrivateLinkEndpoint"></a>
エージェントが接続する [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html) が提供する VPC エンドポイントを指定します。  
タイプ: 文字列  
長さの制限: 最小長は 7 です。最大長は 15 です。  
パターン: `\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z`   
必須: いいえ

 ** SecurityGroupArns **   <a name="DataSync-Type-PrivateLinkConfig-SecurityGroupArns"></a>
DataSync アクセスを VPC エンドポイントに提供するセキュリティグループの Amazon リソースネーム (ARN) を指定します。指定できる ARN は 1 つだけです。  
タイプ: 文字列の配列  
配列メンバー: 1 項目の定数です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
必須: いいえ

 ** SubnetArns **   <a name="DataSync-Type-PrivateLinkConfig-SubnetArns"></a>
VPC エンドポイントがあるサブネットの ARN を指定します。指定できる ARN は 1 つだけです。  
タイプ: 文字列の配列  
配列メンバー: 1 項目の定数です。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
必須: いいえ

 ** VpcEndpointId **   <a name="DataSync-Type-PrivateLinkConfig-VpcEndpointId"></a>
エージェントが接続する VPC エンドポイントの ID を指定します。  
タイプ: 文字列  
パターン: `^vpce-[0-9a-f]{17}$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_PrivateLinkConfig_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) 

# QopConfiguration
<a name="API_QopConfiguration"></a>

保護の品質 (QOP) 構成では、Hadoop Distributed File System (HDFS) クラスターで構成されたリモートプロシージャ呼び出し (RPC) とデータ転送のプライバシー構成を指定します。

## 内容
<a name="API_QopConfiguration_Contents"></a>

 ** DataTransferProtection **   <a name="DataSync-Type-QopConfiguration-DataTransferProtection"></a>
HDFS クラスターで設定されたデータ転送保護設定。この設定は、 Hadoop クラスター`dfs.data.transfer.protection`ファイルの`hdfs-site.xml`設定に対応しています。  
型: 文字列  
有効な値：`DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`  
必須：いいえ

 ** RpcProtection **   <a name="DataSync-Type-QopConfiguration-RpcProtection"></a>
HDFS クラスターで設定された RPC 保護設定。この設定は、 Hadoop クラスター`hadoop.rpc.protection`ファイルの`core-site.xml`設定に対応しています。  
型: 文字列  
有効な値：`DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_QopConfiguration_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) 

# ReportDestination
<a name="API_ReportDestination"></a>

DataSync が[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)をアップロードする場所を指定します。

## 内容
<a name="API_ReportDestination_Contents"></a>

 ** S3 **   <a name="DataSync-Type-ReportDestination-S3"></a>
DataSync がタスクレポートをアップロードする Amazon S3 バケットを指定します。  
型: [ReportDestinationS3](API_ReportDestinationS3.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ReportDestination_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) 

# ReportDestinationS3
<a name="API_ReportDestinationS3"></a>

DataSync が[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)をアップロードする Amazon S3 バケットを指定します。

## 内容
<a name="API_ReportDestinationS3_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-ReportDestinationS3-BucketAccessRoleArn"></a>
DataSync が S3 バケットにタスクレポートをアップロードすることを許可する IAM ポリシーの Amazon リソースネーム (ARN) を指定します。詳細については、「[DataSync による Amazon S3 バケットをアップロードするのを許可する](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
必須: はい

 ** S3BucketArn **   <a name="DataSync-Type-ReportDestinationS3-S3BucketArn"></a>
DataSync がレポートをアップロードする S3 バケットの ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 268 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
必須: はい

 ** Subdirectory **   <a name="DataSync-Type-ReportDestinationS3-Subdirectory"></a>
レポートのバケットプレフィックスを指定します。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ReportDestinationS3_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) 

# ReportOverride
<a name="API_ReportOverride"></a>

DataSync [タスクレポートの特定の側面の詳細レベルを指定します](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)。

## 内容
<a name="API_ReportOverride_Contents"></a>

 ** ReportLevel **   <a name="DataSync-Type-ReportOverride-ReportLevel"></a>
タスクレポートにエラーのみを含めるか、成功とエラーを含めるかを指定します。  
たとえば、レポートには、transfer (`ERRORS_ONLY`) でうまくいかなかったものだけがほとんど含まれている場合があります。同時に、[タスクフィルター](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)が正しく機能していることを確認する必要があります。このような状況では、DataSync が正常にスキップしたファイルと、転送しなかったのに転送されたものの (`SUCCESSES_AND_ERRORS`) のリストが表示されます。  
型: 文字列  
有効な値：`ERRORS_ONLY | SUCCESSES_AND_ERRORS`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ReportOverride_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) 

# ReportOverrides
<a name="API_ReportOverrides"></a>

DataSync [タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)の各要素に含まれる詳細レベル。

## 内容
<a name="API_ReportOverrides_Contents"></a>

 ** Deleted **   <a name="DataSync-Type-ReportOverrides-Deleted"></a>
DataSync が転送先の場所で削除しようとしたファイル、オブジェクト、およびディレクトリのレポートレベルを指定します。これが適用されるのは、転送元にはない転送先のデータを削除するように[タスクを構成した](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)場合のみです。  
型: [ReportOverride](API_ReportOverride.md) オブジェクト  
必須: いいえ

 ** Skipped **   <a name="DataSync-Type-ReportOverrides-Skipped"></a>
DataSync が転送中にスキップしようとしたファイル、オブジェクト、およびディレクトリのレポートレベルを指定します。  
型: [ReportOverride](API_ReportOverride.md) オブジェクト  
必須: いいえ

 ** Transferred **   <a name="DataSync-Type-ReportOverrides-Transferred"></a>
DataSync が転送しようとしたファイル、オブジェクト、およびディレクトリのレポートレベルを指定します。  
型: [ReportOverride](API_ReportOverride.md) オブジェクト  
必須: いいえ

 ** Verified **   <a name="DataSync-Type-ReportOverrides-Verified"></a>
転送終了時に DataSync が検証を試みたファイル、オブジェクト、およびディレクトリのレポートレベルを指定します。  
型: [ReportOverride](API_ReportOverride.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ReportOverrides_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) 

# ReportResult
<a name="API_ReportResult"></a>

DataSync が転送に関する完全な[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) を作成したかどうかを示します。

## 内容
<a name="API_ReportResult_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-ReportResult-ErrorCode"></a>
DataSync が完全なレポートを作成できない場合のエラーに関連するコードを示します。  
タイプ: 文字列  
必須: いいえ

 ** ErrorDetail **   <a name="DataSync-Type-ReportResult-ErrorDetail"></a>
レポート作成時の問題に関する詳細を提供します。  
タイプ: 文字列  
必須: いいえ

 ** Status **   <a name="DataSync-Type-ReportResult-Status"></a>
DataSync がまだレポートを処理中か、レポートを作成したか、完全なレポートを作成できないかを示します。  
型: 文字列  
有効な値：`PENDING | SUCCESS | ERROR`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_ReportResult_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) 

# S3Config
<a name="API_S3Config"></a>

DataSync が S3 バケットにアクセスするために使用する AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN) を指定します。

詳細については、「[Providing DataSync access to S3 buckets](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)」を参照してください。

## 内容
<a name="API_S3Config_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3Config-BucketAccessRoleArn"></a>
DataSync が S3 バケットへのアクセスに使用する IAM ロールの ARN を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
必須: はい

## 以下の資料も参照してください。
<a name="API_S3Config_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) 

# S3ManifestConfig
<a name="API_S3ManifestConfig"></a>

 AWS DataSync 使用するマニフェストをホストする S3 バケットを指定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。

## 内容
<a name="API_S3ManifestConfig_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3ManifestConfig-BucketAccessRoleArn"></a>
DataSync がマニフェストにアクセスできるようにする AWS Identity and Access Management (IAM) ロールを指定します。詳細については、「[Providing DataSync access to your manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
必須: はい

 ** ManifestObjectPath **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectPath"></a>
マニフェストの Amazon S3 オブジェクトキーを指定します。これにはプレフィックス (`prefix/my-manifest.csv` など) を含めることができます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
必須: はい

 ** S3BucketArn **   <a name="DataSync-Type-S3ManifestConfig-S3BucketArn"></a>
マニフェストをホストする S3 バケットの Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 268 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
必須: はい

 ** ManifestObjectVersionId **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectVersionId"></a>
DataSync で使用するマニフェストのオブジェクトバージョン ID を指定します。これを設定しない場合、DataSync はオブジェクトの最新バージョンを使用します。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 100 です。  
パターン: `^.+$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_S3ManifestConfig_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) 

# SmbMountOptions
<a name="API_SmbMountOptions"></a>

AWS DataSync が SMB ファイルサーバーにアクセスするために使用する Server Message Block (SMB) プロトコルのバージョンを指定します。

## 内容
<a name="API_SmbMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-SmbMountOptions-Version"></a>
デフォルトでは、DataSync は SMB ファイルサーバーとのネゴシエーションに基づいて自動的に SMB プロトコルバージョンを選択します。特定の SMB バージョンを使用するように DataSync を設定することもできますが、これは DataSync が SMB ファイルサーバーと自動的にネゴシエーションできない場合にのみ行うことをお勧めします。  
これらは、SMB バージョンを構成するには、次のオプションがあります。  
+  `AUTOMATIC` (デフォルト)：DataSync と SMB ファイルサーバーは、相互にサポートする SMB の最高バージョンを 2.1 と 3.1.1 の間でネゴシエートします。

  これが推奨されるオプションです。代わりに、ファイルサーバーがサポートしていない特定のバージョンを選択すると、`Operation Not Supported` エラーが表示されることがあります。
+  `SMB3`：プロトコルネゴシエーションを SMB バージョン 3.0.2 のみに制限します。
+  `SMB2`：プロトコルネゴシエーションを SMB バージョン 2.1 のみに制限します。
+  `SMB2_0`：プロトコルネゴシエーションを SMB バージョン 2.0 のみに制限します。
+  `SMB1`：プロトコルネゴシエーションを SMB バージョン 1.0 のみに制限します。
**注記**  
[Amazon FSx for NetApp ONTAP ロケーションを作成する](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html)場合、`SMB1` オプションは使用できません。
タイプ：文字列  
有効な値：`AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_SmbMountOptions_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) 

# SourceManifestConfig
<a name="API_SourceManifestConfig"></a>

AWS DataSync が使用するマニフェストとそのホスト先を指定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。

## 内容
<a name="API_SourceManifestConfig_Contents"></a>

 ** S3 **   <a name="DataSync-Type-SourceManifestConfig-S3"></a>
マニフェストをホストする S3 バケットを指定します。  
型: [S3ManifestConfig](API_S3ManifestConfig.md) オブジェクト  
必須: はい

## 以下の資料も参照してください。
<a name="API_SourceManifestConfig_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) 

# TagListEntry
<a name="API_TagListEntry"></a>

AWS リソースに適用された単一のタグを表すキーと値のペア。

## 内容
<a name="API_TagListEntry_Contents"></a>

 ** Key **   <a name="DataSync-Type-TagListEntry-Key"></a>
AWSリソースタグの鍵。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:/-]+$`   
必須: はい

 ** Value **   <a name="DataSync-Type-TagListEntry-Value"></a>
AWSリソースタグの値。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TagListEntry_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) 

# TaskExecutionFilesFailedDetail
<a name="API_TaskExecutionFilesFailedDetail"></a>

タスクの実行中に DataSync が準備、転送、検証、削除に失敗したファイルまたはオブジェクトの数。

**注記**  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。

## 内容
<a name="API_TaskExecutionFilesFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Delete"></a>
タスクの実行中に DataSync が削除に失敗したファイルまたはオブジェクトの数。  
タイプ: Long  
必須: いいえ

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Prepare"></a>
タスクの実行中に DataSync が準備に失敗したファイルまたはオブジェクトの数。  
タイプ: Long  
必須: いいえ

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Transfer"></a>
タスクの実行中に DataSync が転送に失敗したファイルまたはオブジェクトの数。  
タイプ: Long  
必須: いいえ

 ** Verify **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Verify"></a>
タスクの実行中に DataSync が検証に失敗したファイルまたはオブジェクトの数。  
タイプ: Long  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskExecutionFilesFailedDetail_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 

# TaskExecutionFilesListedDetail
<a name="API_TaskExecutionFilesListedDetail"></a>

DataSync がお客様の場所で見つけたファイルまたはオブジェクトの数。

**注記**  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。

## 内容
<a name="API_TaskExecutionFilesListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtDestinationForDelete"></a>
DataSync が送信先で検出したファイルまたはオブジェクトの数。このカウンターが適用されるのは、送信元にはない送信先のデータを削除するように[タスクを設定している](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling)場合のみです。  
タイプ: Long  
必須: いいえ

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtSource"></a>
DataSync がソースロケーションで検出したファイルまたはオブジェクトの数。  
+ [マニフェスト](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)を使用すると、DataSync は送信元の場所にあるものすべてではなく、マニフェスト内のもののみを一覧表示します。
+ 包含[フィルター](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)を使用すると、DataSync は送信元の場所のフィルターに一致するもののみを一覧表示します。
+ 除外フィルターを使用すると、DataSync はフィルターを適用する前に送信元の場所にすべてを一覧表示します。
タイプ: Long  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskExecutionFilesListedDetail_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) 

# TaskExecutionFoldersFailedDetail
<a name="API_TaskExecutionFoldersFailedDetail"></a>

タスクの実行中に DataSync がリスト、準備、転送、検証、削除に失敗したディレクトリの数。

**注記**  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。

## 内容
<a name="API_TaskExecutionFoldersFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Delete"></a>
タスクの実行中に DataSync が削除に失敗したディレクトリの数。  
タイプ: Long  
必須: いいえ

 ** List **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-List"></a>
タスクの実行中に DataSync が一覧表示に失敗したディレクトリの数。  
タイプ: Long  
必須: いいえ

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Prepare"></a>
タスクの実行中に DataSync が準備に失敗したディレクトリの数。  
タイプ: Long  
必須: いいえ

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Transfer"></a>
タスクの実行中に DataSync が転送に失敗したディレクトリの数。  
タイプ: Long  
必須: いいえ

 ** Verify **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Verify"></a>
タスクの実行中に DataSync が検証に失敗したディレクトリの数。  
タイプ: Long  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskExecutionFoldersFailedDetail_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 

# TaskExecutionFoldersListedDetail
<a name="API_TaskExecutionFoldersListedDetail"></a>

DataSync がお客様のロケーションで見つけたディレクトリの数。

**注記**  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。

## 内容
<a name="API_TaskExecutionFoldersListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtDestinationForDelete"></a>
DataSync が送信先ロケーションで検出したディレクトリの数。このカウンターが適用されるのは、送信元にはない送信先のデータを削除するように[タスクを設定している](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling)場合のみです。  
タイプ: Long  
必須: いいえ

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtSource"></a>
DataSync がソースロケーションで検出したディレクトリの数。  
+ [マニフェスト](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)を使用すると、DataSync は送信元の場所にあるものすべてではなく、マニフェスト内のもののみを一覧表示します。
+ 包含[フィルター](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)を使用すると、DataSync は送信元の場所のフィルターに一致するもののみを一覧表示します。
+ 除外フィルターを使用すると、DataSync はフィルターを適用する前に送信元の場所にすべてを一覧表示します。
タイプ: Long  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskExecutionFoldersListedDetail_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 

# TaskExecutionListEntry
<a name="API_TaskExecutionListEntry"></a>

[ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html) オペレーションで返される AWS DataSync タスク実行のリスト内の 1 つのエントリを表します。

## 内容
<a name="API_TaskExecutionListEntry_Contents"></a>

 ** Status **   <a name="DataSync-Type-TaskExecutionListEntry-Status"></a>
タスク実行のステータス。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
型: 文字列  
有効な値：`QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`  
必須: いいえ

 ** TaskExecutionArn **   <a name="DataSync-Type-TaskExecutionListEntry-TaskExecutionArn"></a>
タスク実行の Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
必須: いいえ

 ** TaskMode **   <a name="DataSync-Type-TaskExecutionListEntry-TaskMode"></a>
使用しているタスクモード。詳細については、「[Choosing a task mode for your data transfer](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)」を参照してください。  
型: 文字列  
有効な値：`BASIC | ENHANCED`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskExecutionListEntry_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) 

# TaskExecutionResultDetail
<a name="API_TaskExecutionResultDetail"></a>

AWS DataSync タスクの実行の結果に関する詳細情報を提供します。

## 内容
<a name="API_TaskExecutionResultDetail_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorCode"></a>
タスクの実行中に DataSync が遭遇したエラー。この情報は、[問題のトラブルシューティング](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)に役立てることができます。  
タイプ: 文字列  
必須: いいえ

 ** ErrorDetail **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorDetail"></a>
タスクの実行中に DataSync が遭遇したエラーの詳細な説明。この情報は、[問題のトラブルシューティング](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)に役立てることができます。  
タイプ: 文字列  
必須: いいえ

 ** PrepareDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareDuration"></a>
タスク実行が `PREPARING` ステップにあったミリ秒単位の時間。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
拡張モードタスクの場合、値は常に `0` です。詳細については、「[How DataSync prepares your data transfer](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares)」を参照してください。  
タイプ：長整数  
有効な範囲: 最小値 は 0 です。  
必須: いいえ

 ** PrepareStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareStatus"></a>
`PREPARING` ステップのタスク実行のステータス。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
型: 文字列  
有効な値：`PENDING | SUCCESS | ERROR`  
必須: いいえ

 ** TotalDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TotalDuration"></a>
タスク実行が実行されたミリ秒単位の時間。  
タイプ：長整数  
有効な範囲: 最小値 は 0 です。  
必須: いいえ

 ** TransferDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferDuration"></a>
タスク実行が `TRANSFERRING` ステップにあったミリ秒単位の時間。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
拡張モードタスクの場合、値は常に `0` です。詳細については、「[How DataSync transfers your data](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers)」を参照してください。  
タイプ：長整数  
有効な範囲: 最小値 は 0 です。  
必須: いいえ

 ** TransferStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferStatus"></a>
`TRANSFERRING` ステップのタスク実行のステータス。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
型: 文字列  
有効な値：`PENDING | SUCCESS | ERROR`  
必須：いいえ

 ** VerifyDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyDuration"></a>
タスク実行が `VERIFYING` ステップにあったミリ秒単位の時間。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
拡張モードタスクの場合、値は常に `0` です。詳細については、「[How DataSync verifies your data's integrity](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works)」を参照してください。  
タイプ：長整数  
有効な範囲: 最小値 は 0 です。  
必須: いいえ

 ** VerifyStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyStatus"></a>
`VERIFYING` ステップのタスク実行のステータス。詳細については、「[Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
型: 文字列  
有効な値：`PENDING | SUCCESS | ERROR`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskExecutionResultDetail_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) 

# TaskFilter
<a name="API_TaskFilter"></a>

API フィルタを使用して、`ListTasks`によって返されるリソースのリストを絞り込むことが出来ます。たとえば、あるソースロケーション上のあるすべてのタスクを検索するには、`ListTasks`にフィルタ名`LocationId`、`Operator Equals`にロケーションの ARN を使用します。

詳細については、「[DataSync リソースのフィルタリング](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html)」を参照してください。

## 内容
<a name="API_TaskFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskFilter-Name"></a>
使用されているフィルタの名前。各 API 呼び出しでは、使用可能なフィルタのリストがサポートされています。たとえば、`LocationId` の `ListTasks` を設定します。  
型: 文字列  
有効な値：`LocationId | CreationTime`  
必須: はい

 ** Operator **   <a name="DataSync-Type-TaskFilter-Operator"></a>
フィルタ値の比較に使用される演算子 (たとえば、`Equals`または`Contains`)。  
型: 文字列  
有効な値：`Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`  
必須: はい

 ** Values **   <a name="DataSync-Type-TaskFilter-Values"></a>
フィルタリングする値。たとえば、特定の転送先のタスクのみを表示できます。  
型: 文字列の配列  
長さの制限：最小長 1、最大長は 255 です。  
パターン: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
必須: はい

## 以下の資料も参照してください。
<a name="API_TaskFilter_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) 

# TaskListEntry
<a name="API_TaskListEntry"></a>

タスクのリスト内にある単一のエントリを表します。[ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html)オペレーションが呼び出されると、`TaskListEntry`は、タスクのリストを含む配列を返します。タスクには、同期するソースおよび送信先ファイルシステム、およびタスクに使用するオプションが含まれます。

## 内容
<a name="API_TaskListEntry_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskListEntry-Name"></a>
タスクの名前。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 256 です。  
パターン: `^[a-zA-Z0-9\s+=._:@/-]+$`   
必須: いいえ

 ** Status **   <a name="DataSync-Type-TaskListEntry-Status"></a>
タスクのステータス。  
型: 文字列  
有効な値：`AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE`  
必須：いいえ

 ** TaskArn **   <a name="DataSync-Type-TaskListEntry-TaskArn"></a>
タスクの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
必須: いいえ

 ** TaskMode **   <a name="DataSync-Type-TaskListEntry-TaskMode"></a>
使用しているタスクモード。詳細については、「[Choosing a task mode for your data transfer](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)」を参照してください。  
型: 文字列  
有効な値：`BASIC | ENHANCED`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskListEntry_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) 

# TaskReportConfig
<a name="API_TaskReportConfig"></a>

AWS DataSync 転送に関する詳細情報を提供するタスクレポートの設定方法を指定します。

詳細については、「[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。

## 内容
<a name="API_TaskReportConfig_Contents"></a>

 ** Destination **   <a name="DataSync-Type-TaskReportConfig-Destination"></a>
DataSync がタスクレポートをアップロードする Amazon S3 バケットを指定します。詳細については、「[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access)」を参照してください。  
型: [ReportDestination](API_ReportDestination.md) オブジェクト  
必須: いいえ

 ** ObjectVersionIds **   <a name="DataSync-Type-TaskReportConfig-ObjectVersionIds"></a>
S3 バケットに転送された各オブジェクトの新しいバージョンをタスクレポートに含めるかどうかを指定します。これは、[バケットでバージョニングを有効に](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html)した場合にのみ適用されます。これを `INCLUDE` に設定すると、タスクの実行時間が長くなる可能性があることに注意してください。  
型: 文字列  
有効な値：`INCLUDE | NONE`  
必須：いいえ

 ** OutputType **   <a name="DataSync-Type-TaskReportConfig-OutputType"></a>
必要なタスクレポートのタイプを指定します。  
+  `SUMMARY_ONLY`: 転送されたファイル、オブジェクト、ディレクトリの数、転送時間など、タスクに関する必要な詳細情報を提供します。
+  `STANDARD`: 転送、スキップ、検証されたファイル、オブジェクト、ディレクトリの全リストなど、タスクに関する詳細な情報を提供します。
型: 文字列  
有効な値：`SUMMARY_ONLY | STANDARD`  
必須：いいえ

 ** Overrides **   <a name="DataSync-Type-TaskReportConfig-Overrides"></a>
タスクレポートのさまざまな側面のレポートレベルをカスタマイズします。たとえば、レポートには通常エラーのみが含まれますが、DataSync が転送先ロケーションで削除しようとしたファイルのみを対象とする成功とエラーのリストを作成するように指定できます。  
型: [ReportOverrides](API_ReportOverrides.md) オブジェクト  
必須: いいえ

 ** ReportLevel **   <a name="DataSync-Type-TaskReportConfig-ReportLevel"></a>
タスクレポートに、転送で発生した問題のみを含めるか、成功したものと失敗したもののリストを含めるかを指定します。  
+  `ERRORS_ONLY`: レポートには、DataSync が転送、スキップ、検証、削除できなかった内容が表示されます。
+  `SUCCESSES_AND_ERRORS`: レポートには、DataSync が転送、スキップ、検証、削除できたものとできなかったものが表示されます。
型: 文字列  
有効な値：`ERRORS_ONLY | SUCCESSES_AND_ERRORS`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskReportConfig_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) 

# TaskSchedule
<a name="API_TaskSchedule"></a>

タスクが[スケジュール](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (最低 1 時間の間隔) に従って実行される AWS DataSync ように設定します。

## 内容
<a name="API_TaskSchedule_Contents"></a>

 ** ScheduleExpression **   <a name="DataSync-Type-TaskSchedule-ScheduleExpression"></a>
cron または rate 式を使用して、スケジュールを指定します。  
特定の日時で実行されるタスクスケジュールには cron 式を使用します。例えば、次の cron 式は、毎月第 1 水曜日の午前 8 時に実行されるタスクスケジュールを作成します。  
 `cron(0 8 * * 3#1)`   
定期的に実行されるタスクスケジュールにはレート式を使用します。例えば、次の rate 式は、12 時間ごとに実行されるタスクスケジュールを作成します。  
 `rate(12 hours)`   
cron と rate 式シンタックスの詳細については、「[https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 256 です。  
パターン: `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\(\)\+]*$`   
必須: はい

 ** Status **   <a name="DataSync-Type-TaskSchedule-Status"></a>
タスクスケジュールを有効または無効にするかどうかを指定します。スケジュールはデフォルトで有効になっていますが、無効にする必要がある場合があります。例えば、タスクの問題を解決したり、ストレージシステムのメンテナンスを実行したりするために、定期的な転送を一時停止する必要がある場合があります。  
DataSync は、タスクが同じエラーで繰り返し失敗した場合、スケジュールを自動的に無効にすることがあります。詳細については、「[TaskScheduleDetails](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html)」を参照してください。  
型: 文字列  
有効な値：`ENABLED | DISABLED`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskSchedule_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) 

# TaskScheduleDetails
<a name="API_TaskScheduleDetails"></a>

AWS DataSync [タスクスケジュール](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) に関する情報を提供します。

## 内容
<a name="API_TaskScheduleDetails_Contents"></a>

 ** DisabledBy **   <a name="DataSync-Type-TaskScheduleDetails-DisabledBy"></a>
タスクスケジュールが無効になった方法を示します。  
+  `USER` - スケジュールは、[UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html) オペレーションまたは DataSync コンソールを使用して手動で無効になりました。
+  `SERVICE` - タスクが同じエラーで繰り返し失敗したため、スケジュールは DataSync によって自動的に無効になりました。
型: 文字列  
有効な値：`USER | SERVICE`  
必須: いいえ

 ** DisabledReason **   <a name="DataSync-Type-TaskScheduleDetails-DisabledReason"></a>
タスクスケジュールが無効になっている場合の理由を提供します。  
スケジュールが `USER` によって無効になっている場合は、`Manually disabled by user.` メッセージが表示されます。  
スケジュールが `SERVICE` によって無効になっている場合、タスクが失敗し続ける理由を理解するのに役立つエラーメッセージが表示されます。DataSync エラーの解決に関する詳細については、「[Troubleshooting issues with DataSync transfers](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 8,192 です。  
パターン: `^[\w\s.,'?!:;\/=|<>()-]*$`   
必須: いいえ

 ** StatusUpdateTime **   <a name="DataSync-Type-TaskScheduleDetails-StatusUpdateTime"></a>
タスクスケジュールのステータスが最後に変更された日時を示します。例えば、エラーの繰り返しが原因で DataSync がスケジュールを自動的に無効にした場合、スケジュールが無効になった日時を確認できます。  
型: タイムスタンプ  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_TaskScheduleDetails_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) 

# 共通エラー
<a name="CommonErrors"></a>

このセクションでは、AWS のすべてのサービスの API アクションに共通のエラーを一覧表示しています。このサービスの API アクションに固有のエラーについては、その API アクションのトピックを参照してください。

 **AccessDeniedException**   
このアクションを実行する十分なアクセス権限がありません。  
HTTP ステータスコード: 400

 **IncompleteSignature**   
リクエストの署名が AWS 基準に適合しません。  
HTTP ステータスコード: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
リクエストの処理が、不明なエラー、例外、または障害により実行できませんでした。  
HTTP ステータスコード: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
リクエストされたアクション、またはオペレーションは無効です。アクションが正しく入力されていることを確認してください。  
HTTP ステータスコード: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
指定された X.509 証明書または AWS アクセスキー ID がレコード内に見つかりません。  
HTTP ステータスコード: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
このアクションを実行するためのアクセス許可がありません。  
HTTP ステータスコード: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
サービスを利用するためには、AWS アクセスキー ID を取得する必要があります。  
HTTP ステータスコード: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
リクエストの日付スタンプの 15 分以上後またはリクエストの有効期限 (署名付き URL の場合など) の 15 分以上後に、リクエストが到着しました。または、リクエストの日付スタンプが現在より 15 分以上先です。  
HTTP ステータスコード: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
サーバーの一時的な障害により、リクエストは失敗しました。  
HTTP ステータスコード: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
リクエストのスロットリングにより、リクエストが拒否されました。  
HTTP ステータスコード: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
入力が、AWS サービスで指定された制約を満たしていません。  
HTTP ステータスコード: 400

# 共通パラメータ
<a name="CommonParameters"></a>

次のリストには、すべてのアクションが署名バージョン 4 リクエストにクエリ文字列で署名するために使用するパラメータを示します。アクション固有のパラメータは、アクションのトピックに示されています。Signature Version 4 の詳細については、「IAM ユーザーガイド」の「[AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)」を参照してください。

 **Action**   <a name="CommonParameters-Action"></a>
実行するアクション。  
型: 文字列  
必須: はい

 **Version**   <a name="CommonParameters-Version"></a>
リクエストが想定している API バージョンである、YYYY-MM-DD 形式で表示されます。  
型: 文字列  
必須: はい

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
リクエストの署名を作成するのに使用したハッシュアルゴリズム。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
有効な値：`AWS4-HMAC-SHA256`  
必須: 条件による

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
認証情報スコープの値で、アクセスキー、日付、対象とするリージョン、リクエストしているサービス、および終了文字列 ("aws4\$1request") を含む文字列です。値は次の形式で表現されます。*access\$1key*/*YYYYYYYYMMDD*/*region*/*service*/aws4\$1request  
詳細については、「IAM ユーザーガイド」の「[署名付きAWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
必須: 条件による

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
署名を作成するときに使用する日付です。形式は ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' でなければなりません。例えば、日付 `20120325T120000Z` は、有効な X-Amz-Date の値です。  
条件: X-Amz-Date はすべてのリクエストに対してオプションです。署名リクエストで使用する日付よりも優先される日付として使用できます。ISO 8601 ベーシック形式で日付ヘッダーが指定されている場合、X-Amz-Date は必要ありません。X-Amz-Date を使用すると、常に Date ヘッダーの値よりも優先されます。詳細については、「IAM ユーザーガイド」の「[AWS API リクエスト署名の要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)」を参照してください。  
タイプ: 文字列  
必須: 条件による

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
AWS Security Token Service (AWS STS) へのを呼び出しで取得された一時的なセキュリティトークン。AWS STS の一時的なセキュリティ認証情報をサポートするサービスのリストについては、「IAM ユーザーガイド」の「[IAM と連携するAWS のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。  
条件:AWS STS の一時的なセキュリティ認証情報を使用する場合、セキュリティトークンを含める必要があります。  
タイプ: 文字列  
必須: 条件による

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
署名する文字列と派生署名キーから計算された 16 進符号化署名を指定します。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
必須: 条件による

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
正規リクエストの一部として含まれていたすべての HTTP ヘッダーを指定します。署名付きヘッダーの指定に関する詳細については、「IAM ユーザーガイド」の「[署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。  
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。  
型: 文字列  
必須: 条件による