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.
DescribeLocationSmb
Devuelve metadatos, como, por ejemplo, la ruta y la información de usuario acerca de una ubicación de SMB.
Sintaxis de la solicitud
{
"LocationArn": "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.
- LocationArn
-
Nombre de recurso de Amazon (ARN) de la ubicación SMB que se va a describir.
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}$
Obligatorio: sí
Sintaxis de la respuesta
{
"AgentArns": [ "string" ],
"CreationTime": number,
"Domain": "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
-
Nombre de recurso de Amazon (ARN) de la ubicación del sistema de archivos SMB SMB de origen SMB SMB SMB de origen especificada.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 elemento. de 4
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}$
- CreationTime
-
La de SMB.
Tipo: Timestamp
- Domain
-
Nombre del dominio de Windows al que pertenece el servidor SMB.
Tipo: String
de
Patrón:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$
- LocationArn
-
Nombre de recurso de Amazon (ARN) de la ubicación SMB especificado.
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}$
- LocationUri
-
La dirección de la ubicación SMB de origen especificada.
Tipo: String
de
Patrón:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$
- MountOptions
-
Las deDataSync
Tipo: objeto SmbMountOptions
- User
-
El usuario que puede montar el recurso compartido y que tiene los permisos para obtener acceso a los archivos y carpetas de la ubicación de SMB.
Tipo: String
de
Patrón:
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$
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
Este ejemplo ilustra un uso deDescribeLocationSmb.
Solicitud de muestra
{
"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
Ejemplo
Este ejemplo ilustra un uso deDescribeLocationSmb.
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 un SDK de AWS de un lenguaje específico, consulte: