Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# DescribeLocationSmb
<a name="API_DescribeLocationSmb"></a>

Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für einen SMB-Dateiserver (Server Message Block).

## Anforderungssyntax
<a name="API_DescribeLocationSmb_RequestSyntax"></a>

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

## Anforderungsparameter
<a name="API_DescribeLocationSmb_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
Gibt den Amazon-Ressourcennamen (ARN) des SMB-Standorts an, über den Sie Informationen benötigen.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.  
Pattern: `^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}$`   
Erforderlich: Ja

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_DescribeLocationSmb_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
Die DataSync Agenten, ARNs die eine Verbindung zu Ihrem SMB-Dateiserver herstellen können.  
Typ: Zeichenfolgen-Array  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 8 Artikeln.  
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.  
Pattern: `^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>
Das Authentifizierungsprotokoll, das für die Verbindung mit Ihrem SMB-Dateiserver DataSync verwendet wird.  
Typ: Zeichenfolge  
Zulässige Werte: `NTLM | KERBEROS` 

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
Beschreibt die Konfigurationsinformationen für ein DataSync vom Kunden verwaltetes Geheimnis, wie z. B. ein `Password` oder`KerberosKeytab`, das für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird. AWS KMS key  
Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
Der Zeitpunkt, zu dem der SMB-Standort erstellt wurde.  
Typ: Zeitstempel

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
Beschreibt die Konfigurationsinformationen für ein vom Kunden verwaltetes Geheimnis, wie z. B. ein `Password` oder, `KerberosKeytab` das für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird, mit einer kundenverwalteten Rolle AWS Identity and Access Management (IAM), die den Zugriff auf den geheimen Schlüssel ermöglicht.  
Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
Die IPv4 oder IPv6 Adressen der DNS-Server, zu denen Ihr SMB-Dateiserver gehört. Dieses Element gilt nur, wenn `AuthenticationType` es auf `KERBEROS` gesetzt ist.  
Typ: Zeichenfolgen-Array  
Array-Mitglieder: Maximale Anzahl von 2 Elementen.  
Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Die maximale Länge beträgt 39.  
Pattern: `\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>
Der Name der Windows-Domäne, zu der der SMB-Dateiserver gehört. Dieses Element gilt nur, wenn `AuthenticationType` es auf `NTLM` gesetzt ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Die maximale Länge beträgt 253.  
Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
Der Kerberos-Prinzipal, der berechtigt ist, auf die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver zuzugreifen.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.  
Pattern: `^.+$` 

 ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
Der ARN des SMB-Standorts.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.  
Pattern: `^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>
Die URI des SMB-Standorts.  
Typ: Zeichenfolge  
Längenbeschränkungen: Die maximale Länge beträgt 4360.  
Pattern: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, wie z. B. ein `Password` oder, `KerberosKeytab` das für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird. DataSync verwendet den standardmäßigen AWS verwalteten KMS-Schlüssel, um dieses Geheimnis zu verschlüsseln. AWS Secrets Manager  
Typ: [ManagedSecretConfig](API_ManagedSecretConfig.md) Objekt

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
Die SMB-Protokollversion, die für den Zugriff auf Ihren SMB-Dateiserver DataSync verwendet wird.  
Typ: [SmbMountOptions](API_SmbMountOptions.md) Objekt

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
Der Benutzer, der die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver bereitstellen und darauf zugreifen kann. Dieses Element gilt nur, wenn `AuthenticationType` es auf `NTLM` gesetzt ist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Die maximale Länge beträgt 104.  
Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InternalException **   
Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Dienst ein Fehler auftritt.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet.  
HTTP-Statuscode: 400

## Beispiele
<a name="API_DescribeLocationSmb_Examples"></a>

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

Dieses Beispiel veranschaulicht eine Verwendung von. DescribeLocationSmb

#### Beispielanforderung
<a name="API_DescribeLocationSmb_Example_1_Request"></a>

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

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

Dieses Beispiel veranschaulicht eine Verwendung von DescribeLocationSmb.

#### Beispielantwort
<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"
}
```

## Weitere Informationen finden Sie unter:
<a name="API_DescribeLocationSmb_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb)