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 un endpoint per un sistema di storage a oggetti a cui AWS DataSync può accedere per un trasferimento. Per ulteriori informazioni, vedere Creazione di una posizione per l'archiviazione degli oggetti.

Sintassi della richiesta

{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "BucketName": "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 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.

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

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.

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

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 file con i certificati utilizzati per firmare il certificato del server di storage di oggetti (ad esempio,file:///home/user/.ssh/storage_sys_certificate.pem). Il file specificato deve includere i seguenti parametri:

  • Il certificato dell'autorità di certificazione (CA)

  • Eventuali certificati intermedi

  • codifica base64

  • Un'.pemestensione

Il file può contenere fino a 32768 byte (prima della codifica base64).

Per utilizzare questo parametro, ServerProtocol configurare suHTTPS.

Tipo: oggetto dati binari con codifica Base64

Limitazioni azioni di lunghezza: lunghezza massima di 32768.

Required: No

ServerHostname

Specifica il indirizzo IP o il nome di dominio del server di storage di oggetti. Un DataSync agente utilizza questo nome host per montare il server di storage di oggetti in una rete.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 255.

Pattern: ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

Campo 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: 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 azioni di lunghezza: lunghezza massima di 4096.

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

Required: 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.

Required: 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 a oggetti che si crea.

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

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: