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
Aggiorna alcuni dei parametri di una posizione precedentemente creata per l'accesso al file system Server Message Block (SMB). Per informazioni sulla creazione di una sede SMB, vedere Creazione di una sede per SMB.
Sintassi della richiesta
{
"AgentArns": [ "string" ],
"Domain": "string",
"LocationArn": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"Subdirectory": "string",
"User": "string"
}Parametri della richiesta
Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- AgentArns
-
Gli Amazon Resource Name (ARN) degli agenti da utilizzare per una posizione SMB (Simple Message Block).
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 elementi.
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}$Required: No
- Domain
-
Il nome del dominio Windows a cui appartiene il server SMB.
Tipo: String
Vincoli di lunghezza: lunghezza massima di 253.
Modello:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Required: No
- LocationArn
-
L'Amazon Resource Name (ARN) della sede SMB da aggiornare.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^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
-
Specifica la versione del protocollo SMB (Server Message Block) utilizzata da AWS DataSync per accedere a un server di file SMB.
Tipo: SmbMountOptions oggetto
Required: No
- Password
-
La password dell'utente che può montare la condivisione e che dispone delle autorizzazioni per accedere a file e cartelle nella condivisione SMB.
Tipo: String
Vincoli di lunghezza: lunghezza massima di 104.
Modello:
^.{0,104}$Required: No
- Subdirectory
-
La sottodirectory del file system SMB utilizzata per leggere i dati dalla posizione di origine SMB o scrivere dati nella destinazione SMB. Il percorso SMB deve essere un percorso esportato dal server SMB o una sottodirectory di tale percorso. Questo percorso deve essere tale da poter essere montato da altri client SMB della rete.
Nota
La
Subdirectorydeve essere specificata con una barra. Ad esempio,/path/to/folder.Per trasferire tutti i dati nella cartella specificata, èDataSync necessario disporre delle autorizzazioni per montare la condivisione SMB e per accedere a tutti i dati in tale condivisione. A tale scopo, eseguire una delle seguenti:
-
assicurarsi che l'utente/la password specificati appartengano all'utente che può montare la condivisione e che dispone delle autorizzazioni appropriate per tutti i file e le directory per i quali siDataSync desidera accedere.
-
Usa le credenziali di un membro del gruppo Backup Operators per montare la condivisione.
Una delle due opzioni permettono all'agente di leggere i dati. Affinché l'agente possa accedere alle directory, è necessario inoltre abilitare l'accesso in esecuzione a tutti gli utenti.
Tipo: String
Vincoli di lunghezza: lunghezza massima di 4096.
Modello:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Required: No
-
- User
-
L'utente che può montare la condivisione dispone delle autorizzazioni per accedere a file e cartelle nella condivisione SMB.
Tipo: String
Vincoli di lunghezza: lunghezza massima di 104.
Modello:
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$Required: 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 nelAWS DataSync servizio.
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 uno degli SDK AWS specifici della lingua, consulta quanto segue:
