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à.

# CreateLocationObjectStorage
<a name="API_CreateLocationObjectStorage"></a>

Crea una *posizione* di trasferimento per un sistema di storage di oggetti. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati. È possibile effettuare trasferimenti con o senza un [DataSyncagente.](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required)

Prima di iniziare, assicurati di aver compreso i [prerequisiti](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) per lavorare con i sistemi di storage DataSync a oggetti.

## Sintassi della richiesta
<a name="API_CreateLocationObjectStorage_RequestSyntax"></a>

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "BucketName": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationObjectStorage_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AccessKey"></a>
Specifica la chiave di accesso (ad esempio, un nome utente) se sono necessarie credenziali per l'autenticazione con il server di storage di oggetti.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Modello: `^.*$`   
Obbligatorio: no

 ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AgentArns"></a>
(Facoltativo) Speciifica gli Amazon Resource Names (ARNs) degli DataSync agenti che possono connettersi al tuo sistema di storage di oggetti. Se stai configurando un trasferimento tra cloud senza agenti, non è necessario specificare un valore per questo parametro.  
Assicurati di configurare correttamente questo parametro quando crei per la prima volta la tua posizione di archiviazione. Non è possibile aggiungere o rimuovere agenti da una posizione di archiviazione dopo averla creata.
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 elementi.  
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

 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-BucketName"></a>
Specifica il nome del bucket di storage di oggetti coinvolto nel trasferimento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.  
Modello: `^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$`   
Obbligatorio: sì

 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, che include il `SecretKey` segreto DataSync utilizzato per accedere a una posizione di archiviazione degli oggetti specifica, con un segreto gestito dal cliente. AWS KMS key  
Quando includi questo parametro come parte di una `CreateLocationObjectStorage` richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme al valore specificato per il `SecretKey` parametro per creare un segreto DataSync gestito per archiviare le credenziali di accesso alla posizione.  
Assicurati di disporre DataSync dell'autorizzazione per accedere alla chiave KMS specificata. Per ulteriori informazioni, consulta [Utilizzo di un segreto gestito dal servizio crittografato con](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) un codice personalizzato. AWS KMS key  
È possibile utilizzare `CmkSecretConfig` (con`SecretKey`) o `CustomSecretConfig` (senza`SecretKey`) per fornire le credenziali per una richiesta. `CreateLocationObjectStorage` Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CustomSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui la chiave segreta per una posizione di archiviazione degli oggetti specifica è archiviata in testo semplice, in Secrets Manager. Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto. Per ulteriori informazioni, consulta [Usare un segreto che gestisci tu](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puoi utilizzare `CmkSecretConfig` (con`SecretKey`) o `CustomSecretConfig` (senza`SecretKey`) per fornire le credenziali per una `CreateLocationObjectStorage` richiesta. Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-SecretKey"></a>
Specifica la chiave segreta (ad esempio, una password) se sono necessarie credenziali per l'autenticazione con il server di storage di oggetti.  
Se fornisci un segreto utilizzando`SecretKey`, ma non fornisci dettagli di configurazione segreti utilizzando `CmkSecretConfig` o`CustomSecretConfig`, DataSync archivia il token utilizzando il segreto di Secrets Manager del tuo AWS account.
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Modello: `^.*$`   
Obbligatorio: no

 ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerCertificate"></a>
Speciifica una catena di certificati DataSync per l'autenticazione con il sistema di archiviazione degli oggetti se il sistema utilizza un'autorità di certificazione (CA) privata o autofirmata. È necessario specificare un singolo `.pem` file con una catena di certificati completa (ad esempio,). `file:///home/user/.ssh/object_storage_certificates.pem`  
La catena di certificati potrebbe includere:  
+ Il certificato del sistema di archiviazione degli oggetti
+ Tutti i certificati intermedi (se presenti)
+ Il certificato principale della CA firmataria
È possibile concatenare i certificati in un `.pem` file (che può contenere fino a 32768 byte prima della codifica in base64). Il `cat` comando di esempio seguente crea un file che include tre certificati: `object_storage_certificates.pem`  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
Per utilizzare questo parametro, `ServerProtocol` configurare su`HTTPS`.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 32768.  
Obbligatorio: no

 ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerHostname"></a>
Speciifica il nome di dominio o l'indirizzo IP (IPv4 o IPv6) del server di archiviazione degli oggetti a cui si connette DataSync l'agente.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 255.  
Modello: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obbligatorio: sì

 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerPort"></a>
Specifica la porta su cui il server di storage di oggetti accetta il traffico di rete in ingresso (ad esempio la porta 443).  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 65536.  
Obbligatorio: no

 ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerProtocol"></a>
Specifica il protocollo utilizzato dal server di storage di oggetti per comunicare. Se non specificato, il valore predefinito è `HTTPS`.  
Tipo: String  
Valori validi: `HTTPS | HTTP`   
Campo obbligatorio: no

 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Subdirectory"></a>
Specifica il prefisso dell'oggetto per il server di storage di oggetti. Se si tratta di una posizione di origine, copia DataSync solo gli oggetti con questo prefisso. Se si tratta di una posizione di destinazione, DataSync scrive tutti gli oggetti con questo prefisso.   
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Tags"></a>
Specifica la coppia chiave-valore che rappresenta un tag che si desidera aggiungere alla risorsa. I tag ti aiutano a gestire, filtrare e cercare le risorse. È consigliabile creare un tag di nome per la posizione.  
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
<a name="API_CreateLocationObjectStorage_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateLocationObjectStorage_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-CreateLocationObjectStorage-response-LocationArn"></a>
Speciifica l'ARN della posizione del sistema di storage degli oggetti che si crea.  
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
<a name="API_CreateLocationObjectStorage_Errors"></a>

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
<a name="API_CreateLocationObjectStorage_SeeAlso"></a>

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/CreateLocationObjectStorage) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage)