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

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento dell'archiviazione degli oggetti con AWS DataSync cui si sta utilizzando.

Per ulteriori informazioni, vedere [Configurazione dei DataSync trasferimenti con un sistema di storage di oggetti](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

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

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

## Parametri della richiesta
<a name="API_UpdateLocationObjectStorage_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_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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.  
Non è possibile aggiungere o rimuovere agenti da una posizione di archiviazione dopo averla creata inizialmente.
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

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
Specifica l'ARN della posizione del sistema di storage degli oggetti che si sta aggiornando.  
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}$`   
Obbligatorio: sì

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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`.  
L'aggiornamento di questo parametro non interferisce con le attività in corso.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 32768.  
Obbligatorio: no

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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: no

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Specifica il protocollo utilizzato dal server di storage di oggetti per comunicare.  
Tipo: String  
Valori validi: `HTTPS | HTTP`   
Campo obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-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

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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