Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # AWS DataSync API Outre le AWS Management Console et AWS CLI, vous pouvez utiliser l' AWS DataSync API pour configurer et gérer DataSync avec le [AWS SDKs](https://aws.amazon.com/developer/tools/). **Topics** + [ # Actions ](API_Operations.md) + [ # Types de données ](API_Types.md) + [ # Erreurs courantes ](CommonErrors.md) + [ # Paramètres communs ](CommonParameters.md) # Actions Les actions suivantes sont prises en charge : + [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 Arrête l'exécution d'une AWS DataSync tâche en cours. Le transfert de certains fichiers est brusquement interrompu. Le contenu des fichiers transférés vers la destination peut être incomplet ou ne pas correspondre aux fichiers source. Toutefois, si vous lancez l'exécution d'une nouvelle tâche en utilisant la même tâche et que vous la laissez se terminer, le contenu du fichier de destination sera complet et cohérent. Cela s'applique aux autres défaillances inattendues qui interrompent l'exécution d'une tâche. Dans tous ces cas, le transfert est terminé DataSync avec succès lorsque vous lancez l'exécution de la tâche suivante. ## Syntaxe de la requête ``` { "TaskExecutionArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) ** Nom de ressource Amazon (ARN) de l'exécution de la tâche à arrêter. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) # CreateAgent Active un AWS DataSync agent que vous déployez dans votre environnement de stockage. Le processus d'activation associe l'agent à votre Compte AWS. Si vous n'avez pas encore déployé d'agent, consultez la section [Ai-je besoin d'un DataSync agent ?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) ## Syntaxe de la requête ``` { "ActivationKey": "string", "AgentName": "string", "SecurityGroupArns": [ "string" ], "SubnetArns": [ "string" ], "Tags": [ { "Key": "string", "Value": "string" } ], "VpcEndpointId": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [ActivationKey](#API_CreateAgent_RequestSyntax) ** Spécifie la clé d'activation de votre DataSync agent. Si vous n'avez pas de clé d'activation, consultez la section [Activation de votre agent](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html). Type : Chaîne Contraintes de longueur : longueur maximale de 29. Modèle : `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}` Obligatoire : oui ** [AgentName](#API_CreateAgent_RequestSyntax) ** Spécifie le nom de votre agent. Nous vous recommandons de spécifier un nom dont vous vous souviendrez. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du groupe de sécurité qui autorise le trafic entre votre agent et le point de terminaison du service VPC. Vous ne pouvez spécifier qu'un seul ARN. Type : tableau de chaînes Membres du tableau : nombre fixe de 1 élément. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : non ** [SubnetArns](#API_CreateAgent_RequestSyntax) ** Spécifie l'ARN du sous-réseau où se trouve le point de terminaison de votre service VPC. Vous ne pouvez spécifier qu'un seul ARN. Type : tableau de chaînes Membres du tableau : nombre fixe de 1 élément. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : non ** [Tags](#API_CreateAgent_RequestSyntax) ** Spécifie des étiquettes qui vous aident à classer, filtrer et rechercher vos AWS ressources. Nous vous recommandons de créer au moins un tag pour votre agent. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) ** Spécifie l'ID du point de [terminaison du service VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) que vous utilisez. Par exemple, un identifiant de point de terminaison VPC ressemble à. `vpce-01234d5aff67890e1` Le point de terminaison du service VPC que vous utilisez doit inclure le nom du DataSync service (par exemple,`com.amazonaws.us-east-2.datasync`). Type : Chaîne Modèle : `^vpce-[0-9a-f]{17}$` Obligatoire : non ## Syntaxe de la réponse ``` { "AgentArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AgentArn](#API_CreateAgent_ResponseSyntax) ** L'ARN de l'agent que vous venez d'activer. Utilisez cette [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)opération pour renvoyer une liste d'agents dans votre Compte AWS et Région AWS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant active un DataSync agent. ``` { "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE", "AgentName": "MyAgent", "Tags": [{ "Key": "Job", "Value": "TransferJob-1" }] } ``` ### Exemple de réponse La réponse renvoie l'ARN de l'agent activé. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3" } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent) # CreateLocationAzureBlob Crée un *emplacement* de transfert pour un conteneur Microsoft Azure Blob Storage. AWS DataSync peut utiliser cet emplacement comme source ou destination de transfert. Vous pouvez effectuer des transferts avec ou sans [DataSync agent](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) connecté à votre conteneur. Avant de commencer, assurez-vous de savoir [comment DataSync accéder à Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access) et comment utiliser les [niveaux d'accès](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) et les types de [blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types). ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie le niveau d'accès vers lequel vous souhaitez transférer vos objets ou fichiers. Cela s'applique uniquement lorsque l'emplacement est utilisé comme destination de transfert. Pour plus d'informations, consultez la section [Niveaux d'accès](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Type : Chaîne Valeurs valides : `HOT | COOL | ARCHIVE` Obligatoire : non ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) ** (Facultatif) Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent qui peut se connecter à votre conteneur Azure Blob Storage. Si vous configurez un transfert cross-cloud sans agent, il n'est pas nécessaire de spécifier une valeur pour ce paramètre. Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section [Utilisation de plusieurs agents pour votre transfert](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html). Assurez-vous de configurer correctement ce paramètre lorsque vous créez votre emplacement de stockage pour la première fois. Il est impossible d'ajouter ou de supprimer des agents d'un emplacement de stockage après l'avoir créé. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie la méthode d'authentification DataSync utilisée pour accéder à votre Azure Blob Storage. DataSync peut accéder au stockage blob à l'aide d'une signature d'accès partagé (SAS). Type : Chaîne Valeurs valides : `SAS | NONE` Obligatoire : oui ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie le type de blob que vous souhaitez attribuer à vos objets ou fichiers lorsque vous les transférez dans Azure Blob Storage. Actuellement, DataSync ne prend en charge le transfert de données vers Azure Blob Storage que sous forme de blobs de blocs. Pour plus d'informations sur les types de blob, consultez la documentation [Azure Blob Storage](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs). Type : Chaîne Valeurs valides : `BLOCK` Obligatoire : non ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, qui inclut le jeton d'authentification DataSync utilisé pour accéder à un emplacement de AzureBlob stockage spécifique, avec un code géré par le client AWS KMS key. Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationAzureBlob` demande, vous ne fournissez que l'ARN de la clé KMS. DataSync utilise cette clé KMS avec le jeton d'authentification que vous spécifiez `SasConfiguration` pour créer un secret DataSync géré afin de stocker les informations d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`SasConfiguration`) ou `CustomSecretConfig` (sans`SasConfiguration`) pour fournir des informations d'identification pour une `CreateLocationAzureBlob` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie l'URL du conteneur Azure Blob Storage impliqué dans votre transfert. Type : Chaîne Contraintes de longueur : longueur maximale de 325. Modèle : `^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$` Obligatoire : oui ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client dans lequel le jeton d'authentification d'un emplacement AzureBlob de stockage est stocké en texte brut, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`SasConfiguration`) ou `CustomSecretConfig` (sans`SasConfiguration`) pour fournir des informations d'identification pour une `CreateLocationAzureBlob` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie la configuration SAS qui permet d'accéder DataSync à votre stockage Azure Blob. Si vous fournissez un jeton d'authentification en utilisant`SasConfiguration`, sans fournir de détails de configuration secrets, en utilisant `CmkSecretConfig` ou`CustomSecretConfig`, puis que vous DataSync stockez le jeton en utilisant le secret du gestionnaire de secrets de votre AWS compte. Type : objet [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) Obligatoire : non ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie les segments de chemin si vous souhaitez limiter votre transfert vers un répertoire virtuel de votre conteneur (par exemple,`/my/images`). Type : Chaîne Contraintes de longueur : longueur maximum de 1 024. Modèle : `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` Obligatoire : non ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une étiquette nominative pour votre lieu de transfert. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) ** L'ARN de l'emplacement de transfert Azure Blob Storage que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob) # CreateLocationEfs Crée un *emplacement* de transfert pour un système de fichiers Amazon EFS. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de comprendre comment DataSync [accéder aux systèmes de fichiers Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access). ## Syntaxe de la requête ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du point d'accès DataSync utilisé pour monter votre système de fichiers Amazon EFS. Pour plus d'informations, consultez la section [Accès aux systèmes de fichiers restreints](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** Spécifie le sous-réseau et les groupes de sécurité DataSync utilisés pour se connecter à l'une des [cibles de montage](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) de votre système de fichiers Amazon EFS. Type : objet [Ec2Config](API_Ec2Config.md) Obligatoire : oui ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Spécifie l'ARN de votre système de fichiers Amazon EFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** Spécifie un rôle Gestion des identités et des accès AWS (IAM) qui permet d'accéder DataSync à votre système de fichiers Amazon EFS. Pour plus d'informations sur la création de ce rôle, voir [Création d'un rôle DataSync IAM pour l'accès au système de fichiers](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Obligatoire : non ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** Spécifie si vous DataSync souhaitez utiliser le chiffrement TLS (Transport Layer Security) 1.2 lors du transfert de données vers ou depuis votre système de fichiers Amazon EFS. Si vous spécifiez un point d'accès en utilisant `AccessPointArn` ou un rôle IAM avec `FileSystemAccessRoleArn`, vous devez définir ce paramètre sur `TLS1_2`. Type : Chaîne Valeurs valides : `NONE | TLS1_2` Obligatoire : non ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers Amazon EFS. C'est là que les données sont DataSync lues ou écrites sur votre système de fichiers (selon qu'il s'agit d'un emplacement source ou de destination). Par défaut, DataSync utilise le répertoire racine (ou le [point d'accès](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) si vous en fournissez un en utilisant`AccessPointArn`). Vous pouvez également inclure des sous-répertoires à l'aide de barres obliques (par exemple,). `/path/to/folder` Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** Spécifie la paire clé-valeur qui représente une balise que vous souhaitez ajouter à la ressource. La valeur peut être une chaîne vide. Cette valeur vous aide à gérer, filtrer et rechercher vos ressources. Nous vous recommandons de créer une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement du système de fichiers Amazon EFS que vous créez. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant crée un emplacement pour un système de fichiers 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" }] } ``` ### Exemple de demande : création d'un emplacement pour un système de fichiers Amazon EFS restreint L'exemple suivant crée un emplacement pour un système de fichiers Amazon EFS à accès restreint. Dans ce type de scénario, vous devrez peut-être spécifier des valeurs pour `AccessPointArn``FileSystemAccessRoleArn`, et `InTransitEncryption` dans votre demande. ``` { "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" }] } ``` ### Exemple de réponse Une réponse renvoie l'ARN d'emplacement du système de fichiers Amazon EFS. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs) # CreateLocationFsxLustre Crée un *emplacement* de transfert pour un système de fichiers Amazon FSx for Lustre. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre le mode d' DataSync[accès aux systèmes FSx de fichiers Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access). ## Syntaxe de la requête ``` { "FsxFilesystemArn": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du système de fichiers FSx for Lustre. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) ** Spécifie les noms de ressources Amazon (ARNs) d'un maximum de cinq groupes de sécurité qui donnent accès à votre système de fichiers FSx for Lustre. Les groupes de sécurité doivent pouvoir accéder aux ports du système de fichiers. Le système de fichiers doit également autoriser l'accès depuis les groupes de sécurité. Pour plus d'informations sur l'accès au système de fichiers, consultez le [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). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationFsxLustre_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers FSx for Lustre. Le chemin peut inclure des sous-répertoires. Lorsque l'emplacement est utilisé comme source, DataSync lit les données depuis le chemin de montage. Lorsque l'emplacement est utilisé comme destination, DataSync écrit des données sur le chemin de montage. Si vous n'incluez pas ce paramètre, DataSync utilise le répertoire racine du système de fichiers (`/`). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ** [Tags](#API_CreateLocationFsxLustre_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationFsxLustre_ResponseSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement du système de fichiers FSx pour Lustre que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) # CreateLocationFsxOntap Crée un *emplacement* de transfert pour un système de fichiers Amazon FSx for NetApp ONTAP. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre le mode d' DataSync[accès aux systèmes FSx de fichiers ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access). ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) ** Spécifie le protocole de transfert de données AWS DataSync utilisé pour accéder à votre système de FSx fichiers Amazon. Type : objet [FsxProtocol](API_FsxProtocol.md) Obligatoire : oui ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) ** Spécifie les groupes de sécurité Amazon EC2 qui fournissent l'accès au sous-réseau préféré de votre système de fichiers. Les groupes de sécurité doivent autoriser le trafic sortant sur les ports suivants (selon le protocole que vous utilisez) : + **NFS (Network File System)** : ports TCP 111, 635 et 2 049 + **SMB (Server Message Block)** : port TCP 445 Les groupes de sécurité de votre système de fichiers doivent également autoriser le trafic entrant sur les mêmes ports. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) ** Spécifie l'ARN de la machine virtuelle de stockage (SVM) de votre système de fichiers vers ou depuis laquelle vous souhaitez copier des données. Type : Chaîne Contraintes de longueur : longueur maximale de 162. Modèle : `^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,}$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) ** Spécifie le chemin d'accès au partage de fichiers de la SVM vers lequel vous souhaitez transférer des données ou à partir duquel vous souhaitez transférer des données. Vous pouvez spécifier un chemin de jonction (également appelé point de montage), un chemin qtree (pour les partages de fichiers NFS) ou un nom de partage (pour les partages de fichiers SMB). Par exemple, votre chemin de montage peut être `/vol1`, `/vol1/tree1` ou `/share1`. Ne spécifiez pas de chemin de jonction dans le volume racine de la SVM. Pour plus d'informations, consultez [la section Gestion FSx des machines virtuelles de stockage ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) dans le guide de l'*utilisateur Amazon FSx pour NetApp ONTAP*. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` Obligatoire : non ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) ** Spécifie l'ARN de l'emplacement du système de fichiers FSx pour ONTAP que vous créez. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) # CreateLocationFsxOpenZfs Crée un *emplacement* de transfert pour un système de fichiers Amazon FSx pour OpenZFS. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre le mode d' DataSync[accès aux systèmes FSx de fichiers OpenZFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access). **Note** Les paramètres de demande associés à `SMB` ne sont pas pris en charge par l'`CreateLocationFsxOpenZfs`opération. ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Nom de ressource Amazon (ARN) du système de fichiers FSx pour OpenZFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Type de protocole AWS DataSync utilisé pour accéder à votre système de fichiers. Type : objet [FsxProtocol](API_FsxProtocol.md) Obligatoire : oui ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Les groupes ARNs de sécurité utilisés pour configurer le système de fichiers FSx pour OpenZFS. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Un sous-répertoire dans le chemin de l'emplacement qui doit commencer `/fsx` par. DataSync utilise ce sous-répertoire pour lire ou écrire des données (selon que le système de fichiers est un emplacement source ou de destination). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$` Obligatoire : non ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Paire clé-valeur qui représente une balise que vous souhaitez ajouter à la ressource. La valeur peut être une chaîne vide. Cette valeur vous aide à gérer, filtrer et rechercher vos ressources. Nous vous recommandons de créer une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationFsxOpenZfs_ResponseSyntax) ** L'ARN de l'emplacement du système FSx de fichiers OpenZFS que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) # CreateLocationFsxWindows Crée un *emplacement* de transfert pour un système de fichiers Amazon FSx pour Windows File Server. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre le mode d' DataSync[accès FSx aux systèmes de fichiers Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, notamment le mot de passe DataSync utilisé pour accéder à un emplacement de stockage FSx Windows spécifique, avec un code géré par le client AWS KMS key. Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationFsxWindows` demande, vous ne fournissez que l'ARN de la clé KMS. DataSync utilise cette clé KMS avec celle `Password` que vous spécifiez pour créer un secret DataSync géré afin de stocker les informations d'identification d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`Password`) ou `CustomSecretConfig` (sans`Password`) pour fournir des informations d'identification pour une `CreateLocationFsxWindows` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client où le mot de passe d'un emplacement de stockage FSx pour le serveur de fichiers Windows est stocké en texte brut, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`Password`) ou `CustomSecretConfig` (sans`Password`) pour fournir des informations d'identification pour une `CreateLocationFsxWindows` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie le nom du domaine Windows auquel appartient le système FSx de fichiers du serveur de fichiers Windows. Si votre environnement comporte plusieurs domaines Active Directory, la configuration de ce paramètre garantit la DataSync connexion au bon système de fichiers. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obligatoire : non ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) FSx pour le système de fichiers Windows File Server. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie le mot de passe de l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers dans votre système de fichiers FSx pour Windows File Server. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie les ARN des groupes de sécurité Amazon EC2 qui fournissent l'accès au sous-réseau préféré de votre système de fichiers. Les groupes de sécurité que vous spécifiez doivent pouvoir communiquer avec les groupes de sécurité de votre système de fichiers. Pour plus d'informations sur la configuration des groupes de sécurité pour l'accès au système de fichiers, consultez le [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). Si vous choisissez un groupe de sécurité qui n'autorise pas les connexions internes, effectuez l'une des opérations suivantes : + Configurez le groupe de sécurité pour lui permettre de communiquer au sein de lui-même. + Choisissez un autre groupe de sécurité capable de communiquer avec le groupe de sécurité de la cible de montage. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers en utilisant des barres obliques. C'est là que les données sont DataSync lues ou écrites (selon qu'il s'agit d'un emplacement source ou de destination). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** Spécifie l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers dans votre système de fichiers FSx pour Windows File Server. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez [les autorisations requises](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx pour les emplacements des serveurs de fichiers Windows. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) ** L'ARN de l'emplacement du système de fichiers FSx pour Windows File Server que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows) # CreateLocationHdfs Crée un *emplacement* de transfert pour un système de fichiers distribué Hadoop (HDFS). AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre comment DataSync [accéder aux clusters HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs). ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) ** Les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre cluster HDFS. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) ** Type d'authentification utilisé pour déterminer l'identité de l'utilisateur. Type : Chaîne Valeurs valides : `SIMPLE | KERBEROS` Obligatoire : oui ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) ** La taille des blocs de données à écrire dans le cluster HDFS. La taille des blocs doit être un multiple de 512 octets. La taille des blocs par défaut est de 128 mégaoctets (Mio). Type : Integer Plage valide : valeur minimale de 1048576. Valeur maximale de 1073741824. Obligatoire : non ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, notamment le keytab Kerberos qui permet d'accéder à un emplacement de DataSync stockage Hadoop Distributed File System (HDFS) spécifique, avec un emplacement géré par le client. AWS KMS key Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationHdfs` demande, vous fournissez uniquement l'ARN de la clé KMS. DataSync utilise cette clé KMS avec celle `KerberosKeytab` que vous spécifiez pour créer un secret DataSync géré afin de stocker les informations d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`KerberosKeytab`) ou `CustomSecretConfig` (sans`KerberosKeytab`) pour fournir des informations d'identification pour une `CreateLocationHdfs` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) ** Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client dans lequel le keytab Kerberos pour l'emplacement de stockage HDFS est stocké en binaire, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`KerberosKeytab`) ou `CustomSecretConfig` (sans`KerberosKeytab`) pour fournir des informations d'identification pour une `CreateLocationHdfs` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) ** La table de clés Kerberos (keytab) qui contient les mappages entre le principal Kerberos défini et les clés chiffrées. Vous pouvez charger le keytab à partir d'un fichier en fournissant l'adresse du fichier. Ce paramètre est requis si `KERBEROS` est spécifié pour `AuthenticationType`. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 65536. Obligatoire : non ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) ** Le fichier `krb5.conf` qui contient les informations de configuration Kerberos. Vous pouvez charger le `krb5.conf` fichier en fournissant son adresse. Si vous utilisez le AWS CLI, il exécute le codage base64 pour vous. Sinon, fournissez le texte codé en base64. Ce paramètre est requis si `KERBEROS` est spécifié pour `AuthenticationType`. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 131072. Obligatoire : non ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) ** Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS. Ce paramètre est requis si `KERBEROS` est spécifié pour `AuthenticationType`. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^.+$` Obligatoire : non ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) ** L'URI du serveur de gestion de clés (KMS) du cluster HDFS. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères. Modèle : `^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$` Obligatoire : non ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) ** Celui NameNode qui gère l'espace de noms HDFS. Il NameNode effectue des opérations telles que l'ouverture, la fermeture et le changement de nom de fichiers et de répertoires. Le NameNode contient les informations permettant de mapper des blocs de données au DataNodes. Vous ne pouvez en utiliser qu'un seul NameNode. Type : tableau d’objets [HdfsNameNode](API_HdfsNameNode.md) Membres du tableau : Nombre minimum de 1 élément. Obligatoire : oui ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) ** La configuration de la qualité de protection (QOP) spécifie les paramètres RPC (Remote Procedure Call) et de protection du transfert de données configurés sur le cluster de système de fichiers distribué Hadoop (HDFS). Si la valeur `QopConfiguration` n'est pas spécifiée, les valeurs `RpcProtection` et `DataTransferProtection` par défaut sont `PRIVACY`. Si vous définissez `RpcProtection` ou `DataTransferProtection`, l'autre paramètre suppose la même valeur. Type : objet [QopConfiguration](API_QopConfiguration.md) Obligatoire : non ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) ** Le nombre de DataNodes vers lesquels répliquer les données lors de l'écriture dans le cluster HDFS. Par défaut, les données sont répliquées sur trois DataNodes. Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 512. Obligatoire : non ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) ** Le nom d'utilisateur servant à identifier le client sur le système d'exploitation hôte. Ce paramètre est requis si `SIMPLE` est spécifié pour `AuthenticationType`. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` Obligatoire : non ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) ** Un sous-répertoire du cluster HDFS. Ce sous-répertoire est utilisé pour lire des données à partir du cluster HDFS ou y écrire des données. Si le sous-répertoire n'est pas spécifié, la valeur par défaut est `/`. Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ** [Tags](#API_CreateLocationHdfs_RequestSyntax) ** Paire clé-valeur qui représente la balise que vous souhaitez ajouter à l'emplacement. La valeur peut être une chaîne vide. Nous vous recommandons d'utiliser des balises pour nommer vos ressources. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) ** L'ARN de l'emplacement du cluster HDFS source que vous créez. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) # CreateLocationNfs Crée un *emplacement* de transfert pour un serveur de fichiers NFS (Network File System). AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre comment DataSync [accéder aux serveurs de fichiers NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs). ## Syntaxe de la requête ``` { "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) ** Spécifie les options qui DataSync peuvent être utilisées pour monter votre serveur de fichiers NFS. Type : objet [NfsMountOptions](API_NfsMountOptions.md) Obligatoire : non ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent qui peut se connecter à votre serveur de fichiers NFS. Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section [Utilisation de plusieurs DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents). Type : objet [OnPremConfig](API_OnPremConfig.md) Obligatoire : oui ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) ** Spécifie le nom DNS ou l'adresse IP (IPv4 ou IPv6) du serveur de fichiers NFS auquel votre DataSync agent se connecte. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) ** Spécifie le chemin d'exportation sur le serveur de fichiers NFS que vous DataSync souhaitez monter. Ce chemin (ou un sous-répertoire du chemin) est l'endroit où les données sont DataSync transférées depuis ou vers. Pour plus d'informations sur la configuration d'une exportation pour DataSync, consultez la section [Accès aux serveurs de fichiers NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]+$` Obligatoire : oui ** [Tags](#API_CreateLocationNfs_RequestSyntax) ** Spécifie des étiquettes qui vous aident à classer, filtrer et rechercher vos AWS ressources. Nous vous recommandons de créer au moins une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) ** L'ARN de l'emplacement de transfert que vous avez créé pour votre serveur de fichiers NFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple L'exemple suivant crée un emplacement DataSync de transfert pour un serveur de fichiers NFS. #### Exemple de demande ``` { "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" } ] } ``` ### Exemple La réponse renvoie l'ARN de l'emplacement NFS. #### Exemple de réponse ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" } ``` ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs) # CreateLocationObjectStorage Crée un *emplacement* de transfert pour un système de stockage d'objets. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Vous pouvez effectuer des virements avec ou sans [DataSyncagent](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required). Avant de commencer, assurez-vous de connaître les [prérequis](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) pour travailler avec DataSync les systèmes de stockage d'objets. ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie la clé d'accès (par exemple, un nom d'utilisateur) si des informations d'identification sont requises pour s'authentifier auprès du serveur de stockage d'objets. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. Modèle : `^.*$` Obligatoire : non ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) ** (Facultatif) Spécifie les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre système de stockage d'objets. Si vous configurez un transfert cross-cloud sans agent, il n'est pas nécessaire de spécifier une valeur pour ce paramètre. Assurez-vous de configurer correctement ce paramètre lorsque vous créez votre emplacement de stockage pour la première fois. Il est impossible d'ajouter ou de supprimer des agents d'un emplacement de stockage après l'avoir créé. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie le nom du compartiment de stockage d'objets impliqué dans le transfert. Type : Chaîne Contraintes de longueur : Longueur minimum de 3. Longueur maximum de 63. Modèle : `^[a-zA-Z0-9_\-\+\.\$\p{Zs}]+$` Obligatoire : oui ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, notamment le `SecretKey` secret DataSync utilisé pour accéder à un emplacement de stockage d'objets spécifique, avec un secret géré par le client AWS KMS key. Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationObjectStorage` demande, vous ne fournissez que l'ARN de la clé KMS. DataSync utilise cette clé KMS avec la valeur que vous spécifiez pour le `SecretKey` paramètre afin de créer un secret DataSync géré afin de stocker les informations d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`SecretKey`) ou `CustomSecretConfig` (sans`SecretKey`) pour fournir des informations d'identification pour une `CreateLocationObjectStorage` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client dans lequel la clé secrète d'un emplacement de stockage d'objets spécifique est stockée en texte brut, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`SecretKey`) ou `CustomSecretConfig` (sans`SecretKey`) pour fournir des informations d'identification pour une `CreateLocationObjectStorage` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie la clé secrète (par exemple, un mot de passe) si des informations d'identification sont requises pour s'authentifier auprès du serveur de stockage d'objets. Si vous fournissez un code secret en utilisant `CmkSecretConfig` ou`SecretKey`, si vous ne fournissez pas de détails de configuration secrets`CustomSecretConfig`, vous DataSync stockez le jeton en utilisant le secret du Gestionnaire de Secrets Manager de votre AWS compte. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. Modèle : `^.*$` Obligatoire : non ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie une chaîne de certificats DataSync pour l'authentification auprès de votre système de stockage d'objets si celui-ci utilise une autorité de certification (CA) privée ou auto-signée. Vous devez spécifier un seul `.pem` fichier avec une chaîne de certificats complète (par exemple,`file:///home/user/.ssh/object_storage_certificates.pem`). La chaîne de certificats peut inclure : + Le certificat du système de stockage d'objets + Tous les certificats intermédiaires (s'il y en a) + Le certificat racine de l'autorité de certification signataire Vous pouvez concaténer vos certificats dans un `.pem` fichier (dont la taille peut atteindre 32 768 octets avant le codage base64). L'exemple de `cat` commande suivant crée un `object_storage_certificates.pem` fichier contenant trois certificats : `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` Pour utiliser ce paramètre, configurez `ServerProtocol` sur`HTTPS`. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 32 768. Obligatoire : non ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie le nom de domaine ou l'adresse IP (IPv4 ou IPv6) du serveur de stockage d'objets auquel votre DataSync agent se connecte. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obligatoire : oui ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie le port sur lequel votre serveur de stockage d'objets accepte le trafic réseau entrant (par exemple, le port 443). Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 65536. Obligatoire : non ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie le protocole utilisé par votre serveur de stockage d'objets pour communiquer. L'échelle par défaut, si elle n'est pas spécifiée, est de `HTTPS`. Type : Chaîne Valeurs valides : `HTTPS | HTTP` Obligatoire : non ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie le préfixe d'objet pour votre serveur de stockage d'objets. S'il s'agit d'un emplacement source, copie DataSync uniquement les objets portant ce préfixe. S'il s'agit d'un emplacement de destination, DataSync écrit tous les objets avec ce préfixe. Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) ** Spécifie la paire clé-valeur qui représente une balise que vous souhaitez ajouter à la ressource. Les balises vous aident à gérer, filtrer et rechercher vos ressources. Nous vous recommandons de créer une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) ** Spécifie l'ARN de l'emplacement du système de stockage d'objets que vous créez. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) # CreateLocationS3 Crée un *emplacement de* transfert pour un compartiment Amazon S3. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. **Important** Avant de commencer, assurez-vous de lire les rubriques suivantes : [Considérations relatives à la classe de stockage avec les sites Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Évaluation des coûts des requêtes S3 lors de l'utilisation DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) Pour plus d'informations, consultez [Configuration des transferts avec Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html). ## Syntaxe de la requête ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Amazon S3 sur Outposts uniquement) Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent sur votre Outpost. Pour plus d'informations, voir [Déployer votre DataSync agent sur AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** Spécifie l'ARN du compartiment S3 que vous souhaitez utiliser comme emplacement. (Lorsque vous créerez votre DataSync tâche ultérieurement, vous indiquerez si cet emplacement est une source ou une destination de transfert.) Si votre compartiment S3 se trouve sur une AWS Outposts ressource, vous devez spécifier un point d'accès Amazon S3. Pour plus d'informations, consultez [la section Gestion de l'accès aux données avec les points d'accès Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) dans le *guide de l'utilisateur Amazon S3*. Type : Chaîne Contraintes de longueur : longueur maximale de 268. Modèle : `^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}$` Obligatoire : oui ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) DataSync utilisé pour accéder à votre compartiment S3. Pour plus d'informations, consultez la section [Fournir DataSync un accès aux compartiments S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Type : objet [S3Config](API_S3Config.md) Obligatoire : oui ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** Spécifie la classe de stockage que vous souhaitez que vos objets utilisent lorsque Amazon S3 est une destination de transfert. Pour les compartiments entrants Régions AWS, la classe de stockage par défaut est. `STANDARD` Pour les buckets activés AWS Outposts, la classe de stockage par défaut est. `OUTPOSTS` Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux transferts Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Type : Chaîne Valeurs valides : `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Obligatoire : non ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** Spécifie un préfixe dans le compartiment S3 qui DataSync lit ou écrit vers (selon que le compartiment est un emplacement source ou de destination). DataSync Impossible de transférer des objets dont le préfixe commence par une barre oblique (`/`) ou inclut `//``/./`, ou `/../` des motifs. Par exemple : + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ** [Tags](#API_CreateLocationS3_RequestSyntax) ** Spécifie des étiquettes qui vous aident à classer, filtrer et rechercher vos AWS ressources. Nous vous recommandons de créer au moins une étiquette nominative pour votre lieu de transfert. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) ** L'ARN de l'emplacement S3 que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) # CreateLocationSmb Crée un *emplacement* de transfert pour un serveur de fichiers SMB (Server Message Block). AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de bien comprendre comment DataSync accéder aux serveurs de fichiers SMB. Pour plus d'informations, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) ** Spécifie l' DataSync agent (ou les agents) qui peuvent se connecter à votre serveur de fichiers SMB. Vous spécifiez un agent en utilisant son Amazon Resource Name (ARN). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [AuthenticationType](#API_CreateLocationSmb_RequestSyntax) ** Spécifie le protocole d'authentification DataSync utilisé pour se connecter à votre serveur de fichiers SMB. DataSync supports `NTLM` (par défaut) et `KERBEROS` authentification. Pour plus d'informations, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Type : Chaîne Valeurs valides : `NTLM | KERBEROS` Obligatoire : non ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, `Password` soit `KerberosKeytab` (pour les types `NTLM` (par défaut) et `KERBEROS` d'authentification, respectivement) DataSync utilisé pour accéder à un emplacement de stockage SMB spécifique, avec un emplacement géré par le client. AWS KMS key Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationSmbRequest` demande, vous fournissez uniquement l'ARN de la clé KMS. DataSync utilise cette clé KMS conjointement avec le secret géré `Password` ou `KerberosKeytab` que vous spécifiez pour créer un secret DataSync géré afin de stocker les informations d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec ou`KerberosKeytab`) `Password` ou `CustomSecretConfig` (sans `Password` et`KerberosKeytab`) pour fournir des informations d'identification pour une `CreateLocationSmbRequest` demande. Ne fournissez pas `CmkSecretConfig` les deux `CustomSecretConfig` paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Spécifie les informations de configuration d'un secret du Gestionnaire de secrets géré par le client dans lequel les informations d'identification de l'emplacement de stockage SMB sont stockées dans Secrets Manager sous forme de texte brut (pour`Password`) ou de binaire (pour). `KerberosKeytab` Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`SasConfiguration`) ou `CustomSecretConfig` (sans`SasConfiguration`) pour fournir des informations d'identification pour une `CreateLocationSmbRequest` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) ** Spécifie les IPv6 adresses IPv4 ou les adresses des serveurs DNS auxquels appartient votre serveur de fichiers SMB. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`KERBEROS`. Si votre environnement comporte plusieurs domaines, la configuration de ce paramètre garantit la DataSync connexion au bon serveur de fichiers SMB. Type : tableau de chaînes Membres du tableau : nombre maximum de 2 éléments. Contraintes de longueur : longueur minimale de 7. Longueur maximale de 39. Modèle : `\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` Obligatoire : non ** [Domain](#API_CreateLocationSmb_RequestSyntax) ** Spécifie le nom de domaine Windows auquel appartient votre serveur de fichiers SMB. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Si votre environnement comporte plusieurs domaines, la configuration de ce paramètre garantit la DataSync connexion au bon serveur de fichiers. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obligatoire : non ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) ** Spécifie votre fichier de table de clés Kerberos (keytab), qui inclut les mappages entre votre clé principale Kerberos et vos clés de chiffrement. Pour éviter les erreurs d'exécution des tâches, assurez-vous que le principal Kerberos que vous utilisez pour créer le fichier keytab correspond exactement à ce que vous spécifiez. `KerberosPrincipal` Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 65536. Obligatoire : non ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) ** Spécifie un fichier de configuration Kerberos (`krb5.conf`) qui définit la configuration de votre domaine Kerberos. Le fichier doit être codé en base64. Si vous utilisez le AWS CLI, le codage est fait pour vous. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 131072. Obligatoire : non ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) ** Spécifie un principal Kerberos, qui est une identité dans votre domaine Kerberos autorisée à accéder aux fichiers, aux dossiers et aux métadonnées des fichiers sur votre serveur de fichiers SMB. Un principal Kerberos peut ressembler à. `HOST/kerberosuser@MYDOMAIN.ORG` Les noms principaux distinguent les majuscules et minuscules. L'exécution de votre DataSync tâche échouera si le principal que vous spécifiez pour ce paramètre ne correspond pas exactement au principal que vous avez utilisé pour créer le fichier keytab. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^.+$` Obligatoire : non ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) ** Spécifie la version du protocole SMB DataSync utilisée pour accéder à votre serveur de fichiers SMB. Type : objet [SmbMountOptions](API_SmbMountOptions.md) Obligatoire : non ** [Password](#API_CreateLocationSmb_RequestSyntax) ** Spécifie le mot de passe de l'utilisateur qui peut monter votre serveur de fichiers SMB et qui est autorisé à accéder aux fichiers et dossiers concernés par votre transfert. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) ** Spécifie le nom de domaine ou l'adresse IP (IPv4 ou IPv6) du serveur de fichiers SMB auquel votre DataSync agent se connecte. Si vous utilisez l'authentification Kerberos, vous devez spécifier un nom de domaine. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obligatoire : oui ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) ** Spécifie le nom du partage exporté par votre serveur de fichiers SMB où les données DataSync seront lues ou écrites. Vous pouvez inclure un sous-répertoire dans le chemin de partage (par exemple,`/path/to/subdirectory`). Assurez-vous que les autres clients SMB de votre réseau peuvent également monter ce chemin. Pour copier toutes les données du sous-répertoire, vous DataSync devez être en mesure de monter le partage SMB et d'accéder à toutes ses données. Pour plus d'informations, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : oui ** [Tags](#API_CreateLocationSmb_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une balise de nom pour votre emplacement. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [User](#API_CreateLocationSmb_RequestSyntax) ** Spécifie l'utilisateur qui peut monter et accéder aux fichiers, aux dossiers et aux métadonnées des fichiers sur votre serveur de fichiers SMB. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationSmb_ResponseSyntax) ** L'ARN de l'emplacement SMB que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant crée un emplacement pour un serveur de fichiers 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" } ``` ### Exemple de réponse Une réponse renvoie l'ARN de l'emplacement de votre serveur de fichiers SMB. ``` { "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb) # CreateTask Configure une *tâche* qui définit où et comment vos données sont AWS DataSync transférées. Une tâche inclut un emplacement source, un emplacement de destination et des options de transfert (telles que les limites de bande passante, la planification, etc.). **Important** Si vous prévoyez de transférer des données depuis ou vers un site Amazon S3, examinez [comment cela DataSync peut affecter les frais de votre demande S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) et la [page de DataSync tarification](https://aws.amazon.com/datasync/pricing/) avant de commencer. ## Syntaxe de la requête ``` { "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" } } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) d'un groupe de CloudWatch journaux Amazon pour surveiller votre tâche. Pour les tâches en mode amélioré, il n'est pas nécessaire de spécifier quoi que ce soit. DataSyncenvoie automatiquement les journaux à un groupe de CloudWatch journaux nommé`/aws/datasync`. Pour plus d'informations, consultez la section [Surveillance des transferts de données à l'aide CloudWatch des journaux](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Type : Chaîne Contraintes de longueur : longueur maximale de 562. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obligatoire : non ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Spécifie l'ARN de l'emplacement de destination de votre transfert. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Excludes](#API_CreateTask_RequestSyntax) ** Spécifie les filtres d'exclusion qui définissent les fichiers, les objets et les dossiers de votre emplacement source que vous ne DataSync souhaitez pas transférer. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [Includes](#API_CreateTask_RequestSyntax) ** Spécifie les filtres d'inclusion qui définissent les fichiers, les objets et les dossiers que vous souhaitez DataSync transférer dans votre emplacement source. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** Configure un manifeste, qui est une liste de fichiers ou d'objets que vous souhaitez DataSync transférer. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle DataSync avec lequel vous utilisez) doit être `iam:PassRole` autorisée. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Type : objet [ManifestConfig](API_ManifestConfig.md) Obligatoire : non ** [Name](#API_CreateTask_RequestSyntax) ** Spécifie le nom de votre tâche. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ** [Options](#API_CreateTask_RequestSyntax) ** Spécifie les paramètres de votre tâche, tels que la préservation des métadonnées des fichiers, la vérification de l'intégrité des données, entre autres options. Type : objet [Options](API_Options.md) Obligatoire : non ** [Schedule](#API_CreateTask_RequestSyntax) ** Spécifie le calendrier d'exécution de la tâche. Pour plus d'informations, veuillez consulter la rubrique [Planification de votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Type : objet [TaskSchedule](API_TaskSchedule.md) Obligatoire : non ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Spécifie l'ARN de l'emplacement source de votre transfert. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Tags](#API_CreateTask_RequestSyntax) ** Spécifie les balises que vous souhaitez appliquer à votre tâche. Les *balises* sont des paires clé-valeur qui vous permettent de gérer, de filtrer et de rechercher vos DataSync ressources. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [TaskMode](#API_CreateTask_RequestSyntax) ** Spécifie l'un des modes de tâche suivants pour le transfert de données : + `ENHANCED`- Transférez un nombre pratiquement illimité d'objets avec des performances supérieures à celles du mode Basic. Les tâches en mode amélioré optimisent le processus de transfert de données en listant, préparant, transférant et vérifiant les données en parallèle. Le mode amélioré est actuellement disponible pour les transferts entre les sites Amazon S3, les transferts entre Azure Blob et Amazon S3 sans agent, et les transferts entre d'autres clouds et Amazon S3 sans agent. **Note** Pour créer une tâche en mode amélioré, le rôle IAM que vous utilisez pour appeler l'`CreateTask`opération doit disposer de l'`iam:CreateServiceLinkedRole`autorisation. + `BASIC`(par défaut) - Transférez des fichiers ou des objets entre le AWS stockage et tous les autres DataSync emplacements pris en charge. Les tâches en mode de base sont soumises à [des quotas](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) sur le nombre de fichiers, d'objets et de répertoires dans un ensemble de données. Le mode de base prépare, transfère et vérifie les données de manière séquentielle, ce qui le rend plus lent que le mode amélioré pour la plupart des charges de travail. Pour plus d'informations, voir [Comprendre les différences entre les modes de tâche](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences). Type : Chaîne Valeurs valides : `BASIC | ENHANCED` Obligatoire : non ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** Spécifie la manière dont vous souhaitez configurer un rapport de tâches, qui fournit des informations détaillées sur votre DataSync transfert. Pour plus d'informations, consultez la section [Surveillance de vos DataSync transferts à l'aide de rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle DataSync avec lequel vous utilisez) doit être `iam:PassRole` autorisée. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Type : objet [TaskReportConfig](API_TaskReportConfig.md) Obligatoire : non ## Syntaxe de la réponse ``` { "TaskArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** Amazon Resource Name (ARN) de la tâche. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande pour une tâche en mode amélioré L'exemple suivant crée une DataSync tâche qui utilise le mode amélioré. Contrairement à la création de tâches en mode Basic, il n'est pas nécessaire de spécifier un groupe de CloudWatch journaux Amazon. Avec les tâches en mode amélioré, envoie DataSync automatiquement les journaux des tâches à un groupe de journaux nommé`/aws/datasync`. Si ce groupe de journaux n'existe pas dans votre Région AWS, DataSync crée le groupe de journaux en votre nom lorsque vous créez la tâche. ``` { "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" } } ``` ### Exemple de demande pour une tâche en mode de base L'exemple suivant crée une DataSync tâche qui utilise le mode de base. ``` { "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" } ] } ``` ### Exemple de réponse La réponse suivante inclut l'ARN d'une tâche créée. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask) # DeleteAgent Supprime une ressource d' AWS DataSync agent de votre Compte AWS. N'oubliez pas que cette opération (irréversible) ne supprime pas la machine virtuelle (VM) ou l'instance Amazon EC2 de l'agent de votre environnement de stockage. Pour les étapes suivantes, vous pouvez supprimer la machine virtuelle ou l'instance de votre environnement de stockage ou la réutiliser pour [activer un nouvel agent](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html). ## Syntaxe de la requête ``` { "AgentArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArn](#API_DeleteAgent_RequestSyntax) ** Le nom de ressource Amazon (ARN) de l'agent à supprimer. Utilisez cette `ListAgents` opération pour renvoyer une liste d'agents pour votre compte et Région AWS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) # DeleteLocation Supprime une ressource de lieu de transfert de AWS DataSync. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DeleteLocation_RequestSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement à supprimer. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) # DeleteTask Supprime une ressource de tâche de transfert de AWS DataSync. ## Syntaxe de la requête ``` { "TaskArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [TaskArn](#API_DeleteTask_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la tâche que vous souhaitez supprimer. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteTask) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) # DescribeAgent Renvoie des informations sur un AWS DataSync agent, telles que son nom, son type de point de terminaison de service et son statut. ## Syntaxe de la requête ``` { "AgentArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArn](#API_DescribeAgent_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent sur lequel vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "AgentArn": "string", "CreationTime": number, "EndpointType": "string", "LastConnectionTime": number, "Name": "string", "Platform": { "Version": "string" }, "PrivateLinkConfig": { "PrivateLinkEndpoint": "string", "SecurityGroupArns": [ "string" ], "SubnetArns": [ "string" ], "VpcEndpointId": "string" }, "Status": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AgentArn](#API_DescribeAgent_ResponseSyntax) ** ARN de l’agent. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Heure à laquelle l'agent a été [activé](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html). Type : Timestamp ** [EndpointType](#API_DescribeAgent_ResponseSyntax) ** Type de point de [terminaison de service](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html) auquel votre agent est connecté. Type : Chaîne Valeurs valides : `PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK` ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) ** La dernière fois que l'agent a communiqué avec le DataSync service. Type : Timestamp ** [Name](#API_DescribeAgent_ResponseSyntax) ** Le nom de l'agent. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` ** [Platform](#API_DescribeAgent_ResponseSyntax) ** Les informations relatives à la plate-forme concernant l'agent, telles que le numéro de version. Type : objet [Platform](API_Platform.md) ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) ** Configuration réseau utilisée par l'agent lors de la connexion à un point de terminaison de [service VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc). Type : objet [PrivateLinkConfig](API_PrivateLinkConfig.md) ** [Status](#API_DescribeAgent_ResponseSyntax) ** Le statut de l'agent. + Si le statut est défini`ONLINE`, l'agent est correctement configuré et prêt à être utilisé. + Si le statut est le cas`OFFLINE`, cela signifie que l'agent a été hors de contact avec DataSync lui pendant cinq minutes ou plus. Cela peut se produire pour plusieurs raisons. Pour plus d'informations, voir [Que dois-je faire si mon agent est hors ligne ?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) Type : Chaîne Valeurs valides : `ONLINE | OFFLINE` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant renvoie des informations sur un agent spécifié dans une demande. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0" } ``` ### Exemple de réponse L'exemple de réponse suivant décrit un agent qui utilise un point de terminaison de service public. ``` { "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" } } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeAgent) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeAgent) # DescribeLocationAzureBlob Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour Microsoft Azure Blob Storage. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationAzureBlob_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de votre emplacement de transfert Azure Blob Storage. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Le niveau d'accès vers lequel vous souhaitez transférer vos objets ou fichiers. Cela s'applique uniquement lorsque l'emplacement est utilisé comme destination de transfert. Pour plus d'informations, consultez la section [Niveaux d'accès](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Type : Chaîne Valeurs valides : `HOT | COOL | ARCHIVE` ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Les ARNs DataSync agents qui peuvent se connecter à votre conteneur Azure Blob Storage. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** La méthode d'authentification DataSync utilisée pour accéder à votre Azure Blob Storage. DataSync peut accéder au stockage blob à l'aide d'une signature d'accès partagé (SAS). Type : Chaîne Valeurs valides : `SAS | NONE` ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Type de blob que vous souhaitez attribuer à vos objets ou fichiers lorsque vous les transférez dans Azure Blob Storage. Actuellement, DataSync ne prend en charge le transfert de données vers Azure Blob Storage que sous forme de blobs de blocs. Pour plus d'informations sur les types de blob, consultez la documentation [Azure Blob Storage](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs). Type : Chaîne Valeurs valides : `BLOCK` ** [CmkSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel qu'un jeton d'authentification DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un code géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Heure à laquelle votre emplacement de transfert Azure Blob Storage a été créé. Type : Timestamp ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Décrit les informations de configuration d'un secret géré par le client, tel qu'un jeton d'authentification DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) ** L'ARN de votre emplacement de transfert Azure Blob Storage. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** URL du conteneur Azure Blob Storage impliqué dans votre transfert. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel qu'un jeton d'authentification DataSync utilisé pour accéder à un emplacement de stockage spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager Type : objet [ManagedSecretConfig](API_ManagedSecretConfig.md) ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) # DescribeLocationEfs Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour un système de fichiers Amazon EFS. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement du système de fichiers Amazon EFS sur lequel vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "AccessPointArn": "string", "CreationTime": number, "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "LocationUri": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) ** L'ARN du point d'accès DataSync utilisé pour accéder au système de fichiers Amazon EFS. Pour plus d'informations, consultez la section [Accès aux systèmes de fichiers restreints](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Heure à laquelle le lieu a été créé. Type : Timestamp ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) ** Sous-réseau et groupes de sécurité AWS DataSync utilisés pour se connecter à l'une des [cibles de montage](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) de votre système de fichiers Amazon EFS. Type : objet [Ec2Config](API_Ec2Config.md) ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) ** Rôle Gestion des identités et des accès AWS (IAM) qui permet d'accéder DataSync à votre système de fichiers Amazon EFS. Pour plus d'informations, consultez la section [Création d'un rôle DataSync IAM pour l'accès au système de fichiers](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) ** Indique si le chiffrement TLS (Transport Layer Security) est DataSync utilisé lors du transfert de données vers ou depuis le système de fichiers Amazon EFS. Type : Chaîne Valeurs valides : `NONE | TLS1_2` ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) ** L'ARN de l'emplacement du système de fichiers Amazon EFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** URL de l'emplacement du système de fichiers Amazon EFS. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant montre comment obtenir des informations sur l'emplacement d'un système de fichiers Amazon EFS spécifique. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ### Exemple de réponse L'exemple suivant renvoie les détails de localisation d'un système de fichiers 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/" } ``` ### Exemple de réponse : description de l'emplacement d'un système de fichiers Amazon EFS restreint L'exemple suivant renvoie les détails de localisation d'un système de fichiers Amazon EFS à accès restreint`AccessPointArn`, notamment les `InTransitEncryption` éléments`FileSystemAccessRoleArn`, et. ``` { "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" }] } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs) # DescribeLocationFsxLustre Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert FSx pour un système de fichiers Amazon for Lustre. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationFsxLustre_RequestSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement FSx pour Lustre à décrire. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "SecurityGroupArns": [ "string" ] } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) ** Heure à laquelle l'emplacement FSx pour Lustre a été créé. Type : Timestamp ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement FSx pour Lustre décrit. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'URI de l'emplacement FSx pour Lustre qui a été décrit. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) ** Les Amazon Resource Names (ARNs) des groupes de sécurité configurés pour le système de fichiers FSx for Lustre. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) # DescribeLocationFsxOntap Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert FSx pour un système de fichiers Amazon for NetApp ONTAP. **Note** Si votre position utilise le protocole SMB, l'`DescribeLocationFsxOntap`opération ne renvoie pas réellement un`Password`. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationFsxOntap_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement du système FSx de fichiers ONTAP sur lequel vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Heure à laquelle le lieu a été créé. Type : Timestamp ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** L'ARN du système de fichiers FSx for ONTAP. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'ARN de l'emplacement du système de fichiers FSx pour ONTAP. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'identifiant de ressource uniforme (URI) de l'emplacement du système FSx de fichiers ONTAP. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Spécifie le protocole de transfert de données AWS DataSync utilisé pour accéder à votre système de FSx fichiers Amazon. Type : objet [FsxProtocol](API_FsxProtocol.md) ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Les groupes de sécurité DataSync utilisés pour accéder à votre système de fichiers FSx for ONTAP. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'ARN de la machine virtuelle de stockage (SVM) de votre système de fichiers FSx for ONTAP vers ou depuis laquelle vous copiez des données. Type : Chaîne Contraintes de longueur : longueur maximale de 162. Modèle : `^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,}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) # DescribeLocationFsxOpenZfs Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert FSx pour un système de fichiers Amazon pour OpenZFS. **Note** Les éléments de réponse associés à `SMB` ne sont pas pris en charge par l'`DescribeLocationFsxOpenZfs`opération. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationFsxOpenZfs_RequestSyntax) ** Nom de ressource Amazon (ARN) de l'emplacement FSx pour OpenZFS à décrire. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" ] } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Heure à laquelle l'emplacement FSx pour OpenZFS a été créé. Type : Timestamp ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** L'ARN de l'emplacement FSx pour OpenZFS décrit. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'identifiant de ressource uniforme (URI) de l'emplacement FSx pour OpenZFS décrit. Exemple : `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder` Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Type de protocole AWS DataSync utilisé pour accéder à votre système de fichiers. Type : objet [FsxProtocol](API_FsxProtocol.md) ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Les groupes ARNs de sécurité configurés FSx pour le système de fichiers OpenZFS. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) # DescribeLocationFsxWindows Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert FSx pour un système de fichiers Amazon pour Windows File Server. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationFsxWindows_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement du serveur de fichiers FSx pour Windows. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel `Password` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Heure à laquelle l'emplacement FSx du serveur de fichiers Windows a été créé. Type : Timestamp ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Décrit les informations de configuration d'un secret géré par le client, tel `Password` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Nom du domaine Microsoft Active Directory auquel appartient le système de fichiers FSx pour Windows File Server. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` ** [LocationArn](#API_DescribeLocationFsxWindows_ResponseSyntax) ** L'ARN de l'emplacement du serveur de fichiers FSx pour Windows. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'identifiant de ressource uniforme (URI) de FSx l'emplacement du serveur de fichiers Windows. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel `Password` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager Type : objet [ManagedSecretConfig](API_ManagedSecretConfig.md) ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Les ARN des groupes de sécurité Amazon EC2 qui fournissent l'accès au sous-réseau préféré de votre système de fichiers. Pour plus d'informations sur la configuration des groupes de sécurité pour l'accès au système de fichiers, consultez le [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). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Utilisateur autorisé à monter et à accéder au système de fichiers FSx for Windows File Server. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) # DescribeLocationHdfs Fournit des détails sur la configuration d'un emplacement de AWS DataSync transfert pour un système de fichiers distribué Hadoop (HDFS). ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement HDFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) ** Les ARNs DataSync agents qui peuvent se connecter à votre cluster HDFS. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Type d'authentification utilisé pour déterminer l'identité de l'utilisateur. Type : Chaîne Valeurs valides : `SIMPLE | KERBEROS` ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) ** Taille des blocs de données à écrire dans le cluster HDFS. Type : Integer Plage valide : valeur minimale de 1048576. Valeur maximale de 1073741824. ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel `KerberosKeytab` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) ** Heure à laquelle l'emplacement HDFS a été créé. Type : Timestamp ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** Décrit les informations de configuration d'un secret géré par le client, tel `KerberosKeytab` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) ** Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS. Ce paramètre est utilisé si le `AuthenticationType` est défini comme`KERBEROS`. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^.+$` ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) ** L'URI du serveur de gestion de clés (KMS) du cluster HDFS. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères. Modèle : `^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) ** L'ARN de l'emplacement HDFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'URI de l'emplacement HDFS. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel `KerberosKeytab` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager Type : objet [ManagedSecretConfig](API_ManagedSecretConfig.md) ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) ** Celui NameNode qui gère l'espace de noms HDFS. Type : tableau d’objets [HdfsNameNode](API_HdfsNameNode.md) Membres du tableau : Nombre minimum de 1 élément. ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) ** La configuration de la qualité de protection (QOP), qui spécifie les paramètres d'appel de procédure à distance (RPC) et de protection contre le transfert de données configurés sur le cluster HDFS. Type : objet [QopConfiguration](API_QopConfiguration.md) ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) ** Le nombre de DataNodes vers lesquels répliquer les données lors de l'écriture dans le cluster HDFS. Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 512. ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) ** Nom d'utilisateur permettant d'identifier le client sur le système d'exploitation hôte. Ce paramètre est utilisé si le `AuthenticationType` est défini comme`SIMPLE`. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) # DescribeLocationNfs Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour un serveur de fichiers NFS (Network File System). ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationNfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement NFS sur lequel vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] } } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) ** Heure à laquelle l'emplacement NFS a été créé. Type : Timestamp ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) ** L'ARN de l'emplacement NFS. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'URI de l'emplacement NFS. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) ** Les options de montage DataSync utilisées pour monter votre serveur de fichiers NFS. Type : objet [NfsMountOptions](API_NfsMountOptions.md) ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) ** Les AWS DataSync agents qui peuvent se connecter à votre serveur de fichiers NFS (Network File System). Type : objet [OnPremConfig](API_OnPremConfig.md) ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple L'exemple suivant renvoie des informations sur l'emplacement NFS spécifié dans l'exemple de demande. #### Exemple de demande ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" } ``` ### Exemple Cet exemple illustre une utilisation de DescribeLocationNfs. #### Exemple de réponse ``` { "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" ] } } ``` ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationNfs) # DescribeLocationObjectStorage Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour un système de stockage d'objets. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationObjectStorage_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement du système de stockage d'objets. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) ** La clé d'accès (par exemple, un nom d'utilisateur) requise pour s'authentifier auprès du système de stockage d'objets. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. Modèle : `^.*$` ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Les ARNs DataSync agents qui peuvent se connecter à votre système de stockage d'objets. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Décrit les informations de configuration pour un secret DataSync géré, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Heure à laquelle le lieu a été créé. Type : Timestamp ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Décrit les informations de configuration d'un secret géré par le client, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync permettant d'accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) ** L'ARN de l'emplacement du système de stockage d'objets. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'URI de l'emplacement du système de stockage d'objets. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification permettant DataSync d'accéder à un emplacement de transfert spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager Type : objet [ManagedSecretConfig](API_ManagedSecretConfig.md) ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Chaîne de certificats permettant DataSync de s'authentifier auprès de votre système de stockage d'objets si celui-ci utilise une autorité de certification (CA) privée ou autosignée. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 32 768. ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Port sur lequel votre serveur de stockage d'objets accepte le trafic réseau entrant (par exemple, le port 443). Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 65536. ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Protocole utilisé par votre système de stockage d'objets pour communiquer. Type : Chaîne Valeurs valides : `HTTPS | HTTP` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) # DescribeLocationS3 Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour un compartiment S3. ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement Amazon S3. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "AgentArns": [ "string" ], "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AgentArns](#API_DescribeLocationS3_ResponseSyntax) ** Le ARNs nombre d' DataSync agents déployés sur votre Outpost lorsque vous utilisez Amazon S3 on Outposts. Pour plus d'informations, consultez la section [Déployer votre DataSync agent sur AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Heure à laquelle l'emplacement Amazon S3 a été créé. Type : Timestamp ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) ** L'ARN de l'emplacement Amazon S3. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** URL de l'emplacement Amazon S3 décrit. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) ** Spécifie le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) DataSync utilisé pour accéder à votre compartiment S3. Pour plus d'informations, consultez la section [Fournir DataSync un accès aux compartiments S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Type : objet [S3Config](API_S3Config.md) ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) ** Lorsque Amazon S3 est un emplacement de destination, il s'agit de la classe de stockage que vous avez choisie pour vos objets. Certaines classes de stockage ont des comportements qui peuvent avoir une incidence sur les coûts de stockage de votre Amazon S3. Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux transferts Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Type : Chaîne Valeurs valides : `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple L'exemple suivant renvoie des informations sur l'emplacement Amazon S3 spécifié dans l'exemple de demande. #### Exemple de demande ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3" } ``` ### Exemple Cet exemple illustre une utilisation de DescribeLocation S3. #### Exemple de réponse ``` { "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" } ``` ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3) # DescribeLocationSmb Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour un serveur de fichiers SMB (Server Message Block). ## Syntaxe de la requête ``` { "LocationArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement SMB sur lequel vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) ** Les ARNs DataSync agents qui peuvent se connecter à votre serveur de fichiers SMB. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Protocole d'authentification DataSync utilisé pour se connecter à votre serveur de fichiers SMB. Type : Chaîne Valeurs valides : `NTLM | KERBEROS` ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel qu'un `Password` ou `KerberosKeytab` DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) ** Heure à laquelle l'emplacement SMB a été créé. Type : Timestamp ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** Décrit les informations de configuration d'un secret géré par le client, tel `KerberosKeytab` qu'un `Password` ou DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) ** Les IPv6 adresses IPv4 ou des serveurs DNS auxquels appartient votre serveur de fichiers SMB. Cet élément ne s'applique que s'`AuthenticationType`il est défini sur`KERBEROS`. Type : tableau de chaînes Membres du tableau : nombre maximum de 2 éléments. Contraintes de longueur : longueur minimale de 7. Longueur maximale de 39 Modèle : `\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) ** Nom du domaine Windows auquel appartient le serveur de fichiers SMB. Cet élément ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) ** Le principal Kerberos autorisé à accéder aux fichiers, aux dossiers et aux métadonnées des fichiers sur votre serveur de fichiers SMB. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^.+$` ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) ** L'ARN de l'emplacement SMB. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'URI de l'emplacement SMB. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** Décrit les informations de configuration d'un secret DataSync géré, tel qu'un `Password` ou `KerberosKeytab` DataSync utilisé pour accéder à un emplacement de stockage spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager Type : objet [ManagedSecretConfig](API_ManagedSecretConfig.md) ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) ** Version du protocole SMB DataSync utilisée pour accéder à votre serveur de fichiers SMB. Type : objet [SmbMountOptions](API_SmbMountOptions.md) ** [User](#API_DescribeLocationSmb_ResponseSyntax) ** L'utilisateur qui peut monter et accéder aux fichiers, aux dossiers et aux métadonnées des fichiers sur votre serveur de fichiers SMB. Cet élément ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple Cet exemple illustre une utilisation de DescribeLocationSmb. #### Exemple de demande ``` { "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ### Exemple Cet exemple illustre une utilisation de DescribeLocationSmb. #### Exemple de réponse ``` { "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" } ``` ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb) # DescribeTask Fournit des informations sur une *tâche*, qui définit où et comment AWS DataSync vos données sont transférées. ## Syntaxe de la requête ``` { "TaskArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [TaskArn](#API_DescribeTask_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la tâche de transfert sur laquelle vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) ** Le nom de ressource Amazon (ARN) d'un groupe de CloudWatch journaux Amazon pour le suivi de votre tâche. Pour plus d'informations, consultez la section [Surveillance des transferts de données à l'aide CloudWatch des journaux](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Type : Chaîne Contraintes de longueur : longueur maximale de 562. Modèle : `^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) ** Heure à laquelle la tâche a été créée. Type : Timestamp ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) ** L'ARN de la dernière exécution de tâche. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** L'ARN du lieu de destination de votre transfert. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Les ARNs [interfaces réseau](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) DataSync créées pour votre emplacement de destination. Type : tableau de chaînes Contraintes de longueur : Longueur maximum de 128. Modèle : `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` ** [ErrorCode](#API_DescribeTask_ResponseSyntax) ** En cas de problème avec votre tâche, vous pouvez utiliser le code d'erreur pour vous aider à le résoudre. Pour plus d'informations, consultez la section [Résolution des problèmes liés aux DataSync transferts](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Type : Chaîne ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) ** En cas de problème avec votre tâche, vous pouvez utiliser les détails de l'erreur pour résoudre le problème. Pour plus d'informations, consultez la section [Résolution des problèmes liés aux DataSync transferts](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Type : Chaîne ** [Excludes](#API_DescribeTask_ResponseSyntax) ** Les filtres d'exclusion qui définissent les fichiers, les objets et les dossiers de votre emplacement source que vous ne DataSync souhaitez pas transférer. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. ** [Includes](#API_DescribeTask_ResponseSyntax) ** Ils incluent des filtres qui définissent les fichiers, les objets et les dossiers que vous souhaitez DataSync transférer dans votre emplacement source. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) ** Configuration du manifeste qui répertorie les fichiers ou les objets que vous DataSync souhaitez transférer. Pour plus d'informations, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Type : objet [ManifestConfig](API_ManifestConfig.md) ** [Name](#API_DescribeTask_ResponseSyntax) ** Le nom de votre tâche. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` ** [Options](#API_DescribeTask_ResponseSyntax) ** Les paramètres de la tâche. Par exemple, quelles métadonnées de fichier sont préservées, comment l'intégrité des données est vérifiée à la fin du transfert, limites de bande passante, entre autres options. Type : objet [Options](API_Options.md) ** [Schedule](#API_DescribeTask_ResponseSyntax) ** Le calendrier selon lequel vous souhaitez que votre tâche soit exécutée. Pour plus d'informations, veuillez consulter la rubrique [Planification de votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Type : objet [TaskSchedule](API_TaskSchedule.md) ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) ** Les détails concernant le [planning de vos tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Type : objet [TaskScheduleDetails](API_TaskScheduleDetails.md) ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) ** L'ARN de l'emplacement source de votre transfert. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Les ARNs [interfaces réseau](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) DataSync créées pour votre emplacement source. Type : tableau de chaînes Contraintes de longueur : Longueur maximum de 128. Modèle : `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` ** [Status](#API_DescribeTask_ResponseSyntax) ** État de votre tâche. Pour plus d'informations sur la signification de chaque statut, consultez la section [Statuts des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses). Type : Chaîne Valeurs valides : `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` ** [TaskArn](#API_DescribeTask_ResponseSyntax) ** L'ARN de votre tâche. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Le mode tâche que vous utilisez. Pour plus d'informations, consultez la section [Choix d'un mode de tâche pour le transfert de données](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Chaîne Valeurs valides : `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) ** La configuration de votre rapport de tâches, qui fournit des informations détaillées sur votre DataSync transfert. Pour plus d'informations, consultez la section [Surveillance de vos DataSync transferts à l'aide de rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Type : objet [TaskReportConfig](API_TaskReportConfig.md) ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant indique l'ARN d'une DataSync tâche sur laquelle vous souhaitez obtenir des informations. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### Exemple de réponse L'exemple suivant montre une `DescribeTask` réponse. ``` { "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:*" } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTask) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask) # DescribeTaskExecution Fournit des informations sur l'exécution de votre AWS DataSync tâche. Vous pouvez utiliser cette opération pour suivre la progression d'un transfert de données en cours ou vérifier les résultats du transfert. **Note** Certains éléments de `DescribeTaskExecution` réponse ne concernent qu'un mode de tâche spécifique. Pour plus d'informations, voir [Comprendre les différences entre les modes de tâche](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) et [Comprendre les compteurs de performance du transfert de données](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html). ## Syntaxe de la requête ``` { "TaskExecutionArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'exécution de la tâche sur laquelle vous souhaitez obtenir des informations. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Syntaxe de la réponse ``` { "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" } } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) ** Nombre d'octets physiques DataSync transférés sur le réseau après compression (si la compression est possible). Ce nombre est généralement inférieur à [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)sauf si les données ne sont pas compressibles. Type : Long ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Nombre d'octets DataSync envoyés au réseau avant la compression (si la compression est possible). Pour le nombre d'octets transférés sur le réseau, consultez [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed). Type : Long ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre d'octets logiques qui écrivent DataSync réellement sur l'emplacement de destination. Type : Long ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) ** Heure de fin de la tâche de transfert. Type : Timestamp ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre d'octets logiques qui DataSync devraient écrire sur l'emplacement de destination. Type : Long ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers, d'objets et de répertoires qui DataSync devraient être supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), la valeur est toujours`0`. Pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), ce compteur inclut uniquement les fichiers ou les objets. Les annuaires sont comptés dans [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete). Type : Long ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers, d'objets et de répertoires qui DataSync devraient être transférés sur le réseau. Cette valeur est calculée lors de la DataSync [préparation](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) du transfert. La façon dont cela est calculé dépend principalement de la configuration du [mode de transfert](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) de votre tâche : + Il `TranserMode` est défini sur `CHANGED` - Le calcul est basé sur la comparaison du contenu des emplacements source et de destination et sur la détermination de la différence à transférer. La différence peut inclure : + Tout ce qui est ajouté ou modifié à l'emplacement source. + Tout ce qui se trouve aux deux emplacements et qui est modifié à destination après un transfert initial (sauf s'[OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)il est défini sur`NEVER`). + **(Mode tâche de base uniquement)** Nombre d'éléments qui devraient DataSync être supprimés (s'il [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)est défini sur`REMOVE`). + Si la valeur `TranserMode` est définie sur `ALL` - Le calcul est basé uniquement sur les éléments DataSync trouvés à l'emplacement source. Pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), ce compteur inclut uniquement les fichiers ou les objets. Les annuaires sont comptés dans [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer). Type : Long ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires qui DataSync devraient être supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), la valeur est toujours`0`. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Long ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires qui DataSync devraient être transférés sur le réseau. Cette valeur est calculée lors de la DataSync [préparation](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) des répertoires à transférer. La façon dont cela est calculé dépend principalement de la configuration du [mode de transfert](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) de votre tâche : + Il `TranserMode` est défini sur `CHANGED` - Le calcul est basé sur la comparaison du contenu des emplacements source et de destination et sur la détermination de la différence à transférer. La différence peut inclure : + Tout ce qui est ajouté ou modifié à l'emplacement source. + Tout ce qui se trouve aux deux emplacements et qui est modifié à destination après un transfert initial (sauf s'[OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)il est défini sur`NEVER`). + Si la valeur `TranserMode` est définie sur `ALL` - Le calcul est basé uniquement sur les éléments DataSync trouvés à l'emplacement source. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Long ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) ** Liste de règles de filtrage qui excluent des données spécifiques lors de votre transfert. Pour plus d'informations et des exemples, consultez la section [Filtrage des données transférées par DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers, d'objets et de répertoires DataSync réellement supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), la valeur est toujours`0`. Pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), ce compteur inclut uniquement les fichiers ou les objets. Les annuaires sont comptés dans [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted). Type : Long ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers ou d'objets dont la préparation, le transfert, la vérification et la suppression DataSync échouent lors de l'exécution de la tâche. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : objet [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers ou d'objets DataSync trouvés sur votre site. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : objet [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers ou d'objets qui DataSync tenteront d'être transférés après avoir comparé les emplacements source et de destination. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Ce compteur n'est pas applicable si vous configurez votre tâche pour [transférer toutes les données](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Dans ce scénario, DataSync copie tout de la source vers la destination sans comparer les différences entre les emplacements. Type : Long ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers, d'objets et de répertoires DataSync ignorés lors de votre transfert. Pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), ce compteur inclut uniquement les fichiers ou les objets. Les annuaires sont comptés dans [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped). Type : Long ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers, d'objets et de répertoires DataSync réellement transférés sur le réseau. Cette valeur est mise à jour régulièrement pendant l'exécution de la tâche lorsqu'un élément est lu depuis la source et envoyé sur le réseau. En cas d' DataSync échec du transfert, cette valeur peut être inférieure à`EstimatedFilesToTransfer`. Dans certains cas, cette valeur peut également être supérieure à`EstimatedFilesToTransfer`. Cet élément est spécifique à l'implémentation pour certains types d'emplacement. Ne l'utilisez donc pas comme une indication exacte de ce qui est transféré ou pour surveiller l'exécution de vos tâches. Pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), ce compteur inclut uniquement les fichiers ou les objets. Les annuaires sont comptés dans [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred). Type : Long ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de fichiers, d'objets et de répertoires qui sont DataSync vérifiés lors de votre transfert. Lorsque vous configurez votre tâche pour [vérifier uniquement les données transférées](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync elle ne vérifie pas les répertoires dans certains cas ni les fichiers qui ne parviennent pas à être transférés. Pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), ce compteur inclut uniquement les fichiers ou les objets. Les annuaires sont comptés dans [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified). Type : Long ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires DataSync réellement supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), la valeur est toujours`0`. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Long ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) ** Nombre de répertoires dont la liste, la préparation, le transfert, la vérification et la suppression DataSync échouent pendant l'exécution de votre tâche. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : objet [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires DataSync trouvés dans vos établissements. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : objet [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires qui DataSync tenteront d'être transférés après avoir comparé vos emplacements source et de destination. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Ce compteur n'est pas applicable si vous configurez votre tâche pour [transférer toutes les données](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Dans ce scénario, DataSync copie tout de la source vers la destination sans comparer les différences entre les emplacements. Type : Long ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires DataSync ignorés lors de votre transfert. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Long ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires DataSync réellement transférés sur le réseau. Cette valeur est mise à jour régulièrement pendant l'exécution de la tâche lorsqu'un élément est lu depuis la source et envoyé sur le réseau. En cas d' DataSync échec du transfert, cette valeur peut être inférieure à`EstimatedFoldersToTransfer`. Dans certains cas, cette valeur peut également être supérieure à`EstimatedFoldersToTransfer`. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Long ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) ** Le nombre de répertoires qui sont DataSync vérifiés lors de votre transfert. S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Long ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) ** Liste de règles de filtrage qui incluent des données spécifiques lors de votre transfert. Pour plus d'informations et des exemples, consultez la section [Filtrage des données transférées par DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) ** Heure à laquelle l'exécution de la tâche commence réellement. Pour les tâches ne figurant pas dans la file d'attente, `LaunchTime` `StartTime` elles sont généralement identiques. Pour les tâches en file d'attente, `LaunchTime` c'est généralement plus tard que `StartTime` parce que les tâches précédemment mises en file d'attente doivent terminer leur exécution avant que les nouvelles tâches puissent commencer. Type : Timestamp ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) ** Configuration du manifeste qui répertorie les fichiers ou les objets à transférer. Pour plus d'informations, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Type : objet [ManifestConfig](API_ManifestConfig.md) ** [Options](#API_DescribeTaskExecution_ResponseSyntax) ** Indique comment votre tâche de transfert est configurée. Ces options incluent le mode DataSync de gestion des fichiers, des objets et des métadonnées associées lors de votre transfert. Vous pouvez également spécifier comment vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options. Chaque option possède une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas à configurer d'option avant d'appeler [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Vous pouvez également remplacer vos options de tâche pour chaque exécution de tâche. Par exemple, vous souhaiterez peut-être ajuster le `LogLevel` pour une exécution individuelle. Type : objet [Options](API_Options.md) ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) ** Indique si un [rapport de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) complet a été DataSync généré pour votre transfert. Type : objet [ReportResult](API_ReportResult.md) ** [Result](#API_DescribeTaskExecution_ResponseSyntax) ** Résultat de l'exécution de la tâche. Type : objet [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) ** Heure à laquelle la DataSync demande est envoyée pour démarrer l'exécution de la tâche. Pour les tâches ne figurant pas dans la file d'attente, `LaunchTime` `StartTime` elles sont généralement identiques. Pour les tâches en file d'attente, `LaunchTime` c'est généralement plus tard que `StartTime` parce que les tâches précédemment mises en file d'attente doivent terminer leur exécution avant que les nouvelles tâches puissent commencer. Type : Timestamp ** [Status](#API_DescribeTaskExecution_ResponseSyntax) ** État de l'exécution de la tâche. Pour des informations détaillées sur les états d'exécution des tâches, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Type : Chaîne Valeurs valides : `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) ** L'ARN de l'exécution de la tâche sur laquelle vous vouliez obtenir des informations. `TaskExecutionArn`est hiérarchique et inclut `TaskArn` la tâche exécutée. Par exemple, une `TaskExecution` valeur associée à l'ARN a `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` exécuté la tâche à l'aide de l'ARN`arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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) ** Le mode tâche que vous utilisez. Pour plus d'informations, consultez la section [Choix d'un mode de tâche pour le transfert de données](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Chaîne Valeurs valides : `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) ** La configuration de votre rapport de tâches, qui fournit des informations détaillées sur votre DataSync transfert. Pour plus d'informations, consultez la section [Création d'un rapport de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Type : objet [TaskReportConfig](API_TaskReportConfig.md) ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande Cet exemple illustre une `DescribeTaskExecution` demande. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1" } ``` ### Exemple de réponse 1 pour une exécution de tâche en mode amélioré L'exemple suivant décrit une exécution de DataSync tâche qui utilise le mode amélioré. L'exécution consiste également à transférer des données spécifiques en utilisant des filtres d'exclusion et d'inclusion. ``` { "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 } } ``` ### Exemple de réponse 2 pour une exécution de tâche en mode amélioré L'exemple suivant décrit une autre exécution de DataSync tâche qui utilise le mode amélioré. Dans ce cas, l'exécution transfère des données spécifiques en utilisant un manifeste au lieu de filtres. ``` { "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 } } ``` ### Exemple de réponse pour l'exécution d'une tâche en mode Basic L'exemple suivant décrit une exécution de DataSync tâche qui utilise le mode de base. ``` { "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" } } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution) # ListAgents Renvoie une liste d' AWS DataSync agents appartenant à un Compte AWS in Région AWS spécifié dans la demande. La pagination vous permet de réduire le nombre d'agents renvoyés dans une réponse. Si vous obtenez une liste tronquée d'agents dans une réponse, celle-ci contient un marqueur que vous pouvez spécifier dans votre prochaine demande pour récupérer la page d'agents suivante. `ListAgents`est finalement cohérent. Cela signifie que le résultat de l'exécution de l'opération peut ne pas refléter le fait que vous venez de créer ou de supprimer un agent. Par exemple, si vous créez un agent avec [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)puis que vous l'exécutez immédiatement`ListAgents`, cet agent risque de ne pas apparaître immédiatement dans la liste. Dans de telles situations, vous pouvez toujours vérifier si un agent a été créé (ou supprimé) en utilisant [DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html). ## Syntaxe de la requête ``` { "MaxResults": number, "NextToken": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [MaxResults](#API_ListAgents_RequestSyntax) ** Spécifie le nombre maximum d' DataSync agents à répertorier dans une réponse. Par défaut, une réponse indique un maximum de 100 agents. Type : Integer Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100. Obligatoire : non ** [NextToken](#API_ListAgents_RequestSyntax) ** Spécifie une chaîne opaque qui indique le point de départ de la liste de résultats suivante dans la réponse. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` Obligatoire : non ## Syntaxe de la réponse ``` { "Agents": [ { "AgentArn": "string", "Name": "string", "Platform": { "Version": "string" }, "Status": "string" } ], "NextToken": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [Agents](#API_ListAgents_ResponseSyntax) ** Une liste des DataSync agents figurant Compte AWS dans votre dossier, telle que Région AWS spécifiée dans la demande. La liste est triée selon les Amazon Resource Names (ARNs) des agents. Type : tableau d’objets [AgentListEntry](API_AgentListEntry.md) ** [NextToken](#API_ListAgents_ResponseSyntax) ** Chaîne opaque qui indique le point de départ de la liste de résultats suivante dans la réponse. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListAgents) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) # ListLocations Renvoie une liste des emplacements source et de destination. Si vous avez plus d'emplacements que ce qui est renvoyé dans une réponse (c'est-à-dire que la réponse ne renvoie qu'une liste tronquée de vos agents), la réponse contient un jeton que vous pouvez spécifier dans votre prochaine demande pour récupérer la page d'emplacements suivante. ## Syntaxe de la requête ``` { "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [Filters](#API_ListLocations_RequestSyntax) ** Vous pouvez utiliser des filtres d'API pour affiner la liste des ressources renvoyées par`ListLocations`. Par exemple, pour récupérer toutes les tâches sur un emplacement source spécifique, vous pouvez utiliser `ListLocations` avec le nom du filtre `LocationType S3` et`Operator Equals`. Type : tableau d’objets [LocationFilter](API_LocationFilter.md) Obligatoire : non ** [MaxResults](#API_ListLocations_RequestSyntax) ** Le nombre maximum de sites à retourner. Type : Integer Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100. Obligatoire : non ** [NextToken](#API_ListLocations_RequestSyntax) ** Chaîne opaque qui indique la position à partir de laquelle commencer la prochaine liste d'emplacements. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` Obligatoire : non ## Syntaxe de la réponse ``` { "Locations": [ { "LocationArn": "string", "LocationUri": "string" } ], "NextToken": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [Locations](#API_ListLocations_ResponseSyntax) ** Tableau contenant une liste d'emplacements. Type : tableau d’objets [LocationListEntry](API_LocationListEntry.md) ** [NextToken](#API_ListLocations_ResponseSyntax) ** Chaîne opaque qui indique la position à partir de laquelle commencer à renvoyer la liste d'emplacements suivante. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListLocations) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) # ListTagsForResource Renvoie toutes les balises associées à une AWS ressource. ## Syntaxe de la requête ``` { "MaxResults": number, "NextToken": "string", "ResourceArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [MaxResults](#API_ListTagsForResource_RequestSyntax) ** Spécifie le nombre de résultats que vous souhaitez voir apparaître dans la réponse. Type : Integer Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100. Obligatoire : non ** [NextToken](#API_ListTagsForResource_RequestSyntax) ** Spécifie une chaîne opaque qui indique la position à partir de laquelle commencer la liste de résultats suivante dans la réponse. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` Obligatoire : non ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la ressource pour laquelle vous souhaitez obtenir des informations de balise. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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})?))$` Obligatoire : oui ## Syntaxe de la réponse ``` { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [NextToken](#API_ListTagsForResource_ResponseSyntax) ** Chaîne opaque qui indique le point de départ de la liste de résultats suivante dans la réponse. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** Un tableau de balises appliquées à la ressource spécifiée. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 55 articles. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) # ListTaskExecutions Renvoie la liste des exécutions pour une tâche AWS DataSync de transfert. ## Syntaxe de la requête ``` { "MaxResults": number, "NextToken": "string", "TaskArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) ** Spécifie le nombre de résultats que vous souhaitez voir apparaître dans la réponse. Type : Integer Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100. Obligatoire : non ** [NextToken](#API_ListTaskExecutions_RequestSyntax) ** Spécifie une chaîne opaque qui indique la position à laquelle commencer la liste de résultats suivante dans la réponse. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` Obligatoire : non ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la tâche pour laquelle vous souhaitez obtenir des informations d'exécution. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ## Syntaxe de la réponse ``` { "NextToken": "string", "TaskExecutions": [ { "Status": "string", "TaskExecutionArn": "string", "TaskMode": "string" } ] } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) ** Chaîne opaque qui indique le point de départ de la liste de résultats suivante dans la réponse. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) ** Liste des exécutions de la tâche. Type : tableau d’objets [TaskExecutionListEntry](API_TaskExecutionListEntry.md) ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) # ListTasks Renvoie la liste des AWS DataSync tâches que vous avez créées. ## Syntaxe de la requête ``` { "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [Filters](#API_ListTasks_RequestSyntax) ** Vous pouvez utiliser des filtres d'API pour affiner la liste des ressources renvoyées par`ListTasks`. Par exemple, pour récupérer toutes les tâches d'un emplacement source spécifique, vous pouvez les utiliser `ListTasks` avec le nom du filtre `LocationId` et `Operator Equals` avec l'ARN de l'emplacement. Type : tableau d’objets [TaskFilter](API_TaskFilter.md) Obligatoire : non ** [MaxResults](#API_ListTasks_RequestSyntax) ** Le nombre maximum de tâches à renvoyer. Type : Integer Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100. Obligatoire : non ** [NextToken](#API_ListTasks_RequestSyntax) ** Chaîne opaque qui indique la position à partir de laquelle commencer la liste de tâches suivante. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` Obligatoire : non ## Syntaxe de la réponse ``` { "NextToken": "string", "Tasks": [ { "Name": "string", "Status": "string", "TaskArn": "string", "TaskMode": "string" } ] } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [NextToken](#API_ListTasks_ResponseSyntax) ** Chaîne opaque qui indique la position à partir de laquelle commencer à renvoyer la liste de tâches suivante. Type : Chaîne Contraintes de longueur : longueur maximale de 65535. Modèle : `[a-zA-Z0-9=_-]+` ** [Tasks](#API_ListTasks_ResponseSyntax) ** Liste de toutes les tâches renvoyées. Type : tableau d’objets [TaskListEntry](API_TaskListEntry.md) ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTasks) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) # StartTaskExecution Démarre une tâche AWS DataSync de transfert. Pour chaque tâche, vous ne pouvez exécuter qu'une seule tâche à la fois. L'exécution d'une tâche comporte plusieurs étapes. Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses). **Important** Si vous prévoyez de transférer des données depuis ou vers un site Amazon S3, examinez [comment cela DataSync peut affecter les frais de votre demande S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) et la [page de DataSync tarification](https://aws.amazon.com/datasync/pricing/) avant de commencer. ## Syntaxe de la requête ``` { "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" } } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** Spécifie une liste de règles de filtrage qui détermine les fichiers à exclure d'une tâche. La liste contient une chaîne de filtre unique qui contient les modèles à exclure. Les motifs sont délimités par « \$1 » (c'est-à-dire une barre verticale), par exemple, `"/folder1|/folder2"`. Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [Includes](#API_StartTaskExecution_RequestSyntax) ** Spécifie une liste de règles de filtrage qui détermine les fichiers à inclure lors de l'exécution d'une tâche. Le modèle doit contenir une seule chaîne de filtre composée des modèles à inclure. Les motifs sont délimités par « \$1 » (c'est-à-dire une barre verticale), par exemple, `"/folder1|/folder2"`. Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) ** Configure un manifeste, qui est une liste de fichiers ou d'objets que vous souhaitez DataSync transférer. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle DataSync avec lequel vous utilisez) doit être `iam:PassRole` autorisée. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Pour supprimer une configuration de manifeste, spécifiez ce paramètre avec une valeur vide. Type : objet [ManifestConfig](API_ManifestConfig.md) Obligatoire : non ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** Indique comment votre tâche de transfert est configurée. Ces options incluent le mode DataSync de gestion des fichiers, des objets et des métadonnées associées lors de votre transfert. Vous pouvez également spécifier comment vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options. Chaque option possède une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas besoin de configurer d'option avant d'appeler [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Vous pouvez également remplacer vos options de tâche pour chaque exécution de tâche. Par exemple, vous souhaiterez peut-être ajuster le `LogLevel` pour une exécution individuelle. Type : objet [Options](API_Options.md) Obligatoire : non ** [Tags](#API_StartTaskExecution_RequestSyntax) ** Spécifie les balises que vous souhaitez appliquer à l'Amazon Resource Name (ARN) représentant l'exécution de la tâche. Les *balises* sont des paires clé-valeur qui vous permettent de gérer, de filtrer et de rechercher vos DataSync ressources. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la tâche que vous souhaitez démarrer. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) ** Spécifie la manière dont vous souhaitez configurer un rapport de tâches, qui fournit des informations détaillées sur votre DataSync transfert. Pour plus d'informations, consultez la section [Surveillance de vos DataSync transferts à l'aide de rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle DataSync avec lequel vous utilisez) doit être `iam:PassRole` autorisée. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Pour supprimer une configuration de rapport de tâches, spécifiez ce paramètre comme étant vide. Type : objet [TaskReportConfig](API_TaskReportConfig.md) Obligatoire : non ## Syntaxe de la réponse ``` { "TaskExecutionArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** L'ARN de l'exécution de la tâche en cours d'exécution. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande L'exemple suivant démarre l'exécution d'une tâche en utilisant les options par défaut pour la tâche spécifiée. ``` { "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" } ``` ### Exemple de réponse Cet exemple illustre une utilisation de StartTaskExecution. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution) # TagResource Applique une *balise* à une AWS ressource. Les balises sont des paires clé-valeur qui peuvent vous aider à gérer, filtrer et rechercher vos ressources. Il s'agit notamment AWS DataSync des ressources, telles que les emplacements, les tâches et les exécutions de tâches. ## Syntaxe de la requête ``` { "ResourceArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [ResourceArn](#API_TagResource_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la ressource à laquelle appliquer la balise. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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})?))$` Obligatoire : oui ** [Tags](#API_TagResource_RequestSyntax) ** Spécifie les balises que vous souhaitez appliquer à la ressource. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/TagResource) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) # UntagResource Supprime les balises d'une AWS ressource. ## Syntaxe de la requête ``` { "Keys": [ "string" ], "ResourceArn": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [Keys](#API_UntagResource_RequestSyntax) ** Spécifie les clés des balises que vous souhaitez supprimer. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:/-]+$` Obligatoire : oui ** [ResourceArn](#API_UntagResource_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de la ressource dont les balises doivent être supprimées. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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})?))$` Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UntagResource) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) # UpdateAgent Met à jour le nom d'un AWS DataSync agent. ## Syntaxe de la requête ``` { "AgentArn": "string", "Name": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArn](#API_UpdateAgent_RequestSyntax) ** Nom de ressource Amazon (ARN) de l'agent à mettre à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Name](#API_UpdateAgent_RequestSyntax) ** Le nom que vous souhaitez utiliser pour configurer l'agent. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) # UpdateLocationAzureBlob Modifie les configurations suivantes de l'emplacement de transfert Microsoft Azure Blob Storage que vous utilisez. AWS DataSync Pour plus d'informations, consultez [Configuration des DataSync transferts avec Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessTier](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie le niveau d'accès vers lequel vous souhaitez transférer vos objets ou fichiers. Cela s'applique uniquement lorsque l'emplacement est utilisé comme destination de transfert. Pour plus d'informations, consultez la section [Niveaux d'accès](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Type : Chaîne Valeurs valides : `HOT | COOL | ARCHIVE` Obligatoire : non ** [AgentArns](#API_UpdateLocationAzureBlob_RequestSyntax) ** (Facultatif) Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent qui peut se connecter à votre conteneur Azure Blob Storage. Si vous configurez un transfert cross-cloud sans agent, il n'est pas nécessaire de spécifier une valeur pour ce paramètre. Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section [Utilisation de plusieurs agents pour votre transfert](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html). Il est impossible d'ajouter ou de supprimer des agents d'un emplacement de stockage après l'avoir initialement créé. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [AuthenticationType](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie la méthode d'authentification DataSync utilisée pour accéder à votre Azure Blob Storage. DataSync peut accéder au stockage blob à l'aide d'une signature d'accès partagé (SAS). Type : Chaîne Valeurs valides : `SAS | NONE` Obligatoire : non ** [BlobType](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie le type de blob que vous souhaitez attribuer à vos objets ou fichiers lorsque vous les transférez dans Azure Blob Storage. Actuellement, DataSync ne prend en charge le transfert de données vers Azure Blob Storage que sous forme de blobs de blocs. Pour plus d'informations sur les types de blob, consultez la documentation [Azure Blob Storage](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs). Type : Chaîne Valeurs valides : `BLOCK` Obligatoire : non ** [CmkSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie les informations de configuration pour un secret géré par le client, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync permettant d'accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui fournit l'accès au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie l'ARN de l'emplacement de transfert Azure Blob Storage que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie la configuration SAS qui permet d'accéder DataSync à votre stockage Azure Blob. Type : objet [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) Obligatoire : non ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) ** Spécifie les segments de chemin si vous souhaitez limiter votre transfert vers un répertoire virtuel de votre conteneur (par exemple,`/my/images`). Type : Chaîne Contraintes de longueur : longueur maximum de 1 024. Modèle : `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) # UpdateLocationEfs Modifie les paramètres de configuration suivants du lieu de transfert Amazon EFS que vous utilisez. AWS DataSync Pour plus d'informations, consultez [Configuration des DataSync transferts avec Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html). ## Syntaxe de la requête ``` { "AccessPointArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "Subdirectory": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du point d'accès DataSync utilisé pour monter votre système de fichiers Amazon EFS. Pour plus d'informations, consultez la section [Accès aux systèmes de fichiers Amazon EFS restreints](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `(^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}$)|(^$)` Obligatoire : non ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) ** Spécifie un rôle Gestion des identités et des accès AWS (IAM) qui permet d'accéder DataSync à votre système de fichiers Amazon EFS. Pour plus d'informations sur la création de ce rôle, consultez [Création d'un rôle DataSync IAM pour accéder au système de fichiers Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)` Obligatoire : non ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) ** Spécifie si vous DataSync souhaitez utiliser le chiffrement TLS (Transport Layer Security) 1.2 lors du transfert de données vers ou depuis votre système de fichiers Amazon EFS. Si vous spécifiez un point d'accès en utilisant `AccessPointArn` ou un rôle IAM avec `FileSystemAccessRoleArn`, vous devez définir ce paramètre sur `TLS1_2`. Type : Chaîne Valeurs valides : `NONE | TLS1_2` Obligatoire : non ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du lieu de transfert Amazon EFS que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers Amazon EFS. C'est là que les données sont DataSync lues ou écrites sur votre système de fichiers (selon qu'il s'agit d'un emplacement source ou de destination). Par défaut, DataSync utilise le répertoire racine (ou le [point d'accès](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) si vous en fournissez un en utilisant`AccessPointArn`). Vous pouvez également inclure des sous-répertoires à l'aide de barres obliques (par exemple,). `/path/to/folder` Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) # UpdateLocationFsxLustre Modifie les paramètres de configuration suivants du lieu de transfert Amazon FSx for Lustre que vous utilisez. AWS DataSync Pour plus d'informations, voir [Configuration des DataSync transferts avec FSx pour Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html). ## Syntaxe de la requête ``` { "LocationArn": "string", "Subdirectory": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_UpdateLocationFsxLustre_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement de transfert FSx pour Lustre que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers FSx for Lustre. Le chemin peut inclure des sous-répertoires. Lorsque l'emplacement est utilisé comme source, DataSync lit les données depuis le chemin de montage. Lorsque l'emplacement est utilisé comme destination, DataSync écrit des données sur le chemin de montage. Si vous n'incluez pas ce paramètre, DataSync utilise le répertoire racine du système de fichiers (`/`). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) # UpdateLocationFsxOntap Modifie les paramètres de configuration suivants du lieu de transfert Amazon FSx for NetApp ONTAP que vous utilisez. AWS DataSync Pour plus d'informations, consultez [la section Configuration des DataSync transferts avec FSx pour ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_UpdateLocationFsxOntap_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du lieu FSx de transfert ONTAP que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) ** Spécifie le protocole de transfert de données DataSync utilisé pour accéder à votre système de FSx fichiers Amazon. Type : objet [FsxUpdateProtocol](API_FsxUpdateProtocol.md) Obligatoire : non ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) ** Spécifie le chemin d'accès au partage de fichiers sur la machine virtuelle de stockage (SVM) vers laquelle vous souhaitez transférer des données ou à partir de laquelle vous souhaitez transférer des données. Vous pouvez spécifier un chemin de jonction (également appelé point de montage), un chemin qtree (pour les partages de fichiers NFS) ou un nom de partage (pour les partages de fichiers SMB). Par exemple, votre chemin de montage peut être `/vol1`, `/vol1/tree1` ou `/share1`. Ne spécifiez pas de chemin de jonction dans le volume racine de la SVM. Pour plus d'informations, consultez [la section Gestion FSx des machines virtuelles de stockage ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) dans le guide de l'*utilisateur Amazon FSx pour NetApp ONTAP*. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) # UpdateLocationFsxOpenZfs Modifie les paramètres de configuration suivants du lieu de transfert Amazon FSx pour OpenZFS que vous utilisez. AWS DataSync Pour plus d'informations, consultez [Configuration des DataSync transferts avec FSx pour OpenZFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html). **Note** Les paramètres de demande associés à `SMB` ne sont pas pris en charge par l'`UpdateLocationFsxOpenZfs`opération. ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement de transfert FSx pour OpenZFS que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** Spécifie le protocole de transfert de données AWS DataSync utilisé pour accéder à votre système de FSx fichiers Amazon. Type : objet [FsxProtocol](API_FsxProtocol.md) Obligatoire : non ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** Spécifie un sous-répertoire dans le chemin de l'emplacement qui doit commencer `/fsx` par. DataSync utilise ce sous-répertoire pour lire ou écrire des données (selon que le système de fichiers est un emplacement source ou de destination). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) # UpdateLocationFsxWindows Modifie les paramètres de configuration suivants de l'emplacement de transfert du serveur de fichiers Amazon FSx pour Windows que vous utilisez. AWS DataSync Pour plus d'informations, voir [Configuration des DataSync transferts avec FSx pour Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html). ## Syntaxe de la requête ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "LocationArn": "string", "Password": "string", "Subdirectory": "string", "User": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un `Password` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie les informations de configuration pour un secret géré par le client, comme un `Password` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui fournit l'accès au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie le nom du domaine Windows auquel appartient votre système de fichiers FSx pour Windows File Server. Si votre environnement comporte plusieurs domaines Active Directory, la configuration de ce paramètre garantit la DataSync connexion au bon système de fichiers. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$` Obligatoire : non ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie l'ARN de l'emplacement FSx de transfert du serveur de fichiers Windows que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie le mot de passe de l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers dans votre système de fichiers FSx pour Windows File Server. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie le chemin de montage de votre système de fichiers à l'aide de barres obliques. DataSync utilise ce sous-répertoire pour lire ou écrire des données (selon que le système de fichiers est un emplacement source ou de destination). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ** [User](#API_UpdateLocationFsxWindows_RequestSyntax) ** Spécifie l'utilisateur autorisé à monter et à accéder aux fichiers, dossiers et métadonnées de fichiers dans votre système de fichiers FSx pour Windows File Server. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez [les autorisations requises](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx pour les emplacements des serveurs de fichiers Windows. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) # UpdateLocationHdfs Modifie les paramètres de configuration suivants de l'emplacement de transfert du système de fichiers distribué Hadoop (HDFS) que vous utilisez avec. AWS DataSync Pour plus d'informations, voir [Configuration des DataSync transferts avec un cluster HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) ** Les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre cluster HDFS. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [AuthenticationType](#API_UpdateLocationHdfs_RequestSyntax) ** Type d'authentification utilisé pour déterminer l'identité de l'utilisateur. Type : Chaîne Valeurs valides : `SIMPLE | KERBEROS` Obligatoire : non ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) ** Taille des blocs de données à écrire dans le cluster HDFS. Type : Integer Plage valide : valeur minimale de 1048576. Valeur maximale de 1073741824. Obligatoire : non ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un `KerberosKeytab` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** Spécifie les informations de configuration pour un secret géré par le client, comme un `KerberosKeytab` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui fournit l'accès au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) ** La table de clés Kerberos (keytab) qui contient les mappages entre le principal Kerberos défini et les clés chiffrées. Vous pouvez charger le keytab à partir d'un fichier en fournissant l'adresse du fichier. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 65536. Obligatoire : non ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) ** Le fichier `krb5.conf` qui contient les informations de configuration Kerberos. Vous pouvez charger le `krb5.conf` fichier en fournissant son adresse. Si vous utilisez le AWS CLI, il exécute le codage base64 pour vous. Dans le cas contraire, fournissez le texte codé en base64. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 131072. Obligatoire : non ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) ** Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^.+$` Obligatoire : non ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) ** L'URI du serveur de gestion de clés (KMS) du cluster HDFS. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères. Modèle : `^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$` Obligatoire : non ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement du cluster HDFS source. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) ** Celui NameNode qui gère l'espace de noms HDFS. Il NameNode effectue des opérations telles que l'ouverture, la fermeture et le changement de nom de fichiers et de répertoires. Le NameNode contient les informations permettant de mapper des blocs de données au DataNodes. Vous ne pouvez en utiliser qu'un seul NameNode. Type : tableau d’objets [HdfsNameNode](API_HdfsNameNode.md) Membres du tableau : Nombre minimum de 1 élément. Obligatoire : non ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) ** La configuration de la qualité de protection (QOP) spécifie les paramètres RPC (Remote Procedure Call) et de confidentialité du transfert de données configurés sur le cluster de système de fichiers distribué Hadoop (HDFS). Type : objet [QopConfiguration](API_QopConfiguration.md) Obligatoire : non ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) ** Le nombre de DataNodes vers lesquels répliquer les données lors de l'écriture dans le cluster HDFS. Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 512. Obligatoire : non ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) ** Le nom d'utilisateur servant à identifier le client sur le système d'exploitation hôte. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` Obligatoire : non ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) ** Un sous-répertoire du cluster HDFS. Ce sous-répertoire est utilisé pour lire des données à partir du cluster HDFS ou y écrire des données. Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) # UpdateLocationNfs Modifie les paramètres de configuration suivants de l'emplacement de transfert NFS (Network File System) que vous utilisez. AWS DataSync Pour plus d'informations, consultez [la section Configuration des transferts avec un serveur de fichiers NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html). ## Syntaxe de la requête ``` { "LocationArn": "string", "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_UpdateLocationNfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'emplacement de transfert NFS que vous souhaitez mettre à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) ** Spécifie comment DataSync accéder à un emplacement à l'aide du protocole NFS. Type : objet [NfsMountOptions](API_NfsMountOptions.md) Obligatoire : non ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) ** Les AWS DataSync agents qui peuvent se connecter à votre serveur de fichiers NFS (Network File System). Type : objet [OnPremConfig](API_OnPremConfig.md) Obligatoire : non ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) ** Spécifie le nom DNS ou l'adresse IP (IPv4 ou IPv6) du serveur de fichiers NFS auquel votre DataSync agent se connecte. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obligatoire : non ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) ** Spécifie le chemin d'exportation sur le serveur de fichiers NFS que vous DataSync souhaitez monter. Ce chemin (ou un sous-répertoire du chemin) est l'endroit où les données sont DataSync transférées depuis ou vers. Pour plus d'informations sur la configuration d'une exportation pour DataSync, consultez la section [Accès aux serveurs de fichiers NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]+$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) # UpdateLocationObjectStorage Modifie les paramètres de configuration suivants de l'emplacement de transfert du stockage d'objets que vous utilisez. AWS DataSync Pour plus d'informations, consultez [la section Configuration des DataSync transferts avec un système de stockage d'objets](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie la clé d'accès (par exemple, un nom d'utilisateur) si des informations d'identification sont requises pour s'authentifier auprès du serveur de stockage d'objets. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. Modèle : `^.*$` Obligatoire : non ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) ** (Facultatif) Spécifie les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre système de stockage d'objets. Si vous configurez un transfert cross-cloud sans agent, il n'est pas nécessaire de spécifier une valeur pour ce paramètre. Il est impossible d'ajouter ou de supprimer des agents d'un emplacement de stockage après l'avoir initialement créé. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie les informations de configuration pour un secret géré par le client, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync permettant d'accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui fournit l'accès au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie l'ARN de l'emplacement du système de stockage d'objets que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie la clé secrète (par exemple, un mot de passe) si des informations d'identification sont requises pour s'authentifier auprès du serveur de stockage d'objets. Si vous fournissez un code secret en utilisant `CmkSecretConfig` ou`SecretKey`, si vous ne fournissez pas de détails de configuration secrets`CustomSecretConfig`, vous DataSync stockez le jeton en utilisant le secret du Gestionnaire de Secrets Manager de votre AWS compte. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. Modèle : `^.*$` Obligatoire : non ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie une chaîne de certificats DataSync pour l'authentification auprès de votre système de stockage d'objets si celui-ci utilise une autorité de certification (CA) privée ou auto-signée. Vous devez spécifier un seul `.pem` fichier avec une chaîne de certificats complète (par exemple,`file:///home/user/.ssh/object_storage_certificates.pem`). La chaîne de certificats peut inclure : + Le certificat du système de stockage d'objets + Tous les certificats intermédiaires (s'il y en a) + Le certificat racine de l'autorité de certification signataire Vous pouvez concaténer vos certificats dans un `.pem` fichier (dont la taille peut atteindre 32 768 octets avant le codage base64). L'exemple de `cat` commande suivant crée un `object_storage_certificates.pem` fichier contenant trois certificats : `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` Pour utiliser ce paramètre, configurez `ServerProtocol` sur`HTTPS`. La mise à jour de ce paramètre n'interfère pas avec les tâches en cours. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 32 768. Obligatoire : non ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie le nom de domaine ou l'adresse IP (IPv4 ou IPv6) du serveur de stockage d'objets auquel votre DataSync agent se connecte. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obligatoire : non ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie le port sur lequel votre serveur de stockage d'objets accepte le trafic réseau entrant (par exemple, le port 443). Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 65536. Obligatoire : non ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie le protocole utilisé par votre serveur de stockage d'objets pour communiquer. Type : Chaîne Valeurs valides : `HTTPS | HTTP` Obligatoire : non ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) ** Spécifie le préfixe d'objet pour votre serveur de stockage d'objets. S'il s'agit d'un emplacement source, copie DataSync uniquement les objets portant ce préfixe. S'il s'agit d'un emplacement de destination, DataSync écrit tous les objets avec ce préfixe. Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) # UpdateLocationS3 Modifie les paramètres de configuration suivants du lieu de transfert Amazon S3 que vous utilisez. AWS DataSync **Important** Avant de commencer, assurez-vous de lire les rubriques suivantes : [Considérations relatives à la classe de stockage avec les sites Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Évaluation des coûts des requêtes S3 lors de l'utilisation DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) ## Syntaxe de la requête ``` { "LocationArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du lieu de transfert Amazon S3 que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [S3Config](#API_UpdateLocationS3_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) DataSync utilisé pour accéder à votre compartiment S3. Pour plus d'informations, consultez la section [Fournir DataSync un accès aux compartiments S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Type : objet [S3Config](API_S3Config.md) Obligatoire : non ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) ** Spécifie la classe de stockage que vous souhaitez que vos objets utilisent lorsque Amazon S3 est une destination de transfert. Pour les compartiments entrants Régions AWS, la classe de stockage par défaut est. `STANDARD` Pour les buckets activés AWS Outposts, la classe de stockage par défaut est. `OUTPOSTS` Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux transferts Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Type : Chaîne Valeurs valides : `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Obligatoire : non ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) ** Spécifie un préfixe dans le compartiment S3 qui DataSync lit ou écrit vers (selon que le compartiment est un emplacement source ou de destination). DataSync Impossible de transférer des objets dont le préfixe commence par une barre oblique (`/`) ou inclut `//``/./`, ou `/../` des motifs. Par exemple : + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) # UpdateLocationSmb Modifie les paramètres de configuration suivants de l'emplacement de transfert SMB (Server Message Block) que vous utilisez. AWS DataSync Pour plus d'informations, consultez [la section Configuration des DataSync transferts avec un serveur de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html). ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie l' DataSync agent (ou les agents) qui peuvent se connecter à votre serveur de fichiers SMB. Vous spécifiez un agent en utilisant son Amazon Resource Name (ARN). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [AuthenticationType](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie le protocole d'authentification DataSync utilisé pour se connecter à votre serveur de fichiers SMB. DataSync supports `NTLM` (par défaut) et `KERBEROS` authentification. Pour plus d'informations, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Type : Chaîne Valeurs valides : `NTLM | KERBEROS` Obligatoire : non ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un `Password` `KerberosKeytab` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie les informations de configuration d'un secret géré par le client, telles qu'un `Password` `KerberosKeytab` ou un ensemble d'informations d'identification permettant d' DataSync accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie les adresses IP (IPv4 ou IPv6) des serveurs DNS auxquels appartient votre serveur de fichiers SMB. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`KERBEROS`. Si votre environnement comporte plusieurs domaines, la configuration de ce paramètre garantit la DataSync connexion au bon serveur de fichiers SMB. Type : tableau de chaînes Membres du tableau : nombre maximum de 2 éléments. Contraintes de longueur : longueur minimale de 7. Longueur maximale de 39 Modèle : `\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` Obligatoire : non ** [Domain](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie le nom de domaine Windows auquel appartient votre serveur de fichiers SMB. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Si votre environnement comporte plusieurs domaines, la configuration de ce paramètre garantit la DataSync connexion au bon serveur de fichiers. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obligatoire : non ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie votre fichier de table de clés Kerberos (keytab), qui inclut les mappages entre votre clé principale Kerberos et vos clés de chiffrement. Pour éviter les erreurs d'exécution des tâches, assurez-vous que le principal Kerberos que vous utilisez pour créer le fichier keytab correspond exactement à ce que vous spécifiez. `KerberosPrincipal` Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 65536. Obligatoire : non ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie un fichier de configuration Kerberos (`krb5.conf`) qui définit la configuration de votre domaine Kerberos. Le fichier doit être codé en base64. Si vous utilisez le AWS CLI, le codage est fait pour vous. Type : objet de données binaires encodées en base64 Contraintes de longueur : longueur maximale de 131072. Obligatoire : non ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie un principal Kerberos, c'est-à-dire une identité dans votre domaine Kerberos autorisée à accéder aux fichiers, aux dossiers et aux métadonnées des fichiers sur votre serveur de fichiers SMB. Un principal Kerberos peut ressembler à. `HOST/kerberosuser@MYDOMAIN.ORG` Les noms principaux distinguent les majuscules et minuscules. L'exécution de votre DataSync tâche échouera si le principal que vous spécifiez pour ce paramètre ne correspond pas exactement au principal que vous avez utilisé pour créer le fichier keytab. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^.+$` Obligatoire : non ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie l'ARN de l'emplacement SMB que vous souhaitez mettre à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie la version du protocole SMB (Server Message Block) AWS DataSync utilisée pour accéder à un serveur de fichiers SMB. Type : objet [SmbMountOptions](API_SmbMountOptions.md) Obligatoire : non ** [Password](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie le mot de passe de l'utilisateur qui peut monter votre serveur de fichiers SMB et qui est autorisé à accéder aux fichiers et dossiers concernés par votre transfert. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie le nom de domaine ou l'adresse IP (IPv4 ou IPv6) du serveur de fichiers SMB auquel votre DataSync agent se connecte. Si vous utilisez l'authentification Kerberos, vous devez spécifier un nom de domaine. Type : Chaîne Contraintes de longueur : longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obligatoire : non ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie le nom du partage exporté par votre serveur de fichiers SMB où les données DataSync seront lues ou écrites. Vous pouvez inclure un sous-répertoire dans le chemin de partage (par exemple,`/path/to/subdirectory`). Assurez-vous que les autres clients SMB de votre réseau peuvent également monter ce chemin. Pour copier toutes les données du sous-répertoire spécifié, vous DataSync devez être en mesure de monter le partage SMB et d'accéder à toutes ses données. Pour plus d'informations, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Obligatoire : non ** [User](#API_UpdateLocationSmb_RequestSyntax) ** Spécifie le nom d'utilisateur qui peut monter votre serveur de fichiers SMB et qui est autorisé à accéder aux fichiers et dossiers concernés par votre transfert. Ce paramètre ne s'applique que s'`AuthenticationType`il est défini sur`NTLM`. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez la section [Fournir un DataSync accès aux serveurs de fichiers SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) # UpdateTask Met à jour la configuration d'une *tâche*, qui définit où et comment AWS DataSync vos données sont transférées. ## Syntaxe de la requête ``` { "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" } } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) d'un groupe de CloudWatch journaux Amazon pour surveiller votre tâche. Pour les tâches en mode amélioré, vous devez utiliser `/aws/datasync` comme nom de groupe de journaux. Par exemple : `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` Pour plus d'informations, consultez la section [Surveillance des transferts de données à l'aide CloudWatch des journaux](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Type : Chaîne Contraintes de longueur : longueur maximale de 562. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obligatoire : non ** [Excludes](#API_UpdateTask_RequestSyntax) ** Spécifie les filtres d'exclusion qui définissent les fichiers, les objets et les dossiers de votre emplacement source que vous ne DataSync souhaitez pas transférer. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [Includes](#API_UpdateTask_RequestSyntax) ** Spécifie que les filtres d'inclusion définissent les fichiers, les objets et les dossiers que vous souhaitez DataSync transférer dans votre emplacement source. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** Configure un manifeste, qui est une liste de fichiers ou d'objets que vous souhaitez DataSync transférer. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle IAM DataSync avec lequel vous utilisez) doit être autorisée. `iam:PassRole` La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Pour supprimer une configuration de manifeste, spécifiez ce paramètre comme étant vide. Type : objet [ManifestConfig](API_ManifestConfig.md) Obligatoire : non ** [Name](#API_UpdateTask_RequestSyntax) ** Spécifie le nom de votre tâche. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ** [Options](#API_UpdateTask_RequestSyntax) ** Indique comment votre tâche de transfert est configurée. Ces options incluent le mode DataSync de gestion des fichiers, des objets et des métadonnées associées lors de votre transfert. Vous pouvez également spécifier comment vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options. Chaque option possède une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas à configurer d'option avant d'appeler [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Vous pouvez également remplacer vos options de tâche pour chaque exécution de tâche. Par exemple, vous souhaiterez peut-être ajuster le `LogLevel` pour une exécution individuelle. Type : objet [Options](API_Options.md) Obligatoire : non ** [Schedule](#API_UpdateTask_RequestSyntax) ** Spécifie le calendrier d'exécution de la tâche. Pour plus d'informations, veuillez consulter la rubrique [Planification de votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Type : objet [TaskSchedule](API_TaskSchedule.md) Obligatoire : non ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Spécifie l'ARN de la tâche que vous souhaitez mettre à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** Spécifie la manière dont vous souhaitez configurer un rapport de tâches, qui fournit des informations détaillées sur votre DataSync transfert. Pour plus d'informations, consultez la section [Surveillance de vos DataSync transferts à l'aide de rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle IAM DataSync avec lequel vous utilisez) doit être autorisée. `iam:PassRole` La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Pour supprimer une configuration de rapport de tâches, spécifiez ce paramètre comme étant vide. Type : objet [TaskReportConfig](API_TaskReportConfig.md) Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) # UpdateTaskExecution Met à jour la configuration de l'exécution d'une AWS DataSync tâche en cours d'exécution. **Note** Actuellement, vous ne pouvez modifier `Option` que ce qui limite la bande passante pour l'exécution d'une tâche en cours ou en file d'attente. `UpdateTaskExecution` ` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) ` ## Syntaxe de la requête ``` { "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [Options](#API_UpdateTaskExecution_RequestSyntax) ** Indique comment votre tâche de transfert est configurée. Ces options incluent le mode DataSync de gestion des fichiers, des objets et des métadonnées associées lors de votre transfert. Vous pouvez également spécifier comment vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options. Chaque option possède une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas à configurer d'option avant d'appeler [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Vous pouvez également remplacer vos options de tâche pour chaque exécution de tâche. Par exemple, vous souhaiterez peut-être ajuster le `LogLevel` pour une exécution individuelle. Type : objet [Options](API_Options.md) Obligatoire : oui ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) de l'exécution de la tâche que vous mettez à jour. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) # Types de données Les types de données suivants sont pris en charge : + [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 Représente une seule entrée dans une liste (ou un tableau) d' AWS DataSync agents lorsque vous appelez l'[ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)opération. ## Table des matières ** AgentArn ** Le nom de ressource Amazon (ARN) d'un DataSync agent. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** Name ** Le nom d'un agent. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ** Platform ** Les informations relatives à la plate-forme concernant l'agent, telles que le numéro de version. Type : objet [Platform](API_Platform.md) Obligatoire : non ** Status ** Le statut d'un agent. + Si le statut est défini`ONLINE`, l'agent est correctement configuré et prêt à être utilisé. + Si le statut est le cas`OFFLINE`, l'agent a été hors de contact avec DataSync lui pendant cinq minutes ou plus. Cela peut se produire pour plusieurs raisons. Pour plus d'informations, voir [Que dois-je faire si mon agent est hors ligne ?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) Type : Chaîne Valeurs valides : `ONLINE | OFFLINE` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) # AzureBlobSasConfiguration Configuration de signature d'accès partagé (SAS) qui permet d'accéder AWS DataSync à votre Microsoft Azure Blob Storage. Pour plus d'informations, consultez la section [Jetons SAS](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens) pour accéder à votre stockage Azure Blob. ## Table des matières ** Token ** Spécifie un jeton SAS qui fournit des autorisations pour accéder à votre stockage Azure Blob. Le jeton fait partie de la chaîne d'URI SAS qui suit l'URI de la ressource de stockage et un point d'interrogation. Un jeton ressemble à ceci : `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` Type : String Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255. Modèle : `^.+$` Obligatoire : oui ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) # CmkSecretConfig Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un jeton d'authentification, une clé secrète, un mot de passe ou un keytab Kerberos DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un emplacement géré par le client. AWS KMS key **Note** Vous pouvez utiliser l'un ou l'autre `CmkSecretConfig` ou `CustomSecretConfig` fournir des informations d'identification pour une `CreateLocation` demande. Ne fournissez pas les deux paramètres pour la même demande. ## Table des matières ** KmsKeyArn ** Spécifie l'ARN DataSync utilisé par le client AWS KMS key pour chiffrer le secret DataSync géré stocké pour. `SecretArn` DataSync fournit cette clé à AWS Secrets Manager. Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$` Obligatoire : non ** SecretArn ** Spécifie l'ARN du AWS Secrets Manager secret DataSync géré utilisé pour accéder à un emplacement de stockage spécifique. Cette propriété est générée par DataSync et est en lecture seule. DataSync chiffre ce secret avec la clé KMS que vous spécifiez. `KmsKeyArn` Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) # CustomSecretConfig Spécifie les informations de configuration d'un secret Secrets Manager géré par le client dans lequel les informations d'identification d'un emplacement de stockage sont stockées dans Secrets Manager sous forme de texte brut (pour le jeton d'authentification, la clé secrète ou le mot de passe) ou sous forme binaire (pour Kerberos keytab). Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. **Note** Vous pouvez utiliser l'un ou l'autre `CmkSecretConfig` ou `CustomSecretConfig` fournir des informations d'identification pour une `CreateLocation` demande. Ne fournissez pas les deux paramètres pour la même demande. ## Table des matières ** SecretAccessRoleArn ** Spécifie l'ARN du Gestion des identités et des accès AWS rôle DataSync utilisé pour accéder au secret spécifié pour`SecretArn`. Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$` Obligatoire : non ** SecretArn ** Spécifie l'ARN d'un AWS Secrets Manager secret. Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) # Ec2Config Sous-réseau et groupes de sécurité AWS DataSync utilisés pour se connecter à l'une des [cibles de montage](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) de votre système de fichiers Amazon EFS. ## Table des matières ** SecurityGroupArns ** Spécifie les noms de ressources Amazon (ARNs) des groupes de sécurité associés à la cible de montage d'un système de fichiers Amazon EFS. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ** SubnetArn ** Spécifie l'ARN d'un sous-réseau où sont DataSync créées les [interfaces réseau](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) pour gérer le trafic pendant le transfert. Le sous-réseau doit être situé : + Dans le même cloud privé virtuel (VPC) que le système de fichiers Amazon EFS. + Dans la même zone de disponibilité qu'au moins une cible de montage pour le système de fichiers Amazon EFS. Vous n'avez pas besoin de spécifier un sous-réseau incluant une cible de montage de système de fichiers. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : oui ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) # FilterRule Spécifie les fichiers, les dossiers et les objets à inclure ou à exclure lors du transfert de fichiers de la source vers la destination. ## Table des matières ** FilterType ** Type de règle de filtre à appliquer. AWS DataSync ne prend en charge que le type de règle SIMPLE\$1PATTERN. Type : String Contraintes de longueur : Longueur maximum de 128. Modèle : `^[A-Z0-9_]+$` Valeurs valides : `SIMPLE_PATTERN` Obligatoire : non ** Value ** Une chaîne de filtre unique composée des modèles à inclure ou à exclure. Les modèles sont délimités par « \$1 » (une barre verticale), par exemple : `/folder1|/folder2` Type : String Contraintes de longueur : longueur maximale de 102400. Modèle : `^[^\x00]+$` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) # FsxProtocol Spécifie le protocole de transfert de données AWS DataSync utilisé pour accéder à votre système de FSx fichiers Amazon. ## Table des matières ** NFS ** Spécifie la configuration du protocole NFS (Network File System) à utiliser FSx pour accéder DataSync à votre système de fichiers OpenZFS ou FSx à la machine virtuelle de stockage (SVM) du système de fichiers ONTAP. Type : objet [FsxProtocolNfs](API_FsxProtocolNfs.md) Obligatoire : non ** SMB ** Spécifie la configuration du protocole SMB (Server Message Block) à utiliser FSx pour DataSync accéder à votre SVM du système de fichiers ONTAP. Type : objet [FsxProtocolSmb](API_FsxProtocolSmb.md) Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) # FsxProtocolNfs Spécifie la configuration du protocole NFS (Network File System) à utiliser FSx pour accéder DataSync à votre système de fichiers OpenZFS ou FSx à la machine virtuelle de stockage (SVM) du système de fichiers ONTAP. ## Table des matières ** MountOptions ** Spécifie comment DataSync accéder à un emplacement à l'aide du protocole NFS. Type : objet [NfsMountOptions](API_NfsMountOptions.md) Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) # FsxProtocolSmb Spécifie la configuration du protocole SMB (Server Message Block) qui permet d' AWS DataSync accéder à la machine virtuelle de stockage (SVM) de votre système de fichiers Amazon FSx for NetApp ONTAP. Pour plus d'informations, consultez la section [Fournir un DataSync accès FSx aux systèmes de fichiers ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access). ## Table des matières ** User ** Spécifie un utilisateur qui peut monter et accéder aux fichiers, dossiers et métadonnées de votre SVM. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez la section [Utilisation du protocole SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb). Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : oui ** CmkSecretConfig ** Spécifie les informations de configuration pour un secret DataSync géré, notamment le mot de passe DataSync utilisé FSx pour accéder à un emplacement de stockage spécifique à ONTAP (via SMB), avec un emplacement géré par le client. AWS KMS key Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationFsxOntap` demande, vous ne fournissez que l'ARN de la clé KMS. DataSync utilise cette clé KMS avec celle `Password` que vous spécifiez pour créer un secret DataSync géré afin de stocker les informations d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`Password`) ou `CustomSecretConfig` (sans`Password`) pour fournir des informations d'identification pour une `CreateLocationFsxOntap` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** CustomSecretConfig ** Spécifie les informations de configuration pour un secret du Gestionnaire de Secrets géré par le client où le mot de passe d'un emplacement de stockage FSx pour ONTAP (via SMB) est stocké en texte brut, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`Password`) ou `CustomSecretConfig` (sans`Password`) pour fournir des informations d'identification pour une `CreateLocationFsxOntap` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** Domain ** Spécifie le nom du domaine Windows auquel appartient votre machine virtuelle de stockage (SVM). Si votre environnement comporte plusieurs domaines, la configuration de ce paramètre garantit la DataSync connexion à la SVM appropriée. Si votre environnement comporte plusieurs domaines Active Directory, la configuration de ce paramètre garantit la DataSync connexion à la SVM appropriée. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obligatoire : non ** ManagedSecretConfig ** Décrit les informations de configuration d'un secret DataSync géré, tel `Password` qu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager Ne le fournissez pas dans le cadre d'une `CreateLocation` demande. `ManagedSecretConfig`est une ReadOnly propriété qui ne doit être renseignée que dans la `DescribeLocation` réponse. Type : objet [ManagedSecretConfig](API_ManagedSecretConfig.md) Obligatoire : non ** MountOptions ** Spécifie la version du protocole SMB (Server Message Block) qui permet d'accéder AWS DataSync à un serveur de fichiers SMB. Type : objet [SmbMountOptions](API_SmbMountOptions.md) Obligatoire : non ** Password ** Spécifie le mot de passe d'un utilisateur autorisé à accéder à votre SVM. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) # FsxUpdateProtocol Spécifie le protocole de transfert de données AWS DataSync utilisé pour accéder à votre système de FSx fichiers Amazon. **Note** Vous ne pouvez pas mettre à jour la configuration du protocole NFS (Network File System) FSx pour les emplacements ONTAP. DataSync ne prend actuellement en charge que la version 3 de NFS avec ce type d'emplacement. ## Table des matières ** NFS ** Spécifie la configuration du protocole NFS (Network File System) à utiliser FSx pour accéder DataSync à votre système de fichiers OpenZFS ou FSx à la machine virtuelle de stockage (SVM) du système de fichiers ONTAP. Type : objet [FsxProtocolNfs](API_FsxProtocolNfs.md) Obligatoire : non ** SMB ** Spécifie la configuration du protocole SMB (Server Message Block) à utiliser FSx pour DataSync accéder à la machine virtuelle de stockage (SVM) de votre système de fichiers ONTAP. Type : objet [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) # FsxUpdateProtocolSmb Spécifie la configuration du protocole SMB (Server Message Block) qui permet d' AWS DataSync accéder à la machine virtuelle de stockage (SVM) de votre système de fichiers Amazon FSx for NetApp ONTAP. Pour plus d'informations, consultez la section [Fournir un DataSync accès FSx aux systèmes de fichiers ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access). ## Table des matières ** CmkSecretConfig ** Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un `Password` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** CustomSecretConfig ** Spécifie les informations de configuration pour un secret géré par le client, tel qu'un `Password` ou un ensemble d'informations d'identification permettant d' DataSync accéder à un lieu de transfert spécifique. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** Domain ** Spécifie le nom du domaine Windows auquel appartient votre machine virtuelle de stockage (SVM). Si votre environnement comporte plusieurs domaines Active Directory, la configuration de ce paramètre garantit la DataSync connexion à la SVM appropriée. Type : Chaîne Contraintes de longueur : longueur maximale de 253. Modèle : `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$` Obligatoire : non ** MountOptions ** Spécifie la version du protocole SMB (Server Message Block) AWS DataSync utilisée pour accéder à un serveur de fichiers SMB. Type : objet [SmbMountOptions](API_SmbMountOptions.md) Obligatoire : non ** Password ** Spécifie le mot de passe d'un utilisateur autorisé à accéder à votre SVM. Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^.{0,104}$` Obligatoire : non ** User ** Spécifie un utilisateur qui peut monter et accéder aux fichiers, dossiers et métadonnées de votre SVM. Pour plus d'informations sur le choix d'un utilisateur disposant du niveau d'accès approprié pour votre transfert, consultez la section [Utilisation du protocole SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb). Type : Chaîne Contraintes de longueur : longueur maximale de 104. Modèle : `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) # HdfsNameNode Le NameNode du système de fichiers distribué Hadoop (HDFS). NameNode Gère l'espace de noms du système de fichiers. Il NameNode effectue des opérations telles que l'ouverture, la fermeture et le changement de nom de fichiers et de répertoires. Le NameNode contient les informations permettant de mapper des blocs de données au DataNodes. ## Table des matières ** Hostname ** Le nom d'hôte du NameNode dans le cluster HDFS. Cette valeur est l'adresse IP ou le nom DNS (Domain Name Service) du NameNode. Un agent installé sur site utilise ce nom d'hôte pour communiquer avec NameNode le réseau. Type : String Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255. Modèle : `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$` Obligatoire : oui ** Port ** Port NameNode utilisé pour écouter les demandes des clients. Type : entier Plage valide : valeur minimum de 1. Valeur maximale de 65536. Obligatoire : oui ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) # LocationFilter Affinez la liste des ressources renvoyées par`ListLocations`. Par exemple, pour voir tous vos sites Amazon S3, créez un filtre à l'aide de `"Name": "LocationType"``"Operator": "Equals"`, et`"Values": "S3"`. Pour plus d'informations, consultez la section [Filtrage des ressources](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html). ## Table des matières ** Name ** Nom du filtre utilisé. Chaque appel d'API prend en charge une liste de filtres disponibles pour celui-ci (par exemple, `LocationType` pour`ListLocations`). Type : String Valeurs valides : `LocationUri | LocationType | CreationTime` Obligatoire : oui ** Operator ** Opérateur utilisé pour comparer les valeurs des filtres (par exemple, `Equals` ou`Contains`). Type : String Valeurs valides : `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith` Obligatoire : oui ** Values ** Les valeurs que vous souhaitez filtrer. Par exemple, vous souhaiterez peut-être afficher uniquement les emplacements Amazon S3. Type : tableau de chaînes Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255. Modèle : `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$` Obligatoire : oui ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) # LocationListEntry Représente une entrée unique dans une liste d'emplacements. `LocationListEntry`renvoie un tableau contenant une liste d'emplacements lorsque l'[ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)opération est appelée. ## Table des matières ** LocationArn ** Le nom de ressource Amazon (ARN) de l'emplacement. Pour le système de fichiers réseau (NFS) ou Amazon EFS, l'emplacement est le chemin d'exportation. Pour Amazon S3, l'emplacement est le chemin du préfixe que vous souhaitez monter et utiliser comme racine de l'emplacement. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** LocationUri ** Représente la liste URIs d'un emplacement. `LocationUri`renvoie un tableau contenant une liste d'emplacements lorsque l'[ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)opération est appelée. Format :`TYPE://GLOBAL_ID/SUBDIR`. TYPE désigne le type de lieu (par exemple, `nfs` ou`s3`). GLOBAL\$1ID est l'identifiant unique au monde de la ressource qui soutient l'emplacement. Un exemple pour l'EFS est`us-east-2.fs-abcd1234`. Un exemple pour Amazon S3 est le nom du compartiment, tel que`myBucket`. Un exemple de NFS est une IPv6 adresse IPv4 ou un nom d'hôte valide conforme au DNS. SUBDIR est un chemin de système de fichiers valide, délimité par des barres obliques, conformément à la convention \$1nix. Pour NFS et Amazon EFS, il s'agit du chemin d'exportation pour monter l'emplacement. Pour Amazon S3, il s'agit du chemin du préfixe vers lequel vous montez et que vous considérez comme la racine de l'emplacement. Type : Chaîne Contraintes de longueur : longueur maximale de 4360. Modèle : `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) # ManagedSecretConfig Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification permettant DataSync d'accéder à un emplacement de transfert spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets Manager ## Table des matières ** SecretArn ** Spécifie l'ARN d'un AWS Secrets Manager secret. Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) # ManifestConfig Configure un manifeste, qui est une liste de fichiers ou d'objets que vous souhaitez AWS DataSync transférer. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). ## Table des matières ** Action ** Spécifie à quoi DataSync sert le manifeste. Type : String Valeurs valides : `TRANSFER` Obligatoire : non ** Format ** Spécifie le format de fichier de votre manifeste. Pour plus d'informations, consultez la section [Création d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create). Type : String Valeurs valides : `CSV` Obligatoire : non ** Source ** Spécifie le manifeste que vous souhaitez DataSync utiliser et l'endroit où il est hébergé. Vous devez spécifier ce paramètre si vous configurez un nouveau manifeste le 7 février 2024 ou après cette date. Si ce n'est pas le cas, vous recevrez un code d'état 400 et une `ValidationException` erreur indiquant qu'il vous manque le rôle IAM DataSync pour accéder au compartiment S3 dans lequel vous hébergez votre manifeste. Pour plus d'informations, consultez la section [Fournir DataSync l'accès à votre manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access). Type : objet [SourceManifestConfig](API_SourceManifestConfig.md) Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) # NfsMountOptions Spécifie comment DataSync accéder à un emplacement à l'aide du protocole NFS. ## Table des matières ** Version ** Spécifie la version NFS que vous DataSync souhaitez utiliser lors du montage de votre partage NFS. Si le serveur refuse d'utiliser la version spécifiée, la tâche échoue. Vous pouvez spécifier les options suivantes : + `AUTOMATIC`(par défaut) : DataSync choisit la version 4.1 de NFS. + `NFS3` : version de protocole sans état qui permet des écritures asynchrones sur le serveur. + `NFSv4_0` : version de protocole avec état et compatible avec le pare-feu qui prend en charge les délégations et les pseudo-systèmes de fichiers. + `NFSv4_1` : version de protocole avec état qui prend en charge les sessions, les délégations de répertoires et le traitement parallèle des données. NFS version 4.1 inclut également toutes les fonctionnalités disponibles dans la version 4.0. DataSync ne prend actuellement en charge que la version 3 de NFS avec Amazon FSx pour les sites NetApp ONTAP. Type : String Valeurs valides : `AUTOMATIC | NFS3 | NFS4_0 | NFS4_1` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) # OnPremConfig Les AWS DataSync agents qui peuvent se connecter à votre serveur de fichiers NFS (Network File System). ## Table des matières ** AgentArns ** Les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre serveur de fichiers NFS. Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section [Utilisation de plusieurs DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents). Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : oui ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) # Options Indique comment votre tâche de transfert est configurée. Ces options incluent le mode DataSync de gestion des fichiers, des objets et des métadonnées associées lors de votre transfert. Vous pouvez également spécifier comment vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options. Chaque option possède une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas besoin de configurer d'option avant d'appeler [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Vous pouvez également remplacer vos options de tâche pour chaque exécution de tâche. Par exemple, vous souhaiterez peut-être ajuster le `LogLevel` pour une exécution individuelle. ## Table des matières ** Atime ** Spécifie s'il faut conserver les métadonnées indiquant la dernière fois qu'un fichier a été lu ou écrit. Le comportement de `Atime` n'est pas entièrement standard sur toutes les plateformes. DataSync Vous ne pouvez donc le faire que dans la mesure du possible. + `BEST_EFFORT`(par défaut) : DataSync tente de conserver l'`Atime`attribut d'origine sur tous les fichiers source (c'est-à-dire la version avant les `PREPARING` étapes d'exécution de la tâche). Cette option est recommandée. + `NONE`- Ignore`Atime`. Si `Atime` est défini sur `BEST_EFFORT`, `Mtime` doit être défini sur `PRESERVE`. Si `Atime` est défini sur `NONE`, `Mtime` doit également être défini sur `NONE`. Type : Chaîne Valeurs valides : `NONE | BEST_EFFORT` Obligatoire : non ** BytesPerSecond ** Limite la bande passante utilisée par une DataSync tâche. Par exemple, si vous DataSync souhaitez utiliser un maximum de 1 Mo, définissez cette valeur sur `1048576` (`=1024*1024`). Type : Long Plage valide : Valeur minimum de -1. Obligatoire : non ** Gid ** Spécifie l'ID de groupe POSIX (GID) des propriétaires du fichier. + `INT_VALUE`(par défaut) - Préserve la valeur entière de l'ID utilisateur (UID) et du GID, ce qui est recommandé. + `NONE`- Ignore l'UID et le GID. Pour plus d'informations, voir [Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). Type : Chaîne Valeurs valides : `NONE | INT_VALUE | NAME | BOTH` Obligatoire : non ** LogLevel ** Spécifie le type de journaux DataSync publiés dans un groupe de CloudWatch journaux Amazon Logs. Pour spécifier le groupe de journaux, consultez [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn). + `BASIC`- Publie des journaux contenant uniquement des informations de base (telles que les erreurs de transfert). + `TRANSFER`- Publie des journaux pour tous les fichiers ou objets transférés par votre DataSync tâche et vérifie l'intégrité des données. + `OFF`- Aucun journal n'est publié. Type : Chaîne Valeurs valides : `OFF | BASIC | TRANSFER` Obligatoire : non ** Mtime ** Spécifie s'il faut conserver les métadonnées indiquant la dernière fois qu'un fichier a été écrit avant l'`PREPARING`étape d'exécution de votre tâche. Cette option est requise lorsque vous devez exécuter une tâche plusieurs fois. + `PRESERVE`(par défaut) - Préserve l'original`Mtime`, ce qui est recommandé. + `NONE`- Ignore`Mtime`. Si `Mtime` est défini sur `PRESERVE`, `Atime` doit être défini sur `BEST_EFFORT`. Si `Mtime` est défini sur `NONE`, `Atime` doit également être défini sur `NONE`. Type : Chaîne Valeurs valides : `NONE | PRESERVE` Obligatoire : non ** ObjectTags ** Spécifie si vous DataSync souhaitez utiliser des balises `PRESERVE` d'objet (comportement par défaut) lors du transfert entre systèmes de stockage d'objets. Si vous souhaitez que votre DataSync tâche ignore les balises d'objets, spécifiez la `NONE` valeur. Type : Chaîne Valeurs valides : `PRESERVE | NONE` Obligatoire : non ** OverwriteMode ** Spécifie s'il DataSync faut modifier ou conserver les données à l'emplacement de destination. + `ALWAYS`(par défaut) : DataSync modifie les données dans l'emplacement de destination lorsque les données source (y compris les métadonnées) ont changé. En cas de DataSync remplacement d'objets, des frais supplémentaires peuvent vous être facturés pour certaines classes de stockage Amazon S3 (par exemple, pour la récupération ou la suppression anticipée). Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux transferts Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `NEVER`- DataSync ne remplace pas les données dans l'emplacement de destination, même si les données source ont changé. Vous pouvez utiliser cette option pour vous protéger contre le remplacement des modifications apportées aux fichiers ou aux objets dans la destination. Type : Chaîne Valeurs valides : `ALWAYS | NEVER` Obligatoire : non ** PosixPermissions ** Spécifie quels utilisateurs ou groupes peuvent accéder à un fichier dans un but spécifique, tel que la lecture, l'écriture ou l'exécution du fichier. Pour plus d'informations, voir [Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `PRESERVE`(par défaut) - Préserve les autorisations de style POSIX, ce qui est recommandé. + `NONE`- Ignore les autorisations de type POSIX. DataSync peut conserver les autorisations existantes d'un emplacement source. Type : Chaîne Valeurs valides : `NONE | PRESERVE` Obligatoire : non ** PreserveDeletedFiles ** Spécifie si les fichiers de l'emplacement de destination qui n'existent pas dans la source doivent être conservés. Cette option peut avoir une incidence sur le coût de stockage de votre Amazon S3. Si votre tâche supprime des objets, des frais de stockage minimum peuvent vous être facturés pour certaines classes de stockage. Pour obtenir des informations détaillées, consultez la section [Considérations relatives à l'utilisation des classes de stockage Amazon S3 dans DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `PRESERVE`(par défaut) - Ignore ces fichiers de destination, ce qui est recommandé. + `REMOVE`- Supprime les fichiers de destination absents de la source. Si vous définissez ce paramètre sur`REMOVE`, vous ne pouvez pas le `TransferMode` définir sur`ALL`. Lorsque vous transférez toutes les données, DataSync il ne scanne pas votre position de destination et ne sait pas quoi supprimer. Type : Chaîne Valeurs valides : `PRESERVE | REMOVE` Obligatoire : non ** PreserveDevices ** Spécifie s'il DataSync convient de conserver les métadonnées des unités de blocs et de caractères dans l'emplacement source et de recréer les fichiers avec le nom et les métadonnées de ce périphérique sur la destination. DataSync copie uniquement le nom et les métadonnées de ces appareils. DataSync Impossible de copier le contenu réel de ces appareils car ils ne sont pas des terminaux et ne renvoient pas de marqueur end-of-file (EOF). + `NONE`(par défaut) - Ignore les périphériques spéciaux (recommandé). + `PRESERVE`- Préserve les métadonnées des caractères et des blocs du périphérique. Cette option n'est actuellement pas prise en charge pour Amazon EFS. Type : Chaîne Valeurs valides : `NONE | PRESERVE` Obligatoire : non ** SecurityDescriptorCopyFlags ** Spécifie les composants du descripteur de sécurité SMB qui sont copiés des objets source vers les objets de destination. Cette valeur est uniquement utilisée pour les transferts entre les sites SMB et Amazon FSx pour les serveurs de fichiers Windows ou entre deux FSx pour les emplacements de serveurs de fichiers Windows. Pour plus d'informations, voir [Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `OWNER_DACL`(par défaut) - Pour chaque objet copié, DataSync copie les métadonnées suivantes : + Le propriétaire de l'objet. + Listes de contrôle d'accès discrétionnaires NTFS (DACLs), qui déterminent s'il faut accorder l'accès à un objet. DataSync ne copiera pas les listes de contrôle d'accès au système NTFS (SACLs) avec cette option. + `OWNER_DACL_SACL`- Pour chaque objet copié, DataSync copie les métadonnées suivantes : + Le propriétaire de l'objet. + Listes de contrôle d'accès discrétionnaires NTFS (DACLs), qui déterminent s'il faut accorder l'accès à un objet. + SACLs, qui sont utilisés par les administrateurs pour consigner les tentatives d'accès à un objet sécurisé. La copie SACLs nécessite l'octroi d'autorisations supplémentaires à l'utilisateur Windows DataSync qui accède à votre site SMB. Pour plus d'informations sur le choix d'un utilisateur doté des autorisations appropriées, consultez les autorisations requises pour [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx pour Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) ou [FSx pour ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (selon le type d'emplacement de votre transfert). + `NONE`- Aucun des composants du descripteur de sécurité SMB n'est copié. Les objets de destination appartiennent à l'utilisateur qui a été indiqué pour accéder à l'emplacement de destination. DACLs et SACLs sont définis en fonction de la configuration du serveur de destination. Type : Chaîne Valeurs valides : `NONE | OWNER_DACL | OWNER_DACL_SACL` Obligatoire : non ** TaskQueueing ** Spécifie si vos tâches de transfert doivent être placées dans une file d'attente dans certains scénarios lors de l'[exécution de plusieurs tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks). C'est le `ENABLED` cas par défaut. Type : Chaîne Valeurs valides : `ENABLED | DISABLED` Obligatoire : non ** TransferMode ** Spécifie s'il DataSync transfère uniquement les données (y compris les métadonnées) qui diffèrent d'un emplacement à l'autre après une copie initiale ou s'il transfère toutes les données à chaque fois que vous exécutez la tâche. Si vous prévoyez des transferts récurrents, vous souhaiterez peut-être uniquement transférer les modifications apportées depuis l'exécution de votre tâche précédente. + `CHANGED`(par défaut) - Après votre transfert complet initial, DataSync copie uniquement les données et les métadonnées qui diffèrent entre l'emplacement source et l'emplacement de destination. + `ALL`- DataSync copie tout ce qui se trouve dans la source vers la destination sans comparer les différences entre les emplacements. Type : Chaîne Valeurs valides : `CHANGED | ALL` Obligatoire : non ** Uid ** Spécifie l'ID utilisateur POSIX (UID) du propriétaire du fichier. + `INT_VALUE`(par défaut) - Préserve la valeur entière de l'UID et de l'ID de groupe (GID), ce qui est recommandé. + `NONE`- Ignore l'UID et le GID. Pour plus d'informations, consultez la section [Métadonnées copiées par DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied). Type : Chaîne Valeurs valides : `NONE | INT_VALUE | NAME | BOTH` Obligatoire : non ** VerifyMode ** Spécifie si et comment DataSync vérifie l'intégrité de vos données à la fin de votre transfert. + `ONLY_FILES_TRANSFERRED`(recommandé) : DataSync calcule la somme de contrôle des données transférées (y compris les métadonnées) à l'emplacement source. À la fin du transfert, compare DataSync ensuite cette somme de contrôle à la somme de contrôle calculée sur ces données à destination. **Note** Il s'agit de l'option par défaut pour les [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Nous recommandons cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux sites Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `POINT_IN_TIME_CONSISTENT`- À la fin du transfert, DataSync vérifie l'intégralité de la source et de la destination pour vérifier que les deux emplacements sont parfaitement synchronisés. **Note** Il s'agit de l'option par défaut pour les [tâches en mode de base](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) et n'est actuellement pas prise en charge avec les tâches en mode amélioré. Si vous utilisez un [manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), il analyse et vérifie DataSync uniquement ce qui est répertorié dans le manifeste. Vous ne pouvez pas utiliser cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux sites Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `NONE`- DataSync effectue des contrôles d'intégrité des données uniquement pendant votre transfert. Contrairement aux autres options, il n'y a aucune vérification supplémentaire à la fin de votre transfert. Type : Chaîne Valeurs valides : `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) # Platform Les informations relatives à la plate-forme concernant l' AWS DataSync agent, telles que le numéro de version. ## Table des matières ** Version ** Version de l' DataSync agent. Type : String Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) # PrivateLinkConfig Spécifie la manière dont votre AWS DataSync agent se connecte à AWS l'aide d'un point de terminaison de [service de cloud privé virtuel (VPC)](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc). Un agent qui utilise un point de terminaison VPC n'est pas accessible via Internet public. ## Table des matières ** PrivateLinkEndpoint ** Spécifie le point de terminaison VPC fourni par [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html)lequel votre agent se connecte. Type : Chaîne Contraintes de longueur : longueur minimale de 7. Longueur maximale de 15. Modèle : `\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` Obligatoire : non ** SecurityGroupArns ** Spécifie les Amazon Resource Names (ARN) du groupe de sécurité qui fournit l' DataSync accès à votre point de terminaison VPC. Vous ne pouvez spécifier qu'un seul ARN. Type : tableau de chaînes Membres du tableau : nombre fixe de 1 élément. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : non ** SubnetArns ** Spécifie l'ARN du sous-réseau où se trouve le point de terminaison de votre VPC. Vous ne pouvez spécifier qu'un seul ARN. Type : tableau de chaînes Membres du tableau : nombre fixe de 1 élément. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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]+$` Obligatoire : non ** VpcEndpointId ** Spécifie l'ID du point de terminaison VPC auquel votre agent se connecte. Type : Chaîne Modèle : `^vpce-[0-9a-f]{17}$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) # QopConfiguration La configuration de la qualité de protection (QOP) spécifie les paramètres RPC (Remote Procedure Call) et de confidentialité du transfert de données configurés sur le cluster de système de fichiers distribué Hadoop (HDFS). ## Table des matières ** DataTransferProtection ** Le paramètre de protection du transfert de données configuré sur le cluster HDFS. Ce paramètre correspond à votre paramètre `dfs.data.transfer.protection` dans le fichier `hdfs-site.xml` sur votre cluster Hadoop. Type : String Valeurs valides : `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY` Obligatoire : non ** RpcProtection ** Le paramètre de protection RPC configuré sur le cluster HDFS. Ce paramètre correspond au paramètre `hadoop.rpc.protection` de votre fichier `core-site.xml` sur votre cluster Hadoop. Type : String Valeurs valides : `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) # ReportDestination Spécifie l'endroit DataSync où est chargé votre [rapport de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). ## Table des matières ** S3 ** Spécifie le compartiment Amazon S3 dans lequel DataSync télécharge votre rapport de tâches. Type : objet [ReportDestinationS3](API_ReportDestinationS3.md) Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) # ReportDestinationS3 Spécifie le compartiment Amazon S3 dans lequel DataSync télécharge votre [rapport de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). ## Table des matières ** BucketAccessRoleArn ** Spécifie le nom de ressource Amazon (ARN) de la politique IAM qui permet DataSync de télécharger un rapport de tâches dans votre compartiment S3. Pour plus d'informations, consultez [ DataSync Autoriser le chargement d'un rapport de tâches dans un compartiment Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Obligatoire : oui ** S3BucketArn ** Spécifie l'ARN du compartiment S3 dans lequel DataSync télécharge votre rapport. Type : Chaîne Contraintes de longueur : longueur maximale de 268. Modèle : `^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}$` Obligatoire : oui ** Subdirectory ** Spécifie un préfixe de compartiment pour votre rapport. Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) # ReportOverride Spécifie le niveau de détail d'un aspect particulier de votre [rapport de DataSync tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). ## Table des matières ** ReportLevel ** Spécifie si votre rapport de tâches inclut uniquement les erreurs ou les réussites et les erreurs. Par exemple, il se peut que votre rapport n'inclue généralement que les éléments qui ne se sont pas bien déroulés dans votre transfert (`ERRORS_ONLY`). Dans le même temps, vous souhaitez vérifier que votre [filtre de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) fonctionne correctement. Dans ce cas, vous pouvez obtenir une liste des fichiers ignorés DataSync avec succès et des fichiers transférés que vous n'avez pas dû transférer (`SUCCESSES_AND_ERRORS`). Type : String Valeurs valides : `ERRORS_ONLY | SUCCESSES_AND_ERRORS` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) # ReportOverrides Le niveau de détail inclus dans chaque aspect de votre [rapport de DataSync tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). ## Table des matières ** Deleted ** Spécifie le niveau de rapport pour les fichiers, les objets et les répertoires qui DataSync ont été tentés de supprimer dans votre emplacement de destination. Cela ne s'applique que si vous [configurez votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) pour supprimer des données dans la destination qui ne figurent pas dans la source. Type : objet [ReportOverride](API_ReportOverride.md) Obligatoire : non ** Skipped ** Spécifie le niveau de signalement pour les fichiers, les objets et les répertoires qui DataSync ont tenté d'être ignorés lors de votre transfert. Type : objet [ReportOverride](API_ReportOverride.md) Obligatoire : non ** Transferred ** Spécifie le niveau de signalement des fichiers, objets et répertoires ayant fait l'objet d'une DataSync tentative de transfert. Type : objet [ReportOverride](API_ReportOverride.md) Obligatoire : non ** Verified ** Spécifie le niveau de rapport pour les fichiers, les objets et les répertoires qui DataSync ont tenté de vérifier à la fin de votre transfert. Type : objet [ReportOverride](API_ReportOverride.md) Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) # ReportResult Indique si un [rapport de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) complet DataSync a été créé pour votre transfert. ## Table des matières ** ErrorCode ** Indique le code associé à l'erreur s'il n'est pas DataSync possible de créer un rapport complet. Type : chaîne Obligatoire : non ** ErrorDetail ** Fournit des informations sur les problèmes rencontrés lors de la création d'un rapport. Type : chaîne Obligatoire : non ** Status ** DataSync Indique si vous travaillez toujours sur votre rapport, si vous avez créé un rapport ou si vous ne pouvez pas créer un rapport complet. Type : String Valeurs valides : `PENDING | SUCCESS | ERROR` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) # S3Config Spécifie le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) DataSync utilisé pour accéder à votre compartiment S3. Pour plus d'informations, consultez la section [Fournir DataSync un accès aux compartiments S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). ## Table des matières ** BucketAccessRoleArn ** Spécifie l'ARN du rôle IAM DataSync utilisé pour accéder à votre compartiment S3. Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Obligatoire : oui ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) # S3ManifestConfig Spécifie le compartiment S3 dans lequel vous hébergez le manifeste que vous AWS DataSync souhaitez utiliser. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). ## Table des matières ** BucketAccessRoleArn ** Spécifie le rôle Gestion des identités et des accès AWS (IAM) qui permet d'accéder DataSync à votre manifeste. Pour plus d'informations, consultez la section [Fournir DataSync l'accès à votre manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access). Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Obligatoire : oui ** ManifestObjectPath ** Spécifie la clé d'objet Amazon S3 de votre manifeste. Cela peut inclure un préfixe (par exemple,`prefix/my-manifest.csv`). Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Obligatoire : oui ** S3BucketArn ** Spécifie le nom de ressource Amazon (ARN) du compartiment S3 dans lequel vous hébergez votre manifeste. Type : Chaîne Contraintes de longueur : longueur maximale de 268. Modèle : `^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}$` Obligatoire : oui ** ManifestObjectVersionId ** Spécifie l'ID de version de l'objet du manifeste que vous DataSync souhaitez utiliser. Si ce n'est pas le cas, DataSync utilise la dernière version de l'objet. Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100. Modèle : `^.+$` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) # SmbMountOptions Spécifie la version du protocole SMB (Server Message Block) qui permet d'accéder AWS DataSync à un serveur de fichiers SMB. ## Table des matières ** Version ** Par défaut, choisit DataSync automatiquement une version du protocole SMB en fonction de la négociation avec votre serveur de fichiers SMB. Vous pouvez également configurer DataSync pour utiliser une version SMB spécifique, mais nous vous recommandons de le faire uniquement si DataSync vous rencontrez des difficultés pour négocier automatiquement avec le serveur de fichiers SMB. Les options de configuration de la version SMB sont les suivantes : + `AUTOMATIC`(par défaut) : DataSync et le serveur de fichiers SMB négocient la version la plus élevée de SMB qu'ils supportent mutuellement entre 2.1 et 3.1.1. Il s'agit là de l'option recommandée. Si vous optez pour une version spécifique que votre serveur de fichiers ne prend pas en charge, vous risquez de recevoir une erreur `Operation Not Supported`. + `SMB3` : restreint la négociation de protocole à la version SMB 3.0.2 uniquement. + `SMB2`: Limite la négociation du protocole à la version 2.1 de SMB uniquement. + `SMB2_0`: limite la négociation du protocole à la version 2.0 de SMB uniquement. + `SMB1`: limite la négociation du protocole à la version 1.0 de SMB uniquement. **Note** L'`SMB1`option n'est pas disponible lors de la [création d'un point de vente Amazon FSx pour NetApp ONTAP.](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html) Type : String Valeurs valides : `AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) # SourceManifestConfig Spécifie le manifeste que vous souhaitez AWS DataSync utiliser et l'endroit où il est hébergé. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). ## Table des matières ** S3 ** Spécifie le compartiment S3 dans lequel vous hébergez votre manifeste. Type : objet [S3ManifestConfig](API_S3ManifestConfig.md) Obligatoire : oui ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) # TagListEntry Une paire clé-valeur représentant une balise unique appliquée à une AWS ressource. ## Table des matières ** Key ** La clé d'une balise AWS de ressource. Type : String Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:/-]+$` Obligatoire : oui ** Value ** La valeur d'une balise AWS de ressource. Type : String Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) # TaskExecutionFilesFailedDetail Nombre de fichiers ou d'objets dont la préparation, le transfert, la vérification et la suppression DataSync échouent lors de l'exécution de la tâche. **Note** S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Table des matières ** Delete ** Le nombre de fichiers ou d'objets qui DataSync ne sont pas supprimés pendant l'exécution de la tâche. Type : Long Obligatoire : non ** Prepare ** Le nombre de fichiers ou d'objets dont la préparation DataSync échoue pendant l'exécution de la tâche. Type : Long Obligatoire : non ** Transfer ** Le nombre de fichiers ou d'objets qui DataSync ne parviennent pas à être transférés pendant l'exécution de la tâche. Type : Long Obligatoire : non ** Verify ** Le nombre de fichiers ou d'objets dont la vérification DataSync échoue pendant l'exécution de la tâche. Type : Long Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) # TaskExecutionFilesListedDetail Le nombre de fichiers ou d'objets DataSync trouvés sur votre site. **Note** S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Table des matières ** AtDestinationForDelete ** Le nombre de fichiers ou d'objets trouvés DataSync sur votre emplacement de destination. Ce compteur n'est applicable que si vous [configurez votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling) pour supprimer des données dans la destination qui ne figurent pas dans la source. Type : Long Obligatoire : non ** AtSource ** Le nombre de fichiers ou d'objets DataSync trouvés dans votre emplacement source. + Dans le cas d'un [manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), DataSync répertorie uniquement le contenu de votre manifeste (et non tout ce qui se trouve à votre emplacement source). + Avec un [filtre d'inclusion](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html), DataSync répertorie uniquement ce qui correspond au filtre à votre emplacement source. + Avec un filtre d'exclusion, DataSync répertorie tout ce qui se trouve à votre emplacement source avant d'appliquer le filtre. Type : Long Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) # TaskExecutionFoldersFailedDetail Nombre de répertoires dont la liste, la préparation, le transfert, la vérification et la suppression DataSync échouent pendant l'exécution de votre tâche. **Note** S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Table des matières ** Delete ** Le nombre de répertoires qui DataSync ne sont pas supprimés lors de l'exécution de la tâche. Type : Long Obligatoire : non ** List ** Le nombre de répertoires qui DataSync ne sont pas listés lors de l'exécution de votre tâche. Type : Long Obligatoire : non ** Prepare ** Le nombre de répertoires dont la préparation DataSync échoue pendant l'exécution de la tâche. Type : Long Obligatoire : non ** Transfer ** Le nombre de répertoires qui DataSync ne parviennent pas à être transférés pendant l'exécution de la tâche. Type : Long Obligatoire : non ** Verify ** Le nombre de répertoires dont la vérification DataSync échoue lors de l'exécution de la tâche. Type : Long Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) # TaskExecutionFoldersListedDetail Le nombre de répertoires DataSync trouvés dans vos établissements. **Note** S'applique uniquement aux [tâches en mode amélioré](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Table des matières ** AtDestinationForDelete ** Le nombre de répertoires trouvés DataSync sur votre site de destination. Ce compteur n'est applicable que si vous [configurez votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling) pour supprimer des données dans la destination qui ne figurent pas dans la source. Type : Long Obligatoire : non ** AtSource ** Le nombre de répertoires DataSync trouvés à votre emplacement source. + Dans le cas d'un [manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), DataSync répertorie uniquement le contenu de votre manifeste (et non tout ce qui se trouve à votre emplacement source). + Avec un [filtre d'inclusion](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html), DataSync répertorie uniquement ce qui correspond au filtre à votre emplacement source. + Avec un filtre d'exclusion, DataSync répertorie tout ce qui se trouve à votre emplacement source avant d'appliquer le filtre. Type : Long Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) # TaskExecutionListEntry Représente une entrée unique dans une liste d'exécutions de AWS DataSync tâches renvoyée avec l'[ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html)opération. ## Table des matières ** Status ** État de l'exécution d'une tâche. Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Type : Chaîne Valeurs valides : `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` Obligatoire : non ** TaskExecutionArn ** Le nom de ressource Amazon (ARN) d'une exécution de tâche. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** TaskMode ** Le mode tâche que vous utilisez. Pour plus d'informations, consultez la section [Choix d'un mode de tâche pour le transfert de données](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Chaîne Valeurs valides : `BASIC | ENHANCED` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) # TaskExecutionResultDetail Fournit des informations détaillées sur le résultat de l'exécution de vos AWS DataSync tâches. ## Table des matières ** ErrorCode ** Erreur DataSync survenue lors de l'exécution de votre tâche. Vous pouvez utiliser ces informations pour [résoudre les problèmes](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Type : chaîne Obligatoire : non ** ErrorDetail ** Description détaillée d'une erreur DataSync survenue lors de l'exécution de votre tâche. Vous pouvez utiliser ces informations pour [résoudre les problèmes](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Type : chaîne Obligatoire : non ** PrepareDuration ** Durée en millisecondes pendant laquelle votre tâche a été exécutée dans l'étape. `PREPARING` Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Pour les tâches en mode amélioré, la valeur est toujours`0`. Pour plus d'informations, consultez [Comment DataSync prépare votre transfert de données](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares). Type : long Plage valide : Valeur minimum de 0. Obligatoire : non ** PrepareStatus ** État de l'`PREPARING`étape d'exécution de votre tâche. Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Type : String Valeurs valides : `PENDING | SUCCESS | ERROR` Obligatoire : non ** TotalDuration ** Durée en millisecondes pendant laquelle votre tâche a été exécutée. Type : long Plage valide : Valeur minimum de 0. Obligatoire : non ** TransferDuration ** Durée en millisecondes pendant laquelle votre tâche a été exécutée dans l'étape. `TRANSFERRING` Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Pour les tâches en mode amélioré, la valeur est toujours`0`. Pour plus d'informations, consultez [Comment DataSync transférer vos données](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers). Type : long Plage valide : Valeur minimum de 0. Obligatoire : non ** TransferStatus ** État de l'`TRANSFERRING`étape d'exécution de votre tâche. Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Type : String Valeurs valides : `PENDING | SUCCESS | ERROR` Obligatoire : non ** VerifyDuration ** Durée en millisecondes pendant laquelle votre tâche a été exécutée dans l'étape. `VERIFYING` Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Pour les tâches en mode amélioré, la valeur est toujours`0`. Pour plus d'informations, consultez [Comment DataSync vérifier l'intégrité de vos données](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works). Type : long Plage valide : Valeur minimum de 0. Obligatoire : non ** VerifyStatus ** État de l'`VERIFYING`étape d'exécution de votre tâche. Pour plus d'informations, consultez la section [Statuts d'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Type : String Valeurs valides : `PENDING | SUCCESS | ERROR` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) # TaskFilter Vous pouvez utiliser des filtres d'API pour affiner la liste des ressources renvoyées par`ListTasks`. Par exemple, pour récupérer toutes les tâches d'un emplacement source, vous pouvez les utiliser `ListTasks` avec le nom du filtre `LocationId` et `Operator Equals` avec l'ARN de l'emplacement. Pour plus d'informations, consultez la section [Filtrage DataSync des ressources](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html). ## Table des matières ** Name ** Nom du filtre utilisé. Chaque appel d'API prend en charge une liste de filtres disponibles pour celui-ci. Par exemple, `LocationId` ou `ListTasks`. Type : String Valeurs valides : `LocationId | CreationTime` Obligatoire : oui ** Operator ** Opérateur utilisé pour comparer les valeurs des filtres (par exemple, `Equals` ou`Contains`). Type : String Valeurs valides : `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith` Obligatoire : oui ** Values ** Les valeurs que vous souhaitez filtrer. Par exemple, vous souhaiterez peut-être afficher uniquement les tâches relatives à un lieu de destination spécifique. Type : tableau de chaînes Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255. Modèle : `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$` Obligatoire : oui ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) # TaskListEntry Représente une entrée unique dans une liste de tâches. `TaskListEntry`renvoie un tableau contenant une liste de tâches lorsque l'[ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html)opération est appelée. Une tâche inclut les systèmes de fichiers source et de destination à synchroniser ainsi que les options à utiliser pour les tâches. ## Table des matières ** Name ** Nom de la tâche . Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ** Status ** État de la tâche. Type : Chaîne Valeurs valides : `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` Obligatoire : non ** TaskArn ** Amazon Resource Name (ARN) de la tâche. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** TaskMode ** Le mode tâche que vous utilisez. Pour plus d'informations, consultez la section [Choix d'un mode de tâche pour le transfert de données](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type : Chaîne Valeurs valides : `BASIC | ENHANCED` Obligatoire : non ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) # TaskReportConfig Spécifie la manière dont vous souhaitez configurer un rapport de tâches, qui fournit des informations détaillées sur votre AWS DataSync transfert. Pour plus d'informations, consultez la section [Rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). ## Table des matières ** Destination ** Spécifie le compartiment Amazon S3 dans lequel DataSync télécharge votre rapport de tâches. Pour plus d'informations, consultez la section [Rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access). Type : objet [ReportDestination](API_ReportDestination.md) Obligatoire : non ** ObjectVersionIds ** Spécifie si votre rapport de tâches inclut la nouvelle version de chaque objet transféré dans un compartiment S3. Cela ne s'applique que si vous [activez le versionnement sur votre bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html). N'oubliez pas que définir cette valeur sur `INCLUDE` peut augmenter la durée d'exécution de vos tâches. Type : String Valeurs valides : `INCLUDE | NONE` Obligatoire : non ** OutputType ** Spécifie le type de rapport de tâches que vous souhaitez : + `SUMMARY_ONLY`: fournit les informations nécessaires sur votre tâche, notamment le nombre de fichiers, d'objets et de répertoires transférés et la durée du transfert. + `STANDARD`: fournit des informations complètes sur votre tâche, notamment une liste complète des fichiers, objets et répertoires qui ont été transférés, ignorés, vérifiés, etc. Type : String Valeurs valides : `SUMMARY_ONLY | STANDARD` Obligatoire : non ** Overrides ** Personnalise le niveau de reporting pour certains aspects de votre rapport de tâches. Par exemple, votre rapport peut généralement ne contenir que des erreurs, mais vous pouvez spécifier que vous souhaitez une liste des réussites et des erreurs uniquement pour les fichiers qui DataSync ont tenté de supprimer dans votre emplacement de destination. Type : objet [ReportOverrides](API_ReportOverrides.md) Obligatoire : non ** ReportLevel ** Spécifie si vous souhaitez que votre rapport de tâches inclue uniquement les problèmes rencontrés lors de votre transfert ou une liste de ce qui a réussi et de ce qui n'a pas été le cas. + `ERRORS_ONLY`: un rapport indique ce qui n' DataSync a pas pu être transféré, ignoré, vérifié ou supprimé. + `SUCCESSES_AND_ERRORS`: un rapport indique ce qui DataSync a pu ou non être transféré, ignoré, vérifié et supprimé. Type : String Valeurs valides : `ERRORS_ONLY | SUCCESSES_AND_ERRORS` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) # TaskSchedule Configure votre AWS DataSync tâche pour qu'elle soit exécutée selon un [calendrier](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (à un intervalle minimum d'une heure). ## Table des matières ** ScheduleExpression ** Spécifie le planning de vos tâches à l'aide d'une expression cron ou rate. Utilisez des expressions cron pour les plannings de tâches exécutés à une heure et à un jour spécifiques. Par exemple, l'expression cron suivante crée un planning de tâches qui s'exécute à 8 h le premier mercredi de chaque mois : `cron(0 8 * * 3#1)` Utilisez des expressions de taux pour les planifications de tâches exécutées à intervalles réguliers. Par exemple, l'expression de taux suivante crée un planning de tâches exécuté toutes les 12 heures : `rate(12 hours)` Pour plus d'informations sur la syntaxe des expressions cron et rate, consultez le [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). Type : String Contraintes de longueur : longueur maximale de 256. Modèle : `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\+]*$` Obligatoire : oui ** Status ** Spécifie s'il faut activer ou désactiver votre calendrier de tâches. Votre calendrier est activé par défaut, mais il peut arriver que vous deviez le désactiver. Par exemple, vous devrez peut-être suspendre un transfert récurrent pour résoudre un problème lié à votre tâche ou effectuer des opérations de maintenance sur votre système de stockage. DataSync peut désactiver automatiquement votre planification si votre tâche échoue à plusieurs reprises avec la même erreur. Pour de plus amples informations, veuillez consulter [TaskScheduleDetails](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html). Type : String Valeurs valides : `ENABLED | DISABLED` Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) # TaskScheduleDetails Fournit des informations sur le [planning de vos AWS DataSync tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). ## Table des matières ** DisabledBy ** Indique la façon dont votre calendrier de tâches a été désactivé. + `USER`- Votre planning a été désactivé manuellement à l'aide de l'[UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)opération ou de DataSync la console. + `SERVICE`- Votre planning a été automatiquement désactivé DataSync car la tâche a échoué à plusieurs reprises avec la même erreur. Type : String Valeurs valides : `USER | SERVICE` Obligatoire : non ** DisabledReason ** Indique la raison pour laquelle le calendrier des tâches est désactivé. Si votre emploi du temps est désactivé par`USER`, un `Manually disabled by user.` message s'affiche. Si votre planification est désactivée par`SERVICE`, un message d'erreur s'affiche pour vous aider à comprendre pourquoi la tâche continue d'échouer. Pour plus d'informations sur la résolution DataSync des erreurs, consultez la section [Résolution des problèmes liés aux DataSync transferts](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Type : String Contraintes de longueur : longueur maximale de 8192. Modèle : `^[\w\s.,'?!:;\/=|<>()-]*$` Obligatoire : non ** StatusUpdateTime ** Indique la dernière fois que le statut de votre planning de tâches a été modifié. Par exemple, si vous désactivez DataSync automatiquement votre programme en raison d'une erreur répétée, vous pouvez voir à quel moment le calendrier a été désactivé. Type : Timestamp Obligatoire : non ## consultez aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) # Erreurs courantes Cette section répertorie les erreurs communes aux actions d'API de tous les AWS services. Pour les erreurs spécifiques à une action d’API pour ce service, consultez la rubrique pour cette action d’API. **AccessDeniedException** Vous ne disposez pas d’un accès suffisant pour effectuer cette action. Code d’état HTTP : 400 **IncompleteSignature** La signature de la demande n'est pas conforme aux AWS normes. Code d’état HTTP : 400 **InternalFailure** Le traitement de la demande a échoué en raison d'une erreur, d'une exception ou d'un échec inconnu. Code d’état HTTP : 500 **InvalidAction** L'action ou l'opération demandée n'est pas valide. Vérifiez que l’action est entrée correctement. Code d’état HTTP : 400 **InvalidClientTokenId** Le certificat X.509 ou AWS l'ID de clé d'accès fourni n'existe pas dans nos archives. Code d’état HTTP : 403 **NotAuthorized** Vous ne disposez pas de l’autorisation nécessaire pour effectuer cette action. Code d’état HTTP : 400 **OptInRequired** L'ID de clé d' AWS accès nécessite un abonnement au service. Code d’état HTTP : 403 **RequestExpired** La demande est parvenue au service plus de 15 minutes après l'horodatage sur la demande ou plus de 15 minutes après la date d'expiration de la demande (par exemple pour les demandes pré-signées URLs), ou le horodatage sur la demande est daté dans plus de 15 minutes dans le futur. Code d’état HTTP : 400 **ServiceUnavailable** La requête a échoué en raison d’une défaillance temporaire du serveur. HTTP Status Code: 503 **ThrottlingException** La demande a été refusée suite à une limitation des demandes. Code d’état HTTP : 400 **ValidationError** L'entrée ne satisfait pas les contraintes spécifiées par un AWS service. Code d’état HTTP : 400 # Paramètres communs La liste suivante contient les paramètres que toutes les actions utilisent pour signer les demandes Signature Version 4 à l'aide d'une chaîne de requête. Tous les paramètres spécifiques d'une action particulière sont énumérées dans le sujet consacré à cette action. Pour plus d'informations sur la version 4 de Signature, consultez [la section Signing AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) du *guide de l'utilisateur IAM*. **Action** Action à effectuer. Type : chaîne Obligatoire : oui **Version** Version de l'API pour laquelle la demande est écrite, exprimée dans le format YYYY-MM-DD. Type : chaîne Obligatoire : oui **X-Amz-Algorithm** Algorithme de hachage que vous avez utilisé pour créer la signature de la demande. Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP. Type : chaîne Valeurs valides : `AWS4-HMAC-SHA256` Obligatoire : Conditionnelle **X-Amz-Credential** Valeur de la portée des informations d'identification, qui est une chaîne incluant votre clé d'accès, la date, la région cible, le service demandé et une chaîne de terminaison (« aws4\$1request »). Spécifiez la valeur au format suivant : *access\$1key*/*AAAAMMJJ*/*région*/*service*/aws4\$1request. Pour plus d'informations, consultez la section [Création d'une demande d' AWS API signée](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) dans le *guide de l'utilisateur IAM*. Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP. Type : chaîne Obligatoire : Conditionnelle **X-Amz-Date** La date utilisée pour créer la signature. Le format doit être au format de base ISO 8601 (AAAAMMJJ'T'HHMMSS'Z'). Par exemple, la date et l'heure suivantes sont une X-Amz-Date valeur valide :`20120325T120000Z`. Condition : X-Amz-Date est un en-tête facultatif pour toutes les demandes. Il peut être utilisé pour signer les demandes. Si l'en-tête Date est spécifié au format de base ISO 8601, X-Amz-Date il n'est pas obligatoire. Lorsqu'il X-Amz-Date est utilisé, il remplace toujours la valeur de l'en-tête Date. Pour plus d'informations, consultez la section [Éléments d'une signature de demande d' AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) dans le *Guide de l'utilisateur IAM*. Type : chaîne Obligatoire : Conditionnelle **X-Amz-Security-Token** Le jeton de sécurité temporaire obtenu par un appel à AWS Security Token Service (AWS STS). Pour obtenir la liste des services prenant en charge les informations d'identification de sécurité temporaires d' AWS STS, consultez [Services AWS qui fonctionnent avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dans le *Guide de l'utilisateur IAM*. Condition : Si vous utilisez des informations d'identification de sécurité temporaires provenant de AWS STS, vous devez inclure le jeton de sécurité. Type : chaîne Obligatoire : Conditionnelle **X-Amz-Signature** Spécifie la signature codée en hexadécimal qui a été calculée à partir de la chaîne à signer et de la clé de signature dérivée. Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP. Type : chaîne Obligatoire : Conditionnelle **X-Amz-SignedHeaders** Spécifie tous les en-têtes HTTP qui ont été inclus dans la demande canonique. Pour plus d'informations sur la spécification d'en-têtes signés, consultez la section [Créer une demande d' AWS API signée](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) dans le guide de l'*utilisateur IAM*. Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP. Type : chaîne Obligatoire : Conditionnelle