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.
CreateLocationNfs
Define un sistema de archivos en un servidor de Network File System (NFS) en el que se puede leer o escribir.
Sintaxis de la solicitud
{
"MountOptions": {
"Version": "string"
},
"OnPremConfig": {
"AgentArns": [ "string" ]
},
"ServerHostname": "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.
- MountOptions
-
Opciones de montaje NFS queDataSync puede utilizar para montar el recurso compartido NFS.
Tipo: objeto NfsMountOptions
Obligatorio: no
- OnPremConfig
-
Contiene una lista de nombres de recursos de Amazon (ARN) de agentes que se utilizan para conectarse a un servidor NFS.
Si está copiando datos desde o hacia su dispositivo o hacia su dispositivo o desde suAWS Snowcone dispositivo o está copiando datos desde o hacia su dispositivo o hacia su dispositivoAWS Snowcone o desde su dispositivo o desde su dispositivo o
Tipo: objeto OnPremConfig
Obligatorio: sí
- ServerHostname
-
El nombre del servidor NFS. Este valor es la dirección IP o el nombre del Servicio de nombres de dominio (Domain Name Service, DNS) del servidor NFS. Un agente que está instalado en las instalaciones utiliza este nombre de host para montar el servidor de NFS en una red.
Si está copiando datos desde o hacia su dispositivo o hacia su dispositivo o desde suAWS Snowcone dispositivo o está copiando datos desde o hacia su dispositivo o hacia su dispositivoAWS Snowcone o desde su dispositivo o desde su dispositivo o
nota
Este nombre debe ser compatible con DNS o debe ser una dirección IP versión 4 (IPv4).
Tipo: String
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
-
Subdirectorio del sistema de archivos NFS que se utiliza para leer datos de la ubicación de origen NFS o escribir datos en el destino NFS. La ruta de NFS debe ser una ruta que exporta el servidor de NFS o un subdirectorio de dicha ruta. La ruta debe ser tal que permita el montaje por parte de otros clientes NFS de la red.
Para ver todas las rutas exportadas por el servidor de NFS, ejecute “
showmount -e nfs-server-name” desde un cliente de NFS con acceso al servidor. Puede especificar cualquier directorio que aparezca en los resultados y cualquier subdirectorio de dicho directorio. Asegúrese de que la exportación de NFS sea accesible sin la autenticación de Kerberos.Para transferir todos los datos de la carpeta que ha especificado, DataSync debe tener permisos para leer todos los datos. Para asegurarse, configure la exportación de NFS con
no_root_squash,o asegúrese de que los permisos para todos los archivos que desea queDataSync permita el acceso de lectura a todos los usuarios. Ambas opciones permiten que el agente lea los archivos. Para que el agente obtenga acceso a los directorios, también debe habilitar todos los accesos de ejecución.Si está copiando datos desde o hacia su dispositivo o hacia su dispositivo o desde suAWS Snowcone dispositivo o está copiando datos desde o hacia su dispositivo o hacia su dispositivoAWS Snowcone o desde su dispositivo o desde su dispositivo o
Para obtener información acerca de la configuración de exportación de NFS, consulte 18.7. El archivo de configuración /etc/exports
en la documentación de Red Hat Enterprise Linux. Tipo: String
Limitaciones de longitud: longitud máxima de 4096 caracteres.
Patrón:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$Obligatorio: sí
- 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
-
Nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos NFS 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 elAWS 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
Ejemplos
Ejemplo
El siguiente ejemplo crea un punto final para un sistema de archivos NFS utilizando la versión de NFS especificada como opción de montaje.
Solicitud de muestra
{
"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": "ElasticFileSystem-1"
}
]
}Ejemplo
La respuesta devuelve el nombre de recurso de Amazon (ARN) de la ubicación de NFS.
Respuesta de ejemplo
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}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:
