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.
Sintassi della richiesta
{
"AgentArns": [ "string
" ],
"AuthenticationType": "string
",
"DnsIpAddresses": [ "string
" ],
"Domain": "string
",
"KerberosKeytab": blob
,
"KerberosKrb5Conf": blob
,
"KerberosPrincipal": "string
",
"LocationArn": "string
",
"MountOptions": {
"Version": "string
"
},
"Password": "string
",
"Subdirectory": "string
",
"User": "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
-
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: 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
- AuthenticationType
-
Speciifica il protocollo di autenticazione DataSync utilizzato per connettersi al file server SMB. DataSync supporta
NTLM
(impostazione predefinita) eKERBEROS
autenticazione.Per ulteriori informazioni, vedere Fornire DataSync l'accesso ai file server SMB.
Tipo: stringa
Valori validi:
NTLM | KERBEROS
Campo obbligatorio: no
- DnsIpAddresses
-
Speciifica gli IPv4 indirizzi dei 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: matrice di stringhe
Membri della matrice: numero massimo di 2 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 7. La lunghezza massima è 15 caratteri.
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}\z
Campo obbligatorio: no
- Domain
-
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: stringa
Vincoli di lunghezza: lunghezza massima di 253.
Modello:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$
Campo obbligatorio: no
- KerberosKeytab
-
Speciifica il file della tabella delle chiavi Kerberos (keytab), che include le mappature tra la chiave principale Kerberos e la chiave di crittografia.
Il file deve essere codificato in base 64. Se stai usando il AWS CLI, la codifica è pronta per te.
Per evitare errori di esecuzione delle attività, assicuratevi 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.
Campo obbligatorio: no
- KerberosKrb5Conf
-
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.
Campo obbligatorio: no
- KerberosPrincipal
-
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: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
^.+$
Campo obbligatorio: no
- LocationArn
-
Specificare l'ARN della posizione SMB che si desidera aggiornare.
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}$
Campo obbligatorio: sì
- MountOptions
-
Speciifica la versione del protocollo Server Message Block (SMB) AWS DataSync utilizzata per accedere a un file server SMB.
Tipo: oggetto SmbMountOptions
Campo obbligatorio: no
- Password
-
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: stringa
Vincoli di lunghezza: lunghezza massima di 104.
Modello:
^.{0,104}$
Campo obbligatorio: no
- Subdirectory
-
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.
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 4096.
Modello:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$
Campo obbligatorio: no
- User
-
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.
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 104.
Modello:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
Campo 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 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
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: