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.
CreateLocationFsxWindows
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.
Sintaxis de la solicitud
{
"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
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.
- CmkSecretConfig
-
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
CreateLocationFsxWindowssolicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con laPasswordque 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. AWS KMS key
nota
Puede usar
CmkSecretConfig(conPassword) oCustomSecretConfig(sinPassword) para proporcionar credenciales para una solicitudCreateLocationFsxWindows. No proporcione ambos parámetros para la misma solicitud.Tipo: objeto CmkSecretConfig
Obligatorio: no
- CustomSecretConfig
-
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.
nota
Puede usar
CmkSecretConfig(conPassword) oCustomSecretConfig(sinPassword) para proporcionar credenciales para una solicitudCreateLocationFsxWindows. No proporcione ambos parámetros para la misma solicitud.Tipo: objeto CustomSecretConfig
Obligatorio: no
- Domain
-
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
-
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
-
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
-
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 Guía del usuario de Amazon FSx for 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-eusc|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 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
-
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 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 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
{
"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 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
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 uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
