

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.

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