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