Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateLocationS3
Una posizione è un endpoint per un bucket Amazon S3. AWS DataSyncpuò utilizzare la posizione come origine o destinazione per copiare i dati.
Importante
Prima di creare la posizione, assicurati di leggere le seguenti sezioni:
Per ulteriori informazioni, consulta Creare una posizione Amazon S3.
Sintassi della richiesta
{
"AgentArns": [ "string" ],
"S3BucketArn": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parametri della richiesta
Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- AgentArns
-
Se utilizzi DataSync un AWS Outpost, specifica gli Amazon Resource Names (ARN) degli DataSync agenti distribuiti nel tuo Outpost. Per ulteriori informazioni sul lancio di un DataSync agente su un AWS avamposto, consulta Implementa il tuo DataSync agente su. AWS Outposts
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 elementi.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^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}$Required: No
- S3BucketArn
-
L'ARN del bucket Amazon S3. Se il bucket si trova su un AWS avamposto, questo deve essere un punto di accesso ARN.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 156.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):(s3|s3-outposts):[a-z\-0-9]*:[0-9]*:.*$Campo obbligatorio: sì
- S3Config
-
Il nome della risorsa Amazon (ARN) del ruolo AWS Identity and Access Management (IAM) usato per accedere a un bucket Amazon S3.
Per informazioni dettagliate sull'utilizzo di tale ruolo, consulta Creazione di una posizione per Amazon S3 nella Guida per l'utente di AWS DataSync.
Tipo: S3Config oggetto
Campo obbligatorio: sì
- S3StorageClass
-
La classe di storage Amazon S3 in cui desideri archiviare i file quando questa posizione viene utilizzata come destinazione di attività. Per i bucket nelleRegioni AWS, la classe di storage viene impostata per impostazione predefinita su Standard. Per i bucket attiviAWS Outposts, la classe di storage viene impostata per impostazione predefinita su S3 Outposts. AWS
Per maggiori informazioni sulle classi di storage S3, consulta Classi di storage di Amazon S3
. Alcune classi di storage hanno comportamenti che possono influire sui costi di storage S3. Per informazioni dettagliate, consulta Considerazioni sull'utilizzo delle classi di storage S3 in. DataSync Tipo: String
Valori validi:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVALRequired: No
- Subdirectory
-
Una sottodirectory nel bucket Amazon S3. Questa sottodirectory in Amazon S3 viene utilizzata per leggere i dati dalla posizione di origine S3 o scrivere dati nella destinazione S3.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 4096.
Modello:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$Required: No
- Tags
-
La coppia chiave-valore che rappresenta il tag che si desidera aggiungere alla posizione. Il valore può essere una stringa vuota. Si consiglia di utilizzare tag per assegnare un nome alle risorse.
Tipo: matrice di oggetti TagListEntry
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Required: No
Sintassi della risposta
{
"LocationArn": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- LocationArn
-
L'Amazon Resource Name (ARN) della posizione del bucket Amazon S3 specificato.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^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}$
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalException
-
Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
Esempi
Fase 1. Consenti di assumere il ruolo IAM richiesto per scrivere nel bucket
L'esempio seguente mostra la policy più semplice che concede le autorizzazioni necessarie per accedere AWS DataSync a un bucket Amazon S3 di destinazione, seguita da un ruolo IAM a cui è stata associata la create-location-s3-iam-role policy.
{ "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" } ] } } }
Fase 2. Consenti al ruolo IAM specificato
Allega una policy che disponga di autorizzazioni sufficienti per accedere al bucket al ruolo. Un esempio di tale politica è la politica AWSDataSyncFullAccess gestita.
Per ulteriori informazioni, consulta AWSDataSyncFullAccess
Non è necessario creare questa politica. È gestito daAWS, quindi tutto ciò che devi fare è specificare il suo ARN nel attach-role-policy comando.
IAM_POLICY_ARN='arn:aws:iam::aws:policy/AWSDataSyncFullAccess'
Fase 3. Creare un endpoint per un bucket Amazon S3
L'esempio seguente crea un endpoint per un bucket Amazon S3.
Quando viene creato l'endpoint S3, una risposta simile al secondo esempio seguente restituisce l'Amazon Resource Name (ARN) per la nuova sede Amazon S3.
Richiesta di esempio
{
"S3BucketArn": "arn:aws:s3:::MyBucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
},
"S3StorageClass": "STANDARD",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "s3Bucket-1"
}
]
}Risposta di esempio
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
