CreateLocationObjectStorage - AWS DataSync
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi 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à.

CreateLocationObjectStorage

Crea una posizione di trasferimento per un sistema di storage di oggetti. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati. È possibile effettuare trasferimenti con o senza un DataSyncagente.

Prima di iniziare, assicurati di aver compreso i prerequisiti per lavorare con i sistemi di storage DataSync a oggetti.

Sintassi della richiesta

{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "BucketName": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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.

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

Modello: ^.*$

Obbligatorio: no

AgentArns

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

Nota

Assicurati di configurare correttamente questo parametro quando crei per la prima volta la tua posizione di archiviazione. Non è possibile aggiungere o rimuovere agenti da una posizione di archiviazione dopo averla creata.

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

BucketName

Specifica il nome del bucket di storage di oggetti coinvolto nel trasferimento.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 63 caratteri.

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

Obbligatorio: sì

CmkSecretConfig

Specifica le informazioni di configurazione per un segreto DataSync gestito, che include il SecretKey segreto DataSync utilizzato per accedere a una posizione di archiviazione degli oggetti specifica, con un segreto gestito dal cliente. AWS KMS key

Quando includi questo parametro come parte di una CreateLocationObjectStorage richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme al valore specificato per il SecretKey parametro per creare un segreto DataSync gestito per archiviare le credenziali di accesso alla posizione.

Assicurati di disporre DataSync dell'autorizzazione per accedere alla chiave KMS specificata.

Nota

Puoi utilizzare CmkSecretConfig (conSecretKey) o CustomSecretConfig (senzaSecretKey) per fornire le credenziali per una CreateLocationObjectStorage richiesta. Non fornire entrambi i parametri per la stessa richiesta.

Tipo: oggetto CmkSecretConfig

Obbligatorio: no

CustomSecretConfig

Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui la chiave segreta per una posizione di archiviazione degli oggetti specifica è archiviata in testo semplice, in Secrets Manager. Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto.

Nota

È possibile utilizzare CmkSecretConfig (conSecretKey) o CustomSecretConfig (senzaSecretKey) per fornire le credenziali per una richiesta. CreateLocationObjectStorage Non fornire entrambi i parametri per la stessa richiesta.

Tipo: oggetto CustomSecretConfig

Obbligatorio: no

SecretKey

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

Nota

Se fornisci un segreto utilizzandoSecretKey, ma non fornisci dettagli di configurazione segreti utilizzando CmkSecretConfig oCustomSecretConfig, 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

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

Tipo: oggetto dati binari con codifica Base64

Vincoli di lunghezza: lunghezza massima di 32768.

Obbligatorio: no

ServerHostname

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: sì

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: numero intero

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

Obbligatorio: no

ServerProtocol

Specifica il protocollo utilizzato dal server di storage di oggetti per comunicare. Se non specificato, il valore predefinito è HTTPS.

Tipo: String

Valori validi: HTTPS | HTTP

Campo obbligatorio: no

Subdirectory

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

Tags

Specifica la coppia chiave-valore che rappresenta un tag che si desidera aggiungere alla risorsa. I tag ti aiutano a gestire, filtrare e cercare le risorse. È consigliabile creare un tag di nome per la posizione.

Tipo: matrice di oggetti TagListEntry

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.

Obbligatorio: no

Sintassi della risposta

{
   "LocationArn": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

LocationArn

Specifica l'ARN della posizione del sistema di storage degli oggetti che si crea.

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}$

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: