Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Además de la Consola de administración de AWS y AWS CLI, puede usar la AWS DataSync API para configurar y administrar DataSync con [AWS SDKs](https://aws.amazon.com/developer/tools/).

**Topics**
+ [

# Acciones
](API_Operations.md)
+ [

# Data Types
](API_Types.md)
+ [

# Errores comunes
](CommonErrors.md)
+ [

# Parámetros comunes
](CommonParameters.md)

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

Se admiten las siguientes acciones:
+  [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>

Detiene la ejecución de una AWS DataSync tarea en curso. La transferencia de algunos archivos se interrumpe bruscamente. El contenido de los archivos que se transfiere al destino puede estar incompleto o no ser coherente con los archivos de origen.

Sin embargo, si inicia la ejecución de una nueva tarea con la misma tarea y deja que finalice, el contenido del archivo de destino estará completo y será coherente. Esto se aplica a otros errores inesperados que interrumpan la ejecución de una tarea. En todos estos casos, la transferencia se completa DataSync correctamente al iniciar la siguiente ejecución de la tarea.

## Sintaxis de la solicitud
<a name="API_CancelTaskExecution_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CancelTaskExecution_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) **   <a name="DataSync-CancelTaskExecution-request-TaskExecutionArn"></a>
Nombre de recurso de Amazon (ARN) de la ejecución de la tarea para que se detenga.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_CancelTaskExecution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_CancelTaskExecution_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CancelTaskExecution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) 

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

Activa un AWS DataSync agente que se implementa en el entorno de almacenamiento. El proceso de activación asocia el agente con el suyo Cuenta de AWS.

Si aún no ha desplegado un agente, consulte [¿Necesito un DataSync agente?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 

## Sintaxis de la solicitud
<a name="API_CreateAgent_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CreateAgent_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
Especifica la clave de activación de su DataSync agente. Si no tiene una clave de activación, consulte [Activar el agente](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 29 caracteres.  
Patrón: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
Obligatorio: sí

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
Especifica un nombre para el agente. Le recomendamos que especifique un nombre que pueda recordar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
Especifica el nombre de recurso de Amazon (ARN) del grupo de seguridad que permite el tráfico entre su agente y el punto de conexión del servicio de VPC. Solo puede especificar un ARN.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: no

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
Especifica el ARN de la subred en la que se encuentra el punto de conexión del servicio de VPC. Solo puede especificar un ARN.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: no

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar AWS los recursos. Le recomendamos que cree al menos una etiqueta para el agente.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
Especifica el ID del [punto de conexión del servicio de VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) que está utilizando. Por ejemplo, un ID de punto de conexión de VPC se parece a `vpce-01234d5aff67890e1`.  
El punto final del servicio de VPC que utilice debe incluir el nombre del DataSync servicio (por ejemplo,`com.amazonaws.us-east-2.datasync`).
Tipo: cadena  
Patrón: `^vpce-[0-9a-f]{17}$`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateAgent_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateAgent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
Estos comandos devuelven el ARN del agente que acaba de activar. Utilice la [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operación para devolver una lista de los agentes que tiene en su mano Cuenta de AWS . Región de AWS  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateAgent_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_CreateAgent_Example_1"></a>

El siguiente ejemplo activa un DataSync agente.

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

### Respuesta de ejemplo
<a name="API_CreateAgent_Example_2"></a>

La respuesta devuelve el ARN del agente activado.

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

## Véase también
<a name="API_CreateAgent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent) 

# CreateLocationAzureBlob
<a name="API_CreateLocationAzureBlob"></a>

Crea una *ubicación* de transferencia para un contenedor de Microsoft Azure Blob Storage. AWS DataSync puede usar esta ubicación como origen o destino de la transferencia. Puede realizar transferencias con o sin un [DataSync agente](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) que se conecte a su contenedor.

Antes de empezar, asegúrese de saber [cómo se DataSync accede a Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access) y cómo funciona con los [niveles de acceso](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) y los tipos de [blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types).

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationAzureBlob_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AccessTier"></a>
Especifica el nivel de acceso al que desea transferir sus objetos o archivos. Esto solo se aplica cuando se utiliza la ubicación como destino de transferencia. Para obtener más información, consulte [Niveles de acceso](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers).  
Tipo: cadena  
Valores válidos: `HOT | COOL | ARCHIVE`   
Obligatorio: no

 ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AgentArns"></a>
(Opcional) Especifica el nombre de recurso de Amazon (ARN) del DataSync agente que se puede conectar con el contenedor de Azure Blob Storage. Si se configura una transferencia entre nubes sin agente, no es necesario especificar un valor para este parámetro.  
Puede especificar más de un agente. Para obtener más información, consulte [Using multiple agents for your transfer](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html).  
Asegúrese de configurar este parámetro correctamente cuando cree por primera vez la ubicación de almacenamiento. No es posible agregar ni eliminar agentes de una ubicación de almacenamiento después de crearla.
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AuthenticationType"></a>
Especifica el método de autenticación que se DataSync utiliza para acceder a Azure Blob Storage. DataSync puede acceder al almacenamiento de blobs mediante una firma de acceso compartido (SAS).  
Tipo: cadena  
Valores válidos: `SAS | NONE`   
Obligatorio: sí

 ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-BlobType"></a>
Especifica el tipo de blob que desea que tengan sus objetos o archivos al transferirlos a Azure Blob Storage. Actualmente, DataSync solo admite el traslado de datos a Azure Blob Storage como bloques blobs. Para obtener más información sobre los tipos de blobs, consulte la [Documentación de Azure Blob Storage.](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs)  
Tipo: cadena  
Valores válidos: `BLOCK`   
Obligatorio: no

 ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, que incluye el token de autenticación que se DataSync utiliza para acceder a una ubicación de AzureBlob almacenamiento específica, con una ubicación administrada por el cliente. AWS KMS key  
Cuando incluye este parámetro como parte de una `CreateLocationAzureBlob` solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con el token de autenticación que especifique `SasConfiguration` para crear un secreto DataSync administrado que almacene las credenciales de acceso a la ubicación.  
Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Puede usar `CmkSecretConfig` (con `SasConfiguration`) o `CustomSecretConfig` (sin `SasConfiguration`) para proporcionar credenciales para una solicitud `CreateLocationAzureBlob`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-ContainerUrl"></a>
Especifica la URL del contenedor de Azure Blob Storage implicado en la transferencia.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 325 caracteres.  
Patrón: `^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$`   
Obligatorio: sí

 ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente donde el token de autenticación de una ubicación AzureBlob de almacenamiento se almacena en texto plano, en Secrets Manager. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un secreto que usted administra](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puede usar `CmkSecretConfig` (con `SasConfiguration`) o `CustomSecretConfig` (sin `SasConfiguration`) para proporcionar credenciales para una solicitud `CreateLocationAzureBlob`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-SasConfiguration"></a>
Especifica la configuración de SAS que permite acceder DataSync a su Azure Blob Storage.  
Si proporciona un token de autenticación utilizando`SasConfiguration`, pero no proporciona detalles de configuración secretos utilizando `CmkSecretConfig` o`CustomSecretConfig`, entonces DataSync almacena el token utilizando el secreto del administrador de secretos de su AWS cuenta.
Tipo: objeto [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)  
Obligatorio: no

 ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Subdirectory"></a>
Especifica los segmentos de ruta si desea limitar su transferencia a un directorio virtual del contenedor (por ejemplo, `/my/images`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1024 caracteres.  
Patrón: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS . Le recomendamos crear al menos una etiqueta de nombre para su ubicación de transferencia.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationAzureBlob_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationAzureBlob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-CreateLocationAzureBlob-response-LocationArn"></a>
ARN de la ubicación de transferencia de Azure Blob Storage que creó.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationAzureBlob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationAzureBlob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob) 

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

Crea una *ubicación* de transferencia para un sistema de archivos Amazon EFS. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo DataSync [accede a los sistemas de archivos de Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access).

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationEfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-AccessPointArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del punto de acceso que se DataSync utiliza para montar el sistema de archivos Amazon EFS.  
Para obtener más información, consulte [Acceso a sistemas de archivos restringidos](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Ec2Config"></a>
Especifica la subred y los grupos de seguridad que se DataSync utilizan para conectarse a uno de los [destinos de montaje](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del sistema de archivos Amazon EFS.  
Tipo: objeto [Ec2Config](API_Ec2Config.md)  
Obligatorio: sí

 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-EfsFilesystemArn"></a>
Especifica el ARN del sistema de archivos de Amazon EFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-FileSystemAccessRoleArn"></a>
Especifica un rol AWS Identity and Access Management (IAM) que permite acceder DataSync al sistema de archivos Amazon EFS.  
Para obtener información sobre la creación de esta función, consulte [Creación de una función de DataSync IAM para el acceso al sistema de archivos](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obligatorio: no

 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-InTransitEncryption"></a>
Especifica si desea DataSync utilizar el cifrado Transport Layer Security (TLS) 1.2 cuando transfiera datos hacia o desde su sistema de archivos Amazon EFS.  
Si especifica un punto de acceso mediante `AccessPointArn` o un rol de IAM con `FileSystemAccessRoleArn`, debe establecer este parámetro en `TLS1_2`.  
Tipo: cadena  
Valores válidos: `NONE | TLS1_2`   
Obligatorio: no

 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Subdirectory"></a>
Especifica una ruta de montaje para el sistema de archivos de Amazon EFS. Aquí es donde DataSync lee o escribe los datos en su sistema de archivos (dependiendo de si se trata de una ubicación de origen o de destino).  
De forma predeterminada, DataSync utiliza el directorio raíz (o el [punto de acceso](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) si se proporciona uno mediante él`AccessPointArn`). También puede incluir subdirectorios usando barras diagonales (por ejemplo, `/path/to/folder`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Tags"></a>
Especifica el par clave-valor que representa una etiqueta que desea agregar al recurso. El valor puede ser una cadena vacía. Este valor le ayuda a administrar, filtrar y buscar sus recursos. Le recomendamos que cree una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationEfs_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationEfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) **   <a name="DataSync-CreateLocationEfs-response-LocationArn"></a>
Nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos de Amazon EFS que cree.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationEfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_CreateLocationEfs_Example_1"></a>

En el siguiente ejemplo, se crea una ubicación para un sistema de archivos de 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"
    }]
}
```

### Solicitud de muestra: creación de una ubicación para un sistema de archivos de Amazon EFS restringido
<a name="API_CreateLocationEfs_Example_2"></a>

En el siguiente ejemplo, se crea una ubicación para un sistema de archivos de Amazon EFS configurado para acceso restringido. En este tipo de escenario, es posible que deba especificar valores para `AccessPointArn`, `FileSystemAccessRoleArn` y `InTransitEncryption` en su solicitud.

```
{
    "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"
    }]
}
```

### Respuesta de ejemplo
<a name="API_CreateLocationEfs_Example_3"></a>

Una respuesta arroja el ARN de ubicación del sistema de archivos de Amazon EFS.

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

## Véase también
<a name="API_CreateLocationEfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs) 

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

Crea una *ubicación* de transferencia para un sistema de archivos de Amazon FSx for Lustre. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync [accede a los sistemas de archivos FSx de Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access).

## Sintaxis de la solicitud
<a name="API_CreateLocationFsxLustre_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CreateLocationFsxLustre_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-FsxFilesystemArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del sistema de archivos de FSx for Lustre.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-SecurityGroupArns"></a>
Especifica los nombres de recursos de Amazon (ARNs) de hasta cinco grupos de seguridad que proporcionan acceso a su sistema de archivos FSx for Lustre.  
Los grupos de seguridad deben poder acceder a los puertos del sistema de archivos. El sistema de archivos también debe permitir el acceso desde los grupos de seguridad. Para obtener información sobre el acceso al sistema de archivos, consulte 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: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [Subdirectory](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Subdirectory"></a>
Especifica una ruta de montaje para su sistema FSx de archivos para Lustre. La ruta puede incluir subdirectorios.  
Cuando la ubicación se utiliza como fuente, DataSync lee los datos de la ruta de montaje. Cuando la ubicación se utiliza como destino, DataSync escribe los datos en la ruta de montaje. Si no incluye este parámetro, DataSync utiliza el directorio raíz del sistema de archivos (`/`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS . Le recomendamos crear al menos una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationFsxLustre_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationFsxLustre_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxLustre-response-LocationArn"></a>
El nombre del recurso de Amazon (ARN) de la ubicación del sistema de archivos de FSx for Lustre que ha creado.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationFsxLustre_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationFsxLustre_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) 

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

Crea una *ubicación* de transferencia para un sistema de archivos Amazon FSx for NetApp ONTAP. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync [accede a los sistemas de archivos FSx de ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationFsxOntap_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Protocol"></a>
Especifica el protocolo de transferencia de datos que se AWS DataSync utiliza para acceder al sistema de FSx archivos de Amazon.  
Tipo: objeto [FsxProtocol](API_FsxProtocol.md)  
Obligatorio: sí

 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-SecurityGroupArns"></a>
Especifica los grupos de seguridad de Amazon EC2 que proporcionan acceso a la subred preferida del sistema de archivos.  
Los grupos de seguridad deben permitir el tráfico saliente en los siguientes puertos (según el protocolo que utilice):  
+  **Sistema de archivos de red (NFS)**: puertos TCP 111, 635 y 2049
+  **Server Message Block (SMB)**: puerto TCP 445
Los grupos de seguridad del sistema de archivos también deben permitir el tráfico entrante en los mismos puertos.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-StorageVirtualMachineArn"></a>
Especifica el ARN de la máquina virtual de almacenamiento (SVM) del sistema de archivos en el que quiere copiar datos o desde el que quiere copiar datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 162 caracteres.  
Patrón: `^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,}$`   
Obligatorio: sí

 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Subdirectory"></a>
Especifica la ruta del recurso compartido de archivos en la SVM desde la que desea transferir datos o a la que desea transferirlos.  
Puede especificar una ruta de unión (también conocida como punto de montaje), una ruta de qtree (para recursos compartidos de archivos NFS) o un nombre de recurso compartido (para recursos compartidos de archivos SMB). Por ejemplo, la ruta de montaje podría ser `/vol1`, `/vol1/tree1` o`/share1`.  
No especifique una ruta de cruce en el volumen raíz del SVM. Para obtener más información, consulte [Administración FSx de máquinas virtuales de almacenamiento de ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) en la Guía del *usuario de Amazon FSx for NetApp ONTAP*.
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS . Le recomendamos crear al menos una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationFsxOntap_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationFsxOntap_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOntap-response-LocationArn"></a>
Especifica el ARN de la ubicación del sistema FSx de archivos ONTAP que cree.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationFsxOntap_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationFsxOntap_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) 

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

Crea una *ubicación* de transferencia para un sistema de archivos Amazon FSx for OpenZFS. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync [accede a los sistemas FSx de archivos OpenZFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access).

**nota**  
Los parámetros de solicitud relacionados con `SMB` no se admiten con la operación `CreateLocationFsxOpenZfs`.

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationFsxOpenZfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-FsxFilesystemArn"></a>
El nombre de recurso de Amazon (ARN) del sistema de archivos FSx OpenZFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Protocol"></a>
El tipo de protocolo que se AWS DataSync utiliza para acceder al sistema de archivos.  
Tipo: objeto [FsxProtocol](API_FsxProtocol.md)  
Obligatorio: sí

 ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-SecurityGroupArns"></a>
Los grupos ARNs de seguridad que se utilizan para configurar el sistema de FSx archivos OpenZFS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [Subdirectory](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Subdirectory"></a>
Un subdirectorio en la ruta de la ubicación que debe empezar por. `/fsx` DataSync utiliza este subdirectorio para leer o escribir datos (dependiendo de si el sistema de archivos es una ubicación de origen o de destino).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Tags"></a>
El par clave-valor que representa una etiqueta que desea agregar al recurso. El valor puede ser una cadena vacía. Este valor le ayuda a administrar, filtrar y buscar sus recursos. Le recomendamos que cree una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationFsxOpenZfs_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationFsxOpenZfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-response-LocationArn"></a>
El ARN de la ubicación del sistema FSx de archivos OpenZFS que creó.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationFsxOpenZfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationFsxOpenZfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 

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

Crea una *ubicación* de transferencia para un sistema de archivos de Amazon FSx para Windows File Server. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync [accede FSx a los sistemas de archivos del servidor de archivos de Windows](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationFsxWindows_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, que incluye la contraseña que se DataSync utiliza para acceder a una ubicación de almacenamiento específica de FSx Windows, gestionada por el cliente. AWS KMS key  
Cuando incluye este parámetro como parte de una `CreateLocationFsxWindows` solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con la `Password` que especifique para crear un secreto DataSync administrado que almacene las credenciales de acceso a la ubicación.  
Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Puede usar `CmkSecretConfig` (con `Password`) o `CustomSecretConfig` (sin `Password`) para proporcionar credenciales para una solicitud `CreateLocationFsxWindows`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente donde la contraseña de una ubicación de almacenamiento FSx para Windows File Server se almacena en texto plano, en Secrets Manager. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un secreto que usted administra](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puede usar `CmkSecretConfig` (con `Password`) o `CustomSecretConfig` (sin `Password`) para proporcionar credenciales para una solicitud `CreateLocationFsxWindows`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Domain"></a>
Especifica el nombre del dominio de Windows al que pertenece FSx el sistema de archivos del servidor de archivos de Windows.  
Si tiene varios dominios de Active Directory en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al sistema de archivos correcto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obligatorio: no

 ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-FsxFilesystemArn"></a>
Especifica el nombre de recurso de Amazon (ARN) FSx para el sistema de archivos del servidor de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Password"></a>
Especifica la contraseña del usuario con los permisos para montar y acceder a los archivos, las carpetas y los metadatos de los archivos del sistema de archivos FSx del servidor de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^.{0,104}$`   
Obligatorio: no

 ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-SecurityGroupArns"></a>
Especifica los ARN de los grupos de seguridad de Amazon EC2 que proporcionan acceso a la subred preferida del sistema de archivos.  
Los grupos de seguridad que especifique deben poder comunicarse con los grupos de seguridad del sistema de archivos. Para obtener información sobre la configuración de grupos de seguridad para el acceso al sistema de archivos, consulte 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).  
Si elige un grupo de seguridad que no permite conexiones desde dentro de sí mismo, haga una de estas cosas:  
+ Configure el grupo de seguridad para permitir que se comunique dentro de sí mismo.
+ Elija un grupo de seguridad diferente que pueda comunicarse con el grupo de seguridad del destino de montaje.
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Subdirectory"></a>
Especifica una ruta de montaje para el sistema de archivos mediante barras inclinadas. Aquí es donde DataSync lee o escribe los datos (dependiendo de si se trata de una ubicación de origen o de destino).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS . Le recomendamos crear al menos una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-User"></a>
Especifica el usuario con los permisos para montar y acceder a los archivos, las carpetas y los metadatos de los archivos del sistema FSx de archivos del servidor de archivos de Windows.  
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte [los permisos necesarios](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx para las ubicaciones de los servidores de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateLocationFsxWindows_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationFsxWindows_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxWindows-response-LocationArn"></a>
El ARN de la ubicación del sistema FSx de archivos del servidor de archivos de Windows que creó.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationFsxWindows_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationFsxWindows_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows) 

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

Crea una *ubicación* de transferencia para un sistema de archivos distribuido Hadoop (HDFS). AWS DataSync puede utilizar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync [accede a los clústeres de HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs).

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationHdfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
Los nombres de recursos de Amazon (ARNs) de los DataSync agentes que se pueden conectar al clúster de HDFS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
El tipo de autenticación utilizado para determinar la identidad del usuario.   
Tipo: cadena  
Valores válidos: `SIMPLE | KERBEROS`   
Obligatorio: sí

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
El tamaño de los bloques de datos que se escribirán en el clúster HDFS. El tamaño del bloque debe ser un múltiplo de 512 bytes. El tamaño de bloque predeterminado es de 128 mebibytes (MiB).  
Tipo: entero  
Rango válido: valor mínimo de 1 048 576. Valor máximo de 1 073 741 824.  
Obligatorio: no

 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, que incluye la pestaña clave de Kerberos que se DataSync utiliza para acceder a una ubicación de almacenamiento específica del Sistema de archivos distribuido de Hadoop (HDFS), con una ubicación administrada por el cliente. AWS KMS key  
Cuando incluye este parámetro como parte de una `CreateLocationHdfs` solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con la `KerberosKeytab` que especifique para crear un secreto DataSync administrado que almacene las credenciales de acceso a la ubicación.  
Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Puede usar `CmkSecretConfig` (con `KerberosKeytab`) o `CustomSecretConfig` (sin `KerberosKeytab`) para proporcionar credenciales para una solicitud `CreateLocationHdfs`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente en el que el keytab de Kerberos de la ubicación de almacenamiento HDFS se almacena en formato binario, en Secrets Manager. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key) secreto que usted administra.  
Puede usar `CmkSecretConfig` (con `KerberosKeytab`) o `CustomSecretConfig` (sin `KerberosKeytab`) para proporcionar credenciales para una solicitud `CreateLocationHdfs`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
La tabla de claves de Kerberos (keytab) que contiene asignaciones entre el Kerberos principal definido y las claves cifradas. Puede cargar el keytab desde un archivo proporcionando la dirección del archivo.  
Este parámetro es obligatorio si se especifica `KERBEROS` para `AuthenticationType`. 
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 65 536 caracteres.  
Obligatorio: no

 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
El archivo `krb5.conf` que contiene la información de configuración de Kerberos. Puede cargar el archivo `krb5.conf` proporcionando la dirección del archivo. Si utiliza la AWS CLI, esta realizará la codificación base64 por usted. De lo contrario, proporcione texto codificado en base64.   
Este parámetro es obligatorio si se especifica `KERBEROS` para `AuthenticationType`.
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 131 072 caracteres.  
Obligatorio: no

 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
La entidad principal de Kerberos con acceso a los archivos y carpetas del clúster de HDFS.   
Este parámetro es obligatorio si se especifica `KERBEROS` para `AuthenticationType`.
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^.+$`   
Obligatorio: no

 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
El URI de Key Management Server (KMS) del clúster HDFS.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^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$`   
Obligatorio: no

 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
El NameNode que administra el espacio de nombres HDFS. NameNode Realiza operaciones como abrir, cerrar y cambiar el nombre de archivos y directorios. NameNode Contiene la información necesaria para asignar bloques de datos al DataNodes. Puede usar solo uno NameNode.  
Tipo: Matriz de [HdfsNameNode](API_HdfsNameNode.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: sí

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
La configuración de calidad de protección (QOP) especifica la llamada a procedimiento remoto (RPC) y los ajustes de protección de transferencia de datos configurados en el clúster del sistema de archivos distribuido de Hadoop (HDFS). Si no se especifica `QopConfiguration`, el valor predeterminado de `RpcProtection` y `DataTransferProtection` es `PRIVACY`. Si configura `RpcProtection` o `DataTransferProtection`, el otro parámetro asume el mismo valor.   
Tipo: objeto [QopConfiguration](API_QopConfiguration.md)  
Obligatorio: no

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
El número en el DataNodes que se van a replicar los datos al escribir en el clúster HDFS. De forma predeterminada, los datos se replican en tres. DataNodes  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 512.  
Obligatorio: no

 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
El nombre de usuario utilizado para identificar al cliente en el sistema operativo host.   
Este parámetro es obligatorio si se especifica `SIMPLE` para `AuthenticationType`. 
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Obligatorio: no

 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
Un subdirectorio del clúster de HDFS. Este subdirectorio se utiliza para leer o escribir datos en el clúster de HDFS. Si no se especifica el subdirectorio, el valor predeterminado será `/`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
El par clave-valor que representa la etiqueta que desea agregar a la ubicación. El valor puede ser una cadena vacía. Le recomendamos que utilice etiquetas para asignar nombres a sus recursos.   
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationHdfs_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationHdfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
El ARN de la ubicación del clúster de HDFS de origen que usted crea.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationHdfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationHdfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) 

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

Crea una *ubicación* de transferencia para un servidor de archivos de Network File System (NFS). AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync [accede a los servidores de archivos NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).

## Sintaxis de la solicitud
<a name="API_CreateLocationNfs_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CreateLocationNfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-MountOptions"></a>
Especifica las opciones que se DataSync pueden utilizar para montar el servidor de archivos NFS.  
Tipo: objeto [NfsMountOptions](API_NfsMountOptions.md)  
Obligatorio: no

 ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-OnPremConfig"></a>
Especifica el nombre de recurso de Amazon (ARN) del DataSync agente que se puede conectar al servidor de archivos NFS.  
Puede especificar más de un agente. Para obtener más información, consulte [Uso de varios DataSync agentes](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents).  
Tipo: objeto [OnPremConfig](API_OnPremConfig.md)  
Obligatorio: sí

 ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-ServerHostname"></a>
Especifica el nombre DNS o la dirección IP (IPv4 o IPv6) del servidor de archivos NFS al que se conecta el DataSync agente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obligatorio: sí

 ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Subdirectory"></a>
Especifica la ruta de exportación del servidor de archivos NFS que desea DataSync montar.  
Esta ruta (o un subdirectorio de la ruta) es DataSync desde donde se transfieren los datos hacia o desde ella. Para obtener información sobre cómo configurar una exportación DataSync, consulte [Acceso a los servidores de archivos NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
Obligatorio: sí

 ** [Tags](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Tags"></a>
Especifica etiquetas que le ayudan a clasificar, filtrar y buscar los recursos. AWS Le recomendamos crear al menos una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationNfs_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationNfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) **   <a name="DataSync-CreateLocationNfs-response-LocationArn"></a>
El ARN de la ubicación de transferencia que creó para el servidor de archivos NFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationNfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

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

El siguiente ejemplo crea una ubicación de DataSync transferencia para un servidor de archivos NFS.

#### Solicitud de muestra
<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"
              }
           ]
}
```

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

La respuesta devuelve el ARN de la ubicación NFS.

#### Respuesta de ejemplo
<a name="API_CreateLocationNfs_Example_2_Response"></a>

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

## Véase también
<a name="API_CreateLocationNfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs) 

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

Crea una *ubicación* de transferencia para un sistema de almacenamiento de objetos. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos. Puede realizar transferencias con o sin un [DataSyncagente](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required).

Antes de empezar, asegúrese de entender los [requisitos previos](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) DataSync para trabajar con sistemas de almacenamiento de objetos.

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationObjectStorage_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AccessKey"></a>
Especifica la clave de acceso (por ejemplo, un nombre de usuario) si se requieren credenciales para autenticarse en el servidor de almacenamiento de objetos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Patrón: `^.*$`   
Obligatorio: no

 ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AgentArns"></a>
(Opcional) Especifica los nombres de recursos de Amazon (ARNs) de los DataSync agentes que se pueden conectar al sistema de almacenamiento de objetos. Si se configura una transferencia entre nubes sin agente, no es necesario especificar un valor para este parámetro.  
Asegúrese de configurar este parámetro correctamente cuando cree por primera vez la ubicación de almacenamiento. No es posible agregar ni eliminar agentes de una ubicación de almacenamiento después de crearla.
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-BucketName"></a>
Especifica el nombre del bucket de almacenamiento de objetos implicado en la transferencia.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 63 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$`   
Obligatorio: sí

 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, que incluye el `SecretKey` que se DataSync utiliza para acceder a una ubicación de almacenamiento de objetos específica, con un secreto administrado por el cliente AWS KMS key.  
Cuando incluye este parámetro como parte de una `CreateLocationObjectStorage` solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con el valor que especifique para el `SecretKey` parámetro para crear un secreto DataSync administrado que almacene las credenciales de acceso a la ubicación.  
Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Puede usar `CmkSecretConfig` (con `SecretKey`) o `CustomSecretConfig` (sin `SecretKey`) para proporcionar credenciales para una solicitud `CreateLocationObjectStorage`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente, donde la clave secreta de una ubicación de almacenamiento de objetos específica se almacena en texto plano, en Secrets Manager. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un secreto que usted administra](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puede usar `CmkSecretConfig` (con `SecretKey`) o `CustomSecretConfig` (sin `SecretKey`) para proporcionar credenciales para una solicitud `CreateLocationObjectStorage`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-SecretKey"></a>
Especifica la clave secreta (por ejemplo, una contraseña) si se requieren credenciales para autenticarse en el servidor de almacenamiento de objetos.  
Si proporciona un secreto utilizando`SecretKey`, pero no proporciona los detalles de configuración del secreto, utilizando `CmkSecretConfig` o`CustomSecretConfig`, entonces DataSync almacena el token con el secreto de Secrets Manager de su AWS cuenta.
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Patrón: `^.*$`   
Obligatorio: no

 ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerCertificate"></a>
Especifica una cadena de certificados DataSync para autenticarse en el sistema de almacenamiento de objetos si el sistema utiliza una entidad de certificación (CA) privada o autofirmada. Debe especificar un único archivo `.pem` con una cadena de certificados completa (por ejemplo, `file:///home/user/.ssh/object_storage_certificates.pem`).  
La cadena de certificados puede incluir:  
+ El certificado del sistema de almacenamiento de objetos
+ Todos los certificados intermedios (si los hay)
+ El certificado raíz de la CA firmante
Puede concatenar sus certificados en un archivo `.pem` (que puede tener un máximo de 32 768 bytes antes de la codificación base64). El siguiente comando `cat` de ejemplo crea un archivo `object_storage_certificates.pem` que incluye tres certificados:  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
Para usar este parámetro, configure el `ServerProtocol` para `HTTPS`.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 32 768 caracteres.  
Obligatorio: no

 ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerHostname"></a>
Especifica el nombre de dominio o la dirección IP (IPv4 o IPv6) del servidor de almacenamiento de objetos al que se conecta el DataSync agente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obligatorio: sí

 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerPort"></a>
Especifica el puerto en el que el servidor de almacenamiento de objetos acepta el tráfico de red entrante (por ejemplo, el puerto 443).  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 65 536.  
Obligatorio: no

 ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerProtocol"></a>
Especifica el protocolo que usa el servidor de almacenamiento de objetos para comunicarse. Si no se especifica, el valor predeterminado es `HTTPS`.  
Tipo: cadena  
Valores válidos: `HTTPS | HTTP`   
Obligatorio: no

 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Subdirectory"></a>
Especifica el prefijo de objeto del servidor de almacenamiento de objetos. Si se trata de una ubicación de origen, DataSync solo copia los objetos con este prefijo. Si se trata de una ubicación de destino, DataSync escribe todos los objetos con este prefijo.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Tags"></a>
Especifica el par clave-valor que representa una etiqueta que desea agregar al recurso. Las etiquetas le ayudan a administrar, filtrar y buscar sus recursos. Le recomendamos crear una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationObjectStorage_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationObjectStorage_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-CreateLocationObjectStorage-response-LocationArn"></a>
Especifique el ARN de la ubicación del sistema de almacenamiento de objetos que creó.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationObjectStorage_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationObjectStorage_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) 

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

Crea una *ubicación* de transferencia para un bucket de Amazon S3. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

**importante**  
Antes de comenzar, asegúrese de haber leído los siguientes temas:  
 [Consideraciones sobre las clases de almacenamiento en las ubicaciones de Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Evaluación de los costos de las solicitudes de S3 cuando se usa DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

 Para obtener más información, consulte [Configuring transfers with Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html).

## Sintaxis de la solicitud
<a name="API_CreateLocationS3_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CreateLocationS3_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArns](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-AgentArns"></a>
(Amazon S3 solo en Outposts) Especifica el nombre de recurso de Amazon (ARN) del DataSync agente de su Outpost.  
Para obtener más información, consulte [Implementar su agente en. DataSync AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent)  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3BucketArn"></a>
Especifica el ARN del bucket de S3 que desea usar como ubicación. (Al crear la DataSync tarea más adelante, debe especificar si esta ubicación es un origen o un destino de transferencia).   
Si su bucket de S3 se encuentra en un AWS Outposts recurso, debe especificar un punto de acceso de Amazon S3. Para obtener más información, consulte [Administración del acceso a datos con puntos de acceso de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) en la *Guía del usuario de Amazon S3*.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 268.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [S3Config](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3Config"></a>
Especifica el nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que se DataSync utiliza para acceder al bucket de S3.  
Para obtener más información, consulte [Proporcionar DataSync acceso a los buckets de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipo: objeto [S3Config](API_S3Config.md)  
Obligatorio: sí

 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3StorageClass"></a>
Especifica la clase de almacenamiento que desea que utilicen los objetos cuando Amazon S3 sea un destino de transferencia.  
Para los depósitos incluidos Regiones de AWS, la clase de almacenamiento se establece de forma predeterminada en. `STANDARD` Para los depósitos activados AWS Outposts, la clase de almacenamiento se establece de forma predeterminada en. `OUTPOSTS`  
Para obtener más información, consulte [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: cadena  
Valores válidos: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Obligatorio: no

 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Subdirectory"></a>
Especifica un prefijo en el depósito de S3 que DataSync lee o escribe en él (en función de si el depósito es una ubicación de origen o de destino).  
DataSync no puede transferir objetos con un prefijo que comience con una barra (`/`) o que incluya `//``/./`, o patrones. `/../` Por ejemplo:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

 ** [Tags](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Tags"></a>
Especifica etiquetas que le ayudan a clasificar, filtrar y buscar los recursos. AWS Le recomendamos crear al menos una etiqueta de nombre para su ubicación de transferencia.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationS3_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationS3_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) **   <a name="DataSync-CreateLocationS3-response-LocationArn"></a>
El ARN de la ubicación de S3 que creó.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationS3_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateLocationS3_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) 

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

Crea una *ubicación* de transferencia para un servidor de archivos de bloque de mensajes del servidor (SMB). AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.

Antes de empezar, asegúrese de entender cómo se DataSync accede a los servidores de archivos SMB. Para obtener más información, consulte [Proporcionar DataSync acceso a los servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_CreateLocationSmb_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AgentArns"></a>
Especifica el DataSync agente (o los agentes) que se pueden conectar al servidor de archivos SMB. Puede especificar un agente mediante un nombre de recurso de Amazon (ARN).  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [AuthenticationType](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AuthenticationType"></a>
Especifica el protocolo de autenticación que se DataSync utiliza para conectarse al servidor de archivos SMB. DataSync el soporte `NTLM` (predeterminado) y la `KERBEROS` autenticación.  
Para obtener más información, consulte [Proporcionar DataSync acceso a servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: cadena  
Valores válidos: `NTLM | KERBEROS`   
Obligatorio: no

 ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, ya sea a `Password` o `KerberosKeytab` (para los tipos de `KERBEROS` autenticación `NTLM` (predeterminado) y, respectivamente,) que se DataSync utiliza para acceder a una ubicación de almacenamiento SMB específica, con una ubicación administrada por el cliente. AWS KMS key  
Cuando incluye este parámetro como parte de una `CreateLocationSmbRequest` solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con la clave `Password` o bien la `KerberosKeytab` que usted especifique para crear un secreto DataSync administrado para almacenar las credenciales de acceso a la ubicación.  
Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Puede usar `CmkSecretConfig` (con `Password` o`KerberosKeytab`) o `CustomSecretConfig` (sin ningún `Password` y`KerberosKeytab`) para proporcionar las credenciales para una `CreateLocationSmbRequest` solicitud. No proporciones ambos `CmkSecretConfig` `CustomSecretConfig` parámetros para la misma solicitud.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente donde las credenciales de la ubicación de almacenamiento SMB se almacenan en Secrets Manager como texto sin formato (para`Password`) o binarias (para). `KerberosKeytab` Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un secreto que usted administra](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puede usar `CmkSecretConfig` (con `SasConfiguration`) o `CustomSecretConfig` (sin `SasConfiguration`) para proporcionar credenciales para una solicitud `CreateLocationSmbRequest`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-DnsIpAddresses"></a>
Especifica las IPv6 direcciones IPv4 o de los servidores DNS a los que pertenece el servidor de archivos SMB. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `KERBEROS`.  
Si tiene varios dominios en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al servidor de archivos SMB correcto.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 2 elementos.  
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 39.  
Patrón: `\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`   
Obligatorio: no

 ** [Domain](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Domain"></a>
Especifica el nombre de dominio de Windows al que pertenece el servidor de archivos SMB. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `NTLM`.  
Si tiene varios dominios en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al servidor de archivos correcto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obligatorio: no

 ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKeytab"></a>
Especifica el archivo de tabla de claves de Kerberos (keytab), que incluye las asignaciones entre la entidad principal de Kerberos y las claves de cifrado.  
Para evitar errores durante la ejecución de tareas, asegúrese de que la entidad principal de Kerberos que utiliza para crear el archivo keytab coincida exactamente con lo que especifica para `KerberosPrincipal`.   
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 65 536 caracteres.  
Obligatorio: no

 ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKrb5Conf"></a>
Especifica un archivo de configuración de Kerberos (`krb5.conf`) que define la configuración del dominio de Kerberos.  
El archivo debe estar codificado en base64. Si está utilizando el AWS CLI, la codificación está lista para usted.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 131 072 caracteres.  
Obligatorio: no

 ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosPrincipal"></a>
Especifica una entidad principal de Kerberos, que es una identidad en el dominio de Kerberos con permiso para acceder a los archivos, las carpetas y los metadatos de archivos en el servidor de archivos SMB.  
Una entidad principal de Kerberos puede tener un formato similar a `HOST/kerberosuser@MYDOMAIN.ORG`.  
Los nombres de las entidades principales distinguen entre mayúsculas y minúsculas. La ejecución de la DataSync tarea fallará si el principal que especifique para este parámetro no coincide exactamente con el principal que utilizó para crear el archivo keytab.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^.+$`   
Obligatorio: no

 ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-MountOptions"></a>
Especifica la versión del protocolo SMB que se DataSync utiliza para acceder al servidor de archivos SMB.  
Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md)  
Obligatorio: no

 ** [Password](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Password"></a>
Especifica la contraseña del usuario que puede montar su servidor de archivos SMB y que tiene permiso para acceder a los archivos y las carpetas involucrados en la transferencia. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `NTLM`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^.{0,104}$`   
Obligatorio: no

 ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-ServerHostname"></a>
Especifica el nombre de dominio o la dirección IP (IPv4 o IPv6) del servidor de archivos SMB al que se conecta el DataSync agente.  
Si utiliza autenticación Kerberos, debe especificar un nombre de dominio.
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obligatorio: sí

 ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Subdirectory"></a>
Especifica el nombre del recurso compartido exportado por el servidor de archivos SMB en el que se DataSync leerán o escribirán los datos. Puede incluir un subdirectorio en la ruta del recurso compartido (por ejemplo, `/path/to/subdirectory`). Asegúrese de que otros clientes de SMB de la red también puedan montar esta ruta.  
Para copiar todos los datos del subdirectorio, DataSync debe poder montar el recurso compartido SMB y acceder a todos sus datos. Para obtener más información, consulte [Proporcionar DataSync acceso a los servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: sí

 ** [Tags](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de AWS . Le recomendamos crear al menos una etiqueta de nombre para su ubicación.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** [User](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-User"></a>
Especifica el usuario que puede montar y acceder a los archivos, carpetas y metadatos del servidor de archivos de SMB. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `NTLM`.  
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte [Proporcionar DataSync acceso a los servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateLocationSmb_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateLocationSmb_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [LocationArn](#API_CreateLocationSmb_ResponseSyntax) **   <a name="DataSync-CreateLocationSmb-response-LocationArn"></a>
El ARN de la ubicación de SMB que creó.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateLocationSmb_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_CreateLocationSmb_Example_1"></a>

En el siguiente ejemplo, se crea una ubicación para un sistema de archivos 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"
}
```

### Respuesta de ejemplo
<a name="API_CreateLocationSmb_Example_2"></a>

Una respuesta devuelve el ARN de ubicación de su servidor de archivos SMB.

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

## Véase también
<a name="API_CreateLocationSmb_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb) 

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

Configura una *tarea*, que define dónde y cómo AWS DataSync transfiere los datos.

Una tarea incluye una ubicación de origen, una ubicación de destino y opciones de transferencia (como límites de ancho de banda, la programación, entre otras opciones).

**importante**  
Si planea transferir datos a o desde una ubicación de Amazon S3, consulte [cómo DataSync pueden afectar los cargos por solicitud de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) y la [página de DataSync precios](https://aws.amazon.com/datasync/pricing/) antes de empezar.

## Sintaxis de la solicitud
<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"
   }
}
```

## Parámetros de la solicitud
<a name="API_CreateTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-CloudWatchLogGroupArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de un grupo de CloudWatch registros de Amazon para supervisar la tarea.  
En el caso de las tareas del modo mejorado, no necesita especificar nada. DataSyncenvía automáticamente los registros a un grupo de CloudWatch registros denominado`/aws/datasync`.  
Para obtener más información, consulte [Supervisar las transferencias de datos con CloudWatch registros](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 562 caracteres.  
Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
Obligatorio: no

 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-DestinationLocationArn"></a>
Especifica el ARN de la ubicación de destino de la transferencia.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Excludes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Excludes"></a>
Especifica los filtros de exclusión que definen los archivos, objetos y carpetas de la ubicación de origen que no se DataSync desean transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Obligatorio: no

 ** [Includes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Includes"></a>
Especifica incluir filtros que definan los archivos, objetos y carpetas de la ubicación de origen que DataSync desea transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Obligatorio: no

 ** [ManifestConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-ManifestConfig"></a>
Configura un manifiesto, que es una lista de archivos u objetos que se desean DataSync transferir. Para obtener más información y ejemplos de configuración, consulte [Especificar lo que se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Al usar este parámetro, la identidad de la persona que llama (el rol DataSync con el que estás usando) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso.  
Tipo: objeto [ManifestConfig](API_ManifestConfig.md)  
Obligatorio: no

 ** [Name](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Name"></a>
Especifica el nombre de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

 ** [Options](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Options"></a>
Especifica la configuración de la tarea, como la conservación de los metadatos de los archivos y la verificación de la integridad de los datos, entre otras opciones.  
Tipo: objeto [Options](API_Options.md)  
Obligatorio: no

 ** [Schedule](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Schedule"></a>
Especifica el momento en que quiere que la tarea se ejecute. Para obtener más información, consulte [Scheduling your task](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (Programación de tareas).  
Tipo: objeto [TaskSchedule](API_TaskSchedule.md)  
Obligatorio: no

 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-SourceLocationArn"></a>
Especifica el ARN de la ubicación de origen de la transferencia.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Tags](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Tags"></a>
Las etiquetas que desea aplicar a la tarea.  
 Las *etiquetas* son pares clave-valor que ayudan a administrar, filtrar y buscar los recursos. DataSync   
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** [TaskMode](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskMode"></a>
Especifica uno de los siguientes modos de tarea para la transferencia de datos:  
+  `ENHANCED`: transfiera cantidades prácticamente ilimitadas de objetos con un mayor rendimiento que en el modo básico. Las tareas en modo mejorado optimizan el proceso de transferencia de datos mediante la enumeración, la preparación, la transferencia y la verificación de los datos en paralelo. Actualmente, el modo mejorado está disponible para transferencias entre ubicaciones de Amazon S3, transferencias entre Azure Blob y Amazon S3 sin un agente, y transferencias entre otras nubes y Amazon S3 sin un agente.
**nota**  
Para crear una tarea en modo mejorado, el rol de IAM que utilice para llamar a la operación `CreateTask` debe tener el permiso `iam:CreateServiceLinkedRole`.
+  `BASIC`(predeterminado): transfiere archivos u objetos entre el AWS almacenamiento y todas las demás ubicaciones compatibles DataSync . Las tareas en modo básico están sujetas a [cuotas](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) sobre el número de archivos, objetos y directorios en un conjunto de datos. El modo básico prepara, transfiere y verifica los datos de forma secuencial, lo que lo hace más lento que el modo mejorado para la mayoría de las cargas de trabajo.
Para obtener más información, consulte [Descripción de las diferencias entre los modos de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences).  
Tipo: cadena  
Valores válidos: `BASIC | ENHANCED`   
Obligatorio: no

 ** [TaskReportConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskReportConfig"></a>
Especifica cómo desea configurar un informe de tareas, que proporciona información detallada sobre la DataSync transferencia. Para obtener más información, consulte [Supervisar DataSync las transferencias con informes de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Al usar este parámetro, la identidad de la persona que llama (el rol DataSync con el que estás usando) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso.  
Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateTask_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateTask_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [TaskArn](#API_CreateTask_ResponseSyntax) **   <a name="DataSync-CreateTask-response-TaskArn"></a>
El nombre de recurso de Amazon (ARN) de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_CreateTask_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo para una tarea en modo mejorado
<a name="API_CreateTask_Example_1"></a>

En el siguiente ejemplo, se crea una DataSync tarea que utiliza el modo mejorado.

A diferencia de cuando se crean tareas en modo Básico, no es necesario especificar un grupo de CloudWatch registros de Amazon. Con las tareas del modo mejorado, envía DataSync automáticamente los registros de tareas a un grupo de registros denominado`/aws/datasync`. Si ese grupo de registros no existe en su cuenta Región de AWS, DataSync crea el grupo de registros en su nombre al crear la tarea.

```
{
  "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"
  }
}
```

### Solicitud de ejemplo para una tarea en modo básico
<a name="API_CreateTask_Example_2"></a>

En el siguiente ejemplo, se crea una DataSync tarea que utiliza el modo Básico.

```
{
    "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"
        }
    ]
}
```

### Respuesta de ejemplo
<a name="API_CreateTask_Example_3"></a>

La siguiente respuesta incluye el ARN de la tarea creada.

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

## Véase también
<a name="API_CreateTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask) 

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

Elimina un recurso de AWS DataSync agente de su Cuenta de AWS.

Tenga en cuenta que esta operación (que no se puede deshacer) no elimina la máquina virtual (VM) del agente o la instancia de Amazon EC2 de su entorno de almacenamiento. Para los siguientes pasos, puede eliminar la máquina virtual o la instancia de su entorno de almacenamiento o reutilizarla para [activar un nuevo agente](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).

## Sintaxis de la solicitud
<a name="API_DeleteAgent_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DeleteAgent_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArn](#API_DeleteAgent_RequestSyntax) **   <a name="DataSync-DeleteAgent-request-AgentArn"></a>
El nombre de recurso de Amazon (ARN) del agente que se va a eliminar. Utilice la `ListAgents` operación para devolver una lista de agentes para su cuenta y Región de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteAgent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteAgent_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteAgent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) 

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

Elimina un recurso de ubicación de transferencia de AWS DataSync. 

## Sintaxis de la solicitud
<a name="API_DeleteLocation_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DeleteLocation_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DeleteLocation_RequestSyntax) **   <a name="DataSync-DeleteLocation-request-LocationArn"></a>
El nombre de recurso de Amazon (ARN) de la ubicación que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteLocation_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteLocation_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteLocation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) 

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

Elimina un recurso de tarea de transferencia de AWS DataSync.

## Sintaxis de la solicitud
<a name="API_DeleteTask_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DeleteTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [TaskArn](#API_DeleteTask_RequestSyntax) **   <a name="DataSync-DeleteTask-request-TaskArn"></a>
Especifique las etiquetas que desea aplicar al nombre de recurso de Amazon (ARN) de la tarea que desea eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteTask_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteTask_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) 

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

Devuelve información sobre un AWS DataSync agente, como su nombre, tipo de punto final del servicio y estado.

## Sintaxis de la solicitud
<a name="API_DescribeAgent_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeAgent_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArn](#API_DescribeAgent_RequestSyntax) **   <a name="DataSync-DescribeAgent-request-AgentArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del DataSync agente sobre el que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_DescribeAgent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArn](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-AgentArn"></a>
El ARN del agente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
La hora a la que se [activó](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html) el agente.  
Tipo: marca temporal

 ** [EndpointType](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-EndpointType"></a>
El tipo de [punto de conexión del servicio](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html) al que está conectado el agente.  
Tipo: cadena  
Valores válidos: `PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK` 

 ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-LastConnectionTime"></a>
La última vez que el agente se comunicó con el DataSync servicio.  
Tipo: marca temporal

 ** [Name](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Name"></a>
El nombre del agente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Platform](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Platform"></a>
Los detalles relacionados con la plataforma sobre el agente, como el número de versión.  
Tipo: objeto [Platform](API_Platform.md)

 ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-PrivateLinkConfig"></a>
La configuración de red que usa el agente cuando se conecta a un [punto de conexión del servicio de VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc).  
Tipo: objeto [PrivateLinkConfig](API_PrivateLinkConfig.md)

 ** [Status](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Status"></a>
El estado del agente.  
+ Si el estado es `ONLINE`, el agente está configurado correctamente y listo para usarse.
+ Si el estado es`OFFLINE`, el agente no ha estado en contacto con él DataSync durante cinco minutos o más. Esto puede suceder por varias razones. Para obtener más información, consulte [What do I do if my agent is offline?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 
Tipo: cadena  
Valores válidos: `ONLINE | OFFLINE` 

## Errores
<a name="API_DescribeAgent_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_DescribeAgent_Example_1"></a>

En el siguiente ejemplo, se arroja información sobre un agente especificado en una solicitud.

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

### Respuesta de ejemplo
<a name="API_DescribeAgent_Example_2"></a>

El siguiente ejemplo de respuesta describe un agente que usa un punto de conexión de servicio público.

```
{
    "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"
    }
}
```

## Véase también
<a name="API_DescribeAgent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeAgent) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para Microsoft Azure Blob Storage.

## Sintaxis de la solicitud
<a name="API_DescribeLocationAzureBlob_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationAzureBlob_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationAzureBlob_RequestSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia de Azure Blob Storage.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeLocationAzureBlob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AccessTier"></a>
El nivel de acceso al que desea transferir sus objetos o archivos. Esto solo se aplica cuando se utiliza la ubicación como destino de transferencia. Para obtener más información, consulte [Niveles de acceso](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers).  
Tipo: cadena  
Valores válidos: `HOT | COOL | ARCHIVE` 

 ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AgentArns"></a>
Uno ARNs de los DataSync agentes que se pueden conectar con su contenedor de Azure Blob Storage.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El método de autenticación que se DataSync utiliza para acceder a su Azure Blob Storage. DataSync puede acceder al almacenamiento de blobs mediante una firma de acceso compartido (SAS).  
Tipo: cadena  
Valores válidos: `SAS | NONE` 

 ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-BlobType"></a>
El tipo de blob que desea que tengan sus objetos o archivos al transferirlos a Azure Blob Storage. Actualmente, DataSync solo admite el traslado de datos a Azure Blob Storage como bloques blobs. Para obtener más información sobre los tipos de blobs, consulte la [Documentación de Azure Blob Storage.](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs)  
Tipo: cadena  
Valores válidos: `BLOCK` 

 ** [CmkSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CmkSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un token de autenticación que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una ubicación administrada por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CreationTime"></a>
La hora en que se creó la ubicación de transferencia de Azure Blob Storage.  
Tipo: marca temporal

 ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CustomSecretConfig"></a>
Describe la información de configuración de un secreto administrado por el cliente, como un token de autenticación que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationArn"></a>
El ARN de la ubicación de transferencia de Azure Blob Storage.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
La URL del contenedor de Azure Blob Storage implicado en la transferencia.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un token de autenticación que se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)

## Errores
<a name="API_DescribeLocationAzureBlob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationAzureBlob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos Amazon EFS.

## Sintaxis de la solicitud
<a name="API_DescribeLocationEfs_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationEfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) **   <a name="DataSync-DescribeLocationEfs-request-LocationArn"></a>
El nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos de Amazon EFS sobre el que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeLocationEfs_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_DescribeLocationEfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-AccessPointArn"></a>
El ARN del punto de acceso que se DataSync utiliza para acceder al sistema de archivos Amazon EFS.  
Para obtener más información, consulte [Acceso a sistemas de archivos restringidos](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
La hora en que se creó el registro.  
Tipo: marca temporal

 ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-Ec2Config"></a>
La subred y los grupos de seguridad que se AWS DataSync utilizan para conectarse a uno de los [destinos de montaje](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del sistema de archivos Amazon EFS.  
Tipo: objeto [Ec2Config](API_Ec2Config.md)

 ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-FileSystemAccessRoleArn"></a>
El rol AWS Identity and Access Management (IAM) que permite acceder DataSync al sistema de archivos Amazon EFS.  
Para obtener más información, consulte [Crear un rol de DataSync IAM para el acceso al sistema de archivos.](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^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 si DataSync utiliza el cifrado Transport Layer Security (TLS) al transferir datos hacia o desde el sistema de archivos Amazon EFS.  
Tipo: cadena  
Valores válidos: `NONE | TLS1_2` 

 ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationArn"></a>
El ARN de la ubicación del sistema de archivos de Amazon EFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
La URL de la ubicación del sistema de archivos de Amazon EFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

## Errores
<a name="API_DescribeLocationEfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_DescribeLocationEfs_Example_1"></a>

El siguiente ejemplo muestra cómo obtener información sobre una ubicación específica del sistema de archivos de Amazon EFS.

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

### Respuesta de ejemplo
<a name="API_DescribeLocationEfs_Example_2"></a>

El siguiente ejemplo devuelve detalles de ubicación sobre un sistema de archivos de 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/"
}
```

### Respuesta de ejemplo: descripción de una ubicación para un sistema de archivos de Amazon EFS restringido
<a name="API_DescribeLocationEfs_Example_3"></a>

El siguiente ejemplo devuelve los detalles de ubicación de un sistema de archivos de Amazon EFS con acceso restringido, incluidos los elementos `AccessPointArn`, `FileSystemAccessRoleArn` y `InTransitEncryption`.

```
{
    "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"
    }]
}
```

## Véase también
<a name="API_DescribeLocationEfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos de Amazon FSx for Lustre.

## Sintaxis de la solicitud
<a name="API_DescribeLocationFsxLustre_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationFsxLustre_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationFsxLustre_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-request-LocationArn"></a>
El nombre del recurso de Amazon (ARN) de la ubicación de FSx for Lustre que se va a describir.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeLocationFsxLustre_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_DescribeLocationFsxLustre_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-CreationTime"></a>
La hora en que se creó la ubicación FSx de for Lustre.  
Tipo: marca temporal

 ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationArn"></a>
El nombre del recurso de Amazon (ARN) de la ubicación de FSx for Lustre que se describió.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El URI de la ubicación de FSx for Lustre que se describió.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-SecurityGroupArns"></a>
Los nombres de recursos de Amazon (ARNs) de los grupos de seguridad que están configurados FSx para el sistema de archivos de Lustre.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$` 

## Errores
<a name="API_DescribeLocationFsxLustre_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationFsxLustre_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos de Amazon FSx for NetApp ONTAP.

**nota**  
Si su ubicación utiliza SMB, la operación `DescribeLocationFsxOntap` en realidad no devuelve un `Password`.

## Sintaxis de la solicitud
<a name="API_DescribeLocationFsxOntap_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationFsxOntap_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationFsxOntap_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos ONTAP sobre la que desea FSx obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationFsxOntap_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-CreationTime"></a>
La hora en que se creó el registro.  
Tipo: marca temporal

 ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-FsxFilesystemArn"></a>
El ARN del sistema de archivos ONTAP. FSx   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El ARN de la ubicación del sistema de archivos FSx de ONTAP.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El identificador uniforme de recursos (URI) de la ubicación del sistema de archivos FSx de ONTAP.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-Protocol"></a>
Especifica el protocolo de transferencia de datos que se AWS DataSync utiliza para acceder al sistema de FSx archivos de Amazon.  
Tipo: objeto [FsxProtocol](API_FsxProtocol.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-SecurityGroupArns"></a>
Los grupos de seguridad que se DataSync utilizan para acceder al sistema de archivos de ONTAP. FSx   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El ARN de la máquina virtual de almacenamiento (SVM) del sistema de archivos de ONTAP en el que se copian los datos FSx hacia o desde donde se copian los datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 162 caracteres.  
Patrón: `^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,}$` 

## Errores
<a name="API_DescribeLocationFsxOntap_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationFsxOntap_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos Amazon FSx for OpenZFS.

**nota**  
Los elementos de respuesta relacionados con `SMB` no son compatibles con la operación `DescribeLocationFsxOpenZfs`.

## Sintaxis de la solicitud
<a name="API_DescribeLocationFsxOpenZfs_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationFsxOpenZfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-request-LocationArn"></a>
El nombre del recurso de Amazon (ARN) de la FSx ubicación de OpenZFS que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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" ]
}
```

## Elementos de respuesta
<a name="API_DescribeLocationFsxOpenZfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-CreationTime"></a>
La hora en que se creó la ubicación FSx de OpenZFS.  
Tipo: marca temporal

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationArn"></a>
El ARN de la FSx ubicación de OpenZFS que se describió.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El identificador uniforme de recursos (URI) de la FSx ubicación de OpenZFS que se describió.  
Ejemplo: `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder`   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-Protocol"></a>
El tipo de protocolo que se AWS DataSync utiliza para acceder al sistema de archivos.  
Tipo: objeto [FsxProtocol](API_FsxProtocol.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-SecurityGroupArns"></a>
El ARNs de los grupos de seguridad que están configurados FSx para el sistema de archivos OpenZFS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$` 

## Errores
<a name="API_DescribeLocationFsxOpenZfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationFsxOpenZfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos de Amazon FSx para Windows File Server.

## Sintaxis de la solicitud
<a name="API_DescribeLocationFsxWindows_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationFsxWindows_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationFsxWindows_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación del servidor FSx de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationFsxWindows_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CmkSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como el `Password` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con un secreto administrado por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CreationTime"></a>
La hora a la que se creó la FSx ubicación del servidor de archivos de Windows.  
Tipo: marca temporal

 ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CustomSecretConfig"></a>
Describe la información de configuración de un secreto administrado por el cliente, como el `Password` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-Domain"></a>
El nombre del dominio de Microsoft Active Directory al que pertenece el sistema FSx de archivos del servidor de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [LocationArn](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationArn"></a>
El ARN de la ubicación del servidor FSx de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El identificador uniforme de recursos (URI) de la ubicación del servidor FSx de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como el `Password` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-SecurityGroupArns"></a>
Los ARN de los grupos de seguridad de Amazon EC2 que proporcionan acceso a la subred preferida del sistema de archivos.  
Para obtener información sobre la configuración de grupos de seguridad para el acceso al sistema de archivos, consulte 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: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El usuario con los permisos para montar y acceder al sistema de archivos del servidor de archivos de Windows. FSx   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Errores
<a name="API_DescribeLocationFsxWindows_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationFsxWindows_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos distribuido Hadoop (HDFS).

## Sintaxis de la solicitud
<a name="API_DescribeLocationHdfs_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationHdfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) **   <a name="DataSync-DescribeLocationHdfs-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de HDFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationHdfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AgentArns"></a>
Los ARNs DataSync agentes que se pueden conectar con su clúster de HDFS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El tipo de autenticación utilizado para determinar la identidad del usuario.   
Tipo: cadena  
Valores válidos: `SIMPLE | KERBEROS` 

 ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-BlockSize"></a>
El tamaño de los bloques de datos que se escribirán en el clúster de HDFS.   
Tipo: entero  
Rango válido: valor mínimo de 1 048 576. Valor máximo de 1 073 741 824.

 ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CmkSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como el `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con un secreto administrado por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CreationTime"></a>
Es la hora en que se creó la ubicación del HDFS.  
Tipo: marca temporal

 ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CustomSecretConfig"></a>
Describe la información de configuración de un secreto administrado por el cliente, como el `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KerberosPrincipal"></a>
La entidad principal de Kerberos con acceso a los archivos y carpetas del clúster de HDFS. Este parámetro se utiliza si `AuthenticationType` se define como `KERBEROS`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^.+$` 

 ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KmsKeyProviderUri"></a>
 El URI de Key Management Server (KMS) del clúster HDFS.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^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>
El ARN de la ubicación de HDFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El URi de la ubicación de HDFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como el `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-NameNodes"></a>
La NameNode que administra el espacio de nombres HDFS.   
Tipo: Matriz de [HdfsNameNode](API_HdfsNameNode.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.

 ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-QopConfiguration"></a>
La configuración de calidad de protección (QOP), que especifica la llamada a procedimiento remoto (RPC) y los ajustes de protección de transferencia de datos configurados en el clúster del sistema de archivos distribuido de Hadoop (HDFS).   
Tipo: objeto [QopConfiguration](API_QopConfiguration.md)

 ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ReplicationFactor"></a>
El número en el DataNodes que se van a replicar los datos al escribir en el clúster HDFS.   
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 512.

 ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-SimpleUser"></a>
El nombre de usuario utilizado para identificar al cliente en el sistema operativo host. Este parámetro se utiliza si `AuthenticationType` se define como `SIMPLE`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 

## Errores
<a name="API_DescribeLocationHdfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationHdfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un servidor de archivos de Network File System (NFS).

## Sintaxis de la solicitud
<a name="API_DescribeLocationNfs_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationNfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationNfs_RequestSyntax) **   <a name="DataSync-DescribeLocationNfs-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de NFS sobre la que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeLocationNfs_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_DescribeLocationNfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-CreationTime"></a>
Es la hora en que se creó la ubicación de NFS.  
Tipo: marca temporal

 ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationArn"></a>
El ARN de la ubicación de NFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El URI de la ubicación de NFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-MountOptions"></a>
Las opciones de montaje que se DataSync utilizan para montar el servidor de archivos NFS.  
Tipo: objeto [NfsMountOptions](API_NfsMountOptions.md)

 ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-OnPremConfig"></a>
Los AWS DataSync agentes que se pueden conectar al servidor de archivos del Network File System (NFS).  
Tipo: objeto [OnPremConfig](API_OnPremConfig.md)

## Errores
<a name="API_DescribeLocationNfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

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

En el siguiente ejemplo, se arroja información sobre la ubicación de NFS especificada en el ejemplo de solicitud.

#### Solicitud de muestra
<a name="API_DescribeLocationNfs_Example_1_Request"></a>

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

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

Este ejemplo ilustra un uso de DescribeLocationNfs.

#### Respuesta de ejemplo
<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" ]
   }
}
```

## Véase también
<a name="API_DescribeLocationNfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationNfs) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de almacenamiento de objetos.

## Sintaxis de la solicitud
<a name="API_DescribeLocationObjectStorage_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationObjectStorage_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationObjectStorage_RequestSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación del sistema de almacenamiento de objetos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationObjectStorage_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AccessKey"></a>
La clave de acceso (por ejemplo, un nombre de usuario) requerida para autenticarse en el sistema de almacenamiento de objetos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Patrón: `^.*$` 

 ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AgentArns"></a>
Los ARNs DataSync agentes que se pueden conectar con el sistema de almacenamiento de objetos.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
Describe la información de configuración de un secreto DataSync administrado, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica, y de un secreto administrado por el cliente AWS KMS key.  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CreationTime"></a>
La hora en que se creó el registro.  
Tipo: marca temporal

 ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CustomSecretConfig"></a>
Describe la información de configuración de un secreto administrado por el cliente, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica, y una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationArn"></a>
El ARN de la ubicación del sistema de almacenamiento de objetos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El URI de la ubicación del sistema de almacenamiento de objetos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerCertificate"></a>
La cadena de certificados DataSync para autenticarse en el sistema de almacenamiento de objetos si el sistema utiliza una entidad de certificación (CA) privada o autofirmada.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 32 768 caracteres.

 ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerPort"></a>
El puerto en el que el servidor de almacenamiento de objetos acepta el tráfico de red entrante (por ejemplo, el puerto 443).  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 65 536.

 ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerProtocol"></a>
El protocolo que utiliza su sistema de almacenamiento de objetos para comunicarse.  
Tipo: cadena  
Valores válidos: `HTTPS | HTTP` 

## Errores
<a name="API_DescribeLocationObjectStorage_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeLocationObjectStorage_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un bucket de S3.

## Sintaxis de la solicitud
<a name="API_DescribeLocationS3_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationS3_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) **   <a name="DataSync-DescribeLocationS3-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeLocationS3_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_DescribeLocationS3_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArns](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-AgentArns"></a>
Los DataSync agentes desplegados en su Outpost cuando trabajaba con Amazon S3 en Outposts. ARNs   
Para obtener más información, consulte [Implementar su DataSync agente en](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). AWS Outposts  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
La hora en que se creó la ubicación de Amazon S3.  
Tipo: marca temporal

 ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationArn"></a>
El ARN de la ubicación de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
Es la dirección URL de la ubicación de Amazon S3 que se describió.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3Config"></a>
Especifica el nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que se DataSync utiliza para acceder al bucket de S3.  
Para obtener más información, consulte [Proporcionar DataSync acceso a los buckets de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipo: objeto [S3Config](API_S3Config.md)

 ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3StorageClass"></a>
Cuando Amazon S3 es una ubicación de destino, esta es la clase de almacenamiento que ha elegido para sus objetos.  
Algunas clases de almacenamiento tienen comportamientos que pueden afectar los costos de almacenamiento de Amazon S3. Para obtener más información, consulte [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: cadena  
Valores válidos: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 

## Errores
<a name="API_DescribeLocationS3_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

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

En el siguiente ejemplo, se arroja información sobre la ubicación de Amazon S3 especificada en el ejemplo de solicitud.

#### Solicitud de muestra
<a name="API_DescribeLocationS3_Example_1_Request"></a>

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

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

Este ejemplo ilustra un uso de DescribeLocation S3.

#### Respuesta de ejemplo
<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"
}
```

## Véase también
<a name="API_DescribeLocationS3_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3) 

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

Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un servidor de archivos de bloque de mensajes del servidor (SMB).

## Sintaxis de la solicitud
<a name="API_DescribeLocationSmb_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeLocationSmb_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de SMB sobre la que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationSmb_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
Los ARNs DataSync agentes que se pueden conectar con el servidor de archivos SMB.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El protocolo de autenticación que se DataSync utiliza para conectarse al servidor de archivos SMB.  
Tipo: cadena  
Valores válidos: `NTLM | KERBEROS` 

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un `Password` o `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una ubicación administrada por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
Es la hora en que se creó la ubicación SMB.  
Tipo: marca temporal

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
Describe la información de configuración de un secreto administrado por el cliente, como un `Password` o `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
Las IPv6 direcciones IPv4 o de los servidores DNS a los que pertenece el servidor de archivos SMB. Este elemento se aplica únicamente si `AuthenticationType` está configurado en `KERBEROS`.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 2 elementos.  
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 39.  
Patrón: `\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>
El nombre del dominio de Windows al que pertenece el servidor de archivos SMB. Este elemento se aplica únicamente si `AuthenticationType` está configurado en `NTLM`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
La entidad principal de Kerberos que tiene permiso para acceder a los archivos, las carpetas y los metadatos de archivos en el servidor de archivos SMB.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^.+$` 

 ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
El ARN de la ubicación de SMB.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El URI de la ubicación de SMB.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un `Password` o `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
La versión del protocolo SMB que se DataSync utiliza para acceder al servidor de archivos SMB.  
Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md)

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
El usuario que puede montar y acceder a los archivos, carpetas y metadatos del servidor de archivos de SMB. Este elemento se aplica únicamente si `AuthenticationType` está configurado en `NTLM`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Errores
<a name="API_DescribeLocationSmb_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

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

En este ejemplo se ilustra un uso de. DescribeLocationSmb

#### Solicitud de muestra
<a name="API_DescribeLocationSmb_Example_1_Request"></a>

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

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

Este ejemplo ilustra un uso de DescribeLocationSmb.

#### Respuesta de ejemplo
<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"
}
```

## Véase también
<a name="API_DescribeLocationSmb_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb) 

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

Proporciona información sobre una *tarea*, que define dónde y cómo AWS DataSync transfiere los datos.

## Sintaxis de la solicitud
<a name="API_DescribeTask_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [TaskArn](#API_DescribeTask_RequestSyntax) **   <a name="DataSync-DescribeTask-request-TaskArn"></a>
Especifique el nombre de recurso de Amazon (ARN) de la tarea de transferencia sobre la que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeTask_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CloudWatchLogGroupArn"></a>
El nombre de recurso de Amazon (ARN) de un grupo de CloudWatch registros de Amazon para supervisar la tarea.  
Para obtener más información, consulte [Supervisión de las transferencias de datos con CloudWatch registros](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 562 caracteres.  
Patrón: `^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>
La hora en que se creó la tarea.  
Tipo: marca temporal

 ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CurrentTaskExecutionArn"></a>
El ARN de la ejecución de tarea más reciente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El ARN de la ubicación de destino de la transferencia.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
Las [interfaces ARNs de red](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) que se DataSync crearon para su ubicación de destino.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
Si hay algún problema con la tarea, puede usar el código de error como ayuda para solucionar el problema. Para obtener más información, consulta [Solución de problemas relacionados con DataSync las transferencias](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: cadena

 ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorDetail"></a>
Si hay algún problema con la tarea, puede usar los detalles del error como ayuda para solucionar el problema. Para obtener más información, consulta [Solución de problemas relacionados con DataSync las transferencias](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: cadena

 ** [Excludes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Excludes"></a>
Los filtros de exclusión que definen los archivos, objetos y carpetas de la ubicación de origen que no DataSync desea transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.

 ** [Includes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Includes"></a>
Incluyen filtros que definen los archivos, objetos y carpetas de la ubicación de origen que DataSync desea transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.

 ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ManifestConfig"></a>
La configuración del manifiesto que enumera los archivos u objetos que DataSync desea transferir. Para obtener más información, consulta [Especificar qué se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipo: objeto [ManifestConfig](API_ManifestConfig.md)

 ** [Name](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Name"></a>
El nombre de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Options](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Options"></a>
La configuración de la tarea. Por ejemplo, qué metadatos del archivo se conservan, cómo se verifica la integridad de los datos al final de la transferencia, límites de ancho de banda, entre otras opciones.  
Tipo: objeto [Options](API_Options.md)

 ** [Schedule](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Schedule"></a>
El momento en que quiere que la tarea se ejecute. Para obtener más información, consulte [Scheduling your task](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (Programación de tareas).  
Tipo: objeto [TaskSchedule](API_TaskSchedule.md)

 ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ScheduleDetails"></a>
Los detalles de su [programa de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: objeto [TaskScheduleDetails](API_TaskScheduleDetails.md)

 ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceLocationArn"></a>
El ARN de la ubicación de origen de la transferencia.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
Las [interfaces ARNs de red](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) que se DataSync crearon para su ubicación de origen.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El estado de la tarea. Para obtener información sobre el significado de cada estado, consulte [Estados de las tareas](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses).  
Tipo: cadena  
Valores válidos: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` 

 ** [TaskArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskArn"></a>
El ARN de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El modo de tarea que utiliza. Para obtener más información, consulte [Selección del modo de tarea para la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: cadena  
Valores válidos: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskReportConfig"></a>
La configuración del informe de tareas, que proporciona información detallada sobre la DataSync transferencia. Para obtener más información, consulta [Supervisar tus DataSync transferencias con informes de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md)

## Errores
<a name="API_DescribeTask_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_DescribeTask_Example_1"></a>

El siguiente ejemplo especifica el ARN de una DataSync tarea sobre la que se va a obtener información.

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

### Respuesta de ejemplo
<a name="API_DescribeTask_Example_2"></a>

El siguiente ejemplo muestra una respuesta `DescribeTask`.

```
{
  "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:*"
}
```

## Véase también
<a name="API_DescribeTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask) 

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

Proporciona información sobre la ejecución de la AWS DataSync tarea. Puede utilizar esta operación para ayudar a supervisar el progreso de una transferencia de datos en curso o para comprobar los resultados de la transferencia.

**nota**  
Algunos elementos de respuesta `DescribeTaskExecution` solo son relevantes para un modo de tarea específico. Para obtener más información, consulte [Descripción de las diferencias entre los modos de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) y [Comprensión de los contadores de rendimiento de la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html).

## Sintaxis de la solicitud
<a name="API_DescribeTaskExecution_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DescribeTaskExecution_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **   <a name="DataSync-DescribeTaskExecution-request-TaskExecutionArn"></a>
Especifique el nombre de recurso de Amazon (ARN) de la tarea de ejecución sobre la que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeTaskExecution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesCompressed"></a>
El número de bytes físicos que se DataSync transfieren a través de la red después de la compresión (si la compresión es posible). Este valor suele ser inferior a [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred), salvo que los datos no sean comprimibles.  
Tipo: largo

 ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesTransferred"></a>
El número de bytes que se DataSync envían a la red antes de la compresión (si la compresión es posible). Para conocer el número de bytes transferidos a través de la red, consulte [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed).   
Tipo: largo

 ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesWritten"></a>
El número de bytes lógicos que DataSync realmente se escriben en la ubicación de destino.  
Tipo: largo

 ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EndTime"></a>
La hora en la que finaliza la tarea de transferencia.  
Tipo: marca temporal

 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedBytesToTransfer"></a>
El número de bytes lógicos que se DataSync espera escribir en la ubicación de destino.  
Tipo: largo

 ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToDelete"></a>
El número de archivos, objetos y directorios que se DataSync espera eliminar en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.  
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete). 
Tipo: largo

 ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToTransfer"></a>
La cantidad de archivos, objetos y directorios que se DataSync espera transferir a través de la red. Este valor se calcula mientras DataSync [se prepara](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) la transferencia.  
La forma en que se calcula depende principalmente de la configuración del [modo de transferencia](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) de la tarea:  
+ Si `TranserMode` está configurado como `CHANGED`: el cálculo se basa en comparar el contenido de las ubicaciones de origen y destino, y en determinar la diferencia que debe transferirse. La diferencia puede incluir:
  + Todo lo que se añada o modifique en la ubicación de origen.
  + Todo lo que se encuentre en ambas ubicaciones y que se modifique en el destino después de una transferencia inicial (a menos que [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)esté configurado en`NEVER`).
  +  **(Solo en el modo de tarea básica)** El número de elementos que se DataSync espera eliminar (si [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)está configurado en`REMOVE`).
+ Si `TranserMode` está establecido en`ALL`: el cálculo se basa únicamente en los elementos que DataSync se encuentran en la ubicación de origen.
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer). 
Tipo: largo

 ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete"></a>
El número de directorios que se DataSync espera eliminar en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo

 ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer"></a>
El número de directorios que se DataSync espera transferir a través de la red. Este valor se calcula a medida que DataSync [se preparan](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) los directorios para transferirlos.  
La forma en que se calcula depende principalmente de la configuración del [modo de transferencia](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) de la tarea:  
+ Si `TranserMode` está configurado como `CHANGED`: el cálculo se basa en comparar el contenido de las ubicaciones de origen y destino, y en determinar la diferencia que debe transferirse. La diferencia puede incluir:
  + Todo lo que se añada o modifique en la ubicación de origen.
  + Todo lo que se encuentre en ambas ubicaciones y que se haya modificado en el destino después de una transferencia inicial (a menos que [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)esté configurado en`NEVER`).
+ Si `TranserMode` está establecido en`ALL`: el cálculo se basa únicamente en los elementos que DataSync se encuentran en la ubicación de origen.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo

 ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Excludes"></a>
Una lista de reglas de filtrado que excluyen datos específicos durante la transferencia. Para obtener más información y ejemplos, consulte [Filtrar los datos transferidos por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.

 ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesDeleted"></a>
El número de archivos, objetos y directorios que DataSync realmente se eliminan en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.  
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted). 
Tipo: largo

 ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesFailed"></a>
El número de archivos u objetos que DataSync no se pueden preparar, transferir, verificar ni eliminar durante la ejecución de la tarea.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)

 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesListed"></a>
El número de archivos u objetos que DataSync se encuentran en sus ubicaciones.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)

 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesPrepared"></a>
El número de archivos u objetos que DataSync se intentarán transferir después de comparar las ubicaciones de origen y destino.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Este contador no es aplicable si la tarea se configura para [transferir todos los datos](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). En ese escenario, DataSync copia todo, desde el origen hasta el destino, sin comparar las diferencias entre las ubicaciones.  
Tipo: largo

 ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesSkipped"></a>
El número de archivos, objetos y directorios que se DataSync omiten durante la transferencia.  
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped). 
Tipo: largo

 ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesTransferred"></a>
El número de archivos, objetos y directorios que DataSync realmente se transfieren a través de la red. Este valor se actualiza periódicamente durante la ejecución de la tarea cuando se lee contenido desde el origen y se envía a través de la red.  
Si DataSync no se puede transferir algo, este valor puede ser inferior a`EstimatedFilesToTransfer`. Este valor también puede ser mayor que `EstimatedFilesToTransfer` en algunos casos. Este elemento es específico de la implementación para algunos tipos de ubicaciones, por lo que no lo utilice como un indicador exacto de lo que se transfiere ni para supervisar la ejecución de la tarea.  
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred). 
Tipo: largo

 ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesVerified"></a>
El número de archivos, objetos y directorios que se DataSync verifica durante la transferencia.  
Al configurar la tarea para [comprobar únicamente los datos que se transfieren](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync no comprueba los directorios en algunas situaciones ni los archivos que no se transfieren.  
En el [caso de las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified). 
Tipo: largo

 ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersDeleted"></a>
El número de directorios que DataSync realmente se eliminan en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo

 ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersFailed"></a>
El número de directorios que DataSync no se pueden enumerar, preparar, transferir, verificar ni eliminar durante la ejecución de la tarea.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)

 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersListed"></a>
El número de directorios que DataSync se encuentran en sus ubicaciones.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)

 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersPrepared"></a>
El número de directorios que DataSync se intentarán transferir después de comparar las ubicaciones de origen y destino.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Este contador no es aplicable si la tarea se configura para [transferir todos los datos](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). En ese escenario, DataSync copia todo, desde el origen hasta el destino, sin comparar las diferencias entre las ubicaciones.  
Tipo: largo

 ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersSkipped"></a>
El número de directorios que se DataSync omiten durante la transferencia.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo

 ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersTransferred"></a>
El número de directorios que DataSync realmente se transfieren a través de la red. Este valor se actualiza periódicamente durante la ejecución de la tarea cuando se lee contenido desde el origen y se envía a través de la red.  
Si DataSync no se puede transferir algo, este valor puede ser inferior a`EstimatedFoldersToTransfer`. Este valor también puede ser mayor que `EstimatedFoldersToTransfer` en algunos casos.   
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo

 ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersVerified"></a>
El número de directorios que se DataSync verifica durante la transferencia.  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo

 ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Includes"></a>
Una lista de reglas de filtrado que incluyen datos específicos durante la transferencia. Para obtener más información y ejemplos, consulte [Filtrar los datos transferidos por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.

 ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-LaunchTime"></a>
La hora en la que realmente comienza la ejecución de la tarea. Para las tareas que no están en cola, `LaunchTime` y `StartTime` suelen ser iguales. En el caso de las tareas en cola, `LaunchTime` suele ser posterior a `StartTime`, ya que las tareas previamente en cola deben terminar de ejecutarse antes de que puedan comenzar las tareas más recientes.  
Tipo: marca temporal

 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ManifestConfig"></a>
La configuración del manifiesto que enumere los archivos y los objetos a transferir. Para obtener más información, consulta [Especificar qué se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipo: objeto [ManifestConfig](API_ManifestConfig.md)

 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Options"></a>
Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones.  
Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual.  
Tipo: objeto [Options](API_Options.md)

 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ReportResult"></a>
Indica si DataSync se ha generado un [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) completo para tu transferencia.  
Tipo: objeto [ReportResult](API_ReportResult.md)

 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Result"></a>
El resultado de la ejecución de la tarea.  
Tipo: objeto [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)

 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-StartTime"></a>
La hora a la que se DataSync envía la solicitud para iniciar la ejecución de la tarea. Para las tareas que no están en cola, `LaunchTime` y `StartTime` suelen ser iguales. En el caso de las tareas en cola, `LaunchTime` suele ser posterior a `StartTime`, ya que las tareas previamente en cola deben terminar de ejecutarse antes de que puedan comenzar las tareas más recientes.  
Tipo: marca temporal

 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Status"></a>
El estado de la ejecución de la tarea.   
Para obtener información detallada sobre los estados de ejecución de las tareas, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipo: cadena  
Valores válidos: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` 

 ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskExecutionArn"></a>
El ARN de ejecución de la tarea sobre la que quería información. `TaskExecutionArn` es jerárquico e incluye `TaskArn` para la tarea que se ejecutó.   
Por ejemplo, un valor de `TaskExecution` con el ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` ejecutó la tarea con el ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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>
El modo de tarea que utiliza. Para obtener más información, consulte [Selección del modo de tarea para la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: cadena  
Valores válidos: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskReportConfig"></a>
La configuración del informe de tareas, que proporciona información detallada sobre la DataSync transferencia. Para obtener más información, consulte [Creating a task report](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md)

## Errores
<a name="API_DescribeTaskExecution_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_DescribeTaskExecution_Example_1"></a>

En este ejemplo se ilustra una solicitud de `DescribeTaskExecution`.

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

### Respuesta de ejemplo 1 para la ejecución de una tarea en modo mejorado
<a name="API_DescribeTaskExecution_Example_2"></a>

El siguiente ejemplo describe la ejecución de una DataSync tarea que utiliza el modo mejorado. La ejecución también transfiere datos específicos mediante el uso de filtros de exclusión e inclusión.

```
{
    "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
    }
}
```

### Respuesta de ejemplo 2 para la ejecución de una tarea en modo mejorado
<a name="API_DescribeTaskExecution_Example_3"></a>

El siguiente ejemplo describe la ejecución de otra DataSync tarea que utiliza el modo mejorado. En esta situación, la ejecución transfiere datos específicos mediante el uso de un manifiesto en lugar de filtros.

```
{
    "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
    }
  }
```

### Respuesta de ejemplo para la ejecución de una tarea en modo básico
<a name="API_DescribeTaskExecution_Example_4"></a>

El siguiente ejemplo describe la ejecución de una DataSync tarea que utiliza el modo Básico.

```
{
    "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"
    }
}
```

## Véase también
<a name="API_DescribeTaskExecution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution) 

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

Devuelve una lista de AWS DataSync agentes que pertenecen a una Cuenta de AWS de las Región de AWS especificadas en la solicitud.

Con la paginación, puede reducir la cantidad de agentes devueltos en una respuesta. Si obtiene una lista truncada de agentes en una respuesta, la respuesta contiene un marcador que puede especificar en su próxima solicitud para obtener la siguiente página de agentes.

 `ListAgents` acaba siendo coherente. Esto significa que es posible que el resultado de ejecutar la operación no refleje que acaba de crear o eliminar un agente. Por ejemplo, si crea un agente con [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)y lo ejecuta inmediatamente`ListAgents`, es posible que ese agente no aparezca inmediatamente en la lista. En situaciones como esta, siempre puede confirmar si un agente se ha creado (o eliminado) mediante [DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html).

## Sintaxis de la solicitud
<a name="API_ListAgents_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_ListAgents_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-MaxResults"></a>
Especifica el número máximo de DataSync agentes que se deben incluir en una respuesta. De forma predeterminada, una respuesta muestra un máximo de 100 agentes.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-NextToken"></a>
Especifica una cadena opaca que indica la posición en la que debe comenzar la siguiente lista de resultados de la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListAgents_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_ListAgents_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Agents](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-Agents"></a>
Una lista de sus DataSync agentes Cuenta de AWS en los Región de AWS especificados en la solicitud. La lista está ordenada por los nombres de los recursos de Amazon (ARNs) de los agentes.  
Tipo: matriz de objetos [AgentListEntry](API_AgentListEntry.md)

 ** [NextToken](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-NextToken"></a>
Es la cadena opaca que indica la posición en la que debe comenzar la siguiente lista de resultados de la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+` 

## Errores
<a name="API_ListAgents_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListAgents_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) 

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

Devuelve una lista de ubicaciones de origen y destino.

Si tiene más ubicaciones de las que se muestran en una respuesta (es decir, la respuesta devuelve solo una lista truncada de sus agentes), la respuesta incluye un token que puede especificar en su próxima solicitud para buscar la siguiente página de ubicaciones.

## Sintaxis de la solicitud
<a name="API_ListLocations_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_ListLocations_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Filters](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-Filters"></a>
Puede utilizar filtros de API para acotar la lista de recursos devueltos por `ListLocations`. Por ejemplo, para recuperar todas las tareas en una ubicación de origen específica, puede utilizar `ListLocations` con el nombre del filtro `LocationType S3` y `Operator Equals`.  
Tipo: matriz de objetos [LocationFilter](API_LocationFilter.md)  
Obligatorio: no

 ** [MaxResults](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-MaxResults"></a>
Número máximo de ubicaciones que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-NextToken"></a>
Es una cadena opaca que indica la posición en la que debe comenzar la siguiente lista de ubicaciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListLocations_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_ListLocations_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Locations](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-Locations"></a>
Es una matriz que incluye una lista de ubicaciones.  
Tipo: matriz de objetos [LocationListEntry](API_LocationListEntry.md)

 ** [NextToken](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-NextToken"></a>
Es una cadena opaca que indica la posición en la que debe comenzar a arrojar la siguiente lista de ubicaciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+` 

## Errores
<a name="API_ListLocations_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListLocations_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) 

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

Devuelve todas las etiquetas asociadas a un AWS recurso.

## Sintaxis de la solicitud
<a name="API_ListTagsForResource_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_ListTagsForResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-MaxResults"></a>
Especifica cuántos resultados quiere obtener en la respuesta.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-NextToken"></a>
Especifica una cadena opaca que indica la posición en la que debe comenzar la siguiente lista de resultados de la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+`   
Obligatorio: no

 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-ResourceArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del recurso sobre el que desea etiquetar información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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})?))$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_ListTagsForResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-NextToken"></a>
Es la cadena opaca que indica la posición en la que debe comenzar la siguiente lista de resultados de la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+` 

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-Tags"></a>
Matriz de etiquetas que se aplican al recurso especificado.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 55 elementos.

## Errores
<a name="API_ListTagsForResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) 

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

Devuelve una lista de las ejecuciones de una tarea AWS DataSync de transferencia.

## Sintaxis de la solicitud
<a name="API_ListTaskExecutions_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_ListTaskExecutions_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-MaxResults"></a>
Especifica cuántos resultados desea obtener en la respuesta.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-NextToken"></a>
Especifica una cadena opaca que indica la posición en la que debe comenzar la siguiente lista de resultados de la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+`   
Obligatorio: no

 ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-TaskArn"></a>
Especifique el nombre de recurso de Amazon (ARN) de la tarea de ejecución sobre la que desea obtener información.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListTaskExecutions_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_ListTaskExecutions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-NextToken"></a>
Es la cadena opaca que indica la posición en la que debe comenzar la siguiente lista de resultados de la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+` 

 ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-TaskExecutions"></a>
Una lista de las ejecuciones de la tarea.  
Tipo: matriz de objetos [TaskExecutionListEntry](API_TaskExecutionListEntry.md)

## Errores
<a name="API_ListTaskExecutions_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTaskExecutions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) 

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

Devuelve una lista de las AWS DataSync tareas que ha creado.

## Sintaxis de la solicitud
<a name="API_ListTasks_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_ListTasks_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Filters](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-Filters"></a>
Puede utilizar filtros de API para acotar la lista de recursos devueltos por `ListTasks`. Por ejemplo, para recuperar todas las tareas en una ubicación de origen específica, puede utilizar `ListTasks` con el nombre del filtro `LocationId` y `Operator Equals` con el ARN de la ubicación.  
Tipo: matriz de objetos [TaskFilter](API_TaskFilter.md)  
Obligatorio: no

 ** [MaxResults](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-MaxResults"></a>
Número máximo de filas que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-NextToken"></a>
Cadena opaca que indica la posición en la que debe comenzar la siguiente lista de tareas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListTasks_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_ListTasks_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-NextToken"></a>
Cadena opaca que indica la posición en la que debe comenzar a devolver la siguiente lista de tareas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+` 

 ** [Tasks](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-Tasks"></a>
Lista de todas las tareas devueltas.  
Tipo: matriz de objetos [TaskListEntry](API_TaskListEntry.md)

## Errores
<a name="API_ListTasks_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTasks_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) 

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

Inicia una tarea AWS DataSync de transferencia. Para cada tarea, solo puede ejecutar una tarea a la vez.

Hay varios pasos en la ejecución de una tarea. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses).

**importante**  
Si planea transferir datos a o desde una ubicación de Amazon S3, consulte [cómo DataSync pueden afectar los cargos por solicitud de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) y la [página de DataSync precios](https://aws.amazon.com/datasync/pricing/) antes de empezar.

## Sintaxis de la solicitud
<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"
   }
}
```

## Parámetros de la solicitud
<a name="API_StartTaskExecution_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Excludes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Excludes"></a>
Especifica una lista de reglas de filtro que determina qué archivos se excluyen de una tarea. La lista contiene una única cadena de filtro que consiste en los patrones que se excluyen. Los patrones están delimitados por “\$1” (es decir, una tubería), por ejemplo, `"/folder1|/folder2"`.   
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Obligatorio: no

 ** [Includes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Includes"></a>
Especifica una lista de reglas de filtro que determina qué archivos se incluyen al ejecutar una tarea. El patrón debe contener una única cadena de filtro que consta de los patrones que se van a incluir. Los patrones están delimitados por “\$1” (es decir, una tubería), por ejemplo, `"/folder1|/folder2"`.   
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Obligatorio: no

 ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-ManifestConfig"></a>
Configura un manifiesto, que es una lista de archivos u objetos que desea DataSync transferir. Para obtener más información y ejemplos de configuración, consulte [Especificar lo que se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Al usar este parámetro, la identidad de la persona que llama (el rol DataSync con el que estás usando) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso.  
Para eliminar una configuración de manifiesto, especifique este parámetro como vacío.  
Tipo: objeto [ManifestConfig](API_ManifestConfig.md)  
Obligatorio: no

 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-OverrideOptions"></a>
Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones.  
Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual.  
Tipo: objeto [Options](API_Options.md)  
Obligatorio: no

 ** [Tags](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Tags"></a>
Especifica las etiquetas que desea aplicar al nombre de recurso de Amazon (ARN) que representa la ejecución de la tarea.  
 Las *etiquetas* son pares clave-valor que te ayudan a administrar, filtrar y buscar tus DataSync recursos.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la tarea que desea iniciar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskReportConfig"></a>
Especifica cómo desea configurar un informe de tareas, que proporciona información detallada sobre la transferencia. DataSync Para obtener más información, consulte [Supervisar DataSync las transferencias con informes de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Al usar este parámetro, la identidad de la persona que llama (el rol que utilizas DataSync ) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso.  
Para eliminar una configuración de informe de tarea, especifique este parámetro como vacío.  
Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_StartTaskExecution_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_StartTaskExecution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) **   <a name="DataSync-StartTaskExecution-response-TaskExecutionArn"></a>
El ARN de la ejecución de la tarea en ejecución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

## Errores
<a name="API_StartTaskExecution_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_StartTaskExecution_Example_1"></a>

En el siguiente ejemplo, se inicia la ejecución de una tarea mediante las opciones predeterminadas para la tarea especificada.

```
{
    "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"
}
```

### Respuesta de ejemplo
<a name="API_StartTaskExecution_Example_2"></a>

Este ejemplo ilustra un uso de StartTaskExecution.

```
{
  "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}
```

## Véase también
<a name="API_StartTaskExecution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution) 

# TagResource
<a name="API_TagResource"></a>

Aplica una *etiqueta* a un AWS recurso. Una etiqueta es un par clave-valor que le puede ayudar a administrar, filtrar y buscar sus recursos.

Estos incluyen AWS DataSync recursos, como ubicaciones, tareas y ejecuciones de tareas.

## Sintaxis de la solicitud
<a name="API_TagResource_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_TagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-ResourceArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del recurso al que se va a aplicar la etiqueta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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})?))$`   
Obligatorio: sí

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-Tags"></a>
Las etiquetas que desea añadir al recurso especificado.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: sí

## Elementos de respuesta
<a name="API_TagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_TagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Elimina las etiquetas de un AWS recurso.

## Sintaxis de la solicitud
<a name="API_UntagResource_RequestSyntax"></a>

```
{
   "Keys": [ "string" ],
   "ResourceArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_UntagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Keys](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-Keys"></a>
Especifica las claves de las etiquetas que quiere eliminar.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:/-]+$`   
Obligatorio: sí

 ** [ResourceArn](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-ResourceArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del recurso del que se van a eliminar las etiquetas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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})?))$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_UntagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UntagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) 

# UpdateAgent
<a name="API_UpdateAgent"></a>

Actualiza el nombre de un AWS DataSync agente.

## Sintaxis de la solicitud
<a name="API_UpdateAgent_RequestSyntax"></a>

```
{
   "AgentArn": "string",
   "Name": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateAgent_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArn](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-AgentArn"></a>
El nombre de recurso de Amazon (ARN) del agente que hay que actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Name](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-Name"></a>
El nombre que desea usar para configurar el agente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateAgent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateAgent_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateAgent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) 

# UpdateLocationAzureBlob
<a name="API_UpdateLocationAzureBlob"></a>

Modifica las siguientes configuraciones de la ubicación de transferencia de Microsoft Azure Blob Storage con la que está utilizando. AWS DataSync

Para obtener más información, consulte [Configuración de DataSync transferencias con Azure Blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html) Storage.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationAzureBlob_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccessTier](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AccessTier"></a>
Especifica el nivel de acceso al que desea transferir sus objetos o archivos. Esto solo se aplica cuando se utiliza la ubicación como destino de transferencia. Para obtener más información, consulte [Niveles de acceso](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers).  
Tipo: cadena  
Valores válidos: `HOT | COOL | ARCHIVE`   
Obligatorio: no

 ** [AgentArns](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AgentArns"></a>
(Opcional) Especifica el nombre de recurso de Amazon (ARN) del DataSync agente que se puede conectar con el contenedor de Azure Blob Storage. Si se configura una transferencia entre nubes sin agente, no es necesario especificar un valor para este parámetro.  
Puede especificar más de un agente. Para obtener más información, consulte [Using multiple agents for your transfer](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html).  
No puede agregar ni eliminar agentes de una ubicación de almacenamiento después de crearla inicialmente.
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [AuthenticationType](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AuthenticationType"></a>
Especifica el método de autenticación que se DataSync utiliza para acceder a Azure Blob Storage. DataSync puede acceder al almacenamiento de blobs mediante una firma de acceso compartido (SAS).  
Tipo: cadena  
Valores válidos: `SAS | NONE`   
Obligatorio: no

 ** [BlobType](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-BlobType"></a>
Especifica el tipo de blob que desea que tengan sus objetos o archivos al transferirlos a Azure Blob Storage. Actualmente, DataSync solo admite el traslado de datos a Azure Blob Storage como bloques blobs. Para obtener más información sobre los tipos de blobs, consulte la [Documentación de Azure Blob Storage.](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs)  
Tipo: cadena  
Valores válidos: `BLOCK`   
Obligatorio: no

 ** [CmkSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica, y a un lugar administrado por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto administrado por el cliente, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica, y una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-LocationArn"></a>
Especifica el ARN de la ubicación de transferencia de Azure Blob Storage que va a actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-SasConfiguration"></a>
Especifica la configuración de SAS que permite acceder DataSync a su Azure Blob Storage.  
Tipo: objeto [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)  
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-Subdirectory"></a>
Especifica los segmentos de ruta si desea limitar su transferencia a un directorio virtual del contenedor (por ejemplo, `/my/images`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1024 caracteres.  
Patrón: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationAzureBlob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationAzureBlob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationAzureBlob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) 

# UpdateLocationEfs
<a name="API_UpdateLocationEfs"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de Amazon EFS con AWS DataSync la que está utilizando.

Para obtener más información, consulte [Configuración de DataSync transferencias con Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html).

## Sintaxis de la solicitud
<a name="API_UpdateLocationEfs_RequestSyntax"></a>

```
{
   "AccessPointArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationEfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-AccessPointArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del punto de acceso que se DataSync utiliza para montar el sistema de archivos Amazon EFS.  
Para obtener más información, consulte [Acceso a sistemas de archivos de Amazon EFS restringidos](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `(^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}$)|(^$)`   
Obligatorio: no

 ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-FileSystemAccessRoleArn"></a>
Especifica un rol AWS Identity and Access Management (IAM) que permite acceder DataSync al sistema de archivos Amazon EFS.  
Para obtener información sobre la creación de este rol, consulte [Creación de un rol de DataSync IAM para el acceso al sistema de archivos Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)`   
Obligatorio: no

 ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-InTransitEncryption"></a>
Especifica si desea DataSync utilizar el cifrado Transport Layer Security (TLS) 1.2 cuando transfiera datos hacia o desde su sistema de archivos Amazon EFS.  
Si especifica un punto de acceso mediante `AccessPointArn` o un rol de IAM con `FileSystemAccessRoleArn`, debe establecer este parámetro en `TLS1_2`.  
Tipo: cadena  
Valores válidos: `NONE | TLS1_2`   
Obligatorio: no

 ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia de Amazon EFS que se actualiza.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-Subdirectory"></a>
Especifica una ruta de montaje para el sistema de archivos de Amazon EFS. Aquí es donde DataSync lee o escribe los datos en su sistema de archivos (dependiendo de si se trata de una ubicación de origen o de destino).  
De forma predeterminada, DataSync utiliza el directorio raíz (o el [punto de acceso](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) si se proporciona uno mediante él`AccessPointArn`). También puede incluir subdirectorios usando barras diagonales (por ejemplo, `/path/to/folder`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationEfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationEfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationEfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) 

# UpdateLocationFsxLustre
<a name="API_UpdateLocationFsxLustre"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de Amazon FSx for Lustre con la que estás utilizando. AWS DataSync

Para obtener más información, consulta [Cómo configurar las DataSync transferencias con FSx for Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html).

## Sintaxis de la solicitud
<a name="API_UpdateLocationFsxLustre_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationFsxLustre_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia de FSx for Lustre que está actualizando.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-Subdirectory"></a>
Especifica una ruta de montaje FSx para su sistema de archivos de Lustre. La ruta puede incluir subdirectorios.  
Cuando la ubicación se utiliza como fuente, DataSync lee los datos de la ruta de montaje. Cuando la ubicación se utiliza como destino, DataSync escribe los datos en la ruta de montaje. Si no incluye este parámetro, DataSync utiliza el directorio raíz del sistema de archivos (`/`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationFsxLustre_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationFsxLustre_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationFsxLustre_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) 

# UpdateLocationFsxOntap
<a name="API_UpdateLocationFsxOntap"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de Amazon FSx for NetApp ONTAP con la que estás utilizando. AWS DataSync

Para obtener más información, consulta [Cómo configurar las DataSync transferencias con ONTAP FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationFsxOntap_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia FSx de ONTAP que está actualizando.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Protocol"></a>
Especifica el protocolo de transferencia de datos que se DataSync utiliza para acceder al sistema de FSx archivos de Amazon.  
Tipo: objeto [FsxUpdateProtocol](API_FsxUpdateProtocol.md)  
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Subdirectory"></a>
Especifica la ruta del recurso compartido de archivos en la máquina virtual de almacenamiento (SVM) desde la cual o hacia la cual desea transferir los datos.  
Puede especificar una ruta de unión (también conocida como punto de montaje), una ruta de qtree (para recursos compartidos de archivos NFS) o un nombre de recurso compartido (para recursos compartidos de archivos SMB). Por ejemplo, la ruta de montaje podría ser `/vol1`, `/vol1/tree1` o`/share1`.  
No especifique una ruta de cruce en el volumen raíz del SVM. Para obtener más información, consulte [Administración FSx de máquinas virtuales de almacenamiento de ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) en la Guía del *usuario de Amazon FSx for NetApp ONTAP*.
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationFsxOntap_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationFsxOntap_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationFsxOntap_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) 

# UpdateLocationFsxOpenZfs
<a name="API_UpdateLocationFsxOpenZfs"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de Amazon FSx for OpenZFS con la que estás utilizando. AWS DataSync

Para obtener más información, consulte [Configurar DataSync transferencias con FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html) OpenZFS.

**nota**  
Los parámetros de solicitud relacionados con `SMB` no se admiten con la operación `UpdateLocationFsxOpenZfs`.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationFsxOpenZfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia FSx de OpenZFS que está actualizando.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Protocol"></a>
Especifica el protocolo de transferencia de datos que se AWS DataSync utiliza para acceder al sistema de FSx archivos de Amazon.  
Tipo: objeto [FsxProtocol](API_FsxProtocol.md)  
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Subdirectory"></a>
Especifica un subdirectorio en la ruta de la ubicación que debe empezar `/fsx` por. DataSync utiliza este subdirectorio para leer o escribir datos (en función de si el sistema de archivos es una ubicación de origen o de destino).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationFsxOpenZfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationFsxOpenZfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationFsxOpenZfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 

# UpdateLocationFsxWindows
<a name="API_UpdateLocationFsxWindows"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia del servidor de archivos de Amazon FSx para Windows con AWS DataSync la que estás utilizando.

Para obtener más información, consulte [Configuración de DataSync transferencias con el servidor FSx de archivos de Windows](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationFsxWindows_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, como un `Password` conjunto de credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica, y un secreto administrado por el cliente AWS KMS key.  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto administrado por el cliente, como una `Password` o varias credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica y una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Domain"></a>
Especifica el nombre del dominio de Windows al que pertenece el sistema de archivos del servidor FSx de archivos de Windows.  
Si tiene varios dominios de Active Directory en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al sistema de archivos correcto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
Obligatorio: no

 ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-LocationArn"></a>
Especifica el ARN de la ubicación de transferencia del FSx servidor de archivos de Windows que está actualizando.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Password"></a>
Especifica la contraseña del usuario con los permisos para montar y acceder a los archivos, las carpetas y los metadatos de los archivos del sistema de archivos FSx del servidor de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^.{0,104}$`   
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Subdirectory"></a>
Especifica una ruta de montaje para el sistema de archivos mediante barras diagonales. DataSync utiliza este subdirectorio para leer o escribir datos (dependiendo de si el sistema de archivos es una ubicación de origen o de destino).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

 ** [User](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-User"></a>
Especifica el usuario con los permisos para montar y acceder a los archivos, las carpetas y los metadatos de los archivos del sistema de archivos FSx del servidor de archivos de Windows.  
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte [los permisos necesarios](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx para las ubicaciones de los servidores de archivos de Windows.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationFsxWindows_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationFsxWindows_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationFsxWindows_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) 

# UpdateLocationHdfs
<a name="API_UpdateLocationHdfs"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia del Sistema de archivos distribuido de Hadoop (HDFS) que está utilizando. AWS DataSync

Para obtener más información, consulte [Configuración de DataSync transferencias con](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html) un clúster HDFS.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationHdfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AgentArns"></a>
Los nombres de recursos de Amazon (ARNs) de los DataSync agentes que se pueden conectar al clúster de HDFS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [AuthenticationType](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AuthenticationType"></a>
El tipo de autenticación utilizado para determinar la identidad del usuario.   
Tipo: cadena  
Valores válidos: `SIMPLE | KERBEROS`   
Obligatorio: no

 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-BlockSize"></a>
El tamaño de los bloques de datos que se escribirán en el clúster de HDFS.   
Tipo: entero  
Rango válido: valor mínimo de 1 048 576. Valor máximo de 1 073 741 824.  
Obligatorio: no

 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, como un `KerberosKeytab` conjunto de credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica, y un secreto administrado por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto administrado por el cliente, como una `KerberosKeytab` o varias credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica y una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKeytab"></a>
La tabla de claves de Kerberos (keytab) que contiene asignaciones entre el Kerberos principal definido y las claves cifradas. Puede cargar el keytab desde un archivo proporcionando la dirección del archivo.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 65 536 caracteres.  
Obligatorio: no

 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKrb5Conf"></a>
El archivo `krb5.conf` que contiene la información de configuración de Kerberos. Puede cargar el archivo `krb5.conf` proporcionando la dirección del archivo. Si utiliza la AWS CLI, esta realizará la codificación base64 por usted. De lo contrario, proporcione texto codificado en base64.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 131 072 caracteres.  
Obligatorio: no

 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosPrincipal"></a>
La entidad principal de Kerberos con acceso a los archivos y carpetas del clúster de HDFS.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^.+$`   
Obligatorio: no

 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KmsKeyProviderUri"></a>
El URI de Key Management Server (KMS) del clúster HDFS.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^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$`   
Obligatorio: no

 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-LocationArn"></a>
El nombre de recurso de Amazon (ARN) de la ubicación de clúster de HDFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-NameNodes"></a>
El que administra el espacio de nombres NameNode HDFS. NameNode Realiza operaciones como abrir, cerrar y cambiar el nombre de archivos y directorios. NameNode Contiene la información necesaria para asignar bloques de datos al DataNodes. Puede usar solo uno NameNode.  
Tipo: Matriz de [HdfsNameNode](API_HdfsNameNode.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo.  
Obligatorio: no

 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-QopConfiguration"></a>
La configuración de calidad de protección (QOP) especifica la configuración de privacidad de llamada a procedimiento remoto (RPC) y transferencia de datos configurada en el clúster del sistema de archivos distribuido de Hadoop (HDFS).   
Tipo: objeto [QopConfiguration](API_QopConfiguration.md)  
Obligatorio: no

 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-ReplicationFactor"></a>
El número en el DataNodes que se van a replicar los datos al escribir en el clúster HDFS.   
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 512.  
Obligatorio: no

 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-SimpleUser"></a>
El nombre de usuario utilizado para identificar al cliente en el sistema operativo host.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-Subdirectory"></a>
Un subdirectorio del clúster de HDFS. Este subdirectorio se utiliza para leer o escribir datos en el clúster de HDFS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationHdfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationHdfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationHdfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) 

# UpdateLocationNfs
<a name="API_UpdateLocationNfs"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia del Sistema de archivos de red (NFS) que está utilizando. AWS DataSync

Para obtener más información, consulte [Configuración de transferencias con un servidor de archivos NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html).

## Sintaxis de la solicitud
<a name="API_UpdateLocationNfs_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationNfs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-LocationArn"></a>
Específica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia de NFS que desea actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-MountOptions"></a>
Especifica cómo DataSync se puede acceder a una ubicación mediante el protocolo NFS.  
Tipo: objeto [NfsMountOptions](API_NfsMountOptions.md)  
Obligatorio: no

 ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-OnPremConfig"></a>
Los AWS DataSync agentes que se pueden conectar al servidor de archivos del Network File System (NFS).  
Tipo: objeto [OnPremConfig](API_OnPremConfig.md)  
Obligatorio: no

 ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-ServerHostname"></a>
Especifica el nombre DNS o la dirección IP (IPv4 o IPv6) del servidor de archivos NFS al que se conecta el DataSync agente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-Subdirectory"></a>
Especifica la ruta de exportación del servidor de archivos NFS que desea DataSync montar.  
Esta ruta (o un subdirectorio de la ruta) es DataSync desde donde se transfieren los datos hacia o desde. Para obtener información sobre cómo configurar una exportación DataSync, consulte [Acceso a los servidores de archivos NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationNfs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationNfs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationNfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) 

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de almacenamiento de objetos con AWS DataSync la que está utilizando.

Para obtener más información, consulte [Configurar DataSync las transferencias con un sistema de almacenamiento de objetos](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationObjectStorage_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
Especifica la clave de acceso (por ejemplo, un nombre de usuario) si se requieren credenciales para autenticarse en el servidor de almacenamiento de objetos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Patrón: `^.*$`   
Obligatorio: no

 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(Opcional) Especifica los nombres de recursos de Amazon (ARNs) de los DataSync agentes que se pueden conectar al sistema de almacenamiento de objetos. Si se configura una transferencia entre nubes sin agente, no es necesario especificar un valor para este parámetro.  
No puede agregar ni eliminar agentes de una ubicación de almacenamiento después de crearla inicialmente.
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica, y un secreto administrado por el cliente AWS KMS key.  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto administrado por el cliente, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica, y una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
Especifica el ARN de la ubicación de almacenamiento de objetos que va a actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
Especifica la clave secreta (por ejemplo, una contraseña) si se requieren credenciales para autenticarse en el servidor de almacenamiento de objetos.  
Si proporciona un secreto utilizando`SecretKey`, pero no proporciona los detalles de configuración del secreto, utilizando `CmkSecretConfig` o`CustomSecretConfig`, entonces DataSync almacena el token con el secreto de Secrets Manager de su AWS cuenta.
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Patrón: `^.*$`   
Obligatorio: no

 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
Especifica una cadena de certificados DataSync para autenticarse en el sistema de almacenamiento de objetos si el sistema utiliza una entidad de certificación (CA) privada o autofirmada. Debe especificar un único archivo `.pem` con una cadena de certificados completa (por ejemplo, `file:///home/user/.ssh/object_storage_certificates.pem`).  
La cadena de certificados puede incluir:  
+ El certificado del sistema de almacenamiento de objetos
+ Todos los certificados intermedios (si los hay)
+ El certificado raíz de la CA firmante
Puede concatenar sus certificados en un archivo `.pem` (que puede tener un máximo de 32 768 bytes antes de la codificación base64). El siguiente comando `cat` de ejemplo crea un archivo `object_storage_certificates.pem` que incluye tres certificados:  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
Para usar este parámetro, configure el `ServerProtocol` para `HTTPS`.  
La actualización de este parámetro no interfiere en las tareas que tiene en curso.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 32 768 caracteres.  
Obligatorio: no

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
Especifica el nombre de dominio o la dirección IP (IPv4 o IPv6) del servidor de almacenamiento de objetos al que se conecta el DataSync agente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obligatorio: no

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
Especifica el puerto en el que el servidor de almacenamiento de objetos acepta el tráfico de red entrante (por ejemplo, el puerto 443).  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 65 536.  
Obligatorio: no

 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Especifica el protocolo que usa el servidor de almacenamiento de objetos para comunicarse.  
Tipo: cadena  
Valores válidos: `HTTPS | HTTP`   
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
Especifica el prefijo de objeto del servidor de almacenamiento de objetos. Si se trata de una ubicación de origen, DataSync solo copia los objetos con este prefijo. Si se trata de una ubicación de destino, DataSync escribe todos los objetos con este prefijo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationObjectStorage_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationObjectStorage_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationObjectStorage_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) 

# UpdateLocationS3
<a name="API_UpdateLocationS3"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de Amazon S3 con AWS DataSync la que está utilizando.

**importante**  
Antes de comenzar, asegúrese de haber leído los siguientes temas:  
 [Consideraciones sobre las clases de almacenamiento en las ubicaciones de Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Evaluar los costos de las solicitudes de S3 al usar DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

## Sintaxis de la solicitud
<a name="API_UpdateLocationS3_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationS3_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-LocationArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia de Amazon S3 que actualiza.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3Config"></a>
Especifica el nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que se DataSync utiliza para acceder al bucket de S3.  
Para obtener más información, consulte [Proporcionar DataSync acceso a los buckets de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipo: objeto [S3Config](API_S3Config.md)  
Obligatorio: no

 ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3StorageClass"></a>
Especifica la clase de almacenamiento que desea que utilicen los objetos cuando Amazon S3 sea un destino de transferencia.  
Para los depósitos incluidos Regiones de AWS, la clase de almacenamiento se establece de forma predeterminada en. `STANDARD` Para los depósitos activados AWS Outposts, la clase de almacenamiento se establece de forma predeterminada en. `OUTPOSTS`  
Para obtener más información, consulte [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: cadena  
Valores válidos: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-Subdirectory"></a>
Especifica un prefijo en el depósito de S3 que DataSync lee o escribe en él (en función de si el depósito es una ubicación de origen o de destino).  
DataSync no puede transferir objetos con un prefijo que comience con una barra (`/`) o que incluya `//``/./`, o patrones. `/../` Por ejemplo:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationS3_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationS3_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationS3_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) 

# UpdateLocationSmb
<a name="API_UpdateLocationSmb"></a>

Modifica los siguientes parámetros de configuración de la ubicación de transferencia del bloque de mensajes del servidor (SMB) que está utilizando. AWS DataSync

Para obtener más información, consulte [Configuración de DataSync transferencias con un servidor de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateLocationSmb_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AgentArns"></a>
Especifica el DataSync agente (o los agentes) que se pueden conectar al servidor de archivos SMB. Puede especificar un agente mediante un nombre de recurso de Amazon (ARN).  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** [AuthenticationType](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AuthenticationType"></a>
Especifica el protocolo de autenticación que se DataSync utiliza para conectarse al servidor de archivos SMB. DataSync el soporte `NTLM` (predeterminado) y la `KERBEROS` autenticación.  
Para obtener más información, consulte [Proporcionar DataSync acceso a servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: cadena  
Valores válidos: `NTLM | KERBEROS`   
Obligatorio: no

 ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync administrado, como un `Password` `KerberosKeytab` o un conjunto de credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica, y de un secreto administrado por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto administrado por el cliente, como una `Password` `KerberosKeytab` o un conjunto de credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica y una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-DnsIpAddresses"></a>
Especifica las direcciones IP (IPv4 o IPv6) de los servidores DNS a los que pertenece el servidor de archivos SMB. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `KERBEROS`.  
Si tiene varios dominios en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al servidor de archivos SMB correcto.   
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 2 elementos.  
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 39.  
Patrón: `\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`   
Obligatorio: no

 ** [Domain](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Domain"></a>
Especifica el nombre de dominio de Windows al que pertenece el servidor de archivos SMB. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `NTLM`.  
Si tiene varios dominios en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al servidor de archivos correcto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obligatorio: no

 ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKeytab"></a>
Especifica el archivo de tabla de claves de Kerberos (keytab), que incluye las asignaciones entre la entidad principal de Kerberos y las claves de cifrado.  
Para evitar errores durante la ejecución de tareas, asegúrese de que la entidad principal de Kerberos que utiliza para crear el archivo keytab coincida exactamente con lo que especifica para `KerberosPrincipal`.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 65 536 caracteres.  
Obligatorio: no

 ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKrb5Conf"></a>
Especifica un archivo de configuración de Kerberos (`krb5.conf`) que define la configuración del dominio de Kerberos.  
El archivo debe estar codificado en base64. Si está utilizando el AWS CLI, la codificación está lista para usted.  
Tipo: objeto de datos binarios codificados en Base64  
Limitaciones de longitud: longitud máxima de 131 072 caracteres.  
Obligatorio: no

 ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosPrincipal"></a>
Especifica una entidad principal de Kerberos, que es una identidad dentro del dominio Kerberos con permisos para acceder a los archivos, las carpetas y los metadatos de archivos en el servidor de archivos SMB.  
Una entidad principal de Kerberos puede tener un formato similar a `HOST/kerberosuser@MYDOMAIN.ORG`.  
Los nombres de las entidades principales distinguen entre mayúsculas y minúsculas. La ejecución de la DataSync tarea fallará si el principal que especifique para este parámetro no coincide exactamente con el principal que utilizó para crear el archivo keytab.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^.+$`   
Obligatorio: no

 ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-LocationArn"></a>
Especifica el ARN de la ubicación de SMB que desea actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-MountOptions"></a>
Especifica la versión del protocolo del bloque de mensajes del servidor (SMB) que se AWS DataSync utiliza para acceder a un servidor de archivos SMB.  
Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md)  
Obligatorio: no

 ** [Password](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Password"></a>
Especifica la contraseña del usuario que puede montar su servidor de archivos SMB y que tiene permiso para acceder a los archivos y las carpetas involucrados en la transferencia. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `NTLM`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^.{0,104}$`   
Obligatorio: no

 ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-ServerHostname"></a>
Especifica el nombre de dominio o la dirección IP (IPv4 o IPv6) del servidor de archivos SMB al que se conecta el DataSync agente.  
Si utiliza autenticación Kerberos, debe especificar un nombre de dominio.
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obligatorio: no

 ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Subdirectory"></a>
Especifica el nombre del recurso compartido exportado por el servidor de archivos SMB en el que se DataSync leerán o escribirán los datos. Puede incluir un subdirectorio en la ruta del recurso compartido (por ejemplo, `/path/to/subdirectory`). Asegúrese de que otros clientes de SMB de la red también puedan montar esta ruta.  
Para copiar todos los datos del subdirectorio especificado, DataSync debe poder montar el recurso compartido SMB y acceder a todos sus datos. Para obtener más información, consulte [Proporcionar DataSync acceso a los servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obligatorio: no

 ** [User](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-User"></a>
Especifica el nombre del usuario que puede montar su servidor de archivos SMB y que tiene permiso para acceder a los archivos y las carpetas involucrados en la transferencia. Este parámetro se aplica únicamente si `AuthenticationType` se establece en `NTLM`.  
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte [Proporcionar DataSync acceso a los servidores de archivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateLocationSmb_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateLocationSmb_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateLocationSmb_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) 

# UpdateTask
<a name="API_UpdateTask"></a>

Actualiza la configuración de una *tarea*, que define dónde y cómo AWS DataSync transfiere los datos.

## Sintaxis de la solicitud
<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"
   }
}
```

## Parámetros de la solicitud
<a name="API_UpdateTask_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-CloudWatchLogGroupArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de un grupo de CloudWatch registros de Amazon para supervisar la tarea.  
Para tareas en modo mejorado, debe usar `/aws/datasync` como nombre del grupo de registro. Por ejemplo:  
 `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`   
Para obtener más información, consulte [Supervisión de las transferencias de datos con CloudWatch registros](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 562 caracteres.  
Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
Obligatorio: no

 ** [Excludes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Excludes"></a>
Especifica los filtros de exclusión que definen los archivos, objetos y carpetas de la ubicación de origen que no se DataSync desean transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Obligatorio: no

 ** [Includes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Includes"></a>
Especifica los filtros de inclusión que definen los archivos, objetos y carpetas de la ubicación de origen que DataSync deseas transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Obligatorio: no

 ** [ManifestConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-ManifestConfig"></a>
Configura un manifiesto, que es una lista de archivos u objetos que se desean DataSync transferir. Para obtener más información y ejemplos de configuración, consulte [Especificar lo que se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Al usar este parámetro, la identidad de la persona que llama (la función de IAM DataSync con la que está utilizando) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso.  
Para eliminar una configuración de manifiesto, especifique este parámetro como vacío.  
Tipo: objeto [ManifestConfig](API_ManifestConfig.md)  
Obligatorio: no

 ** [Name](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Name"></a>
Especifica el nombre de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

 ** [Options](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Options"></a>
Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones.  
Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual.  
Tipo: objeto [Options](API_Options.md)  
Obligatorio: no

 ** [Schedule](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Schedule"></a>
Especifica el momento en que quiere que la tarea se ejecute. Para obtener más información, consulte [Scheduling your task](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (Programación de tareas).  
Tipo: objeto [TaskSchedule](API_TaskSchedule.md)  
Obligatorio: no

 ** [TaskArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskArn"></a>
Especifica el ARN de la tarea que desea actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

 ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskReportConfig"></a>
Especifica cómo desea configurar un informe de tareas, que proporciona información detallada sobre la DataSync transferencia. Para obtener más información, consulte [Supervisar DataSync las transferencias con informes de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Al usar este parámetro, la identidad de la persona que llama (la función de IAM que utilizas DataSync ) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso.  
Para eliminar una configuración de informe de tarea, especifique este parámetro como vacío.  
Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md)  
Obligatorio: no

## Elementos de respuesta
<a name="API_UpdateTask_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateTask_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) 

# UpdateTaskExecution
<a name="API_UpdateTaskExecution"></a>

Actualiza la configuración de la ejecución de una AWS DataSync tarea en ejecución.

**nota**  
Actualmente, la única `Option` que puede modificar con `UpdateTaskExecution` es ` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) `, que limita el ancho de banda de la ejecución de una tarea en ejecución o en cola.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateTaskExecution_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Options](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-Options"></a>
Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones.  
Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual.  
Tipo: objeto [Options](API_Options.md)  
Obligatorio: sí

 ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-TaskExecutionArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la ejecución de la tarea que está actualizando.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_UpdateTaskExecution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateTaskExecution_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateTaskExecution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) 

# Data Types
<a name="API_Types"></a>

Los siguientes tipos de datos son compatibles:
+  [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>

Representa una sola entrada en una lista (o matriz) de AWS DataSync agentes cuando se llama a la [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operación.

## Contenido
<a name="API_AgentListEntry_Contents"></a>

 ** AgentArn **   <a name="DataSync-Type-AgentListEntry-AgentArn"></a>
El nombre de recurso de Amazon (ARN) de un DataSync agente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** Name **   <a name="DataSync-Type-AgentListEntry-Name"></a>
El nombre de un agente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

 ** Platform **   <a name="DataSync-Type-AgentListEntry-Platform"></a>
Los detalles relacionados con la plataforma sobre el agente, como el número de versión.  
Tipo: objeto [Platform](API_Platform.md)  
Obligatorio: no

 ** Status **   <a name="DataSync-Type-AgentListEntry-Status"></a>
El estado de un agente.  
+ Si el estado es `ONLINE`, el agente está configurado correctamente y listo para usarse.
+ Si el estado es`OFFLINE`, el agente ha estado sin contacto con él DataSync durante cinco minutos o más. Esto puede suceder por varias razones. Para obtener más información, consulte [What do I do if my agent is offline?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 
Tipo: cadena  
Valores válidos: `ONLINE | OFFLINE`   
Obligatorio: no

## Véase también
<a name="API_AgentListEntry_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) 

# AzureBlobSasConfiguration
<a name="API_AzureBlobSasConfiguration"></a>

La configuración de firma de acceso compartido (SAS) que permite a AWS DataSync acceder a su Microsoft Azure Blob Storage.

Para obtener más información, consulte los [tokens SAS](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens) para acceder a su Azure Blob Storage.

## Contenido
<a name="API_AzureBlobSasConfiguration_Contents"></a>

 ** Token **   <a name="DataSync-Type-AzureBlobSasConfiguration-Token"></a>
Especifica un token SAS que proporciona permisos para acceder a Azure Blob Storage.  
El token forma parte de la cadena URI de SAS que aparece después del URI del recurso de almacenamiento y de un signo de interrogación. Un token tiene un aspecto similar a este:  
 `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: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^.+$`   
Obligatorio: sí

## Véase también
<a name="API_AzureBlobSasConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) 

# CmkSecretConfig
<a name="API_CmkSecretConfig"></a>

Especifica la información de configuración de un secreto DataSync administrado, como un token de autenticación, una clave secreta, una contraseña o un keytab de Kerberos que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una ubicación administrada por el cliente. AWS KMS key

**nota**  
Puede utilizar `CmkSecretConfig` o `CustomSecretConfig` para proporcionar credenciales para una solicitud de `CreateLocation`. No proporcione ambos parámetros para la misma solicitud.

## Contenido
<a name="API_CmkSecretConfig_Contents"></a>

 ** KmsKeyArn **   <a name="DataSync-Type-CmkSecretConfig-KmsKeyArn"></a>
Especifica el ARN del gestionado por el cliente AWS KMS key que se DataSync utiliza para cifrar el DataSync secreto gestionado almacenado para. `SecretArn` DataSync proporciona esta clave a. AWS Secrets Manager  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$`   
Obligatorio: no

 ** SecretArn **   <a name="DataSync-Type-CmkSecretConfig-SecretArn"></a>
Especifica el ARN del AWS Secrets Manager secreto DataSync administrado que se utiliza para acceder a una ubicación de almacenamiento específica. Esta propiedad la genera DataSync y es de solo lectura. DataSync cifra este secreto con la clave KMS que especifique. `KmsKeyArn`  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Obligatorio: no

## Véase también
<a name="API_CmkSecretConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) 

# CustomSecretConfig
<a name="API_CustomSecretConfig"></a>

Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente, donde las credenciales de un lugar de almacenamiento se almacenan en Secrets Manager como texto sin formato (para el token de autenticación, la clave secreta o la contraseña) o en formato binario (para la pestaña clave de Kerberos). Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto.

**nota**  
Puede utilizar `CmkSecretConfig` o `CustomSecretConfig` para proporcionar credenciales para una solicitud de `CreateLocation`. No proporcione ambos parámetros para la misma solicitud.

## Contenido
<a name="API_CustomSecretConfig_Contents"></a>

 ** SecretAccessRoleArn **   <a name="DataSync-Type-CustomSecretConfig-SecretAccessRoleArn"></a>
Especifica el ARN del AWS Identity and Access Management rol que se DataSync utiliza para acceder al secreto especificado para. `SecretArn`  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$`   
Obligatorio: no

 ** SecretArn **   <a name="DataSync-Type-CustomSecretConfig-SecretArn"></a>
Especifica el ARN de un AWS Secrets Manager secreto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Obligatorio: no

## Véase también
<a name="API_CustomSecretConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) 

# Ec2Config
<a name="API_Ec2Config"></a>

La subred y los grupos de seguridad que se AWS DataSync utilizan para conectarse a uno de los [destinos de montaje](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) del sistema de archivos Amazon EFS.

## Contenido
<a name="API_Ec2Config_Contents"></a>

 ** SecurityGroupArns **   <a name="DataSync-Type-Ec2Config-SecurityGroupArns"></a>
Especifica los nombres de recursos de Amazon (ARNs) de los grupos de seguridad asociados al destino de montaje de un sistema de archivos Amazon EFS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

 ** SubnetArn **   <a name="DataSync-Type-Ec2Config-SubnetArn"></a>
Especifica el ARN de una subred donde DataSync crea las [interfaces de red](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) para administrar el tráfico durante la transferencia.  
La subred debe estar ubicada:  
+ En la misma nube privada virtual (VPC) que el sistema de archivos de Amazon EFS.
+ En la misma zona de disponibilidad que al menos un destino de montaje del sistema de archivos de Amazon EFS.
No es necesario especificar una subred que incluya un destino de montaje del sistema de archivos.
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: sí

## Véase también
<a name="API_Ec2Config_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) 

# FilterRule
<a name="API_FilterRule"></a>

Especifica los archivos, carpetas y objetos que se van a incluir o excluir al transferir archivos del origen al destino.

## Contenido
<a name="API_FilterRule_Contents"></a>

 ** FilterType **   <a name="DataSync-Type-FilterRule-FilterType"></a>
Tipo de regla de filtro que se va a aplicar. AWS DataSync solo admite el tipo de regla SIMPLE\$1PATTERN.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^[A-Z0-9_]+$`   
Valores válidos: `SIMPLE_PATTERN`   
Obligatorio: no

 ** Value **   <a name="DataSync-Type-FilterRule-Value"></a>
Una única cadena de filtro que consiste en los patrones que se incluyen o excluyen. Los patrones están delimitados por “\$1” (es decir, una tubería), por ejemplo: `/folder1|/folder2`   
   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 102 400 caracteres.  
Patrón: `^[^\x00]+$`   
Obligatorio: no

## Véase también
<a name="API_FilterRule_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) 

# FsxProtocol
<a name="API_FsxProtocol"></a>

Especifica el protocolo de transferencia de datos que AWS DataSync utiliza para acceder al sistema de archivos de Amazon FSx.

## Contenido
<a name="API_FsxProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxProtocol-NFS"></a>
Especifique la configuración del protocolo Network File System (NFS) que DataSync utiliza para acceder la máquina virtual de almacenamiento (SVM) del sistema de archivos de FSx para OpenZFS o FSx para ONTAP.  
Tipo: objeto [FsxProtocolNfs](API_FsxProtocolNfs.md)  
Obligatorio: no

 ** SMB **   <a name="DataSync-Type-FsxProtocol-SMB"></a>
Especifique la configuración del protocolo Server Message Block (SMB) que DataSync utiliza para acceder a su máquina virtual de almacenamiento (SVM) del sistema de archivo de FSx para ONTAP.  
Tipo: objeto [FsxProtocolSmb](API_FsxProtocolSmb.md)  
Obligatorio: no

## Véase también
<a name="API_FsxProtocol_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) 

# FsxProtocolNfs
<a name="API_FsxProtocolNfs"></a>

Especifique la configuración del protocolo Network File System (NFS) que DataSync utiliza para acceder la máquina virtual de almacenamiento (SVM) del sistema de archivos de FSx para OpenZFS o FSx para ONTAP.

## Contenido
<a name="API_FsxProtocolNfs_Contents"></a>

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolNfs-MountOptions"></a>
Especifica cómo DataSync puede acceder a una ubicación mediante el protocolo NFS.  
Tipo: objeto [NfsMountOptions](API_NfsMountOptions.md)  
Obligatorio: no

## Véase también
<a name="API_FsxProtocolNfs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) 

# FsxProtocolSmb
<a name="API_FsxProtocolSmb"></a>

Especifica la configuración del protocolo Server Message Block (SMB) que se AWS DataSync utiliza para acceder a la máquina virtual de almacenamiento (SVM) del sistema de archivos Amazon FSx for NetApp ONTAP. Para obtener más información, consulte [Proporcionar DataSync acceso a los sistemas de archivos de FSx ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Contenido
<a name="API_FsxProtocolSmb_Contents"></a>

 ** User **   <a name="DataSync-Type-FsxProtocolSmb-User"></a>
Especifica un usuario que puede montar y acceder a los archivos, carpetas y metadatos que necesita en su SVM.  
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte [Uso del protocolo de SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obligatorio: sí

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync gestionado, que incluye la contraseña que se DataSync utiliza FSx para acceder a una ubicación de almacenamiento específica de ONTAP (mediante SMB), gestionada por el cliente. AWS KMS key  
Cuando incluye este parámetro como parte de una `CreateLocationFsxOntap` solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con la `Password` que especifique para crear un secreto DataSync administrado que almacene las credenciales de acceso a la ubicación.  
Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Puede usar `CmkSecretConfig` (con `Password`) o `CustomSecretConfig` (sin `Password`) para proporcionar credenciales para una solicitud `CreateLocationFsxOntap`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto de Secrets Manager gestionado por el cliente en el que la contraseña de una FSx ubicación de almacenamiento de ONTAP (mediante SMB) se guarda en texto plano, en Secrets Manager. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un secreto](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key) que usted administra.  
Puede usar `CmkSecretConfig` (con `Password`) o `CustomSecretConfig` (sin `Password`) para proporcionar credenciales para una solicitud `CreateLocationFsxOntap`. No proporcione ambos parámetros para la misma solicitud.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** Domain **   <a name="DataSync-Type-FsxProtocolSmb-Domain"></a>
Especifica el nombre del dominio de Windows al que pertenece la máquina virtual de almacenamiento (SVM).  
Si tiene varios dominios en su entorno, al configurar esta configuración se asegura de que DataSync se conecten a la SVM correcta.  
Si tiene varios dominios de Active Directory en su entorno, al configurar este parámetro se asegura de que DataSync se conecte al SVM correcto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Obligatorio: no

 ** ManagedSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como el `Password` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
No la proporciones para una `CreateLocation` solicitud. `ManagedSecretConfig`es una ReadOnly propiedad y solo debe rellenarse en la `DescribeLocation` respuesta.
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)  
Obligatorio: no

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolSmb-MountOptions"></a>
Especifica la versión del protocolo de bloque de mensajes del servidor (SMB) que se AWS DataSync utiliza para acceder a un servidor de archivos SMB.  
Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md)  
Obligatorio: no

 ** Password **   <a name="DataSync-Type-FsxProtocolSmb-Password"></a>
Especifique la contraseña de un usuario que tiene permiso para acceder a la SVM.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^.{0,104}$`   
Obligatorio: no

## Véase también
<a name="API_FsxProtocolSmb_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) 

# FsxUpdateProtocol
<a name="API_FsxUpdateProtocol"></a>

Especifica el protocolo de transferencia de datos que AWS DataSync utiliza para acceder al sistema de archivos de Amazon FSx.

**nota**  
No puede actualizar la configuración del protocolo del sistema de archivos de red (NFS) para ubicaciones de FSx para ONTAP. Actualmente, DataSync solo admite la versión 3 de NFS con este tipo de ubicación.

## Contenido
<a name="API_FsxUpdateProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxUpdateProtocol-NFS"></a>
Especifique la configuración del protocolo Network File System (NFS) que DataSync utiliza para acceder la máquina virtual de almacenamiento (SVM) del sistema de archivos de FSx para OpenZFS o FSx para ONTAP.  
Tipo: objeto [FsxProtocolNfs](API_FsxProtocolNfs.md)  
Obligatorio: no

 ** SMB **   <a name="DataSync-Type-FsxUpdateProtocol-SMB"></a>
Especifica la configuración del protocolo de bloque de mensajes del servidor (SMB) que DataSync utiliza para acceder a la máquina virtual de almacenamiento (SVM) del sistema de archivos Amazon FSx para NetApp ONTAP.  
Tipo: objeto [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md)  
Obligatorio: no

## Véase también
<a name="API_FsxUpdateProtocol_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) 

# FsxUpdateProtocolSmb
<a name="API_FsxUpdateProtocolSmb"></a>

Especifica la configuración del protocolo Server Message Block (SMB) que se AWS DataSync utiliza para acceder a la máquina virtual de almacenamiento (SVM) del sistema de archivos Amazon FSx for NetApp ONTAP. Para obtener más información, consulte [Proporcionar DataSync acceso a los sistemas de archivos de FSx ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Contenido
<a name="API_FsxUpdateProtocolSmb_Contents"></a>

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CmkSecretConfig"></a>
Especifica la información de configuración de un secreto DataSync gestionado, como un `Password` conjunto de credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica, y de un secreto gestionado por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatorio: no

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CustomSecretConfig"></a>
Especifica la información de configuración de un secreto administrado por el cliente, como una `Password` o varias credenciales que se DataSync utilizan para acceder a una ubicación de transferencia específica. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatorio: no

 ** Domain **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Domain"></a>
Especifica el nombre del dominio de Windows al que pertenece la máquina virtual de almacenamiento (SVM).  
Si tiene varios dominios de Active Directory en su entorno, la configuración de este parámetro garantiza que DataSync se conecte al SVM correcto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
Obligatorio: no

 ** MountOptions **   <a name="DataSync-Type-FsxUpdateProtocolSmb-MountOptions"></a>
Especifica la versión del protocolo de bloque de mensajes del servidor (SMB) que se AWS DataSync utiliza para acceder a un servidor de archivos SMB.  
Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md)  
Obligatorio: no

 ** Password **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Password"></a>
Especifique la contraseña de un usuario que tiene permiso para acceder a la SVM.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^.{0,104}$`   
Obligatorio: no

 ** User **   <a name="DataSync-Type-FsxUpdateProtocolSmb-User"></a>
Especifica un usuario que puede montar y acceder a los archivos, carpetas y metadatos que necesita en su SVM.  
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte [Uso del protocolo de SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Obligatorio: no

## Véase también
<a name="API_FsxUpdateProtocolSmb_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) 

# HdfsNameNode
<a name="API_HdfsNameNode"></a>

NameNode del sistema de archivos distribuido de Hadoop (HDFS). El NameNode administra el espacio de nombres del sistema de archivos. El NameNode lleva a cabo operaciones como abrir, cerrar y cambiar el nombre de archivos y directorios. El NameNode contiene la información para asignar bloques de datos a los DataNodes.

## Contenido
<a name="API_HdfsNameNode_Contents"></a>

 ** Hostname **   <a name="DataSync-Type-HdfsNameNode-Hostname"></a>
El nombre de host del NameNode del clúster HDFS. Este valor es la dirección IP o el nombre del Servicio de nombres de dominio (DNS) de NameNode. Un agente que está instalado en las instalaciones utiliza este nombre de host para comunicarse con NameNode en la red.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$`   
Obligatorio: sí

 ** Port **   <a name="DataSync-Type-HdfsNameNode-Port"></a>
El puerto que utiliza NameNode para escuchar las solicitudes de los clientes.  
Tipo: número entero  
Rango válido: valor mínimo de 1. Valor máximo de 65 536.  
Obligatorio: sí

## Véase también
<a name="API_HdfsNameNode_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) 

# LocationFilter
<a name="API_LocationFilter"></a>

Reduce la lista de recursos que arroja `ListLocations`. Por ejemplo, para ver todas sus ubicaciones de Amazon S3, cree un filtro con `"Name": "LocationType"`, `"Operator": "Equals"` y `"Values": "S3"`.

Para obtener más información, consulte [Recursos de filtrado](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html).

## Contenido
<a name="API_LocationFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-LocationFilter-Name"></a>
Nombre del filtro que se está utilizando. Cada llamada a la API admite una lista de filtros que están disponibles para ella (por ejemplo, `LocationType` para `ListLocations`).  
Tipo: cadena  
Valores válidos: `LocationUri | LocationType | CreationTime`   
Obligatorio: sí

 ** Operator **   <a name="DataSync-Type-LocationFilter-Operator"></a>
Es el operador que se utiliza para comparar los valores de los filtros (por ejemplo, `Equals` o `Contains`).  
Tipo: cadena  
Valores válidos: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`   
Obligatorio: sí

 ** Values **   <a name="DataSync-Type-LocationFilter-Values"></a>
Valores por los que quiere filtrar. Por ejemplo, es posible que desee mostrar solo las ubicaciones de Amazon S3.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
Obligatorio: sí

## Véase también
<a name="API_LocationFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) 

# LocationListEntry
<a name="API_LocationListEntry"></a>

Representa una sola entrada en una lista de ubicaciones. `LocationListEntry`devuelve una matriz que contiene una lista de ubicaciones cuando se llama a la [ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)operación.

## Contenido
<a name="API_LocationListEntry_Contents"></a>

 ** LocationArn **   <a name="DataSync-Type-LocationListEntry-LocationArn"></a>
El nombre de recurso de Amazon (ARN) de la ubicación. En el caso del Sistema de archivos de red (NFS) o Amazon EFS, la ubicación es la ruta de exportación. En el caso de Amazon S3, la ubicación es la ruta del prefijo que desea montar y utilizar como la raíz de la sincronización.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** LocationUri **   <a name="DataSync-Type-LocationListEntry-LocationUri"></a>
Representa una lista URIs de ubicaciones. `LocationUri`devuelve una matriz que contiene una lista de ubicaciones cuando se llama a la [ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)operación.  
Formato: `TYPE://GLOBAL_ID/SUBDIR`.  
TYPE designa el tipo de ubicación (por ejemplo, `nfs` o `s3`).  
GLOBAL\$1ID es el identificador único global del recurso que respalda la ubicación. Un ejemplo de EFS es `us-east-2.fs-abcd1234`. Un ejemplo de Amazon S3 es el nombre del bucket, como `myBucket`. Un ejemplo de NFS es una IPv6 dirección IPv4 OR válida o un nombre de host que sea compatible con el DNS.  
SUBDIR es una ruta del sistema de archivos válida, delimitada por barras diagonales, según la convención \$1nix. En el caso de NFS y Amazon EFS, es la ruta de exportación para montar la ubicación. En el caso de Amazon S3, es la ruta del prefijo que desea montar y utilizar como la raíz de la sincronización.  
  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4360 caracteres.  
Patrón: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$`   
Obligatorio: no

## Véase también
<a name="API_LocationListEntry_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) 

# ManagedSecretConfig
<a name="API_ManagedSecretConfig"></a>

Especifica la información de configuración de un secreto DataSync administrado, como un token de autenticación o un conjunto de credenciales que se DataSync utiliza para acceder a una ubicación de transferencia específica. DataSync utiliza la clave KMS AWS administrada de forma predeterminada para cifrar este secreto. AWS Secrets Manager

## Contenido
<a name="API_ManagedSecretConfig_Contents"></a>

 ** SecretArn **   <a name="DataSync-Type-ManagedSecretConfig-SecretArn"></a>
Especifica el ARN de un AWS Secrets Manager secreto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Obligatorio: no

## Véase también
<a name="API_ManagedSecretConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) 

# ManifestConfig
<a name="API_ManifestConfig"></a>

Configura un manifiesto, que es una lista de archivos u objetos que desea que AWS DataSync transfiera. Para obtener más información y ejemplos de configuración, consulte [Especificar lo que DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Contenido
<a name="API_ManifestConfig_Contents"></a>

 ** Action **   <a name="DataSync-Type-ManifestConfig-Action"></a>
Especifica para qué utiliza DataSync el manifiesto.  
Tipo: cadena  
Valores válidos: `TRANSFER`   
Obligatorio: no

 ** Format **   <a name="DataSync-Type-ManifestConfig-Format"></a>
Específica el formato de archivo del manifiesto. Para obtener información, consulte [Crear un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create).  
Tipo: cadena  
Valores válidos: `CSV`   
Obligatorio: no

 ** Source **   <a name="DataSync-Type-ManifestConfig-Source"></a>
Especifica el manifiesto que quieres que use DataSync y dónde está alojado.  
Debe especificar este parámetro si va a configurar un nuevo manifiesto a partir del 7 de febrero de 2024.  
Si no lo hace, recibirá un código de estado 400 y un error `ValidationException` que indica que le falta la función de IAM para que DataSync pueda acceder al bucket de S3 en el que aloja su manifiesto. Para obtener más información, consulte [Cómo proporcionar acceso a DataSync al manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access).
Tipo: objeto [SourceManifestConfig](API_SourceManifestConfig.md)  
Obligatorio: no

## Véase también
<a name="API_ManifestConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) 

# NfsMountOptions
<a name="API_NfsMountOptions"></a>

Especifica cómo DataSync puede acceder a una ubicación mediante el protocolo NFS.

## Contenido
<a name="API_NfsMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-NfsMountOptions-Version"></a>
Específica la versión de NFS que desea que DataSync utilice para montar el recurso compartido de NFS. Si el servidor se niega a utilizar la versión especificada, se producirá un error en la tarea.  
Puede especificar las opciones siguientes:  
+  `AUTOMATIC` (predeterminado): DataSync elige NFS versión 4.1.
+  `NFS3`: versión de protocolo sin estado que permite escrituras asincrónicas en el servidor.
+  `NFSv4_0`: versión de protocolo con estado y compatible con cortafuegos que admite delegaciones y pseudo sistemas de archivos.
+  `NFSv4_1`: versión de protocolo con estado que admite sesiones, delegaciones de directorios y procesamiento de datos en paralelo. La versión 4.1 de NFS también incluye todas las funciones disponibles en la versión 4.0.
Actualmente, DataSync solo admite la versión 3 de NFS con ubicaciones de Amazon FSx para NetApp ONTAP.
Tipo: cadena  
Valores válidos: `AUTOMATIC | NFS3 | NFS4_0 | NFS4_1`   
Obligatorio: no

## Véase también
<a name="API_NfsMountOptions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) 

# OnPremConfig
<a name="API_OnPremConfig"></a>

Los AWS DataSync agentes que se pueden conectar al servidor de archivos del Network File System (NFS).

## Contenido
<a name="API_OnPremConfig_Contents"></a>

 ** AgentArns **   <a name="DataSync-Type-OnPremConfig-AgentArns"></a>
Los nombres de recursos de Amazon (ARNs) de los DataSync agentes que se pueden conectar al servidor de archivos NFS.  
Puede especificar más de un agente. Para obtener más información, consulte [Uso de varios DataSync agentes](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents).  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: sí

## Véase también
<a name="API_OnPremConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) 

# Options
<a name="API_Options"></a>

Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones.

Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).

También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual.

## Contenido
<a name="API_Options_Contents"></a>

 ** Atime **   <a name="DataSync-Type-Options-Atime"></a>
Especifica si deben conservarse los metadatos que indican la última vez que se leyó o escribió un archivo.  
El comportamiento de `Atime` no es totalmente estándar en todas las plataformas, por lo que solo DataSync se puede hacer si se hace el mejor esfuerzo.
+  `BEST_EFFORT`(predeterminado): DataSync intenta conservar el `Atime` atributo original en todos los archivos fuente (es decir, la versión anterior a los `PREPARING` pasos de ejecución de la tarea). Se recomienda usar esta opción.
+  `NONE`: ignora `Atime`.
Si `Atime` se establece en `BEST_EFFORT`, `Mtime` debe establecerse en `PRESERVE`.   
Si `Atime` se establece en `NONE`, `Mtime` también debe ser `NONE`. 
Tipo: cadena  
Valores válidos: `NONE | BEST_EFFORT`   
Obligatorio: no

 ** BytesPerSecond **   <a name="DataSync-Type-Options-BytesPerSecond"></a>
Limita el ancho de banda utilizado por una DataSync tarea. Por ejemplo, si desea DataSync utilizar un máximo de 1 MB, establezca este valor en `1048576` (`=1024*1024`).  
Tipo: largo  
Rango válido: valor mínimo de -1.  
Obligatorio: no

 ** Gid **   <a name="DataSync-Type-Options-Gid"></a>
Especifica la ID del grupo POSIX (GID) de los propietarios del archivo.  
+  `INT_VALUE` (predeterminado): conserva el valor entero del ID de usuario (UID) y del GID (recomendado), que está recomendado.
+  `NONE`: ignoran los UID y GID.
Para obtener más información, consulte [Cómo se DataSync gestionan los metadatos de archivos y objetos](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
Tipo: cadena  
Valores válidos: `NONE | INT_VALUE | NAME | BOTH`   
Obligatorio: no

 ** LogLevel **   <a name="DataSync-Type-Options-LogLevel"></a>
Especifica el tipo de registros que se DataSync publican en un grupo de CloudWatch registros de Amazon Logs. Para especificar el grupo de registros, consulte [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn).  
+  `BASIC`- Publica los registros solo con información básica (como los errores de transferencia).
+  `TRANSFER`- Publica los registros de todos los archivos u objetos que transfiere la DataSync tarea y comprueba la integridad de los datos.
+  `OFF`- No se publica ningún registro.
Tipo: cadena  
Valores válidos: `OFF | BASIC | TRANSFER`   
Obligatorio: no

 ** Mtime **   <a name="DataSync-Type-Options-Mtime"></a>
Especifica si se deben conservar los metadatos que indican la última vez que se escribió un archivo antes del paso `PREPARING` de la ejecución de la tarea. Esta opción es obligatoria cuando necesita ejecutar la misma tarea más de una vez.  
+  `PRESERVE`(predeterminado): conserva el original`Mtime`, lo que se recomienda.
+  `NONE`: ignora `Mtime`.
Si `Mtime` se establece en `PRESERVE`, `Atime` debe establecerse en `BEST_EFFORT`.  
Si `Mtime` se establece en `NONE`, `Atime` también se debe establecer en `NONE`. 
Tipo: cadena  
Valores válidos: `NONE | PRESERVE`   
Obligatorio: no

 ** ObjectTags **   <a name="DataSync-Type-Options-ObjectTags"></a>
Especifica si desea DataSync poner `PRESERVE` objetos en las etiquetas (comportamiento predeterminado) al realizar transferencias entre sistemas de almacenamiento de objetos. Si desea que la DataSync tarea ignore las etiquetas de objetos, especifique el `NONE` valor.  
Tipo: cadena  
Valores válidos: `PRESERVE | NONE`   
Obligatorio: no

 ** OverwriteMode **   <a name="DataSync-Type-Options-OverwriteMode"></a>
Especifica si se DataSync deben modificar o conservar los datos en la ubicación de destino.  
+  `ALWAYS`(predeterminado): DataSync modifica los datos de la ubicación de destino cuando los datos de origen (incluidos los metadatos) cambian.

  Si DataSync sobrescribe objetos, es posible que incurra en cargos adicionales por determinadas clases de almacenamiento de Amazon S3 (por ejemplo, por recuperación o eliminación anticipada). Para obtener más información, consulte [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NEVER`- DataSync no sobrescribe los datos de la ubicación de destino aunque los datos de origen hayan cambiado. Puede utilizar esta opción para evitar que se sobrescriban los cambios realizados en los archivos u objetos del destino.
Tipo: cadena  
Valores válidos: `ALWAYS | NEVER`   
Obligatorio: no

 ** PosixPermissions **   <a name="DataSync-Type-Options-PosixPermissions"></a>
Determina qué usuarios o grupos pueden acceder a un archivo para un propósito específico, como leer, escribir o ejecutar el archivo.  
Para obtener más información, consulte [Cómo se gestionan DataSync los metadatos de archivos y objetos](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `PRESERVE`(predeterminado): conserva los permisos de estilo POSIX, lo que se recomienda.
+  `NONE`- Ignora los permisos de estilo POSIX. 
DataSync puede conservar los permisos actuales de una ubicación de origen.
Tipo: cadena  
Valores válidos: `NONE | PRESERVE`   
Obligatorio: no

 ** PreserveDeletedFiles **   <a name="DataSync-Type-Options-PreserveDeletedFiles"></a>
Valor que especifica si los archivos del destino que no existen en el origen deben conservarse. Esta opción puede afectar su costo de almacenamiento Amazon S3. Si su tarea elimina objetos, es posible que se apliquen cargos mínimos por la duración de almacenamiento para determinadas clases de almacenamiento. Para obtener información detallada, consulte [Consideraciones al trabajar con clases de almacenamiento de Amazon S3 en DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
+  `PRESERVE`(predeterminado): ignora dichos archivos de destino, lo cual es recomendable. 
+  `REMOVE`: elimina los archivos de destino que no están presentes en el origen.
Si establece este parámetro en `REMOVE`, no podrá configurar `TransferMode` en `ALL`. Al transferir todos los datos, DataSync no escanea la ubicación de destino y no sabe qué eliminar.
Tipo: cadena  
Valores válidos: `PRESERVE | REMOVE`   
Obligatorio: no

 ** PreserveDevices **   <a name="DataSync-Type-Options-PreserveDevices"></a>
Especifica si se DataSync deben conservar los metadatos de los dispositivos de bloques y caracteres en la ubicación de origen y volver a crear los archivos con el nombre del dispositivo y los metadatos en el destino. DataSync copia únicamente el nombre y los metadatos de dichos dispositivos.  
DataSync no puede copiar el contenido real de estos dispositivos porque no son terminales y no devuelven un marcador end-of-file (EOF).
+  `NONE`(predeterminado): ignoran los dispositivos especiales (recomendado).
+  `PRESERVE`: conserva los metadatos de los dispositivos de bloques y caracteres. Amazon EFS actualmente no admite esta opción.
Tipo: cadena  
Valores válidos: `NONE | PRESERVE`   
Obligatorio: no

 ** SecurityDescriptorCopyFlags **   <a name="DataSync-Type-Options-SecurityDescriptorCopyFlags"></a>
Determina qué componentes del descriptor de seguridad de SMB se copian de los objetos de origen a los de destino.   
Este valor solo se usa para transferencias entre ubicaciones de SMB y Amazon FSx for Windows File Server o entre dos FSx ubicaciones de Windows File Server. Para obtener más información, consulte [Cómo se gestionan DataSync los metadatos de archivos y objetos](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `OWNER_DACL`(predeterminado): para cada objeto copiado, DataSync copia los siguientes metadatos:
  + El propietario del objeto.
  + Listas de control de acceso discrecional de NTFS (DACLs), que determinan si se debe conceder el acceso a un objeto.

    DataSync no copiará las listas de control de acceso al sistema NTFS (SACLs) con esta opción.
+  `OWNER_DACL_SACL`- Para cada objeto copiado, DataSync copia los siguientes metadatos:
  + El propietario del objeto.
  + Listas de control de acceso discrecional de NTFS (DACLs), que determinan si se debe conceder el acceso a un objeto.
  + SACLs, que los administradores utilizan para registrar los intentos de acceso a un objeto protegido.

     SACLs Para copiar es necesario conceder permisos adicionales al usuario de Windows que DataSync utilice para acceder a su ubicación SMB. Para obtener información sobre cómo elegir un usuario con los permisos correctos, consulta los permisos necesarios para [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) o [FSx ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (según el tipo de ubicación de la transferencia).
+  `NONE`: no se copia ninguno de los componentes del descriptor de seguridad de SMB. Los objetos de destino son propiedad del usuario que se proporcionó para acceder a la ubicación de destino. DACLs y SACLs se establecen en función de la configuración del servidor de destino. 
Tipo: cadena  
Valores válidos: `NONE | OWNER_DACL | OWNER_DACL_SACL`   
Obligatorio: no

 ** TaskQueueing **   <a name="DataSync-Type-Options-TaskQueueing"></a>
Especifica si las tareas de transferencia deben ponerse en cola en determinadas situaciones en los que [se ejecutan varias tareas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks). Este es `ENABLED` de forma predeterminada.  
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: no

 ** TransferMode **   <a name="DataSync-Type-Options-TransferMode"></a>
Especifica si DataSync transfiere solo los datos (incluidos los metadatos) que difieren de una ubicación a otra después de una copia inicial o si transfiere todos los datos cada vez que se ejecuta la tarea. Si se planifican transferencias recurrentes, es posible que solo se desee transferir lo que haya cambiado desde la ejecución anterior de la tarea.  
+  `CHANGED`(predeterminado): tras la transferencia completa inicial, DataSync copia solo los datos y metadatos que difieran de la ubicación de origen y la de destino.
+  `ALL`- DataSync copia todo el contenido de la fuente al destino sin comparar las diferencias entre las ubicaciones.
Tipo: cadena  
Valores válidos: `CHANGED | ALL`   
Obligatorio: no

 ** Uid **   <a name="DataSync-Type-Options-Uid"></a>
Especifica el ID de usuario de POSIX (UID) del propietario del archivo.  
+  `INT_VALUE` (predeterminado): conserva el valor entero del ID de usuario (UID) y del ID de grupo (GID), que está recomendado.
+  `NONE`: ignoran los UID y GID. 
Para obtener más información, consulte [Metadatos copiados por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied).  
Tipo: cadena  
Valores válidos: `NONE | INT_VALUE | NAME | BOTH`   
Obligatorio: no

 ** VerifyMode **   <a name="DataSync-Type-Options-VerifyMode"></a>
Especifica si se DataSync comprueba la integridad de los datos al final de la transferencia y cómo lo hace.  
+  `ONLY_FILES_TRANSFERRED`(recomendado): DataSync calcula la suma de verificación de los datos transferidos (incluidos los metadatos) en la ubicación de origen. Al final de la transferencia, compara esta suma DataSync de verificación con la suma de verificación calculada para esos datos en el destino.
**nota**  
Esta es la opción predeterminada para las tareas en [modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

  Es conveniente utilizar esta opción cuando la transferencia se realice a S3 Glacier Flexible Retrieval o a las clases de almacenamiento de S3 Glacier Deep Archive. Para obtener más información, consulte [Storage class considerations with Amazon S3 locations](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `POINT_IN_TIME_CONSISTENT`- Al final de la transferencia, DataSync comprueba todo el origen y el destino para comprobar que ambas ubicaciones estén completamente sincronizadas.
**nota**  
Esta es la opción predeterminada para las tareas en [modo básico](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) y actualmente no es compatible con las tareas en modo mejorado.

  Si utilizas un [manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), DataSync solo escanea y verifica lo que aparece en el manifiesto.

  No puede utilizar esta opción cuando la transferencia se realice a S3 Glacier Flexible Retrieval o a las clases de almacenamiento de S3 Glacier Deep Archive. Para obtener más información, consulte [Storage class considerations with Amazon S3 locations](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NONE`- DataSync comprueba la integridad de los datos solo durante la transferencia. A diferencia de otras opciones, no hay ninguna verificación adicional al final de la transferencia.
Tipo: cadena  
Valores válidos: `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE`   
Obligatorio: no

## Véase también
<a name="API_Options_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) 

# Platform
<a name="API_Platform"></a>

Los detalles relacionados con la plataforma sobre el agente de AWS DataSync, como el número de versión.

## Contenido
<a name="API_Platform_Contents"></a>

 ** Version **   <a name="DataSync-Type-Platform-Version"></a>
La versión del agente de DataSync.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

## Véase también
<a name="API_Platform_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) 

# PrivateLinkConfig
<a name="API_PrivateLinkConfig"></a>

Especifica cómo se conecta su AWS DataSync agente AWS mediante un punto final de [servicio de nube privada virtual (VPC)](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc). No se puede acceder a un agente que usa un punto de conexión de VPC a través de la red de Internet pública.

## Contenido
<a name="API_PrivateLinkConfig_Contents"></a>

 ** PrivateLinkEndpoint **   <a name="DataSync-Type-PrivateLinkConfig-PrivateLinkEndpoint"></a>
Especifica el punto de conexión de VPC proporcionado por el [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html) al que se conecta el agente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 15.  
Patrón: `\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`   
Obligatorio: no

 ** SecurityGroupArns **   <a name="DataSync-Type-PrivateLinkConfig-SecurityGroupArns"></a>
Especifica los nombres de recursos de Amazon (ARN) del grupo de seguridad que proporciona DataSync acceso al punto final de la VPC. Solo puede especificar un ARN.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: no

 ** SubnetArns **   <a name="DataSync-Type-PrivateLinkConfig-SubnetArns"></a>
Especifica el ARN de la subred en la que se encuentra el punto de conexión de VPC. Solo puede especificar un ARN.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: no

 ** VpcEndpointId **   <a name="DataSync-Type-PrivateLinkConfig-VpcEndpointId"></a>
Especifica el ID del punto de conexión de VPC al que se conecta su agente.  
Tipo: cadena  
Patrón: `^vpce-[0-9a-f]{17}$`   
Obligatorio: no

## Véase también
<a name="API_PrivateLinkConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) 

# QopConfiguration
<a name="API_QopConfiguration"></a>

La configuración de calidad de protección (QOP) especifica la configuración de privacidad de llamada a procedimiento remoto (RPC) y transferencia de datos configurada en el clúster del sistema de archivos distribuido de Hadoop (HDFS).

## Contenido
<a name="API_QopConfiguration_Contents"></a>

 ** DataTransferProtection **   <a name="DataSync-Type-QopConfiguration-DataTransferProtection"></a>
La configuración de protección de transferencia de datos configurada en el clúster HDFS. Esta configuración corresponde a la configuración de `dfs.data.transfer.protection` en el archivo `hdfs-site.xml` en su clúster de Hadoop.  
Tipo: cadena  
Valores válidos: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`   
Obligatorio: no

 ** RpcProtection **   <a name="DataSync-Type-QopConfiguration-RpcProtection"></a>
La configuración de protección de transferencia de datos configurada en el clúster de HDFS. Esta configuración corresponde a la configuración de `hadoop.rpc.protection` en el archivo `core-site.xml` en su clúster de Hadoop.  
Tipo: cadena  
Valores válidos: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`   
Obligatorio: no

## Véase también
<a name="API_QopConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) 

# ReportDestination
<a name="API_ReportDestination"></a>

Especifica el lugar en el que DataSync carga el [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Contenido
<a name="API_ReportDestination_Contents"></a>

 ** S3 **   <a name="DataSync-Type-ReportDestination-S3"></a>
Especifica el bucket de Amazon S3 donde DataSync carga el informe de tareas.  
Tipo: objeto [ReportDestinationS3](API_ReportDestinationS3.md)  
Obligatorio: no

## Véase también
<a name="API_ReportDestination_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) 

# ReportDestinationS3
<a name="API_ReportDestinationS3"></a>

Especifica el bucket de Amazon S3 en el que se DataSync carga el [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Contenido
<a name="API_ReportDestinationS3_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-ReportDestinationS3-BucketAccessRoleArn"></a>
Especifica el nombre de recurso de Amazon (ARN) de la política de IAM que permite DataSync cargar un informe de tareas en el bucket de S3. Para obtener más información, consulte [Permitir DataSync cargar un informe de tareas a un bucket de Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obligatorio: sí

 ** S3BucketArn **   <a name="DataSync-Type-ReportDestinationS3-S3BucketArn"></a>
Especifica el ARN del depósito de S3 en el que se DataSync carga el informe.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 268.  
Patrón: `^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}$`   
Obligatorio: sí

 ** Subdirectory **   <a name="DataSync-Type-ReportDestinationS3-Subdirectory"></a>
Especifica un prefijo de bucket para el informe.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: no

## Véase también
<a name="API_ReportDestinationS3_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) 

# ReportOverride
<a name="API_ReportOverride"></a>

Especifica el nivel de detalle de un aspecto concreto de su [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) de DataSync.

## Contenido
<a name="API_ReportOverride_Contents"></a>

 ** ReportLevel **   <a name="DataSync-Type-ReportOverride-ReportLevel"></a>
Especifica si su informe de tareas incluye solo errores o aciertos y errores.  
Por ejemplo, es posible que el informe incluya principalmente solo aquello que no salió bien en la transferencia (`ERRORS_ONLY`). Al mismo tiempo, es conveniente que compruebe que su [filtro de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) funciona correctamente. En esta situación, puede obtener una lista de los archivos que DataSync omitió correctamente y si se transfirió algo que no quería transferir (`SUCCESSES_AND_ERRORS`).  
Tipo: cadena  
Valores válidos: `ERRORS_ONLY | SUCCESSES_AND_ERRORS`   
Obligatorio: no

## Véase también
<a name="API_ReportOverride_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) 

# ReportOverrides
<a name="API_ReportOverrides"></a>

El nivel de detalle incluido en cada aspecto de su [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) de DataSync.

## Contenido
<a name="API_ReportOverrides_Contents"></a>

 ** Deleted **   <a name="DataSync-Type-ReportOverrides-Deleted"></a>
Especifica el nivel de informe de los archivos, objetos y directorios que DataSync intentó eliminar en su ubicación de destino. Esto solo se aplica si [configura su tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen.  
Tipo: objeto [ReportOverride](API_ReportOverride.md)  
Obligatorio: no

 ** Skipped **   <a name="DataSync-Type-ReportOverrides-Skipped"></a>
Especifica el nivel de informe de los archivos, objetos y directorios que DataSync intentó omitir durante su transferencia.  
Tipo: objeto [ReportOverride](API_ReportOverride.md)  
Obligatorio: no

 ** Transferred **   <a name="DataSync-Type-ReportOverrides-Transferred"></a>
Especifica el nivel de informe de los archivos, objetos y directorios que DataSync intentó transferir.  
Tipo: objeto [ReportOverride](API_ReportOverride.md)  
Obligatorio: no

 ** Verified **   <a name="DataSync-Type-ReportOverrides-Verified"></a>
Especifica el nivel de informe de los archivos, objetos y directorios que DataSync intentó verificar al final de su transferencia.  
Tipo: objeto [ReportOverride](API_ReportOverride.md)  
Obligatorio: no

## Véase también
<a name="API_ReportOverrides_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) 

# ReportResult
<a name="API_ReportResult"></a>

Indica si DataSync creó un [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) completo para la transferencia.

## Contenido
<a name="API_ReportResult_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-ReportResult-ErrorCode"></a>
Indica el código asociado al error si DataSync no puede crear un informe completo.  
Tipo: cadena  
Requerido: no

 ** ErrorDetail **   <a name="DataSync-Type-ReportResult-ErrorDetail"></a>
Proporciona detalles sobre los problemas al crear un informe.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="DataSync-Type-ReportResult-Status"></a>
Indica si DataSync todavía sigue trabajando en el informe, ha creado un informe o no puede crear un informe completo.  
Tipo: cadena  
Valores válidos: `PENDING | SUCCESS | ERROR`   
Obligatorio: no

## Véase también
<a name="API_ReportResult_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) 

# S3Config
<a name="API_S3Config"></a>

Especifica el nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que se DataSync utiliza para acceder al bucket de S3.

Para obtener más información, consulte [Proporcionar DataSync acceso a los buckets de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).

## Contenido
<a name="API_S3Config_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3Config-BucketAccessRoleArn"></a>
Especifica el ARN de la función de IAM que se DataSync utiliza para acceder al bucket de S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obligatorio: sí

## Véase también
<a name="API_S3Config_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) 

# S3ManifestConfig
<a name="API_S3ManifestConfig"></a>

Especifica el bucket de S3 en el que alojas el manifiesto que AWS DataSync quieres usar. Para obtener más información y ejemplos de configuración, consulta [Especificar qué se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Contenido
<a name="API_S3ManifestConfig_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3ManifestConfig-BucketAccessRoleArn"></a>
Especifica la función AWS Identity and Access Management (IAM) que permite acceder DataSync al manifiesto. Para obtener más información, consulta Cómo [proporcionar DataSync acceso a tu manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Obligatorio: sí

 ** ManifestObjectPath **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectPath"></a>
Específica la clave de objeto de Amazon S3 de su manifiesto. Puede incluir un prefijo (por ejemplo, `prefix/my-manifest.csv`).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 4096 caracteres.  
Patrón: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatorio: sí

 ** S3BucketArn **   <a name="DataSync-Type-S3ManifestConfig-S3BucketArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del bucket de S3 en el que aloja el manifiesto.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 268.  
Patrón: `^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}$`   
Obligatorio: sí

 ** ManifestObjectVersionId **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectVersionId"></a>
Especifica el ID de versión del objeto del manifiesto que DataSync quieres usar. Si no lo estableces, DataSync utiliza la última versión del objeto.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^.+$`   
Obligatorio: no

## Véase también
<a name="API_S3ManifestConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) 

# SmbMountOptions
<a name="API_SmbMountOptions"></a>

Especifica la versión del protocolo Server Message Block (SMB) que AWS DataSync utiliza para acceder a un servidor de archivos SMB.

## Contenido
<a name="API_SmbMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-SmbMountOptions-Version"></a>
De forma predeterminada, DataSync elige automáticamente una versión del protocolo SMB en función de la negociación con el servidor de archivos SMB. Además, puede configurar DataSync para que utilice una versión de SMB específica; sin embargo, recomendamos que lo haga solo si DataSync tiene problemas para negociar de manera automática con el servidor de archivos SMB.  
A continuación, se enumeran las opciones para configurar la versión de SMB:  
+  `AUTOMATIC` (predeterminado): DataSync y el servidor de archivos SMB negocian la versión más alta de SMB que ambos admiten entre 2.1 y 3.1.1.

  Esta es la opción recomendada. Si, por el contrario, elige una versión específica que el servidor de archivos no admite, es posible que aparezca un error `Operation Not Supported`.
+  `SMB3`: restringe la negociación del protocolo solo a la versión 3.0.2 de SMB.
+  `SMB2`: restringe la negociación del protocolo solo a la versión 2.1 de SMB.
+  `SMB2_0`: restringe la negociación del protocolo solo a la versión 2.0 de SMB.
+  `SMB1`: restringe la negociación del protocolo solo a la versión 1.0 de SMB.
**nota**  
La opción `SMB1` no está disponible al [crear una ubicación de Amazon FSx para NetApp ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html).
Tipo: cadena  
Valores válidos: `AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0`   
Obligatorio: no

## Véase también
<a name="API_SmbMountOptions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) 

# SourceManifestConfig
<a name="API_SourceManifestConfig"></a>

Especifica el manifiesto que quieres que use AWS DataSync y dónde está alojado. Para obtener más información y ejemplos de configuración, consulte [Especificar lo que DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Contenido
<a name="API_SourceManifestConfig_Contents"></a>

 ** S3 **   <a name="DataSync-Type-SourceManifestConfig-S3"></a>
Especifica el bucket de S3 en el que alojas el manifiesto.  
Tipo: objeto [S3ManifestConfig](API_S3ManifestConfig.md)  
Obligatorio: sí

## Véase también
<a name="API_SourceManifestConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) 

# TagListEntry
<a name="API_TagListEntry"></a>

Par clave-valor que representa una sola etiqueta que se ha aplicado a un recurso de AWS.

## Contenido
<a name="API_TagListEntry_Contents"></a>

 ** Key **   <a name="DataSync-Type-TagListEntry-Key"></a>
Clave de una etiqueta de recurso de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:/-]+$`   
Obligatorio: sí

 ** Value **   <a name="DataSync-Type-TagListEntry-Value"></a>
Valor de una etiqueta de recurso de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

## Véase también
<a name="API_TagListEntry_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) 

# TaskExecutionFilesFailedDetail
<a name="API_TaskExecutionFilesFailedDetail"></a>

El número de archivos u objetos que DataSync no se pueden preparar, transferir, verificar ni eliminar durante la ejecución de la tarea.

**nota**  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Contenido
<a name="API_TaskExecutionFilesFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Delete"></a>
El número de archivos u objetos que DataSync no se pueden eliminar durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Prepare"></a>
El número de archivos u objetos que DataSync no se preparan durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Transfer"></a>
El número de archivos u objetos que DataSync no se pueden transferir durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** Verify **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Verify"></a>
El número de archivos u objetos que DataSync no se verifican durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

## Véase también
<a name="API_TaskExecutionFilesFailedDetail_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 

# TaskExecutionFilesListedDetail
<a name="API_TaskExecutionFilesListedDetail"></a>

El número de archivos u objetos que DataSync se encuentran en sus ubicaciones.

**nota**  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Contenido
<a name="API_TaskExecutionFilesListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtDestinationForDelete"></a>
El número de archivos u objetos que DataSync se encuentran en la ubicación de destino. Este contador solo es aplicable si la tarea se configura para [eliminar datos en el destino que no están presentes en el origen](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling).  
Tipo: largo  
Obligatorio: no

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtSource"></a>
El número de archivos u objetos que DataSync se encuentran en la ubicación de origen.  
+ En el caso de un [manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), solo se DataSync muestra lo que hay en el manifiesto (y no todo lo que se encuentra en la ubicación de origen).
+ Con un [filtro de inclusión](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html), solo DataSync muestra lo que coincide con el filtro de tu ubicación de origen.
+ Con un filtro de exclusión, DataSync muestra todo lo que hay en la ubicación de origen antes de aplicar el filtro.
Tipo: largo  
Obligatorio: no

## Véase también
<a name="API_TaskExecutionFilesListedDetail_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) 

# TaskExecutionFoldersFailedDetail
<a name="API_TaskExecutionFoldersFailedDetail"></a>

El número de directorios que DataSync no se muestran, preparan, transfieren, verifican ni eliminan durante la ejecución de la tarea.

**nota**  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Contenido
<a name="API_TaskExecutionFoldersFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Delete"></a>
El número de directorios que DataSync no se eliminan durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** List **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-List"></a>
El número de directorios que DataSync no aparecen en la lista durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Prepare"></a>
El número de directorios que DataSync no se preparan durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Transfer"></a>
El número de directorios que DataSync no se pueden transferir durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

 ** Verify **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Verify"></a>
El número de directorios que DataSync no se verifican durante la ejecución de la tarea.  
Tipo: largo  
Obligatorio: no

## Véase también
<a name="API_TaskExecutionFoldersFailedDetail_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 

# TaskExecutionFoldersListedDetail
<a name="API_TaskExecutionFoldersListedDetail"></a>

El número de directorios que DataSync encuentra en sus ubicaciones.

**nota**  
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Contenido
<a name="API_TaskExecutionFoldersListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtDestinationForDelete"></a>
El número de directorios que DataSync se encuentran en la ubicación de destino. Este contador solo es aplicable si la tarea se configura para [eliminar datos en el destino que no están presentes en el origen](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling).  
Tipo: largo  
Obligatorio: no

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtSource"></a>
El número de directorios que DataSync se encuentran en la ubicación de origen.  
+ En el caso de un [manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), solo se DataSync muestra lo que hay en el manifiesto (y no todo lo que se encuentra en la ubicación de origen).
+ Con un [filtro de inclusión](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html), solo DataSync muestra lo que coincide con el filtro de tu ubicación de origen.
+ Con un filtro de exclusión, DataSync muestra todo lo que hay en la ubicación de origen antes de aplicar el filtro.
Tipo: largo  
Obligatorio: no

## Véase también
<a name="API_TaskExecutionFoldersListedDetail_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 

# TaskExecutionListEntry
<a name="API_TaskExecutionListEntry"></a>

Representa una sola entrada en una lista de ejecuciones de AWS DataSync tareas que se devuelve con la [ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html)operación.

## Contenido
<a name="API_TaskExecutionListEntry_Contents"></a>

 ** Status **   <a name="DataSync-Type-TaskExecutionListEntry-Status"></a>
Estado de una ejecución de una tarea. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipo: cadena  
Valores válidos: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`   
Obligatorio: no

 ** TaskExecutionArn **   <a name="DataSync-Type-TaskExecutionListEntry-TaskExecutionArn"></a>
Nombre de recurso de Amazon (ARN) de la ejecución de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** TaskMode **   <a name="DataSync-Type-TaskExecutionListEntry-TaskMode"></a>
El modo de tarea que utiliza. Para obtener más información, consulte [Cómo elegir un modo de tarea para la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: cadena  
Valores válidos: `BASIC | ENHANCED`   
Obligatorio: no

## Véase también
<a name="API_TaskExecutionListEntry_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) 

# TaskExecutionResultDetail
<a name="API_TaskExecutionResultDetail"></a>

Proporciona información detallada sobre el resultado de la ejecución de la tarea de AWS DataSync.

## Contenido
<a name="API_TaskExecutionResultDetail_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorCode"></a>
Un error que DataSync detectó durante la ejecución de la tarea. Puede utilizar esta información para ayudar a [solucionar problemas](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: cadena  
Requerido: no

 ** ErrorDetail **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorDetail"></a>
La descripción detallada de un error que DataSync detectó durante la ejecución de la tarea. Puede utilizar esta información para ayudar a [solucionar problemas](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).   
Tipo: cadena  
Requerido: no

 ** PrepareDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareDuration"></a>
El tiempo, en milisegundos, que la ejecución de la tarea permaneció en el paso `PREPARING`. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Para las tareas en modo mejorado, el valor siempre es `0`. Para obtener más información, consulte [Cómo DataSync prepara la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares).  
Tipo: Long  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** PrepareStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareStatus"></a>
El estado del paso `PREPARING` de la ejecución de la tarea. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipo: cadena  
Valores válidos: `PENDING | SUCCESS | ERROR`   
Obligatorio: no

 ** TotalDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TotalDuration"></a>
El tiempo en milisegundos durante el que se ejecutó la tarea.  
Tipo: Long  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** TransferDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferDuration"></a>
El tiempo, en milisegundos, que la ejecución de la tarea permaneció en el paso `TRANSFERRING`. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Para las tareas en modo mejorado, el valor siempre es `0`. Para obtener más información, consulte [Cómo DataSync transfiere los datos](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers).  
Tipo: Long  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** TransferStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferStatus"></a>
El estado del paso `TRANSFERRING` de la ejecución de la tarea. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipo: cadena  
Valores válidos: `PENDING | SUCCESS | ERROR`   
Obligatorio: no

 ** VerifyDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyDuration"></a>
El tiempo, en milisegundos, que la ejecución de la tarea permaneció en el paso `VERIFYING`. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Para las tareas en modo mejorado, el valor siempre es `0`. Para obtener más información, consulte [Cómo DataSync verifica la integridad de los datos](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works).  
Tipo: Long  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** VerifyStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyStatus"></a>
El estado del paso `VERIFYING` de la ejecución de la tarea. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipo: cadena  
Valores válidos: `PENDING | SUCCESS | ERROR`   
Obligatorio: no

## Véase también
<a name="API_TaskExecutionResultDetail_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) 

# TaskFilter
<a name="API_TaskFilter"></a>

Puede utilizar filtros de API para acotar la lista de recursos devueltos por `ListTasks`. Por ejemplo, para recuperar todas las tareas en una ubicación de origen, puede utilizar `ListTasks` con el nombre del filtro `LocationId` y `Operator Equals` con el ARN de la ubicación.

Para obtener más información, consulte [filtering DataSync resources](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html).

## Contenido
<a name="API_TaskFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskFilter-Name"></a>
Nombre del filtro que se está utilizando. Cada llamada a la API admite una lista de filtros que están disponibles para ella. Por ejemplo, `LocationId` para `ListTasks`.  
Tipo: cadena  
Valores válidos: `LocationId | CreationTime`   
Obligatorio: sí

 ** Operator **   <a name="DataSync-Type-TaskFilter-Operator"></a>
Es el operador que se utiliza para comparar los valores de los filtros (por ejemplo, `Equals` o `Contains`).  
Tipo: cadena  
Valores válidos: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`   
Obligatorio: sí

 ** Values **   <a name="DataSync-Type-TaskFilter-Values"></a>
Valores por los que quiere filtrar. Por ejemplo, es posible que desee mostrar solo las tareas para una ubicación de destino determinada.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
Obligatorio: sí

## Véase también
<a name="API_TaskFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) 

# TaskListEntry
<a name="API_TaskListEntry"></a>

Representa una sola entrada en una lista de tareas. `TaskListEntry`devuelve una matriz que contiene una lista de tareas cuando se llama a la [ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html)operación. Una tarea incluye los sistemas de archivos de origen y destino que se van a sincronizar y las opciones que se van a utilizar en las tareas.

## Contenido
<a name="API_TaskListEntry_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskListEntry-Name"></a>
El nombre de la tarea .  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

 ** Status **   <a name="DataSync-Type-TaskListEntry-Status"></a>
El estado de la tarea.  
Tipo: cadena  
Valores válidos: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE`   
Obligatorio: no

 ** TaskArn **   <a name="DataSync-Type-TaskListEntry-TaskArn"></a>
El nombre de recurso de Amazon (ARN) de la tarea.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$`   
Obligatorio: no

 ** TaskMode **   <a name="DataSync-Type-TaskListEntry-TaskMode"></a>
El modo de tarea que utiliza. Para obtener más información, consulte [Cómo elegir un modo de tarea para la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: cadena  
Valores válidos: `BASIC | ENHANCED`   
Obligatorio: no

## Véase también
<a name="API_TaskListEntry_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) 

# TaskReportConfig
<a name="API_TaskReportConfig"></a>

Especifica el modo en que desea configurar su informe de tareas, que proporciona información detallada sobre la transferencia AWS DataSync.

Para obtener más información, consulte [Informes de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Contenido
<a name="API_TaskReportConfig_Contents"></a>

 ** Destination **   <a name="DataSync-Type-TaskReportConfig-Destination"></a>
Especifica el bucket de Amazon S3 donde DataSync carga el informe de tareas. Para obtener más información, consulte [Informes de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access).  
Tipo: objeto [ReportDestination](API_ReportDestination.md)  
Obligatorio: no

 ** ObjectVersionIds **   <a name="DataSync-Type-TaskReportConfig-ObjectVersionIds"></a>
Especifica si el informe de tareas incluye la nueva versión de cada objeto transferido a un bucket de S3. Esto solo se aplica si [habilita el control de versiones en su bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html). Tenga en cuenta que si lo establece en `INCLUDE`, puede aumentar la duración de la ejecución de la tarea.  
Tipo: cadena  
Valores válidos: `INCLUDE | NONE`   
Obligatorio: no

 ** OutputType **   <a name="DataSync-Type-TaskReportConfig-OutputType"></a>
Especifica el tipo de informe de tareas que desea:  
+  `SUMMARY_ONLY`: proporciona los detalles necesarios sobre la tarea, como el número de archivos, objetos y directorios transferidos y la duración de la transferencia.
+  `STANDARD`: proporciona detalles completos sobre la tarea, incluida una lista completa de los archivos, objetos y directorios que se transfirieron, omitieron, verificaron, etc.
Tipo: cadena  
Valores válidos: `SUMMARY_ONLY | STANDARD`   
Obligatorio: no

 ** Overrides **   <a name="DataSync-Type-TaskReportConfig-Overrides"></a>
Personaliza el nivel de informes para algunos aspectos del informe de tareas. Por ejemplo, es posible que su informe generalmente solo incluya errores, pero puede especificar que desea una lista de resultados satisfactorios y errores solo para los archivos que DataSync intentó eliminar en su ubicación de destino.  
Tipo: objeto [ReportOverrides](API_ReportOverrides.md)  
Obligatorio: no

 ** ReportLevel **   <a name="DataSync-Type-TaskReportConfig-ReportLevel"></a>
Especifica si desea que el informe de tareas incluya solo los errores de la transferencia o una lista de lo que se realizó correctamente y lo que no.  
+  `ERRORS_ONLY`: se muestra en un informe lo que DataSync no pudo transferir, omitir, verificar y eliminar.
+  `SUCCESSES_AND_ERRORS`: se muestra en un informe lo que DataSync pudo transferir, omitir, verificar y eliminar, y lo que no.
Tipo: cadena  
Valores válidos: `ERRORS_ONLY | SUCCESSES_AND_ERRORS`   
Obligatorio: no

## Véase también
<a name="API_TaskReportConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) 

# TaskSchedule
<a name="API_TaskSchedule"></a>

Configura la tarea AWS DataSync para que se ejecute siguiendo una [programación](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (con un intervalo mínimo de 1 hora).

## Contenido
<a name="API_TaskSchedule_Contents"></a>

 ** ScheduleExpression **   <a name="DataSync-Type-TaskSchedule-ScheduleExpression"></a>
Especifica la programación de tareas mediante una expresión Cron o Rate.  
Use expresiones Cron para las programaciones de tareas que se ejecuten a una hora y un día específicos. Por ejemplo, la siguiente expresión Cron crea un programa de tareas que se ejecuta a las 8:00 del primer miércoles de cada mes:  
 `cron(0 8 * * 3#1)`   
Utilice expresiones Rate para los programas de tareas que se ejecuten a intervalos regulares. Por ejemplo, la siguiente expresión Rate crea un programa de tareas que se ejecuta cada 12 horas:  
 `rate(12 hours)`   
Para obtener más información sobre la sintaxis de expresiones Cron y Rate, consulte 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: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\(\)\+]*$`   
Obligatorio: sí

 ** Status **   <a name="DataSync-Type-TaskSchedule-Status"></a>
Especifica si habilitar o deshabilitar la programación de tareas. La programación está habilitada de forma predeterminada, pero puede haber situaciones en las que necesite deshabilitarla. Por ejemplo, es posible que tenga que pausar una transferencia periódica para solucionar un problema con la tarea o realizar tareas de mantenimiento en el sistema de almacenamiento.  
DataSync puede deshabilitar automáticamente su programa si la tarea falla repetidamente con el mismo error. Para obtener más información, consulte [TaskScheduleDetails.](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html)  
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: no

## Véase también
<a name="API_TaskSchedule_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) 

# TaskScheduleDetails
<a name="API_TaskScheduleDetails"></a>

Proporciona información sobre el [programa de la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) AWS DataSync.

## Contenido
<a name="API_TaskScheduleDetails_Contents"></a>

 ** DisabledBy **   <a name="DataSync-Type-TaskScheduleDetails-DisabledBy"></a>
Indica cómo se deshabilitó el programa de la tarea.  
+  `USER` - Su programa se inhabilitó manualmente mediante la operación [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html) o la consola DataSync.
+  `SERVICE` - DataSync inhabilitó automáticamente su programa porque la tarea falló repetidamente con el mismo error.
Tipo: cadena  
Valores válidos: `USER | SERVICE`   
Obligatorio: no

 ** DisabledReason **   <a name="DataSync-Type-TaskScheduleDetails-DisabledReason"></a>
Indica el motivo por el que el programa de la tarea está inhabilitado.  
Si su programa ha sido inhabilitado por `USER`, verá un mensaje de `Manually disabled by user.`.  
Si su programa ha sido inhabilitado por `SERVICE`, verá un mensaje de error que lo ayudará a entender por qué la tarea sigue fallando. Para obtener información sobre cómo resolver los errores de DataSync, consulte [Solución de problemas con las transferencias de DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 8192.  
Patrón: `^[\w\s.,'?!:;\/=|<>()-]*$`   
Obligatorio: no

 ** StatusUpdateTime **   <a name="DataSync-Type-TaskScheduleDetails-StatusUpdateTime"></a>
Indica la última vez que se modificó el estado de la programación de tareas. Por ejemplo, si DataSync inhabilita automáticamente su programación debido a la repetición de un error, podrá ver cuándo se inhabilitó la programación.  
Tipo: marca temporal  
Obligatorio: no

## Véase también
<a name="API_TaskScheduleDetails_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) 

# Errores comunes
<a name="CommonErrors"></a>

En esta sección, se enumeran los errores comunes a las acciones de la API de todos los servicios de AWS. En el caso de los errores específicos de una acción de la API de este servicio, consulte el tema de dicha acción de la API.

 **AccessDeniedException**   
No tiene acceso suficiente para realizar esta acción.  
Código de estado HTTP: 400

 **IncompleteSignature**   
La firma de solicitud no se ajusta a los estándares de AWS.  
Código de estado HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
El procesamiento de la solicitud ha devuelto un error debido a un error o una excepción desconocidos.  
Código de estado HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
La acción u operación solicitada no es válida. Compruebe que la acción se ha escrito correctamente.  
Código de estado HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
El certificado X.509 o el ID de clave de acceso de AWS proporcionado no existen en nuestros registros.  
Código de estado HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
No tiene permiso para realizar esta acción.  
Código de estado HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
El ID de clave de acceso de AWS necesita una suscripción al servicio.  
Código de estado HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La solicitud llegó al servicio más de 15 minutos después de la marca de fecha en la solicitud o más de 15 minutos después de la fecha de vencimiento de la solicitud (por ejemplo, para las URL prefirmadas) o la marca de fecha de la solicitud corresponde a una hora futura en más de 15 minutos.  
Código de estado HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.  
Código de estado HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La solicitud fue denegada debido a una limitación de la solicitud.  
Código de estado HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
La entrada no satisface las limitaciones que especifica un servicio de AWS.  
Código de estado HTTP: 400

# Parámetros comunes
<a name="CommonParameters"></a>

La siguiente lista contiene los parámetros que utilizan todas las acciones para firmar solicitudes de Signature Version 4 con una cadena de consulta. Los parámetros específicos de acción se enumeran en el tema correspondiente a la acción. Para obtener más información sobre Signature Version 4, consulte [Firma de solicitudes API de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*.

 **Action**   <a name="CommonParameters-Action"></a>
Las acciones que se van a realizar.  
Tipo: cadena  
Obligatorio: sí

 **Version**   <a name="CommonParameters-Version"></a>
La versión de la API para la que está escrita la solicitud, expresada en el formato AAAA-MM-DD.  
Tipo: cadena  
Obligatorio: sí

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
El algoritmo de hash que utilizó para crear la solicitud de firma.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Valores válidos: `AWS4-HMAC-SHA256`   
Obligatorio: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
El valor del ámbito de la credencial, que es una cadena que incluye la clave de acceso, la fecha, la región a la que se dirige, el servicio que solicita y una cadena de terminación (“aws4\$1request”). El valor se expresa en el siguiente formato: *access\$1key*/*AAAAMMDD*/*region*/*service*/aws4\$1request.  
Para obtener más información, consulte [Crear una solicitud API de AWS firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la *Guía del usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La fecha utilizada para crear la firma. El formato debe ser ISO 8601 formato básico (AAAAMMDD‘T’HHMMSS‘Z’). Por ejemplo, la siguiente fecha y hora es un valor válido de X-Amz-Date para `20120325T120000Z`.  
Condición: X-Amz-Date es opcional en todas las solicitudes; se puede utilizar para anular la fecha empleada a fin de firmar las solicitudes. Si el encabezado Date se especifica en el formato básico ISO 8601, no se requiere X-Amz-Date. Cuando se usa X-Amz-Date, siempre anula el valor del encabezado Date. Para obtener más información, consulte [Elementos de una firma de solicitud API de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) en la *Guía del usuario de IAM*.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
El token de seguridad temporal que se obtuvo mediante una llamada a AWS Security Token Service (AWS STS). Para obtener una lista de servicios compatibles con las credenciales de seguridad temporales de AWS STS, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la *Guía del usuario de IAM*.  
Condición: si utiliza credenciales de seguridad temporales de AWS STS, debe incluir el token de seguridad.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica la firma codificada hexadecimal que se calculó a partir de la cadena que se va a firmar y la clave de firma derivada.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos los encabezados HTTP que se incluyeron como parte de la solicitud canónica. Para obtener más información acerca de especificar encabezados firmados, consulte [Crear una solicitud API de AWS firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la *Guía del usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional