CreateLocationAzureBlob - 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à.

CreateLocationAzureBlob

Crea una posizione di trasferimento per un contenitore Microsoft Azure Blob Storage. AWS DataSync può usare questa posizione come origine o destinazione di trasferimento. Puoi effettuare trasferimenti con o senza un DataSync agente che si connetta al tuo contenitore.

Prima di iniziare, assicurati di sapere come DataSync accede all'archiviazione BLOB di Azure e come funziona con i livelli di accesso e i tipi di blob.

Sintassi della richiesta

{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "ContainerUrl": "string",
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SasConfiguration": { 
      "Token": "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.

AccessTier

Speciifica il livello di accesso in cui desideri trasferire gli oggetti o i file. Ciò si applica solo quando si utilizza la posizione come destinazione di trasferimento. Per ulteriori informazioni, consulta Livelli di accesso.

Tipo: stringa

Valori validi: HOT | COOL | ARCHIVE

Campo obbligatorio: no

AgentArns

(Facoltativo) Specifica l'Amazon Resource Name (ARN) dell'agente che può connettersi DataSync al tuo contenitore Azure Blob Storage. Se stai configurando un trasferimento tra cloud senza agenti, non è necessario specificare un valore per questo parametro.

È possibile specificare più di un agente. Per ulteriori informazioni, consulta Utilizzo di più agenti per il trasferimento.

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

Campo obbligatorio: no

AuthenticationType

Specifica il metodo di autenticazione DataSync usato per accedere al tuo archivio BLOB di Azure. DataSync può accedere all'archiviazione BLOB utilizzando una firma ad accesso condiviso (SAS).

Tipo: stringa

Valori validi: SAS | NONE

Campo obbligatorio: sì

BlobType

Speciifica il tipo di blob che vuoi che siano i tuoi oggetti o file quando li trasferisci in Azure Blob Storage. Attualmente, supporta DataSync solo lo spostamento di dati in Azure Blob Storage come block blob. Per altre informazioni sui tipi di blob, consulta la documentazione di Azure Blob Storage.

Tipo: stringa

Valori validi: BLOCK

Campo obbligatorio: no

CmkSecretConfig

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

Quando includi questo parametro come parte di una CreateLocationAzureBlob richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme al token di autenticazione specificato per creare un segreto DataSync gestito per SasConfiguration memorizzare le credenziali di accesso alla posizione.

Assicurati che DataSync abbia il permesso di accedere alla chiave KMS specificata.

Nota

Puoi utilizzare CmkSecretConfig (conSasConfiguration) o CustomSecretConfig (senzaSasConfiguration) per fornire le credenziali per una CreateLocationAzureBlob richiesta. Non fornire entrambi i parametri per la stessa richiesta.

Tipo: oggetto CmkSecretConfig

Campo obbligatorio: no

ContainerUrl

Speciifica l'URL del contenitore Azure Blob Storage coinvolto nel trasferimento.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 325.

Modello: ^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$

Campo obbligatorio: sì

CustomSecretConfig

Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui il token di autenticazione per una posizione di AzureBlob archiviazione è archiviato in testo semplice. Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto.

Nota

È possibile utilizzare CmkSecretConfig (conSasConfiguration) o CustomSecretConfig (senzaSasConfiguration) per fornire le credenziali per una richiesta. CreateLocationAzureBlob Non fornire entrambi i parametri per la stessa richiesta.

Tipo: oggetto CustomSecretConfig

Campo obbligatorio: no

SasConfiguration

Speciifica la configurazione SAS che consente di accedere DataSync al tuo Azure Blob Storage.

Nota

Se fornisci un token di autenticazione utilizzandoSasConfiguration, ma non fornisci dettagli di configurazione segreti utilizzando CmkSecretConfig oCustomSecretConfig, DataSync archivia il token utilizzando il segreto del gestore dei segreti del tuo AWS account.

Tipo: oggetto AzureBlobSasConfiguration

Campo obbligatorio: no

Subdirectory

Specificate i segmenti di percorso se desiderate limitare il trasferimento a una directory virtuale del contenitore (ad esempio,/my/images).

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 1024.

Modello: ^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$

Campo obbligatorio: no

Tags

Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS . Ti consigliamo di creare almeno un tag con il nome per la località di trasferimento.

Tipo: matrice di oggetti TagListEntry

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

Campo 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

L'ARN della posizione di trasferimento di Azure Blob Storage che hai creato.

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

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: