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
<a name="API_DescribeLocationSmb"></a>

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
<a name="API_DescribeLocationSmb_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeLocationSmb_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
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-eusc|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
<a name="API_DescribeLocationSmb_ResponseSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "MountOptions": { 
      "Version": "string"
   },
   "User": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeLocationSmb_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
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 8 elementos.  
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}:agent/agent-[0-9a-z]{17}$` 

 ** [AuthenticationType](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AuthenticationType"></a>
El protocolo de autenticación que se DataSync utiliza para conectarse al servidor de archivos SMB.  
Tipo: cadena  
Valores válidos: `NTLM | KERBEROS` 

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un `Password` o `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una ubicación administrada por el cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
Es la hora en que se creó la ubicación SMB.  
Tipo: marca temporal

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
Describe la información de configuración de un secreto administrado por el cliente, como un `Password` o `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
Las IPv6 direcciones IPv4 o de los servidores DNS a los que pertenece el servidor de archivos SMB. Este elemento se aplica únicamente si `AuthenticationType` está configurado en `KERBEROS`.  
Tipo: 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 39.  
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}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 

 ** [Domain](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-Domain"></a>
El nombre del dominio de Windows al que pertenece el servidor de archivos SMB. Este elemento se aplica únicamente si `AuthenticationType` está configurado en `NTLM`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 253 caracteres.  
Patrón: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
La entidad principal de Kerberos que tiene permiso para acceder a los archivos, las carpetas y los metadatos de archivos en el 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](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
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-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationUri"></a>
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.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
Describe la información de configuración de un secreto DataSync administrado, como un `Password` o `KerberosKeytab` que se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets Manager  
Tipo: objeto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
La versión del protocolo SMB que se DataSync utiliza para acceder al servidor de archivos SMB.  
Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md)

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
El usuario que puede montar y acceder a los archivos, carpetas y metadatos del servidor de archivos de SMB. Este elemento se aplica únicamente si `AuthenticationType` está configurado en `NTLM`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 104 caracteres.  
Patrón: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Errores
<a name="API_DescribeLocationSmb_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** 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
<a name="API_DescribeLocationSmb_Examples"></a>

### Ejemplo
<a name="API_DescribeLocationSmb_Example_1"></a>

En este ejemplo se ilustra un uso de. DescribeLocationSmb

#### Solicitud de muestra
<a name="API_DescribeLocationSmb_Example_1_Request"></a>

```
{
  "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

### Ejemplo
<a name="API_DescribeLocationSmb_Example_2"></a>

Este ejemplo ilustra un uso de DescribeLocationSmb.

#### Respuesta de ejemplo
<a name="API_DescribeLocationSmb_Example_2_Response"></a>

```
{
   "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
<a name="API_DescribeLocationSmb_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb)