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 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: [Considerazioni sulla classe di storage con le sedi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Valutazione dei costi delle richieste S3 durante l'utilizzo DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) Per ulteriori informazioni, consulta [Configurazione dei trasferimenti con Amazon](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html) 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](CommonParameters.md). La richiesta accetta i seguenti dati in formato JSON. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (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](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent) Tipo: array di stringhe Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli. Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^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}$` Obbligatorio: no ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) nella *Amazon S3* User Guide. Tipo: String Limiti di lunghezza: lunghezza massima di 268. Modello: `^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}$` Obbligatorio: sì ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access) bucket S3. Tipo: oggetto [S3Config](API_S3Config.md) Obbligatorio: sì ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** 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 è. `STANDARD` Per i bucket attivi AWS Outposts, la classe di archiviazione ha come impostazione predefinita. `OUTPOSTS` Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con i trasferimenti Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Tipo: String Valori validi: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Campo obbligatorio: no ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** 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). DataSync non può trasferire oggetti con un prefisso che inizia con una barra () `/` o include o pattern. `//` `/./` `/../` Esempio: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Tipo: String Vincoli di lunghezza: lunghezza massima di 4096. Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Obbligatorio: no ** [Tags](#API_CreateLocationS3_RequestSyntax) ** 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](API_TagListEntry.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item. 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](#API_CreateLocationS3_ResponseSyntax) ** L'ARN della posizione S3 che hai creato. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^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}$` ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md). ** 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 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3)