UpdateLocationObjectStorage - AWS DataSync
Sintassi della richiestaParametri della richiestaElementi di rispostaErroriVedi anche

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

Aggiorna alcuni parametri di una posizione di archiviazione degli oggetti esistente a cui AWS DataSync si accede per un trasferimento. Per informazioni sulla creazione di una posizione di archiviazione degli oggetti autogestita, vedere Creazione di una posizione per l'archiviazione degli oggetti.

Sintassi della richiesta

{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "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.

AccessKey

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 1. Lunghezza massima di 200.

Modello: ^.+$

Required: No

AgentArns

Specifica i nomi della risorsa Amazon (ARN) degli DataSync agenti che possono connettersi in modo sicuro con la tua posizione.

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

LocationArn

Specifica l'ARN della posizione del sistema di storage a oggetti 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ì

SecretKey

Specifica la chiave segreta (ad esempio, una password) se sono necessarie credenziali per l'autenticazione con il server di storage di oggetti.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.

Modello: ^.+$

Required: No

ServerCertificate

Specifica un certificato da autenticare con un sistema di storage a oggetti che utilizza un'autorità di certificazione (CA) privata o autofirmata. Devi specificare un .pem file con codifica Base64 (ad esempio). file:///home/user/.ssh/storage_sys_certificate.pem Il certificato può contenere fino a 32768 byte (prima della codifica Base64).

Per utilizzare questo parametro, ServerProtocol configurare suHTTPS.

L'aggiornamento del certificato non interferisce con le attività in corso.

Tipo: oggetto dati binari con codifica Base64

Limitazioni di lunghezza: lunghezza massima di 32768.

Required: No

ServerPort

Specifica la porta su cui il server di storage di oggetti accetta il traffico di rete in ingresso (ad esempio la porta 443).

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 65536.

Required: No

ServerProtocol

Specifica il protocollo utilizzato dal server di storage di oggetti per comunicare.

Tipo: String

Valori validi: HTTPS | HTTP

Required: No

Subdirectory

Specifica il prefisso dell'oggetto per il server di storage di oggetti. Se questa è una posizione di origine, copia DataSync solo gli oggetti con questo prefisso. Se questa è una posizione di destinazione, DataSync scrive tutti gli oggetti con questo prefisso.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 4096.

Modello: ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

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 nel AWS 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: