CreateLocationFsxWindows
Crea una ubicación de transferencia para un sistema de archivos Amazon FSx para Windows File Server. AWS DataSync puede usar esta ubicación como origen o destino para transferir datos.
Antes de comenzar, asegúrese de que entiende cómo DataSync accede a un servidor de archivos de FSx para Windows File Server.
Sintaxis de la solicitud
{
"Domain": "string",
"FsxFilesystemArn": "string",
"Password": "string",
"SecurityGroupArns": [ "string" ],
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"User": "string"
}Parámetros de la 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.
- Domain
-
Especifica el nombre del dominio de Windows al que pertenece el sistema de archivos de FSx para Windows File Server.
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
-
Especifica el nombre de recurso de Amazon (ARN) para el sistema de archivos de FSx para Windows File Server.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):fsx:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$Obligatorio: sí
- Password
-
Especifica la contraseña del usuario que tiene los permisos para montar y acceder a los archivos, carpetas y metadatos de los archivos en el sistema de archivos FSx para Windows File Server.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 104 caracteres.
Patrón:
^.{0,104}$Obligatorio: sí
- SecurityGroupArns
-
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 más información acerca de la configuración de grupos de seguridad para acceder al sistema de archivos, consulte la Guía de usuario de Amazon FSx para Windows File Server.
nota
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-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$Obligatorio: sí
-
- Subdirectory
-
Especifica una ruta de montaje para el sistema de archivos mediante barras inclinadas. Aquí es donde DataSync lee o escribe datos (en función 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
-
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
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.
Obligatorio: no
- User
-
Especifica el usuario que tiene los permisos para montar y acceder a los archivos, carpetas y metadatos de los archivos en el sistema de archivos FSx para Windows File Server.
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para la transferencia, consulte los permisos necesarios para las ubicaciones de FSx para Windows File Server.
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
{
"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 de la ubicación del sistema de archivos de FSx para Windows File.
Tipo: cadena
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 acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- 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
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
