

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
<a name="API_CreateLocationAzureBlob"></a>

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](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) 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](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) tipi di blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access).](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types)

## Sintassi della richiesta
<a name="API_CreateLocationAzureBlob_RequestSyntax"></a>

```
{
   "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
<a name="API_CreateLocationAzureBlob_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AccessTier"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers).  
Tipo: String  
Valori validi: `HOT | COOL | ARCHIVE`   
Campo obbligatorio: no

 ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AgentArns"></a>
(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](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html).  
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

 ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AuthenticationType"></a>
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: String  
Valori validi: `SAS | NONE`   
Obbligatorio: sì

 ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-BlobType"></a>
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.](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs)  
Tipo: String  
Valori validi: `BLOCK`   
Campo obbligatorio: no

 ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-CmkSecretConfig"></a>
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` archiviare le credenziali di accesso alla posizione.  
Assicurati di disporre DataSync dell'autorizzazione per accedere alla chiave KMS specificata. Per ulteriori informazioni, consulta [Utilizzo di un segreto gestito dal servizio crittografato con](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) un codice personalizzato. AWS KMS key  
È possibile utilizzare `CmkSecretConfig` (con`SasConfiguration`) o `CustomSecretConfig` (senza`SasConfiguration`) per fornire le credenziali per una richiesta. `CreateLocationAzureBlob` Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-ContainerUrl"></a>
Speciifica l'URL del contenitore Azure Blob Storage coinvolto nel trasferimento.  
Tipo: String  
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}$`   
Obbligatorio: sì

 ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-CustomSecretConfig"></a>
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, in Secrets Manager. Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto. Per ulteriori informazioni, consulta [Usare un segreto che gestisci tu](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puoi utilizzare `CmkSecretConfig` (con`SasConfiguration`) o `CustomSecretConfig` (senza`SasConfiguration`) per fornire le credenziali per una `CreateLocationAzureBlob` richiesta. Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-SasConfiguration"></a>
Speciifica la configurazione SAS che consente di accedere DataSync al tuo Azure Blob Storage.  
Se fornisci un token di autenticazione utilizzando`SasConfiguration`, ma non fornisci dettagli di configurazione segreti utilizzando `CmkSecretConfig` o`CustomSecretConfig`, DataSync archivia il token utilizzando il segreto del gestore dei segreti del tuo AWS account.
Tipo: oggetto [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)  
Obbligatorio: no

 ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Subdirectory"></a>
Specificate i segmenti di percorso se desiderate limitare il trasferimento a una directory virtuale del contenitore (ad esempio,`/my/images`).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 1024.  
Modello: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Tags"></a>
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](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateLocationAzureBlob_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateLocationAzureBlob_ResponseElements"></a>

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

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

 ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-CreateLocationAzureBlob-response-LocationArn"></a>
L'ARN della posizione di trasferimento di Azure Blob Storage che hai creato.  
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
<a name="API_CreateLocationAzureBlob_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** 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
<a name="API_CreateLocationAzureBlob_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob) 