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. # 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)