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.
CreateLocationSmb
Crea un punto final para un servidor de archivos de bloque de mensajes del servidor (SMB) al que AWS DataSync puede acceder para una transferencia. Para obtener más información, consulte Crear una ubicación SMB.
Sintaxis de la solicitud
{
"AgentArns": [ "string" ],
"Domain": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"User": "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
-
Especifica el DataSync agente (o agentes) que desea conectar al servidor de archivos SMB. Para especificar un agente, utilice su nombre de recurso de Amazon (ARN).
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 elemento. Número máximo de 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í
- Domain
-
Especifica el nombre de dominio de Windows al que pertenece el servidor de archivos SMB.
Para obtener más información, consulte required permissions (permisos requeridos) para ubicaciones de SMB.
Tipo: String
Limitaciones de longitud: longitud máxima de 253 caracteres.
Patrón:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Obligatorio: no
- MountOptions
-
Especifica la versión del protocolo SMB que se DataSync utiliza para acceder a su servidor de archivos SMB.
Tipo: objeto SmbMountOptions
Obligatorio: no
- Password
-
Especifica la contraseña del usuario que puede montar su servidor de archivos SMB y tiene permiso para acceder a archivos y carpetas en la ubicación y que tiene los permisos para obtener acceso a los archivos y carpetas de SMB.
Para obtener más información, consulte required permissions (permisos requeridos) para ubicaciones de SMB.
Tipo: String
Limitaciones de longitud: longitud máxima de 104 caracteres.
Patrón:
^.{0,104}$Obligatorio: sí
- ServerHostname
-
Especifica el nombre del servicio de nombres de dominio (DNS) o la dirección IP del servidor de archivos SMB que montará su DataSync agente.
nota
No puede especificar una dirección IP de versión 6 (IPv6).
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
-
Especifica el nombre del recurso compartido exportado por el servidor de archivos SMB donde DataSync se leerán o escribirán los datos. Puede incluir un subdirectorio en la ruta compartida (por ejemplo,
/path/to/subdirectory). Asegúrese de que otros clientes SMB de su red también puedan montar esta ruta.Para copiar todos los datos del subdirectorio especificado, DataSync debe poder montar el recurso compartido SMB y acceder a todos sus datos. Para obtener más información, consulte required permissions (permisos requeridos) para ubicaciones de SMB.
Tipo: String
Limitaciones de longitud: longitud máxima de 4096 caracteres.
Patrón:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obligatorio: sí
- 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 elementos. Número máximo de 50 elementos.
Obligatorio: no
- User
-
Especifica el nombre de usuario que puede montar el servidor de archivos SMB y tiene permiso para acceder a los archivos y carpetas involucrados en la transferencia.
Para obtener información sobre cómo elegir un usuario con el nivel de acceso adecuado para tu transferencia, consulta los permisos necesarios para las ubicaciones de pequeñas y medianas empresas.
Tipo: String
Limitaciones de longitud: longitud máxima de 104 caracteres.
Patrón:
^[^\x5B\x5D\\/:;|=,+*?]{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 SMB que ha creado.
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
Ejemplos
Solicitud de muestra
En el siguiente ejemplo, se crea una ubicación para un servidor de archivos SMB.
{ "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs", "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3" ], "Domain":"AMAZON", "MountOptions":{ "Version":"SMB3" }, "Password":"string", "ServerHostname":"MyServer.amazon.com", "Subdirectory":"share", "Tags":[ { "Key":"department", "Value":"finance" } ], "User":"user-1" }
Respuesta de ejemplo
Una respuesta devuelve el ARN de ubicación de su servidor de archivos SMB.
{ "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" }
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:
