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
Un emplacement est un point de terminaison pour un compartiment Amazon S3. AWS DataSyncpeut utiliser l'emplacement comme source ou destination pour copier des données.
Important
Avant de créer votre emplacement, assurez-vous de lire les sections suivantes :
Pour plus d'informations, veuillez consulter la rubrique Création d'un emplacement pour Amazon S3.
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 communs à toutes les actions, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- AgentArns
-
Si vous utilisez DataSync sur un AWS Outpost, spécifiez les Amazon Resource Names (ARN) des DataSync agents déployés sur votre Outpost. Pour plus d'informations sur le lancement d'un DataSync agent sur un AWS Outpost, voir Déployer votre DataSync agent sur AWS Outposts.
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre de 4 éléments.
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$
Obligatoire : non
- S3BucketArn
-
ARN du compartiment Amazon S3. Si le bucket se trouve sur un AWS Outpost, il doit s'agir d'un ARN de point d'accès.
Type : String
Contraintes de longueur : Longueur de 156.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):(s3|s3-outposts):[a-z\-0-9]*:[0-9]*:.*$
Obligatoire : oui
- S3Config
-
Amazon Resource Name (ARN) du rôle AWS Identity and Access Management (IAM) utilisé pour accéder à un compartiment Amazon S3.
Pour plus d'informations sur l'utilisation d'un tel rôle, veuillez consulter la rubrique Création d'un emplacement pour Amazon S3 dans le Guide de l'utilisateur AWS DataSync.
Type : objet S3Config
Obligatoire : oui
- S3StorageClass
-
Classe de stockage Amazon S3 dans laquelle vous souhaitez stocker vos fichiers lorsque cet emplacement est utilisé comme destination de tâche. Pour les compartiments dans lesRégions AWS, la classe de stockage est Standard par défaut. Pour les compartimentsAWS Outposts, la classe de stockage est Standard OutpostsAWS.
Pour de plus amples informations sur les classes de stockage S3, veuillez consulter Classes de stockage Amazon S3
. Certaines classes de stockage ont des comportements qui peuvent avoir un impact sur votre coût de stockage S3. Pour plus d'informations, veuillez consulter la rubrique Considérations relatives à l'utilisation des classes de stockage S3 dans DataSync. Type : String
Valeurs valides :
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
Obligatoire : non
- Subdirectory
-
Sous-répertoire dans le compartiment Amazon S3. Il s'agit du sous-répertoire dans Amazon S3 qui est utilisé pour lire les données à partir de l'emplacement source S3 ou écrire des données vers la destination S3.
Type : String
Contraintes de longueur : Longueur de 4 096.
Modèle :
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$
Obligatoire : non
- Tags
-
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
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
-
L'Amazon Resource Name (ARN) de l'emplacement du compartiment Amazon S3 source qui est créé.
Type : String
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|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 communes à toutes les actions, reportez-vous à la sectionErreurs courantes.
- 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
Étape 1. Autoriser l'écriture dans le compartiment
L'exemple suivant montre la politique la plus simple qui accorde les autorisations requises pour accéder AWS DataSync à un bucket Amazon S3 de destination, suivies d'un rôle IAM auquel la create-location-s3-iam-role
politique a été associée.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
"Role": { "Path": "/", "RoleName": "MyBucketAccessRole", "RoleId": "role-id", "Arn": "arn:aws:iam::account-id:role/MyBucketAccessRole", "CreateDate": "2018-07-27T02:49:23.117Z", "AssumeRolePolicyDocument": { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } } }
Étape 2. Autoriser le rôle IAM créé à écrire dans le compartiment
Associez au rôle une politique disposant des autorisations suffisantes pour accéder au bucket. La politique AWSDataSyncFullAccess
gérée est un exemple d'une telle stratégie.
Pour plus d'informations, consultez AWSDataSyncFullAccess
Vous n'avez pas besoin de créer cette politique. Il est géré parAWS, il vous suffit donc de spécifier son ARN dans la attach-role-policy
commande.
IAM_POLICY_ARN='arn:aws:iam::aws:policy/AWSDataSyncFullAccess'
Étape 3. Création d'un point de terminaison pour un compartiment Amazon S3
L'exemple suivant crée un point de terminaison pour un compartiment Amazon S3.
Lorsque le point de terminaison S3 est créé, une réponse similaire au deuxième exemple suivant renvoie l'Amazon Resource Name (ARN) pour le nouvel emplacement Amazon S3.
Exemple de demande
{
"S3BucketArn": "arn:aws:s3:::MyBucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
},
"S3StorageClass": "STANDARD",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "s3Bucket-1"
}
]
}
Exemple de réponse
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :