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à. # UpdateLocationSmb Modifica i seguenti parametri di configurazione della posizione di trasferimento Server Message Block (SMB) con cui stai utilizzando. AWS DataSync Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti con un file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html). ## Sintassi della richiesta ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "LocationArn": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "User": "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_UpdateLocationSmb_RequestSyntax) ** Speciifica l' DataSync agente (o gli agenti) che possono connettersi al file server SMB. Specifichi un agente utilizzando il relativo Amazon Resource Name (ARN). 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 ** [AuthenticationType](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica il protocollo di autenticazione DataSync utilizzato per connettersi al file server SMB. DataSync supporta `NTLM` (impostazione predefinita) e `KERBEROS` autenticazione. Per ulteriori informazioni, vedere [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipo: String Valori validi: `NTLM | KERBEROS` Campo obbligatorio: no ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` or `KerberosKeytab` 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_UpdateLocationSmb_RequestSyntax) ** Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `Password` or `KerberosKeytab` 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 ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica gli indirizzi IP (IPv4 o IPv6) per i server DNS a cui appartiene il file server SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su. `KERBEROS` Se nell'ambiente sono presenti più domini, la configurazione di questo parametro assicura la DataSync connessione al file server SMB corretto. Tipo: array di stringhe Membri della matrice: numero massimo di 2 elementi. Limitazioni di lunghezza: lunghezza minima pari a 7. Lunghezza massima di 39. Modello: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` Obbligatorio: no ** [Domain](#API_UpdateLocationSmb_RequestSyntax) ** Specifica il nome dominio di Windows a cui appartiene il server di file SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su`NTLM`. Se nell'ambiente sono presenti più domini, la configurazione di questo parametro assicura la DataSync connessione al file server corretto. Tipo: String Vincoli di lunghezza: lunghezza massima di 253. Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Obbligatorio: no ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica il file della tabella delle chiavi Kerberos (keytab), che include le mappature tra la chiave principale Kerberos e la chiave di crittografia. Per evitare errori di esecuzione delle attività, assicurati che il principale Kerberos utilizzato per creare il file keytab corrisponda esattamente a quello specificato. `KerberosPrincipal` Tipo: oggetto dati binari con codifica Base64 Vincoli di lunghezza: lunghezza massima di 65536. Obbligatorio: no ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) ** Specifica un file di configurazione Kerberos (`krb5.conf`) che definisce la configurazione del realm Kerberos. Il file deve essere codificato in base 64. Se stai usando il AWS CLI, la codifica è pronta per te. Tipo: oggetto dati binari con codifica Base64 Vincoli di lunghezza: lunghezza massima di 131072. Obbligatorio: no ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica un principale Kerberos, che è un'identità nell'area di autenticazione Kerberos autorizzata ad accedere a file, cartelle e metadati dei file nel file server SMB. Potrebbe essere simile `HOST/kerberosuser@MYDOMAIN.ORG` a un principale Kerberos. I nomi principali distinguono tra maiuscole e minuscole. L'esecuzione dell' DataSync attività avrà esito negativo se il principale specificato per questo parametro non corrisponde esattamente al principale utilizzato per creare il file keytab. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Modello: `^.+$` Obbligatorio: no ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) ** Specificare l'ARN della posizione SMB che si desidera aggiornare. 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ì ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica la versione del protocollo Server Message Block (SMB) AWS DataSync utilizzata per accedere a un file server SMB. Tipo: oggetto [SmbMountOptions](API_SmbMountOptions.md) Obbligatorio: no ** [Password](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica la password dell'utente che può montare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento. Questo parametro si applica solo se `AuthenticationType` è impostato su. `NTLM` Tipo: String Vincoli di lunghezza: lunghezza massima di 104. Modello: `^.{0,104}$` Obbligatorio: no ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica il nome di dominio o l'indirizzo IP (IPv4 o IPv6) del file server SMB a cui l'agente si connette DataSync . Se utilizzi l'autenticazione Kerberos, devi specificare un nome di dominio. 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 ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica il nome della condivisione esportata dal file server SMB in cui leggerà o DataSync scriverà i dati. È possibile includere una sottodirectory nel percorso di condivisione (ad esempio,). `/path/to/subdirectory` Assicurati che anche altri client SMB della tua rete possano montare questo percorso. Per copiare tutti i dati nella sottodirectory specificata, DataSync deve essere in grado di montare la condivisione SMB e accedere a tutti i relativi dati. Per ulteriori informazioni, vedere [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipo: String Vincoli di lunghezza: lunghezza massima di 4096. Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` Obbligatorio: no ** [User](#API_UpdateLocationSmb_RequestSyntax) ** Speciifica il nome utente che può montare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento. Questo parametro si applica solo se `AuthenticationType` è impostato su. `NTLM` Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipo: String Vincoli di lunghezza: lunghezza massima di 104. Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Obbligatorio: no ## Elementi di risposta Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto. ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore 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/UpdateLocationSmb) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb)