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.
CreateLocationHdfs
Crea un sistema de archivos distribuido Hadoop Distributed File System (HDFS).
Sintaxis de la solicitud
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlockSize": number,
"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 solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- AgentArns
-
Los nombres de recurso de Amazon (ARN) de los agentes que se utilizan para conectarse al clúster de HDFS.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 elemento. Número 4 elementos.
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$Obligatorio: sí
- AuthenticationType
-
El tipo de autenticación que se utiliza para determinar la identidad del usuario.
Tipo: String
Valores válidos:
SIMPLE | KERBEROSObligatorio: sí
- BlockSize
-
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. Valor.
Obligatorio: no
- KerberosKeytab
-
La tabla de claves de Kerberos (keytab) que contiene asignaciones entre el Kerberos principal definido y las claves cifradas. Puede cargar la pestaña clave desde un archivo proporcionando la dirección del archivo. Si está utilizandoAWS CLI, realiza la codificación en base64 por usted. De lo contrario, proporcione texto codificado en base64.
nota
Este parámetro es obligatorio si se especifica
KERBEROSparaAuthenticationType.Tipo: objeto de datos binarios codificados en Base64
Limitaciones de longitud: longitud: longitud: 65536 caracteres.
Obligatorio: no
- KerberosKrb5Conf
-
El archivo
krb5.confque contiene la información de configuración de Kerberos. Puede cargar elkrb5.confarchivo proporcionando la dirección del archivo. Si está utilizandoAWS CLI, realizará la codificación en base64 por usted. De lo contrario, proporcione texto codificado en base64.nota
Este parámetro es obligatorio si se especifica
KERBEROSparaAuthenticationType.Tipo: objeto de datos binarios codificados en Base64
Limitaciones de longitud: longitud: longitud: 131072 caracteres.
Obligatorio: no
- KerberosPrincipal
-
El Kerberos principal con acceso a los archivos y carpetas del clúster HDFS.
nota
Este parámetro es obligatorio si se especifica
KERBEROSparaAuthenticationType.Tipo: String
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Patrón:
^.+$Obligatorio: no
- KmsKeyProviderUri
-
El URI de Key Management Server (KMS) del clúster HDFS.
Tipo: String
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
-
El NameNode espacio de nombres HDFS. NameNodeRealiza operaciones como abrir, cerrar y cambiar el nombre de archivos y directorios. NameNodeContiene la información para asignar bloques de datos aDataNodes. Puede utilizar solo unoNameNode.
Tipo: Matriz de objetos HdfsNameNode
Miembros de la matriz: número mínimo de 1 elemento.
Obligatorio: sí
- QopConfiguration
-
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 deRpcProtectionyDataTransferProtectionesPRIVACY. Si configuraRpcProtectionoDataTransferProtection, el otro parámetro asume el mismo valor.Tipo: objeto QopConfiguration
Obligatorio: no
- ReplicationFactor
-
El número en DataNodes que se replican los datos al escribir en el clúster HDFS. De forma predeterminada, los datos se replican en tres DataNodes datos.
Tipo: entero
Rango válido: valor mínimo de 1. Valor.
Obligatorio: no
- SimpleUser
-
El nombre de usuario utilizado para identificar al cliente en el sistema operativo host.
nota
Este parámetro es obligatorio si se especifica
SIMPLEparaAuthenticationType.Tipo: String
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
-
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: String
Limitaciones de longitud: longitud: longitud: 4096 caracteres.
Patrón:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obligatorio: no
- Tags
-
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
Miembros de la matriz: número mínimo de 0 elementos. Número máximo de 50 elementos.
Obligatorio: no
Sintaxis de la respuesta
{
"LocationArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- LocationArn
-
El ARN del clúster HDFS de origen que se crea.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- InternalException
-
Esta excepción se produce cuando se produce un error en el AWS DataSync servicio.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con formato incorrecto.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
