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

# AWS DataSync API
<a name="API_Reference"></a>

Oltre a Console di gestione AWS and AWS CLI, puoi utilizzare l' AWS DataSync API per configurare e gestire DataSync con [AWS SDKs](https://aws.amazon.com/developer/tools/).

**Topics**
+ [

# Azioni
](API_Operations.md)
+ [

# Tipi di dati
](API_Types.md)
+ [

# Errori comuni
](CommonErrors.md)
+ [

# Parametri comuni
](CommonParameters.md)

# Azioni
<a name="API_Operations"></a>

Sono supportate le operazioni seguenti:
+  [CancelTaskExecution](API_CancelTaskExecution.md) 
+  [CreateAgent](API_CreateAgent.md) 
+  [CreateLocationAzureBlob](API_CreateLocationAzureBlob.md) 
+  [CreateLocationEfs](API_CreateLocationEfs.md) 
+  [CreateLocationFsxLustre](API_CreateLocationFsxLustre.md) 
+  [CreateLocationFsxOntap](API_CreateLocationFsxOntap.md) 
+  [CreateLocationFsxOpenZfs](API_CreateLocationFsxOpenZfs.md) 
+  [CreateLocationFsxWindows](API_CreateLocationFsxWindows.md) 
+  [CreateLocationHdfs](API_CreateLocationHdfs.md) 
+  [CreateLocationNfs](API_CreateLocationNfs.md) 
+  [CreateLocationObjectStorage](API_CreateLocationObjectStorage.md) 
+  [CreateLocationS3](API_CreateLocationS3.md) 
+  [CreateLocationSmb](API_CreateLocationSmb.md) 
+  [CreateTask](API_CreateTask.md) 
+  [DeleteAgent](API_DeleteAgent.md) 
+  [DeleteLocation](API_DeleteLocation.md) 
+  [DeleteTask](API_DeleteTask.md) 
+  [DescribeAgent](API_DescribeAgent.md) 
+  [DescribeLocationAzureBlob](API_DescribeLocationAzureBlob.md) 
+  [DescribeLocationEfs](API_DescribeLocationEfs.md) 
+  [DescribeLocationFsxLustre](API_DescribeLocationFsxLustre.md) 
+  [DescribeLocationFsxOntap](API_DescribeLocationFsxOntap.md) 
+  [DescribeLocationFsxOpenZfs](API_DescribeLocationFsxOpenZfs.md) 
+  [DescribeLocationFsxWindows](API_DescribeLocationFsxWindows.md) 
+  [DescribeLocationHdfs](API_DescribeLocationHdfs.md) 
+  [DescribeLocationNfs](API_DescribeLocationNfs.md) 
+  [DescribeLocationObjectStorage](API_DescribeLocationObjectStorage.md) 
+  [DescribeLocationS3](API_DescribeLocationS3.md) 
+  [DescribeLocationSmb](API_DescribeLocationSmb.md) 
+  [DescribeTask](API_DescribeTask.md) 
+  [DescribeTaskExecution](API_DescribeTaskExecution.md) 
+  [ListAgents](API_ListAgents.md) 
+  [ListLocations](API_ListLocations.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ListTaskExecutions](API_ListTaskExecutions.md) 
+  [ListTasks](API_ListTasks.md) 
+  [StartTaskExecution](API_StartTaskExecution.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateAgent](API_UpdateAgent.md) 
+  [UpdateLocationAzureBlob](API_UpdateLocationAzureBlob.md) 
+  [UpdateLocationEfs](API_UpdateLocationEfs.md) 
+  [UpdateLocationFsxLustre](API_UpdateLocationFsxLustre.md) 
+  [UpdateLocationFsxOntap](API_UpdateLocationFsxOntap.md) 
+  [UpdateLocationFsxOpenZfs](API_UpdateLocationFsxOpenZfs.md) 
+  [UpdateLocationFsxWindows](API_UpdateLocationFsxWindows.md) 
+  [UpdateLocationHdfs](API_UpdateLocationHdfs.md) 
+  [UpdateLocationNfs](API_UpdateLocationNfs.md) 
+  [UpdateLocationObjectStorage](API_UpdateLocationObjectStorage.md) 
+  [UpdateLocationS3](API_UpdateLocationS3.md) 
+  [UpdateLocationSmb](API_UpdateLocationSmb.md) 
+  [UpdateTask](API_UpdateTask.md) 
+  [UpdateTaskExecution](API_UpdateTaskExecution.md) 

# CancelTaskExecution
<a name="API_CancelTaskExecution"></a>

Interrompe l'esecuzione di un' AWS DataSync attività in corso. Il trasferimento di alcuni file viene interrotto bruscamente. I contenuti dei file trasferiti nella destinazione potrebbero essere incompleti o non coerenti con i file di origine.

Tuttavia, se iniziate l'esecuzione di una nuova attività utilizzando la stessa operazione e ne consentite il completamento, il contenuto del file nella destinazione sarà completo e coerente. Questo vale per altri errori imprevisti che interrompono l'esecuzione di un'attività. In tutti questi casi, il trasferimento viene completato DataSync correttamente all'avvio dell'esecuzione successiva dell'attività.

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

```
{
   "TaskExecutionArn": "string"
}
```

## Parametri della richiesta
<a name="API_CancelTaskExecution_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.

 ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) **   <a name="DataSync-CancelTaskExecution-request-TaskExecutionArn"></a>
L'Amazon Resource Name (ARN) dell'esecuzione dell'attività da interrompere.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_CancelTaskExecution_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 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
<a name="API_CancelTaskExecution_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/CancelTaskExecution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) 

# CreateAgent
<a name="API_CreateAgent"></a>

Attiva un AWS DataSync agente da distribuire nel tuo ambiente di storage. Il processo di attivazione associa l'agente al tuo. Account AWS

Se non hai ancora implementato un agente, vedi [Ho bisogno di un DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) agente? 

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

```
{
   "ActivationKey": "string",
   "AgentName": "string",
   "SecurityGroupArns": [ "string" ],
   "SubnetArns": [ "string" ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VpcEndpointId": "string"
}
```

## Parametri della richiesta
<a name="API_CreateAgent_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.

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
Specifica la chiave di attivazione del tuo DataSync agente. Se non disponi di una chiave di attivazione, vedi [Attivazione del tuo agente](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Tipo: String  
Limiti di lunghezza: lunghezza massima di 29.  
Modello: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
Obbligatorio: sì

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
Specificate un nome per il vostro agente. Ti consigliamo di specificare un nome facile da ricordare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obbligatorio: no

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
Speciifica l'Amazon Resource Name (ARN) del gruppo di sicurezza che consente il traffico tra l'agente e l'endpoint del servizio VPC. È possibile specificare un solo ARN.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 1 elemento.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: no

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
Speciifica l'ARN della sottorete in cui si trova l'endpoint del servizio VPC. È possibile specificare un solo ARN.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 1 elemento.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
Obbligatorio: no

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse. AWS Ti consigliamo di creare almeno un tag per il tuo agente.  
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
Speciifica l'ID dell'endpoint del [servizio VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) che stai utilizzando. Ad esempio, ha il seguente aspetto: un ID endpoint VPC. `vpce-01234d5aff67890e1`  
L'endpoint del servizio VPC utilizzato deve includere il nome del DataSync servizio (ad esempio,). `com.amazonaws.us-east-2.datasync`
Tipo: stringa  
Modello: `^vpce-[0-9a-f]{17}$`   
Obbligatorio: no

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

```
{
   "AgentArn": "string"
}
```

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

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

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

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
L'ARN dell'agente che hai appena attivato. Utilizzate l'[ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operazione per restituire un elenco di agenti nel vostro Account AWS and Regione AWS.  
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}:agent/agent-[0-9a-z]{17}$` 

## Errori
<a name="API_CreateAgent_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 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

## Esempi
<a name="API_CreateAgent_Examples"></a>

### Richiesta di esempio
<a name="API_CreateAgent_Example_1"></a>

L'esempio seguente attiva un agente. DataSync 

```
{
    "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE",
    "AgentName": "MyAgent",
    "Tags": [{
        "Key": "Job",
        "Value": "TransferJob-1"
    }]
}
```

### Risposta di esempio
<a name="API_CreateAgent_Example_2"></a>

La risposta restituisce l'ARN dell'agente attivato.

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3"
}
```

## Vedi anche
<a name="API_CreateAgent_SeeAlso"></a>

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

# 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) 

# CreateLocationEfs
<a name="API_CreateLocationEfs"></a>

Crea una *posizione* di trasferimento per un file system Amazon EFS. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync [accede ai file system Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access).

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

```
{
   "AccessPointArn": "string",
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "EfsFilesystemArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationEfs_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.

 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-AccessPointArn"></a>
Speciifica l'Amazon Resource Name (ARN) del punto di accesso utilizzato per DataSync montare il file system Amazon EFS.  
Per ulteriori informazioni, consulta [Accesso ai file system con restrizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$`   
Obbligatorio: no

 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Ec2Config"></a>
Speciifica la sottorete e i gruppi di sicurezza DataSync utilizzati per connettersi a uno degli obiettivi di [montaggio](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del file system Amazon EFS.  
Tipo: oggetto [Ec2Config](API_Ec2Config.md)  
Obbligatorio: sì

 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-EfsFilesystemArn"></a>
Speciifica l'ARN per il tuo file system Amazon EFS.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$`   
Obbligatorio: sì

 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-FileSystemAccessRoleArn"></a>
Specifica un ruolo AWS Identity and Access Management (IAM) che consente di accedere DataSync al file system Amazon EFS.  
Per informazioni sulla creazione di questo ruolo, consulta [Creazione di un ruolo DataSync IAM per l'accesso al file system](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obbligatorio: no

 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-InTransitEncryption"></a>
Specifica se desideri DataSync utilizzare la crittografia Transport Layer Security (TLS) 1.2 quando trasferisce dati da o verso il tuo file system Amazon EFS.  
Se specifichi un punto di accesso utilizzando `AccessPointArn` o un ruolo IAM utilizzando `FileSystemAccessRoleArn`, è necessario impostare questo parametro su `TLS1_2`.  
Tipo: String  
Valori validi: `NONE | TLS1_2`   
Campo obbligatorio: no

 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Subdirectory"></a>
Specifica un percorso di montaggio per il tuo file system Amazon EFS. È qui che DataSync legge o scrive i dati sul tuo file system (a seconda che si tratti di una posizione di origine o di destinazione).  
Per impostazione predefinita, DataSync utilizza la directory principale (o il [punto di accesso](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html), se fornito utilizzando`AccessPointArn`). È inoltre possibile includere sottodirectory utilizzando barre (ad esempio,). `/path/to/folder`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Tags"></a>
Specifica la coppia chiave-valore che rappresenta un tag che si desidera aggiungere alla risorsa. Il valore può essere una stringa vuota. Questo valore consente di gestire, filtrare e cercare le risorse. È consigliabile creare un tag di nome per la posizione.  
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_CreateLocationEfs_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationEfs_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_CreateLocationEfs_ResponseSyntax) **   <a name="DataSync-CreateLocationEfs-response-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione del file system Amazon EFS che crei.  
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_CreateLocationEfs_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 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

## Esempi
<a name="API_CreateLocationEfs_Examples"></a>

### Richiesta di esempio
<a name="API_CreateLocationEfs_Example_1"></a>

L'esempio seguente crea una posizione per un file system Amazon EFS.

```
{
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2"
        ]
    },
    "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### Richiesta di esempio: creazione di una posizione per un file system Amazon EFS con restrizioni
<a name="API_CreateLocationEfs_Example_2"></a>

L'esempio seguente crea una posizione per un file system Amazon EFS con accesso limitato. In questo tipo di scenario, potrebbe essere necessario specificare i valori per `AccessPointArn` e `InTransitEncryption` nella richiesta. `FileSystemAccessRoleArn`

```
{
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### Risposta di esempio
<a name="API_CreateLocationEfs_Example_3"></a>

Una risposta restituisce l'ARN della posizione del file system Amazon EFS.

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

## Vedi anche
<a name="API_CreateLocationEfs_SeeAlso"></a>

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

# CreateLocationFsxLustre
<a name="API_CreateLocationFsxLustre"></a>

Crea una *posizione* di trasferimento per un file system Amazon FSx for Lustre. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync [accedere ai file system FSx Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access).

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

```
{
   "FsxFilesystemArn": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationFsxLustre_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.

 ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-FsxFilesystemArn"></a>
Speciifica l'Amazon Resource Name (ARN) FSx del file system for Lustre.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Obbligatorio: sì

 ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-SecurityGroupArns"></a>
Speciifica gli Amazon Resource Names (ARNs) di un massimo di cinque gruppi di sicurezza che forniscono l'accesso al file system FSx for Lustre.  
I gruppi di sicurezza devono essere in grado di accedere alle porte del file system. Il file system deve consentire anche l'accesso dai gruppi di sicurezza. Per informazioni sull'accesso al file system, consulta la [https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html).  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: sì

 ** [Subdirectory](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Subdirectory"></a>
Speciifica un percorso di montaggio per il file system FSx for Lustre. Il percorso può includere sottodirectory.  
Quando la posizione viene utilizzata come fonte, DataSync legge i dati dal percorso di montaggio. Quando la posizione viene utilizzata come destinazione, DataSync scrive i dati nel percorso di montaggio. Se non includete questo parametro, DataSync utilizza la directory principale del file system (`/`).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS . È consigliabile creare almeno un tag di nome per la posizione.  
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_CreateLocationFsxLustre_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationFsxLustre_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_CreateLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxLustre-response-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione del file system FSx for Lustre 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_CreateLocationFsxLustre_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_CreateLocationFsxLustre_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/CreateLocationFsxLustre) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) 

# CreateLocationFsxOntap
<a name="API_CreateLocationFsxOntap"></a>

Crea una *posizione* di trasferimento per un file system Amazon FSx for NetApp ONTAP. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync [accedere ai file system FSx ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

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

```
{
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationFsxOntap_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.

 ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Protocol"></a>
Speciifica il protocollo di trasferimento dati AWS DataSync utilizzato per accedere al tuo FSx file system Amazon.  
Tipo: oggetto [FsxProtocol](API_FsxProtocol.md)  
Obbligatorio: sì

 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-SecurityGroupArns"></a>
Speciifica i gruppi di sicurezza di Amazon EC2 che forniscono l'accesso alla sottorete preferita del file system.  
I gruppi di sicurezza devono consentire il traffico in uscita sulle seguenti porte (a seconda del protocollo utilizzato):  
+  **NFS (Network File System)**: porte TCP 111, 635 e 2049
+  **SMB (Server Message Block)**: porta TCP 445
I gruppi di sicurezza del file system devono inoltre consentire il traffico in entrata sulle stesse porte.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: sì

 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-StorageVirtualMachineArn"></a>
Specifica l'ARN della macchina virtuale di archiviazione (SVM) nel file system in cui o da cui copiare i dati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 162.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$`   
Obbligatorio: sì

 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Subdirectory"></a>
Specificate il percorso della condivisione di file nella SVM da cui desiderate trasferire i dati o da cui desiderate trasferire i dati.  
Puoi specificare un percorso di giunzione (detto anche punto di montaggio), un percorso qtree (per condivisioni di file NFS) o un nome condivisione (per condivisioni di file SMB). Ad esempio, il percorso di montaggio potrebbe essere `/vol1`, `/vol1/tree1`, o `/share1`.  
Non specificare un percorso di giunzione nel volume radice dell'SVM. Per ulteriori informazioni, consulta [Managing FSx for ONTAP Storage Virtual Machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) nella *Amazon FSx for NetApp ONTAP User Guide*.
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 255.  
Modello: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS . È consigliabile creare almeno un tag di nome per la posizione.  
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_CreateLocationFsxOntap_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationFsxOntap_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_CreateLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOntap-response-LocationArn"></a>
Specificate l'ARN della posizione FSx del file system for ONTAP che create.  
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_CreateLocationFsxOntap_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_CreateLocationFsxOntap_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/CreateLocationFsxOntap) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) 

# CreateLocationFsxOpenZfs
<a name="API_CreateLocationFsxOpenZfs"></a>

Crea una *posizione* di trasferimento per un file system Amazon FSx for OpenZFS. AWS DataSync può utilizzare questa posizione come fonte o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync [accedere ai file system FSx OpenZFS.](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access)

**Nota**  
I parametri di richiesta relativi a `SMB` non sono supportati dall'operazione. `CreateLocationFsxOpenZfs`

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

```
{
   "FsxFilesystemArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationFsxOpenZfs_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.

 ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-FsxFilesystemArn"></a>
L'Amazon Resource Name (ARN) del file system FSx per OpenZFS.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Obbligatorio: sì

 ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Protocol"></a>
Il tipo di protocollo AWS DataSync utilizzato per accedere al file system.  
Tipo: oggetto [FsxProtocol](API_FsxProtocol.md)  
Obbligatorio: sì

 ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-SecurityGroupArns"></a>
I gruppi ARNs di sicurezza utilizzati per configurare il file system FSx per OpenZFS.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: sì

 ** [Subdirectory](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Subdirectory"></a>
Una sottodirectory nel percorso della posizione che deve iniziare con. `/fsx` DataSync utilizza questa sottodirectory per leggere o scrivere dati (a seconda che il file system sia una posizione di origine o di destinazione).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Tags"></a>
La coppia chiave-valore che rappresenta un tag che si desidera aggiungere alla risorsa. Il valore può essere una stringa vuota. Questo valore consente di gestire, filtrare e cercare le risorse. È consigliabile creare un tag di nome per la posizione.  
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_CreateLocationFsxOpenZfs_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationFsxOpenZfs_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_CreateLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-response-LocationArn"></a>
L'ARN della posizione del FSx file system OpenZFS 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_CreateLocationFsxOpenZfs_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_CreateLocationFsxOpenZfs_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/CreateLocationFsxOpenZfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 

# CreateLocationFsxWindows
<a name="API_CreateLocationFsxWindows"></a>

Crea una *posizione* di trasferimento per un file system Amazon FSx for Windows File Server. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicuratevi di conoscere DataSync [le modalità di accesso ai file system FSx di Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access).

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

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "FsxFilesystemArn": "string",
   "Password": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

## Parametri della richiesta
<a name="API_CreateLocationFsxWindows_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.

 ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, che include la password da DataSync utilizzare per accedere a una specifica posizione di archiviazione di FSx Windows, con una password gestita dal cliente. AWS KMS key  
Quando includi questo parametro come parte di una `CreateLocationFsxWindows` richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme a quella `Password` specificata 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. 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`Password`) o `CustomSecretConfig` (senza`Password`) per fornire le credenziali per una richiesta. `CreateLocationFsxWindows` Non fornite entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CustomSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui la password per una posizione di archiviazione FSx per Windows File Server è 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. 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`Password`) o `CustomSecretConfig` (senza`Password`) per fornire le credenziali per una `CreateLocationFsxWindows` richiesta. Non fornite entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Domain"></a>
Speciifica il nome del dominio Windows a cui appartiene il file system FSx for Windows File Server.  
Se nell'ambiente sono presenti più domini Active Directory, la configurazione di questo parametro assicura la DataSync connessione al file system corretto.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obbligatorio: no

 ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-FsxFilesystemArn"></a>
Speciifica l'Amazon Resource Name (ARN) per FSx il file system per Windows File Server.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Obbligatorio: sì

 ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Password"></a>
Speciifica la password dell'utente con le autorizzazioni per montare e accedere a file, cartelle e metadati dei file nel file system FSx per Windows File Server.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^.{0,104}$`   
Obbligatorio: no

 ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-SecurityGroupArns"></a>
Speciifica gli ARN dei gruppi di sicurezza Amazon EC2 che forniscono l'accesso alla sottorete preferita del file system.  
I gruppi di sicurezza specificati devono essere in grado di comunicare con i gruppi di sicurezza del file system. Per informazioni sulla configurazione dei gruppi di sicurezza per l'accesso al file system, consulta la [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html).  
Se scegli un gruppo di sicurezza che non consente connessioni dall'interno, esegui una delle seguenti operazioni:  
+ Configura il gruppo di sicurezza per consentirgli di comunicare al suo interno.
+ Scegli un gruppo di sicurezza diverso in grado di comunicare con il gruppo di sicurezza del target di montaggio.
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: sì

 ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Subdirectory"></a>
Specifica un percorso di montaggio per il tuo file system utilizzando le barre. Qui è dove DataSync legge o scrive i dati (a seconda che si tratti di una posizione di origine o di destinazione).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS . È consigliabile creare almeno un tag di nome per la posizione.  
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-User"></a>
Speciifica l'utente con le autorizzazioni per montare e accedere a file, cartelle e metadati dei file nel file system FSx per Windows File Server.  
Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta le [autorizzazioni richieste FSx per le posizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) dei file server di Windows.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obbligatorio: sì

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

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

## Elementi di risposta
<a name="API_CreateLocationFsxWindows_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_CreateLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxWindows-response-LocationArn"></a>
L'ARN della posizione del file system FSx per Windows File Server 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_CreateLocationFsxWindows_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 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
<a name="API_CreateLocationFsxWindows_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/CreateLocationFsxWindows) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows) 

# CreateLocationHdfs
<a name="API_CreateLocationHdfs"></a>

Crea una *posizione* di trasferimento per un Hadoop Distributed File System (HDFS). AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync [accede ai cluster HDFS.](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs)

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationHdfs_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.

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
Gli Amazon Resource Names (ARNs) degli DataSync agenti che possono connettersi al tuo cluster HDFS.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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: sì

 ** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
Il tipo di autenticazione utilizzato per determinare l'identità dell'utente.   
Tipo: String  
Valori validi: `SIMPLE | KERBEROS`   
Obbligatorio: sì

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
La dimensione dei blocchi di dati da scrivere nel cluster HDFS. La dimensione del blocco deve essere un multiplo di 512 byte. La dimensione predefinita del blocco è 128 mebibyte (MiB).  
Tipo: numero intero  
Intervallo valido: valore minimo di 1048576. Valore massimo di 1073741824.  
Obbligatorio: no

 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, che include il keytab Kerberos DataSync utilizzato per accedere a una specifica posizione di archiviazione Hadoop Distributed File System (HDFS), con una posizione gestita dal cliente. AWS KMS key  
Quando includi questo parametro come parte di una `CreateLocationHdfs` richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme a quella `KerberosKeytab` specificata 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. 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`KerberosKeytab`) o `CustomSecretConfig` (senza`KerberosKeytab`) per fornire le credenziali per una richiesta. `CreateLocationHdfs` Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui il keytab Kerberos per la posizione di archiviazione HDFS è archiviato in formato binario, 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`KerberosKeytab`) o `CustomSecretConfig` (senza`KerberosKeytab`) per fornire le credenziali per una `CreateLocationHdfs` richiesta. Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
La tabella delle chiavi Kerberos (keytab) che contiene le mappature tra il principali Kerberos definiti e le chiavi crittografate. È possibile caricare il keytab da un file fornendo l'indirizzo del file.  
Questo parametro è obbligatorio se `KERBEROS` viene specificato per `AuthenticationType`. 
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 65536.  
Obbligatorio: no

 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
Il file `krb5.conf` che contiene le informazioni di configurazione di Kerberos. È possibile caricare il `krb5.conf` file fornendo l'indirizzo del file. Se stai usando AWS CLI, esegue la codifica base64 per te. Altrimenti, fornisci il testo con codifica base64.   
Questo parametro è obbligatorio se `KERBEROS` viene specificato per `AuthenticationType`.
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 131072.  
Obbligatorio: no

 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS.   
Questo parametro è obbligatorio se `KERBEROS` viene specificato per `AuthenticationType`.
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$`   
Obbligatorio: no

 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
L'URI del Key Management Server (KMS) del cluster HDFS.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
Obbligatorio: no

 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
Il NameNode che gestisce lo spazio dei nomi HDFS. NameNode Esegue operazioni come l'apertura, la chiusura e la ridenominazione di file e directory. NameNode Contiene le informazioni per mappare blocchi di dati su. DataNodes È possibile utilizzarne solo uno NameNode.  
Tipo: matrice di oggetti [HdfsNameNode](API_HdfsNameNode.md)  
Membri dell’array: numero minimo di 1 elemento.  
Obbligatorio: sì

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
La configurazione QOP (Quality of Protection) specifica le impostazioni di protezione per le chiamate di procedura remota (RPC, Remote Procedure Call) e per il trasferimento dati configurate nel cluster del file system distribuito Hadoop (HDFS). Se non si specifica `QopConfiguration`, il valore predefinito di `RpcProtection` e `DataTransferProtection` sarà `PRIVACY`. Se si imposta `RpcProtection` o `DataTransferProtection`, l'altro parametro assume lo stesso valore.   
Tipo: oggetto [QopConfiguration](API_QopConfiguration.md)  
Obbligatorio: no

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
Il numero DataNodes su cui replicare i dati durante la scrittura sul cluster HDFS. Per impostazione predefinita, i dati vengono replicati fino a tre. DataNodes  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 512.  
Obbligatorio: no

 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
Il nome utente utilizzato per identificare il client sul sistema operativo host.   
Questo parametro è obbligatorio se `SIMPLE` viene specificato per `AuthenticationType`. 
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Obbligatorio: no

 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
Una sottodirectory nel cluster HDFS. Questa sottodirectory viene utilizzata per leggere i dati da o scrivere i dati sul cluster HDFS. Se la sottodirectory non viene specificata, il valore predefinito sarà impostato su `/`.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
La coppia chiave-valore che rappresenta il tag che si desidera aggiungere alla posizione. Il valore può essere una stringa vuota. Si consiglia di utilizzare tag per assegnare un nome alle risorse.   
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_CreateLocationHdfs_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationHdfs_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_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
L'ARN della posizione del cluster HDFS di origine che crei.  
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_CreateLocationHdfs_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_CreateLocationHdfs_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/CreateLocationHdfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) 

# CreateLocationNfs
<a name="API_CreateLocationNfs"></a>

Crea una *posizione* di trasferimento per un file server Network File System (NFS). AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicuratevi di aver compreso come DataSync [accede ai file server NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).

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

```
{
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationNfs_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.

 ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-MountOptions"></a>
Specifica le opzioni che è DataSync possibile utilizzare per montare il file server NFS.  
Tipo: oggetto [NfsMountOptions](API_NfsMountOptions.md)  
Obbligatorio: no

 ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-OnPremConfig"></a>
Speciifica l'Amazon Resource Name (ARN) DataSync dell'agente che può connettersi al tuo file server NFS.  
Puoi specificare più di un agente. Per ulteriori informazioni, vedere [Utilizzo di più DataSync agenti](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents).  
Tipo: oggetto [OnPremConfig](API_OnPremConfig.md)  
Obbligatorio: sì

 ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-ServerHostname"></a>
Speciifica il nome DNS o l'indirizzo IP (IPv4 o IPv6) del file server NFS a cui si connette l' DataSync 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ì

 ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Subdirectory"></a>
Specificate il percorso di esportazione nel file server NFS che desiderate montare. DataSync   
Questo percorso (o una sottodirectory del percorso) è il luogo in cui vengono DataSync trasferiti i dati da o verso. Per informazioni sulla configurazione di un'esportazione per DataSync, consultate [Accesso ai file server NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
Obbligatorio: sì

 ** [Tags](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse. AWS È consigliabile creare almeno un tag di nome per la posizione.  
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_CreateLocationNfs_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationNfs_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_CreateLocationNfs_ResponseSyntax) **   <a name="DataSync-CreateLocationNfs-response-LocationArn"></a>
L'ARN della posizione di trasferimento che hai creato per il tuo file server NFS.  
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_CreateLocationNfs_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

## Esempi
<a name="API_CreateLocationNfs_Examples"></a>

### Esempio
<a name="API_CreateLocationNfs_Example_1"></a>

L'esempio seguente crea una posizione di DataSync trasferimento per un file server NFS.

#### Richiesta di esempio
<a name="API_CreateLocationNfs_Example_1_Request"></a>

```
{
  "MountOptions": {
     "Version": : "NFS4_0"
     },
  "OnPremConfig": {
    "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
          },
          
           "ServerHostname": "MyServer@amazon.com",
           "Subdirectory": "/MyFolder",
           "Tags": [
              {
                "Key": "Name",
                "Value": "FileSystem-1"
              }
           ]
}
```

### Esempio
<a name="API_CreateLocationNfs_Example_2"></a>

La risposta restituisce l'ARN della posizione NFS.

#### Risposta di esempio
<a name="API_CreateLocationNfs_Example_2_Response"></a>

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
```

## Vedi anche
<a name="API_CreateLocationNfs_SeeAlso"></a>

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

# CreateLocationObjectStorage
<a name="API_CreateLocationObjectStorage"></a>

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.](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required)

Prima di iniziare, assicurati di aver compreso i [prerequisiti](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) per lavorare con i sistemi di storage DataSync a oggetti.

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

```
{
   "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
<a name="API_CreateLocationObjectStorage_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.

 ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AccessKey"></a>
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](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AgentArns"></a>
(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.  
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](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-BucketName"></a>
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](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CmkSecretConfig"></a>
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. 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`SecretKey`) o `CustomSecretConfig` (senza`SecretKey`) per fornire le credenziali per una richiesta. `CreateLocationObjectStorage` Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CustomSecretConfig"></a>
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. 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`SecretKey`) o `CustomSecretConfig` (senza`SecretKey`) per fornire le credenziali per una `CreateLocationObjectStorage` richiesta. Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-SecretKey"></a>
Specifica la chiave segreta (ad esempio, una password) se sono necessarie credenziali per l'autenticazione con il server di storage di oggetti.  
Se fornisci un segreto utilizzando`SecretKey`, ma non fornisci dettagli di configurazione segreti utilizzando `CmkSecretConfig` o`CustomSecretConfig`, 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](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerCertificate"></a>
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 su`HTTPS`.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 32768.  
Obbligatorio: no

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

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

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

## Elementi di risposta
<a name="API_CreateLocationObjectStorage_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_CreateLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-CreateLocationObjectStorage-response-LocationArn"></a>
Speciifica 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
<a name="API_CreateLocationObjectStorage_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_CreateLocationObjectStorage_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/CreateLocationObjectStorage) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) 

# CreateLocationS3
<a name="API_CreateLocationS3"></a>

Crea una *posizione* di trasferimento per un bucket Amazon S3. AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

**Importante**  
Prima di iniziare, assicurati di leggere i seguenti argomenti:  
 [Considerazioni sulla classe di storage con le sedi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Valutazione dei costi delle richieste S3 durante l'utilizzo DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

 Per ulteriori informazioni, consulta [Configurazione dei trasferimenti con Amazon](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html) S3.

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

```
{
   "AgentArns": [ "string" ],
   "S3BucketArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateLocationS3_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.

 ** [AgentArns](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-AgentArns"></a>
(Amazon S3 solo su Outposts) Specifica l'Amazon Resource Name (ARN) dell'agente sul tuo Outpost. DataSync   
[Per ulteriori informazioni, consulta Deploy your agent on. DataSync AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent)  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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

 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3BucketArn"></a>
Speciifica l'ARN del bucket S3 che desideri utilizzare come posizione. (Quando crei l' DataSync attività in un secondo momento, specifichi se questa posizione è una fonte o una destinazione di trasferimento.)   
Se il bucket S3 si trova su una AWS Outposts risorsa, devi specificare un punto di accesso Amazon S3. Per ulteriori informazioni, consulta [Gestire l'accesso ai dati con i punti di accesso Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) nella *Amazon S3* User Guide.  
Tipo: String  
Limiti di lunghezza: lunghezza massima di 268.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
Obbligatorio: sì

 ** [S3Config](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3Config"></a>
Speciifica l'Amazon Resource Name (ARN) AWS Identity and Access Management del ruolo DataSync (IAM) utilizzato per accedere al bucket S3.  
Per ulteriori informazioni, consulta [Fornire l' DataSync accesso ai](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access) bucket S3.  
Tipo: oggetto [S3Config](API_S3Config.md)  
Obbligatorio: sì

 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3StorageClass"></a>
Speciifica la classe di storage che desideri che i tuoi oggetti utilizzino quando Amazon S3 è una destinazione di trasferimento.  
Per i bucket in Regioni AWS, la classe di storage predefinita è. `STANDARD` Per i bucket attivi AWS Outposts, la classe di archiviazione ha come impostazione predefinita. `OUTPOSTS`  
Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con i trasferimenti Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: String  
Valori validi: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Campo obbligatorio: no

 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Subdirectory"></a>
Speciifica un prefisso nel bucket S3 da cui eseguire la DataSync lettura o la scrittura (a seconda che il bucket sia una posizione di origine o di destinazione).  
DataSync non può trasferire oggetti con un prefisso che inizia con una barra () `/` o include o pattern. `//` `/./` `/../` Esempio:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: no

 ** [Tags](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse. AWS Ti consigliamo di creare almeno un'etichetta con il nome della 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_CreateLocationS3_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_CreateLocationS3_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_CreateLocationS3_ResponseSyntax) **   <a name="DataSync-CreateLocationS3-response-LocationArn"></a>
L'ARN della posizione S3 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_CreateLocationS3_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_CreateLocationS3_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/CreateLocationS3) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) 

# CreateLocationSmb
<a name="API_CreateLocationSmb"></a>

Crea una *posizione* di trasferimento per un file server Server Message Block (SMB). AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.

Prima di iniziare, assicurati di aver compreso come DataSync accede ai file server SMB. Per ulteriori informazioni, consulta [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "Password": "string",
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

## Parametri della richiesta
<a name="API_CreateLocationSmb_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.

 ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AgentArns"></a>
Speciifica l' DataSync agente (o gli agenti) che possono connettersi al file server SMB. Specifichi un agente utilizzando il relativo Amazon Resource Name (ARN).  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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: sì

 ** [AuthenticationType](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AuthenticationType"></a>
Speciifica il protocollo di autenticazione DataSync utilizzato per connettersi al file server SMB. DataSync supporta `NTLM` (impostazione predefinita) e `KERBEROS` autenticazione.  
Per ulteriori informazioni, vedere [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: String  
Valori validi: `NTLM | KERBEROS`   
Campo obbligatorio: no

 ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, un `Password` o `KerberosKeytab` `NTLM` (per impostazione predefinita) e i tipi di `KERBEROS` autenticazione, rispettivamente) da DataSync utilizzare per accedere a una posizione di archiviazione SMB specifica, con un server gestito dal cliente. AWS KMS key  
Quando includi questo parametro come parte di una `CreateLocationSmbRequest` richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme al `Password` o `KerberosKeytab` specificato 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. 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 `Password` o`KerberosKeytab`) o `CustomSecretConfig` (senza `Password` e`KerberosKeytab`) per fornire le credenziali per una richiesta. `CreateLocationSmbRequest` Non fornite entrambi `CmkSecretConfig` i `CustomSecretConfig` parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CustomSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui le credenziali della posizione di archiviazione SMB sono archiviate in Secrets Manager come testo semplice (per`Password`) o binario (per). `KerberosKeytab` 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 `CreateLocationSmbRequest` richiesta. Non fornite entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-DnsIpAddresses"></a>
Speciifica gli IPv6 indirizzi IPv4 o per i server DNS a cui appartiene il file server SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su. `KERBEROS`  
Se nell'ambiente sono presenti più domini, la configurazione di questo parametro assicura la DataSync connessione al file server SMB corretto.  
Tipo: array di stringhe  
Membri della matrice: numero massimo di 2 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 7. Lunghezza massima di 39.  
Modello: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z`   
Obbligatorio: no

 ** [Domain](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Domain"></a>
Specifica il nome dominio di Windows a cui appartiene il server di file SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su`NTLM`.  
Se nell'ambiente sono presenti più domini, la configurazione di questo parametro assicura la DataSync connessione al file server corretto.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obbligatorio: no

 ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKeytab"></a>
Speciifica il file della tabella delle chiavi Kerberos (keytab), che include le mappature tra la chiave principale Kerberos e la chiave di crittografia.  
Per evitare errori di esecuzione delle attività, assicurati che il principale Kerberos utilizzato per creare il file keytab corrisponda esattamente a quello specificato. `KerberosPrincipal`   
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 65536.  
Obbligatorio: no

 ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKrb5Conf"></a>
Specifica un file di configurazione Kerberos (`krb5.conf`) che definisce la configurazione del realm Kerberos.  
Il file deve essere codificato in base 64. Se stai usando il AWS CLI, la codifica è pronta per te.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 131072.  
Obbligatorio: no

 ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosPrincipal"></a>
Speciifica un principale Kerberos, che è un'identità nell'area di autenticazione Kerberos che dispone dell'autorizzazione ad accedere a file, cartelle e metadati dei file nel file server SMB.  
Potrebbe essere simile a un principale Kerberos. `HOST/kerberosuser@MYDOMAIN.ORG`  
I nomi principali distinguono tra maiuscole e minuscole. L'esecuzione dell' DataSync attività avrà esito negativo se il principale specificato per questo parametro non corrisponde esattamente al principale utilizzato per creare il file keytab.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$`   
Obbligatorio: no

 ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-MountOptions"></a>
Speciifica la versione del protocollo SMB DataSync utilizzata per accedere al file server SMB.  
Tipo: oggetto [SmbMountOptions](API_SmbMountOptions.md)  
Obbligatorio: no

 ** [Password](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Password"></a>
Speciifica la password dell'utente che può montare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento. Questo parametro si applica solo se `AuthenticationType` è impostato su. `NTLM`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^.{0,104}$`   
Obbligatorio: no

 ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-ServerHostname"></a>
Speciifica il nome di dominio o l'indirizzo IP (IPv4 o IPv6) del file server SMB a cui l'agente si connette DataSync .  
Se utilizzi l'autenticazione Kerberos, devi specificare un nome di dominio.
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ì

 ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Subdirectory"></a>
Speciifica il nome della condivisione esportata dal file server SMB in cui leggerà o DataSync scriverà i dati. È possibile includere una sottodirectory nel percorso di condivisione (ad esempio,). `/path/to/subdirectory` Assicurati che anche altri client SMB della tua rete possano montare questo percorso.  
Per copiare tutti i dati nella sottodirectory, DataSync devi essere in grado di montare la condivisione SMB e accedere a tutti i suoi dati. Per ulteriori informazioni, vedere [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: sì

 ** [Tags](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Tags"></a>
Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS . È consigliabile creare almeno un tag di nome per la posizione.  
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

 ** [User](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-User"></a>
Speciifica l'utente che può montare e accedere ai file, alle cartelle e ai metadati dei file nel file server SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su. `NTLM`  
Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obbligatorio: no

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

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

## Elementi di risposta
<a name="API_CreateLocationSmb_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_CreateLocationSmb_ResponseSyntax) **   <a name="DataSync-CreateLocationSmb-response-LocationArn"></a>
L'ARN della sede SMB 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_CreateLocationSmb_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

## Esempi
<a name="API_CreateLocationSmb_Examples"></a>

### Richiesta di esempio
<a name="API_CreateLocationSmb_Example_1"></a>

L'esempio seguente crea una posizione per un file server SMB.

```
{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3"
   ],
   "Domain":"AMAZON",
   "MountOptions":{
      "Version":"SMB3"
   },
   "Password":"string",
   "ServerHostname":"MyServer.amazon.com",
   "Subdirectory":"share",
   "Tags":[
      {
         "Key":"department",
         "Value":"finance"
      }
   ],
   "User":"user-1"
}
```

### Risposta di esempio
<a name="API_CreateLocationSmb_Example_2"></a>

Una risposta restituisce l'ARN della posizione del file server SMB.

```
{
    "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

## Vedi anche
<a name="API_CreateLocationSmb_SeeAlso"></a>

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

# CreateTask
<a name="API_CreateTask"></a>

Configura un'*attività*, che definisce dove e come vengono AWS DataSync trasferiti i dati.

Un'attività include una posizione di origine, una posizione di destinazione e opzioni di trasferimento (come limiti di larghezza di banda, pianificazione e altro).

**Importante**  
Se hai intenzione di trasferire dati da o verso una sede Amazon S3, consulta in che [modo DataSync possono influire sui costi delle richieste S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) e sulla [pagina dei DataSync prezzi](https://aws.amazon.com/datasync/pricing/) prima di iniziare.

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

```
{
   "CloudWatchLogGroupArn": "string",
   "DestinationLocationArn": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "SourceLocationArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## Parametri della richiesta
<a name="API_CreateTask_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.

 ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-CloudWatchLogGroupArn"></a>
Speciifica l'Amazon Resource Name (ARN) di un gruppo di log CloudWatch Amazon per il monitoraggio dell'attività.  
Per le attività in modalità avanzata, non è necessario specificare nulla. DataSyncinvia automaticamente i log a un gruppo di CloudWatch log denominato`/aws/datasync`.  
Per ulteriori informazioni, vedere [Monitoraggio dei trasferimenti di dati con i CloudWatch registri](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 562.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
Obbligatorio: no

 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-DestinationLocationArn"></a>
Specifica l'ARN della località di destinazione del trasferimento.   
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}$`   
Obbligatorio: sì

 ** [Excludes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Excludes"></a>
Speciifica i filtri di esclusione che definiscono i file, gli oggetti e le cartelle nella posizione di origine che non si desidera DataSync trasferire. Per ulteriori informazioni ed esempi, consulta [Specificare DataSync i trasferimenti utilizzando i filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: no

 ** [Includes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Includes"></a>
Le specifiche includono i filtri che definiscono i file, gli oggetti e le cartelle che si desidera DataSync trasferire nella posizione di origine. Per ulteriori informazioni ed esempi, vedere [Specificazione dei DataSync trasferimenti mediante filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: no

 ** [ManifestConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-ManifestConfig"></a>
Configura un manifesto, che è un elenco di file o oggetti che si desidera DataSync trasferire. Per ulteriori informazioni ed esempi di configurazione, vedere [Specificazione degli elementi da DataSync trasferire utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Quando si utilizza questo parametro, l'identità del chiamante (il ruolo DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione.  
Tipo: oggetto [ManifestConfig](API_ManifestConfig.md)  
Obbligatorio: no

 ** [Name](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Name"></a>
Specificate il nome dell'attività.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obbligatorio: no

 ** [Options](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Options"></a>
Speciifica le impostazioni dell'attività, come la conservazione dei metadati dei file, la verifica dell'integrità dei dati, tra le altre opzioni.  
Tipo: oggetto [Options](API_Options.md)  
Obbligatorio: no

 ** [Schedule](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Schedule"></a>
Specificate una pianificazione per quando desiderate che l'attività venga eseguita. Per ulteriori informazioni, vedere [Pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: oggetto [TaskSchedule](API_TaskSchedule.md)  
Obbligatorio: no

 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-SourceLocationArn"></a>
Specifica l'ARN della posizione di origine del trasferimento.  
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}$`   
Obbligatorio: sì

 ** [Tags](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Tags"></a>
Specificate i tag da applicare all'attività.  
 I *tag* sono coppie chiave-valore che consentono di gestire, filtrare e cercare le risorse. DataSync   
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

 ** [TaskMode](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskMode"></a>
Specifica una delle seguenti modalità di attività per il trasferimento dei dati:  
+  `ENHANCED`- Trasferisci un numero virtualmente illimitato di oggetti con prestazioni superiori rispetto alla modalità Basic. Le attività in modalità avanzata ottimizzano il processo di trasferimento dei dati elencando, preparando, trasferendo e verificando i dati in parallelo. La modalità avanzata è attualmente disponibile per i trasferimenti tra sedi Amazon S3, i trasferimenti tra Azure Blob e Amazon S3 senza un agente e i trasferimenti tra altri cloud e Amazon S3 senza agente.
**Nota**  
Per creare un'attività in modalità avanzata, il ruolo IAM utilizzato per chiamare l'`CreateTask`operazione deve disporre dell'autorizzazione. `iam:CreateServiceLinkedRole`
+  `BASIC`(impostazione predefinita): trasferisci file o oggetti tra l' AWS archiviazione e tutte le altre DataSync posizioni supportate. Le attività in modalità base sono soggette a [quote](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) sul numero di file, oggetti e directory in un set di dati. La modalità base prepara, trasferisce e verifica i dati in modo sequenziale, rendendola più lenta della modalità avanzata per la maggior parte dei carichi di lavoro.
[Per ulteriori informazioni, vedere Comprensione delle differenze tra le modalità di attività.](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)  
Tipo: String  
Valori validi: `BASIC | ENHANCED`   
Campo obbligatorio: no

 ** [TaskReportConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskReportConfig"></a>
Specifica come si desidera configurare un rapporto sulle attività, che fornisce informazioni dettagliate sul DataSync trasferimento. Per ulteriori informazioni, consulta [Monitoraggio dei DataSync trasferimenti con i report sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Quando si utilizza questo parametro, l'identità del chiamante (il ruolo DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione.  
Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md)  
Obbligatorio: no

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

```
{
   "TaskArn": "string"
}
```

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

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

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

 ** [TaskArn](#API_CreateTask_ResponseSyntax) **   <a name="DataSync-CreateTask-response-TaskArn"></a>
L'Amazon Resource Name (ARN) dell'attività.  
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}:task/task-[0-9a-f]{17}$` 

## Errori
<a name="API_CreateTask_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 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

## Esempi
<a name="API_CreateTask_Examples"></a>

### Esempio di richiesta per un'attività in modalità avanzata
<a name="API_CreateTask_Example_1"></a>

L'esempio seguente crea un' DataSync attività che utilizza la modalità avanzata.

A differenza di quando si creano attività in modalità Basic, non è necessario specificare un gruppo di CloudWatch log Amazon. Con le attività in modalità avanzata, invia DataSync automaticamente i log delle attività a un gruppo di log denominato`/aws/datasync`. Se quel gruppo di log non esiste nel tuo Regione AWS, DataSync crea il gruppo di log per tuo conto quando crei l'attività.

```
{
  "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3",
  "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2",
  "Name": "My Enhanced mode task",
  "TaskMode": "ENHANCED",
  "Options": {
    "TransferMode": "CHANGED",
    "VerifyMode": "ONLY_FILES_TRANSFERRED",
    "ObjectTags": "PRESERVE",
    "LogLevel": "TRANSFER"
  }
}
```

### Esempio di richiesta per un'attività in modalità Basic
<a name="API_CreateTask_Example_2"></a>

L'esempio seguente crea un' DataSync attività che utilizza la modalità Basic.

```
{
    "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3",
    "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2",
    "Name": "My Basic mode task",
    "TaskMode": "BASIC",
    "Options": {
        "Atime": "BEST_EFFORT",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "ONLY_FILES_TRANSFERRED"
    },
    "Schedule": {
        "ScheduleExpression": "0 12 ? * SUN,WED *"
    },
    "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*",
    "Tags": [
        {
            "Key": "Name",
            "Value": "Migration-wave-1"
        }
    ]
}
```

### Risposta di esempio
<a name="API_CreateTask_Example_3"></a>

La risposta seguente include l'ARN di un'attività creata.

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

## Vedi anche
<a name="API_CreateTask_SeeAlso"></a>

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

# DeleteAgent
<a name="API_DeleteAgent"></a>

Rimuove una risorsa AWS DataSync agente dal tuo Account AWS.

Tieni presente che questa operazione (che non può essere annullata) non rimuove la macchina virtuale (VM) dell'agente o l'istanza Amazon EC2 dal tuo ambiente di storage. [Per i passaggi successivi, puoi eliminare la macchina virtuale o l'istanza dal tuo ambiente di storage o riutilizzarla per attivare un nuovo agente.](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)

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

```
{
   "AgentArn": "string"
}
```

## Parametri della richiesta
<a name="API_DeleteAgent_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.

 ** [AgentArn](#API_DeleteAgent_RequestSyntax) **   <a name="DataSync-DeleteAgent-request-AgentArn"></a>
L'Amazon Resource Name (ARN) dell'agente da eliminare. Utilizza l'`ListAgents`operazione per restituire un elenco di agenti per il tuo account e Regione AWS.  
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}:agent/agent-[0-9a-z]{17}$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_DeleteAgent_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 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
<a name="API_DeleteAgent_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/DeleteAgent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) 

# DeleteLocation
<a name="API_DeleteLocation"></a>

Elimina una risorsa di posizione di trasferimento da AWS DataSync. 

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

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

## Parametri della richiesta
<a name="API_DeleteLocation_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.

 ** [LocationArn](#API_DeleteLocation_RequestSyntax) **   <a name="DataSync-DeleteLocation-request-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione da eliminare.  
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}$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_DeleteLocation_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 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
<a name="API_DeleteLocation_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/DeleteLocation) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) 

# DeleteTask
<a name="API_DeleteTask"></a>

Elimina una risorsa dell'attività di trasferimento da AWS DataSync.

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

```
{
   "TaskArn": "string"
}
```

## Parametri della richiesta
<a name="API_DeleteTask_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.

 ** [TaskArn](#API_DeleteTask_RequestSyntax) **   <a name="DataSync-DeleteTask-request-TaskArn"></a>
Speciifica l'Amazon Resource Name (ARN) dell'attività che desideri eliminare.  
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}:task/task-[0-9a-f]{17}$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_DeleteTask_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_DeleteTask_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/DeleteTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) 

# DescribeAgent
<a name="API_DescribeAgent"></a>

Restituisce informazioni su un AWS DataSync agente, ad esempio il nome, il tipo di endpoint del servizio e lo stato.

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

```
{
   "AgentArn": "string"
}
```

## Parametri della richiesta
<a name="API_DescribeAgent_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.

 ** [AgentArn](#API_DescribeAgent_RequestSyntax) **   <a name="DataSync-DescribeAgent-request-AgentArn"></a>
Speciifica l'Amazon Resource Name (ARN) DataSync dell'agente su cui desideri informazioni.  
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}:agent/agent-[0-9a-z]{17}$`   
Obbligatorio: sì

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

```
{
   "AgentArn": "string",
   "CreationTime": number,
   "EndpointType": "string",
   "LastConnectionTime": number,
   "Name": "string",
   "Platform": { 
      "Version": "string"
   },
   "PrivateLinkConfig": { 
      "PrivateLinkEndpoint": "string",
      "SecurityGroupArns": [ "string" ],
      "SubnetArns": [ "string" ],
      "VpcEndpointId": "string"
   },
   "Status": "string"
}
```

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

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

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

 ** [AgentArn](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-AgentArn"></a>
L'ARN dell'agente.  
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}:agent/agent-[0-9a-z]{17}$` 

 ** [CreationTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-CreationTime"></a>
[L'ora in cui l'agente è stato attivato.](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)  
Tipo: Timestamp

 ** [EndpointType](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-EndpointType"></a>
Il tipo di [endpoint di servizio](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html) a cui è connesso l'agente.  
Tipo: String  
Valori validi: `PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK` 

 ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-LastConnectionTime"></a>
L'ultima volta che l'agente ha comunicato con il DataSync servizio.  
Tipo: Timestamp

 ** [Name](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Name"></a>
Il nome dell'agente.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Platform](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Platform"></a>
I dettagli relativi alla piattaforma sull'agente, ad esempio il numero di versione.  
Tipo: oggetto [Platform](API_Platform.md)

 ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-PrivateLinkConfig"></a>
La configurazione di rete utilizzata dall'agente per la connessione a un endpoint del [servizio VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc).  
Tipo: oggetto [PrivateLinkConfig](API_PrivateLinkConfig.md)

 ** [Status](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Status"></a>
Lo stato dell'agente.  
+ Se lo stato è`ONLINE`, l'agente è configurato correttamente e pronto per l'uso.
+ Se lo stato è`OFFLINE`, l'agente non è in contatto con l'agente DataSync da cinque minuti o più. Questo può succedere per diversi motivi. Per ulteriori informazioni, vedi [Cosa devo fare se il mio agente è offline?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 
Tipo: String  
Valori validi: `ONLINE | OFFLINE` 

## Errori
<a name="API_DescribeAgent_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 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

## Esempi
<a name="API_DescribeAgent_Examples"></a>

### Richiesta di esempio
<a name="API_DescribeAgent_Example_1"></a>

L'esempio seguente restituisce informazioni su un agente specificato in una richiesta.

```
{
  "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0"
}
```

### Risposta di esempio
<a name="API_DescribeAgent_Example_2"></a>

Il seguente esempio di risposta descrive un agente che utilizza un endpoint di servizio pubblico.

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0",
    "Name": "Data center migration agent",
    "Status": "ONLINE",
    "LastConnectionTime": "2022-10-17T17:21:35.540000+00:00",
    "CreationTime": "2022-10-05T20:52:29.499000+00:00",
    "EndpointType": "PUBLIC",
    "Platform": {
        "Version": "2"
    }
}
```

## Vedi anche
<a name="API_DescribeAgent_SeeAlso"></a>

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

# DescribeLocationAzureBlob
<a name="API_DescribeLocationAzureBlob"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per Microsoft Azure Blob Storage.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationAzureBlob_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.

 ** [LocationArn](#API_DescribeLocationAzureBlob_RequestSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-request-LocationArn"></a>
Specifica l'Amazon Resource Name (ARN) della posizione di trasferimento di Azure Blob Storage.  
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}$`   
Obbligatorio: sì

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

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   }
}
```

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

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

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

 ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AccessTier"></a>
Il livello di accesso in cui desideri trasferire i tuoi oggetti o file. Questo vale 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` 

 ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AgentArns"></a>
Gli DataSync agenti che possono connettersi al contenitore Azure Blob Storage. ARNs   
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}$` 

 ** [AuthenticationType](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AuthenticationType"></a>
Il metodo di autenticazione DataSync utilizzato 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` 

 ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-BlobType"></a>
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` 

 ** [CmkSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CmkSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CreationTime"></a>
L'ora in cui è stata creata la posizione di trasferimento di Azure Blob Storage.  
Tipo: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CustomSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un token di autenticazione DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationArn"></a>
L'ARN della posizione di trasferimento di Azure Blob Storage.  
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}$` 

 ** [LocationUri](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationUri"></a>
L'URL del contenitore Azure Blob Storage coinvolto nel trasferimento.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione DataSync utilizzato per accedere a una posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)

## Errori
<a name="API_DescribeLocationAzureBlob_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_DescribeLocationAzureBlob_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/DescribeLocationAzureBlob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) 

# DescribeLocationEfs
<a name="API_DescribeLocationEfs"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un file system Amazon EFS.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationEfs_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.

 ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) **   <a name="DataSync-DescribeLocationEfs-request-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione del file system Amazon EFS su cui desideri informazioni.  
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}$`   
Obbligatorio: sì

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

```
{
   "AccessPointArn": "string",
   "CreationTime": number,
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "LocationUri": "string"
}
```

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

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

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

 ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-AccessPointArn"></a>
L'ARN del punto di accesso DataSync utilizzato per accedere al file system Amazon EFS.  
Per ulteriori informazioni, consulta [Accesso ai file system con restrizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` 

 ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-CreationTime"></a>
L'ora in cui è stata creata la posizione.  
Tipo: Timestamp

 ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-Ec2Config"></a>
La sottorete e i gruppi di sicurezza AWS DataSync utilizzati per connettersi a uno degli [obiettivi di montaggio](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del file system Amazon EFS.  
Tipo: oggetto [Ec2Config](API_Ec2Config.md)

 ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-FileSystemAccessRoleArn"></a>
Il ruolo AWS Identity and Access Management (IAM) che consente di accedere DataSync al file system Amazon EFS.  
Per ulteriori informazioni, consulta [Creazione di un ruolo DataSync IAM per l'accesso al file system](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 

 ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-InTransitEncryption"></a>
Indica se DataSync utilizza la crittografia Transport Layer Security (TLS) per il trasferimento di dati da o verso il file system Amazon EFS.  
Tipo: String  
Valori validi: `NONE | TLS1_2` 

 ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationArn"></a>
L'ARN della posizione del file system Amazon EFS.  
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}$` 

 ** [LocationUri](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationUri"></a>
L'URL della posizione del file system Amazon EFS.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

## Errori
<a name="API_DescribeLocationEfs_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

## Esempi
<a name="API_DescribeLocationEfs_Examples"></a>

### Richiesta di esempio
<a name="API_DescribeLocationEfs_Example_1"></a>

L'esempio seguente mostra come ottenere informazioni su una posizione specifica del file system Amazon EFS.

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

### Risposta di esempio
<a name="API_DescribeLocationEfs_Example_2"></a>

L'esempio seguente restituisce i dettagli sulla posizione di un file system Amazon EFS.

```
{
    "CreationTime": 1653319021.353,
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/"
}
```

### Esempio di risposta: descrizione di una posizione per un file system Amazon EFS con restrizioni
<a name="API_DescribeLocationEfs_Example_3"></a>

L'esempio seguente restituisce i dettagli sulla posizione di un file system Amazon EFS con accesso limitato`AccessPointArn`, inclusi gli `InTransitEncryption` elementi`FileSystemAccessRoleArn`, e.

```
{
    "CreationTime": 1653319021.353,
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

## Vedi anche
<a name="API_DescribeLocationEfs_SeeAlso"></a>

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

# DescribeLocationFsxLustre
<a name="API_DescribeLocationFsxLustre"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento FSx per un file system Amazon for Lustre.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationFsxLustre_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.

 ** [LocationArn](#API_DescribeLocationFsxLustre_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-request-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione FSx for Lustre da descrivere.   
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}$`   
Obbligatorio: sì

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

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "SecurityGroupArns": [ "string" ]
}
```

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

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

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

 ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-CreationTime"></a>
L'ora in cui è stata creata la sede FSx for Lustre.  
Tipo: Timestamp

 ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione FSx for Lustre descritta.  
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}$` 

 ** [LocationUri](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationUri"></a>
L'URI della posizione FSx for Lustre descritta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-SecurityGroupArns"></a>
Gli Amazon Resource Names (ARNs) dei gruppi di sicurezza configurati per il file system FSx for Lustre.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

## Errori
<a name="API_DescribeLocationFsxLustre_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 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
<a name="API_DescribeLocationFsxLustre_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/DescribeLocationFsxLustre) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) 

# DescribeLocationFsxOntap
<a name="API_DescribeLocationFsxOntap"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento FSx per un file system Amazon for NetApp ONTAP.

**Nota**  
Se la tua posizione utilizza SMB, l'`DescribeLocationFsxOntap`operazione non restituisce effettivamente un. `Password`

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

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

## Parametri della richiesta
<a name="API_DescribeLocationFsxOntap_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.

 ** [LocationArn](#API_DescribeLocationFsxOntap_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione FSx del file system for ONTAP su cui desideri informazioni.  
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}$`   
Obbligatorio: sì

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

```
{
   "CreationTime": number,
   "FsxFilesystemArn": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string"
}
```

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

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

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

 ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-CreationTime"></a>
L'ora in cui è stata creata la posizione.  
Tipo: Timestamp

 ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-FsxFilesystemArn"></a>
L'ARN del file system FSx for ONTAP.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` 

 ** [LocationArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-LocationArn"></a>
L'ARN della posizione del file system FSx for ONTAP.  
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}$` 

 ** [LocationUri](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-LocationUri"></a>
L'Uniform Resource Identifier (URI) della posizione del file FSx system ONTAP.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-Protocol"></a>
Speciifica il protocollo di trasferimento dati AWS DataSync utilizzato per accedere al tuo FSx file system Amazon.  
Tipo: oggetto [FsxProtocol](API_FsxProtocol.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-SecurityGroupArns"></a>
I gruppi di sicurezza DataSync utilizzati per accedere al file system FSx for ONTAP.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

 ** [StorageVirtualMachineArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-StorageVirtualMachineArn"></a>
L'ARN della macchina virtuale di archiviazione (SVM) sul file system FSx for ONTAP su cui stai copiando i dati da o verso cui stai copiando i dati.  
Tipo: String  
Limiti di lunghezza: lunghezza massima di 162.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` 

## Errori
<a name="API_DescribeLocationFsxOntap_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_DescribeLocationFsxOntap_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/DescribeLocationFsxOntap) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) 

# DescribeLocationFsxOpenZfs
<a name="API_DescribeLocationFsxOpenZfs"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento FSx per un file system Amazon for OpenZFS.

**Nota**  
Gli elementi di risposta correlati a `SMB` non sono supportati dall'`DescribeLocationFsxOpenZfs`operazione.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationFsxOpenZfs_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.

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-request-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione FSx per OpenZFS da descrivere.  
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}$`   
Obbligatorio: sì

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

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ]
}
```

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

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

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

 ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-CreationTime"></a>
L'ora in cui è stata creata la FSx posizione for OpenZFS.  
Tipo: Timestamp

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationArn"></a>
L'ARN della posizione FSx per OpenZFS descritta.  
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}$` 

 ** [LocationUri](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationUri"></a>
L'Uniform Resource Identifier (URI) della posizione FSx per OpenZFS descritta.  
Ad esempio: `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder`   
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-Protocol"></a>
Il tipo di protocollo AWS DataSync utilizzato per accedere al file system.  
Tipo: oggetto [FsxProtocol](API_FsxProtocol.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-SecurityGroupArns"></a>
I gruppi ARNs di sicurezza configurati per il file system FSx per OpenZFS.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

## Errori
<a name="API_DescribeLocationFsxOpenZfs_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_DescribeLocationFsxOpenZfs_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/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 

# DescribeLocationFsxWindows
<a name="API_DescribeLocationFsxWindows"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento FSx per un file system Amazon for Windows File Server.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationFsxWindows_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.

 ** [LocationArn](#API_DescribeLocationFsxWindows_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione FSx del file server per Windows.  
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}$`   
Obbligatorio: sì

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

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "SecurityGroupArns": [ "string" ],
   "User": "string"
}
```

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

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

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

 ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CmkSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un segreto DataSync utilizzato per accedere a una `Password` posizione di archiviazione specifica, con un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CreationTime"></a>
L'ora in cui è stata creata la posizione FSx per Windows File Server.  
Tipo: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CustomSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `Password` segreto DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-Domain"></a>
Il nome del dominio Microsoft Active Directory a cui appartiene il file system FSx for Windows File Server.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [LocationArn](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationArn"></a>
L'ARN della posizione del file server FSx per Windows.  
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}$` 

 ** [LocationUri](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationUri"></a>
L'Uniform Resource Identifier (URI) della posizione FSx per Windows File Server.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un segreto DataSync utilizzato per accedere a una `Password` posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-SecurityGroupArns"></a>
Gli ARN dei gruppi di sicurezza di Amazon EC2 che forniscono l'accesso alla sottorete preferita del file system.  
Per informazioni sulla configurazione dei gruppi di sicurezza per l'accesso al file system, consulta la [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html).  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` 

 ** [User](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-User"></a>
L'utente con le autorizzazioni per montare e accedere al file system FSx per Windows File Server.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Errori
<a name="API_DescribeLocationFsxWindows_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_DescribeLocationFsxWindows_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/DescribeLocationFsxWindows) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) 

# DescribeLocationHdfs
<a name="API_DescribeLocationHdfs"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un Hadoop Distributed File System (HDFS).

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

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

## Parametri della richiesta
<a name="API_DescribeLocationHdfs_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.

 ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) **   <a name="DataSync-DescribeLocationHdfs-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione HDFS.  
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}$`   
Obbligatorio: sì

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string"
}
```

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

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

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

 ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AgentArns"></a>
Gli DataSync agenti che possono connettersi al tuo cluster HDFS. ARNs   
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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}$` 

 ** [AuthenticationType](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AuthenticationType"></a>
Il tipo di autenticazione utilizzato per determinare l'identità dell'utente.   
Tipo: String  
Valori validi: `SIMPLE | KERBEROS` 

 ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-BlockSize"></a>
La dimensione dei blocchi di dati da scrivere nel cluster HDFS.   
Tipo: numero intero  
Intervallo valido: valore minimo di 1048576. Valore massimo di 1073741824.

 ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CmkSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio uno `KerberosKeytab` che DataSync consente di accedere a una posizione di archiviazione specifica, con un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CreationTime"></a>
L'ora in cui è stata creata la posizione HDFS.  
Tipo: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CustomSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `KerberosKeytab` segreto DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KerberosPrincipal"></a>
Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS. Questo parametro viene utilizzato se è definito come. `AuthenticationType` `KERBEROS`  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$` 

 ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KmsKeyProviderUri"></a>
 L'URI del Key Management Server (KMS) del cluster HDFS.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` 

 ** [LocationArn](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationArn"></a>
L'ARN della posizione HDFS.  
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}$` 

 ** [LocationUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationUri"></a>
L'URI della posizione HDFS.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un segreto DataSync utilizzato per accedere a una `KerberosKeytab` posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-NameNodes"></a>
Il NameNode che gestisce lo spazio dei nomi HDFS.   
Tipo: matrice di oggetti [HdfsNameNode](API_HdfsNameNode.md)  
Membri dell’array: numero minimo di 1 elemento.

 ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-QopConfiguration"></a>
La configurazione Quality of Protection (QOP), che specifica la Remote Procedure Call (RPC) e le impostazioni di protezione del trasferimento dati configurate sul cluster HDFS.   
Tipo: oggetto [QopConfiguration](API_QopConfiguration.md)

 ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ReplicationFactor"></a>
Il numero DataNodes su cui replicare i dati durante la scrittura sul cluster HDFS.   
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 512.

 ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-SimpleUser"></a>
Il nome utente per identificare il client sul sistema operativo host. Questo parametro viene utilizzato se `AuthenticationType` è definito come`SIMPLE`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 

## Errori
<a name="API_DescribeLocationHdfs_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 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
<a name="API_DescribeLocationHdfs_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/DescribeLocationHdfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) 

# DescribeLocationNfs
<a name="API_DescribeLocationNfs"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un file server NFS (Network File System).

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

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

## Parametri della richiesta
<a name="API_DescribeLocationNfs_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.

 ** [LocationArn](#API_DescribeLocationNfs_RequestSyntax) **   <a name="DataSync-DescribeLocationNfs-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione NFS su cui desideri informazioni.  
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}$`   
Obbligatorio: sì

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

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   }
}
```

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

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

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

 ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-CreationTime"></a>
L'ora in cui è stata creata la posizione NFS.  
Tipo: Timestamp

 ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationArn"></a>
L'ARN della posizione NFS.  
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}$` 

 ** [LocationUri](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationUri"></a>
L'URI della posizione NFS.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-MountOptions"></a>
Le opzioni di montaggio DataSync utilizzate per montare il file server NFS.  
Tipo: oggetto [NfsMountOptions](API_NfsMountOptions.md)

 ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-OnPremConfig"></a>
Gli AWS DataSync agenti che possono connettersi al file server Network File System (NFS).  
Tipo: oggetto [OnPremConfig](API_OnPremConfig.md)

## Errori
<a name="API_DescribeLocationNfs_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 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

## Esempi
<a name="API_DescribeLocationNfs_Examples"></a>

### Esempio
<a name="API_DescribeLocationNfs_Example_1"></a>

L'esempio seguente restituisce informazioni sulla posizione NFS specificata nella richiesta di esempio.

#### Richiesta di esempio
<a name="API_DescribeLocationNfs_Example_1_Request"></a>

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
```

### Esempio
<a name="API_DescribeLocationNfs_Example_2"></a>

Questo esempio illustra un utilizzo di. DescribeLocationNfs

#### Risposta di esempio
<a name="API_DescribeLocationNfs_Example_2_Response"></a>

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa",
   "LocationUri": "hostname.amazon.com",
   "OnPremConfig": { 
      "AgentArns": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
   }
}
```

## Vedi anche
<a name="API_DescribeLocationNfs_SeeAlso"></a>

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

# DescribeLocationObjectStorage
<a name="API_DescribeLocationObjectStorage"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un sistema di storage di oggetti.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationObjectStorage_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.

 ** [LocationArn](#API_DescribeLocationObjectStorage_RequestSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione del sistema di storage degli oggetti.  
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}$`   
Obbligatorio: sì

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

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "ServerCertificate": blob,
   "ServerPort": number,
   "ServerProtocol": "string"
}
```

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

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

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

 ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AccessKey"></a>
La chiave di accesso (ad esempio, un nome utente) necessaria per l'autenticazione con il sistema di storage di oggetti.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Modello: `^.*$` 

 ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AgentArns"></a>
Gli DataSync agenti che possono connettersi al sistema di storage degli oggetti. ARNs   
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}$` 

 ** [CmkSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CmkSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CreationTime"></a>
L'ora in cui è stata creata la posizione.  
Tipo: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CustomSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationArn"></a>
L'ARN della posizione del sistema di storage degli oggetti.  
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}$` 

 ** [LocationUri](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationUri"></a>
L'URI della posizione del sistema di storage degli oggetti.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerCertificate"></a>
La 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.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 32768.

 ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerPort"></a>
La porta su cui il server di archiviazione degli oggetti accetta il traffico di rete in entrata (ad esempio, la porta 443).  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 65536.

 ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerProtocol"></a>
Il protocollo utilizzato dal sistema di storage degli oggetti per comunicare.  
Tipo: String  
Valori validi: `HTTPS | HTTP` 

## Errori
<a name="API_DescribeLocationObjectStorage_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 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
<a name="API_DescribeLocationObjectStorage_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/DescribeLocationObjectStorage) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) 

# DescribeLocationS3
<a name="API_DescribeLocationS3"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un bucket S3.

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

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

## Parametri della richiesta
<a name="API_DescribeLocationS3_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.

 ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) **   <a name="DataSync-DescribeLocationS3-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione Amazon S3.  
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}$`   
Obbligatorio: sì

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

```
{
   "AgentArns": [ "string" ],
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string"
}
```

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

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

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

 ** [AgentArns](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-AgentArns"></a>
Gli DataSync agenti distribuiti sul tuo Outpost quando utilizzi Amazon S3 su Outposts. ARNs   
Per ulteriori informazioni, consulta [Deploy](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent) your agent on. DataSync AWS Outposts  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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}$` 

 ** [CreationTime](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-CreationTime"></a>
L'ora in cui è stata creata la sede Amazon S3.  
Tipo: Timestamp

 ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationArn"></a>
L'ARN della sede Amazon S3.  
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}$` 

 ** [LocationUri](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationUri"></a>
L'URL della posizione Amazon S3 descritta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3Config"></a>
Speciifica l'Amazon Resource Name (ARN) AWS Identity and Access Management del ruolo DataSync (IAM) utilizzato per accedere al bucket S3.  
Per ulteriori informazioni, consulta [Fornire l' DataSync accesso ai](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access) bucket S3.  
Tipo: oggetto [S3Config](API_S3Config.md)

 ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3StorageClass"></a>
Quando Amazon S3 è una posizione di destinazione, questa è la classe di storage che hai scelto per i tuoi oggetti.  
Alcune classi di storage hanno comportamenti che possono influire sui costi di storage di Amazon S3. Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con i trasferimenti Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: String  
Valori validi: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 

## Errori
<a name="API_DescribeLocationS3_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

## Esempi
<a name="API_DescribeLocationS3_Examples"></a>

### Esempio
<a name="API_DescribeLocationS3_Example_1"></a>

L'esempio seguente restituisce informazioni sulla posizione Amazon S3 specificata nella richiesta di esempio.

#### Richiesta di esempio
<a name="API_DescribeLocationS3_Example_1_Request"></a>

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}
```

### Esempio
<a name="API_DescribeLocationS3_Example_2"></a>

Questo esempio illustra un utilizzo di DescribeLocation S3.

#### Risposta di esempio
<a name="API_DescribeLocationS3_Example_2_Response"></a>

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
   "LocationUri": "s3://amzn-s3-demo-bucket",
   "S3Config": { 
      "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
   }
    "S3StorageClass": "STANDARD"
}
```

## Vedi anche
<a name="API_DescribeLocationS3_SeeAlso"></a>

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

# DescribeLocationSmb
<a name="API_DescribeLocationSmb"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un file server Server Message Block (SMB).

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

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

## Parametri della richiesta
<a name="API_DescribeLocationSmb_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.

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della sede SMB su cui desideri informazioni.  
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}$`   
Obbligatorio: sì

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "MountOptions": { 
      "Version": "string"
   },
   "User": "string"
}
```

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

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

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

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
Gli DataSync agenti che possono connettersi al tuo file server SMB. ARNs   
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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}$` 

 ** [AuthenticationType](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AuthenticationType"></a>
Il protocollo di autenticazione DataSync utilizzato per connettersi al file server SMB.  
Tipo: String  
Valori validi: `NTLM | KERBEROS` 

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` o `KerberosKeytab` che DataSync viene utilizzato per accedere a una posizione di archiviazione specifica, con un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
L'ora in cui è stata creata la sede SMB.  
Tipo: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `Password` o `KerberosKeytab` che DataSync viene utilizzato per accedere a una posizione di archiviazione specifica, con un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
 IPv6 Gli indirizzi IPv4 o per i server DNS a cui appartiene il file server SMB. Questo elemento si applica solo se `AuthenticationType` è impostato su. `KERBEROS`  
Tipo: array di stringhe  
Membri della matrice: numero massimo di 2 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 7. Lunghezza massima di 39.  
Modello: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 

 ** [Domain](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-Domain"></a>
Il nome del dominio Windows a cui appartiene il file server SMB. Questo elemento si applica solo se `AuthenticationType` è impostato su. `NTLM`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
Il principale Kerberos che dispone dell'autorizzazione per accedere a file, cartelle e metadati dei file nel file server SMB.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$` 

 ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
L'ARN della sede SMB.  
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}$` 

 ** [LocationUri](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationUri"></a>
L'URI della sede SMB.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` or `KerberosKeytab` che DataSync viene utilizzato per accedere a una posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
La versione del protocollo SMB DataSync utilizzata per accedere al file server SMB.  
Tipo: oggetto [SmbMountOptions](API_SmbMountOptions.md)

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
L'utente che può montare e accedere a file, cartelle e metadati dei file nel file server SMB. Questo elemento si applica solo se `AuthenticationType` è impostato su. `NTLM`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Errori
<a name="API_DescribeLocationSmb_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

## Esempi
<a name="API_DescribeLocationSmb_Examples"></a>

### Esempio
<a name="API_DescribeLocationSmb_Example_1"></a>

Questo esempio illustra un utilizzo di. DescribeLocationSmb

#### Richiesta di esempio
<a name="API_DescribeLocationSmb_Example_1_Request"></a>

```
{
  "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

### Esempio
<a name="API_DescribeLocationSmb_Example_2"></a>

Questo esempio illustra un utilizzo di. DescribeLocationSmb

#### Risposta di esempio
<a name="API_DescribeLocationSmb_Example_2_Response"></a>

```
{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
   ],
   "CreationTime":"1532660733.39",
   "Domain":"AMAZON",
   "LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
   "LocationUri":"smb://hostname.amazon.com/share",
   "MountOptions":{
      "Version":"SMB3"
   },
   "User":"user-1"
}
```

## Vedi anche
<a name="API_DescribeLocationSmb_SeeAlso"></a>

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

# DescribeTask
<a name="API_DescribeTask"></a>

Fornisce informazioni su un'*attività*, che definisce dove e come vengono AWS DataSync trasferiti i dati.

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

```
{
   "TaskArn": "string"
}
```

## Parametri della richiesta
<a name="API_DescribeTask_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.

 ** [TaskArn](#API_DescribeTask_RequestSyntax) **   <a name="DataSync-DescribeTask-request-TaskArn"></a>
Speciifica l'Amazon Resource Name (ARN) dell'attività di trasferimento su cui desideri informazioni.  
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}:task/task-[0-9a-f]{17}$`   
Obbligatorio: sì

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

```
{
   "CloudWatchLogGroupArn": "string",
   "CreationTime": number,
   "CurrentTaskExecutionArn": "string",
   "DestinationLocationArn": "string",
   "DestinationNetworkInterfaceArns": [ "string" ],
   "ErrorCode": "string",
   "ErrorDetail": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "ScheduleDetails": { 
      "DisabledBy": "string",
      "DisabledReason": "string",
      "StatusUpdateTime": number
   },
   "SourceLocationArn": "string",
   "SourceNetworkInterfaceArns": [ "string" ],
   "Status": "string",
   "TaskArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

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

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

 ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CloudWatchLogGroupArn"></a>
L'Amazon Resource Name (ARN) di un gruppo di CloudWatch log Amazon per il monitoraggio delle tue attività.  
Per ulteriori informazioni, consulta [Monitoraggio dei trasferimenti di dati con CloudWatch Logs](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 562.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 

 ** [CreationTime](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CreationTime"></a>
L'ora in cui è stata creata l'attività.  
Tipo: Timestamp

 ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CurrentTaskExecutionArn"></a>
L'ARN dell'esecuzione dell'attività più recente.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [DestinationLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationLocationArn"></a>
L'ARN della località di destinazione del trasferimento.  
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}$` 

 ** [DestinationNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationNetworkInterfaceArns"></a>
Le [interfacce ARNs di rete](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) DataSync create per la località di destinazione.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` 

 ** [ErrorCode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorCode"></a>
Se c'è un problema con la tua attività, puoi utilizzare il codice di errore per aiutarti a risolverlo. Per ulteriori informazioni, consulta [Risoluzione dei problemi relativi ai DataSync trasferimenti](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: String

 ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorDetail"></a>
Se c'è un problema con la tua attività, puoi utilizzare i dettagli dell'errore per aiutarti a risolverlo. Per ulteriori informazioni, consulta [Risoluzione dei problemi relativi ai DataSync trasferimenti](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: String

 ** [Excludes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Excludes"></a>
I filtri di esclusione che definiscono i file, gli oggetti e le cartelle nella posizione di origine che non desideri DataSync trasferire. Per ulteriori informazioni ed esempi, consulta [Specificare i DataSync trasferimenti utilizzando i filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

 ** [Includes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Includes"></a>
Includono filtri che definiscono i file, gli oggetti e le cartelle che si desidera DataSync trasferire nella posizione di origine. Per ulteriori informazioni ed esempi, consulta [Specificare i DataSync trasferimenti utilizzando i filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

 ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ManifestConfig"></a>
La configurazione del manifesto che elenca i file o gli oggetti che si desidera DataSync trasferire. Per ulteriori informazioni, vedere [Specificare quali DataSync trasferimenti utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipo: oggetto [ManifestConfig](API_ManifestConfig.md)

 ** [Name](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Name"></a>
Il nome dell'attività.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Options](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Options"></a>
Le impostazioni dell'attività. Ad esempio, quali metadati dei file vengono conservati, come viene verificata l'integrità dei dati al termine del trasferimento, limiti di larghezza di banda, tra le altre opzioni.  
Tipo: oggetto [Options](API_Options.md)

 ** [Schedule](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Schedule"></a>
La pianificazione del momento in cui desideri che l'attività venga eseguita. Per ulteriori informazioni, vedere [Pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: oggetto [TaskSchedule](API_TaskSchedule.md)

 ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ScheduleDetails"></a>
I dettagli sulla [pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: oggetto [TaskScheduleDetails](API_TaskScheduleDetails.md)

 ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceLocationArn"></a>
L'ARN della posizione di origine del trasferimento.  
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}$` 

 ** [SourceNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceNetworkInterfaceArns"></a>
Le [interfacce ARNs di rete](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) DataSync create per la posizione di origine.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` 

 ** [Status](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Status"></a>
Lo stato dell'attività. Per informazioni sul significato di ogni stato, consulta [Stati delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses)  
Tipo: String  
Valori validi: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` 

 ** [TaskArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskArn"></a>
L'ARN della tua attività.  
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}:task/task-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskMode"></a>
La modalità di attività che stai utilizzando. Per ulteriori informazioni, vedere [Scelta di una modalità di operazione per il trasferimento dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: String  
Valori validi: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskReportConfig"></a>
La configurazione del rapporto sulle attività, che fornisce informazioni dettagliate sul DataSync trasferimento. Per ulteriori informazioni, consulta [Monitoraggio dei DataSync trasferimenti con i report sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md)

## Errori
<a name="API_DescribeTask_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 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

## Esempi
<a name="API_DescribeTask_Examples"></a>

### Richiesta di esempio
<a name="API_DescribeTask_Example_1"></a>

L'esempio seguente specifica l'ARN di DataSync un'attività su cui ottenere informazioni.

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

### Risposta di esempio
<a name="API_DescribeTask_Example_2"></a>

L'esempio seguente mostra una `DescribeTask` risposta.

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026",
  "Name": "MyTask",
  "TaskMode": "BASIC",
  "Status": "RUNNING",
  "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3",
  "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2",
  "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f",
  "CreationTime": 1532660733.39,
  "Options": { 
    "Atime": "BEST_EFFORT",
    "BytesPerSecond": 1000,
    "Gid": "NONE",
    "Mtime": "PRESERVE",
    "PosixPermissions": "PRESERVE",
    "PreserveDevices": "NONE",
    "PreserveDeletedFiles": "PRESERVE",
    "Uid": "NONE",
    "VerifyMode": "POINT_IN_TIME_CONSISTENT"
  },
  "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*"
}
```

## Vedi anche
<a name="API_DescribeTask_SeeAlso"></a>

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

# DescribeTaskExecution
<a name="API_DescribeTaskExecution"></a>

Fornisce informazioni sull'esecuzione dell' AWS DataSync attività. È possibile utilizzare questa operazione per monitorare l'avanzamento di un trasferimento di dati in corso o controllare i risultati del trasferimento.

**Nota**  
Alcuni elementi di `DescribeTaskExecution` risposta sono rilevanti solo per una modalità di operazione specifica. Per informazioni, vedere [Comprensione delle differenze tra le modalità di attività](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) e [Comprensione dei contatori delle prestazioni del trasferimento dati](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html).

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

```
{
   "TaskExecutionArn": "string"
}
```

## Parametri della richiesta
<a name="API_DescribeTaskExecution_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.

 ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **   <a name="DataSync-DescribeTaskExecution-request-TaskExecutionArn"></a>
Specifica l'Amazon Resource Name (ARN) dell'esecuzione dell'attività su cui desideri informazioni.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Obbligatorio: sì

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

```
{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EndTime": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToDelete": number,
   "EstimatedFilesToTransfer": number,
   "EstimatedFoldersToDelete": number,
   "EstimatedFoldersToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesDeleted": number,
   "FilesFailed": { 
      "Delete": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FilesListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FilesPrepared": number,
   "FilesSkipped": number,
   "FilesTransferred": number,
   "FilesVerified": number,
   "FoldersDeleted": number,
   "FoldersFailed": { 
      "Delete": number,
      "List": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FoldersListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FoldersPrepared": number,
   "FoldersSkipped": number,
   "FoldersTransferred": number,
   "FoldersVerified": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "LaunchTime": number,
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "ReportResult": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "Status": "string"
   },
   "Result": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "PrepareDuration": number,
      "PrepareStatus": "string",
      "TotalDuration": number,
      "TransferDuration": number,
      "TransferStatus": "string",
      "VerifyDuration": number,
      "VerifyStatus": "string"
   },
   "StartTime": number,
   "Status": "string",
   "TaskExecutionArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

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

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

 ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesCompressed"></a>
Il numero di byte fisici che vengono DataSync trasferiti sulla rete dopo la compressione (se la compressione è possibile). Questo numero è in genere inferiore [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)a quello a meno che i dati non siano comprimibili.  
Tipo: long

 ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesTransferred"></a>
Il numero di byte DataSync inviati alla rete prima della compressione (se la compressione è possibile). Per il numero di byte trasferiti sulla rete, vedere. [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed)   
Tipo: long

 ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesWritten"></a>
Il numero di byte logici DataSync effettivamente scritti nella posizione di destinazione.  
Tipo: long

 ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EndTime"></a>
L'ora in cui termina l'operazione di trasferimento.  
Tipo: Timestamp

 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedBytesToTransfer"></a>
Il numero di byte logici che DataSync prevede di scrivere nella posizione di destinazione.  
Tipo: long

 ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToDelete"></a>
Il numero di file, oggetti e directory che DataSync prevede di eliminare nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) valore è sempre. `0`  
Per le [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), questo contatore include solo file o oggetti. Le directory vengono conteggiate [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete). 
Tipo: long

 ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToTransfer"></a>
Il numero di file, oggetti e directory che DataSync prevede di trasferire sulla rete. Questo valore viene calcolato durante la DataSync [preparazione del trasferimento.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Il modo in cui viene calcolato dipende principalmente dalla configurazione della [modalità di trasferimento](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) dell'attività:  
+ Se `TranserMode` è impostato su `CHANGED` - Il calcolo si basa sul confronto del contenuto delle posizioni di origine e di destinazione e sulla determinazione della differenza da trasferire. La differenza può includere:
  + Tutto ciò che viene aggiunto o modificato nella posizione di origine.
  + Tutto ciò che si trova in entrambe le posizioni e viene modificato nella destinazione dopo un trasferimento iniziale (a meno che non [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)sia impostato su`NEVER`).
  +  **(Solo modalità attività di base)** Il numero di elementi che DataSync prevede di eliminare (se [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)è impostato su`REMOVE`).
+ Se `TranserMode` è impostato su `ALL` - Il calcolo si basa solo sugli elementi DataSync trovati nella posizione di origine.
Per le [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), questo contatore include solo file o oggetti. Le directory vengono conteggiate [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer). 
Tipo: long

 ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete"></a>
Il numero di cartelle che DataSync prevede di eliminare nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) valore è sempre. `0`  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: long

 ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer"></a>
Il numero di directory che DataSync prevede di trasferire sulla rete. Questo valore viene calcolato per DataSync [preparare le directory da trasferire.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Il modo in cui viene calcolato dipende principalmente dalla configurazione della [modalità di trasferimento](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) dell'attività:  
+ Se `TranserMode` è impostato su `CHANGED` - Il calcolo si basa sul confronto del contenuto delle posizioni di origine e di destinazione e sulla determinazione della differenza da trasferire. La differenza può includere:
  + Tutto ciò che viene aggiunto o modificato nella posizione di origine.
  + Tutto ciò che si trova in entrambe le posizioni e viene modificato nella destinazione dopo un trasferimento iniziale (a meno che non [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)sia impostato su`NEVER`).
+ Se `TranserMode` è impostato su `ALL` - Il calcolo si basa solo sugli elementi che DataSync si trovano nella posizione di origine.
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: long

 ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Excludes"></a>
Un elenco di regole di filtro che escludono dati specifici durante il trasferimento. Per ulteriori informazioni ed esempi, consulta [Filtraggio dei dati trasferiti da DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

 ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesDeleted"></a>
Il numero di file, oggetti e directory DataSync effettivamente eliminati nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) valore è sempre. `0`  
Per le [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), questo contatore include solo file o oggetti. Le directory vengono conteggiate [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted). 
Tipo: long

 ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesFailed"></a>
Il numero di file o oggetti che DataSync non vengono preparati, trasferiti, verificati ed eliminati durante l'esecuzione dell'attività.  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: oggetto [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)

 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesListed"></a>
Il numero di file o oggetti che DataSync si trovano nelle tue posizioni.  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: oggetto [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)

 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesPrepared"></a>
Il numero di file o oggetti che DataSync tenteranno di trasferire dopo aver confrontato le posizioni di origine e di destinazione.  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Questo contatore non è applicabile se si configura l'attività per [trasferire tutti i dati](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). In questo scenario, DataSync copia tutto dall'origine alla destinazione senza confrontare le differenze tra le posizioni.  
Tipo: long

 ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesSkipped"></a>
Il numero di file, oggetti e directory che vengono DataSync ignorati durante il trasferimento.  
Per le [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), questo contatore include solo file o oggetti. Le directory vengono conteggiate [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped). 
Tipo: long

 ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesTransferred"></a>
Il numero di file, oggetti e directory che vengono DataSync effettivamente trasferiti sulla rete. Questo valore viene aggiornato periodicamente durante l'esecuzione dell'attività quando qualcosa viene letto dall'origine e inviato in rete.  
Se DataSync non riesce a trasferire qualcosa, questo valore può essere inferiore a`EstimatedFilesToTransfer`. In alcuni casi, questo valore può anche essere maggiore di`EstimatedFilesToTransfer`. Questo elemento è specifico dell'implementazione per alcuni tipi di posizione, quindi non utilizzatelo come indicazione esatta di ciò che viene trasferito o per monitorare l'esecuzione delle attività.  
Per le [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), questo contatore include solo file o oggetti. Le directory vengono conteggiate [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred). 
Tipo: long

 ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesVerified"></a>
Il numero di file, oggetti e directory che viene DataSync verificato durante il trasferimento.  
Quando configuri l'attività in modo da [verificare solo i dati trasferiti](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync non verifica le directory in alcune situazioni o i file che non vengono trasferiti.  
Per le [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), questo contatore include solo file o oggetti. Le directory vengono conteggiate [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified). 
Tipo: long

 ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersDeleted"></a>
Il numero di cartelle DataSync effettivamente eliminate nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) valore è sempre. `0`  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: long

 ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersFailed"></a>
Il numero di directory che DataSync non vengono elencate, preparate, trasferite, verificate ed eliminate durante l'esecuzione dell'attività.  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: oggetto [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)

 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersListed"></a>
Il numero di cartelle disponibili DataSync nelle tue sedi.  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: oggetto [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)

 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersPrepared"></a>
Il numero di directory che DataSync tenterà di trasferire dopo aver confrontato le posizioni di origine e di destinazione.  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Questo contatore non è applicabile se si configura l'attività per [trasferire tutti i dati](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). In questo scenario, DataSync copia tutto dall'origine alla destinazione senza confrontare le differenze tra le posizioni.  
Tipo: long

 ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersSkipped"></a>
Il numero di cartelle che vengono DataSync ignorate durante il trasferimento.  
Si applica solo alle attività in [modalità Avanzata.](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)
Tipo: long

 ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersTransferred"></a>
Il numero di directory DataSync effettivamente trasferite sulla rete. Questo valore viene aggiornato periodicamente durante l'esecuzione dell'attività quando qualcosa viene letto dall'origine e inviato in rete.  
Se DataSync non riesce a trasferire qualcosa, questo valore può essere inferiore a`EstimatedFoldersToTransfer`. In alcuni casi, questo valore può anche essere maggiore di`EstimatedFoldersToTransfer`.   
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: long

 ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersVerified"></a>
Il numero di cartelle DataSync verificate durante il trasferimento.  
Si applica solo alle attività in [modalità Avanzata.](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)
Tipo: long

 ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Includes"></a>
Un elenco di regole di filtro che includono dati specifici durante il trasferimento. Per ulteriori informazioni ed esempi, consulta [Filtraggio dei dati trasferiti da DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

 ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-LaunchTime"></a>
L'ora in cui inizia effettivamente l'esecuzione dell'attività. Per le attività non in coda, `LaunchTime` e in genere `StartTime` sono le stesse. Per le attività in coda, in genere `LaunchTime` è successivo rispetto al momento in cui le attività precedentemente `StartTime` accodate devono terminare l'esecuzione prima che possano iniziare le nuove attività.  
Tipo: Timestamp

 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ManifestConfig"></a>
La configurazione del manifesto che elenca i file o gli oggetti da trasferire. Per ulteriori informazioni, vedete [Specificare quali DataSync trasferimenti utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipo: oggetto [ManifestConfig](API_ManifestConfig.md)

 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Options"></a>
Indica come è configurata l'attività di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni.  
Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore `LogLevel` per una singola esecuzione.  
Tipo: oggetto [Options](API_Options.md)

 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ReportResult"></a>
Indica se è stato DataSync generato un [rapporto completo sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) per il trasferimento.  
Tipo: oggetto [ReportResult](API_ReportResult.md)

 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Result"></a>
Il risultato dell'esecuzione dell'attività.  
Tipo: oggetto [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)

 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-StartTime"></a>
L'ora in cui DataSync viene inviata la richiesta per avviare l'esecuzione dell'attività. Per le attività non in coda, `LaunchTime` e in genere `StartTime` sono le stesse. Per le attività in coda, in genere `LaunchTime` è successivo rispetto al momento in cui le attività precedentemente `StartTime` accodate devono terminare l'esecuzione prima che possano iniziare le nuove attività.  
Tipo: Timestamp

 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Status"></a>
Lo stato dell'esecuzione dell'attività.   
Per informazioni dettagliate sugli stati di esecuzione delle attività, vedere Stati di [esecuzione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipo: String  
Valori validi: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` 

 ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskExecutionArn"></a>
L'ARN dell'esecuzione dell'attività su cui volevi informazioni. `TaskExecutionArn`è gerarchico e include `TaskArn` l'operazione che è stata eseguita.   
Ad esempio, un `TaskExecution` valore con ARN ha `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` eseguito l'operazione con l'ARN. `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`   
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskMode"></a>
La modalità di attività che stai utilizzando. Per ulteriori informazioni, vedere [Scelta di una modalità di operazione per il trasferimento dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: String  
Valori validi: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskReportConfig"></a>
La configurazione del rapporto sulle attività, che fornisce informazioni dettagliate sul DataSync trasferimento. Per ulteriori informazioni, vedere [Creazione di un rapporto sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md)

## Errori
<a name="API_DescribeTaskExecution_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 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

## Esempi
<a name="API_DescribeTaskExecution_Examples"></a>

### Richiesta di esempio
<a name="API_DescribeTaskExecution_Example_1"></a>

Questo esempio illustra una richiesta. `DescribeTaskExecution`

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1"
}
```

### Esempio di risposta 1 per l'esecuzione di un'attività in modalità avanzata
<a name="API_DescribeTaskExecution_Example_2"></a>

L'esempio seguente descrive un'esecuzione di DataSync attività che utilizza la modalità avanzata. L'esecuzione trasferisce anche dati specifici utilizzando i filtri di esclusione e inclusione.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "BASIC",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/archive-files"
    }],
    "Includes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/files"
    }],
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "EstimatedFilesToTransfer": 7,
    "EstimatedFoldersToTransfer": 2,
    "EstimatedBytesToTransfer": 30,
    "FilesTransferred": 7,
    "FoldersTransferred": 2,
    "BytesWritten": 30,
    "BytesTransferred": 30,
    "BytesCompressed": 30,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3310,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 7,
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 7,
    "FilesListed": {
        "AtSource": 7,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 2,
    "FoldersPrepared": 2,
    "FoldersListed": {
        "AtSource": 2,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
}
```

### Sample Response 2 per un'esecuzione di attività in modalità avanzata
<a name="API_DescribeTaskExecution_Example_3"></a>

L'esempio seguente descrive l'esecuzione di un'altra DataSync attività che utilizza la modalità Enhanced. In questa situazione, l'esecuzione consiste nel trasferire dati specifici utilizzando un manifesto anziché filtri.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "TRANSFER",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [],
    "Includes": [],
    "ManifestConfig": {
        "Action": "TRANSFER",
        "Format": "CSV",
        "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess",
        "S3Bucket": "arn:aws:s3:::manifests-datasync",
        "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG",
        "Source": {
            "S3": {
                "ManifestObjectPath": "manifest-folder/manifest-versioned-files",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess",
                "S3BucketArn": "arn:aws:s3:::manifests-datasync",
                "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG"
            }
        }
    },
    "StartTime": "2024-10-16T09:29:56.757000-04:00",
    "EstimatedFilesToTransfer": 1,
    "EstimatedFoldersToTransfer": 0,
    "EstimatedBytesToTransfer": 6,
    "FilesTransferred": 1,
    "FoldersTransferred": 1,
    "BytesWritten": 6,
    "BytesTransferred": 6,
    "BytesCompressed": 6,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3089,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "Subdirectory": "reports/",
                "S3BucketArn": "arn:aws:s3:::my-task-report",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess"
            }
        },
        "OutputType": "STANDARD",
        "ReportLevel": "SUCCESSES_AND_ERRORS",
        "ObjectVersionIds": "INCLUDE"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 1,
    "ReportResult": {
        "Status": "SUCCESS"
    },
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 1,
    "FilesListed": {
        "AtSource": 1,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 0,
    "FoldersPrepared": 0,
    "FoldersListed": {
        "AtSource": 0,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
  }
```

### Esempio di risposta per l'esecuzione di un task in modalità Basic
<a name="API_DescribeTaskExecution_Example_4"></a>

L'esempio seguente descrive l'esecuzione di un' DataSync attività che utilizza la modalità Basic.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "BytesCompressed": 3500,
    "BytesTransferred": 5000,
    "BytesWritten": 5000,
    "EstimatedBytesToTransfer": 5000,
    "EstimatedFilesToDelete": 10,
    "EstimatedFilesToTransfer": 100,
    "FilesDeleted": 10,
    "FilesSkipped": 0,
    "FilesTransferred": 100,
    "FilesVerified": 100,
    "Result": {
        "PrepareDuration": 100,
        "PrepareStatus": "SUCCESS",
        "TransferDuration": 60,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 30,
        "VerifyStatus": "SUCCESS"
    },
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "Status": "SUCCESS",
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": "1000",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role",
                "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*",
                "Subdirectory": "reports"
            }
        },
        "ObjectVersionIds": "INCLUDE",
        "OutputType": "STANDARD",
        "Overrides": {
            "Deleted": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Skipped": {
                "ReportLevel": "SUCCESSES_AND_ERRORS"
            },
            "Transferred": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Verified": {
                "ReportLevel": "ERRORS_ONLY"
            }
        },
        "ReportLevel": "ERRORS_ONLY"
    }
}
```

## Vedi anche
<a name="API_DescribeTaskExecution_SeeAlso"></a>

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

# ListAgents
<a name="API_ListAgents"></a>

Restituisce un elenco di AWS DataSync agenti che appartengono Account AWS a uno dei Regione AWS specificati nella richiesta.

Con l'impaginazione, è possibile ridurre il numero di agenti restituiti in una risposta. Se in una risposta viene visualizzato un elenco troncato di agenti, la risposta contiene un indicatore che è possibile specificare nella richiesta successiva per recuperare la pagina successiva di agenti.

 `ListAgents`alla fine è coerente. Ciò significa che il risultato dell'esecuzione dell'operazione potrebbe non rispecchiare la creazione o l'eliminazione di un agente da parte dell'utente. Ad esempio, se si crea un agente con [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)e poi lo si esegue immediatamente`ListAgents`, tale agente potrebbe non comparire immediatamente nell'elenco. In situazioni come questa, puoi sempre confermare se un agente è stato creato (o eliminato) utilizzando [DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html).

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

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parametri della richiesta
<a name="API_ListAgents_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.

 ** [MaxResults](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-MaxResults"></a>
Speciifica il numero massimo di DataSync agenti da elencare in una risposta. Per impostazione predefinita, una risposta mostra un massimo di 100 agenti.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-NextToken"></a>
Specifica una stringa opaca che indica la posizione in cui iniziare l'elenco successivo di risultati nella risposta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+`   
Obbligatorio: no

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

```
{
   "Agents": [ 
      { 
         "AgentArn": "string",
         "Name": "string",
         "Platform": { 
            "Version": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [Agents](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-Agents"></a>
Un elenco degli DataSync agenti presenti nel tuo account come Regione AWS specificato Account AWS nella richiesta. L'elenco è ordinato in base agli Amazon Resource Names () ARNs degli agenti.  
Tipo: matrice di oggetti [AgentListEntry](API_AgentListEntry.md)

 ** [NextToken](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-NextToken"></a>
La stringa opaca che indica la posizione in cui iniziare l'elenco successivo di risultati nella risposta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+` 

## Errori
<a name="API_ListAgents_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_ListAgents_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/ListAgents) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) 

# ListLocations
<a name="API_ListLocations"></a>

Restituisce un elenco di posizioni di origine e destinazione.

Se hai più sedi di quelle restituite in una risposta (ovvero, la risposta restituisce solo un elenco troncato dei tuoi agenti), la risposta contiene un token che puoi specificare nella tua richiesta successiva per recuperare la pagina successiva di sedi.

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

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parametri della richiesta
<a name="API_ListLocations_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.

 ** [Filters](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-Filters"></a>
Puoi utilizzare i filtri API per restringere l'elenco delle risorse restituite da. `ListLocations` Ad esempio, per recuperare tutte le attività in una posizione di origine specifica, è possibile utilizzare `ListLocations` with filter name `LocationType S3` and`Operator Equals`.  
Tipo: matrice di oggetti [LocationFilter](API_LocationFilter.md)  
Obbligatorio: no

 ** [MaxResults](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-MaxResults"></a>
Il numero massimo di posizioni da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-NextToken"></a>
Una stringa opaca che indica la posizione da cui iniziare il successivo elenco di posizioni.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+`   
Obbligatorio: no

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

```
{
   "Locations": [ 
      { 
         "LocationArn": "string",
         "LocationUri": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [Locations](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-Locations"></a>
Un array che contiene un elenco di posizioni.  
Tipo: matrice di oggetti [LocationListEntry](API_LocationListEntry.md)

 ** [NextToken](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-NextToken"></a>
Una stringa opaca che indica la posizione da cui iniziare a restituire l'elenco successivo di posizioni.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+` 

## Errori
<a name="API_ListLocations_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_ListLocations_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/ListLocations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Restituisce tutti i tag associati a una AWS risorsa.

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

```
{
   "MaxResults": number,
   "NextToken": "string",
   "ResourceArn": "string"
}
```

## Parametri della richiesta
<a name="API_ListTagsForResource_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.

 ** [MaxResults](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-MaxResults"></a>
Specificare il numero di risultati che si desidera ottenere nella risposta.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-NextToken"></a>
Specifica una stringa opaca che indica la posizione in cui iniziare l'elenco successivo di risultati nella risposta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+`   
Obbligatorio: no

 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-ResourceArn"></a>
Specifica l'Amazon Resource Name (ARN) della risorsa su cui desideri inserire le informazioni relative ai tag.  
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}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
Obbligatorio: sì

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

```
{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-NextToken"></a>
La stringa opaca che indica la posizione in cui iniziare il successivo elenco di risultati nella risposta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+` 

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-Tags"></a>
Una matrice di tag applicata alla risorsa specificata.  
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 55 elementi.

## Errori
<a name="API_ListTagsForResource_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 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
<a name="API_ListTagsForResource_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/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) 

# ListTaskExecutions
<a name="API_ListTaskExecutions"></a>

Restituisce un elenco di esecuzioni per un'attività di AWS DataSync trasferimento.

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

```
{
   "MaxResults": number,
   "NextToken": "string",
   "TaskArn": "string"
}
```

## Parametri della richiesta
<a name="API_ListTaskExecutions_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.

 ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-MaxResults"></a>
Specificate il numero di risultati che desiderate ottenere nella risposta.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-NextToken"></a>
Specifica una stringa opaca che indica la posizione da cui iniziare il successivo elenco di risultati nella risposta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+`   
Obbligatorio: no

 ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-TaskArn"></a>
Specifica l'Amazon Resource Name (ARN) dell'attività su cui desideri informazioni sull'esecuzione.  
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}:task/task-[0-9a-f]{17}$`   
Obbligatorio: no

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

```
{
   "NextToken": "string",
   "TaskExecutions": [ 
      { 
         "Status": "string",
         "TaskExecutionArn": "string",
         "TaskMode": "string"
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-NextToken"></a>
La stringa opaca che indica la posizione da cui iniziare il successivo elenco di risultati nella risposta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+` 

 ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-TaskExecutions"></a>
Un elenco delle esecuzioni dell'attività.  
Tipo: matrice di oggetti [TaskExecutionListEntry](API_TaskExecutionListEntry.md)

## Errori
<a name="API_ListTaskExecutions_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 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
<a name="API_ListTaskExecutions_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/ListTaskExecutions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) 

# ListTasks
<a name="API_ListTasks"></a>

Restituisce un elenco delle AWS DataSync attività che hai creato.

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

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parametri della richiesta
<a name="API_ListTasks_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.

 ** [Filters](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-Filters"></a>
Puoi utilizzare i filtri API per restringere l'elenco delle risorse restituite da`ListTasks`. Ad esempio, per recuperare tutte le attività su una posizione di origine specifica, è possibile utilizzare `ListTasks` con il nome del filtro `LocationId` e `Operator Equals` con l'ARN per la posizione.  
Tipo: matrice di oggetti [TaskFilter](API_TaskFilter.md)  
Obbligatorio: no

 ** [MaxResults](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-MaxResults"></a>
Il numero massimo di attività da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0. valore massimo pari a 100.  
Obbligatorio: no

 ** [NextToken](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-NextToken"></a>
Una stringa opaca che indica la posizione da cui iniziare l'elenco successivo di attività.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+`   
Obbligatorio: no

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

```
{
   "NextToken": "string",
   "Tasks": [ 
      { 
         "Name": "string",
         "Status": "string",
         "TaskArn": "string",
         "TaskMode": "string"
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-NextToken"></a>
Una stringa opaca che indica la posizione da cui iniziare a restituire l'elenco successivo di attività.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 65535.  
Modello: `[a-zA-Z0-9=_-]+` 

 ** [Tasks](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-Tasks"></a>
Un elenco di tutte le attività restituite.  
Tipo: matrice di oggetti [TaskListEntry](API_TaskListEntry.md)

## Errori
<a name="API_ListTasks_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 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
<a name="API_ListTasks_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/ListTasks) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) 

# StartTaskExecution
<a name="API_StartTaskExecution"></a>

Avvia un'operazione AWS DataSync di trasferimento. Per ogni attività, è possibile eseguire una sola operazione alla volta.

L'esecuzione di un'attività prevede diversi passaggi. Per ulteriori informazioni, vedere [Stati di esecuzione delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses)

**Importante**  
Se hai intenzione di trasferire dati da o verso una sede Amazon S3, consulta in che [modo DataSync possono influire sui costi delle richieste S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) e sulla [pagina dei DataSync prezzi](https://aws.amazon.com/datasync/pricing/) prima di iniziare.

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

```
{
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "OverrideOptions": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskArn": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## Parametri della richiesta
<a name="API_StartTaskExecution_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.

 ** [Excludes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Excludes"></a>
Specifica un elenco di regole di filtro che determina quali file escludere da un'attività. L'elenco contiene una singola stringa di filtro costituita dai modelli da escludere. I modelli sono delimitati da "\$1" (cioè una barra verticale), ad esempio: `"/folder1|/folder2"`.   
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: no

 ** [Includes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Includes"></a>
Specifica un elenco di regole di filtro che determina quali file includere durante l'esecuzione di un'attività. Il modello deve contenere una singola stringa di filtro costituita dai modelli da includere. I modelli sono delimitati da "\$1" (cioè una barra verticale), ad esempio: `"/folder1|/folder2"`.   
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: no

 ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-ManifestConfig"></a>
Configura un manifesto, che è un elenco di file o oggetti che si desidera DataSync trasferire. Per ulteriori informazioni ed esempi di configurazione, vedere [Specificazione degli elementi da DataSync trasferire utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Quando si utilizza questo parametro, l'identità del chiamante (il ruolo DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione.  
Per rimuovere una configurazione del manifesto, specificate questo parametro con un valore vuoto.  
Tipo: oggetto [ManifestConfig](API_ManifestConfig.md)  
Obbligatorio: no

 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-OverrideOptions"></a>
Indica come è configurata l'attività di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni.  
Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore `LogLevel` per una singola esecuzione.  
Tipo: oggetto [Options](API_Options.md)  
Obbligatorio: no

 ** [Tags](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Tags"></a>
Speciifica i tag da applicare all'Amazon Resource Name (ARN) che rappresenta l'esecuzione dell'attività.  
 I *tag* sono coppie chiave-valore che ti aiutano a gestire, filtrare e cercare le tue risorse. DataSync   
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskArn"></a>
Specifica l'Amazon Resource Name (ARN) dell'attività che desideri avviare.  
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}:task/task-[0-9a-f]{17}$`   
Obbligatorio: sì

 ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskReportConfig"></a>
Specifica come desideri configurare un report sulle attività, che fornisce informazioni dettagliate sul trasferimento. DataSync Per ulteriori informazioni, consulta [Monitoraggio dei DataSync trasferimenti con i report sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Quando si utilizza questo parametro, l'identità del chiamante (il ruolo DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione.  
Per rimuovere la configurazione di un report di attività, specificate questo parametro come vuoto.  
Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md)  
Obbligatorio: no

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

```
{
   "TaskExecutionArn": "string"
}
```

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

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

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

 ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) **   <a name="DataSync-StartTaskExecution-response-TaskExecutionArn"></a>
L'ARN dell'esecuzione dell'attività in esecuzione.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

## Errori
<a name="API_StartTaskExecution_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 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

## Esempi
<a name="API_StartTaskExecution_Examples"></a>

### Richiesta di esempio
<a name="API_StartTaskExecution_Example_1"></a>

L'esempio seguente avvia l'esecuzione di un'attività utilizzando le opzioni predefinite per l'attività specificata.

```
{
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": 1000,
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

### Risposta di esempio
<a name="API_StartTaskExecution_Example_2"></a>

Questo esempio illustra un utilizzo di. StartTaskExecution

```
{
  "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}
```

## Vedi anche
<a name="API_StartTaskExecution_SeeAlso"></a>

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

# TagResource
<a name="API_TagResource"></a>

Applica un *tag* a una AWS risorsa. I tag sono coppie chiave-valore che possono aiutarti a gestire, filtrare e cercare le tue risorse.

Questi includono AWS DataSync risorse, come ubicazioni, attività ed esecuzioni di attività.

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

```
{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_TagResource_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.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-ResourceArn"></a>
Speciifica l'Amazon Resource Name (ARN) della risorsa a cui applicare il tag.  
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}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
Obbligatorio: sì

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-Tags"></a>
Speciifica i tag che desideri applicare alla risorsa.  
Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_TagResource_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 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
<a name="API_TagResource_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/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Rimuove i tag da una AWS risorsa.

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

```
{
   "Keys": [ "string" ],
   "ResourceArn": "string"
}
```

## Parametri della richiesta
<a name="API_UntagResource_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.

 ** [Keys](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-Keys"></a>
Specificate le chiavi nei tag che desiderate rimuovere.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:/-]+$`   
Obbligatorio: sì

 ** [ResourceArn](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-ResourceArn"></a>
Speciifica l'Amazon Resource Name (ARN) della risorsa da cui rimuovere i tag.  
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}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UntagResource_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_UntagResource_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/UntagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) 

# UpdateAgent
<a name="API_UpdateAgent"></a>

Aggiorna il nome di un AWS DataSync agente.

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

```
{
   "AgentArn": "string",
   "Name": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateAgent_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.

 ** [AgentArn](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-AgentArn"></a>
L'Amazon Resource Name (ARN) dell'agente da aggiornare.  
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}:agent/agent-[0-9a-z]{17}$`   
Obbligatorio: sì

 ** [Name](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-Name"></a>
Il nome che desideri utilizzare per configurare l'agente.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateAgent_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 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
<a name="API_UpdateAgent_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/UpdateAgent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) 

# UpdateLocationAzureBlob
<a name="API_UpdateLocationAzureBlob"></a>

Modifica le seguenti configurazioni della posizione di trasferimento di Microsoft Azure Blob Storage con cui stai usando. AWS DataSync

Per ulteriori informazioni, vedere [Configurazione dei DataSync trasferimenti](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html) con Azure Blob Storage.

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

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SasConfiguration": { 
      "Token": "string"
   },
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationAzureBlob_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_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-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_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-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).  
Non è possibile aggiungere o rimuovere agenti da una posizione di archiviazione dopo averla creata inizialmente.
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_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-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`   
Campo obbligatorio: no

 ** [BlobType](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-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_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CustomSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-LocationArn"></a>
Speciifica l'ARN della posizione di trasferimento di Azure Blob Storage che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-SasConfiguration"></a>
Speciifica la configurazione SAS che consente di accedere DataSync al tuo Azure Blob Storage.  
Tipo: oggetto [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)  
Obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-Subdirectory"></a>
Specifica i segmenti di percorso se desideri limitare il trasferimento a una directory virtuale nel 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

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationAzureBlob_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_UpdateLocationAzureBlob_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/UpdateLocationAzureBlob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) 

# UpdateLocationEfs
<a name="API_UpdateLocationEfs"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Amazon EFS con AWS DataSync cui stai utilizzando.

Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti con Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html).

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

```
{
   "AccessPointArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationEfs_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.

 ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-AccessPointArn"></a>
Speciifica l'Amazon Resource Name (ARN) del punto di accesso utilizzato per DataSync montare il file system Amazon EFS.  
Per ulteriori informazioni, consulta [Accesso ai file system Amazon EFS con restrizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$)|(^$)`   
Obbligatorio: no

 ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-FileSystemAccessRoleArn"></a>
Specifica un ruolo AWS Identity and Access Management (IAM) che consente di accedere DataSync al file system Amazon EFS.  
Per informazioni sulla creazione di questo ruolo, consulta [Creazione di un ruolo DataSync IAM per l'accesso al file system Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)`   
Obbligatorio: no

 ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-InTransitEncryption"></a>
Specifica se desideri DataSync utilizzare la crittografia Transport Layer Security (TLS) 1.2 quando trasferisce dati da o verso il tuo file system Amazon EFS.  
Se specifichi un punto di accesso utilizzando `AccessPointArn` o un ruolo IAM utilizzando `FileSystemAccessRoleArn`, è necessario impostare questo parametro su `TLS1_2`.  
Tipo: String  
Valori validi: `NONE | TLS1_2`   
Campo obbligatorio: no

 ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione di trasferimento Amazon EFS che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-Subdirectory"></a>
Specifica un percorso di montaggio per il tuo file system Amazon EFS. È qui che DataSync legge o scrive i dati sul tuo file system (a seconda che si tratti di una posizione di origine o di destinazione).  
Per impostazione predefinita, DataSync utilizza la directory principale (o il [punto di accesso](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html), se fornito utilizzando`AccessPointArn`). È inoltre possibile includere sottodirectory utilizzando barre (ad esempio,). `/path/to/folder`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationEfs_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_UpdateLocationEfs_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/UpdateLocationEfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) 

# UpdateLocationFsxLustre
<a name="API_UpdateLocationFsxLustre"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Amazon FSx for Lustre con cui stai utilizzando. AWS DataSync

Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti con FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html) for Lustre.

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

```
{
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationFsxLustre_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.

 ** [LocationArn](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) FSx della posizione di trasferimento for Lustre che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-Subdirectory"></a>
Speciifica un percorso di montaggio per il file system FSx for Lustre. Il percorso può includere sottodirectory.  
Quando la posizione viene utilizzata come fonte, DataSync legge i dati dal percorso di montaggio. Quando la posizione viene utilizzata come destinazione, DataSync scrive i dati nel percorso di montaggio. Se non includete questo parametro, DataSync utilizza la directory principale del file system (`/`).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationFsxLustre_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_UpdateLocationFsxLustre_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/UpdateLocationFsxLustre) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) 

# UpdateLocationFsxOntap
<a name="API_UpdateLocationFsxOntap"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Amazon FSx for NetApp ONTAP con cui stai utilizzando. AWS DataSync

Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti con FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html) for ONTAP.

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

```
{
   "LocationArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationFsxOntap_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.

 ** [LocationArn](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) FSx della posizione di trasferimento for ONTAP che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Protocol"></a>
Speciifica il protocollo di trasferimento dati DataSync utilizzato per accedere al tuo FSx file system Amazon.  
Tipo: oggetto [FsxUpdateProtocol](API_FsxUpdateProtocol.md)  
Obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Subdirectory"></a>
Speciifica il percorso della condivisione di file nella macchina virtuale di archiviazione (SVM) da cui desideri trasferire i dati.  
Puoi specificare un percorso di giunzione (detto anche punto di montaggio), un percorso qtree (per condivisioni di file NFS) o un nome condivisione (per condivisioni di file SMB). Ad esempio, il percorso di montaggio potrebbe essere `/vol1`, `/vol1/tree1`, o `/share1`.  
Non specificare un percorso di giunzione nel volume radice dell'SVM. Per ulteriori informazioni, consulta [Managing FSx for ONTAP Storage Virtual Machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) nella *Amazon FSx for NetApp ONTAP User Guide*.
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 255.  
Modello: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationFsxOntap_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_UpdateLocationFsxOntap_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/UpdateLocationFsxOntap) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) 

# UpdateLocationFsxOpenZfs
<a name="API_UpdateLocationFsxOpenZfs"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Amazon FSx for OpenZFS con cui stai utilizzando. AWS DataSync

Per maggiori informazioni, consulta [Configurazione dei DataSync trasferimenti](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html) con per OpenZFS. FSx 

**Nota**  
I parametri di richiesta relativi a `SMB` non sono supportati dall'operazione. `UpdateLocationFsxOpenZfs`

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

```
{
   "LocationArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationFsxOpenZfs_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.

 ** [LocationArn](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) FSx della posizione di trasferimento per OpenZFS che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Protocol"></a>
Speciifica il protocollo di trasferimento dati AWS DataSync utilizzato per accedere al tuo FSx file system Amazon.  
Tipo: oggetto [FsxProtocol](API_FsxProtocol.md)  
Obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Subdirectory"></a>
Speciifica una sottodirectory nel percorso della posizione che deve iniziare con. `/fsx` DataSync utilizza questa sottodirectory per leggere o scrivere dati (a seconda che il file system sia una posizione di origine o di destinazione).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationFsxOpenZfs_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_UpdateLocationFsxOpenZfs_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/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 

# UpdateLocationFsxWindows
<a name="API_UpdateLocationFsxWindows"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento di Amazon FSx for Windows File Server con AWS DataSync cui stai utilizzando.

Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti con FSx per Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html).

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

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "LocationArn": "string",
   "Password": "string",
   "Subdirectory": "string",
   "User": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationFsxWindows_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.

 ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CustomSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `Password` set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Domain"></a>
Speciifica il nome del dominio Windows a cui appartiene il file system FSx per Windows File Server.  
Se nell'ambiente sono presenti più domini Active Directory, la configurazione di questo parametro assicura la DataSync connessione al file system corretto.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
Obbligatorio: no

 ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-LocationArn"></a>
Speciifica l'ARN FSx della posizione di trasferimento per Windows File Server che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Password"></a>
Speciifica la password dell'utente con le autorizzazioni per montare e accedere a file, cartelle e metadati dei file nel file system FSx per Windows File Server.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^.{0,104}$`   
Obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Subdirectory"></a>
Specificate un percorso di montaggio per il file system utilizzando barre. DataSync utilizza questa sottodirectory per leggere o scrivere dati (a seconda che il file system sia una posizione di origine o di destinazione).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

 ** [User](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-User"></a>
Speciifica l'utente con le autorizzazioni per montare e accedere a file, cartelle e metadati dei file nel file system FSx per Windows File Server.  
Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta le [autorizzazioni richieste FSx per le posizioni](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) dei file server di Windows.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationFsxWindows_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_UpdateLocationFsxWindows_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/UpdateLocationFsxWindows) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) 

# UpdateLocationHdfs
<a name="API_UpdateLocationHdfs"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Hadoop Distributed File System (HDFS) con cui stai utilizzando. AWS DataSync

Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html) con un cluster HDFS.

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationHdfs_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.

 ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AgentArns"></a>
Gli Amazon Resource Names (ARNs) degli DataSync agenti che possono connettersi al tuo cluster HDFS.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AuthenticationType"></a>
Il tipo di autenticazione utilizzato per determinare l'identità dell'utente.   
Tipo: String  
Valori validi: `SIMPLE | KERBEROS`   
Campo obbligatorio: no

 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-BlockSize"></a>
La dimensione dei blocchi di dati da scrivere nel cluster HDFS.   
Tipo: numero intero  
Intervallo valido: valore minimo di 1048576. Valore massimo di 1073741824.  
Obbligatorio: no

 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CmkSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un set di credenziali da DataSync utilizzare per accedere a una `KerberosKeytab` posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CustomSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `KerberosKeytab` set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKeytab"></a>
La tabella delle chiavi Kerberos (keytab) che contiene le mappature tra il principali Kerberos definiti e le chiavi crittografate. È possibile caricare il keytab da un file fornendo l'indirizzo del file.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 65536.  
Obbligatorio: no

 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKrb5Conf"></a>
Il file `krb5.conf` che contiene le informazioni di configurazione di Kerberos. È possibile caricare il `krb5.conf` file fornendo l'indirizzo del file. Se stai usando AWS CLI, esegue la codifica base64 per te. Altrimenti, fornisci il testo con codifica base64.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 131072.  
Obbligatorio: no

 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosPrincipal"></a>
Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$`   
Obbligatorio: no

 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KmsKeyProviderUri"></a>
L'URI del Key Management Server (KMS) del cluster HDFS.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
Obbligatorio: no

 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione del cluster HDFS di origine.  
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}$`   
Obbligatorio: sì

 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-NameNodes"></a>
Il NameNode che gestisce lo spazio dei nomi HDFS. NameNode Esegue operazioni come l'apertura, la chiusura e la ridenominazione di file e directory. NameNode Contiene le informazioni per mappare blocchi di dati su. DataNodes È possibile utilizzarne solo uno NameNode.  
Tipo: matrice di oggetti [HdfsNameNode](API_HdfsNameNode.md)  
Membri dell’array: numero minimo di 1 elemento.  
Obbligatorio: no

 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-QopConfiguration"></a>
La configurazione QOP (Quality of Protection) specifica le impostazioni di privacy per le chiamate di procedura remota (RPC, Remote Procedure Call) e per il trasferimento dati configurate nel cluster del file system distribuito Hadoop (HDFS).   
Tipo: oggetto [QopConfiguration](API_QopConfiguration.md)  
Obbligatorio: no

 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-ReplicationFactor"></a>
Il numero DataNodes su cui replicare i dati durante la scrittura sul cluster HDFS.   
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 512.  
Obbligatorio: no

 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-SimpleUser"></a>
Il nome utente utilizzato per identificare il client sul sistema operativo host.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-Subdirectory"></a>
Una sottodirectory nel cluster HDFS. Questa sottodirectory viene utilizzata per leggere i dati da o scrivere i dati sul cluster HDFS.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationHdfs_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_UpdateLocationHdfs_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/UpdateLocationHdfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) 

# UpdateLocationNfs
<a name="API_UpdateLocationNfs"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Network File System (NFS) con cui si sta utilizzando. AWS DataSync

Per ulteriori informazioni, consulta [Configurazione dei trasferimenti con un file server NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html).

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

```
{
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationNfs_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.

 ** [LocationArn](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione di trasferimento NFS che desideri aggiornare.  
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}$`   
Obbligatorio: sì

 ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-MountOptions"></a>
Speciifica come DataSync accedere a una posizione utilizzando il protocollo NFS.  
Tipo: oggetto [NfsMountOptions](API_NfsMountOptions.md)  
Obbligatorio: no

 ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-OnPremConfig"></a>
Gli AWS DataSync agenti che possono connettersi al file server Network File System (NFS).  
Tipo: oggetto [OnPremConfig](API_OnPremConfig.md)  
Obbligatorio: no

 ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-ServerHostname"></a>
Speciifica il nome DNS o l'indirizzo IP (IPv4 o IPv6) del file server NFS 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: no

 ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-Subdirectory"></a>
Specificate il percorso di esportazione nel file server NFS che desiderate montare. DataSync   
Questo percorso (o una sottodirectory del percorso) è il luogo in cui vengono DataSync trasferiti i dati da o verso. Per informazioni sulla configurazione di un'esportazione per DataSync, consultate [Accesso ai file server NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationNfs_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_UpdateLocationNfs_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/UpdateLocationNfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) 

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento dell'archiviazione degli oggetti con AWS DataSync cui si sta utilizzando.

Per ulteriori informazioni, vedere [Configurazione dei DataSync trasferimenti con un sistema di storage di oggetti](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

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

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationObjectStorage_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.

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
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](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(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.  
Non è possibile aggiungere o rimuovere agenti da una posizione di archiviazione dopo averla creata inizialmente.
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

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
Specifica l'ARN della posizione del sistema di storage degli oggetti che si sta aggiornando.  
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}$`   
Obbligatorio: sì

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
Specifica la chiave segreta (ad esempio, una password) se sono necessarie credenziali per l'autenticazione con il server di storage di oggetti.  
Se fornisci un segreto utilizzando`SecretKey`, ma non fornisci dettagli di configurazione segreti utilizzando `CmkSecretConfig` o`CustomSecretConfig`, 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](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
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 su`HTTPS`.  
L'aggiornamento di questo parametro non interferisce con le attività in corso.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 32768.  
Obbligatorio: no

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
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: no

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
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](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Specifica il protocollo utilizzato dal server di storage di oggetti per comunicare.  
Tipo: String  
Valori validi: `HTTPS | HTTP`   
Campo obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
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

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationObjectStorage_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_UpdateLocationObjectStorage_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/UpdateLocationObjectStorage) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) 

# UpdateLocationS3
<a name="API_UpdateLocationS3"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Amazon S3 con cui stai utilizzando. AWS DataSync

**Importante**  
Prima di iniziare, assicurati di leggere i seguenti argomenti:  
 [Considerazioni sulla classe di storage con le sedi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Valutazione dei costi delle richieste S3 durante l'utilizzo DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

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

```
{
   "LocationArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationS3_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.

 ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione di trasferimento Amazon S3 che stai aggiornando.  
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}$`   
Obbligatorio: sì

 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3Config"></a>
Speciifica l'Amazon Resource Name (ARN) AWS Identity and Access Management del ruolo DataSync (IAM) utilizzato per accedere al bucket S3.  
Per ulteriori informazioni, consulta [Fornire l' DataSync accesso ai](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access) bucket S3.  
Tipo: oggetto [S3Config](API_S3Config.md)  
Obbligatorio: no

 ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3StorageClass"></a>
Speciifica la classe di storage che desideri che i tuoi oggetti utilizzino quando Amazon S3 è una destinazione di trasferimento.  
Per i bucket in Regioni AWS, la classe di storage predefinita è. `STANDARD` Per i bucket attivi AWS Outposts, la classe di archiviazione ha come impostazione predefinita. `OUTPOSTS`  
Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con i trasferimenti Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: String  
Valori validi: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Campo obbligatorio: no

 ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-Subdirectory"></a>
Speciifica un prefisso nel bucket S3 da cui eseguire la DataSync lettura o la scrittura (a seconda che il bucket sia una posizione di origine o di destinazione).  
DataSync non può trasferire oggetti con un prefisso che inizia con una barra () `/` o include o pattern. `//` `/./` `/../` Esempio:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationS3_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_UpdateLocationS3_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/UpdateLocationS3) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) 

# UpdateLocationSmb
<a name="API_UpdateLocationSmb"></a>

Modifica i seguenti parametri di configurazione della posizione di trasferimento Server Message Block (SMB) con cui stai utilizzando. AWS DataSync

Per ulteriori informazioni, consulta [Configurazione dei DataSync trasferimenti con un file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html).

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "Password": "string",
   "ServerHostname": "string",
   "Subdirectory": "string",
   "User": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateLocationSmb_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.

 ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AgentArns"></a>
Speciifica l' DataSync agente (o gli agenti) che possono connettersi al file server SMB. Specifichi un agente utilizzando il relativo Amazon Resource Name (ARN).  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AuthenticationType"></a>
Speciifica il protocollo di autenticazione DataSync utilizzato per connettersi al file server SMB. DataSync supporta `NTLM` (impostazione predefinita) e `KERBEROS` autenticazione.  
Per ulteriori informazioni, vedere [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: String  
Valori validi: `NTLM | KERBEROS`   
Campo obbligatorio: no

 ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` or `KerberosKeytab` o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CustomSecretConfig"></a>
Speciifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `Password` or `KerberosKeytab` o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-DnsIpAddresses"></a>
Speciifica gli indirizzi IP (IPv4 o IPv6) per i server DNS a cui appartiene il file server SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su. `KERBEROS`  
Se nell'ambiente sono presenti più domini, la configurazione di questo parametro assicura la DataSync connessione al file server SMB corretto.   
Tipo: array di stringhe  
Membri della matrice: numero massimo di 2 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 7. Lunghezza massima di 39.  
Modello: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z`   
Obbligatorio: no

 ** [Domain](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Domain"></a>
Specifica il nome dominio di Windows a cui appartiene il server di file SMB. Questo parametro si applica solo se `AuthenticationType` è impostato su`NTLM`.  
Se nell'ambiente sono presenti più domini, la configurazione di questo parametro assicura la DataSync connessione al file server corretto.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obbligatorio: no

 ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKeytab"></a>
Speciifica il file della tabella delle chiavi Kerberos (keytab), che include le mappature tra la chiave principale Kerberos e la chiave di crittografia.  
Per evitare errori di esecuzione delle attività, assicurati che il principale Kerberos utilizzato per creare il file keytab corrisponda esattamente a quello specificato. `KerberosPrincipal`  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 65536.  
Obbligatorio: no

 ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKrb5Conf"></a>
Specifica un file di configurazione Kerberos (`krb5.conf`) che definisce la configurazione del realm Kerberos.  
Il file deve essere codificato in base 64. Se stai usando il AWS CLI, la codifica è pronta per te.  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza massima di 131072.  
Obbligatorio: no

 ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosPrincipal"></a>
Speciifica un principale Kerberos, che è un'identità nell'area di autenticazione Kerberos autorizzata ad accedere a file, cartelle e metadati dei file nel file server SMB.  
Potrebbe essere simile `HOST/kerberosuser@MYDOMAIN.ORG` a un principale Kerberos.  
I nomi principali distinguono tra maiuscole e minuscole. L'esecuzione dell' DataSync attività avrà esito negativo se il principale specificato per questo parametro non corrisponde esattamente al principale utilizzato per creare il file keytab.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$`   
Obbligatorio: no

 ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-LocationArn"></a>
Specificare l'ARN della posizione SMB che si desidera aggiornare.  
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}$`   
Obbligatorio: sì

 ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-MountOptions"></a>
Speciifica la versione del protocollo Server Message Block (SMB) AWS DataSync utilizzata per accedere a un file server SMB.  
Tipo: oggetto [SmbMountOptions](API_SmbMountOptions.md)  
Obbligatorio: no

 ** [Password](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Password"></a>
Speciifica la password dell'utente che può montare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento. Questo parametro si applica solo se `AuthenticationType` è impostato su. `NTLM`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^.{0,104}$`   
Obbligatorio: no

 ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-ServerHostname"></a>
Speciifica il nome di dominio o l'indirizzo IP (IPv4 o IPv6) del file server SMB a cui l'agente si connette DataSync .  
Se utilizzi l'autenticazione Kerberos, devi specificare un nome di dominio.
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: no

 ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Subdirectory"></a>
Speciifica il nome della condivisione esportata dal file server SMB in cui leggerà o DataSync scriverà i dati. È possibile includere una sottodirectory nel percorso di condivisione (ad esempio,). `/path/to/subdirectory` Assicurati che anche altri client SMB della tua rete possano montare questo percorso.  
Per copiare tutti i dati nella sottodirectory specificata, DataSync deve essere in grado di montare la condivisione SMB e accedere a tutti i relativi dati. Per ulteriori informazioni, vedere [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obbligatorio: no

 ** [User](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-User"></a>
Speciifica il nome utente che può montare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento. Questo parametro si applica solo se `AuthenticationType` è impostato su. `NTLM`  
Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta [Fornire DataSync l'accesso ai file server SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateLocationSmb_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_UpdateLocationSmb_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/UpdateLocationSmb) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) 

# UpdateTask
<a name="API_UpdateTask"></a>

Aggiorna la configurazione di un'*attività*, che definisce dove e come vengono AWS DataSync trasferiti i dati.

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

```
{
   "CloudWatchLogGroupArn": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "TaskArn": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## Parametri della richiesta
<a name="API_UpdateTask_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.

 ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-CloudWatchLogGroupArn"></a>
Speciifica l'Amazon Resource Name (ARN) di un gruppo di log CloudWatch Amazon per il monitoraggio dell'attività.  
Per le attività in modalità avanzata, devi utilizzare `/aws/datasync` come nome del gruppo di log. Esempio:  
 `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`   
Per ulteriori informazioni, vedere [Monitoraggio dei trasferimenti di dati con CloudWatch i registri.](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 562.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
Obbligatorio: no

 ** [Excludes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Excludes"></a>
Speciifica i filtri di esclusione che definiscono i file, gli oggetti e le cartelle nella posizione di origine che non si desidera trasferire. DataSync Per ulteriori informazioni ed esempi, consulta [Specificare DataSync i trasferimenti utilizzando i filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: no

 ** [Includes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Includes"></a>
I filtri di inclusione specificano i file, gli oggetti e le cartelle che si desidera DataSync trasferire nella posizione di origine. Per ulteriori informazioni ed esempi, vedere [Specificazione dei DataSync trasferimenti utilizzando i filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: no

 ** [ManifestConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-ManifestConfig"></a>
Configura un manifesto, che è un elenco di file o oggetti che si desidera DataSync trasferire. Per ulteriori informazioni ed esempi di configurazione, vedere [Specificazione degli elementi da DataSync trasferire utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Quando si utilizza questo parametro, l'identità del chiamante (il ruolo IAM DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione.  
Per rimuovere una configurazione del manifesto, specificate questo parametro come vuoto.  
Tipo: oggetto [ManifestConfig](API_ManifestConfig.md)  
Obbligatorio: no

 ** [Name](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Name"></a>
Specificate il nome dell'attività.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obbligatorio: no

 ** [Options](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Options"></a>
Indica come è configurata l'attività di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni.  
Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore `LogLevel` per una singola esecuzione.  
Tipo: oggetto [Options](API_Options.md)  
Obbligatorio: no

 ** [Schedule](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Schedule"></a>
Specificate una pianificazione in base alla quale desiderate che l'attività venga eseguita. Per ulteriori informazioni, vedere [Pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: oggetto [TaskSchedule](API_TaskSchedule.md)  
Obbligatorio: no

 ** [TaskArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskArn"></a>
Specificare l'ARN dell'attività che si desidera aggiornare.  
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}:task/task-[0-9a-f]{17}$`   
Obbligatorio: sì

 ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskReportConfig"></a>
Specifica come si desidera configurare un rapporto sulle attività, che fornisce informazioni dettagliate sul trasferimento. DataSync Per ulteriori informazioni, consulta [Monitoraggio dei DataSync trasferimenti con i report sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Quando utilizzi questo parametro, l'identità del chiamante (il ruolo IAM DataSync con cui stai utilizzando) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione.  
Per rimuovere la configurazione di un report di attività, specificate questo parametro come vuoto.  
Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md)  
Obbligatorio: no

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateTask_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 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
<a name="API_UpdateTask_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/UpdateTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) 

# UpdateTaskExecution
<a name="API_UpdateTaskExecution"></a>

Aggiorna la configurazione dell'esecuzione di un' AWS DataSync attività in esecuzione.

**Nota**  
Attualmente, l'unica opzione `Option` che è possibile modificare `UpdateTaskExecution` è` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) `, che limita la larghezza di banda per l'esecuzione di un'attività in esecuzione o in coda.

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

```
{
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "TaskExecutionArn": "string"
}
```

## Parametri della richiesta
<a name="API_UpdateTaskExecution_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.

 ** [Options](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-Options"></a>
Indica come è configurata l'operazione di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni.  
Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore `LogLevel` per una singola esecuzione.  
Tipo: oggetto [Options](API_Options.md)  
Obbligatorio: sì

 ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-TaskExecutionArn"></a>
Speciifica l'Amazon Resource Name (ARN) dell'esecuzione dell'attività che stai aggiornando.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateTaskExecution_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_UpdateTaskExecution_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/UpdateTaskExecution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) 

# Tipi di dati
<a name="API_Types"></a>

Sono supportati i tipi di dati seguenti:
+  [AgentListEntry](API_AgentListEntry.md) 
+  [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) 
+  [CmkSecretConfig](API_CmkSecretConfig.md) 
+  [CustomSecretConfig](API_CustomSecretConfig.md) 
+  [Ec2Config](API_Ec2Config.md) 
+  [FilterRule](API_FilterRule.md) 
+  [FsxProtocol](API_FsxProtocol.md) 
+  [FsxProtocolNfs](API_FsxProtocolNfs.md) 
+  [FsxProtocolSmb](API_FsxProtocolSmb.md) 
+  [FsxUpdateProtocol](API_FsxUpdateProtocol.md) 
+  [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) 
+  [HdfsNameNode](API_HdfsNameNode.md) 
+  [LocationFilter](API_LocationFilter.md) 
+  [LocationListEntry](API_LocationListEntry.md) 
+  [ManagedSecretConfig](API_ManagedSecretConfig.md) 
+  [ManifestConfig](API_ManifestConfig.md) 
+  [NfsMountOptions](API_NfsMountOptions.md) 
+  [OnPremConfig](API_OnPremConfig.md) 
+  [Options](API_Options.md) 
+  [Platform](API_Platform.md) 
+  [PrivateLinkConfig](API_PrivateLinkConfig.md) 
+  [QopConfiguration](API_QopConfiguration.md) 
+  [ReportDestination](API_ReportDestination.md) 
+  [ReportDestinationS3](API_ReportDestinationS3.md) 
+  [ReportOverride](API_ReportOverride.md) 
+  [ReportOverrides](API_ReportOverrides.md) 
+  [ReportResult](API_ReportResult.md) 
+  [S3Config](API_S3Config.md) 
+  [S3ManifestConfig](API_S3ManifestConfig.md) 
+  [SmbMountOptions](API_SmbMountOptions.md) 
+  [SourceManifestConfig](API_SourceManifestConfig.md) 
+  [TagListEntry](API_TagListEntry.md) 
+  [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) 
+  [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) 
+  [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) 
+  [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) 
+  [TaskExecutionListEntry](API_TaskExecutionListEntry.md) 
+  [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) 
+  [TaskFilter](API_TaskFilter.md) 
+  [TaskListEntry](API_TaskListEntry.md) 
+  [TaskReportConfig](API_TaskReportConfig.md) 
+  [TaskSchedule](API_TaskSchedule.md) 
+  [TaskScheduleDetails](API_TaskScheduleDetails.md) 

# AgentListEntry
<a name="API_AgentListEntry"></a>

Rappresenta una singola voce in un elenco (o matrice) di AWS DataSync agenti quando si chiama l'[ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operazione.

## Indice
<a name="API_AgentListEntry_Contents"></a>

 ** AgentArn **   <a name="DataSync-Type-AgentListEntry-AgentArn"></a>
L'Amazon Resource Name (ARN) di un DataSync agente.  
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}:agent/agent-[0-9a-z]{17}$`   
Obbligatorio: no

 ** Name **   <a name="DataSync-Type-AgentListEntry-Name"></a>
Il nome di un agente.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obbligatorio: no

 ** Platform **   <a name="DataSync-Type-AgentListEntry-Platform"></a>
I dettagli relativi alla piattaforma sull'agente, ad esempio il numero di versione.  
Tipo: oggetto [Platform](API_Platform.md)  
Obbligatorio: no

 ** Status **   <a name="DataSync-Type-AgentListEntry-Status"></a>
Lo stato di un agente.  
+ Se lo stato è`ONLINE`, l'agente è configurato correttamente e pronto per l'uso.
+ Se lo stato è`OFFLINE`, l'agente non è in contatto con l'agente DataSync da cinque minuti o più. Questo può succedere per diversi motivi. Per ulteriori informazioni, vedi [Cosa devo fare se il mio agente è offline?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 
Tipo: String  
Valori validi: `ONLINE | OFFLINE`   
Campo obbligatorio: no

## Vedi anche
<a name="API_AgentListEntry_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) 

# AzureBlobSasConfiguration
<a name="API_AzureBlobSasConfiguration"></a>

La configurazione SAS (Shared Access Signature) che consente di accedere AWS DataSync al tuo Microsoft Azure Blob Storage.

Per ulteriori informazioni, vedi [Token SAS](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens) per accedere al tuo Azure Blob Storage.

## Indice
<a name="API_AzureBlobSasConfiguration_Contents"></a>

 ** Token **   <a name="DataSync-Type-AzureBlobSasConfiguration-Token"></a>
Specifica un token SAS che fornisce le autorizzazioni per accedere al tuo Azure Blob Storage.  
Il token fa parte della stringa URI SAS che segue l'URI della risorsa di archiviazione e un punto interrogativo. Un token ha un aspetto simile al seguente:  
 `sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D`   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^.+$`   
Campo obbligatorio: sì

## Vedi anche
<a name="API_AzureBlobSasConfiguration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) 

# CmkSecretConfig
<a name="API_CmkSecretConfig"></a>

Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione, una chiave segreta, una password o un keytab Kerberos DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un codice gestito dal cliente. AWS KMS key

**Nota**  
È possibile utilizzare una delle due opzioni `CmkSecretConfig` o fornire le credenziali per una richiesta`CustomSecretConfig`. `CreateLocation` Non fornire entrambi i parametri per la stessa richiesta.

## Indice
<a name="API_CmkSecretConfig_Contents"></a>

 ** KmsKeyArn **   <a name="DataSync-Type-CmkSecretConfig-KmsKeyArn"></a>
Speciifica l'ARN per il codice gestito dal AWS KMS key cliente utilizzato per DataSync crittografare il segreto gestito DataSync per. `SecretArn` DataSync fornisce questa chiave a. Gestione dei segreti AWS  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$`   
Obbligatorio: no

 ** SecretArn **   <a name="DataSync-Type-CmkSecretConfig-SecretArn"></a>
Speciifica l'ARN per DataSync il Gestione dei segreti AWS -managed secret utilizzato per accedere a una posizione di archiviazione specifica. Questa proprietà è generata da DataSync ed è di sola lettura. DataSync crittografa questo segreto con la chiave KMS specificata. `KmsKeyArn`  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_CmkSecretConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) 

# CustomSecretConfig
<a name="API_CustomSecretConfig"></a>

Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui le credenziali di una posizione di archiviazione vengono archiviate in Secrets Manager come testo semplice (per token di autenticazione, chiave segreta o password) o come binario (per keytab Kerberos). Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto.

**Nota**  
È possibile utilizzare uno `CmkSecretConfig` o l'altro `CustomSecretConfig` per fornire le credenziali per una richiesta. `CreateLocation` Non fornire entrambi i parametri per la stessa richiesta.

## Indice
<a name="API_CustomSecretConfig_Contents"></a>

 ** SecretAccessRoleArn **   <a name="DataSync-Type-CustomSecretConfig-SecretAccessRoleArn"></a>
Speciifica l'ARN per AWS Identity and Access Management il ruolo DataSync utilizzato per accedere al segreto specificato per. `SecretArn`  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$`   
Obbligatorio: no

 ** SecretArn **   <a name="DataSync-Type-CustomSecretConfig-SecretArn"></a>
Speciifica l'ARN per Gestione dei segreti AWS un segreto.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_CustomSecretConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) 

# Ec2Config
<a name="API_Ec2Config"></a>

La sottorete e i gruppi di sicurezza AWS DataSync utilizzati per connettersi a uno degli [obiettivi di montaggio](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del file system Amazon EFS.

## Indice
<a name="API_Ec2Config_Contents"></a>

 ** SecurityGroupArns **   <a name="DataSync-Type-Ec2Config-SecurityGroupArns"></a>
Speciifica gli Amazon Resource Names (ARNs) dei gruppi di sicurezza associati alla destinazione di montaggio di un file system Amazon EFS.  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: sì

 ** SubnetArn **   <a name="DataSync-Type-Ec2Config-SubnetArn"></a>
Speciifica l'ARN di una sottorete in DataSync cui crea le interfacce di [rete per la](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) gestione del traffico durante il trasferimento.  
La sottorete deve trovarsi:  
+ Nello stesso cloud privato virtuale (VPC) del file system Amazon EFS.
+ Nella stessa zona di disponibilità di almeno una destinazione di montaggio per il file system Amazon EFS.
Non è necessario specificare una sottorete che presenti una destinazione di montaggio del file system.
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
Obbligatorio: sì

## Vedi anche
<a name="API_Ec2Config_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) 

# FilterRule
<a name="API_FilterRule"></a>

Specifica quali file, cartelle e oggetti includere o escludere durante il trasferimento dei file dall'origine alla destinazione.

## Indice
<a name="API_FilterRule_Contents"></a>

 ** FilterType **   <a name="DataSync-Type-FilterRule-FilterType"></a>
Il tipo di regola di filtro da applicare. AWS DataSync supporta solo il tipo di regola SIMPLE\$1PATTERN.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^[A-Z0-9_]+$`   
Valori validi: `SIMPLE_PATTERN`   
Campo obbligatorio: no

 ** Value **   <a name="DataSync-Type-FilterRule-Value"></a>
Una singola stringa di filtro costituita dai modelli da includere o escludere. I modelli sono delimitati da "\$1" (cioè una barra verticale), ad esempio: `/folder1|/folder2`   
   
Tipo: stringa  
Vincoli di lunghezza: lunghezza massima di 102400.  
Modello: `^[^\x00]+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_FilterRule_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) 

# FsxProtocol
<a name="API_FsxProtocol"></a>

Speciifica il protocollo di trasferimento dati AWS DataSync utilizzato per accedere al tuo FSx file system Amazon.

## Indice
<a name="API_FsxProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxProtocol-NFS"></a>
Speciifica la configurazione del protocollo Network File System (NFS) da DataSync utilizzare FSx per accedere al file system per OpenZFS o FSx alla macchina virtuale di archiviazione (SVM) del file system ONTAP.  
Tipo: oggetto [FsxProtocolNfs](API_FsxProtocolNfs.md)  
Campo obbligatorio: no

 ** SMB **   <a name="DataSync-Type-FsxProtocol-SMB"></a>
Specifica la configurazione del protocollo Server Message Block (SMB) da DataSync utilizzare per accedere alla SVM del file system for ONTAP. FSx   
Tipo: oggetto [FsxProtocolSmb](API_FsxProtocolSmb.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_FsxProtocol_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consultate quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) 

# FsxProtocolNfs
<a name="API_FsxProtocolNfs"></a>

Specifica la configurazione del protocollo Network File System (NFS) da DataSync utilizzare FSx per accedere al file system per OpenZFS o alla macchina virtuale di archiviazione ( FSx SVM) del file system ONTAP.

## Indice
<a name="API_FsxProtocolNfs_Contents"></a>

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolNfs-MountOptions"></a>
Speciifica come accedere a una posizione utilizzando il DataSync protocollo NFS.  
Tipo: oggetto [NfsMountOptions](API_NfsMountOptions.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_FsxProtocolNfs_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) 

# FsxProtocolSmb
<a name="API_FsxProtocolSmb"></a>

Speciifica la configurazione del protocollo Server Message Block (SMB) da AWS DataSync utilizzare per accedere alla macchina virtuale di archiviazione (SVM) del file system Amazon FSx for NetApp ONTAP. Per ulteriori informazioni, consulta [Fornire DataSync l'accesso ai file system ONTAP FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Indice
<a name="API_FsxProtocolSmb_Contents"></a>

 ** User **   <a name="DataSync-Type-FsxProtocolSmb-User"></a>
Speciifica un utente in grado di montare e accedere ai file, alle cartelle e ai metadati nel tuo SVM.  
Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta [Uso del](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) protocollo SMB.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obbligatorio: sì

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, che include la password DataSync utilizzata per accedere a una posizione di archiviazione specifica di FSx FOR ONTAP (tramite SMB), con un server gestito dal cliente. AWS KMS key  
Quando includi questo parametro come parte di una `CreateLocationFsxOntap` richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme a quella `Password` specificata 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. 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`Password`) o `CustomSecretConfig` (senza`Password`) per fornire le credenziali per una richiesta. `CreateLocationFsxOntap` Non fornite entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CustomSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui la password per una posizione di archiviazione FSx for ONTAP (utilizzando SMB) è 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. 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`Password`) o `CustomSecretConfig` (senza`Password`) per fornire le credenziali per una `CreateLocationFsxOntap` richiesta. Non fornite entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** Domain **   <a name="DataSync-Type-FsxProtocolSmb-Domain"></a>
Speciifica il nome del dominio Windows a cui appartiene la macchina virtuale di archiviazione (SVM).  
Se nel tuo ambiente sono presenti più domini, la configurazione di questa impostazione assicura che DataSync si connetta alla SVM corretta.  
Se nel tuo ambiente sono presenti più domini Active Directory, la configurazione di questo parametro assicura che DataSync si connetta alla SVM corretta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obbligatorio: no

 ** ManagedSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` segreto DataSync utilizzato per accedere a una posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Non fornirlo per una richiesta. `CreateLocation` `ManagedSecretConfig`è una ReadOnly proprietà e deve essere compilata solo nella `DescribeLocation` risposta.
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)  
Obbligatorio: no

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolSmb-MountOptions"></a>
Speciifica la versione del protocollo Server Message Block (SMB) che viene AWS DataSync utilizzata per accedere a un file server SMB.  
Tipo: oggetto [SmbMountOptions](API_SmbMountOptions.md)  
Obbligatorio: no

 ** Password **   <a name="DataSync-Type-FsxProtocolSmb-Password"></a>
Specifica la password di un utente che dispone dell'autorizzazione per accedere a SVM.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^.{0,104}$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_FsxProtocolSmb_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) 

# FsxUpdateProtocol
<a name="API_FsxUpdateProtocol"></a>

Speciifica il protocollo di trasferimento dati AWS DataSync utilizzato per accedere al tuo FSx file system Amazon.

**Nota**  
Non puoi aggiornare la configurazione del protocollo Network File System (NFS) FSx per le sedi ONTAP. DataSync attualmente supporta solo la versione 3 di NFS con questo tipo di posizione.

## Indice
<a name="API_FsxUpdateProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxUpdateProtocol-NFS"></a>
Speciifica la configurazione del protocollo Network File System (NFS) da DataSync utilizzare FSx per accedere al file system per OpenZFS o FSx alla macchina virtuale di archiviazione (SVM) del file system ONTAP.  
Tipo: oggetto [FsxProtocolNfs](API_FsxProtocolNfs.md)  
Campo obbligatorio: no

 ** SMB **   <a name="DataSync-Type-FsxUpdateProtocol-SMB"></a>
Speciifica la configurazione del protocollo Server Message Block (SMB) da DataSync utilizzare per accedere alla macchina virtuale di archiviazione (SVM) del file system FSx for ONTAP.  
Tipo: oggetto [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_FsxUpdateProtocol_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) 

# FsxUpdateProtocolSmb
<a name="API_FsxUpdateProtocolSmb"></a>

Speciifica la configurazione del protocollo Server Message Block (SMB) da AWS DataSync utilizzare per accedere alla macchina virtuale di archiviazione (SVM) del file system Amazon FSx for NetApp ONTAP. Per ulteriori informazioni, consulta [Fornire DataSync l'accesso ai file system ONTAP FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Indice
<a name="API_FsxUpdateProtocolSmb_Contents"></a>

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CmkSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un `Password` set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica, e un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CustomSecretConfig"></a>
Specifica le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un set di credenziali da utilizzare per accedere a una `Password` posizione di trasferimento specifica. DataSync Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** Domain **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Domain"></a>
Speciifica il nome del dominio Windows a cui appartiene la macchina virtuale di archiviazione (SVM).  
Se nel tuo ambiente sono presenti più domini Active Directory, la configurazione di questo parametro assicura che DataSync si connetta alla SVM corretta.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 253.  
Modello: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
Obbligatorio: no

 ** MountOptions **   <a name="DataSync-Type-FsxUpdateProtocolSmb-MountOptions"></a>
Speciifica la versione del protocollo Server Message Block (SMB) da AWS DataSync utilizzare per accedere a un file server SMB.  
Tipo: oggetto [SmbMountOptions](API_SmbMountOptions.md)  
Obbligatorio: no

 ** Password **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Password"></a>
Specifica la password di un utente che dispone dell'autorizzazione per accedere a SVM.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^.{0,104}$`   
Obbligatorio: no

 ** User **   <a name="DataSync-Type-FsxUpdateProtocolSmb-User"></a>
Speciifica un utente in grado di montare e accedere a file, cartelle e metadati nella SVM.  
Per informazioni sulla scelta di un utente con il giusto livello di accesso per il trasferimento, consulta [Uso del](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) protocollo SMB.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 104.  
Modello: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_FsxUpdateProtocolSmb_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) 

# HdfsNameNode
<a name="API_HdfsNameNode"></a>

Il NameNode sistema Hadoop Distributed File System (HDFS). NameNode Gestisce lo spazio dei nomi del file system. NameNode Esegue operazioni come l'apertura, la chiusura e la ridenominazione di file e directory. NameNode Contiene le informazioni per mappare blocchi di dati su. DataNodes

## Indice
<a name="API_HdfsNameNode_Contents"></a>

 ** Hostname **   <a name="DataSync-Type-HdfsNameNode-Hostname"></a>
Il nome host di NameNode nel cluster HDFS. Questo valore è l'indirizzo IP o il nome DNS (Domain Name Service) di. NameNode Un agente installato in locale utilizza questo nome host per comunicare con loro NameNode nella rete.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$`   
Campo obbligatorio: sì

 ** Port **   <a name="DataSync-Type-HdfsNameNode-Port"></a>
La porta che NameNode utilizza per ascoltare le richieste dei client.  
Tipo: integer  
Intervallo valido: valore minimo di 1. Valore massimo di 65536.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_HdfsNameNode_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) 

# LocationFilter
<a name="API_LocationFilter"></a>

Restringi l'elenco delle risorse restituite da`ListLocations`. Ad esempio, per visualizzare tutte le tue sedi Amazon S3, crea un filtro utilizzando `"Name": "LocationType"``"Operator": "Equals"`, e. `"Values": "S3"`

Per ulteriori informazioni, consulta [Filtraggio delle risorse.](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html)

## Indice
<a name="API_LocationFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-LocationFilter-Name"></a>
Il nome del filtro utilizzato. Ogni chiamata API supporta un elenco di filtri disponibili (ad esempio, `LocationType` per`ListLocations`).  
Tipo: stringa  
Valori validi: `LocationUri | LocationType | CreationTime`   
Campo obbligatorio: sì

 ** Operator **   <a name="DataSync-Type-LocationFilter-Operator"></a>
L'operatore utilizzato per confrontare i valori dei filtri (ad esempio, `Equals` o`Contains`).  
Tipo: stringa  
Valori validi: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`   
Campo obbligatorio: sì

 ** Values **   <a name="DataSync-Type-LocationFilter-Values"></a>
I valori in base ai quali si desidera filtrare. Ad esempio, potresti voler visualizzare solo le sedi Amazon S3.  
Tipo: matrice di stringhe  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
Campo obbligatorio: sì

## Vedi anche
<a name="API_LocationFilter_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) 

# LocationListEntry
<a name="API_LocationListEntry"></a>

Rappresenta una singola voce in un elenco di posizioni. `LocationListEntry`restituisce un array che contiene un elenco di posizioni quando viene chiamata l'[ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)operazione.

## Indice
<a name="API_LocationListEntry_Contents"></a>

 ** LocationArn **   <a name="DataSync-Type-LocationListEntry-LocationArn"></a>
L'Amazon Resource Name (ARN) della posizione. Per Network File System (NFS) o Amazon EFS, la posizione è il percorso di esportazione. Per Amazon S3, la posizione è il percorso del prefisso che desideri montare e utilizzare come radice della posizione.  
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}$`   
Obbligatorio: no

 ** LocationUri **   <a name="DataSync-Type-LocationListEntry-LocationUri"></a>
Rappresenta un elenco URIs di una posizione. `LocationUri`restituisce un array che contiene un elenco di posizioni quando viene chiamata l'[ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)operazione.  
Formato:`TYPE://GLOBAL_ID/SUBDIR`.  
TYPE indica il tipo di posizione (ad esempio, `nfs` o`s3`).  
GLOBAL\$1ID è l'identificatore univoco globale della risorsa che supporta la posizione. Un esempio per EFS è`us-east-2.fs-abcd1234`. Un esempio per Amazon S3 è il nome del bucket, ad esempio. `myBucket` Un esempio di NFS è un IPv6 indirizzo IPv4 or o un nome host valido conforme al DNS.  
SUBDIR è un percorso di file system valido, delimitato da barre, così come la convenzione\$1nix. Per NFS e Amazon EFS, è il percorso di esportazione per montare la posizione. Per Amazon S3, è il percorso del prefisso su cui monti e che consideri come radice della posizione.  
  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_LocationListEntry_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) 

# ManagedSecretConfig
<a name="API_ManagedSecretConfig"></a>

Specifica le informazioni di configurazione per un segreto DataSync gestito, ad esempio un token di autenticazione o un set di credenziali da DataSync utilizzare per accedere a una posizione di trasferimento specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS

## Indice
<a name="API_ManagedSecretConfig_Contents"></a>

 ** SecretArn **   <a name="DataSync-Type-ManagedSecretConfig-SecretArn"></a>
Speciifica l'ARN per Gestione dei segreti AWS un segreto.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_ManagedSecretConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) 

# ManifestConfig
<a name="API_ManifestConfig"></a>

Configura un manifesto, che è un elenco di file o oggetti che si desidera AWS DataSync trasferire. Per ulteriori informazioni ed esempi di configurazione, vedere [Specificazione degli elementi da DataSync trasferire utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Indice
<a name="API_ManifestConfig_Contents"></a>

 ** Action **   <a name="DataSync-Type-ManifestConfig-Action"></a>
Speciifica per cosa DataSync viene utilizzato il manifesto.  
Tipo: stringa  
Valori validi: `TRANSFER`   
Campo obbligatorio: no

 ** Format **   <a name="DataSync-Type-ManifestConfig-Format"></a>
Speciifica il formato di file del manifesto. Per ulteriori informazioni, vedere [Creazione di un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create).  
Tipo: stringa  
Valori validi: `CSV`   
Campo obbligatorio: no

 ** Source **   <a name="DataSync-Type-ManifestConfig-Source"></a>
Specificate il manifesto che desiderate DataSync utilizzare e dove è ospitato.  
È necessario specificare questo parametro se si sta configurando un nuovo manifesto a partire dal 7 febbraio 2024.  
In caso contrario, riceverai un codice di stato 400 e un `ValidationException` errore che indica che ti manca il ruolo IAM per accedere DataSync al bucket S3 in cui stai ospitando il tuo manifest. Per ulteriori informazioni, consulta [Fornire DataSync l'accesso al tuo manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access).
Tipo: oggetto [SourceManifestConfig](API_SourceManifestConfig.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_ManifestConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) 

# NfsMountOptions
<a name="API_NfsMountOptions"></a>

Specifica come DataSync accedere a una posizione utilizzando il protocollo NFS.

## Indice
<a name="API_NfsMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-NfsMountOptions-Version"></a>
Speciifica la versione NFS che si desidera utilizzare DataSync per montare la condivisione NFS. Se il server rifiuta di utilizzare la versione specificata, l'attività avrà esito negativo.  
Puoi specificare le seguenti opzioni:  
+  `AUTOMATIC`(impostazione predefinita): DataSync sceglie la versione 4.1 di NFS.
+  `NFS3`: versione del protocollo stateless che consente scritture asincrone sul server.
+  `NFSv4_0`: versione del protocollo stateful, abilitato per firewall che supporta deleghe e pseudo file system.
+  `NFSv4_1`: versione del protocollo stateful che supporta sessioni, deleghe di directory ed elaborazione parallela dei dati. La versione 4.1 di NFS include anche tutte le funzionalità disponibili nella versione 4.0.
DataSync attualmente supporta solo la versione 3 di NFS con sedi Amazon FSx for NetApp ONTAP.
Tipo: stringa  
Valori validi: `AUTOMATIC | NFS3 | NFS4_0 | NFS4_1`   
Campo obbligatorio: no

## Vedi anche
<a name="API_NfsMountOptions_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) 

# OnPremConfig
<a name="API_OnPremConfig"></a>

Gli AWS DataSync agenti che possono connettersi al file server Network File System (NFS).

## Indice
<a name="API_OnPremConfig_Contents"></a>

 ** AgentArns **   <a name="DataSync-Type-OnPremConfig-AgentArns"></a>
Gli Amazon Resource Names (ARNs) degli DataSync agenti che possono connettersi al tuo file server NFS.  
Puoi specificare più di un agente. Per ulteriori informazioni, vedere [Utilizzo di più DataSync agenti](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents).  
Tipo: array di stringhe  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.  
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: sì

## Vedi anche
<a name="API_OnPremConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) 

# Options
<a name="API_Options"></a>

Indica come è configurata l'attività di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni.

Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).

È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore `LogLevel` per una singola esecuzione.

## Indice
<a name="API_Options_Contents"></a>

 ** Atime **   <a name="DataSync-Type-Options-Atime"></a>
Speciifica se conservare i metadati che indicano l'ultima volta in cui un file è stato letto o scritto.  
Il comportamento di `Atime` non è completamente standard su tutte le piattaforme, quindi DataSync può farlo solo con il massimo impegno.
+  `BEST_EFFORT`(impostazione predefinita): DataSync tenta di preservare l'`Atime`attributo originale su tutti i file di origine (ovvero la versione precedente alle `PREPARING` fasi dell'esecuzione dell'attività). Questa opzione è consigliata.
+  `NONE`- Ignora. `Atime`
Se `Atime` è impostato su `BEST_EFFORT`, `Mtime` deve essere impostato su `PRESERVE`.   
Se `Atime` è impostato su `NONE`, anche `Mtime` deve essere `NONE`. 
Tipo: String  
Valori validi: `NONE | BEST_EFFORT`   
Campo obbligatorio: no

 ** BytesPerSecond **   <a name="DataSync-Type-Options-BytesPerSecond"></a>
Limita la larghezza di banda utilizzata da un' DataSync attività. Ad esempio, se desideri DataSync utilizzare un massimo di 1 MB, imposta questo valore su `1048576` (`=1024*1024`).  
Tipo: long  
Intervallo valido: valore minimo di -1.  
Obbligatorio: no

 ** Gid **   <a name="DataSync-Type-Options-Gid"></a>
Specifica l'ID di gruppo POSIX (GID) dei proprietari del file.  
+  `INT_VALUE`(impostazione predefinita): conserva il valore intero dell'ID utente (UID) e del GID, impostazione consigliata.
+  `NONE`- Ignora UID e GID.
Per ulteriori informazioni, consulta [Comprendere la modalità di gestione dei metadati DataSync di file e oggetti](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
Tipo: String  
Valori validi: `NONE | INT_VALUE | NAME | BOTH`   
Campo obbligatorio: no

 ** LogLevel **   <a name="DataSync-Type-Options-LogLevel"></a>
Speciifica il tipo di log che vengono DataSync pubblicati in un gruppo di log di Amazon CloudWatch Logs. Per specificare il gruppo di log, consulta. [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn)  
+  `BASIC`- Pubblica i log con solo informazioni di base (come gli errori di trasferimento).
+  `TRANSFER`- Pubblica i registri per tutti i file o gli oggetti trasferiti dall' DataSync attività ed esegue controlli di integrità dei dati.
+  `OFF`- Non viene pubblicato alcun registro.
Tipo: String  
Valori validi: `OFF | BASIC | TRANSFER`   
Campo obbligatorio: no

 ** Mtime **   <a name="DataSync-Type-Options-Mtime"></a>
Specifica se conservare i metadati che indicano l'ultima volta in cui è stato scritto un file prima della `PREPARING` fase di esecuzione dell'attività. Questa opzione è necessaria quando è necessario eseguire un'attività più di una volta.  
+  `PRESERVE`(impostazione predefinita): conserva l'originale`Mtime`, operazione consigliata.
+  `NONE`- Ignora`Mtime`.
Se `Mtime` è impostato su `PRESERVE`, `Atime` deve essere impostato su `BEST_EFFORT`.  
Se `Mtime` è impostato su `NONE`, anche `Atime` deve essere impostato su `NONE`. 
Tipo: String  
Valori validi: `NONE | PRESERVE`   
Campo obbligatorio: no

 ** ObjectTags **   <a name="DataSync-Type-Options-ObjectTags"></a>
Specifica se si desidera DataSync utilizzare i tag come `PRESERVE` oggetto (comportamento predefinito) durante il trasferimento tra sistemi di storage di oggetti. Se desiderate che l' DataSync attività ignori i tag degli oggetti, specificate il `NONE` valore.  
Tipo: String  
Valori validi: `PRESERVE | NONE`   
Campo obbligatorio: no

 ** OverwriteMode **   <a name="DataSync-Type-Options-OverwriteMode"></a>
Speciifica se DataSync modificare o conservare i dati nella posizione di destinazione.  
+  `ALWAYS`(impostazione predefinita): DataSync modifica i dati nella posizione di destinazione quando i dati di origine (inclusi i metadati) sono cambiati.

  Se DataSync sovrascrive gli oggetti, potresti incorrere in costi aggiuntivi per determinate classi di storage di Amazon S3 (ad esempio, per il recupero o l'eliminazione anticipata). Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con i trasferimenti Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NEVER`- DataSync non sovrascrive i dati nella posizione di destinazione anche se i dati di origine sono cambiati. È possibile utilizzare questa opzione per evitare di sovrascrivere le modifiche apportate a file o oggetti nella destinazione.
Tipo: String  
Valori validi: `ALWAYS | NEVER`   
Campo obbligatorio: no

 ** PosixPermissions **   <a name="DataSync-Type-Options-PosixPermissions"></a>
Speciifica quali utenti o gruppi possono accedere a un file per uno scopo specifico, ad esempio la lettura, la scrittura o l'esecuzione del file.  
Per ulteriori informazioni, vedere [Comprensione della DataSync gestione dei metadati di file e oggetti](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `PRESERVE`(impostazione predefinita): conserva le autorizzazioni in stile POSIX, operazione consigliata.
+  `NONE`- Ignora le autorizzazioni in stile POSIX. 
DataSync può conservare le autorizzazioni esistenti di una posizione di origine.
Tipo: String  
Valori validi: `NONE | PRESERVE`   
Campo obbligatorio: no

 ** PreserveDeletedFiles **   <a name="DataSync-Type-Options-PreserveDeletedFiles"></a>
Speciifica se i file nella posizione di destinazione che non esistono nell'origine devono essere conservati. Questa opzione può influire sui costi di storage di Amazon S3. Se l'attività elimina gli oggetti, è possibile incorrere in costi minimi per la durata dello storage per determinate classi di storage. Per informazioni dettagliate, consulta [Considerazioni sull'utilizzo delle classi di storage Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) in. DataSync  
+  `PRESERVE`(impostazione predefinita): ignora tali file di destinazione, operazione consigliata. 
+  `REMOVE`- Elimina i file di destinazione che non sono presenti nell'origine.
Se imposti questo parametro su`REMOVE`, non puoi `TransferMode` impostarlo `ALL` su. Quando trasferisci tutti i dati, DataSync non analizza la posizione di destinazione e non sa cosa eliminare.
Tipo: String  
Valori validi: `PRESERVE | REMOVE`   
Campo obbligatorio: no

 ** PreserveDevices **   <a name="DataSync-Type-Options-PreserveDevices"></a>
Speciifica se DataSync conservare i metadati dei dispositivi a blocchi e a caratteri nella posizione di origine e ricreare i file con quel nome di dispositivo e i metadati nella destinazione. DataSync copia solo il nome e i metadati di tali dispositivi.  
DataSync non può copiare il contenuto effettivo di questi dispositivi perché non sono terminali e non restituiscono un marker end-of-file (EOF).
+  `NONE`(impostazione predefinita): ignora i dispositivi speciali (consigliato).
+  `PRESERVE`- Conserva i caratteri e i metadati dei dispositivi a blocchi. Questa opzione al momento non è supportata per Amazon EFS.
Tipo: String  
Valori validi: `NONE | PRESERVE`   
Campo obbligatorio: no

 ** SecurityDescriptorCopyFlags **   <a name="DataSync-Type-Options-SecurityDescriptorCopyFlags"></a>
Speciifica quali componenti del descrittore di sicurezza SMB vengono copiati dagli oggetti di origine a quelli di destinazione.   
Questo valore viene utilizzato solo per i trasferimenti tra le posizioni SMB e Amazon FSx for Windows File Server o tra due posizioni FSx per Windows File Server. Per ulteriori informazioni, consulta [Comprendere come DataSync gestisce i metadati di file e oggetti](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `OWNER_DACL`(impostazione predefinita): per ogni oggetto copiato, DataSync copia i seguenti metadati:
  + Il proprietario dell'oggetto.
  + Liste di controllo degli accessi discrezionali NTFS (DACLs), che determinano se concedere l'accesso a un oggetto.

    DataSync non copierà gli elenchi di controllo degli accessi al sistema NTFS (SACLs) con questa opzione.
+  `OWNER_DACL_SACL`- Per ogni oggetto copiato, DataSync copia i seguenti metadati:
  + Il proprietario dell'oggetto.
  + Liste di controllo degli accessi discrezionali NTFS (DACLs), che determinano se concedere l'accesso a un oggetto.
  + SACLs, utilizzati dagli amministratori per registrare i tentativi di accesso a un oggetto protetto.

    La copia SACLs richiede la concessione di autorizzazioni aggiuntive all'utente Windows che DataSync utilizza per accedere alla posizione SMB. Per informazioni sulla scelta di un utente con le autorizzazioni corrette, consulta Autorizzazioni richieste per [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), per [Windows File Server o FSx FSx per](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) [ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (a seconda del tipo di posizione nel trasferimento).
+  `NONE`- Nessuno dei componenti del descrittore di sicurezza SMB viene copiato. Gli oggetti di destinazione sono di proprietà dell'utente a cui è stato fornito l'accesso alla posizione di destinazione. DACLs e SACLs sono impostati in base alla configurazione del server di destinazione. 
Tipo: String  
Valori validi: `NONE | OWNER_DACL | OWNER_DACL_SACL`   
Campo obbligatorio: no

 ** TaskQueueing **   <a name="DataSync-Type-Options-TaskQueueing"></a>
Speciifica se le attività di trasferimento devono essere messe in coda in determinati scenari quando si [eseguono più](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks) attività. Questa è l'impostazione `ENABLED` predefinita.  
Tipo: String  
Valori validi: `ENABLED | DISABLED`   
Campo obbligatorio: no

 ** TransferMode **   <a name="DataSync-Type-Options-TransferMode"></a>
Speciifica se DataSync trasferisce solo i dati (inclusi i metadati) che differiscono tra le posizioni dopo una copia iniziale o trasferisce tutti i dati ogni volta che si esegue l'attività. Se hai intenzione di effettuare trasferimenti ricorrenti, potresti voler trasferire solo le modifiche apportate rispetto alla precedente esecuzione dell'attività.  
+  `CHANGED`(impostazione predefinita): dopo il trasferimento completo iniziale, DataSync copia solo i dati e i metadati che differiscono tra la posizione di origine e quella di destinazione.
+  `ALL`- DataSync copia tutto ciò che si trova nell'origine nella destinazione senza confrontare le differenze tra le posizioni.
Tipo: String  
Valori validi: `CHANGED | ALL`   
Campo obbligatorio: no

 ** Uid **   <a name="DataSync-Type-Options-Uid"></a>
Specifica l'ID utente POSIX (UID) del proprietario del file.  
+  `INT_VALUE`(impostazione predefinita): conserva il valore intero di UID e ID di gruppo (GID), impostazione consigliata.
+  `NONE`- Ignora UID e GID. 
Per ulteriori informazioni, vedete [Metadati copiati](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied) da. DataSync  
Tipo: String  
Valori validi: `NONE | INT_VALUE | NAME | BOTH`   
Campo obbligatorio: no

 ** VerifyMode **   <a name="DataSync-Type-Options-VerifyMode"></a>
Speciifica se e come DataSync verifica l'integrità dei dati al termine del trasferimento.  
+  `ONLY_FILES_TRANSFERRED`(consigliato): DataSync calcola il checksum dei dati trasferiti (inclusi i metadati) nella posizione di origine. Al termine del trasferimento, confronta DataSync quindi questo checksum con il checksum calcolato su quei dati nella destinazione.
**Nota**  
Questa è l'opzione predefinita per le attività in modalità [Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

  Consigliamo questa opzione per il trasferimento alle classi di storage S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con le sedi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `POINT_IN_TIME_CONSISTENT`- Al termine del trasferimento, DataSync controlla l'intera origine e la destinazione per verificare che entrambe le sedi siano completamente sincronizzate.
**Nota**  
È l'opzione predefinita per le [attività in modalità Base](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) e attualmente non è supportata nelle attività in modalità Avanzata.

  Se si utilizza un [manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), analizza e verifica DataSync solo ciò che è elencato nel manifesto.

  Non puoi utilizzare questa opzione per il trasferimento a classi di storage S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con le sedi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NONE`- DataSync esegue controlli di integrità dei dati solo durante il trasferimento. A differenza di altre opzioni, non è prevista alcuna verifica aggiuntiva al termine del trasferimento.
Tipo: String  
Valori validi: `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE`   
Campo obbligatorio: no

## Vedi anche
<a name="API_Options_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) 

# Platform
<a name="API_Platform"></a>

I dettagli relativi alla piattaforma sull' AWS DataSync agente, ad esempio il numero di versione.

## Indice
<a name="API_Platform_Contents"></a>

 ** Version **   <a name="DataSync-Type-Platform-Version"></a>
La versione dell'agente. DataSync   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_Platform_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) 

# PrivateLinkConfig
<a name="API_PrivateLinkConfig"></a>

Specifica in che modo l' AWS DataSync agente si connette all' AWS utilizzo di un [endpoint del servizio Virtual Private Cloud (VPC)](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc). Un agente che utilizza un endpoint VPC non è accessibile sulla rete Internet pubblica.

## Indice
<a name="API_PrivateLinkConfig_Contents"></a>

 ** PrivateLinkEndpoint **   <a name="DataSync-Type-PrivateLinkConfig-PrivateLinkEndpoint"></a>
Specifica l'endpoint VPC fornito [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html)dal quale l'agente si connette.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 7. La lunghezza massima è 15 caratteri.  
Modello: `\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z`   
Obbligatorio: no

 ** SecurityGroupArns **   <a name="DataSync-Type-PrivateLinkConfig-SecurityGroupArns"></a>
Speciifica l'Amazon Resource Names (ARN) del gruppo di sicurezza che DataSync fornisce l'accesso all'endpoint VPC. È possibile specificare un solo ARN.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 1 elemento.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Obbligatorio: no

 ** SubnetArns **   <a name="DataSync-Type-PrivateLinkConfig-SubnetArns"></a>
Speciifica l'ARN della sottorete in cui si trova l'endpoint VPC. È possibile specificare un solo ARN.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 1 elemento.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
Obbligatorio: no

 ** VpcEndpointId **   <a name="DataSync-Type-PrivateLinkConfig-VpcEndpointId"></a>
Specifica l'ID dell'endpoint VPC a cui l'agente si connette.  
Tipo: stringa  
Modello: `^vpce-[0-9a-f]{17}$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_PrivateLinkConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) 

# QopConfiguration
<a name="API_QopConfiguration"></a>

La configurazione QOP (Quality of Protection) specifica le impostazioni di privacy per le chiamate di procedura remota (RPC, Remote Procedure Call) e per il trasferimento dati configurate nel cluster del file system distribuito Hadoop (HDFS).

## Indice
<a name="API_QopConfiguration_Contents"></a>

 ** DataTransferProtection **   <a name="DataSync-Type-QopConfiguration-DataTransferProtection"></a>
L'impostazione di protezione per il trasferimento dati configurata nel cluster HDFS. Questa impostazione corrisponde all'impostazione `dfs.data.transfer.protection` nel file `hdfs-site.xml` del cluster Hadoop.  
Tipo: stringa  
Valori validi: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`   
Campo obbligatorio: no

 ** RpcProtection **   <a name="DataSync-Type-QopConfiguration-RpcProtection"></a>
L'impostazione di protezione RPC configurata nel cluster HDFS. Questa impostazione corrisponde all'impostazione `hadoop.rpc.protection` nel file `core-site.xml` del cluster Hadoop.  
Tipo: stringa  
Valori validi: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`   
Campo obbligatorio: no

## Vedi anche
<a name="API_QopConfiguration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) 

# ReportDestination
<a name="API_ReportDestination"></a>

Specificate dove DataSync caricare il rapporto sulle [attività.](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)

## Indice
<a name="API_ReportDestination_Contents"></a>

 ** S3 **   <a name="DataSync-Type-ReportDestination-S3"></a>
Specifica il bucket Amazon S3 DataSync in cui carica il report delle attività.  
Tipo: oggetto [ReportDestinationS3](API_ReportDestinationS3.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_ReportDestination_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) 

# ReportDestinationS3
<a name="API_ReportDestinationS3"></a>

[Specifica il bucket Amazon S3 DataSync in cui carica il report delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)

## Indice
<a name="API_ReportDestinationS3_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-ReportDestinationS3-BucketAccessRoleArn"></a>
Specifica l'Amazon Resource Name (ARN) della policy IAM che DataSync consente di caricare un report delle attività nel bucket S3. Per ulteriori informazioni, consulta [Consentire DataSync il caricamento di un report delle attività in un bucket Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obbligatorio: sì

 ** S3BucketArn **   <a name="DataSync-Type-ReportDestinationS3-S3BucketArn"></a>
Speciifica l'ARN del bucket DataSync S3 in cui carica il rapporto.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 268.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
Obbligatorio: sì

 ** Subdirectory **   <a name="DataSync-Type-ReportDestinationS3-Subdirectory"></a>
Specificate un prefisso bucket per il rapporto.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_ReportDestinationS3_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) 

# ReportOverride
<a name="API_ReportOverride"></a>

Specificate il livello di dettaglio per un aspetto particolare del [rapporto sulle DataSync attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Indice
<a name="API_ReportOverride_Contents"></a>

 ** ReportLevel **   <a name="DataSync-Type-ReportOverride-ReportLevel"></a>
Specifica se il rapporto sull'attività include solo errori o successi ed errori.  
Ad esempio, il rapporto potrebbe includere principalmente solo ciò che non è andato bene nel trasferimento ()`ERRORS_ONLY`. Allo stesso tempo, vuoi verificare che il [filtro delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) funzioni correttamente. In questa situazione, puoi ottenere un elenco di quali file sono stati ignorati DataSync correttamente e se è stato trasferito qualcosa che non hai trasferito (`SUCCESSES_AND_ERRORS`).  
Tipo: stringa  
Valori validi: `ERRORS_ONLY | SUCCESSES_AND_ERRORS`   
Campo obbligatorio: no

## Vedi anche
<a name="API_ReportOverride_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) 

# ReportOverrides
<a name="API_ReportOverrides"></a>

Il livello di dettaglio incluso in ogni aspetto del [rapporto sulle DataSync attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Indice
<a name="API_ReportOverrides_Contents"></a>

 ** Deleted **   <a name="DataSync-Type-ReportOverrides-Deleted"></a>
Speciifica il livello di segnalazione per i file, gli oggetti e le directory che DataSync hanno tentato di eliminare nella posizione di destinazione. Ciò si applica solo se si [configura l'attività](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) in modo da eliminare i dati nella destinazione che non si trovano nell'origine.  
Tipo: oggetto [ReportOverride](API_ReportOverride.md)  
Campo obbligatorio: no

 ** Skipped **   <a name="DataSync-Type-ReportOverrides-Skipped"></a>
Speciifica il livello di reporting per i file, gli oggetti e le directory che hai DataSync cercato di ignorare durante il trasferimento.  
Tipo: oggetto [ReportOverride](API_ReportOverride.md)  
Campo obbligatorio: no

 ** Transferred **   <a name="DataSync-Type-ReportOverrides-Transferred"></a>
Speciifica il livello di segnalazione per i file, gli oggetti e le directory che hanno tentato di trasferire. DataSync   
Tipo: oggetto [ReportOverride](API_ReportOverride.md)  
Campo obbligatorio: no

 ** Verified **   <a name="DataSync-Type-ReportOverrides-Verified"></a>
Speciifica il livello di segnalazione per i file, gli oggetti e le directory che si è DataSync tentato di verificare al termine del trasferimento.  
Tipo: oggetto [ReportOverride](API_ReportOverride.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_ReportOverrides_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) 

# ReportResult
<a name="API_ReportResult"></a>

Indica se DataSync è stato creato un [rapporto sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) completo per il trasferimento.

## Indice
<a name="API_ReportResult_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-ReportResult-ErrorCode"></a>
Indica il codice associato all'errore se non è DataSync possibile creare un rapporto completo.  
Tipo: string  
Campo obbligatorio: no

 ** ErrorDetail **   <a name="DataSync-Type-ReportResult-ErrorDetail"></a>
Fornisce dettagli sui problemi relativi alla creazione di un rapporto.  
Tipo: string  
Campo obbligatorio: no

 ** Status **   <a name="DataSync-Type-ReportResult-Status"></a>
Indica se DataSync sta ancora lavorando sul rapporto, ha creato un rapporto o non è possibile creare un rapporto completo.  
Tipo: stringa  
Valori validi: `PENDING | SUCCESS | ERROR`   
Campo obbligatorio: no

## Vedi anche
<a name="API_ReportResult_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) 

# S3Config
<a name="API_S3Config"></a>

Speciifica l'Amazon Resource Name (ARN) AWS Identity and Access Management del ruolo DataSync (IAM) utilizzato per accedere al bucket S3.

Per ulteriori informazioni, consulta [Fornire l' DataSync accesso ai](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access) bucket S3.

## Indice
<a name="API_S3Config_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3Config-BucketAccessRoleArn"></a>
Speciifica l'ARN del ruolo DataSync IAM utilizzato per accedere al bucket S3.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obbligatorio: sì

## Vedi anche
<a name="API_S3Config_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) 

# S3ManifestConfig
<a name="API_S3ManifestConfig"></a>

Specifica il bucket S3 in cui stai ospitando il manifesto che desideri utilizzare. AWS DataSync Per ulteriori informazioni ed esempi di configurazione, consulta [Specificare quali DataSync trasferimenti vengono trasferiti utilizzando](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) un manifesto.

## Indice
<a name="API_S3ManifestConfig_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3ManifestConfig-BucketAccessRoleArn"></a>
Specifica il ruolo AWS Identity and Access Management (IAM) che consente di accedere DataSync al manifesto. Per ulteriori informazioni, consulta [Fornire DataSync l'accesso al manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obbligatorio: sì

 ** ManifestObjectPath **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectPath"></a>
Specifica la chiave oggetto Amazon S3 del tuo manifesto. Questo può includere un prefisso (ad esempio,). `prefix/my-manifest.csv`  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4096.  
Modello: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obbligatorio: sì

 ** S3BucketArn **   <a name="DataSync-Type-S3ManifestConfig-S3BucketArn"></a>
Specifica l'Amazon Resource Name (ARN) del bucket S3 in cui stai ospitando il tuo manifest.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 268.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
Obbligatorio: sì

 ** ManifestObjectVersionId **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectVersionId"></a>
Specificate l'ID della versione dell'oggetto del manifesto che desiderate DataSync utilizzare. Se non lo impostate, DataSync utilizza la versione più recente dell'oggetto.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^.+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_S3ManifestConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) 

# SmbMountOptions
<a name="API_SmbMountOptions"></a>

Speciifica la versione del protocollo Server Message Block (SMB) che viene AWS DataSync utilizzata per accedere a un file server SMB.

## Indice
<a name="API_SmbMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-SmbMountOptions-Version"></a>
Per impostazione predefinita, sceglie DataSync automaticamente una versione del protocollo SMB in base alla negoziazione con il file server SMB. Puoi anche configurare l'utilizzo DataSync di una versione SMB specifica, ma ti consigliamo di farlo solo se hai problemi a negoziare automaticamente con DataSync il file server SMB.  
Di seguito sono riportate le opzioni per la configurazione della versione SMB:  
+  `AUTOMATIC`(impostazione predefinita): DataSync e il file server SMB negozia la versione più alta di SMB supportata reciprocamente tra la 2.1 e la 3.1.1.

  Questa è la scelta consigliata. Se scegli una versione specifica che il tuo server di file non supporta, potresti ricevere un errore `Operation Not Supported`.
+  `SMB3`: limita la negoziazione del protocollo solo alla versione SMB 3.0.2.
+  `SMB2`: limita la negoziazione del protocollo solo alla versione 2.1 di SMB.
+  `SMB2_0`: limita la negoziazione del protocollo solo alla versione 2.0 di SMB.
+  `SMB1`: limita la negoziazione del protocollo solo alla versione 1.0 di SMB.
**Nota**  
L'`SMB1`opzione non è disponibile quando si [crea una sede Amazon FSx for NetApp ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html).
Tipo: stringa  
Valori validi: `AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0`   
Campo obbligatorio: no

## Vedi anche
<a name="API_SmbMountOptions_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) 

# SourceManifestConfig
<a name="API_SourceManifestConfig"></a>

Specifica il manifesto che si AWS DataSync desidera utilizzare e dove è ospitato. Per ulteriori informazioni ed esempi di configurazione, vedere [Specificazione degli elementi da DataSync trasferire utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Indice
<a name="API_SourceManifestConfig_Contents"></a>

 ** S3 **   <a name="DataSync-Type-SourceManifestConfig-S3"></a>
Specifica il bucket S3 in cui stai ospitando il tuo manifest.  
Tipo: oggetto [S3ManifestConfig](API_S3ManifestConfig.md)  
Campo obbligatorio: sì

## Vedi anche
<a name="API_SourceManifestConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) 

# TagListEntry
<a name="API_TagListEntry"></a>

Una coppia chiave-valore che rappresenta un singolo tag applicato a una AWS risorsa.

## Indice
<a name="API_TagListEntry_Contents"></a>

 ** Key **   <a name="DataSync-Type-TagListEntry-Key"></a>
La chiave per un tag di AWS risorsa.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:/-]+$`   
Campo obbligatorio: sì

 ** Value **   <a name="DataSync-Type-TagListEntry-Value"></a>
Il valore di un tag di AWS risorsa.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_TagListEntry_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) 

# TaskExecutionFilesFailedDetail
<a name="API_TaskExecutionFilesFailedDetail"></a>

Il numero di file o oggetti che DataSync non riescono a preparare, trasferire, verificare ed eliminare durante l'esecuzione dell'attività.

**Nota**  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Indice
<a name="API_TaskExecutionFilesFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Delete"></a>
Il numero di file o oggetti che DataSync non vengono eliminati durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Prepare"></a>
Il numero di file o oggetti che DataSync non vengono preparati durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Transfer"></a>
Il numero di file o oggetti che DataSync non viene trasferito durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** Verify **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Verify"></a>
Il numero di file o oggetti che DataSync non viene verificato durante l'esecuzione dell'attività.  
Tipo: long  
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskExecutionFilesFailedDetail_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 

# TaskExecutionFilesListedDetail
<a name="API_TaskExecutionFilesListedDetail"></a>

Il numero di file o oggetti che DataSync si trovano nelle tue posizioni.

**Nota**  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Indice
<a name="API_TaskExecutionFilesListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtDestinationForDelete"></a>
Il numero di file o oggetti DataSync trovati nella posizione di destinazione. Questo contatore è applicabile solo se si [configura l'attività](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling) in modo da eliminare i dati nella destinazione che non si trovano nell'origine.  
Tipo: long  
Obbligatorio: no

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtSource"></a>
Il numero di file o oggetti DataSync trovati nella posizione di origine.  
+ Con un [manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), DataSync elenca solo ciò che è nel manifesto (e non tutto nella posizione di origine).
+ Con un [filtro](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) di inclusione, DataSync elenca solo ciò che corrisponde al filtro nella posizione di origine.
+ Con un filtro di esclusione, DataSync elenca tutto nella posizione di origine prima di applicare il filtro.
Tipo: long  
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskExecutionFilesListedDetail_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) 

# TaskExecutionFoldersFailedDetail
<a name="API_TaskExecutionFoldersFailedDetail"></a>

Il numero di directory che DataSync non vengono elencate, preparate, trasferite, verificate ed eliminate durante l'esecuzione dell'attività.

**Nota**  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Indice
<a name="API_TaskExecutionFoldersFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Delete"></a>
Il numero di directory che DataSync non è possibile eliminare durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** List **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-List"></a>
Il numero di directory che DataSync non vengono elencate durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Prepare"></a>
Il numero di directory che DataSync non vengono preparate durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Transfer"></a>
Il numero di directory che DataSync non viene trasferito durante l'esecuzione dell'attività.  
Tipo: long  
Obbligatorio: no

 ** Verify **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Verify"></a>
Il numero di directory che DataSync non viene verificato durante l'esecuzione dell'attività.  
Tipo: long  
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskExecutionFoldersFailedDetail_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 

# TaskExecutionFoldersListedDetail
<a name="API_TaskExecutionFoldersListedDetail"></a>

Il numero di elenchi presenti DataSync nelle tue sedi.

**Nota**  
Si applica solo alle [attività in modalità Avanzata](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Indice
<a name="API_TaskExecutionFoldersListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtDestinationForDelete"></a>
Il numero di cartelle che DataSync si trovano nella posizione di destinazione. Questo contatore è applicabile solo se si [configura l'attività](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling) in modo da eliminare i dati nella destinazione che non si trovano nell'origine.  
Tipo: long  
Obbligatorio: no

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtSource"></a>
Il numero di directory che DataSync si trovano nella posizione di origine.  
+ Con un [manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), DataSync elenca solo ciò che è nel manifesto (e non tutto nella posizione di origine).
+ Con un [filtro](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) di inclusione, DataSync elenca solo ciò che corrisponde al filtro nella posizione di origine.
+ Con un filtro di esclusione, DataSync elenca tutto nella posizione di origine prima di applicare il filtro.
Tipo: long  
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskExecutionFoldersListedDetail_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 

# TaskExecutionListEntry
<a name="API_TaskExecutionListEntry"></a>

Rappresenta una singola voce in un elenco di esecuzioni di AWS DataSync attività restituite con l'[ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html)operazione.

## Indice
<a name="API_TaskExecutionListEntry_Contents"></a>

 ** Status **   <a name="DataSync-Type-TaskExecutionListEntry-Status"></a>
Lo stato dell'esecuzione di un'attività. Per ulteriori informazioni, vedere [Stati di esecuzione delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Tipo: String  
Valori validi: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`   
Campo obbligatorio: no

 ** TaskExecutionArn **   <a name="DataSync-Type-TaskExecutionListEntry-TaskExecutionArn"></a>
L'Amazon Resource Name (ARN) dell'esecuzione di un'attività.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Obbligatorio: no

 ** TaskMode **   <a name="DataSync-Type-TaskExecutionListEntry-TaskMode"></a>
La modalità di attività che stai utilizzando. Per ulteriori informazioni, vedere [Scelta di una modalità di operazione per il trasferimento dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: String  
Valori validi: `BASIC | ENHANCED`   
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskExecutionListEntry_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) 

# TaskExecutionResultDetail
<a name="API_TaskExecutionResultDetail"></a>

Fornisce informazioni dettagliate sul risultato dell'esecuzione dell' AWS DataSync attività.

## Indice
<a name="API_TaskExecutionResultDetail_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorCode"></a>
Un errore che si è DataSync verificato durante l'esecuzione dell'operazione. È possibile utilizzare queste informazioni per [risolvere i problemi](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: string  
Campo obbligatorio: no

 ** ErrorDetail **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorDetail"></a>
La descrizione dettagliata di un errore DataSync riscontrato durante l'esecuzione dell'attività. È possibile utilizzare queste informazioni per [risolvere i problemi](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).   
Tipo: string  
Campo obbligatorio: no

 ** PrepareDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareDuration"></a>
Il tempo, in millisecondi, durante il quale l'operazione è stata eseguita durante la fase. `PREPARING` Per ulteriori informazioni, vedere Stati di esecuzione delle [attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Per le attività in modalità Avanzata, il valore è sempre`0`. Per ulteriori informazioni, consulta [Come DataSync si prepara il trasferimento dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares).  
Tipo: long  
Intervallo valido: valore minimo di 0.  
Campo obbligatorio: no

 ** PrepareStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareStatus"></a>
Lo stato della `PREPARING` fase di esecuzione dell'attività. Per ulteriori informazioni, consulta [Stati di esecuzione delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Tipo: stringa  
Valori validi: `PENDING | SUCCESS | ERROR`   
Campo obbligatorio: no

 ** TotalDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TotalDuration"></a>
Il tempo in millisecondi in cui è stata eseguita l'esecuzione dell'attività.  
Tipo: long  
Intervallo valido: valore minimo di 0.  
Campo obbligatorio: no

 ** TransferDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferDuration"></a>
Il tempo in millisecondi durante il quale l'operazione è stata eseguita. `TRANSFERRING` Per ulteriori informazioni, vedere Stati di esecuzione delle [attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Per le attività in modalità Avanzata, il valore è sempre`0`. Per ulteriori informazioni, consulta [Come DataSync trasferisce i dati](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers).  
Tipo: long  
Intervallo valido: valore minimo di 0.  
Campo obbligatorio: no

 ** TransferStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferStatus"></a>
Lo stato della `TRANSFERRING` fase di esecuzione dell'attività. Per ulteriori informazioni, consulta [Stati di esecuzione delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Tipo: stringa  
Valori validi: `PENDING | SUCCESS | ERROR`   
Campo obbligatorio: no

 ** VerifyDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyDuration"></a>
Il tempo, in millisecondi, durante il quale l'operazione è stata eseguita durante la fase. `VERIFYING` Per ulteriori informazioni, vedere Stati di esecuzione delle [attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Per le attività in modalità Avanzata, il valore è sempre`0`. Per ulteriori informazioni, consulta [Come DataSync verifica l'integrità dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works).  
Tipo: long  
Intervallo valido: valore minimo di 0.  
Campo obbligatorio: no

 ** VerifyStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyStatus"></a>
Lo stato della `VERIFYING` fase di esecuzione dell'attività. Per ulteriori informazioni, consulta [Stati di esecuzione delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)  
Tipo: stringa  
Valori validi: `PENDING | SUCCESS | ERROR`   
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskExecutionResultDetail_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) 

# TaskFilter
<a name="API_TaskFilter"></a>

Puoi utilizzare i filtri API per restringere l'elenco delle risorse restituite da`ListTasks`. Ad esempio, per recuperare tutte le attività in una posizione di origine, è possibile utilizzare `ListTasks` con il nome del filtro `LocationId` e `Operator Equals` con l'ARN per la posizione.

Per ulteriori informazioni, consulta [Filtraggio DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html) delle risorse.

## Indice
<a name="API_TaskFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskFilter-Name"></a>
Il nome del filtro utilizzato. Ogni chiamata API supporta un elenco di filtri disponibili. Ad esempio: `LocationId` per `ListTasks`.  
Tipo: stringa  
Valori validi: `LocationId | CreationTime`   
Campo obbligatorio: sì

 ** Operator **   <a name="DataSync-Type-TaskFilter-Operator"></a>
L'operatore utilizzato per confrontare i valori dei filtri (ad esempio, `Equals` o`Contains`).  
Tipo: stringa  
Valori validi: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`   
Campo obbligatorio: sì

 ** Values **   <a name="DataSync-Type-TaskFilter-Values"></a>
I valori in base ai quali si desidera filtrare. Ad esempio, potresti voler visualizzare solo le attività per una località di destinazione specifica.  
Tipo: matrice di stringhe  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
Campo obbligatorio: sì

## Vedi anche
<a name="API_TaskFilter_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) 

# TaskListEntry
<a name="API_TaskListEntry"></a>

Rappresenta una singola voce in un elenco di attività. `TaskListEntry`restituisce un array che contiene un elenco di attività quando viene chiamata l'[ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html)operazione. Un'attività include i file system di origine e di destinazione da sincronizzare e le opzioni da utilizzare per le attività.

## Indice
<a name="API_TaskListEntry_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskListEntry-Name"></a>
Il nome dell'attività .  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obbligatorio: no

 ** Status **   <a name="DataSync-Type-TaskListEntry-Status"></a>
Lo stato dell'attività.  
Tipo: String  
Valori validi: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE`   
Campo obbligatorio: no

 ** TaskArn **   <a name="DataSync-Type-TaskListEntry-TaskArn"></a>
L'Amazon Resource Name (ARN) dell'attività.  
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}:task/task-[0-9a-f]{17}$`   
Obbligatorio: no

 ** TaskMode **   <a name="DataSync-Type-TaskListEntry-TaskMode"></a>
La modalità attività che stai utilizzando. Per ulteriori informazioni, vedere [Scelta di una modalità di operazione per il trasferimento dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: String  
Valori validi: `BASIC | ENHANCED`   
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskListEntry_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) 

# TaskReportConfig
<a name="API_TaskReportConfig"></a>

Specifica come si desidera configurare un rapporto sulle attività, che fornisce informazioni dettagliate sul AWS DataSync trasferimento.

Per ulteriori informazioni, consulta [Rapporti sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Indice
<a name="API_TaskReportConfig_Contents"></a>

 ** Destination **   <a name="DataSync-Type-TaskReportConfig-Destination"></a>
Specifica il bucket Amazon S3 DataSync in cui carica il report delle attività. [Per ulteriori informazioni, consulta Rapporti sulle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access)  
Tipo: oggetto [ReportDestination](API_ReportDestination.md)  
Campo obbligatorio: no

 ** ObjectVersionIds **   <a name="DataSync-Type-TaskReportConfig-ObjectVersionIds"></a>
Specifica se il report delle attività include la nuova versione di ogni oggetto trasferito in un bucket S3. Questo vale solo se [abiliti il controllo delle versioni](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html) nel tuo bucket. Tieni presente che impostarlo su `INCLUDE` può aumentare la durata dell'esecuzione dell'attività.  
Tipo: stringa  
Valori validi: `INCLUDE | NONE`   
Campo obbligatorio: no

 ** OutputType **   <a name="DataSync-Type-TaskReportConfig-OutputType"></a>
Specificate il tipo di rapporto sulle attività che desiderate:  
+  `SUMMARY_ONLY`: fornisce i dettagli necessari sull'attività, tra cui il numero di file, oggetti e directory trasferiti e la durata del trasferimento.
+  `STANDARD`: fornisce dettagli completi sull'attività, incluso un elenco completo di file, oggetti e directory che sono stati trasferiti, ignorati, verificati e altro ancora.
Tipo: stringa  
Valori validi: `SUMMARY_ONLY | STANDARD`   
Campo obbligatorio: no

 ** Overrides **   <a name="DataSync-Type-TaskReportConfig-Overrides"></a>
Personalizza il livello di segnalazione per alcuni aspetti del rapporto sulle attività. Ad esempio, il rapporto potrebbe in genere includere solo errori, ma è possibile specificare che si desidera un elenco di successi ed errori solo per i file che DataSync hanno tentato di eliminare nella posizione di destinazione.  
Tipo: oggetto [ReportOverrides](API_ReportOverrides.md)  
Campo obbligatorio: no

 ** ReportLevel **   <a name="DataSync-Type-TaskReportConfig-ReportLevel"></a>
Specificare se si desidera che il rapporto sulle attività includa solo gli errori durante il trasferimento o un elenco di ciò che è riuscito e non è riuscito.  
+  `ERRORS_ONLY`: Un rapporto mostra ciò che non DataSync è stato possibile trasferire, ignorare, verificare ed eliminare.
+  `SUCCESSES_AND_ERRORS`: Un rapporto mostra cosa DataSync è stato possibile e cosa non è stato possibile trasferire, ignorare, verificare ed eliminare.
Tipo: stringa  
Valori validi: `ERRORS_ONLY | SUCCESSES_AND_ERRORS`   
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskReportConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) 

# TaskSchedule
<a name="API_TaskSchedule"></a>

Configura l' AWS DataSync attività per l'esecuzione in base a una [pianificazione](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (a un intervallo minimo di 1 ora).

## Indice
<a name="API_TaskSchedule_Contents"></a>

 ** ScheduleExpression **   <a name="DataSync-Type-TaskSchedule-ScheduleExpression"></a>
Specificate la pianificazione delle attività utilizzando un'espressione cron o rate.  
Utilizza le espressioni cron per le pianificazioni delle attività eseguite in un'ora e in un giorno specifici. Ad esempio, la seguente espressione cron crea una pianificazione delle attività che viene eseguita alle 8:00 del primo mercoledì di ogni mese:  
 `cron(0 8 * * 3#1)`   
Utilizza le espressioni di frequenza per le pianificazioni delle attività che vengono eseguite a intervalli regolari. Ad esempio, la seguente espressione di frequenza crea una pianificazione delle attività che viene eseguita ogni 12 ore:  
 `rate(12 hours)`   
Per informazioni sulla sintassi delle espressioni cron e rate, consulta la [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html).  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\(\)\+]*$`   
Campo obbligatorio: sì

 ** Status **   <a name="DataSync-Type-TaskSchedule-Status"></a>
Specifica se abilitare o disabilitare la pianificazione delle attività. La pianificazione è abilitata per impostazione predefinita, ma in alcuni casi può essere necessario disabilitarla. Ad esempio, potrebbe essere necessario sospendere un trasferimento ricorrente per risolvere un problema relativo all'operazione o eseguire la manutenzione del sistema di storage.  
DataSync potrebbe disattivare automaticamente la pianificazione se l'attività fallisce ripetutamente con lo stesso errore. Per ulteriori informazioni, consulta [TaskScheduleDetails](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html).  
Tipo: stringa  
Valori validi: `ENABLED | DISABLED`   
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskSchedule_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) 

# TaskScheduleDetails
<a name="API_TaskScheduleDetails"></a>

Fornisce informazioni sulla [pianificazione delle AWS DataSync attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).

## Indice
<a name="API_TaskScheduleDetails_Contents"></a>

 ** DisabledBy **   <a name="DataSync-Type-TaskScheduleDetails-DisabledBy"></a>
Indica in che modo la pianificazione delle attività è stata disabilitata.  
+  `USER`- La pianificazione è stata disabilitata manualmente utilizzando l'[UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)operazione o la DataSync console.
+  `SERVICE`- La pianificazione è stata disattivata automaticamente DataSync perché l'attività non è riuscita ripetutamente con lo stesso errore.
Tipo: stringa  
Valori validi: `USER | SERVICE`   
Campo obbligatorio: no

 ** DisabledReason **   <a name="DataSync-Type-TaskScheduleDetails-DisabledReason"></a>
Fornisce un motivo se la pianificazione delle attività è disabilitata.  
Se la pianificazione è disattivata da`USER`, viene visualizzato un `Manually disabled by user.` messaggio.  
Se la tua pianificazione è disattivata da`SERVICE`, viene visualizzato un messaggio di errore che ti aiuta a capire perché l'attività continua a fallire. Per informazioni sulla risoluzione DataSync degli errori, consulta [Risoluzione dei problemi relativi ai DataSync trasferimenti](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: stringa  
Vincoli di lunghezza: lunghezza massima di 8192.  
Modello: `^[\w\s.,'?!:;\/=|<>()-]*$`   
Campo obbligatorio: no

 ** StatusUpdateTime **   <a name="DataSync-Type-TaskScheduleDetails-StatusUpdateTime"></a>
Indica l'ultima volta in cui lo stato della pianificazione delle attività è cambiato. Ad esempio, se la pianificazione DataSync viene disattivata automaticamente a causa di un errore ripetuto, è possibile vedere quando è stata disabilitata.  
Tipo: Timestamp  
Campo obbligatorio: no

## Vedi anche
<a name="API_TaskScheduleDetails_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) 

# Errori comuni
<a name="CommonErrors"></a>

Questa sezione elenca gli errori comuni alle azioni API di tutti i AWS servizi. Per gli errori specifici di un'azione API per questo servizio, consulta l'argomento per quell'azione API.

 **AccessDeniedException**   
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.  
Codice di stato HTTP: 400

 **IncompleteSignature**   
La firma della richiesta non è conforme agli AWS standard.  
Codice di stato HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
L'elaborazione della richiesta non è riuscita a causa di un errore, un'eccezione o un guasto interno sconosciuto.  
Codice di stato HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
L'azione o l'operazione richiesta non è valida. Verifica che l'operazione sia digitata correttamente.  
Codice di stato HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Il certificato X.509 o AWS l'ID della chiave di accesso fornito non esiste nei nostri archivi.  
Codice di stato HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Non disponi delle autorizzazioni per eseguire questa azione.  
Codice di stato HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
L'ID della chiave di AWS accesso richiede un abbonamento al servizio.  
Codice di stato HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La richiesta ha raggiunto il servizio più di 15 minuti dopo la data indicata sulla richiesta o più di 15 minuti dopo la data di scadenza della richiesta (ad esempio nel caso di pre-firmata URLs), oppure la data indicata sulla richiesta è tra più di 15 minuti.  
Codice di stato HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La richiesta non è riuscita a causa di un errore temporaneo del server.  
Codice di stato HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La richiesta è stata negata a causa del throttling della richiesta.  
Codice di stato HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
L'input non soddisfa i vincoli specificati da un servizio. AWS   
Codice di stato HTTP: 400

# Parametri comuni
<a name="CommonParameters"></a>

L'elenco seguente contiene i parametri utilizzati da tutte le azioni per firmare le richieste di Signature Version 4 con una stringa di query. Qualsiasi parametro specifico di un'operazione è riportato nell'argomento relativo all'operazione. Per ulteriori informazioni sulla versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.

 **Action**   <a name="CommonParameters-Action"></a>
azione da eseguire.  
Tipo: stringa  
Campo obbligatorio: sì

 **Version**   <a name="CommonParameters-Version"></a>
La versione dell'API per cui è scritta la richiesta, espressa nel formato YYYY-MM-DD.  
Tipo: stringa  
Campo obbligatorio: sì

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Algoritmo hash utilizzato per creare la firma della richiesta.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Valori validi: `AWS4-HMAC-SHA256`   
Obbligatorio: condizionale

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Il valore dell'ambito delle credenziali, che è una stringa che include la chiave di accesso, la data, la regione di destinazione, il servizio richiesto e una stringa di terminazione ("aws4\$1request"). Il valore viene espresso nel seguente formato: *chiave\$1accesso*/*AAAAMMGG*/*regione*/*servizio*/aws4\$1request.  
Per ulteriori informazioni, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella *Guida per l'utente IAM*.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La data utilizzata per creare la firma. Il formato deve essere il formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Per esempio, la data e l'ora seguenti è un X-Amz-Date valore valido:`20120325T120000Z`.  
Condizione: X-Amz-Date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato base ISO 8601, non X-Amz-Date è obbligatoria. Quando X-Amz-Date viene utilizzata, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta [Elementi di una firma di richiesta AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) nella Guida per l'utente *IAM*.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service (AWS STS). Per un elenco di servizi che supportano le credenziali di sicurezza temporanee da AWS STS, consulta la pagina [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) nella *Guida per l'utente di IAM*.  
Condizione: se utilizzi credenziali di sicurezza temporanee di AWS STS, devi includere il token di sicurezza.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Specifica la firma con codifica esadecimale calcolata dalla stringa da firmare e dalla chiave di firma derivata.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Specifica tutte le intestazioni HTTP incluse come parte della richiesta canonica. Per ulteriori informazioni sulla specificazione delle intestazioni firmate, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella Guida per l'utente *IAM*.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale