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.
Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un servidor de archivos de bloque de mensajes del servidor (SMB).
Sintaxis de la solicitud
{
"LocationArn": "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.
- LocationArn
-
Especifica el nombre de recurso de Amazon (ARN) de la ubicación de SMB sobre la que desea obtener información.
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}$Obligatorio: sí
Sintaxis de la respuesta
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"CreationTime": number,
"DnsIpAddresses": [ "string" ],
"Domain": "string",
"KerberosPrincipal": "string",
"LocationArn": "string",
"LocationUri": "string",
"MountOptions": {
"Version": "string"
},
"User": "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.
- AgentArns
-
Los ARNs DataSync agentes que se pueden conectar con el servidor de archivos SMB.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es 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}$ - AuthenticationType
-
El protocolo de autenticación que se DataSync utiliza para conectarse al servidor de archivos SMB.
Tipo: cadena
Valores válidos:
NTLM | KERBEROS - CreationTime
-
Es la hora en que se creó la ubicación SMB.
Tipo: marca temporal
- DnsIpAddresses
-
Las IPv4 direcciones de los servidores DNS a los que pertenece el servidor de archivos SMB. Este elemento solo se aplica si
AuthenticationTypeestá establecido en.KERBEROSTipo: matriz de cadenas
Miembros de la matriz: número máximo de 2 elementos.
Limitaciones de longitud: longitud mínima de 7. Longitud máxima de 15.
Patrón:
\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z - Domain
-
El nombre del dominio de Windows al que pertenece el servidor de archivos SMB. Este elemento solo se aplica si
AuthenticationTypeestá establecido en.NTLMTipo: cadena
Limitaciones de longitud: longitud máxima de 253 caracteres.
Patrón:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - KerberosPrincipal
-
El principal de Kerberos que tiene permiso para acceder a los archivos, las carpetas y los metadatos de los archivos del servidor de archivos SMB.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Patrón:
^.+$ - LocationArn
-
El ARN de la ubicación de SMB.
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}$ - LocationUri
-
El URI de la ubicación de SMB.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 4360 caracteres.
Patrón:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - MountOptions
-
La versión del protocolo SMB que se DataSync utiliza para acceder al servidor de archivos SMB.
Tipo: objeto SmbMountOptions
- User
-
El usuario que puede montar y acceder a los archivos, carpetas y metadatos del servidor de archivos de SMB. Este elemento solo se aplica si
AuthenticationTypeestá establecido en.NTLMTipo: cadena
Limitaciones de longitud: longitud máxima de 104 caracteres.
Patrón:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
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
Ejemplos
Ejemplo
Este ejemplo ilustra un uso de DescribeLocationSmb.
Solicitud de muestra
{
"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}Ejemplo
Este ejemplo ilustra un uso de DescribeLocationSmb.
Respuesta de ejemplo
{
"AgentArns":[
"arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
"arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
],
"CreationTime":"1532660733.39",
"Domain":"AMAZON",
"LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
"LocationUri":"smb://hostname.amazon.com/share",
"MountOptions":{
"Version":"SMB3"
},
"User":"user-1"
}
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:
