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à.
Crea una posizione di trasferimento per un bucket Amazon S3. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.
Importante
Prima di iniziare, assicurati di leggere i seguenti argomenti:
Per ulteriori informazioni, consulta Configurazione dei trasferimenti con 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 per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- AgentArns
-
(Amazon S3 solo su Outposts) Specifica l'Amazon Resource Name (ARN) dell'agente sul tuo Outpost. DataSync
Per ulteriori informazioni, consulta Deploy your agent on. DataSync AWS Outposts
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 articoli.
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}$Campo obbligatorio: no
- S3BucketArn
-
Speciifica l'ARN del bucket S3 che desideri utilizzare come posizione. (Quando crei l' DataSync attività in un secondo momento, specifichi se questa posizione è una fonte o una destinazione di trasferimento.)
Se il bucket S3 si trova su una AWS Outposts risorsa, devi specificare un punto di accesso Amazon S3. Per ulteriori informazioni, consulta Gestire l'accesso ai dati con i punti di accesso Amazon S3 nella Amazon S3 User Guide.
Tipo: stringa
Limiti di lunghezza: lunghezza massima di 268.
Modello:
^arn:(aws|aws-cn|aws-us-gov|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-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-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$Campo obbligatorio: sì
- S3Config
-
Speciifica l'Amazon Resource Name (ARN) AWS Identity and Access Management del ruolo DataSync (IAM) utilizzato per accedere al bucket S3.
Per ulteriori informazioni, consulta Fornire l' DataSync accesso ai bucket S3.
Tipo: oggetto S3Config
Campo obbligatorio: sì
- S3StorageClass
-
Speciifica la classe di storage che desideri che i tuoi oggetti utilizzino quando Amazon S3 è una destinazione di trasferimento.
Per i bucket in Regioni AWS, la classe di storage predefinita è.
STANDARDPer i bucket attivi AWS Outposts, la classe di archiviazione ha come impostazione predefinita.OUTPOSTSPer ulteriori informazioni, consulta Considerazioni sulla classe di storage con i trasferimenti Amazon S3.
Tipo: stringa
Valori validi:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVALCampo obbligatorio: no
- Subdirectory
-
Speciifica un prefisso nel bucket S3 da cui eseguire la DataSync lettura o la scrittura (a seconda che il bucket sia una posizione di origine o di destinazione).
Nota
DataSync non può trasferire oggetti con un prefisso che inizia con una barra ()
/o include o pattern.///.//../Per esempio:-
/photos -
photos//2006/January -
photos/./2006/February -
photos/../2006/March
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 4096.
Modello:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$Campo obbligatorio: no
-
- Tags
-
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse. AWS Ti consigliamo di creare almeno un'etichetta con il nome della località di trasferimento.
Tipo: matrice di oggetti TagListEntry
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Campo obbligatorio: 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'ARN della posizione S3 che hai creato.
Tipo: stringa
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}: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 servizio. AWS DataSync
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 allegata create-location-s3-iam-role la policy.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}"Role": {
"Path": "/",
"RoleName": "amzn-s3-demo-bucket-access-role",
"RoleId": "role-id",
"Arn": "arn:aws:iam::account-id:role/amzn-s3-demo-bucket-access-role",
"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 creato di scrivere nel bucket
Allega al ruolo una policy con autorizzazioni sufficienti per accedere al bucket. Un esempio di tale politica è la politica AWSDataSyncFullAccess gestita.
Per ulteriori informazioni, consulta AWSDataSyncFullAccess
Non è necessario creare questa policy. È gestito da AWS, 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. Crea 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 posizione Amazon S3.
Richiesta di esempio
{
"S3BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
},
"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 una delle lingue AWS SDKs specifiche, consulta quanto segue:
