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. # AWS DataSync API Zusätzlich zur AWS-Managementkonsole und AWS CLI können Sie die AWS DataSync API zur Konfiguration und Verwaltung DataSync mit dem verwenden [AWS SDKs](https://aws.amazon.com/developer/tools/). **Topics** + [Aktionen](API_Operations.md) + [Datentypen](API_Types.md) + [Häufige Fehler](CommonErrors.md) + [Geläufige Parameter](CommonParameters.md) # Aktionen Folgende Aktionen werden unterstützt: + [CancelTaskExecution](API_CancelTaskExecution.md) + [CreateAgent](API_CreateAgent.md) + [CreateLocationAzureBlob](API_CreateLocationAzureBlob.md) + [CreateLocationEfs](API_CreateLocationEfs.md) + [CreateLocationFsxLustre](API_CreateLocationFsxLustre.md) + [CreateLocationFsxOntap](API_CreateLocationFsxOntap.md) + [CreateLocationFsxOpenZfs](API_CreateLocationFsxOpenZfs.md) + [CreateLocationFsxWindows](API_CreateLocationFsxWindows.md) + [CreateLocationHdfs](API_CreateLocationHdfs.md) + [CreateLocationNfs](API_CreateLocationNfs.md) + [CreateLocationObjectStorage](API_CreateLocationObjectStorage.md) + [CreateLocationS3](API_CreateLocationS3.md) + [CreateLocationSmb](API_CreateLocationSmb.md) + [CreateTask](API_CreateTask.md) + [DeleteAgent](API_DeleteAgent.md) + [DeleteLocation](API_DeleteLocation.md) + [DeleteTask](API_DeleteTask.md) + [DescribeAgent](API_DescribeAgent.md) + [DescribeLocationAzureBlob](API_DescribeLocationAzureBlob.md) + [DescribeLocationEfs](API_DescribeLocationEfs.md) + [DescribeLocationFsxLustre](API_DescribeLocationFsxLustre.md) + [DescribeLocationFsxOntap](API_DescribeLocationFsxOntap.md) + [DescribeLocationFsxOpenZfs](API_DescribeLocationFsxOpenZfs.md) + [DescribeLocationFsxWindows](API_DescribeLocationFsxWindows.md) + [DescribeLocationHdfs](API_DescribeLocationHdfs.md) + [DescribeLocationNfs](API_DescribeLocationNfs.md) + [DescribeLocationObjectStorage](API_DescribeLocationObjectStorage.md) + [DescribeLocationS3](API_DescribeLocationS3.md) + [DescribeLocationSmb](API_DescribeLocationSmb.md) + [DescribeTask](API_DescribeTask.md) + [DescribeTaskExecution](API_DescribeTaskExecution.md) + [ListAgents](API_ListAgents.md) + [ListLocations](API_ListLocations.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ListTaskExecutions](API_ListTaskExecutions.md) + [ListTasks](API_ListTasks.md) + [StartTaskExecution](API_StartTaskExecution.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateAgent](API_UpdateAgent.md) + [UpdateLocationAzureBlob](API_UpdateLocationAzureBlob.md) + [UpdateLocationEfs](API_UpdateLocationEfs.md) + [UpdateLocationFsxLustre](API_UpdateLocationFsxLustre.md) + [UpdateLocationFsxOntap](API_UpdateLocationFsxOntap.md) + [UpdateLocationFsxOpenZfs](API_UpdateLocationFsxOpenZfs.md) + [UpdateLocationFsxWindows](API_UpdateLocationFsxWindows.md) + [UpdateLocationHdfs](API_UpdateLocationHdfs.md) + [UpdateLocationNfs](API_UpdateLocationNfs.md) + [UpdateLocationObjectStorage](API_UpdateLocationObjectStorage.md) + [UpdateLocationS3](API_UpdateLocationS3.md) + [UpdateLocationSmb](API_UpdateLocationSmb.md) + [UpdateTask](API_UpdateTask.md) + [UpdateTaskExecution](API_UpdateTaskExecution.md) # CancelTaskExecution Stoppt die Ausführung einer AWS DataSync Aufgabe, die gerade läuft. Die Übertragung einiger Dateien wird abrupt unterbrochen. Dateiinhalte, die an das Ziel übertragen werden, sind möglicherweise unvollständig oder stimmen nicht mit den Quelldateien überein. Wenn Sie jedoch eine neue Aufgabenausführung mit derselben Aufgabe starten und warten, bis sie abgeschlossen ist, ist der Dateiinhalt auf dem Ziel vollständig und konsistent. Dies gilt für andere unerwartete Fehler, die die Ausführung einer Aufgabe unterbrechen. In all diesen Fällen schließt die Übertragung DataSync erfolgreich ab, wenn Sie mit der nächsten Aufgabenausführung beginnen. ## Anforderungssyntax ``` { "TaskExecutionArn": "string" } ``` ## Anforderungsparameter 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. ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) der Aufgabenausführung, die gestoppt werden soll. 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) # CreateAgent Aktiviert einen AWS DataSync Agenten, den Sie in Ihrer Speicherumgebung bereitstellen. Der Aktivierungsprozess verknüpft den Agenten mit Ihrem AWS-Konto. Falls Sie noch keinen Agenten eingesetzt haben, finden Sie weitere Informationen unter [Benötige ich einen DataSync Agenten?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) ## Anforderungssyntax ``` { "ActivationKey": "string", "AgentName": "string", "SecurityGroupArns": [ "string" ], "SubnetArns": [ "string" ], "Tags": [ { "Key": "string", "Value": "string" } ], "VpcEndpointId": "string" } ``` ## Anforderungsparameter 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. ** [ActivationKey](#API_CreateAgent_RequestSyntax) ** Gibt den Aktivierungsschlüssel Ihres DataSync Agenten an. Wenn Sie keinen Aktivierungsschlüssel haben, finden Sie weitere Informationen unter [Aktivierung Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 29. Pattern: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}` Erforderlich: Ja ** [AgentName](#API_CreateAgent_RequestSyntax) ** Gibt einen Namen für Ihren Agenten an. Wir empfehlen, einen Namen anzugeben, an den Sie sich erinnern können. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Sicherheitsgruppe an, die den Datenverkehr zwischen Ihrem Agenten und dem VPC-Serviceendpunkt zulässt. Sie können nur einen ARN angeben. Typ: Zeichenfolgen-Array Array-Mitglieder: Feste Anzahl von 1 Element. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Nein ** [SubnetArns](#API_CreateAgent_RequestSyntax) ** Gibt den ARN des Subnetzes an, in dem sich Ihr VPC-Dienstendpunkt befindet. Sie können nur einen ARN angeben. Typ: Zeichenfolgen-Array Array-Mitglieder: Feste Anzahl von 1 Element. 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):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$` Erforderlich: Nein ** [Tags](#API_CreateAgent_RequestSyntax) ** Gibt Labels an, die Ihnen helfen, Ihre AWS Ressourcen zu kategorisieren, zu filtern und nach ihnen zu suchen. Wir empfehlen, mindestens ein Tag für Ihren Agenten zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) ** Gibt die ID des [VPC-Dienstendpunkts](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) an, den Sie verwenden. Eine VPC-Endpunkt-ID sieht beispielsweise so `vpce-01234d5aff67890e1` aus. Der von Ihnen verwendete VPC-Dienstendpunkt muss den DataSync Dienstnamen enthalten (z. B.`com.amazonaws.us-east-2.datasync`). Typ: Zeichenfolge Pattern: `^vpce-[0-9a-f]{17}$` Erforderlich: Nein ## Antwortsyntax ``` { "AgentArn": "string" } ``` ## Antwortelemente 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. ** [AgentArn](#API_CreateAgent_ResponseSyntax) ** Der ARN des Agenten, den Sie gerade aktiviert haben. Verwenden Sie den [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)Vorgang, um eine Liste der Agenten in Ihrem Land AWS-Konto zurückzugeben AWS-Region. 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}:agent/agent-[0-9a-z]{17}$` ## Fehler 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 ### Beispielanforderung Im folgenden Beispiel wird ein DataSync Agent aktiviert. ``` { "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE", "AgentName": "MyAgent", "Tags": [{ "Key": "Job", "Value": "TransferJob-1" }] } ``` ### Beispielantwort Die Antwort gibt den ARN des aktivierten Agenten zurück. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3" } ``` ## Weitere Informationen finden Sie unter: 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/CreateAgent) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent) # CreateLocationAzureBlob Erstellt einen *Übertragungsort* für einen Microsoft Azure Blob Storage-Container. AWS DataSync kann diesen Speicherort als Übertragungsquelle oder -ziel verwenden. Sie können Übertragungen mit oder ohne einen [DataSync Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) durchführen, der eine Verbindung zu Ihrem Container herstellt. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, [wie auf Azure Blob Storage DataSync zugegriffen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access) wird und wie mit [Zugriffsebenen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) und [Blobtypen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types) gearbeitet wird. ## Anforderungssyntax ``` { "AccessTier": "string", "AgentArns": [ "string" ], "AuthenticationType": "string", "BlobType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "ContainerUrl": "string", "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "SasConfiguration": { "Token": "string" }, "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt die Zugriffsebene an, in die Ihre Objekte oder Dateien übertragen werden sollen. Dies gilt nur, wenn der Standort als Übertragungsziel verwendet wird. Weitere Informationen finden Sie unter [Zugriffsebenen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Typ: Zeichenfolge Zulässige Werte: `HOT | COOL | ARCHIVE` Erforderlich: Nein ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) ** (Optional) Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten an, der eine Verbindung mit Ihrem Azure Blob Storage-Container herstellen kann. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben. Sie können mehr als einen Agenten angeben. Weitere Informationen finden Sie unter [Mehrere Agenten für Ihre Übertragung verwenden](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html). Stellen Sie sicher, dass Sie diesen Parameter korrekt konfigurieren, wenn Sie Ihren Speicherort zum ersten Mal erstellen. Nachdem Sie einen Speicherort erstellt haben, können Sie keine Agenten mehr hinzufügen oder daraus entfernen. 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}$` Erforderlich: Nein ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt die Authentifizierungsmethode an, die für den Zugriff auf Ihren Azure Blob Storage DataSync verwendet wird. DataSync kann mithilfe einer Shared Access Signature (SAS) auf Blob-Speicher zugreifen. Typ: Zeichenfolge Zulässige Werte: `SAS | NONE` Erforderlich: Ja ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt den Blobtyp an, den Ihre Objekte oder Dateien haben sollen, wenn sie in Azure Blob Storage übertragen werden. Unterstützt derzeit DataSync nur das Verschieben von Daten in Azure Blob Storage als Blockblobs. Weitere Informationen zu Blobtypen finden Sie in der [Azure Blob](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Storage-Dokumentation. Typ: Zeichenfolge Zulässige Werte: `BLOCK` Erforderlich: Nein ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom Kunden DataSync verwaltetes Geheimnis an, zu dem auch das Authentifizierungstoken gehört, das für den Zugriff auf einen bestimmten AzureBlob Speicherort DataSync verwendet wird. AWS KMS key Wenn Sie diesen Parameter als Teil einer `CreateLocationAzureBlob` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem Authentifizierungstoken, für das Sie angeben`SasConfiguration`, um ein DataSync verwaltetes Geheimnis zum Speichern der Standortzugriffsanmeldeinformationen zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit`SasConfiguration`) oder `CustomSecretConfig` (ohne`SasConfiguration`) verwenden, um Anmeldeinformationen für eine `CreateLocationAzureBlob` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt die URL des Azure Blob Storage-Containers an, der an Ihrer Übertragung beteiligt ist. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 325. Pattern: `^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$` Erforderlich: Ja ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten Secrets Manager Secret an, bei dem das Authentifizierungstoken für einen AzureBlob Speicherort im Klartext in Secrets Manager gespeichert wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`SasConfiguration`) oder `CustomSecretConfig` (ohne`SasConfiguration`) verwenden, um Anmeldeinformationen für eine `CreateLocationAzureBlob` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt die SAS-Konfiguration an, die DataSync den Zugriff auf Ihren Azure Blob Storage ermöglicht. Wenn Sie mithilfe von `CmkSecretConfig` oder ein Authentifizierungstoken bereitstellen`SasConfiguration`, aber keine geheimen Konfigurationsdetails angeben`CustomSecretConfig`, DataSync speichert das Token dann unter Verwendung des Secrets Managers Secret Ihres AWS Kontos. Typ: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) Objekt Erforderlich: Nein ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt Pfadsegmente an, wenn Sie Ihre Übertragung auf ein virtuelles Verzeichnis in Ihrem Container beschränken möchten (z. B.`/my/images`). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 1 024. Pattern: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) ** Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, mindestens ein Namensschild für Ihren Übertragungsort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) ** Der ARN des Azure Blob Storage-Übertragungsorts, den Sie erstellt haben. 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}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob) # CreateLocationEfs Erstellt einen *Übertragungsort* für ein Amazon EFS-Dateisystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie DataSync [auf Amazon EFS-Dateisysteme zugegriffen](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access) wird. ## Anforderungssyntax ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Access Points an, der zum Mounten Ihres Amazon EFS-Dateisystems DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugreifen auf eingeschränkte Dateisysteme](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). 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):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` Erforderlich: Nein ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** Gibt das Subnetz und die Sicherheitsgruppen an, die DataSync verwendet werden, um eine Verbindung zu einem der [Mount-Ziele](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) Ihres Amazon EFS-Dateisystems herzustellen. Typ: [Ec2Config](API_Ec2Config.md) Objekt Erforderlich: Ja ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Gibt den ARN für Ihr Amazon EFS-Dateisystem an. 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):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` Erforderlich: Ja ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** Gibt eine AWS Identity and Access Management (IAM-) Rolle an, die DataSync den Zugriff auf Ihr Amazon EFS-Dateisystem ermöglicht. Informationen zum Erstellen dieser Rolle finden Sie unter [Eine DataSync IAM-Rolle für den Dateisystemzugriff erstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Erforderlich: Nein ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** Gibt an, ob Sie DataSync die Transport Layer Security (TLS) 1.2-Verschlüsselung verwenden möchten, wenn Daten zu oder von Ihrem Amazon EFS-Dateisystem übertragen werden. Wenn Sie einen Zugriffspunkt mit `AccessPointArn` oder eine IAM-Rolle mit `FileSystemAccessRoleArn` angeben, müssen Sie diesen Parameter auf `TLS1_2` setzen. Typ: Zeichenfolge Zulässige Werte: `NONE | TLS1_2` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Gibt einen Mount-Pfad für Ihr Amazon-EFS-Dateisystem an. Hier werden Daten in Ihrem Dateisystem DataSync gelesen oder geschrieben (je nachdem, ob es sich um einen Quell- oder Zielspeicherort handelt). DataSync Verwendet standardmäßig das Stammverzeichnis (oder den [Zugriffspunkt](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html), falls Sie eines mit angeben`AccessPointArn`). Sie können Unterverzeichnisse auch mit Schrägstrichen einbeziehen (z. B.`/path/to/folder`). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** Gibt Schlüssel-Wert-Paar an, das für ein Tag steht, das Sie der Ressource hinzufügen möchten. Der Wert kann auch eine leere Zeichenfolge sein. Dieser Wert hilft Ihnen, Ressourcen zu verwalten, zu filtern und zu suchen. Wir empfehlen Ihnen, für Ihren Speicherort ein Namens-Tag anzulegen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des Amazon EFS-Dateisystemspeicherorts, den Sie erstellen. 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}$` ## Fehler 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 Service 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 ### Beispielanforderung Im folgenden Beispiel wird ein Speicherort für ein Amazon EFS-Dateisystem erstellt. ``` { "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Beispielanforderung: Erstellen eines Speicherorts für ein eingeschränktes Amazon EFS-Dateisystem Im folgenden Beispiel wird ein Speicherort für ein Amazon EFS-Dateisystem mit eingeschränktem Zugriff erstellt. In einem solchen Szenario müssen Sie möglicherweise Werte für `AccessPointArn``FileSystemAccessRoleArn`, und `InTransitEncryption` in Ihrer Anfrage angeben. ``` { "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Beispielantwort Eine Antwort gibt den Standort-ARN des Amazon EFS-Dateisystems zurück. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## Weitere Informationen finden Sie unter: 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/CreateLocationEfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs) # CreateLocationFsxLustre Erstellt einen *Übertragungsort* für ein Amazon FSx for Lustre-Dateisystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie DataSync [auf Lustre-Dateisysteme zugegriffen FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access) wird. ## Anforderungssyntax ``` { "FsxFilesystemArn": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des FSx for Lustre-Dateisystems an. 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):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` Erforderlich: Ja ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) ** Gibt die Amazon-Ressourcennamen (ARNs) von bis zu fünf Sicherheitsgruppen an, die den Zugriff auf Ihr FSx for Lustre-Dateisystem ermöglichen. Die Sicherheitsgruppen müssen auf die Ports des Dateisystems zugreifen können. Das Dateisystem muss auch den Zugriff von den Sicherheitsgruppen aus ermöglichen. Informationen zum Dateisystemzugriff finden Sie im [https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html). Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationFsxLustre_RequestSyntax) ** Gibt einen Bereitstellungspfad für Ihr FSx for Lustre-Dateisystem an. Der Pfad kann Unterverzeichnisse enthalten. Wenn der Speicherort als Quelle verwendet wird, DataSync liest Daten aus dem Mount-Pfad. Wenn der Speicherort als Ziel verwendet wird, werden Daten in den Bereitstellungspfad DataSync geschrieben. Wenn Sie diesen Parameter nicht angeben, DataSync verwendet das Stammverzeichnis des Dateisystems (`/`). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ** [Tags](#API_CreateLocationFsxLustre_RequestSyntax) ** Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationFsxLustre_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des FSx for Lustre-Dateisystemspeicherorts, den Sie erstellt haben. 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}$` ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) # CreateLocationFsxOntap Erstellt einen *Übertragungsort* für ein Amazon FSx for NetApp ONTAP-Dateisystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie [auf ONTAP-Dateisysteme DataSync zugegriffen FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access) wird. ## Anforderungssyntax ``` { "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "StorageVirtualMachineArn": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) ** Gibt das Datenübertragungsprotokoll an, das für den Zugriff auf Ihr FSx Amazon-Dateisystem AWS DataSync verwendet wird. Typ: [FsxProtocol](API_FsxProtocol.md) Objekt Erforderlich: Ja ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) ** Gibt die Amazon EC2-Sicherheitsgruppen an, die den Zugriff auf das bevorzugte Subnetz Ihres Dateisystems ermöglichen. Die Sicherheitsgruppen müssen ausgehenden Datenverkehr an den folgenden Ports zulassen (abhängig vom verwendeten Protokoll): + **Netzwerk-Dateisystem (NFS)**: TCP-Ports 111, 635 und 2 049 + **Server Message Block (SMB)**: TCP-Port 445 Die Sicherheitsgruppen Ihres Dateisystems müssen auch eingehenden Datenverkehr über dieselben Ports zulassen. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Ja ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) ** Gibt den ARN der Storage Virtual Machine (SVM, virtuelle Speichermaschine) in Ihrem Dateisystem an, in die Sie Daten kopieren wollen. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 162. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) ** Gibt den Pfad zur Dateifreigabe auf der SVM an, zu der oder von der Sie Daten übertragen möchten. Sie können einen Knotenpfad (auch als Mount-Punkt bezeichnet), einen Qtree-Pfad (für NFS-Dateifreigaben) oder einen Share-Namen (für SMB-Dateifreigaben) angeben. Ihr Mount-Pfad könnte zum Beispiel `/vol1`, `/vol1/tree1` oder `/share1` sein. Geben Sie keinen Verbindungspfad im Stammvolume der SVM an. Weitere Informationen finden Sie unter [Verwaltung FSx virtueller ONTAP-Speichermaschinen](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) im *Amazon FSx for NetApp ONTAP-Benutzerhandbuch*. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` Erforderlich: Nein ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) ** Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) ** Gibt den ARN des Speicherorts FSx für das Dateisystem für ONTAP an, den Sie erstellen. 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}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) # CreateLocationFsxOpenZfs Erstellt einen *Übertragungsort* für ein Amazon FSx for OpenZFS-Dateisystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie DataSync [Zugriffe auf FSx OpenZFS-Dateisysteme funktionieren](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access). **Anmerkung** Anforderungsparameter, die sich auf beziehen, `SMB` werden von dem Vorgang nicht unterstützt. `CreateLocationFsxOpenZfs` ## Anforderungssyntax ``` { "FsxFilesystemArn": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des FSx Dateisystems für OpenZFS. 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):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` Erforderlich: Ja ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Der Protokolltyp, der für den Zugriff auf Ihr Dateisystem AWS DataSync verwendet wird. Typ: [FsxProtocol](API_FsxProtocol.md) Objekt Erforderlich: Ja ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Die Sicherheitsgruppen, die zur Konfiguration ARNs des Dateisystems FSx für OpenZFS verwendet werden. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Ein Unterverzeichnis im Pfad des Speicherorts, das mit beginnen muss. `/fsx` DataSync verwendet dieses Unterverzeichnis zum Lesen oder Schreiben von Daten (je nachdem, ob es sich bei dem Dateisystem um einen Quell- oder Zielspeicherort handelt). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$` Erforderlich: Nein ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** Das Schlüssel-Wert-Paar, das für ein Tag steht, das Sie der Ressource hinzufügen möchten. Der Wert kann auch eine leere Zeichenfolge sein. Dieser Wert hilft Ihnen, Ressourcen zu verwalten, zu filtern und zu suchen. Wir empfehlen Ihnen, für Ihren Speicherort ein Namens-Tag anzulegen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationFsxOpenZfs_ResponseSyntax) ** Der ARN des Speicherorts FSx für das OpenZFS-Dateisystem, den Sie erstellt haben. 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}$` ## Fehler 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 Dienst ein Fehler auftritt. AWS DataSync HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) # CreateLocationFsxWindows Erstellt einen *Übertragungsort* für ein Dateisystem von Amazon FSx für Windows File Server. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie DataSync [Zugriffe auf FSx Windows File Server-Dateisysteme funktionieren](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access). ## Anforderungssyntax ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "FsxFilesystemArn": "string", "Password": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" } ``` ## Anforderungsparameter 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. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom DataSync Kunden verwaltetes Geheimnis an, zu dem auch das Kennwort gehört, das für den Zugriff auf einen bestimmten FSx Windows-Speicherort DataSync verwendet wird. AWS KMS key Wenn Sie diesen Parameter als Teil einer `CreateLocationFsxWindows` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem, für den `Password` Sie angegeben haben, um ein DataSync verwaltetes Geheimnis zum Speichern der Standortzugriffsanmeldeinformationen zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit`Password`) oder `CustomSecretConfig` (ohne`Password`) verwenden, um Anmeldeinformationen für eine `CreateLocationFsxWindows` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten Secrets Manager-Schlüssel an, bei dem das Passwort FSx für einen Windows-Dateiserver-Speicherort im Klartext in Secrets Manager gespeichert wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`Password`) oder `CustomSecretConfig` (ohne`Password`) verwenden, um Anmeldeinformationen für eine `CreateLocationFsxWindows` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt den Namen der Windows-Domäne an, zu der das Dateisystem FSx für Windows File Server gehört. Wenn Sie mehrere Active Directory-Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen Dateisystem hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Erforderlich: Nein ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) für das Dateisystem FSx für Windows File Server an. 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):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` Erforderlich: Ja ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt das Passwort des Benutzers an, der berechtigt ist, die Dateien, Ordner und Dateimetadaten in Ihrem Dateisystem FSx für Windows File Server bereitzustellen und darauf zuzugreifen. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt die ARNs der Amazon EC2-Sicherheitsgruppen an, die den Zugriff auf das bevorzugte Subnetz Ihres Dateisystems ermöglichen. Die von Ihnen angegebenen Sicherheitsgruppen müssen in der Lage sein, mit den Sicherheitsgruppen Ihres Dateisystems zu kommunizieren. Informationen zur Konfiguration von Sicherheitsgruppen für den Dateisystemzugriff finden Sie im [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html). Wenn Sie eine Sicherheitsgruppe wählen, die keine internen Verbindungen zulässt, gehen Sie wie folgt vor: + Konfigurieren Sie die Sicherheitsgruppe so, dass sie mit sich selbst kommunizieren kann. + Wählen Sie eine andere Sicherheitsgruppe, die mit der Sicherheitsgruppe des Mount-Ziels kommunizieren kann. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt einen Mount-Pfad für Ihr Dateisystem mithilfe von Schrägstrichen an. Hier werden Daten DataSync gelesen oder geschrieben (je nachdem, ob es sich um einen Quell- oder Zielort handelt). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** Gibt den Benutzer an, der berechtigt ist, die Dateien, Ordner und Dateimetadaten in Ihrem Dateisystem FSx für Windows File Server bereitzustellen und darauf zuzugreifen. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [Erforderliche Berechtigungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx für Windows-Dateiserverstandorte. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Ja ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) ** Der ARN des Dateisystemspeicherorts FSx für Windows File Server, den Sie erstellt haben. 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}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows) # CreateLocationHdfs Erstellt einen *Übertragungsort* für ein Hadoop Distributed File System (HDFS). AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie auf DataSync [HDFS-Cluster zugegriffen](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs) wird. ## Anforderungssyntax ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) ** Die Amazon-Ressourcennamen (ARNs) der DataSync Agenten, die eine Verbindung zu Ihrem HDFS-Cluster 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}$` Erforderlich: Ja ** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) ** Die Art der Authentifizierung, die verwendet wird, um die Identität des Benutzers zu ermitteln. Typ: Zeichenfolge Zulässige Werte: `SIMPLE | KERBEROS` Erforderlich: Ja ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) ** Die Größe der Datenblöcke, die in den HDFS-Cluster geschrieben werden sollen. Die Blockgröße muss ein Vielfaches von 512 Bytes sein. Die standardmäßige Blockgröße ist 128 Mebibyte (MiB). Typ: Ganzzahl Gültiger Bereich: Mindestwert von 1048576. Der Höchstwert ist 1073741824. Erforderlich: Nein ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, zu dem auch die Kerberos-Keytab gehört, die für den Zugriff auf einen bestimmten Hadoop Distributed File System (HDFS) -Speicherort DataSync verwendet wird, mit einem vom Kunden verwalteten Speicherort. AWS KMS key Wenn Sie diesen Parameter als Teil einer `CreateLocationHdfs` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem, für den `KerberosKeytab` Sie angegeben haben, um ein DataSync verwaltetes Geheimnis zum Speichern der Standortzugriffsanmeldeinformationen zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit`KerberosKeytab`) oder `CustomSecretConfig` (ohne`KerberosKeytab`) verwenden, um Anmeldeinformationen für eine `CreateLocationHdfs` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten Secrets Manager-Secret an, bei dem die Kerberos-Keytab für den HDFS-Speicherort binär in Secrets Manager gespeichert ist. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`KerberosKeytab`) oder `CustomSecretConfig` (ohne`KerberosKeytab`) verwenden, um Anmeldeinformationen für eine `CreateLocationHdfs` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) ** Die Kerberos-Schlüsseltabelle (keytab), die Zuweisungen zwischen dem definierten Kerberos-Prinzipal und den verschlüsselten Schlüsseln enthält. Sie können den Keytab aus einer Datei laden, indem Sie die Adresse der Datei angeben. Dieser Parameter ist erforderlich, wenn `KERBEROS` für `AuthenticationType` festgelegt ist. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 65536. Erforderlich: Nein ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) ** Die `krb5.conf`-Datei, die die Kerberos-Konfigurationsinformationen enthält. Sie können die `krb5.conf` Datei laden, indem Sie die Adresse der Datei angeben. Wenn Sie das verwenden AWS CLI, führt es die Base64-Kodierung für Sie durch. Andernfalls geben Sie den Base64-codierten Text an. Dieser Parameter ist erforderlich, wenn `KERBEROS` für `AuthenticationType` festgelegt ist. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 131072. Erforderlich: Nein ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) ** Das Kerberos-Prinzipal mit Zugriff auf die Dateien und Ordner im HDFS-Cluster. Dieser Parameter ist erforderlich, wenn `KERBEROS` für `AuthenticationType` festgelegt ist. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^.+$` Erforderlich: Nein ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) ** Die URI des Key Management Servers (KMS) des HDFS-Clusters. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` Erforderlich: Nein ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) ** Der NameNode , der den HDFS-Namespace verwaltet. Der NameNode führt Operationen wie das Öffnen, Schließen und Umbenennen von Dateien und Verzeichnissen aus. Das NameNode enthält die Informationen zum Zuordnen von Datenblöcken zu. DataNodes Sie können nur einen verwenden NameNode. Typ: Array von [HdfsNameNode](API_HdfsNameNode.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Erforderlich: Ja ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) ** Die Konfiguration der Quality of Protection (QOP, Schutzqualität) legt den Remote Procedure Call (RPC) und die Datenschutzeinstellungen für die Datenübertragung fest, die auf dem Hadoop Distributed File System (HDFS)-Cluster konfiguriert sind. Wenn `QopConfiguration` nicht angegeben ist, ist `PRIVACY` der Standardwert für `RpcProtection` und `DataTransferProtection`. Wenn Sie `RpcProtection` oder `DataTransferProtection` festlegen, nimmt der andere Parameter den gleichen Wert an. Typ: [QopConfiguration](API_QopConfiguration.md) Objekt Erforderlich: Nein ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) ** Die Nummer DataNodes , auf die die Daten repliziert werden sollen, wenn in den HDFS-Cluster geschrieben wird. Standardmäßig werden Daten auf drei repliziert. DataNodes Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Maximalwert ist 512. Erforderlich: Nein ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) ** Der zur Identifizierung des Clients auf dem Host-Betriebssystem verwendete Benutzername. Dieser Parameter ist erforderlich, wenn `SIMPLE` für `AuthenticationType` festgelegt ist. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) ** Ein Unterverzeichnis im HDFS-Cluster. Dieses Unterverzeichnis wird verwendet, um Daten vom HDFS-Cluster zu lesen oder zu schreiben. Wenn das Unterverzeichnis nicht angegeben ist, ist es standardmäßig `/`. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ** [Tags](#API_CreateLocationHdfs_RequestSyntax) ** Das Schlüssel-Wert-Paar, das für das Tag steht, das Sie dem Speicherort hinzufügen möchten. Der Wert kann auch eine leere Zeichenfolge sein. Wir empfehlen, zum Benennen Ihrer Ressourcen Tags zu verwenden. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) ** Der ARN des Quell-HDFS-Cluster-Speicherorts, den Sie erstellen. 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}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) # CreateLocationNfs Erstellt einen *Übertragungsort* für einen NFS-Dateiserver (Network File System). AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie auf [NFS-Dateiserver DataSync zugegriffen](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs) wird. ## Anforderungssyntax ``` { "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) ** Gibt die Optionen an, die zum Mounten Ihres NFS-Dateiservers verwendet werden DataSync können. Typ: [NfsMountOptions](API_NfsMountOptions.md) Objekt Erforderlich: Nein ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten an, der eine Verbindung zu Ihrem NFS-Dateiserver herstellen kann. Sie können mehr als einen Agenten angeben. Weitere Informationen finden Sie unter [Mehrere DataSync Agenten verwenden](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents). Typ: [OnPremConfig](API_OnPremConfig.md) Objekt Erforderlich: Ja ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) ** Gibt den DNS-Namen oder die IP-Adresse (IPv4 oder IPv6) des NFS-Dateiservers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) ** Gibt den Exportpfad auf Ihrem NFS-Dateiserver an, den Sie mounten DataSync möchten. Dieser Pfad (oder ein Unterverzeichnis des Pfads) ist der Ort, an den Daten DataSync übertragen werden oder von diesem Pfad. Informationen zur Konfiguration eines Exports für DataSync finden Sie unter [Zugreifen auf NFS-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]+$` Erforderlich: Ja ** [Tags](#API_CreateLocationNfs_RequestSyntax) ** Gibt Beschriftungen an, die Ihnen helfen, Ihre Ressourcen zu kategorisieren, zu filtern und nach ihnen zu AWS suchen. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) ** Der ARN des Übertragungsorts, den Sie für Ihren NFS-Dateiserver erstellt haben. 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}$` ## Fehler 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 ### Beispiel Im folgenden Beispiel wird ein DataSync Übertragungsort für einen NFS-Dateiserver erstellt. #### Beispielanforderung ``` { "MountOptions": { "Version": : "NFS4_0" }, "OnPremConfig": { "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ] }, "ServerHostname": "MyServer@amazon.com", "Subdirectory": "/MyFolder", "Tags": [ { "Key": "Name", "Value": "FileSystem-1" } ] } ``` ### Beispiel Die Antwort gibt den ARN des NFS-Standorts zurück. #### Beispielantwort ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" } ``` ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs) # CreateLocationObjectStorage Erzeugt einen *Übertragungsort* für ein Objektspeichersystem. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Sie können Übertragungen mit oder ohne einen [DataSyncAgenten durchführen](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required). Bevor Sie beginnen, stellen Sie sicher, dass Sie die [Voraussetzungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) für DataSync die Arbeit mit Objektspeichersystemen verstehen. ## Anforderungssyntax ``` { "AccessKey": "string", "AgentArns": [ "string" ], "BucketName": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Zugriffsschlüssel (z. B. einen Benutzernamen) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` Erforderlich: Nein ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) ** (Optional) Gibt die Amazon-Ressourcennamen (ARNs) der DataSync Agenten an, die eine Verbindung zu Ihrem Objektspeichersystem herstellen können. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben. Stellen Sie sicher, dass Sie diesen Parameter korrekt konfigurieren, wenn Sie Ihren Speicherort zum ersten Mal erstellen. Nachdem Sie einen Speicherort erstellt haben, können Sie keine Agenten mehr hinzufügen oder daraus entfernen. 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}$` Erforderlich: Nein ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Namen des Objektspeicher-Buckets an, der an der Übertragung beteiligt ist. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 63 Zeichen. Pattern: `^[a-zA-Z0-9_\-\+\.\$\p{Zs}]+$` Erforderlich: Ja ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt die Konfigurationsinformationen für ein vom Kunden DataSync AWS KMS key verwaltetes Geheimnis an, zu dem auch der Schlüssel gehört`SecretKey`, der für den Zugriff auf einen bestimmten Objektspeicherort DataSync verwendet wird. Wenn Sie diesen Parameter als Teil einer `CreateLocationObjectStorage` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem Wert, den Sie für den `SecretKey` Parameter angeben, um ein DataSync verwaltetes Geheimnis zum Speichern der Anmeldeinformationen für den Standortzugriff zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit`SecretKey`) oder `CustomSecretConfig` (ohne`SecretKey`) verwenden, um Anmeldeinformationen für eine `CreateLocationObjectStorage` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Secrets Manager-Geheimnis an, bei dem der geheime Schlüssel für einen bestimmten Objektspeicherort im Klartext in Secrets Manager gespeichert wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`SecretKey`) oder `CustomSecretConfig` (ohne`SecretKey`) verwenden, um Anmeldeinformationen für eine `CreateLocationObjectStorage` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den geheimen Schlüssel (z. B. ein Passwort) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind. Wenn Sie mithilfe von `CmkSecretConfig` oder ein Geheimnis angeben`SecretKey`, aber keine geheimen Konfigurationsdetails angeben`CustomSecretConfig`, DataSync speichert das Token unter Verwendung des Secrets Manager Manager-Geheimnisses Ihres AWS Kontos. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` Erforderlich: Nein ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt eine Zertifikatskette für DataSync die Authentifizierung bei Ihrem Objektspeichersystem an, falls das System eine private oder selbstsignierte Zertifizierungsstelle (CA) verwendet. Sie müssen eine einzelne `.pem` Datei mit einer vollständigen Zertifikatskette angeben (z. B.`file:///home/user/.ssh/object_storage_certificates.pem`). Die Zertifikatskette könnte Folgendes beinhalten: + Das Zertifikat des Objektspeichersystems + Alle Zwischenzertifikate (falls vorhanden) + Das Stammzertifikat der signierenden Zertifizierungsstelle Sie können Ihre Zertifikate zu einer `.pem` Datei zusammenfügen (die vor der Base64-Kodierung bis zu 32768 Byte groß sein kann). Mit dem folgenden `cat` Beispielbefehl wird eine `object_storage_certificates.pem` Datei erstellt, die drei Zertifikate enthält: `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` Um diesen Parameter zu verwenden, konfigurieren Sie `ServerProtocol` auf`HTTPS`. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 32768. Erforderlich: Nein ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Domainnamen oder die IP-Adresse (IPv4 oder IPv6) des Object Storage-Servers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Erforderlich: Ja ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt den Port an, an dem Ihr Objektspeicher-Server eingehenden Netzwerkverkehr annimmt (z. B. Port 443). Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Höchstwert ist 65536. Erforderlich: Nein ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt das Protokoll an, das Ihr Objektspeicher-Server für die Kommunikation verwendet. Wenn nichts angegeben ist, lautet der Standardwert `HTTPS`. Typ: Zeichenfolge Zulässige Werte: `HTTPS | HTTP` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt das Objekt-Präfix für Ihren Objektspeicher-Server an. Wenn es sich um einen Quellspeicherort handelt, werden DataSync nur Objekte mit diesem Präfix kopiert. Wenn es sich um einen Zielort handelt, werden alle Objekte mit diesem Präfix DataSync geschrieben. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) ** Gibt Schlüssel-Wert-Paar an, das für ein Tag steht, das Sie der Ressource hinzufügen möchten. Mithilfe von Tags können Sie Ihre Ressourcen verwalten, filtern und suchen. Wir empfehlen, ein Namensschild für Ihren Standort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) ** Gibt den ARN des Objekt-Storage-Systemspeicherorts an, den Sie erstellen. 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}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) # CreateLocationS3 Erstellt einen *Übertragungsort* für einen Amazon S3 S3-Bucket. AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. **Wichtig** Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Themen gelesen haben: [Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Bewertung der Kosten für S3-Anfragen bei der Verwendung DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) Weitere Informationen finden Sie unter [Konfiguration von Übertragungen mit Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html). ## Anforderungssyntax ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Nur Amazon S3 bei Outposts) Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten in Ihrem Outpost an. Weitere Informationen finden Sie unter [Bereitstellen Ihres DataSync Agenten auf](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). AWS Outposts 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}$` Erforderlich: Nein ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** Gibt den ARN des S3-Buckets an, den Sie als Speicherort verwenden möchten. (Wenn Sie Ihre DataSync Aufgabe später erstellen, geben Sie an, ob es sich bei diesem Speicherort um eine Übertragungsquelle oder ein Übertragungsziel handelt.) Wenn sich Ihr S3-Bucket auf einer AWS Outposts Ressource befindet, müssen Sie einen Amazon S3 S3-Zugriffspunkt angeben. Weitere Informationen finden Sie unter [Verwaltung des Datenzugriffs mit Amazon S3 S3-Zugriffspunkten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) im *Amazon S3 S3-Benutzerhandbuch*. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 268. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` Erforderlich: Ja ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der AWS Identity and Access Management (IAM) -Rolle an, die für den Zugriff auf Ihren S3-Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [ DataSync Zugriff auf S3-Buckets bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Typ: [S3Config](API_S3Config.md) Objekt Erforderlich: Ja ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** Gibt die Speicherklasse an, die Ihre Objekte verwenden sollen, wenn Amazon S3 ein Übertragungsziel ist. Für Buckets in ist AWS-Regionen die Speicherklasse standardmäßig auf eingestellt. `STANDARD` Bei aktivierten Buckets ist AWS Outposts die Speicherklasse standardmäßig auf. `OUTPOSTS` Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Typ: Zeichenfolge Zulässige Werte: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Erforderlich: Nein ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** Gibt ein Präfix im S3-Bucket an, das DataSync Lese- oder Schreibvorgänge vornimmt (je nachdem, ob es sich bei dem Bucket um einen Quell- oder Zielspeicherort handelt). DataSync kann keine Objekte mit einem Präfix übertragen, das mit einem Schrägstrich (`/`) beginnt oder `/../` Muster einschließt`//`. `/./` Beispiel: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ** [Tags](#API_CreateLocationS3_RequestSyntax) ** Gibt Beschriftungen an, die Ihnen helfen, Ihre Ressourcen zu kategorisieren, zu filtern und nach ihnen zu AWS suchen. Wir empfehlen, mindestens ein Namensschild für Ihren Transferort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) ** Der ARN des S3-Standorts, den Sie erstellt haben. 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}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) # CreateLocationSmb Erstellt einen *Übertragungsort* für einen SMB-Dateiserver (Server Message Block). AWS DataSync kann diesen Speicherort als Quelle oder Ziel für die Übertragung von Daten verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie auf SMB-Dateiserver DataSync zugegriffen wird. Weitere Informationen finden Sie unter [Bereitstellen des DataSync Zugriffs auf SMB-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). ## Anforderungssyntax ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" } ``` ## Anforderungsparameter 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. ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) ** Gibt den DataSync Agenten (oder die Agenten) an, der eine Verbindung zu Ihrem SMB-Dateiserver herstellen kann. Sie geben einen Agenten anhand seines Amazon-Ressourcennamens (ARN) an. 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}$` Erforderlich: Ja ** [AuthenticationType](#API_CreateLocationSmb_RequestSyntax) ** Gibt das Authentifizierungsprotokoll an, das für die Verbindung mit Ihrem SMB-Dateiserver DataSync verwendet wird. DataSync unterstützt `NTLM` (Standard) und `KERBEROS` Authentifizierung. Weitere Informationen finden Sie unter [Bereitstellen des DataSync Zugriffs auf SMB-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Typ: Zeichenfolge Zulässige Werte: `NTLM | KERBEROS` Erforderlich: Nein ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, entweder ein `Password` oder `KerberosKeytab` (für `NTLM` (Standard-) bzw. `KERBEROS` Authentifizierungstypen), das für den Zugriff auf einen bestimmten SMB-Speicherort mit einem vom Kunden verwalteten SMB-Speicherort DataSync verwendet wird. AWS KMS key Wenn Sie diesen Parameter als Teil einer `CreateLocationSmbRequest` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem `Password` oder, den `KerberosKeytab` Sie angeben, um ein DataSync verwaltetes Geheimnis zum Speichern der Standortzugriffsanmeldeinformationen zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit entweder `Password` oder`KerberosKeytab`) oder `CustomSecretConfig` (ohne `Password` und`KerberosKeytab`) verwenden, um Anmeldeinformationen für eine `CreateLocationSmbRequest` Anfrage anzugeben. Geben Sie nicht `CmkSecretConfig` sowohl als auch `CustomSecretConfig` Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten Secrets Manager Secret an, bei dem die Anmeldeinformationen für den SMB-Speicherort in Secrets Manager als Klartext (für`Password`) oder binär (für`KerberosKeytab`) gespeichert werden. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`SasConfiguration`) oder `CustomSecretConfig` (ohne`SasConfiguration`) verwenden, um Anmeldeinformationen für eine `CreateLocationSmbRequest` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) ** Gibt die IPv6 Adressen IPv4 oder für die DNS-Server an, zu denen Ihr SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf `KERBEROS` gesetzt `AuthenticationType` ist. Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen SMB-Dateiserver hergestellt wird. 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` Erforderlich: Nein ** [Domain](#API_CreateLocationSmb_RequestSyntax) ** Gibt den Windows-Domain-Namen an, zu dem SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf gesetzt `AuthenticationType` ist`NTLM`. Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen Dateiserver hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Erforderlich: Nein ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) ** Gibt Ihre Kerberos-Schlüsseltabellendatei (Keytab) an, die Zuordnungen zwischen Ihrem Kerberos-Prinzipal und den Verschlüsselungsschlüsseln enthält. Um Fehler bei der Ausführung von Aufgaben zu vermeiden, stellen Sie sicher, dass der Kerberos-Prinzipal, den Sie zum Erstellen der Keytab-Datei verwenden, genau dem entspricht, wofür Sie es angegeben haben. `KerberosPrincipal` Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 65536. Erforderlich: Nein ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) ** Gibt eine Kerberos-Konfigurationsdatei (`krb5.conf`) an, die Ihre Kerberos-Realm-Konfiguration definiert. Die Datei muss base64-codiert sein. Wenn Sie das verwenden AWS CLI, ist die Kodierung für Sie erledigt. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 131072. Erforderlich: Nein ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) ** Gibt einen Kerberos-Prinzipal an. Dabei handelt es sich um eine Identität in Ihrem Kerberos-Bereich, die berechtigt ist, auf die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver zuzugreifen. Ein Kerberos-Prinzipal könnte wie folgt aussehen. `HOST/kerberosuser@MYDOMAIN.ORG` Bei Prinzipalnamen wird Groß- und Kleinschreibung beachtet. Ihre DataSync Aufgabenausführung schlägt fehl, wenn der Prinzipal, den Sie für diesen Parameter angeben, nicht exakt dem Prinzipal entspricht, den Sie zum Erstellen der Keytab-Datei verwenden. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^.+$` Erforderlich: Nein ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) ** Gibt die Version des SMB-Protokolls an, das für den Zugriff auf Ihren SMB-Dateiserver DataSync verwendet wird. Typ: [SmbMountOptions](API_SmbMountOptions.md) Objekt Erforderlich: Nein ** [Password](#API_CreateLocationSmb_RequestSyntax) ** Gibt das Kennwort des Benutzers an, der Ihren SMB-Dateiserver bereitstellen kann und über Zugriffsrechte auf die Dateien und Ordner verfügt, die an Ihrer Übertragung beteiligt sind. Dieser Parameter gilt nur, wenn er auf `NTLM` gesetzt `AuthenticationType` ist. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) ** Gibt den Domänennamen oder die IP-Adresse (IPv4 oder IPv6) des SMB-Dateiservers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. Wenn Sie die Kerberos-Authentifizierung verwenden, müssen Sie einen Domänennamen angeben. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Erforderlich: Ja ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) ** Gibt den Namen der von Ihrem SMB-Dateiserver exportierten Freigabe an, auf der Daten gelesen oder geschrieben DataSync werden. Sie können ein Unterverzeichnis in den Freigabepfad aufnehmen (z. B.`/path/to/subdirectory`). Stellen Sie sicher, dass andere SMB-Clients in Ihrem Netzwerk diesen Pfad ebenfalls bereitstellen können. Um alle Daten im Unterverzeichnis zu kopieren, DataSync müssen Sie in der Lage sein, die SMB-Freigabe zu mounten und auf alle zugehörigen Daten zuzugreifen. Weitere Informationen finden Sie unter [ DataSync Zugriff auf SMB-Dateiserver bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Ja ** [Tags](#API_CreateLocationSmb_RequestSyntax) ** Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ** [User](#API_CreateLocationSmb_RequestSyntax) ** Gibt den Benutzer an, der die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver bereitstellen und darauf zugreifen kann. Dieser Parameter gilt nur, wenn er auf `NTLM` gesetzt `AuthenticationType` ist. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [ DataSync Zugriff auf SMB-Dateiserver bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Nein ## Antwortsyntax ``` { "LocationArn": "string" } ``` ## Antwortelemente 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. ** [LocationArn](#API_CreateLocationSmb_ResponseSyntax) ** Der ARN des SMB-Standorts, den Sie erstellt haben. 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}$` ## Fehler 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 ### Beispielanforderung Im folgenden Beispiel wird ein Speicherort für einen SMB-Dateiserver erstellt. ``` { "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" } ``` ### Beispielantwort Eine Antwort gibt den Standort-ARN Ihres SMB-Dateiservers zurück. ``` { "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb) # CreateTask Konfiguriert eine *Aufgabe*, die definiert, wo und wie Ihre Daten AWS DataSync übertragen werden. Eine Aufgabe umfasst einen Quellstandort, einen Zielort und Übertragungsoptionen (wie Bandbreitenbeschränkungen, Planung und mehr). **Wichtig** Wenn Sie planen, Daten zu oder von einem Amazon S3 S3-Standort zu übertragen, lesen Sie zunächst, [wie sich dies auf Ihre S3-Anforderungsgebühren auswirken DataSync kann](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests), sowie auf der [DataSync Preisseite](https://aws.amazon.com/datasync/pricing/). ## Anforderungssyntax ``` { "CloudWatchLogGroupArn": "string", "DestinationLocationArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "SourceLocationArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Anforderungsparameter 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. ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) einer CloudWatch Amazon-Protokollgruppe zur Überwachung Ihrer Aufgabe an. Für Aufgaben im erweiterten Modus müssen Sie nichts angeben. DataSyncsendet automatisch Protokolle an eine CloudWatch Protokollgruppe mit dem Namen`/aws/datasync`. Weitere Informationen finden Sie unter [Überwachen von Datenübertragungen mit CloudWatch Protokollen](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 562. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Erforderlich: Nein ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Gibt den ARN des Zielorts Ihrer Übertragung an. 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 ** [Excludes](#API_CreateTask_RequestSyntax) ** Gibt Ausschlussfilter an, die die Dateien, Objekte und Ordner an Ihrem Quellspeicherort definieren, die Sie nicht übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [Includes](#API_CreateTask_RequestSyntax) ** Gibt Inklusivfilter an, die die Dateien, Objekte und Ordner an Ihrem Quellspeicherort definieren, die Sie übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** Konfiguriert ein Manifest, bei dem es sich um eine Liste von Dateien oder Objekten handelt, die Sie übertragen DataSync möchten. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Mithilfe eines Manifests angeben, was DataSync übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) soll. Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die Rolle, DataSync mit der Sie ihn verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Erlaubnis. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt Erforderlich: Nein ** [Name](#API_CreateTask_RequestSyntax) ** Gibt den Namen Ihrer Aufgabe an. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ** [Options](#API_CreateTask_RequestSyntax) ** Gibt die Einstellungen Ihrer Aufgabe an, z. B. die Beibehaltung von Dateimetadaten, die Überprüfung der Datenintegrität und andere Optionen. Typ: [Options](API_Options.md) Objekt Erforderlich: Nein ** [Schedule](#API_CreateTask_RequestSyntax) ** Gibt einen Zeitplan an, zu dem Ihre Aufgabe ausgeführt werden soll. Weitere Informationen finden Sie unter [Aufgabenplanung](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Typ: [TaskSchedule](API_TaskSchedule.md) Objekt Erforderlich: Nein ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Gibt den ARN des Quellorts Ihrer Übertragung an. 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 ** [Tags](#API_CreateTask_RequestSyntax) ** Gibt die Tags an, die Sie auf Ihre Aufgabe anwenden möchten. *Stichwörter* sind Schlüssel-Wert-Paare, die Ihnen helfen, Ihre DataSync Ressourcen zu verwalten, zu filtern und nach ihnen zu suchen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ** [TaskMode](#API_CreateTask_RequestSyntax) ** Gibt einen der folgenden Aufgabenmodi für Ihre Datenübertragung an: + `ENHANCED`- Übertragen Sie eine praktisch unbegrenzte Anzahl von Objekten mit höherer Leistung als im Basismodus. Aufgaben im erweiterten Modus optimieren den Datenübertragungsprozess, indem sie Daten parallel auflisten, vorbereiten, übertragen und verifizieren. Der erweiterte Modus ist derzeit für Übertragungen zwischen Amazon S3-Standorten, Übertragungen zwischen Azure Blob und Amazon S3 ohne Agenten und Übertragungen zwischen anderen Clouds und Amazon S3 ohne Agenten verfügbar. **Anmerkung** Um eine Aufgabe im erweiterten Modus zu erstellen, muss die IAM-Rolle, mit der Sie den `CreateTask` Vorgang aufrufen, über die entsprechende Berechtigung verfügen. `iam:CreateServiceLinkedRole` + `BASIC`(Standard) — Übertragen Sie Dateien oder Objekte zwischen dem AWS Speicher und allen anderen unterstützten DataSync Speicherorten. Für Aufgaben im Basismodus gelten [Kontingente](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) für die Anzahl der Dateien, Objekte und Verzeichnisse in einem Datensatz. Im Basismodus werden Daten sequenziell vorbereitet, übertragen und überprüft, sodass er für die meisten Workloads langsamer ist als der erweiterte Modus. Weitere Informationen finden Sie unter [Grundlegendes zu Unterschieden im Aufgabenmodus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` Erforderlich: Nein ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** Gibt an, wie Sie einen Aufgabenbericht konfigurieren möchten, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Überwachen Ihrer DataSync Übertragungen mit Aufgabenberichten](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die Rolle, DataSync mit der Sie ihn verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Erlaubnis. Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt Erforderlich: Nein ## Antwortsyntax ``` { "TaskArn": "string" } ``` ## Antwortelemente 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. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) der Aufgabe. 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}:task/task-[0-9a-f]{17}$` ## Fehler 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 ### Beispielanforderung für eine Aufgabe im erweiterten Modus Im folgenden Beispiel wird eine DataSync Aufgabe erstellt, die den erweiterten Modus verwendet. Anders als bei der Erstellung von Aufgaben im Basismodus müssen Sie keine CloudWatch Amazon-Protokollgruppe angeben. Bei Aufgaben im erweiterten Modus werden Aufgabenprotokolle DataSync automatisch an eine Protokollgruppe mit dem Namen gesendet`/aws/datasync`. Wenn diese Protokollgruppe in Ihrer nicht vorhanden ist AWS-Region, DataSync erstellt die Protokollgruppe in Ihrem Namen, wenn Sie die Aufgabe erstellen. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2", "Name": "My Enhanced mode task", "TaskMode": "ENHANCED", "Options": { "TransferMode": "CHANGED", "VerifyMode": "ONLY_FILES_TRANSFERRED", "ObjectTags": "PRESERVE", "LogLevel": "TRANSFER" } } ``` ### Beispielanforderung für eine Aufgabe im Basismodus Im folgenden Beispiel wird eine DataSync Aufgabe erstellt, die den Basismodus verwendet. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "Name": "My Basic mode task", "TaskMode": "BASIC", "Options": { "Atime": "BEST_EFFORT", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "ONLY_FILES_TRANSFERRED" }, "Schedule": { "ScheduleExpression": "0 12 ? * SUN,WED *" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*", "Tags": [ { "Key": "Name", "Value": "Migration-wave-1" } ] } ``` ### Beispielantwort Die folgende Antwort enthält den ARN einer erstellten Aufgabe. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## Weitere Informationen finden Sie unter: 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/CreateTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask) # DeleteAgent Entfernt eine AWS DataSync Agentenressource von Ihrer AWS-Konto. Beachten Sie, dass durch diesen Vorgang (der nicht rückgängig gemacht werden kann) die virtuelle Maschine (VM) oder die Amazon EC2 EC2-Instanz des Agenten nicht aus Ihrer Speicherumgebung entfernt wird. Für die nächsten Schritte können Sie die VM oder Instanz aus Ihrer Speicherumgebung löschen oder sie wiederverwenden, um [einen neuen Agenten zu aktivieren](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html). ## Anforderungssyntax ``` { "AgentArn": "string" } ``` ## Anforderungsparameter 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. ** [AgentArn](#API_DeleteAgent_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des zu löschenden Agenten. Verwenden Sie den `ListAgents` Vorgang, um eine Liste von Agenten für Ihr Konto und zurückzugeben AWS-Region. 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}:agent/agent-[0-9a-z]{17}$` Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteAgent) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) # DeleteLocation Löscht eine Transferstandortressource von AWS DataSync. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DeleteLocation_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des Speicherorts, der gelöscht werden soll. 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 ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteLocation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) # DeleteTask Löscht eine Transferaufgabenressource von AWS DataSync. ## Anforderungssyntax ``` { "TaskArn": "string" } ``` ## Anforderungsparameter 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. ** [TaskArn](#API_DeleteTask_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Aufgabe an, die Sie löschen möchten. 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}:task/task-[0-9a-f]{17}$` Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DeleteTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) # DescribeAgent Gibt Informationen über einen AWS DataSync Agenten zurück, z. B. seinen Namen, seinen Dienstendpunkttyp und seinen Status. ## Anforderungssyntax ``` { "AgentArn": "string" } ``` ## Anforderungsparameter 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. ** [AgentArn](#API_DescribeAgent_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten 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}:agent/agent-[0-9a-z]{17}$` Erforderlich: Ja ## Antwortsyntax ``` { "AgentArn": "string", "CreationTime": number, "EndpointType": "string", "LastConnectionTime": number, "Name": "string", "Platform": { "Version": "string" }, "PrivateLinkConfig": { "PrivateLinkEndpoint": "string", "SecurityGroupArns": [ "string" ], "SubnetArns": [ "string" ], "VpcEndpointId": "string" }, "Status": "string" } ``` ## Antwortelemente 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. ** [AgentArn](#API_DescribeAgent_ResponseSyntax) ** Der ARN des Kundendienstmitarbeiters. 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}:agent/agent-[0-9a-z]{17}$` ** [CreationTime](#API_DescribeAgent_ResponseSyntax) ** Der Zeitpunkt, zu dem der Agent [aktiviert](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html) wurde. Typ: Zeitstempel ** [EndpointType](#API_DescribeAgent_ResponseSyntax) ** Der Typ des [Dienstendpunkts](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html), mit dem Ihr Agent verbunden ist. Typ: Zeichenfolge Zulässige Werte: `PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK` ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) ** Das letzte Mal, dass der Agent mit dem DataSync Service kommuniziert hat. Typ: Zeitstempel ** [Name](#API_DescribeAgent_ResponseSyntax) ** Der Name des Agenten. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` ** [Platform](#API_DescribeAgent_ResponseSyntax) ** Die plattformbezogenen Details über den Agenten, wie z. B. die Versionsnummer. Typ: [Platform](API_Platform.md) Objekt ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) ** Die Netzwerkkonfiguration, die der Agent verwendet, wenn er eine Verbindung zu einem [VPC-Dienstendpunkt](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc) herstellt. Typ: [PrivateLinkConfig](API_PrivateLinkConfig.md) Objekt ** [Status](#API_DescribeAgent_ResponseSyntax) ** Der Status des Agenten. + Wenn der Status lautet`ONLINE`, ist der Agent ordnungsgemäß konfiguriert und einsatzbereit. + Wenn der Status lautet`OFFLINE`, hat der Agent seit mindestens fünf DataSync Minuten keinen Kontakt mehr zu Ihnen aufgenommen. Dies kann verschiedene Gründe haben. Weitere Informationen finden Sie unter [Was mache ich, wenn mein Agent offline ist?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) Typ: Zeichenfolge Zulässige Werte: `ONLINE | OFFLINE` ## Fehler 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 ### Beispielanforderung Das folgende Beispiel gibt Informationen über einen in einer Anfrage angegebenen Agenten zurück. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0" } ``` ### Beispielantwort Die folgende Beispielantwort beschreibt einen Agenten, der einen öffentlichen Dienstendpunkt verwendet. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0", "Name": "Data center migration agent", "Status": "ONLINE", "LastConnectionTime": "2022-10-17T17:21:35.540000+00:00", "CreationTime": "2022-10-05T20:52:29.499000+00:00", "EndpointType": "PUBLIC", "Platform": { "Version": "2" } } ``` ## Weitere Informationen finden Sie unter: 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/DescribeAgent) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeAgent) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeAgent) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeAgent) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeAgent) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeAgent) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeAgent) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeAgent) # DescribeLocationAzureBlob Enthält Details zur Konfiguration eines AWS DataSync Übertragungsorts für Microsoft Azure Blob Storage. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationAzureBlob_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) Ihres Azure Blob Storage-Übertragungsorts an. 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 ``` { "AccessTier": "string", "AgentArns": [ "string" ], "AuthenticationType": "string", "BlobType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" } } ``` ## Antwortelemente 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. ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Die Zugriffsebene, in die Ihre Objekte oder Dateien übertragen werden sollen. Dies gilt nur, wenn Sie den Standort als Übertragungsziel verwenden. Weitere Informationen finden Sie unter [Zugriffsebenen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Typ: Zeichenfolge Zulässige Werte: `HOT | COOL | ARCHIVE` ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Die ARNs DataSync Agents, die eine Verbindung mit Ihrem Azure Blob Storage-Container 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_DescribeLocationAzureBlob_ResponseSyntax) ** Die Authentifizierungsmethode, die für den Zugriff auf Ihren Azure Blob Storage DataSync verwendet wird. DataSync kann mithilfe einer Shared Access Signature (SAS) auf den Blob-Speicher zugreifen. Typ: Zeichenfolge Zulässige Werte: `SAS | NONE` ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Der Blobtyp, den Ihre Objekte oder Dateien haben sollen, wenn sie in Azure Blob Storage übertragen werden. Unterstützt derzeit DataSync nur das Verschieben von Daten in Azure Blob Storage als Blockblobs. Weitere Informationen zu Blobtypen finden Sie in der [Azure Blob](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Storage-Dokumentation. Typ: Zeichenfolge Zulässige Werte: `BLOCK` ** [CmkSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein vom Kunden DataSync verwaltetes Geheimnis, z. B. ein Authentifizierungstoken, das für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird, wobei ein vom Kunden verwalteter Schlüssel verwendet wird. AWS KMS key Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Der Zeitpunkt, zu dem Ihr Azure Blob Storage-Übertragungsort erstellt wurde. Typ: Zeitstempel ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein vom Kunden verwaltetes Geheimnis, z. B. ein Authentifizierungstoken, 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 das Geheimnis ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Der ARN Ihres Azure Blob Storage-Übertragungsorts. 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_DescribeLocationAzureBlob_ResponseSyntax) ** Die URL des Azure Blob Storage-Containers, der an Ihrer Übertragung beteiligt ist. 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_DescribeLocationAzureBlob_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, z. B. ein Authentifizierungstoken, 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 ## Fehler 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 Dienst ein Fehler auftritt. AWS DataSync HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) # DescribeLocationEfs Enthält Details darüber, wie ein AWS DataSync Übertragungsort für ein Amazon EFS-Dateisystem konfiguriert ist. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationEfs_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des Amazon EFS-Dateisystemspeicherorts, ü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 ``` { "AccessPointArn": "string", "CreationTime": number, "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "LocationUri": "string" } ``` ## Antwortelemente 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. ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) ** Der ARN des Access Points, der für den Zugriff auf das Amazon EFS-Dateisystem DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugreifen auf eingeschränkte Dateisysteme](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). 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):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) ** Der Zeitpunkt, zu dem der Standort erstellt wurde. Typ: Zeitstempel ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) ** Das Subnetz und die Sicherheitsgruppen, die für die Verbindung zu einem der [Mount-Ziele](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) Ihres Amazon EFS-Dateisystems AWS DataSync verwendet werden. Typ: [Ec2Config](API_Ec2Config.md) Objekt ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) ** Die AWS Identity and Access Management (IAM) -Rolle, die DataSync den Zugriff auf Ihr Amazon EFS-Dateisystem ermöglicht. Weitere Informationen finden Sie unter [Erstellen einer DataSync IAM-Rolle für den Dateisystemzugriff](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) ** Gibt an, ob bei der Übertragung von Daten zum oder vom Amazon EFS-Dateisystem die Transport Layer Security (TLS) -Verschlüsselung DataSync verwendet wird. Typ: Zeichenfolge Zulässige Werte: `NONE | TLS1_2` ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) ** Der ARN des Speicherorts des Amazon EFS-Dateisystems. 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_DescribeLocationEfs_ResponseSyntax) ** Die URL des Speicherorts des Amazon EFS-Dateisystems. 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.:/\-]+$` ## Fehler 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 ### Beispielanforderung Das folgende Beispiel zeigt, wie Sie Informationen über einen bestimmten Speicherort im Amazon EFS-Dateisystem abrufen können. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ### Beispielantwort Das folgende Beispiel gibt Standortdetails zu einem Amazon EFS-Dateisystem zurück. ``` { "CreationTime": 1653319021.353, "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/" } ``` ### Beispielantwort: Beschreibung eines Speicherorts für ein eingeschränktes Amazon EFS-Dateisystem Das folgende Beispiel gibt Standortdetails zu einem Amazon EFS-Dateisystem mit eingeschränktem Zugriff zurück`AccessPointArn`, einschließlich der `InTransitEncryption` Elemente`FileSystemAccessRoleArn`, und. ``` { "CreationTime": 1653319021.353, "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ## Weitere Informationen finden Sie unter: 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/DescribeLocationEfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs) # DescribeLocationFsxLustre Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für ein Amazon FSx for Lustre-Dateisystem. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationFsxLustre_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des zu FSx beschreibenden for Lustre-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}$` Erforderlich: Ja ## Antwortsyntax ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "SecurityGroupArns": [ "string" ] } ``` ## Antwortelemente 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. ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) ** Der Zeitpunkt, zu dem der Standort FSx für Lustre erstellt wurde. Typ: Zeitstempel ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des beschriebenen FSx For Lustre-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_DescribeLocationFsxLustre_ResponseSyntax) ** Der URI des FSx for Lustre-Standorts, der beschrieben wurde. 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.:/\-]+$` ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) ** Die Amazon-Ressourcennamen (ARNs) der Sicherheitsgruppen, die für das FSx for Lustre-Dateisystem konfiguriert sind. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) # DescribeLocationFsxOntap Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für ein Amazon FSx for NetApp ONTAP-Dateisystem. **Anmerkung** Wenn Ihr Standort SMB verwendet, gibt der `DescribeLocationFsxOntap` Vorgang nicht wirklich a zurück. `Password` ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationFsxOntap_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Speicherorts FSx für das ONTAP-Dateisystem 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 ``` { "CreationTime": number, "FsxFilesystemArn": "string", "LocationArn": "string", "LocationUri": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "StorageVirtualMachineArn": "string" } ``` ## Antwortelemente 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. ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Die Uhrzeit, zu der der Standort erstellt wurde. Typ: Zeitstempel ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Der ARN des FSx for ONTAP-Dateisystems. 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):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` ** [LocationArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Der ARN des Speicherorts FSx für das ONTAP-Dateisystem. 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_DescribeLocationFsxOntap_ResponseSyntax) ** Der Uniform Resource Identifier (URI) des Speicherorts FSx für das ONTAP-Dateisystem. 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.:/\-]+$` ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Gibt das Datenübertragungsprotokoll an, das für den Zugriff auf Ihr FSx Amazon-Dateisystem AWS DataSync verwendet wird. Typ: [FsxProtocol](API_FsxProtocol.md) Objekt ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Die Sicherheitsgruppen, die FSx für den Zugriff auf Ihr ONTAP-Dateisystem DataSync verwendet werden. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` ** [StorageVirtualMachineArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** Der ARN der virtuellen Speichermaschine (SVM) auf Ihrem FSx ONTAP-Dateisystem, zu dem Sie Daten kopieren oder von der Sie Daten kopieren. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 162. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) # DescribeLocationFsxOpenZfs Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für ein Amazon FSx for OpenZFS-Dateisystem. **Anmerkung** Antwortelemente, die sich auf beziehen, werden von dem `DescribeLocationFsxOpenZfs` Vorgang `SMB` nicht unterstützt. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationFsxOpenZfs_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des zu FSx beschreibenden OpenZFS-Speicherorts. 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 ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ] } ``` ## Antwortelemente 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. ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Der Zeitpunkt, zu dem der Speicherort FSx für OpenZFS erstellt wurde. Typ: Zeitstempel ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Der ARN des FSx für OpenZFS beschriebenen Speicherorts. 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_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Der Uniform Resource Identifier (URI) des FSx für OpenZFS beschriebenen Speicherorts. Beispiel: `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder` 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.:/\-]+$` ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Der Protokolltyp, der für den Zugriff auf Ihr Dateisystem AWS DataSync verwendet wird. Typ: [FsxProtocol](API_FsxProtocol.md) Objekt ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** Die ARNs Sicherheitsgruppen, die FSx für das OpenZFS-Dateisystem konfiguriert sind. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` ## Fehler 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 Dienst ein Fehler auftritt. AWS DataSync HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) # DescribeLocationFsxWindows Enthält Einzelheiten darüber, wie ein AWS DataSync Übertragungsort für ein Amazon FSx for Windows File Server-Dateisystem konfiguriert ist. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationFsxWindows_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Speicherorts FSx für den Windows-Dateiserver an. 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 ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "SecurityGroupArns": [ "string" ], "User": "string" } ``` ## Antwortelemente 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. ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein vom Kunden DataSync verwaltetes Geheimnis, z. B. ein, `Password` das für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird, und für das ein Kunde AWS KMS key verwaltet wird. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Der Zeitpunkt, zu dem der Speicherort FSx für den Windows-Dateiserver erstellt wurde. Typ: Zeitstempel ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel, z. B. einen`Password`, der 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 ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Der Name der Microsoft Active Directory-Domäne, zu der das Dateisystem FSx für Windows File Server gehört. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` ** [LocationArn](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Der ARN des Speicherorts FSx für den Windows-Dateiserver. 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_DescribeLocationFsxWindows_ResponseSyntax) ** Der Uniform Resource Identifier (URI) des Speicherorts FSx für den Windows-Dateiserver. 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_DescribeLocationFsxWindows_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, z. B. ein, `Password` 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 ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Die ARNs der Amazon EC2-Sicherheitsgruppen, die den Zugriff auf das bevorzugte Subnetz Ihres Dateisystems ermöglichen. Informationen zur Konfiguration von Sicherheitsgruppen für den Dateisystemzugriff finden Sie im [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html). Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` ** [User](#API_DescribeLocationFsxWindows_ResponseSyntax) ** Der Benutzer mit den Berechtigungen zum Mounten und Zugreifen auf das Dateisystem FSx für Windows File Server. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) # DescribeLocationHdfs Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für ein Hadoop Distributed File System (HDFS). ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationHdfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des HDFS-Speicherorts an. 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 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string" } ``` ## Antwortelemente 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_DescribeLocationHdfs_ResponseSyntax) ** Der ARNs der DataSync Agenten, die eine Verbindung zu Ihrem HDFS-Cluster herstellen können. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 8 Elementen. 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_DescribeLocationHdfs_ResponseSyntax) ** Die Art der Authentifizierung, die verwendet wird, um die Identität des Benutzers zu ermitteln. Typ: Zeichenfolge Zulässige Werte: `SIMPLE | KERBEROS` ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) ** Die Größe der Datenblöcke, die in den HDFS-Cluster geschrieben werden sollen. Typ: Ganzzahl Gültiger Bereich: Mindestwert von 1048576. Der Höchstwert ist 1073741824. ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein vom Kunden DataSync verwaltetes Geheimnis, z. B. ein, `KerberosKeytab` das für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird, wobei ein vom Kunden verwalteter Schlüssel verwendet wird. AWS KMS key Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) ** Der Zeitpunkt, zu dem der HDFS-Speicherort erstellt wurde. Typ: Zeitstempel ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel, z. B. einen`KerberosKeytab`, der 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 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) ** Das Kerberos-Prinzipal mit Zugriff auf die Dateien und Ordner im HDFS-Cluster. Dieser Parameter wird verwendet, wenn der definiert `AuthenticationType` ist als. `KERBEROS` Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^.+$` ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) ** Die URI des Key Management Servers (KMS) des HDFS-Clusters. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` ** [LocationArn](#API_DescribeLocationHdfs_ResponseSyntax) ** Der ARN des HDFS-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_DescribeLocationHdfs_ResponseSyntax) ** Der URI des HDFS-Speicherorts. 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_DescribeLocationHdfs_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, z. B. ein, `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 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) ** Der NameNode , der den HDFS-Namespace verwaltet. Typ: Array von [HdfsNameNode](API_HdfsNameNode.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) ** Die QOP-Konfiguration (Quality of Protection), die die auf dem HDFS-Cluster konfigurierten Einstellungen für den Remote Procedure Call (RPC) und den Schutz der Datenübertragung festlegt. Typ: [QopConfiguration](API_QopConfiguration.md) Objekt ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) ** Die Nummer DataNodes , auf die die Daten repliziert werden sollen, wenn in den HDFS-Cluster geschrieben wird. Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Maximalwert ist 512. ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) ** Der Benutzername zur Identifizierung des Clients auf dem Host-Betriebssystem. Dieser Parameter wird verwendet, wenn der definiert `AuthenticationType` ist als`SIMPLE`. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) # DescribeLocationNfs Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für einen NFS-Dateiserver (Network File System). ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationNfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des NFS-Speicherorts 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 ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] } } ``` ## Antwortelemente 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. ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) ** Die Uhrzeit, zu der der NFS-Standort erstellt wurde. Typ: Zeitstempel ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) ** Der ARN des NFS-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_DescribeLocationNfs_ResponseSyntax) ** Die URI des NFS-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.:/\-]+$` ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) ** Die Mount-Optionen, die zum Mounten Ihres NFS-Dateiservers DataSync verwendet werden. Typ: [NfsMountOptions](API_NfsMountOptions.md) Objekt ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) ** Die AWS DataSync Agenten, die eine Verbindung zu Ihrem NFS-Dateiserver (Network File System) herstellen können. Typ: [OnPremConfig](API_OnPremConfig.md) Objekt ## Fehler 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 ### Beispiel Das folgende Beispiel gibt Informationen über den in der Beispielanforderung angegebenen NFS-Speicherort zurück. #### Beispielanforderung ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" } ``` ### Beispiel Dieses Beispiel veranschaulicht eine Verwendung von. DescribeLocationNfs #### Beispielantwort ``` { "CreationTime": 1532660733.39, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa", "LocationUri": "hostname.amazon.com", "OnPremConfig": { "AgentArns": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ] } } ``` ## Weitere Informationen finden Sie unter: 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/DescribeLocationNfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationNfs) # DescribeLocationObjectStorage Enthält Details zur Konfiguration eines AWS DataSync Übertragungsorts für ein Objektspeichersystem. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationObjectStorage_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Objektspeichersystems an. 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 ``` { "AccessKey": "string", "AgentArns": [ "string" ], "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "ServerCertificate": blob, "ServerPort": number, "ServerProtocol": "string" } ``` ## Antwortelemente 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. ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Der Zugriffsschlüssel (z. B. ein Benutzername), der für die Authentifizierung beim Objektspeichersystem erforderlich ist. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Der ARNs der DataSync Agenten, die eine Verbindung zu Ihrem Objektspeichersystem 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}$` ** [CmkSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, das für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet wird, und für einen vom Kunden AWS KMS key verwalteten Schlüssel. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Der Zeitpunkt, zu dem der Standort erstellt wurde. Typ: Zeitstempel ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf den geheimen Schlüssel ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Der ARN des Objekt-Storage-Systemstandorts. 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_DescribeLocationObjectStorage_ResponseSyntax) ** Die URI des Speicherorts des Objektspeichersystems. 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_DescribeLocationObjectStorage_ResponseSyntax) ** Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, wie z. B. ein Authentifizierungstoken oder eine Reihe von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden. 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 ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Die Zertifikatskette für DataSync die Authentifizierung bei Ihrem Objektspeichersystem, wenn das System eine private oder selbstsignierte Zertifizierungsstelle (CA) verwendet. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 32768. ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Der Port, über den Ihr Object Storage-Server eingehenden Netzwerkverkehr akzeptiert (z. B. Port 443). Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Maximalwert ist 65536. ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) ** Das Protokoll, das Ihr Objektspeichersystem für die Kommunikation verwendet. Typ: Zeichenfolge Zulässige Werte: `HTTPS | HTTP` ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) # DescribeLocationS3 Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für einen S3-Bucket. ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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_DescribeLocationS3_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Amazon S3-Standorts an. 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 ``` { "AgentArns": [ "string" ], "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string" } ``` ## Antwortelemente 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_DescribeLocationS3_ResponseSyntax) ** Die ARNs DataSync Agenten, die auf Ihrem Outpost eingesetzt wurden, wenn Sie mit Amazon S3 auf Outposts arbeiten. Weitere Informationen finden Sie unter [Bereitstellen Ihres DataSync Agenten auf](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). AWS Outposts 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}$` ** [CreationTime](#API_DescribeLocationS3_ResponseSyntax) ** Der Zeitpunkt, zu dem der Amazon S3 S3-Standort erstellt wurde. Typ: Zeitstempel ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) ** Der ARN des Amazon S3 S3-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_DescribeLocationS3_ResponseSyntax) ** Die URL des Amazon S3 S3-Standorts, der beschrieben wurde. 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.:/\-]+$` ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der AWS Identity and Access Management (IAM) -Rolle an, die für den Zugriff auf Ihren S3-Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [ DataSync Zugriff auf S3-Buckets bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Typ: [S3Config](API_S3Config.md) Objekt ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) ** Wenn Amazon S3 ein Zielort ist, ist dies die Speicherklasse, die Sie für Ihre Objekte ausgewählt haben. Einige Speicherklassen weisen Verhaltensweisen auf, die sich auf Ihre Amazon S3 S3-Speicherkosten auswirken können. Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Typ: Zeichenfolge Zulässige Werte: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` ## Fehler 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 Service 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 ### Beispiel Das folgende Beispiel gibt Informationen über den Amazon S3 S3-Standort zurück, der in der Beispielanforderung angegeben wurde. #### Beispielanforderung ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3" } ``` ### Beispiel Dieses Beispiel veranschaulicht eine Verwendung von DescribeLocation S3. #### Beispielantwort ``` { "CreationTime": 1532660733.39, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3", "LocationUri": "s3://amzn-s3-demo-bucket", "S3Config": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role", } "S3StorageClass": "STANDARD" } ``` ## Weitere Informationen finden Sie unter: 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/DescribeLocationS3) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3) # DescribeLocationSmb Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für einen SMB-Dateiserver (Server Message Block). ## Anforderungssyntax ``` { "LocationArn": "string" } ``` ## Anforderungsparameter 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) ** 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 ``` { "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 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) ** 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) ** 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) ** 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) ** Der Zeitpunkt, zu dem der SMB-Standort erstellt wurde. Typ: Zeitstempel ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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 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 ### Beispiel Dieses Beispiel veranschaulicht eine Verwendung von. DescribeLocationSmb #### Beispielanforderung ``` { "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ### Beispiel Dieses Beispiel veranschaulicht eine Verwendung von DescribeLocationSmb. #### Beispielantwort ``` { "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: 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) # DescribeTask Stellt Informationen zu einer *Aufgabe* bereit, die definiert, wo und wie Ihre Daten AWS DataSync übertragen werden. ## Anforderungssyntax ``` { "TaskArn": "string" } ``` ## Anforderungsparameter 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. ** [TaskArn](#API_DescribeTask_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Übertragungsaufgabe an, über die 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}:task/task-[0-9a-f]{17}$` Erforderlich: Ja ## Antwortsyntax ``` { "CloudWatchLogGroupArn": "string", "CreationTime": number, "CurrentTaskExecutionArn": "string", "DestinationLocationArn": "string", "DestinationNetworkInterfaceArns": [ "string" ], "ErrorCode": "string", "ErrorDetail": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "ScheduleDetails": { "DisabledBy": "string", "DisabledReason": "string", "StatusUpdateTime": number }, "SourceLocationArn": "string", "SourceNetworkInterfaceArns": [ "string" ], "Status": "string", "TaskArn": "string", "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Antwortelemente 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. ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) einer CloudWatch Amazon-Protokollgruppe zur Überwachung Ihrer Aufgabe. Weitere Informationen finden Sie unter [Überwachen von Datenübertragungen mit CloudWatch Protokollen](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 562. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` ** [CreationTime](#API_DescribeTask_ResponseSyntax) ** Der Zeitpunkt, zu dem die Aufgabe erstellt wurde. Typ: Zeitstempel ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) ** Der ARN der letzten Aufgabenausführung. 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ** [DestinationLocationArn](#API_DescribeTask_ResponseSyntax) ** Der ARN des Zielorts Ihrer Übertragung. 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}$` ** [DestinationNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) ** Die ARNs [Netzwerkschnittstellen](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces), die für Ihren Zielort DataSync erstellt wurden. Typ: Zeichenfolgen-Array Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` ** [ErrorCode](#API_DescribeTask_ResponseSyntax) ** Wenn bei Ihrer Aufgabe ein Problem auftritt, können Sie den Fehlercode verwenden, um das Problem zu beheben. Weitere Informationen finden Sie unter [Problembehandlung bei DataSync Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Typ: Zeichenfolge ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) ** Wenn bei Ihrer Aufgabe ein Problem auftritt, können Sie die Fehlerdetails verwenden, um das Problem zu beheben. Weitere Informationen finden Sie unter [Problembehandlung bei DataSync Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Typ: Zeichenfolge ** [Excludes](#API_DescribeTask_ResponseSyntax) ** Die Ausschlussfilter, die die Dateien, Objekte und Ordner an Ihrem Quellspeicherort definieren, die Sie nicht übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. ** [Includes](#API_DescribeTask_ResponseSyntax) ** Dazu gehören Filter, die die Dateien, Objekte und Ordner an Ihrem Quellspeicherort definieren, die Sie übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) ** Die Konfiguration des Manifests, das die Dateien oder Objekte auflistet, die Sie übertragen DataSync möchten. Weitere Informationen finden Sie unter [Mithilfe eines Manifests angeben, welche DataSync Übertragungen übertragen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) werden. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt ** [Name](#API_DescribeTask_ResponseSyntax) ** Der Name Ihrer Aufgabe. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` ** [Options](#API_DescribeTask_ResponseSyntax) ** Die Einstellungen der Aufgabe. Beispielsweise, welche Dateimetadaten erhalten bleiben, wie die Datenintegrität am Ende der Übertragung überprüft wird, Bandbreitenbeschränkungen und andere Optionen. Typ: [Options](API_Options.md) Objekt ** [Schedule](#API_DescribeTask_ResponseSyntax) ** Der Zeitplan, zu dem Ihre Aufgabe ausgeführt werden soll. Weitere Informationen finden Sie unter [Aufgabenplanung](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Typ: [TaskSchedule](API_TaskSchedule.md) Objekt ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) ** Die Details zu Ihrem [Task-Zeitplan](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Typ: [TaskScheduleDetails](API_TaskScheduleDetails.md) Objekt ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) ** Der ARN des Quellorts Ihrer Übertragung. 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}$` ** [SourceNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) ** Die ARNs [Netzwerkschnittstellen](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces), die für Ihren Quellstandort DataSync erstellt wurden. Typ: Zeichenfolgen-Array Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` ** [Status](#API_DescribeTask_ResponseSyntax) ** Der Status Ihrer Aufgabe. Informationen darüber, was die einzelnen Status bedeuten, finden Sie unter [Aufgabenstatus](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses). Typ: Zeichenfolge Zulässige Werte: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` ** [TaskArn](#API_DescribeTask_ResponseSyntax) ** Der ARN Ihrer Aufgabe. 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}:task/task-[0-9a-f]{17}$` ** [TaskMode](#API_DescribeTask_ResponseSyntax) ** Der Aufgabenmodus, den Sie verwenden. Weitere Informationen finden Sie unter [Auswählen eines Aufgabenmodus für Ihre Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) ** Die Konfiguration Ihres Aufgabenberichts, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Überwachen Ihrer DataSync Übertragungen mit Aufgabenberichten](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt ## Fehler 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 ### Beispielanforderung Das folgende Beispiel gibt den ARN einer DataSync Aufgabe an, über die Informationen abgerufen werden sollen. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### Beispielantwort Das folgende Beispiel zeigt eine `DescribeTask` Antwort. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026", "Name": "MyTask", "TaskMode": "BASIC", "Status": "RUNNING", "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f", "CreationTime": 1532660733.39, "Options": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*" } ``` ## Weitere Informationen finden Sie unter: 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/DescribeTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask) # DescribeTaskExecution Stellt Informationen über die Ausführung Ihrer AWS DataSync Aufgabe bereit. Sie können diesen Vorgang verwenden, um den Fortschritt einer laufenden Datenübertragung zu überwachen oder die Ergebnisse der Übertragung zu überprüfen. **Anmerkung** Einige `DescribeTaskExecution` Antwortelemente sind nur für einen bestimmten Aufgabenmodus relevant. Weitere Informationen finden Sie unter [Grundlegendes zu Unterschieden im Aufgabenmodus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) und [Grundlegendes zu Leistungsindikatoren bei der Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html). ## Anforderungssyntax ``` { "TaskExecutionArn": "string" } ``` ## Anforderungsparameter 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. ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Aufgabenausführung an, über die 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` Erforderlich: Ja ## Antwortsyntax ``` { "BytesCompressed": number, "BytesTransferred": number, "BytesWritten": number, "EndTime": number, "EstimatedBytesToTransfer": number, "EstimatedFilesToDelete": number, "EstimatedFilesToTransfer": number, "EstimatedFoldersToDelete": number, "EstimatedFoldersToTransfer": number, "Excludes": [ { "FilterType": "string", "Value": "string" } ], "FilesDeleted": number, "FilesFailed": { "Delete": number, "Prepare": number, "Transfer": number, "Verify": number }, "FilesListed": { "AtDestinationForDelete": number, "AtSource": number }, "FilesPrepared": number, "FilesSkipped": number, "FilesTransferred": number, "FilesVerified": number, "FoldersDeleted": number, "FoldersFailed": { "Delete": number, "List": number, "Prepare": number, "Transfer": number, "Verify": number }, "FoldersListed": { "AtDestinationForDelete": number, "AtSource": number }, "FoldersPrepared": number, "FoldersSkipped": number, "FoldersTransferred": number, "FoldersVerified": number, "Includes": [ { "FilterType": "string", "Value": "string" } ], "LaunchTime": number, "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "ReportResult": { "ErrorCode": "string", "ErrorDetail": "string", "Status": "string" }, "Result": { "ErrorCode": "string", "ErrorDetail": "string", "PrepareDuration": number, "PrepareStatus": "string", "TotalDuration": number, "TransferDuration": number, "TransferStatus": "string", "VerifyDuration": number, "VerifyStatus": "string" }, "StartTime": number, "Status": "string", "TaskExecutionArn": "string", "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Antwortelemente 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. ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der physischen Byte, die nach der Komprimierung über das Netzwerk DataSync übertragen werden (sofern eine Komprimierung möglich ist). Diese Zahl ist in der Regel geringer als, [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)sofern die Daten nicht komprimierbar sind. Type: Long ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Byte, die vor der Komprimierung an das Netzwerk DataSync gesendet werden (sofern eine Komprimierung möglich ist). Informationen zur Anzahl der über das Netzwerk übertragenen Byte finden Sie unter [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed). Type: Long ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der logischen Byte, die DataSync tatsächlich an den Zielspeicherort schreiben. Type: Long ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) ** Der Zeitpunkt, zu dem die Übertragungsaufgabe endet. Typ: Zeitstempel ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der logischen Byte, die DataSync voraussichtlich an den Zielspeicherort geschrieben werden. Type: Long ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync voraussichtlich an Ihrem Zielort gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) befinden, ist der Wert immer`0`. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete). Type: Long ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync voraussichtlich über das Netzwerk übertragen werden. Dieser Wert wird während der DataSync [Vorbereitung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) der Übertragung berechnet. Wie dieser Wert berechnet wird, hängt in erster Linie von der Konfiguration des [Übertragungsmodus](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) Ihrer Aufgabe ab: + Wenn auf gesetzt `TranserMode` ist `CHANGED` — Die Berechnung basiert auf dem Vergleich des Inhalts der Quell- und Zielspeicherorte und der Bestimmung der Differenz, die übertragen werden muss. Der Unterschied kann Folgendes beinhalten: + Alles, was am Quellspeicherort hinzugefügt oder geändert wurde. + Alles, was sich an beiden Speicherorten [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)befindet und nach einer ersten Übertragung am Ziel geändert wurde (sofern nicht auf eingestellt`NEVER`). + **(Nur einfacher Aufgabenmodus)** Die Anzahl der Elemente, die DataSync voraussichtlich gelöscht werden (falls [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)auf gesetzt`REMOVE`). + Wenn auf gesetzt `TranserMode` ist `ALL` — Die Berechnung basiert nur auf den Elementen, die am DataSync Quellspeicherort gefunden wurden. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Leistungsindikator nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer). Type: Long ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync voraussichtlich an Ihrem Zielort gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) befinden, ist der Wert immer`0`. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync voraussichtlich über das Netzwerk übertragen werden. Dieser Wert wird berechnet, während die Verzeichnisse für die Übertragung DataSync [vorbereitet](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) werden. Wie dieser Wert berechnet wird, hängt in erster Linie von der Konfiguration des [Übertragungsmodus](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) Ihrer Aufgabe ab: + Wenn auf gesetzt `TranserMode` ist `CHANGED` — Die Berechnung basiert auf dem Vergleich des Inhalts der Quell- und Zielspeicherorte und der Bestimmung der Differenz, die übertragen werden muss. Der Unterschied kann Folgendes beinhalten: + Alles, was am Quellspeicherort hinzugefügt oder geändert wurde. + Alles, was sich an beiden Speicherorten [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)befindet und nach einer ersten Übertragung am Ziel geändert wurde (sofern nicht auf eingestellt`NEVER`). + Wenn auf gesetzt `TranserMode` ist `ALL` — Die Berechnung basiert nur auf den Elementen, die am DataSync Quellspeicherort gefunden wurden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) ** Eine Liste von Filterregeln, die bestimmte Daten während Ihrer Übertragung ausschließen. Weitere Informationen und Beispiele finden Sie unter [Filtern von Daten, die übertragen wurden DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die an Ihrem Zielort DataSync tatsächlich gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), ist der Wert immer`0`. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted). Type: Long ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung der Aufgabe nicht vorbereitet, übertragen, überprüft und gelöscht werden konnten. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) Objekt ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien oder Objekte, die DataSync an Ihren Standorten gefunden wurden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) Objekt ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien oder Objekte, DataSync die nach dem Vergleich Ihrer Quell- und Zielspeicherorte zu übertragen versuchen. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Dieser Zähler gilt nicht, wenn Sie Ihre Aufgabe so konfigurieren, dass [alle Daten übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). In diesem Szenario wird alles von der Quelle zum Ziel DataSync kopiert, ohne die Unterschiede zwischen den Speicherorten zu vergleichen. Type: Long ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped). Type: Long ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync tatsächlich über das Netzwerk übertragen werden. Dieser Wert wird während der Ausführung der Aufgabe regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Wenn DataSync etwas nicht übertragen werden kann, kann dieser Wert kleiner als sein`EstimatedFilesToTransfer`. In einigen Fällen kann dieser Wert auch größer als sein`EstimatedFilesToTransfer`. Dieses Element ist für einige Standorttypen implementierungsspezifisch. Verwenden Sie es also nicht, um genau anzugeben, was übertragen wird, oder um die Ausführung Ihrer Aufgabe zu überwachen. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred). Type: Long ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die während der Übertragung DataSync überprüft werden. Wenn Sie Ihre Aufgabe so konfigurieren, [dass nur die übertragenen Daten überprüft](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html) werden. In manchen Situationen werden Verzeichnisse oder Dateien, die DataSync nicht übertragen werden können, nicht überprüft. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Leistungsindikator nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified). Type: Long ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die an Ihrem Zielort DataSync tatsächlich gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), ist der Wert immer`0`. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, DataSync die während der Ausführung der Aufgabe nicht aufgelistet, vorbereitet, übertragen, überprüft und gelöscht werden können. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) Objekt ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync an Ihren Standorten gefunden werden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) Objekt ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, DataSync die nach dem Vergleich Ihrer Quell- und Zielverzeichnisse zu übertragen versuchen. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Dieser Zähler gilt nicht, wenn Sie Ihre Aufgabe so konfigurieren, dass [alle Daten übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). In diesem Szenario wird alles von der Quelle zum Ziel DataSync kopiert, ohne die Unterschiede zwischen den Speicherorten zu vergleichen. Type: Long ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync tatsächlich über das Netzwerk übertragen werden. Dieser Wert wird während der Ausführung der Aufgabe regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Wenn DataSync etwas nicht übertragen werden kann, kann dieser Wert kleiner als sein`EstimatedFoldersToTransfer`. In einigen Fällen kann dieser Wert auch größer als sein`EstimatedFoldersToTransfer`. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die während der Übertragung DataSync überprüft werden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) ** Eine Liste von Filterregeln, die während der Übertragung bestimmte Daten enthalten. Weitere Informationen und Beispiele finden Sie unter [Filtern von Daten, die übertragen wurden DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) ** Der Zeitpunkt, zu dem die Ausführung der Aufgabe tatsächlich beginnt. Für Aufgaben, die sich nicht in der Warteschlange befinden, `LaunchTime` `StartTime` sind sie in der Regel identisch. Bei Aufgaben in der Warteschlange `LaunchTime` erfolgt dies in der Regel später, als `StartTime` weil Aufgaben, die zuvor in der Warteschlange standen, erst abgeschlossen werden müssen, bevor neuere Aufgaben beginnen können. Typ: Zeitstempel ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) ** Die Konfiguration des Manifests, das die zu übertragenden Dateien oder Objekte auflistet. Weitere Informationen finden Sie unter [Mithilfe eines Manifests angeben, welche DataSync Übertragungen übertragen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) werden. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt ** [Options](#API_DescribeTaskExecution_ResponseSyntax) ** Gibt an, wie Ihre Übertragungsaufgabe konfiguriert ist. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten während der Übertragung umgegangen wird. Sie können unter anderem auch angeben, wie die Datenintegrität überprüft werden soll, Bandbreitenlimits für Ihre Aufgabe festlegen. Jede Option hat einen Standardwert. Sofern Sie dies nicht möchten, müssen Sie vor dem Aufrufen keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Sie können Ihre Aufgabenoptionen auch für jede Aufgabenausführung überschreiben. Möglicherweise möchten Sie die `LogLevel` für eine einzelne Ausführung anpassen. Typ: [Options](API_Options.md) Objekt ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) ** Gibt an, ob ein vollständiger [Aufgabenbericht](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) für Ihre Übertragung DataSync generiert wurde. Typ: [ReportResult](API_ReportResult.md) Objekt ** [Result](#API_DescribeTaskExecution_ResponseSyntax) ** Das Ergebnis der Aufgabenausführung. Typ: [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) Objekt ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) ** Die Uhrzeit, zu der die Anforderung zum Starten der Aufgabenausführung DataSync gesendet wird. Für Aufgaben, die sich nicht in der Warteschlange befinden, `LaunchTime` `StartTime` sind sie in der Regel identisch. Bei Aufgaben in der Warteschlange `LaunchTime` erfolgt dies in der Regel später, als `StartTime` weil Aufgaben, die zuvor in der Warteschlange standen, erst abgeschlossen werden müssen, bevor neuere Aufgaben beginnen können. Typ: Zeitstempel ** [Status](#API_DescribeTaskExecution_ResponseSyntax) ** Der Status der Aufgabenausführung. Ausführliche Informationen zum Status der Aufgabenausführung finden Sie unter Status der [Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Typ: Zeichenfolge Zulässige Werte: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) ** Der ARN der Aufgabenausführung, über die Sie Informationen benötigen. `TaskExecutionArn`ist hierarchisch und bezieht sich auf `TaskArn` die Aufgabe, die ausgeführt wurde. Beispielsweise `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` führte ein `TaskExecution` Wert mit dem ARN die Aufgabe mit dem ARN aus`arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`. 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) ** Der Aufgabenmodus, den Sie verwenden. Weitere Informationen finden Sie unter [Auswählen eines Aufgabenmodus für Ihre Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) ** Die Konfiguration Ihres Aufgabenberichts, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Aufgabenbericht erstellen](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt ## Fehler 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 ### Beispielanforderung Dieses Beispiel veranschaulicht eine `DescribeTaskExecution` Anfrage. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1" } ``` ### Beispielantwort 1 für die Ausführung einer Aufgabe im erweiterten Modus Das folgende Beispiel beschreibt eine DataSync Aufgabenausführung, die den erweiterten Modus verwendet. Bei der Ausführung werden auch bestimmte Daten mithilfe von Ausschluss- und Include-Filtern übertragen. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "BASIC", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/archive-files" }], "Includes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/files" }], "StartTime": "2024-10-16T11:19:56.844000-04:00", "EstimatedFilesToTransfer": 7, "EstimatedFoldersToTransfer": 2, "EstimatedBytesToTransfer": 30, "FilesTransferred": 7, "FoldersTransferred": 2, "BytesWritten": 30, "BytesTransferred": 30, "BytesCompressed": 30, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3310, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 7, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 7, "FilesListed": { "AtSource": 7, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 2, "FoldersPrepared": 2, "FoldersListed": { "AtSource": 2, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### Beispielantwort 2 für die Ausführung einer Aufgabe im erweiterten Modus Das folgende Beispiel beschreibt eine weitere DataSync Aufgabenausführung, die den erweiterten Modus verwendet. In dieser Situation überträgt die Ausführung bestimmte Daten mithilfe eines Manifests anstelle von Filtern. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "TRANSFER", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [], "Includes": [], "ManifestConfig": { "Action": "TRANSFER", "Format": "CSV", "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess", "S3Bucket": "arn:aws:s3:::manifests-datasync", "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG", "Source": { "S3": { "ManifestObjectPath": "manifest-folder/manifest-versioned-files", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess", "S3BucketArn": "arn:aws:s3:::manifests-datasync", "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG" } } }, "StartTime": "2024-10-16T09:29:56.757000-04:00", "EstimatedFilesToTransfer": 1, "EstimatedFoldersToTransfer": 0, "EstimatedBytesToTransfer": 6, "FilesTransferred": 1, "FoldersTransferred": 1, "BytesWritten": 6, "BytesTransferred": 6, "BytesCompressed": 6, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3089, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "TaskReportConfig": { "Destination": { "S3": { "Subdirectory": "reports/", "S3BucketArn": "arn:aws:s3:::my-task-report", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess" } }, "OutputType": "STANDARD", "ReportLevel": "SUCCESSES_AND_ERRORS", "ObjectVersionIds": "INCLUDE" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 1, "ReportResult": { "Status": "SUCCESS" }, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 1, "FilesListed": { "AtSource": 1, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 0, "FoldersPrepared": 0, "FoldersListed": { "AtSource": 0, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### Beispielantwort für die Ausführung einer Aufgabe im Basismodus Das folgende Beispiel beschreibt eine DataSync Aufgabenausführung, die den Basismodus verwendet. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "SUCCESS", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": "2024-10-16T11:19:56.844000-04:00", "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` ## Weitere Informationen finden Sie unter: 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/DescribeTaskExecution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution) # ListAgents Gibt eine Liste von AWS DataSync Agenten zurück, die zu einem AWS-Konto in der Anfrage AWS-Region angegebenen gehören. Mit der Paginierung können Sie die Anzahl der Agenten reduzieren, die in einer Antwort zurückgegeben werden. Wenn Sie in einer Antwort eine gekürzte Liste von Agenten erhalten, enthält die Antwort eine Markierung, die Sie in Ihrer nächsten Anfrage angeben können, um die nächste Agentenseite abzurufen. `ListAgents`ist letztlich konsistent. Das bedeutet, dass das Ergebnis der Ausführung des Vorgangs möglicherweise nicht darauf hindeutet, dass Sie gerade einen Agenten erstellt oder gelöscht haben. Wenn Sie beispielsweise einen Agenten mit erstellen [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)und ihn dann sofort ausführen`ListAgents`, wird dieser Agent möglicherweise nicht sofort in der Liste angezeigt. In solchen Situationen können Sie jederzeit mit Hilfe von überprüfen, ob ein Agent erstellt (oder gelöscht) wurde [DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html). ## Anforderungssyntax ``` { "MaxResults": number, "NextToken": "string" } ``` ## Anforderungsparameter 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. ** [MaxResults](#API_ListAgents_RequestSyntax) ** Gibt die maximale Anzahl von DataSync Agenten an, die in einer Antwort aufgeführt werden sollen. Standardmäßig werden in einer Antwort maximal 100 Agenten angezeigt. Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. Maximalwert 100. Erforderlich: Nein ** [NextToken](#API_ListAgents_RequestSyntax) ** Gibt eine undurchsichtige Zeichenfolge an, die die Position angibt, an der die nächste Ergebnisliste in der Antwort beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` Erforderlich: Nein ## Antwortsyntax ``` { "Agents": [ { "AgentArn": "string", "Name": "string", "Platform": { "Version": "string" }, "Status": "string" } ], "NextToken": "string" } ``` ## Antwortelemente 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. ** [Agents](#API_ListAgents_ResponseSyntax) ** Eine Liste der DataSync Agenten in Ihrem AWS-Konto in der AWS-Region Anfrage angegebenen. Die Liste ist nach den Amazon-Ressourcennamen der Agenten (ARNs) sortiert. Typ: Array von [AgentListEntry](API_AgentListEntry.md)-Objekten ** [NextToken](#API_ListAgents_ResponseSyntax) ** Die undurchsichtige Zeichenfolge, die die Position angibt, an der die nächste Ergebnisliste in der Antwort beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` ## Fehler 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 Dienst ein Fehler auftritt. AWS DataSync HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListAgents) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) # ListLocations Gibt eine Liste von Quell- und Zielorten zurück. Wenn Sie mehr Standorte haben, als in einer Antwort zurückgegeben werden (d. h., die Antwort gibt nur eine gekürzte Liste Ihrer Agenten zurück), enthält die Antwort ein Token, das Sie in Ihrer nächsten Anfrage angeben können, um die nächste Seite mit Standorten abzurufen. ## Anforderungssyntax ``` { "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" } ``` ## Anforderungsparameter 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. ** [Filters](#API_ListLocations_RequestSyntax) ** Sie können API-Filter verwenden, um die Liste der von zurückgegebenen Ressourcen einzugrenzen. `ListLocations` Um beispielsweise alle Aufgaben an einem bestimmten Quellspeicherort abzurufen, können Sie `ListLocations` with filter name `LocationType S3` and verwenden`Operator Equals`. Typ: Array von [LocationFilter](API_LocationFilter.md)-Objekten Erforderlich: Nein ** [MaxResults](#API_ListLocations_RequestSyntax) ** Die maximale Anzahl von Standorten, die zurückgegeben werden sollen. Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. Maximalwert 100. Erforderlich: Nein ** [NextToken](#API_ListLocations_RequestSyntax) ** Eine undurchsichtige Zeichenfolge, die die Position angibt, an der die nächste Liste von Orten beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` Erforderlich: Nein ## Antwortsyntax ``` { "Locations": [ { "LocationArn": "string", "LocationUri": "string" } ], "NextToken": "string" } ``` ## Antwortelemente 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. ** [Locations](#API_ListLocations_ResponseSyntax) ** Ein Array, das eine Liste von Orten enthält. Typ: Array von [LocationListEntry](API_LocationListEntry.md)-Objekten ** [NextToken](#API_ListLocations_ResponseSyntax) ** Eine undurchsichtige Zeichenfolge, die die Position angibt, an der mit der Rückgabe der nächsten Ortsliste begonnen werden soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` ## Fehler 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 Dienst ein Fehler auftritt. AWS DataSync HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListLocations) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) # ListTagsForResource Gibt alle mit einer AWS Ressource verknüpften Tags zurück. ## Anforderungssyntax ``` { "MaxResults": number, "NextToken": "string", "ResourceArn": "string" } ``` ## Anforderungsparameter 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. ** [MaxResults](#API_ListTagsForResource_RequestSyntax) ** Gibt an, wie viele Ergebnisse die Antwort enthalten soll. Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. Maximalwert 100. Erforderlich: Nein ** [NextToken](#API_ListTagsForResource_RequestSyntax) ** Gibt eine undurchsichtige Zeichenfolge an, die die Position angibt, an der die nächste Ergebnisliste in der Antwort beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` Erforderlich: Nein ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Ressource an, für die Sie Tag-Informationen wünschen. 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}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$` Erforderlich: Ja ## Antwortsyntax ``` { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Antwortelemente 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. ** [NextToken](#API_ListTagsForResource_ResponseSyntax) ** Die undurchsichtige Zeichenfolge, die die Position angibt, an der die nächste Ergebnisliste in der Antwort beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** Eine Reihe von Tags, die auf die angegebene Ressource angewendet wurden. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Maximale Anzahl von 55 Elementen. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) # ListTaskExecutions Gibt eine Liste von Ausführungen für eine AWS DataSync Übertragungsaufgabe zurück. ## Anforderungssyntax ``` { "MaxResults": number, "NextToken": "string", "TaskArn": "string" } ``` ## Anforderungsparameter 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. ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) ** Gibt an, wie viele Ergebnisse die Antwort enthalten soll. Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. Maximalwert 100. Erforderlich: Nein ** [NextToken](#API_ListTaskExecutions_RequestSyntax) ** Gibt eine undurchsichtige Zeichenfolge an, die die Position angibt, an der die nächste Ergebnisliste in der Antwort beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` Erforderlich: Nein ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Aufgabe an, zu der Sie Ausführungsinformationen 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}:task/task-[0-9a-f]{17}$` Erforderlich: Nein ## Antwortsyntax ``` { "NextToken": "string", "TaskExecutions": [ { "Status": "string", "TaskExecutionArn": "string", "TaskMode": "string" } ] } ``` ## Antwortelemente 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. ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) ** Die undurchsichtige Zeichenfolge, die die Position angibt, an der die nächste Ergebnisliste in der Antwort beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) ** Eine Liste der Ausführungen der Aufgabe. Typ: Array von [TaskExecutionListEntry](API_TaskExecutionListEntry.md)-Objekten ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) # ListTasks Gibt eine Liste der von Ihnen erstellten AWS DataSync Aufgaben zurück. ## Anforderungssyntax ``` { "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" } ``` ## Anforderungsparameter 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. ** [Filters](#API_ListTasks_RequestSyntax) ** Sie können API-Filter verwenden, um die Liste der von zurückgegebenen Ressourcen einzugrenzen`ListTasks`. Um beispielsweise alle Aufgaben an einem bestimmten Quellspeicherort abzurufen, können Sie dies `ListTasks` mit dem Filternamen `LocationId` und `Operator Equals` mit dem ARN für den Speicherort verwenden. Typ: Array von [TaskFilter](API_TaskFilter.md)-Objekten Erforderlich: Nein ** [MaxResults](#API_ListTasks_RequestSyntax) ** Die maximale Anzahl von Aufgaben, die zurückgegeben werden sollen. Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. Maximalwert 100. Erforderlich: Nein ** [NextToken](#API_ListTasks_RequestSyntax) ** Eine undurchsichtige Zeichenfolge, die die Position angibt, an der die nächste Aufgabenliste beginnen soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` Erforderlich: Nein ## Antwortsyntax ``` { "NextToken": "string", "Tasks": [ { "Name": "string", "Status": "string", "TaskArn": "string", "TaskMode": "string" } ] } ``` ## Antwortelemente 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. ** [NextToken](#API_ListTasks_ResponseSyntax) ** Eine undurchsichtige Zeichenfolge, die die Position angibt, an der mit der Rückgabe der nächsten Aufgabenliste begonnen werden soll. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 65535. Pattern: `[a-zA-Z0-9=_-]+` ** [Tasks](#API_ListTasks_ResponseSyntax) ** Eine Liste aller zurückgegebenen Aufgaben. Typ: Array von [TaskListEntry](API_TaskListEntry.md)-Objekten ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/ListTasks) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) # StartTaskExecution Startet eine AWS DataSync Übertragungsaufgabe. Für jede Aufgabe können Sie jeweils nur eine Aufgabenausführung ausführen. Die Ausführung einer Aufgabe besteht aus mehreren Schritten. Weitere Informationen finden Sie unter [Status der Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses). **Wichtig** Wenn Sie planen, Daten zu oder von einem Amazon S3 S3-Standort zu übertragen, lesen Sie zunächst, [wie sich dies auf Ihre S3-Anforderungsgebühren auswirken DataSync kann](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests), sowie auf der [DataSync Preisseite](https://aws.amazon.com/datasync/pricing/). ## Anforderungssyntax ``` { "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "OverrideOptions": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ], "TaskArn": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Anforderungsparameter 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. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** Gibt eine Liste von Filterregeln an, die bestimmt, welche Dateien von einer Aufgabe ausgeschlossen werden sollen. Die Liste enthält eine einzelne Filterzeichenfolge, die aus den auszuschließenden Mustern besteht. Die Muster werden durch "\$1" (also eine Pipe) abgegrenzt. Beispiel: `"/folder1|/folder2"`. Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [Includes](#API_StartTaskExecution_RequestSyntax) ** Gibt eine Liste von Filterregeln an, die bestimmt, welche Dateien bei der Ausführung einer Aufgabe berücksichtigt werden sollen. Das Muster sollte eine einzelne Filterzeichenfolge enthalten, die aus den einzuschließenden Mustern besteht. Die Muster werden durch "\$1" (also eine Pipe) abgegrenzt. Beispiel: `"/folder1|/folder2"`. Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) ** Konfiguriert ein Manifest, bei dem es sich um eine Liste von Dateien oder Objekten handelt, die Sie übertragen DataSync möchten. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Angabe der DataSync Übertragungen mithilfe eines Manifests](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die Rolle, DataSync mit der Sie ihn verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Erlaubnis. Um eine Manifestkonfiguration zu entfernen, geben Sie diesen Parameter mit einem leeren Wert an. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt Erforderlich: Nein ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** Gibt an, wie Ihre Übertragungsaufgabe konfiguriert ist. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten während der Übertragung umgegangen wird. Sie können unter anderem auch angeben, wie die Datenintegrität überprüft werden soll, Bandbreitenlimits für Ihre Aufgabe festlegen. Jede Option hat einen Standardwert. Sofern Sie dies nicht möchten, müssen Sie vor dem Anruf keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Sie können Ihre Aufgabenoptionen auch für jede Aufgabenausführung überschreiben. Möglicherweise möchten Sie die `LogLevel` für eine einzelne Ausführung anpassen. Typ: [Options](API_Options.md) Objekt Erforderlich: Nein ** [Tags](#API_StartTaskExecution_RequestSyntax) ** Gibt die Tags an, die Sie auf den Amazon-Ressourcennamen (ARN) anwenden möchten, der die Aufgabenausführung darstellt. *Tags* sind Schlüssel-Wert-Paare, die Ihnen helfen, Ihre DataSync Ressourcen zu verwalten, zu filtern und nach ihnen zu suchen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Aufgabe an, die Sie starten möchten. 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}:task/task-[0-9a-f]{17}$` Erforderlich: Ja ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) ** Gibt an, wie Sie einen Aufgabenbericht konfigurieren möchten, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Überwachen Ihrer DataSync Übertragungen mit Aufgabenberichten](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die Rolle, DataSync mit der Sie ihn verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Erlaubnis. Um eine Task-Berichtskonfiguration zu entfernen, geben Sie diesen Parameter als leer an. Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt Erforderlich: Nein ## Antwortsyntax ``` { "TaskExecutionArn": "string" } ``` ## Antwortelemente 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. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** Der ARN der laufenden Aufgabenausführung. 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ## Fehler 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 ### Beispielanforderung Im folgenden Beispiel wird eine Aufgabenausführung mit den Standardoptionen für die angegebene Aufgabe gestartet. ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### Beispielantwort Dieses Beispiel veranschaulicht eine Verwendung von StartTaskExecution. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## Weitere Informationen finden Sie unter: 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/StartTaskExecution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution) # TagResource Wendet ein *Tag* auf eine AWS Ressource an. Tags sind Schlüssel-Wert-Paare, die Ihnen helfen können, Ihre Ressourcen zu verwalten, zu filtern und nach ihnen zu suchen. Dazu gehören AWS DataSync Ressourcen wie Standorte, Aufgaben und Aufgabenausführungen. ## Anforderungssyntax ``` { "ResourceArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Anforderungsparameter 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. ** [ResourceArn](#API_TagResource_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Ressource an, auf die das Tag angewendet werden soll. 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}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$` Erforderlich: Ja ** [Tags](#API_TagResource_RequestSyntax) ** Gibt die Tags an, die Sie auf die Ressource anwenden möchten. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/TagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) # UntagResource Entfernt Tags aus einer AWS Ressource. ## Anforderungssyntax ``` { "Keys": [ "string" ], "ResourceArn": "string" } ``` ## Anforderungsparameter 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. ** [Keys](#API_UntagResource_RequestSyntax) ** Gibt die Schlüssel in den Tags an, die Sie entfernen möchten. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente. Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:/-]+$` Erforderlich: Ja ** [ResourceArn](#API_UntagResource_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Ressource an, aus der die Tags entfernt werden sollen. 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}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$` Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UntagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) # UpdateAgent Aktualisiert den Namen eines AWS DataSync Agenten. ## Anforderungssyntax ``` { "AgentArn": "string", "Name": "string" } ``` ## Anforderungsparameter 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. ** [AgentArn](#API_UpdateAgent_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des zu aktualisierenden Agenten. 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}:agent/agent-[0-9a-z]{17}$` Erforderlich: Ja ** [Name](#API_UpdateAgent_RequestSyntax) ** Der Name, den Sie zur Konfiguration des Agenten verwenden möchten. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateAgent) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) # UpdateLocationAzureBlob Ändert die folgenden Konfigurationen des Microsoft Azure Blob Storage-Übertragungsorts, den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html). ## Anforderungssyntax ``` { "AccessTier": "string", "AgentArns": [ "string" ], "AuthenticationType": "string", "BlobType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "SasConfiguration": { "Token": "string" }, "Subdirectory": "string" } ``` ## Anforderungsparameter 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. ** [AccessTier](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt die Zugriffsebene an, in die Ihre Objekte oder Dateien übertragen werden sollen. Dies gilt nur, wenn der Standort als Übertragungsziel verwendet wird. Weitere Informationen finden Sie unter [Zugriffsebenen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Typ: Zeichenfolge Zulässige Werte: `HOT | COOL | ARCHIVE` Erforderlich: Nein ** [AgentArns](#API_UpdateLocationAzureBlob_RequestSyntax) ** (Optional) Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten an, der eine Verbindung mit Ihrem Azure Blob Storage-Container herstellen kann. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben. Sie können mehr als einen Agenten angeben. Weitere Informationen finden Sie unter [Mehrere Agenten für Ihre Übertragung verwenden](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html). Sie können keine Agenten zu einem Speicherort hinzufügen oder daraus entfernen, nachdem Sie ihn ursprünglich erstellt haben. 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}$` Erforderlich: Nein ** [AuthenticationType](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt die Authentifizierungsmethode an, die für den Zugriff auf Ihren Azure Blob Storage DataSync verwendet wird. DataSync kann mithilfe einer Shared Access Signature (SAS) auf Blob-Speicher zugreifen. Typ: Zeichenfolge Zulässige Werte: `SAS | NONE` Erforderlich: Nein ** [BlobType](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt den Blobtyp an, den Ihre Objekte oder Dateien haben sollen, wenn sie in Azure Blob Storage übertragen werden. Unterstützt derzeit DataSync nur das Verschieben von Daten in Azure Blob Storage als Blockblobs. Weitere Informationen zu Blobtypen finden Sie in der [Azure Blob](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Storage-Dokumentation. Typ: Zeichenfolge Zulässige Werte: `BLOCK` Erforderlich: Nein ** [CmkSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, das für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet wird, und für ein vom Kunden verwaltetes. AWS KMS key Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf das Geheimnis ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt den ARN des Azure Blob Storage-Übertragungsorts an, den Sie aktualisieren. 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 ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt die SAS-Konfiguration an, die DataSync den Zugriff auf Ihren Azure Blob Storage ermöglicht. Typ: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) Objekt Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) ** Gibt Pfadsegmente an, wenn Sie Ihre Übertragung auf ein virtuelles Verzeichnis in Ihrem Container beschränken möchten (z. B.`/my/images`). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 1 024. Pattern: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) # UpdateLocationEfs Ändert die folgenden Konfigurationsparameter des Amazon EFS-Übertragungsorts, den Sie mit AWS DataSync verwenden. Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html). ## Anforderungssyntax ``` { "AccessPointArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "Subdirectory": "string" } ``` ## Anforderungsparameter 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. ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Access Points an, der zum Mounten Ihres Amazon EFS-Dateisystems DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugreifen auf eingeschränkte Amazon EFS-Dateisysteme](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). 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):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$)|(^$)` Erforderlich: Nein ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) ** Gibt eine AWS Identity and Access Management (IAM-) Rolle an, die DataSync den Zugriff auf Ihr Amazon EFS-Dateisystem ermöglicht. Informationen zum Erstellen dieser Rolle finden Sie unter [Erstellen einer DataSync IAM-Rolle für den Zugriff auf das Amazon EFS-Dateisystem](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)` Erforderlich: Nein ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) ** Gibt an, ob Sie DataSync die Transport Layer Security (TLS) 1.2-Verschlüsselung verwenden möchten, wenn Daten zu oder von Ihrem Amazon EFS-Dateisystem übertragen werden. Wenn Sie einen Zugriffspunkt mit `AccessPointArn` oder eine IAM-Rolle mit `FileSystemAccessRoleArn` angeben, müssen Sie diesen Parameter auf `TLS1_2` setzen. Typ: Zeichenfolge Zulässige Werte: `NONE | TLS1_2` Erforderlich: Nein ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Amazon EFS-Übertragungsorts an, den Sie aktualisieren. 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 ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) ** Gibt einen Mount-Pfad für Ihr Amazon-EFS-Dateisystem an. Hier werden Daten in Ihrem Dateisystem DataSync gelesen oder geschrieben (je nachdem, ob es sich um einen Quell- oder Zielort handelt). DataSync Verwendet standardmäßig das Stammverzeichnis (oder den [Zugriffspunkt](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html), falls Sie eines mit angeben`AccessPointArn`). Sie können Unterverzeichnisse auch mit Schrägstrichen einbeziehen (z. B.`/path/to/folder`). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) # UpdateLocationFsxLustre Ändert die folgenden Konfigurationsparameter des Amazon FSx for Lustre-Übertragungsorts, den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [ DataSyncTransfers mit FSx for Lustre konfigurieren](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html). ## Anforderungssyntax ``` { "LocationArn": "string", "Subdirectory": "string" } ``` ## Anforderungsparameter 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_UpdateLocationFsxLustre_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des FSx for Lustre-Transferstandorts an, den Sie aktualisieren. 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 ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) ** Gibt einen Bereitstellungspfad für Ihr FSx for Lustre-Dateisystem an. Der Pfad kann Unterverzeichnisse enthalten. Wenn der Speicherort als Quelle verwendet wird, DataSync liest Daten aus dem Mount-Pfad. Wenn der Speicherort als Ziel verwendet wird, werden Daten in den Bereitstellungspfad DataSync geschrieben. Wenn Sie diesen Parameter nicht angeben, DataSync verwendet das Stammverzeichnis des Dateisystems (`/`). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) # UpdateLocationFsxOntap Ändert die folgenden Konfigurationsparameter des Amazon FSx for NetApp ONTAP-Übertragungsorts, den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [ DataSyncÜbertragungen konfigurieren mit FSx für](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html) ONTAP. ## Anforderungssyntax ``` { "LocationArn": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "Subdirectory": "string" } ``` ## Anforderungsparameter 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_UpdateLocationFsxOntap_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des FSx für ONTAP übertragenden Standorts an, den Sie aktualisieren. 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 ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) ** Gibt das Datenübertragungsprotokoll an, das für den Zugriff auf Ihr FSx Amazon-Dateisystem DataSync verwendet wird. Typ: [FsxUpdateProtocol](API_FsxUpdateProtocol.md) Objekt Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) ** Gibt einen Pfad zur Dateifreigabe in der virtuellen Speichermaschine (SVM) an, zu der oder von der Sie Daten übertragen möchten. Sie können einen Knotenpfad (auch als Mount-Punkt bezeichnet), einen Qtree-Pfad (für NFS-Dateifreigaben) oder einen Share-Namen (für SMB-Dateifreigaben) angeben. Ihr Mount-Pfad könnte zum Beispiel `/vol1`, `/vol1/tree1` oder `/share1` sein. Geben Sie keinen Verbindungspfad im Stammvolume der SVM an. Weitere Informationen finden Sie unter [Verwaltung FSx virtueller ONTAP-Speichermaschinen](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) im *Amazon FSx for NetApp ONTAP-Benutzerhandbuch*. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 Service ein Fehler auftritt. AWS DataSync HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) # UpdateLocationFsxOpenZfs Ändert die folgenden Konfigurationsparameter des Amazon FSx for OpenZFS-Übertragungsorts, den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [ DataSyncÜbertragungen konfigurieren mit FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html) für OpenZFS. **Anmerkung** Anforderungsparameter, die sich auf beziehen, werden von dem `UpdateLocationFsxOpenZfs` Vorgang `SMB` nicht unterstützt. ## Anforderungssyntax ``` { "LocationArn": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "Subdirectory": "string" } ``` ## Anforderungsparameter 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_UpdateLocationFsxOpenZfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des FSx für OpenZFS übertragenen Speicherorts an, den Sie aktualisieren. 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 ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** Gibt das Datenübertragungsprotokoll an, das für den Zugriff auf Ihr FSx Amazon-Dateisystem AWS DataSync verwendet wird. Typ: [FsxProtocol](API_FsxProtocol.md) Objekt Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** Gibt ein Unterverzeichnis im Pfad des Speicherorts an, das mit `/fsx` beginnen muss. DataSync verwendet dieses Unterverzeichnis zum Lesen oder Schreiben von Daten (je nachdem, ob es sich bei dem Dateisystem um einen Quell- oder Zielspeicherort handelt). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) # UpdateLocationFsxWindows Ändert die folgenden Konfigurationsparameter des Amazon FSx for Windows File Server-Übertragungsorts, den Sie mit AWS DataSync verwenden. Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit FSx für Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html). ## Anforderungssyntax ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "LocationArn": "string", "Password": "string", "Subdirectory": "string", "User": "string" } ``` ## Anforderungsparameter 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. ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. für einen `Password` oder mehrere Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und für einen vom AWS KMS key Kunden verwalteten Schlüssel. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel an, z. B. einen `Password` oder eine Reihe von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und für eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf den geheimen Schlüssel ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt den Namen der Windows-Domäne an, zu der Ihr Dateisystem FSx für Windows File Server gehört. Wenn Sie mehrere Active Directory-Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen Dateisystem hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$` Erforderlich: Nein ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt den ARN des Übertragungsorts FSx für den Windows-Dateiserver an, den Sie aktualisieren. 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 ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt das Kennwort des Benutzers an, der berechtigt ist, die Dateien, Ordner und Dateimetadaten in Ihrem Dateisystem FSx für Windows File Server bereitzustellen und darauf zuzugreifen. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt einen Einhängepfad für Ihr Dateisystem unter Verwendung von Schrägstrichen an. DataSync verwendet dieses Unterverzeichnis zum Lesen oder Schreiben von Daten (je nachdem, ob das Dateisystem ein Quell- oder Zielverzeichnis ist). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ** [User](#API_UpdateLocationFsxWindows_RequestSyntax) ** Gibt den Benutzer an, der berechtigt ist, die Dateien, Ordner und Dateimetadaten in Ihrem Dateisystem FSx für Windows File Server bereitzustellen und darauf zuzugreifen. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [Erforderliche Berechtigungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx für Windows-Dateiserverstandorte. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) # UpdateLocationHdfs Ändert die folgenden Konfigurationsparameter des Hadoop Distributed File System (HDFS) -Übertragungsorts, den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit einem](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html) HDFS-Cluster. ## Anforderungssyntax ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string", "Subdirectory": "string" } ``` ## Anforderungsparameter 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. ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) ** Die Amazon-Ressourcennamen (ARNs) der DataSync Agenten, die eine Verbindung zu Ihrem HDFS-Cluster 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}$` Erforderlich: Nein ** [AuthenticationType](#API_UpdateLocationHdfs_RequestSyntax) ** Die Art der Authentifizierung, die verwendet wird, um die Identität des Benutzers zu ermitteln. Typ: Zeichenfolge Zulässige Werte: `SIMPLE | KERBEROS` Erforderlich: Nein ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) ** Die Größe der Datenblöcke, die in den HDFS-Cluster geschrieben werden sollen. Typ: Ganzzahl Gültiger Bereich: Mindestwert von 1048576. Der Höchstwert ist 1073741824. Erforderlich: Nein ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. für einen `KerberosKeytab` oder mehrere Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und für einen vom Kunden verwalteten Schlüssel. AWS KMS key Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel an, z. B. einen `KerberosKeytab` oder eine Reihe von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und für eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf den geheimen Schlüssel ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) ** Die Kerberos-Schlüsseltabelle (keytab), die Zuweisungen zwischen dem definierten Kerberos-Prinzipal und den verschlüsselten Schlüsseln enthält. Sie können den Keytab aus einer Datei laden, indem Sie die Adresse der Datei angeben. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 65536. Erforderlich: Nein ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) ** Die `krb5.conf`-Datei, die die Kerberos-Konfigurationsinformationen enthält. Sie können die `krb5.conf` Datei laden, indem Sie die Adresse der Datei angeben. Wenn Sie das verwenden AWS CLI, führt es die Base64-Kodierung für Sie durch. Andernfalls geben Sie den Base64-codierten Text an. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 131072. Erforderlich: Nein ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) ** Das Kerberos-Prinzipal mit Zugriff auf die Dateien und Ordner im HDFS-Cluster. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^.+$` Erforderlich: Nein ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) ** Die URI des Key Management Servers (KMS) des HDFS-Clusters. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` Erforderlich: Nein ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des Quell-HDFS-Cluster-Speicherorts. 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 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) ** Der NameNode , der den HDFS-Namespace verwaltet. Der NameNode führt Operationen wie das Öffnen, Schließen und Umbenennen von Dateien und Verzeichnissen aus. Das NameNode enthält die Informationen zum Zuordnen von Datenblöcken zu. DataNodes Sie können nur einen verwenden NameNode. Typ: Array von [HdfsNameNode](API_HdfsNameNode.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Erforderlich: Nein ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) ** Die Konfiguration der Quality of Protection (QOP, Schutzqualität) legt den Remote Procedure Call (RPC, Remoteprozeduraufruf) und die Datenschutzeinstellungen für die Datenübertragung fest, die auf dem Hadoop Distributed File System (HDFS)-Cluster konfiguriert sind. Typ: [QopConfiguration](API_QopConfiguration.md) Objekt Erforderlich: Nein ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) ** Die Nummer DataNodes , auf die die Daten repliziert werden sollen, wenn in den HDFS-Cluster geschrieben wird. Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Maximalwert ist 512. Erforderlich: Nein ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) ** Der zur Identifizierung des Clients auf dem Host-Betriebssystem verwendete Benutzername. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) ** Ein Unterverzeichnis im HDFS-Cluster. Dieses Unterverzeichnis wird verwendet, um Daten vom HDFS-Cluster zu lesen oder zu schreiben. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) # UpdateLocationNfs Ändert die folgenden Konfigurationsparameter des NFS-Übertragungsorts (Network File System), den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [Konfiguration von Übertragungen mit einem NFS-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html). ## Anforderungssyntax ``` { "LocationArn": "string", "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string" } ``` ## Anforderungsparameter 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_UpdateLocationNfs_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des NFS-Übertragungsorts an, den Sie aktualisieren möchten. 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 ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) ** Gibt an, wie DataSync mithilfe des NFS-Protokolls auf einen Standort zugegriffen werden kann. Typ: [NfsMountOptions](API_NfsMountOptions.md) Objekt Erforderlich: Nein ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) ** Die AWS DataSync Agenten, die eine Verbindung zu Ihrem NFS-Dateiserver (Network File System) herstellen können. Typ: [OnPremConfig](API_OnPremConfig.md) Objekt Erforderlich: Nein ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) ** Gibt den DNS-Namen oder die IP-Adresse (IPv4 oder IPv6) des NFS-Dateiservers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) ** Gibt den Exportpfad auf Ihrem NFS-Dateiserver an, den Sie mounten DataSync möchten. Dieser Pfad (oder ein Unterverzeichnis des Pfads) ist der Ort, an den Daten DataSync übertragen werden oder von diesem Pfad. Informationen zur Konfiguration eines Exports für DataSync finden Sie unter [Zugreifen auf NFS-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]+$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) # UpdateLocationObjectStorage Ändert die folgenden Konfigurationsparameter des Objektspeicher-Übertragungsorts, den Sie mit AWS DataSync verwenden. Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit einem Objektspeichersystem](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html). ## Anforderungssyntax ``` { "AccessKey": "string", "AgentArns": [ "string" ], "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string" } ``` ## Anforderungsparameter 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. ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt den Zugriffsschlüssel (z. B. einen Benutzernamen) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` Erforderlich: Nein ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) ** (Optional) Gibt die Amazon-Ressourcennamen (ARNs) der DataSync Agenten an, die eine Verbindung zu Ihrem Objektspeichersystem herstellen können. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben. Sie können keine Agenten zu einem Speicherort hinzufügen oder daraus entfernen, nachdem Sie ihn ursprünglich erstellt haben. 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}$` Erforderlich: Nein ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, das für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet wird, und für einen vom AWS KMS key Kunden verwalteten Schlüssel. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf das Geheimnis ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt den ARN des Objekt-Storage-Systemspeicherorts an, den Sie aktualisieren. 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 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt den geheimen Schlüssel (z. B. ein Passwort) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind. Wenn Sie mithilfe von `CmkSecretConfig` oder ein Geheimnis angeben`SecretKey`, aber keine geheimen Konfigurationsdetails angeben`CustomSecretConfig`, DataSync speichert das Token unter Verwendung des Secrets Manager Manager-Geheimnisses Ihres AWS Kontos. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen. Pattern: `^.*$` Erforderlich: Nein ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt eine Zertifikatskette für DataSync die Authentifizierung bei Ihrem Objektspeichersystem an, falls das System eine private oder selbstsignierte Zertifizierungsstelle (CA) verwendet. Sie müssen eine einzelne `.pem` Datei mit einer vollständigen Zertifikatskette angeben (z. B.`file:///home/user/.ssh/object_storage_certificates.pem`). Die Zertifikatskette könnte Folgendes beinhalten: + Das Zertifikat des Objektspeichersystems + Alle Zwischenzertifikate (falls vorhanden) + Das Stammzertifikat der signierenden Zertifizierungsstelle Sie können Ihre Zertifikate zu einer `.pem` Datei zusammenfügen (die vor der Base64-Kodierung bis zu 32768 Byte groß sein kann). Mit dem folgenden `cat` Beispielbefehl wird eine `object_storage_certificates.pem` Datei erstellt, die drei Zertifikate enthält: `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` Um diesen Parameter zu verwenden, konfigurieren Sie `ServerProtocol` auf`HTTPS`. Die Aktualisierung dieses Parameters beeinträchtigt nicht die Aufgaben, die Sie gerade ausführen. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 32768. Erforderlich: Nein ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt den Domänennamen oder die IP-Adresse (IPv4 oder IPv6) des Objektspeicherservers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Erforderlich: Nein ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt den Port an, an dem Ihr Objektspeicher-Server eingehenden Netzwerkverkehr annimmt (z. B. Port 443). Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Höchstwert ist 65536. Erforderlich: Nein ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt das Protokoll an, das Ihr Objektspeicher-Server für die Kommunikation verwendet. Typ: Zeichenfolge Zulässige Werte: `HTTPS | HTTP` Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) ** Gibt das Objekt-Präfix für Ihren Objektspeicher-Server an. Wenn es sich um einen Quellspeicherort handelt, werden DataSync nur Objekte mit diesem Präfix kopiert. Wenn es sich um einen Zielort handelt, werden alle Objekte mit diesem Präfix DataSync geschrieben. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) # UpdateLocationS3 Ändert die folgenden Konfigurationsparameter des Amazon S3 S3-Übertragungsorts, den Sie mit AWS DataSync verwenden. **Wichtig** Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Themen gelesen haben: [Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Bewertung der Kosten für S3-Anfragen bei der Verwendung DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) ## Anforderungssyntax ``` { "LocationArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string" } ``` ## Anforderungsparameter 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_UpdateLocationS3_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) des Amazon S3-Übertragungsorts an, den Sie aktualisieren. 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 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der AWS Identity and Access Management (IAM) -Rolle an, die für den Zugriff auf Ihren S3-Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [ DataSync Zugriff auf S3-Buckets bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Typ: [S3Config](API_S3Config.md) Objekt Erforderlich: Nein ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) ** Gibt die Speicherklasse an, die Ihre Objekte verwenden sollen, wenn Amazon S3 ein Übertragungsziel ist. Für Buckets in ist AWS-Regionen die Speicherklasse standardmäßig auf eingestellt. `STANDARD` Bei aktivierten Buckets ist AWS Outposts die Speicherklasse standardmäßig auf. `OUTPOSTS` Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Typ: Zeichenfolge Zulässige Werte: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) ** Gibt ein Präfix im S3-Bucket an, das DataSync Lese- oder Schreibvorgänge vornimmt (je nachdem, ob es sich bei dem Bucket um einen Quell- oder Zielspeicherort handelt). DataSync kann keine Objekte mit einem Präfix übertragen, das mit einem Schrägstrich (`/`) beginnt oder `/../` Muster einschließt`//`. `/./` Beispiel: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) # UpdateLocationSmb Ändert die folgenden Konfigurationsparameter des SMB-Übertragungsorts (Server Message Block), den Sie mit verwenden. AWS DataSync Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit einem SMB-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html). ## Anforderungssyntax ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "LocationArn": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "User": "string" } ``` ## Anforderungsparameter 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. ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) ** Gibt den DataSync Agenten (oder die Agenten) an, der eine Verbindung zu Ihrem SMB-Dateiserver herstellen kann. Sie geben einen Agenten anhand seines Amazon-Ressourcennamens (ARN) an. 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}$` Erforderlich: Nein ** [AuthenticationType](#API_UpdateLocationSmb_RequestSyntax) ** Gibt das Authentifizierungsprotokoll an, das für die Verbindung mit Ihrem SMB-Dateiserver DataSync verwendet wird. DataSync unterstützt `NTLM` (Standard) und `KERBEROS` Authentifizierung. Weitere Informationen finden Sie unter [Bereitstellen des DataSync Zugriffs auf SMB-Dateiserver](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Typ: Zeichenfolge Zulässige Werte: `NTLM | KERBEROS` Erforderlich: Nein ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. ein `Password` `KerberosKeytab` oder eine Gruppe von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und für einen vom Kunden verwalteten Schlüssel. AWS KMS key Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel an, z. B. einen `Password` `KerberosKeytab` oder einen Satz von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf den geheimen Schlüssel ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) ** Gibt die IP-Adressen (IPv4 oder IPv6) für die DNS-Server an, zu denen Ihr SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf `KERBEROS` gesetzt `AuthenticationType` ist. Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen SMB-Dateiserver hergestellt wird. 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` Erforderlich: Nein ** [Domain](#API_UpdateLocationSmb_RequestSyntax) ** Gibt den Windows-Domain-Namen an, zu dem SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf gesetzt `AuthenticationType` ist`NTLM`. Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen Dateiserver hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Erforderlich: Nein ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) ** Gibt Ihre Kerberos-Schlüsseltabellendatei (Keytab) an, die Zuordnungen zwischen Ihrem Kerberos-Prinzipal und den Verschlüsselungsschlüsseln enthält. Um Fehler bei der Ausführung von Aufgaben zu vermeiden, stellen Sie sicher, dass der Kerberos-Prinzipal, den Sie zum Erstellen der Keytab-Datei verwenden, genau dem entspricht, wofür Sie es angegeben haben. `KerberosPrincipal` Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 65536. Erforderlich: Nein ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) ** Gibt eine Kerberos-Konfigurationsdatei (`krb5.conf`) an, die Ihre Kerberos-Realm-Konfiguration definiert. Die Datei muss base64-codiert sein. Wenn Sie das verwenden AWS CLI, ist die Kodierung für Sie erledigt. Typ: Base64-kodiertes Binärdatenobjekt Längenbeschränkungen: Die maximale Länge beträgt 131072. Erforderlich: Nein ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) ** Gibt einen Kerberos-Principal an. Dabei handelt es sich um eine Identität in Ihrem Kerberos-Bereich, die berechtigt ist, auf die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver zuzugreifen. Ein Kerberos-Prinzipal könnte wie folgt aussehen. `HOST/kerberosuser@MYDOMAIN.ORG` Bei Prinzipalnamen wird Groß- und Kleinschreibung beachtet. Ihre DataSync Aufgabenausführung schlägt fehl, wenn der Prinzipal, den Sie für diesen Parameter angeben, nicht exakt dem Prinzipal entspricht, den Sie zum Erstellen der Keytab-Datei verwenden. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^.+$` Erforderlich: Nein ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) ** Gibt den ARN des SMB-Standorts an, den Sie aktualisieren möchten. 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 ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) ** Gibt die Version des SMB-Protokolls (Server Message Block) an, das für den Zugriff auf einen SMB-Dateiserver AWS DataSync verwendet wird. Typ: [SmbMountOptions](API_SmbMountOptions.md) Objekt Erforderlich: Nein ** [Password](#API_UpdateLocationSmb_RequestSyntax) ** Gibt das Kennwort des Benutzers an, der Ihren SMB-Dateiserver bereitstellen kann und über Zugriffsrechte auf die Dateien und Ordner verfügt, die an Ihrer Übertragung beteiligt sind. Dieser Parameter gilt nur, wenn er auf `NTLM` gesetzt `AuthenticationType` ist. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) ** Gibt den Domänennamen oder die IP-Adresse (IPv4 oder IPv6) des SMB-Dateiservers an, mit dem Ihr DataSync Agent eine Verbindung herstellt. Wenn Sie die Kerberos-Authentifizierung verwenden, müssen Sie einen Domänennamen angeben. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Erforderlich: Nein ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) ** Gibt den Namen der von Ihrem SMB-Dateiserver exportierten Freigabe an, auf der Daten gelesen oder geschrieben DataSync werden. Sie können ein Unterverzeichnis in den Freigabepfad aufnehmen (z. B.`/path/to/subdirectory`). Stellen Sie sicher, dass andere SMB-Clients in Ihrem Netzwerk diesen Pfad ebenfalls bereitstellen können. Um alle Daten im angegebenen Unterverzeichnis zu kopieren, DataSync müssen Sie in der Lage sein, die SMB-Freigabe zu mounten und auf alle zugehörigen Daten zuzugreifen. Weitere Informationen finden Sie unter [ DataSync Zugriff auf SMB-Dateiserver bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` Erforderlich: Nein ** [User](#API_UpdateLocationSmb_RequestSyntax) ** Gibt den Benutzernamen an, der Ihren SMB-Dateiserver mounten kann und der Zugriff auf die Dateien und Ordner hat, die an Ihrer Übertragung beteiligt sind. Dieser Parameter gilt nur, wenn er auf `NTLM` gesetzt `AuthenticationType` ist. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [ DataSync Zugriff auf SMB-Dateiserver bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) # UpdateTask Aktualisiert die Konfiguration einer *Aufgabe*, die definiert, wo und wie Ihre Daten AWS DataSync übertragen werden. ## Anforderungssyntax ``` { "CloudWatchLogGroupArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "TaskArn": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Anforderungsparameter 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. ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) einer CloudWatch Amazon-Protokollgruppe zur Überwachung Ihrer Aufgabe an. Für Aufgaben im erweiterten Modus müssen Sie den Namen Ihrer Protokollgruppe verwenden`/aws/datasync`. Beispiel: `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` Weitere Informationen finden Sie unter [Überwachen von Datenübertragungen mit CloudWatch Protokollen](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 562. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Erforderlich: Nein ** [Excludes](#API_UpdateTask_RequestSyntax) ** Gibt Ausschlussfilter an, die die Dateien, Objekte und Ordner in Ihrem Quellverzeichnis definieren, die Sie nicht übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [Includes](#API_UpdateTask_RequestSyntax) ** Gibt an, dass Include-Filter die Dateien, Objekte und Ordner an Ihrem Quellspeicherort definieren, die Sie übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** Konfiguriert ein Manifest, bei dem es sich um eine Liste von Dateien oder Objekten handelt, die Sie übertragen DataSync möchten. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Mithilfe eines Manifests angeben, was DataSync übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) soll. Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die IAM-Rolle, die Sie DataSync mit verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Berechtigung. Um eine Manifestkonfiguration zu entfernen, geben Sie diesen Parameter als leer an. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt Erforderlich: Nein ** [Name](#API_UpdateTask_RequestSyntax) ** Gibt den Namen Ihrer Aufgabe an. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ** [Options](#API_UpdateTask_RequestSyntax) ** Gibt an, wie Ihre Übertragungsaufgabe konfiguriert ist. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten während der Übertragung umgegangen wird. Sie können unter anderem auch angeben, wie die Datenintegrität überprüft werden soll, Bandbreitenlimits für Ihre Aufgabe festlegen. Jede Option hat einen Standardwert. Sofern Sie dies nicht möchten, müssen Sie vor dem Aufrufen keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Sie können Ihre Aufgabenoptionen auch für jede Aufgabenausführung überschreiben. Möglicherweise möchten Sie die `LogLevel` für eine einzelne Ausführung anpassen. Typ: [Options](API_Options.md) Objekt Erforderlich: Nein ** [Schedule](#API_UpdateTask_RequestSyntax) ** Gibt einen Zeitplan an, zu dem Ihre Aufgabe ausgeführt werden soll. Weitere Informationen finden Sie unter [Aufgabenplanung](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Typ: [TaskSchedule](API_TaskSchedule.md) Objekt Erforderlich: Nein ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Gibt den ARN der Aufgabe an, die Sie aktualisieren möchten. 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}:task/task-[0-9a-f]{17}$` Erforderlich: Ja ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** Gibt an, wie Sie einen Aufgabenbericht konfigurieren möchten, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Überwachen Ihrer DataSync Übertragungen mit Aufgabenberichten](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die IAM-Rolle, die Sie DataSync mit verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Berechtigung. Um eine Task-Berichtskonfiguration zu entfernen, geben Sie diesen Parameter als leer an. Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) # UpdateTaskExecution Aktualisiert die Konfiguration einer laufenden AWS DataSync Aufgabenausführung. **Anmerkung** Derzeit können Sie nur Änderungen vornehmen`Option`, indem die Bandbreite für die Ausführung einer laufenden oder in der Warteschlange befindlichen Aufgabe gedrosselt wird. `UpdateTaskExecution` ` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) ` ## Anforderungssyntax ``` { "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "TaskExecutionArn": "string" } ``` ## Anforderungsparameter 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. ** [Options](#API_UpdateTaskExecution_RequestSyntax) ** Gibt an, wie Ihre Übertragungsaufgabe konfiguriert ist. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten während der Übertragung umgegangen wird. Sie können unter anderem auch angeben, wie die Datenintegrität überprüft werden soll, Bandbreitenlimits für Ihre Aufgabe festlegen. Jede Option hat einen Standardwert. Sofern Sie dies nicht möchten, müssen Sie vor dem Aufrufen keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Sie können Ihre Aufgabenoptionen auch für jede Aufgabenausführung überschreiben. Möglicherweise möchten Sie die `LogLevel` für eine einzelne Ausführung anpassen. Typ: [Options](API_Options.md) Objekt Erforderlich: Ja ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Aufgabenausführung an, die Sie aktualisieren. 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler 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 Service ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) # Datentypen Die folgenden Datentypen werden unterstützt: + [AgentListEntry](API_AgentListEntry.md) + [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) + [CmkSecretConfig](API_CmkSecretConfig.md) + [CustomSecretConfig](API_CustomSecretConfig.md) + [Ec2Config](API_Ec2Config.md) + [FilterRule](API_FilterRule.md) + [FsxProtocol](API_FsxProtocol.md) + [FsxProtocolNfs](API_FsxProtocolNfs.md) + [FsxProtocolSmb](API_FsxProtocolSmb.md) + [FsxUpdateProtocol](API_FsxUpdateProtocol.md) + [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) + [HdfsNameNode](API_HdfsNameNode.md) + [LocationFilter](API_LocationFilter.md) + [LocationListEntry](API_LocationListEntry.md) + [ManagedSecretConfig](API_ManagedSecretConfig.md) + [ManifestConfig](API_ManifestConfig.md) + [NfsMountOptions](API_NfsMountOptions.md) + [OnPremConfig](API_OnPremConfig.md) + [Options](API_Options.md) + [Platform](API_Platform.md) + [PrivateLinkConfig](API_PrivateLinkConfig.md) + [QopConfiguration](API_QopConfiguration.md) + [ReportDestination](API_ReportDestination.md) + [ReportDestinationS3](API_ReportDestinationS3.md) + [ReportOverride](API_ReportOverride.md) + [ReportOverrides](API_ReportOverrides.md) + [ReportResult](API_ReportResult.md) + [S3Config](API_S3Config.md) + [S3ManifestConfig](API_S3ManifestConfig.md) + [SmbMountOptions](API_SmbMountOptions.md) + [SourceManifestConfig](API_SourceManifestConfig.md) + [TagListEntry](API_TagListEntry.md) + [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) + [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) + [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) + [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) + [TaskExecutionListEntry](API_TaskExecutionListEntry.md) + [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) + [TaskFilter](API_TaskFilter.md) + [TaskListEntry](API_TaskListEntry.md) + [TaskReportConfig](API_TaskReportConfig.md) + [TaskSchedule](API_TaskSchedule.md) + [TaskScheduleDetails](API_TaskScheduleDetails.md) # AgentListEntry Stellt einen einzelnen Eintrag in einer Liste (oder einem Array) von AWS DataSync Agenten dar, wenn Sie den [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)Vorgang aufrufen. ## Inhalt ** AgentArn ** Der Amazon-Ressourcenname (ARN) eines DataSync Agenten. 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}:agent/agent-[0-9a-z]{17}$` Erforderlich: Nein ** Name ** Der Name eines Agenten. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ** Platform ** Die plattformbezogenen Details über den Agenten, wie z. B. die Versionsnummer. Typ: [Platform](API_Platform.md) Objekt Erforderlich: Nein ** Status ** Der Status eines Agenten. + Wenn der Status lautet`ONLINE`, ist der Agent ordnungsgemäß konfiguriert und einsatzbereit. + Wenn der Status lautet`OFFLINE`, hat der Agent seit mindestens fünf DataSync Minuten keinen Kontakt mehr zu Ihnen aufgenommen. Dies kann verschiedene Gründe haben. Weitere Informationen finden Sie unter [Was mache ich, wenn mein Agent offline ist?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) Typ: Zeichenfolge Zulässige Werte: `ONLINE | OFFLINE` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) # AzureBlobSasConfiguration Die SAS-Konfiguration (Shared Access Signature), die AWS DataSync den Zugriff auf Ihren Microsoft Azure Blob Storage ermöglicht. Weitere Informationen finden Sie unter [SAS-Token](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens) für den Zugriff auf Ihren Azure Blob Storage. ## Inhalt ** Token ** Gibt ein SAS-Token an, das Berechtigungen für den Zugriff auf Ihren Azure Blob Storage bereitstellt. Das Token ist Teil der SAS-URI-Zeichenfolge, die nach dem Speicherressourcen-URI und einem Fragezeichen steht. Ein Token sieht ungefähr so aus: `sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D` Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^.+$` Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) # CmkSecretConfig Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken, einen geheimen Schlüssel, ein Passwort oder eine Kerberos-Keytab, die für den Zugriff auf einen bestimmten Speicherort DataSync verwendet wird, mit einem vom Kunden verwalteten. AWS KMS key **Anmerkung** Sie können entweder `CmkSecretConfig` oder verwenden, um Anmeldeinformationen `CustomSecretConfig` für eine Anfrage bereitzustellen. `CreateLocation` Geben Sie nicht beide Parameter für dieselbe Anfrage an. ## Inhalt ** KmsKeyArn ** Gibt den ARN für das vom Kunden verwaltete Objekt an AWS KMS key , das zur Verschlüsselung des gespeicherten DataSync -verwalteten Geheimnisses DataSync verwendet wird. `SecretArn` DataSync stellt diesen Schlüssel bereit für. AWS Secrets Manager Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$` Erforderlich: Nein ** SecretArn ** Gibt den ARN für das DataSync -managed AWS Secrets Manager secret an, das für den Zugriff auf einen bestimmten Speicherort verwendet wird. Diese Eigenschaft wird von generiert DataSync und ist schreibgeschützt. DataSync verschlüsselt dieses Geheimnis mit dem KMS-Schlüssel, den Sie angeben. `KmsKeyArn` Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) # CustomSecretConfig Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Secrets Manager-Geheimnis an, bei dem Anmeldeinformationen für einen Speicherort in Secrets Manager als Klartext (für Authentifizierungstoken, geheimen Schlüssel oder Passwort) oder als Binärdatei (für Kerberos-Keytab) gespeichert werden. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. **Anmerkung** Sie können entweder `CmkSecretConfig` oder verwenden`CustomSecretConfig`, um Anmeldeinformationen für eine `CreateLocation` Anfrage bereitzustellen. Geben Sie nicht beide Parameter für dieselbe Anfrage an. ## Inhalt ** SecretAccessRoleArn ** Gibt den ARN für die AWS Identity and Access Management Rolle an, die für den Zugriff auf das angegebene Geheimnis DataSync verwendet wird`SecretArn`. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$` Erforderlich: Nein ** SecretArn ** Gibt den ARN für ein AWS Secrets Manager Geheimnis an. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) # Ec2Config Das Subnetz und die Sicherheitsgruppen, die für die Verbindung zu einem der [Mount-Ziele](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) Ihres Amazon EFS-Dateisystems AWS DataSync verwendet werden. ## Inhalt ** SecurityGroupArns ** Gibt die Amazon-Ressourcennamen (ARNs) der Sicherheitsgruppen an, die dem Mount-Ziel eines Amazon EFS-Dateisystems zugeordnet sind. Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Ja ** SubnetArn ** Gibt den ARN eines Subnetzes an, in dem die [Netzwerkschnittstellen](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) für die Verwaltung des Datenverkehrs während Ihrer Übertragung DataSync erstellt werden. Befinden muss sich das Subnetz: + In derselben Virtual Private Cloud (VPC) wie das Amazon-EFS-Dateisystem. + In derselben Availability Zone wie mindestens ein Bereitstellungsziel für das Amazon-EFS-Dateisystem. Sie müssen kein Subnetz angeben, das ein Bereitstellungsziel für das Dateisystem enthält. 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):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$` Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) # FilterRule Gibt an, welche Dateien, Ordner und Objekte beim Übertragen von Dateien von der Quelle zum Ziel eingeschlossen oder ausgeschlossen werden sollen. ## Inhalt ** FilterType ** Der Typ der anzuwendenden Filterregel. AWS DataSync unterstützt nur den Regeltyp SIMPLE\$1PATTERN. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^[A-Z0-9_]+$` Zulässige Werte: `SIMPLE_PATTERN` Erforderlich: Nein ** Value ** Eine einzelne Filterzeichenfolge, die aus den einzubeziehenden oder auszuschließenden Mustern besteht. Die Muster werden durch „\$1“ (also eine Pipe) begrenzt, zum Beispiel: `/folder1|/folder2` Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 102400. Pattern: `^[^\x00]+$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) # FsxProtocol Gibt das Datenübertragungsprotokoll an, das für den Zugriff auf Ihr FSx Amazon-Dateisystem AWS DataSync verwendet wird. ## Inhalt ** NFS ** Gibt die NFS-Protokollkonfiguration (Network File System) an, die für den Zugriff auf Ihr OpenZFS-Dateisystem oder FSx FSx für die virtuelle Speichermaschine (SVM) des ONTAP-Dateisystems DataSync verwendet wird. Typ: [FsxProtocolNfs](API_FsxProtocolNfs.md) Objekt Erforderlich: Nein ** SMB ** Gibt die SMB-Protokollkonfiguration (Server Message Block) an, die FSx für den Zugriff auf die SVM Ihres ONTAP-Dateisystems DataSync verwendet wird. Typ: [FsxProtocolSmb](API_FsxProtocolSmb.md) Objekt Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) # FsxProtocolNfs Gibt die NFS-Protokollkonfiguration (Network File System) an, die für den Zugriff auf Ihr OpenZFS-Dateisystem oder FSx FSx für die virtuelle Speichermaschine (SVM) des ONTAP-Dateisystems DataSync verwendet wird. ## Inhalt ** MountOptions ** Gibt an, wie mithilfe des DataSync NFS-Protokolls auf einen Speicherort zugegriffen werden kann. Typ: [NfsMountOptions](API_NfsMountOptions.md) Objekt Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) # FsxProtocolSmb Gibt die SMB-Protokollkonfiguration (Server Message Block) an, die für den Zugriff auf die virtuelle Speichermaschine (SVM) Ihres Amazon FSx for NetApp ONTAP-Dateisystems AWS DataSync verwendet wird. Weitere Informationen finden Sie unter [Bereitstellen des DataSync Zugriffs auf FSx ONTAP-Dateisysteme](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access). ## Inhalt ** User ** Gibt einen Benutzer an, der die Dateien, Ordner und Metadaten in Ihrer SVM bereitstellen und darauf zugreifen kann. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [Verwenden des SMB-Protokolls](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Ja ** CmkSecretConfig ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an. Dazu gehört auch das Passwort, das FSx für den Zugriff auf einen bestimmten ONTAP-Speicherort (mithilfe von SMB) DataSync verwendet wird, wobei ein vom Kunden verwalteter Schlüssel verwendet wird. AWS KMS key Wenn Sie diesen Parameter als Teil einer `CreateLocationFsxOntap` Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem, für den `Password` Sie angegeben haben, um ein DataSync verwaltetes Geheimnis zum Speichern der Standortzugriffsanmeldeinformationen zu erstellen. Stellen Sie sicher, dass dieser Benutzer berechtigt DataSync ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen. Weitere Informationen finden Sie unter [Verwenden eines vom Dienst verwalteten Geheimnisses, das mit einem benutzerdefinierten AWS KMS key verschlüsselt](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) ist. Sie können entweder `CmkSecretConfig` (mit`Password`) oder `CustomSecretConfig` (ohne`Password`) verwenden, um Anmeldeinformationen für eine `CreateLocationFsxOntap` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** CustomSecretConfig ** Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Secrets Manager-Geheimnis an, bei dem das Passwort FSx für einen ONTAP-Speicherort (mit SMB) im Klartext in Secrets Manager gespeichert wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Weitere Informationen finden Sie unter [Verwenden eines von Ihnen verwalteten Geheimnisses](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Sie können entweder `CmkSecretConfig` (mit`Password`) oder `CustomSecretConfig` (ohne`Password`) verwenden, um Anmeldeinformationen für eine `CreateLocationFsxOntap` Anfrage anzugeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** Domain ** Gibt den Namen der Windows-Domäne an, zu der Ihre virtuelle Speichermaschine (SVM) gehört. Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieser Einstellung sichergestellt, dass die DataSync Verbindung zur richtigen SVM hergestellt wird. Wenn Sie mehrere Active Directory-Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass die DataSync Verbindung zur richtigen SVM hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` Erforderlich: Nein ** ManagedSecretConfig ** Beschreibt die Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis, z. B. ein, `Password` 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 Geben Sie dies nicht für eine `CreateLocation` Anfrage an. `ManagedSecretConfig`ist eine ReadOnly Eigenschaft und wird nur in der `DescribeLocation` Antwort angegeben. Typ: [ManagedSecretConfig](API_ManagedSecretConfig.md) Objekt Erforderlich: Nein ** MountOptions ** Gibt die Version des SMB-Protokolls (Server Message Block) an, das für den Zugriff auf einen SMB-Dateiserver AWS DataSync verwendet wird. Typ: [SmbMountOptions](API_SmbMountOptions.md) Objekt Erforderlich: Nein ** Password ** Gibt das Passwort eines Benutzers an, der berechtigt ist, auf Ihre SVM zuzugreifen. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) # FsxUpdateProtocol Gibt das Datenübertragungsprotokoll an, das für den Zugriff auf Ihr FSx Amazon-Dateisystem AWS DataSync verwendet wird. **Anmerkung** Sie können die NFS-Protokollkonfiguration (Network File System) FSx für ONTAP-Standorte nicht aktualisieren. DataSync unterstützt derzeit nur NFS Version 3 mit diesem Speicherortyp. ## Inhalt ** NFS ** Gibt die NFS-Protokollkonfiguration (Network File System) an, die für den Zugriff auf Ihr OpenZFS-Dateisystem oder FSx FSx für die virtuelle Speichermaschine (SVM) des ONTAP-Dateisystems DataSync verwendet wird. Typ: [FsxProtocolNfs](API_FsxProtocolNfs.md) Objekt Erforderlich: Nein ** SMB ** Gibt die SMB-Protokollkonfiguration (Server Message Block) an, die FSx für den Zugriff auf die DataSync virtuelle Speichermaschine (SVM) Ihres ONTAP-Dateisystems verwendet wird. Typ: [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) Objekt Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) # FsxUpdateProtocolSmb Gibt die SMB-Protokollkonfiguration (Server Message Block) an, die für den Zugriff auf die virtuelle Speichermaschine (SVM) Ihres Amazon FSx for NetApp ONTAP-Dateisystems AWS DataSync verwendet wird. Weitere Informationen finden Sie unter [Bereitstellen des DataSync Zugriffs auf FSx ONTAP-Dateisysteme](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access). ## Inhalt ** CmkSecretConfig ** Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. für einen `Password` oder mehrere Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und für einen vom Kunden verwalteten Schlüssel. AWS KMS key Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt Erforderlich: Nein ** CustomSecretConfig ** Gibt Konfigurationsinformationen für einen vom Kunden verwalteten geheimen Schlüssel an, z. B. einen `Password` oder mehrere Anmeldeinformationen, der für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht. Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt Erforderlich: Nein ** Domain ** Gibt den Namen der Windows-Domäne an, zu der Ihre virtuelle Speichermaschine (SVM) gehört. Wenn Sie mehrere Active Directory-Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zur richtigen SVM hergestellt wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 253. Pattern: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$` Erforderlich: Nein ** MountOptions ** Gibt die Version des SMB-Protokolls (Server Message Block) an, das für den Zugriff auf einen SMB-Dateiserver AWS DataSync verwendet wird. Typ: [SmbMountOptions](API_SmbMountOptions.md) Objekt Erforderlich: Nein ** Password ** Gibt das Passwort eines Benutzers an, der berechtigt ist, auf Ihre SVM zuzugreifen. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^.{0,104}$` Erforderlich: Nein ** User ** Gibt einen Benutzer an, der die Dateien, Ordner und Metadaten in Ihrer SVM bereitstellen und darauf zugreifen kann. Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter [Verwenden des SMB-Protokolls](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 104. Pattern: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) # HdfsNameNode Das NameNode des Hadoop Distributed File System (HDFS). Das NameNode verwaltet den Namespace des Dateisystems. Der NameNode führt Operationen wie das Öffnen, Schließen und Umbenennen von Dateien und Verzeichnissen aus. Das NameNode enthält die Informationen zum Zuordnen von Datenblöcken zu. DataNodes ## Inhalt ** Hostname ** Der Hostname des NameNode im HDFS-Cluster. Dieser Wert ist die IP-Adresse oder der Name des Domain Name Service (DNS) von. NameNode Ein lokal installierter Agent verwendet diesen Hostnamen für die Kommunikation mit dem NameNode im Netzwerk. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$` Erforderlich: Ja ** Port ** Der Port, den der NameNode verwendet, um Client-Anfragen abzuhören. Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Der Maximalwert ist 65536. Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) # LocationFilter Grenzen Sie die Liste der zurückgegebenen Ressourcen ein von`ListLocations`. Um beispielsweise alle Ihre Amazon S3 S3-Standorte zu sehen, erstellen Sie einen Filter mit `"Name": "LocationType"``"Operator": "Equals"`, und`"Values": "S3"`. Weitere Informationen finden Sie unter [Ressourcen filtern](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html). ## Inhalt ** Name ** Der Name des verwendeten Filters. Jeder API-Aufruf unterstützt eine Liste von Filtern, die für ihn verfügbar sind (z. B. `LocationType` für`ListLocations`). Typ: Zeichenfolge Zulässige Werte: `LocationUri | LocationType | CreationTime` Erforderlich: Ja ** Operator ** Der Operator, der zum Vergleichen von Filterwerten verwendet wird (z. B. `Equals` oder`Contains`). Typ: Zeichenfolge Zulässige Werte: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith` Erforderlich: Ja ** Values ** Die Werte, nach denen Sie filtern möchten. Beispielsweise möchten Sie möglicherweise nur Amazon S3 S3-Standorte anzeigen. Typ: Zeichenfolgen-Array Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$` Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) # LocationListEntry Stellt einen einzelnen Eintrag in einer Liste von Orten dar. `LocationListEntry`gibt ein Array zurück, das eine Liste von Speicherorten enthält, wenn die [ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)Operation aufgerufen wird. ## Inhalt ** LocationArn ** Der Amazon-Ressourcenname (ARN) des Standorts. Für Network File System (NFS) oder Amazon EFS ist der Speicherort der Exportpfad. Für Amazon S3 ist der Speicherort der Präfixpfad, den Sie mounten und als Stammverzeichnis des Speicherorts verwenden möchten. 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: Nein ** LocationUri ** Stellt eine Liste URIs eines Standorts dar. `LocationUri`gibt ein Array zurück, das eine Liste von Speicherorten enthält, wenn die [ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)Operation aufgerufen wird. Format:`TYPE://GLOBAL_ID/SUBDIR`. TYPE bezeichnet den Typ des Standorts (z. B. `nfs` oder`s3`). GLOBAL\$1ID ist der global eindeutige Bezeichner der Ressource, die hinter dem Standort steht. Ein Beispiel für EFS ist`us-east-2.fs-abcd1234`. Ein Beispiel für Amazon S3 ist der Bucket-Name, wie `myBucket` z. Ein Beispiel für NFS ist eine gültige IPv6 OR-Adresse IPv4 oder ein Hostname, der DNS-konform ist. SUBDIR ist ein gültiger Dateisystempfad, der wie bei der \$1nix-Konvention durch Schrägstriche getrennt wird. Für NFS und Amazon EFS ist dies der Exportpfad zum Mounten des Speicherorts. Für Amazon S3 ist es der Präfixpfad, den Sie bereitstellen und den Sie als Stammverzeichnis des Speicherorts behandeln. 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.:/\-]+$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) # ManagedSecretConfig Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden. DataSync verwendet den standardmäßigen AWS verwalteten KMS-Schlüssel, um dieses Geheimnis zu verschlüsseln. AWS Secrets Manager ## Inhalt ** SecretArn ** Gibt den ARN für ein AWS Secrets Manager Geheimnis an. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) # ManifestConfig Konfiguriert ein Manifest, das eine Liste von Dateien oder Objekten ist, die Sie übertragen AWS DataSync möchten. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Angabe der DataSync Übertragungen mithilfe eines Manifests](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). ## Inhalt ** Action ** Gibt an, wofür das Manifest DataSync verwendet wird. Typ: Zeichenfolge Zulässige Werte: `TRANSFER` Erforderlich: Nein ** Format ** Gibt das Dateiformat Ihres Manifests an. Weitere Informationen finden Sie unter [Manifest erstellen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create). Typ: Zeichenfolge Zulässige Werte: `CSV` Erforderlich: Nein ** Source ** Gibt das Manifest an, das Sie verwenden DataSync möchten, und wo es gehostet wird. Sie müssen diesen Parameter angeben, wenn Sie am oder nach dem 7. Februar 2024 ein neues Manifest konfigurieren. Andernfalls erhalten Sie den Statuscode 400 und die `ValidationException` Fehlermeldung, dass Ihnen die IAM-Rolle für DataSync den Zugriff auf den S3-Bucket fehlt, in dem Sie Ihr Manifest hosten. Weitere Informationen finden Sie unter [ DataSync Zugriff auf Ihr Manifest bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access). Typ: [SourceManifestConfig](API_SourceManifestConfig.md) Objekt Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) # NfsMountOptions Gibt an, wie mit dem NFS-Protokoll auf einen Standort zugegriffen werden DataSync kann. ## Inhalt ** Version ** Gibt die NFS-Version an, die Sie beim Mounten Ihrer NFS-Freigabe verwenden möchten DataSync . Wenn der Server die Verwendung der angegebenen Version verweigert, schlägt die Aufgabe fehl. Sie können die folgenden Optionen angeben: + `AUTOMATIC`(Standard): DataSync wählt NFS-Version 4.1. + `NFS3`: Zustandslose Protokollversion, die asynchrone Schreibvorgänge auf dem Server erlaubt. + `NFSv4_0`: Zustandsbehaftete, Firewall-freundliche Protokollversion, die Delegationen und Pseudo-Dateisysteme unterstützt. + `NFSv4_1`: Zustandsbehaftete Protokollversion, die Sitzungen, Verzeichnisdelegierungen und parallele Datenverarbeitung unterstützt. Die NFS-Version 4.1 enthält auch alle in Version 4.0 verfügbaren Funktionen. DataSync unterstützt derzeit nur NFS Version 3 mit Amazon FSx für NetApp ONTAP-Standorte. Typ: Zeichenfolge Zulässige Werte: `AUTOMATIC | NFS3 | NFS4_0 | NFS4_1` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) # OnPremConfig Die AWS DataSync Agenten, die eine Verbindung zu Ihrem Network File System (NFS) -Dateiserver herstellen können. ## Inhalt ** AgentArns ** Die Amazon-Ressourcennamen (ARNs) der DataSync Agenten, die eine Verbindung zu Ihrem NFS-Dateiserver herstellen können. Sie können mehr als einen Agenten angeben. Weitere Informationen finden Sie unter [Mehrere DataSync Agenten verwenden](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents). Typ: Zeichenfolgen-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 8 Elementen. 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}$` Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) # Options Zeigt an, wie Ihre Übertragungsaufgabe konfiguriert ist. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten während der Übertragung umgegangen wird. Sie können unter anderem auch angeben, wie die Datenintegrität überprüft werden soll, Bandbreitenlimits für Ihre Aufgabe festlegen. Jede Option hat einen Standardwert. Sofern Sie dies nicht möchten, müssen Sie vor dem Anruf keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Sie können Ihre Aufgabenoptionen auch für jede Aufgabenausführung überschreiben. Möglicherweise möchten Sie die `LogLevel` für eine einzelne Ausführung anpassen. ## Inhalt ** Atime ** Gibt an, ob Metadaten beibehalten werden sollen, die angeben, wann eine Datei zuletzt gelesen oder geschrieben wurde. Das Verhalten von `Atime` ist plattformübergreifend nicht vollständig standardisiert und DataSync kann daher nur nach bestem Wissen und Gewissen durchgeführt werden. + `BEST_EFFORT`(Standard) — DataSync versucht, das ursprüngliche `Atime` Attribut für alle Quelldateien beizubehalten (d. h. die Version vor den `PREPARING` Schritten der Aufgabenausführung). Diese Option wird empfohlen. + `NONE`- Ignoriert. `Atime` Wenn `Atime` auf `BEST_EFFORT` festgelegt ist, muss `Mtime` auf `PRESERVE` festgelegt werden. Wenn `Atime` auf `NONE` festgelegt ist, muss `Mtime` auch `NONE` sein. Typ: Zeichenfolge Zulässige Werte: `NONE | BEST_EFFORT` Erforderlich: Nein ** BytesPerSecond ** Schränkt die von einer DataSync Aufgabe verwendete Bandbreite ein. Wenn Sie beispielsweise maximal 1 MB verwenden DataSync möchten, setzen Sie diesen Wert auf `1048576` (`=1024*1024`). Type: Long Gültiger Bereich: Mindestwert -1. Erforderlich: Nein ** Gid ** Gibt die POSIX-Gruppen-ID (GID) der Eigentümer der Datei an. + `INT_VALUE`(Standard) — Behält den ganzzahligen Wert von Benutzer-ID (UID) und GID bei, was empfohlen wird. + `NONE`- Ignoriert UID und GID. Weitere Informationen finden Sie unter [Grundlegendes zum DataSync Umgang mit Datei- und](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html) Objektmetadaten. Typ: Zeichenfolge Zulässige Werte: `NONE | INT_VALUE | NAME | BOTH` Erforderlich: Nein ** LogLevel ** Gibt den Typ der Protokolle an, die in einer Amazon CloudWatch Logs-Protokollgruppe DataSync veröffentlicht werden. Informationen zur Angabe der Protokollgruppe finden Sie unter [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn). + `BASIC`- Veröffentlicht Protokolle, die nur grundlegende Informationen enthalten (z. B. Übertragungsfehler). + `TRANSFER`- Veröffentlicht Protokolle für alle Dateien oder Objekte, die Ihre DataSync Aufgabe überträgt, und führt Datenintegritätsprüfungen durch. + `OFF`- Es werden keine Protokolle veröffentlicht. Typ: Zeichenfolge Zulässige Werte: `OFF | BASIC | TRANSFER` Erforderlich: Nein ** Mtime ** Gibt an, ob Metadaten beibehalten werden sollen, die angeben, wann vor dem `PREPARING` Schritt Ihrer Aufgabenausführung das letzte Mal in eine Datei geschrieben wurde. Diese Option ist erforderlich, wenn Sie eine Aufgabe mehrmals ausführen müssen. + `PRESERVE`(Standard) — Behält das Original bei`Mtime`, was empfohlen wird. + `NONE`- Ignoriert`Mtime`. Wenn `Mtime` auf `PRESERVE` festgelegt ist, muss `Atime` auf `BEST_EFFORT` festgelegt werden. Wenn `Mtime` auf `NONE` festgelegt ist, muss `Atime` auch auf `NONE` festgelegt werden. Typ: Zeichenfolge Zulässige Werte: `NONE | PRESERVE` Erforderlich: Nein ** ObjectTags ** Gibt an, ob Sie bei der Übertragung zwischen `PRESERVE` Objektspeichersystemen Objekt-Tags verwenden möchten DataSync (Standardverhalten). Wenn Sie möchten, dass Ihre DataSync Aufgabe Objekt-Tags ignoriert, geben Sie den `NONE` Wert an. Typ: Zeichenfolge Zulässige Werte: `PRESERVE | NONE` Erforderlich: Nein ** OverwriteMode ** Gibt an, ob Daten am Zielort geändert oder beibehalten werden DataSync sollen. + `ALWAYS`(Standard) — DataSync ändert Daten am Zielspeicherort, wenn sich Quelldaten (einschließlich Metadaten) geändert haben. Wenn Objekte DataSync überschrieben werden, können zusätzliche Gebühren für bestimmte Amazon S3 S3-Speicherklassen anfallen (z. B. für das Abrufen oder vorzeitiges Löschen). Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `NEVER`- überschreibt DataSync keine Daten am Zielort, selbst wenn sich die Quelldaten geändert haben. Sie können diese Option verwenden, um vor dem Überschreiben von Änderungen zu schützen, die an Dateien oder Objekten im Ziel vorgenommen wurden. Typ: Zeichenfolge Zulässige Werte: `ALWAYS | NEVER` Erforderlich: Nein ** PosixPermissions ** Gibt an, welche Benutzer oder Gruppen für einen bestimmten Zweck auf eine Datei zugreifen können, z. B. zum Lesen, Schreiben oder Ausführen der Datei. Weitere Informationen finden Sie unter [Grundlegendes zum DataSync Umgang mit Datei- und Objektmetadaten](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `PRESERVE`(Standard) — Behält Berechtigungen im POSIX-Stil bei, was empfohlen wird. + `NONE`- Ignoriert Berechtigungen im POSIX-Stil. DataSync kann bestehende Berechtigungen eines Quellverzeichnisses beibehalten. Typ: Zeichenfolge Zulässige Werte: `NONE | PRESERVE` Erforderlich: Nein ** PreserveDeletedFiles ** Gibt an, ob Dateien im Zielverzeichnis, die in der Quelle nicht existieren, beibehalten werden sollen. Diese Option kann sich auf Ihre Amazon S3 S3-Speicherkosten auswirken. Wenn Ihre Aufgabe Objekte löscht, fallen für bestimmte Speicherklassen möglicherweise Mindestspeicherdauergebühren an. Ausführliche Informationen finden Sie unter [Überlegungen bei der Arbeit mit Amazon S3 S3-Speicherklassen in DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `PRESERVE`(Standard) — Ignoriert solche Zieldateien, was empfohlen wird. + `REMOVE`- Löscht Zieldateien, die in der Quelle nicht vorhanden sind. Wenn Sie diesen Parameter auf setzen`REMOVE`, können Sie nicht `TransferMode` auf `ALL` setzen. Wenn Sie alle Daten übertragen, wird Ihr Zielort DataSync nicht gescannt und Sie wissen nicht, was gelöscht werden soll. Typ: Zeichenfolge Zulässige Werte: `PRESERVE | REMOVE` Erforderlich: Nein ** PreserveDevices ** Gibt an, ob die Metadaten von Block- und Zeichengeräten am Quellspeicherort beibehalten und die Dateien mit diesem Gerätenamen und den Metadaten am Ziel neu erstellt werden DataSync sollen. DataSync kopiert nur den Namen und die Metadaten solcher Geräte. DataSync kann den tatsächlichen Inhalt dieser Geräte nicht kopieren, da sie keine Endgeräte sind und keine end-of-file (EOF-) Markierung zurückgeben. + `NONE`(Standard) — Ignoriert spezielle Geräte (empfohlen). + `PRESERVE`- Behält die Zeichen- und Blockgeräte-Metadaten bei. Diese Option wird derzeit für Amazon EFS nicht unterstützt. Typ: Zeichenfolge Zulässige Werte: `NONE | PRESERVE` Erforderlich: Nein ** SecurityDescriptorCopyFlags ** Gibt an, welche Komponenten der SMB-Sicherheitsbeschreibung von Quell- in Zielobjekte kopiert werden. Dieser Wert wird nur für Übertragungen zwischen SMB- und FSx Amazon-Dateiserverstandorten oder zwischen zwei Speicherorten FSx für Windows-Dateiserver verwendet. Weitere Informationen finden Sie unter [Grundlegendes zum DataSync Umgang mit Datei- und Objektmetadaten](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `OWNER_DACL`(Standard) — Kopiert für jedes DataSync kopierte Objekt die folgenden Metadaten: + Der Objekteigentümer. + Diskretionäre NTFS-Zugriffskontrolllisten (DACLs), die festlegen, ob Zugriff auf ein Objekt gewährt wird. DataSync kopiert mit dieser Option keine NTFS-Systemzugriffskontrolllisten (SACLs). + `OWNER_DACL_SACL`- Kopiert für jedes DataSync kopierte Objekt die folgenden Metadaten: + Der Besitzer des Objekts. + Diskretionäre NTFS-Zugriffskontrolllisten (DACLs), die festlegen, ob Zugriff auf ein Objekt gewährt wird. + SACLs, die von Administratoren verwendet werden, um Zugriffsversuche auf ein geschütztes Objekt zu protokollieren. Zum Kopieren SACLs müssen dem Windows-Benutzer, der für den Zugriff auf Ihren SMB-Standort DataSync verwendet wird, zusätzliche Berechtigungen erteilt werden. Informationen zur Auswahl eines Benutzers mit den richtigen Berechtigungen finden Sie unter Erforderliche Berechtigungen für [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx für Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) oder [FSx für ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (je nach Art des Speicherorts in Ihrer Übertragung). + `NONE`- Keine der Komponenten der SMB-Sicherheitsbeschreibung wird kopiert. Zielobjekte gehören dem Benutzer, der für den Zugriff auf den Zielort angegeben wurde. DACLs und SACLs werden auf der Grundlage der Konfiguration des Zielservers festgelegt. Typ: Zeichenfolge Zulässige Werte: `NONE | OWNER_DACL | OWNER_DACL_SACL` Erforderlich: Nein ** TaskQueueing ** Gibt an, ob Ihre Übertragungsaufgaben in bestimmten Szenarien, wenn [mehrere Aufgaben ausgeführt](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks) werden, in eine Warteschlange gestellt werden sollen. Dies ist `ENABLED` die Standardeinstellung. Typ: Zeichenfolge Zulässige Werte: `ENABLED | DISABLED` Erforderlich: Nein ** TransferMode ** Gibt an, ob nach einer ersten Kopie nur die Daten (einschließlich Metadaten) DataSync übertragen werden, die sich zwischen den Speicherorten unterscheiden, oder ob bei jeder Ausführung der Aufgabe alle Daten übertragen werden. Wenn Sie wiederkehrende Übertragungen planen, möchten Sie möglicherweise nur die Änderungen übertragen, die sich seit der letzten Ausführung der Aufgabe geändert haben. + `CHANGED`(Standard) — DataSync Kopiert nach der ersten vollständigen Übertragung nur die Daten und Metadaten, die sich zwischen Quell- und Zielort unterscheiden. + `ALL`- DataSync kopiert alles in der Quelle an das Ziel, ohne die Unterschiede zwischen den Speicherorten zu vergleichen. Typ: Zeichenfolge Zulässige Werte: `CHANGED | ALL` Erforderlich: Nein ** Uid ** Gibt die POSIX-Benutzer-ID (UID) des Besitzers der Datei an. + `INT_VALUE`(Standard) — Behält den ganzzahligen Wert von UID und Gruppen-ID (GID) bei, was empfohlen wird. + `NONE`- Ignoriert UID und GID. Weitere Informationen finden Sie unter [Metadaten](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied) kopiert von. DataSync Typ: Zeichenfolge Zulässige Werte: `NONE | INT_VALUE | NAME | BOTH` Erforderlich: Nein ** VerifyMode ** Gibt an, ob und wie die Integrität Ihrer Daten am Ende der Übertragung DataSync überprüft wird. + `ONLY_FILES_TRANSFERRED`(empfohlen) — DataSync berechnet die Prüfsumme der übertragenen Daten (einschließlich Metadaten) am Quellspeicherort. Am Ende der Übertragung DataSync wird dann diese Prüfsumme mit der Prüfsumme verglichen, die anhand dieser Daten am Ziel berechnet wurde. **Anmerkung** Dies ist die Standardoption für Aufgaben [im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Wir empfehlen diese Option bei der Übertragung in die Speicherklassen S3 Glacier Flexible Retrieval oder S3 Glacier Deep Archive. Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `POINT_IN_TIME_CONSISTENT`— DataSync Überprüft am Ende der Übertragung die gesamte Quelle und das Ziel, um sicherzustellen, dass beide Standorte vollständig synchronisiert sind. **Anmerkung** Dies ist die Standardoption für [Aufgaben im Basismodus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) und wird derzeit nicht für Aufgaben im erweiterten Modus unterstützt. Wenn Sie ein [Manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) verwenden, wird DataSync nur gescannt und verifiziert, was im Manifest aufgeführt ist. Sie können diese Option nicht verwenden, wenn Sie zu den Speicherklassen S3 Glacier Flexible Retrieval oder S3 Glacier Deep Archive übertragen. Weitere Informationen finden Sie unter [Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `NONE`- DataSync führt Datenintegritätsprüfungen nur während Ihrer Übertragung durch. Im Gegensatz zu anderen Optionen erfolgt am Ende Ihrer Übertragung keine zusätzliche Überprüfung. Typ: Zeichenfolge Zulässige Werte: `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) # Platform Die plattformbezogenen Details zum AWS DataSync Agenten, z. B. die Versionsnummer. ## Inhalt ** Version ** Die Version des DataSync Agenten. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) # PrivateLinkConfig Gibt an, wie Ihr AWS DataSync Agent AWS mithilfe eines [Virtual Private Cloud (VPC) -Dienstendpunkts](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc) eine Verbindung herstellt. Ein Agent, der einen VPC-Endpunkt verwendet, ist nicht über das öffentliche Internet zugänglich. ## Inhalt ** PrivateLinkEndpoint ** Gibt den VPC-Endpunkt an [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html), zu dem Ihr Agent eine Verbindung herstellt. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Maximale Länge beträgt 15 Zeichen. 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}\z` Erforderlich: Nein ** SecurityGroupArns ** Gibt die Amazon-Ressourcennamen (ARN) der Sicherheitsgruppe an, die den DataSync Zugriff auf Ihren VPC-Endpunkt ermöglicht. Sie können nur einen ARN angeben. Typ: Zeichenfolgen-Array Array-Mitglieder: Feste Anzahl von 1 Element. 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$` Erforderlich: Nein ** SubnetArns ** Gibt den ARN des Subnetzes an, in dem sich Ihr VPC-Endpunkt befindet. Sie können nur einen ARN angeben. Typ: Zeichenfolgen-Array Array-Mitglieder: Feste Anzahl von 1 Element. 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):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$` Erforderlich: Nein ** VpcEndpointId ** Gibt die ID des VPC-Endpunkts an, mit dem Ihr Agent eine Verbindung herstellt. Typ: Zeichenfolge Pattern: `^vpce-[0-9a-f]{17}$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) # QopConfiguration Die Konfiguration der Quality of Protection (QOP, Schutzqualität) legt den Remote Procedure Call (RPC, Remoteprozeduraufruf) und die Datenschutzeinstellungen für die Datenübertragung fest, die auf dem Hadoop Distributed File System (HDFS)-Cluster konfiguriert sind. ## Inhalt ** DataTransferProtection ** Die auf dem HDFS-Cluster konfigurierte Einstellung für den Datenübertragungsschutz. Diese Einstellung entspricht Ihrer `dfs.data.transfer.protection`-Einstellung in der `hdfs-site.xml`-Datei auf Ihrem Hadoop-Cluster. Typ: Zeichenfolge Zulässige Werte: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY` Erforderlich: Nein ** RpcProtection ** Die auf dem HDFS-Cluster konfigurierte RPC-Schutzeinstellung. Diese Einstellung entspricht der `hadoop.rpc.protection`-Einstellung in der `core-site.xml`-Datei auf Ihrem Hadoop-Cluster. Typ: Zeichenfolge Zulässige Werte: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) # ReportDestination Gibt an, wo Ihr [Aufgabenbericht DataSync ](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) hochgeladen wird. ## Inhalt ** S3 ** Gibt den Amazon S3 S3-Bucket an, in den Ihr Aufgabenbericht DataSync hochgeladen wird. Typ: [ReportDestinationS3](API_ReportDestinationS3.md) Objekt Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) # ReportDestinationS3 Gibt den Amazon S3 S3-Bucket an, in den Ihr [Aufgabenbericht DataSync ](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) hochgeladen wird. ## Inhalt ** BucketAccessRoleArn ** Gibt den Amazon-Ressourcennamen (ARN) der IAM-Richtlinie an, die das Hochladen eines Aufgabenberichts in Ihren S3-Bucket ermöglicht DataSync . Weitere Informationen finden Sie unter [Zulassen DataSync , einen Aufgabenbericht in einen Amazon S3 S3-Bucket hochzuladen](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Erforderlich: Ja ** S3BucketArn ** Gibt den ARN des S3-Buckets an, in den Ihr Bericht DataSync hochgeladen wird. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 268. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` Erforderlich: Ja ** Subdirectory ** Gibt ein Bucket-Präfix für Ihren Bericht an. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) # ReportOverride Gibt den Detaillierungsgrad für einen bestimmten Aspekt Ihres DataSync [Aufgabenberichts](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) an. ## Inhalt ** ReportLevel ** Gibt an, ob Ihr Aufgabenbericht nur Fehler oder Erfolge und Fehler enthält. Beispielsweise könnte Ihr Bericht hauptsächlich nur das enthalten, was bei Ihrer Übertragung nicht gut gelaufen ist (`ERRORS_ONLY`). Gleichzeitig möchten Sie überprüfen, ob Ihr [Aufgabenfilter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) ordnungsgemäß funktioniert. In diesem Fall können Sie eine Liste der Dateien abrufen, die DataSync erfolgreich übersprungen wurden und ob etwas übertragen wurde, das Sie nicht übertragen haben (`SUCCESSES_AND_ERRORS`). Typ: Zeichenfolge Zulässige Werte: `ERRORS_ONLY | SUCCESSES_AND_ERRORS` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) # ReportOverrides Der Detaillierungsgrad, der in jedem Aspekt Ihres DataSync [Aufgabenberichts](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) enthalten ist. ## Inhalt ** Deleted ** Gibt die Berichtsebene für die Dateien, Objekte und Verzeichnisse an, die DataSync versucht wurden, an Ihrem Zielort zu löschen. Dies gilt nur, wenn Sie [Ihre Aufgabe so konfigurieren](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), dass Daten am Ziel gelöscht werden, die sich nicht in der Quelle befinden. Typ: [ReportOverride](API_ReportOverride.md) Objekt Erforderlich: Nein ** Skipped ** Gibt die Berichtsebene für die Dateien, Objekte und Verzeichnisse an, die während der Übertragung zu überspringen DataSync versucht wurden. Typ: [ReportOverride](API_ReportOverride.md) Objekt Erforderlich: Nein ** Transferred ** Gibt die Berichtsebene für die Dateien, Objekte und Verzeichnisse an, die DataSync versucht haben, zu übertragen. Typ: [ReportOverride](API_ReportOverride.md) Objekt Erforderlich: Nein ** Verified ** Gibt die Berichtsebene für die Dateien, Objekte und Verzeichnisse an, deren Überprüfung am Ende der Übertragung DataSync versucht wurde. Typ: [ReportOverride](API_ReportOverride.md) Objekt Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) # ReportResult Gibt an, ob ein vollständiger [Aufgabenbericht](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) für Ihre Übertragung DataSync erstellt wurde. ## Inhalt ** ErrorCode ** Gibt den Code an, der mit dem Fehler verknüpft ist, falls kein vollständiger Bericht erstellt werden DataSync kann. Typ: Zeichenfolge Erforderlich: Nein ** ErrorDetail ** Enthält Einzelheiten zu Problemen beim Erstellen eines Berichts. Typ: Zeichenfolge Erforderlich: Nein ** Status ** Gibt an, ob noch an Ihrem Bericht gearbeitet DataSync wird, ob ein Bericht erstellt wurde oder ob kein vollständiger Bericht erstellt werden kann. Typ: Zeichenfolge Zulässige Werte: `PENDING | SUCCESS | ERROR` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) # S3Config Gibt den Amazon-Ressourcennamen (ARN) der AWS Identity and Access Management (IAM) -Rolle an, die für den Zugriff auf Ihren S3-Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [ DataSync Zugriff auf S3-Buckets bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). ## Inhalt ** BucketAccessRoleArn ** Gibt den ARN der IAM-Rolle an, die für den Zugriff auf Ihren S3-Bucket DataSync verwendet wird. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) # S3ManifestConfig Gibt den S3-Bucket an, in dem Sie das Manifest hosten, das Sie verwenden AWS DataSync möchten. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Mithilfe eines Manifests angeben, welche DataSync Übertragungen übertragen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) werden. ## Inhalt ** BucketAccessRoleArn ** Gibt die AWS Identity and Access Management (IAM-) Rolle an, die DataSync den Zugriff auf Ihr Manifest ermöglicht. Weitere Informationen finden Sie unter [ DataSync Zugriff auf Ihr Manifest bereitstellen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Erforderlich: Ja ** ManifestObjectPath ** Gibt den Amazon S3 S3-Objektschlüssel Ihres Manifests an. Dies kann ein Präfix enthalten (zum Beispiel`prefix/my-manifest.csv`). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 4096. Pattern: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` Erforderlich: Ja ** S3BucketArn ** Gibt den Amazon-Ressourcennamen (ARN) des S3-Buckets an, in dem Sie Ihr Manifest hosten. Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 268. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` Erforderlich: Ja ** ManifestObjectVersionId ** Gibt die Objektversions-ID des Manifests an, das Sie verwenden DataSync möchten. Wenn Sie dies nicht festlegen, DataSync wird die neueste Version des Objekts verwendet. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 100 Zeichen. Pattern: `^.+$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) # SmbMountOptions Gibt die Version des SMB-Protokolls (Server Message Block) an, das für den Zugriff auf einen SMB-Dateiserver AWS DataSync verwendet wird. ## Inhalt ** Version ** Wählt standardmäßig DataSync automatisch eine SMB-Protokollversion auf der Grundlage der Verhandlungen mit Ihrem SMB-Dateiserver aus. Sie können auch die Verwendung einer bestimmten SMB-Version konfigurieren, aber wir empfehlen, dies nur dann DataSync zu tun, wenn Sie DataSync Probleme haben, automatisch mit dem SMB-Dateiserver zu verhandeln. Dies sind die folgenden Optionen für die Konfigurierung der SMB-Version: + `AUTOMATIC`(Standard): DataSync und der SMB-Dateiserver handeln zwischen 2.1 und 3.1.1 die höchste SMB-Version aus, die sie gegenseitig unterstützen. Dies ist die empfohlene Option. Wenn Sie stattdessen eine bestimmte Version auswählen, die Ihr Dateiserver nicht unterstützt, erhalten Sie möglicherweise eine `Operation Not Supported`-Fehlermeldung. + `SMB3`: Schränkt die Protokollverhandlung nur auf SMB-Version 3.0.2 ein. + `SMB2`: Beschränkt die Protokollaushandlung nur auf SMB-Version 2.1. + `SMB2_0`: Beschränkt die Protokollaushandlung nur auf SMB-Version 2.0. + `SMB1`: Beschränkt die Protokollaushandlung nur auf SMB Version 1.0. **Anmerkung** Die `SMB1` Option ist nicht verfügbar, wenn Sie [einen Amazon FSx for NetApp ONTAP-Standort erstellen](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html). Typ: Zeichenfolge Zulässige Werte: `AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) # SourceManifestConfig Gibt das Manifest an, das Sie verwenden AWS DataSync möchten, und wo es gehostet wird. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Mithilfe eines Manifests angeben, welche DataSync Übertragungen übertragen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) werden. ## Inhalt ** S3 ** Gibt den S3-Bucket an, in dem Sie Ihr Manifest hosten. Typ: [S3ManifestConfig](API_S3ManifestConfig.md) Objekt Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) # TagListEntry Ein Schlüssel-Wert-Paar, das ein einzelnes Tag darstellt, das auf eine AWS Ressource angewendet wurde. ## Inhalt ** Key ** Der Schlüssel für ein AWS Ressourcen-Tag. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:/-]+$` Erforderlich: Ja ** Value ** Der Wert für ein AWS Ressourcen-Tag. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) # TaskExecutionFilesFailedDetail Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung Ihrer Aufgabe nicht vorbereitet, übertragen, überprüft und gelöscht werden können. **Anmerkung** Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Inhalt ** Delete ** Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung der Aufgabe nicht gelöscht werden konnten. Type: Long Erforderlich: Nein ** Prepare ** Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung der Aufgabe nicht vorbereitet werden konnten. Type: Long Erforderlich: Nein ** Transfer ** Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung der Aufgabe nicht übertragen werden konnten. Type: Long Erforderlich: Nein ** Verify ** Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung der Aufgabe nicht überprüft werden konnten. Type: Long Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) # TaskExecutionFilesListedDetail Die Anzahl der Dateien oder Objekte, die DataSync an Ihren Standorten gefunden wurden. **Anmerkung** Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Inhalt ** AtDestinationForDelete ** Die Anzahl der Dateien oder Objekte, die DataSync an Ihrem Zielort gefunden wurden. Dieser Zähler gilt nur, wenn Sie [Ihre Aufgabe so konfigurieren](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling), dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden. Type: Long Erforderlich: Nein ** AtSource ** Die Anzahl der Dateien oder Objekte, die an DataSync Ihrem Quellspeicherort gefunden wurden. + DataSyncListet bei einem [Manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) nur auf, was in Ihrem Manifest enthalten ist (und nicht alles, was sich an Ihrem Quellspeicherort befindet). + Bei einem [Include-Filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) wird nur das DataSync aufgelistet, was dem Filter an Ihrem Quellspeicherort entspricht. + DataSync Listet bei einem Ausschlussfilter alles auf, was sich an Ihrem Quellstandort befindet, bevor der Filter angewendet wird. Type: Long Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) # TaskExecutionFoldersFailedDetail Die Anzahl der Verzeichnisse, DataSync die während der Ausführung Ihrer Aufgabe nicht aufgelistet, vorbereitet, übertragen, verifiziert und gelöscht werden können. **Anmerkung** Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Inhalt ** Delete ** Die Anzahl der Verzeichnisse, die DataSync während der Ausführung Ihrer Aufgabe nicht gelöscht werden konnten. Type: Long Erforderlich: Nein ** List ** Die Anzahl der Verzeichnisse, die DataSync während der Ausführung Ihrer Aufgabe nicht aufgelistet werden konnten. Type: Long Erforderlich: Nein ** Prepare ** Die Anzahl der Verzeichnisse, die DataSync während der Ausführung Ihrer Aufgabe nicht vorbereitet werden konnten. Type: Long Erforderlich: Nein ** Transfer ** Die Anzahl der Verzeichnisse, die DataSync während der Ausführung Ihrer Aufgabe nicht übertragen werden konnten. Type: Long Erforderlich: Nein ** Verify ** Die Anzahl der Verzeichnisse, die DataSync während der Ausführung Ihrer Aufgabe nicht überprüft werden konnten. Type: Long Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) # TaskExecutionFoldersListedDetail Die Anzahl der Verzeichnisse, die DataSync an Ihren Standorten gefunden wurden. **Anmerkung** Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). ## Inhalt ** AtDestinationForDelete ** Die Anzahl der Verzeichnisse, die DataSync an Ihrem Zielort gefunden wurden. Dieser Zähler ist nur relevant, wenn Sie [Ihre Aufgabe so konfigurieren](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling), dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden. Type: Long Erforderlich: Nein ** AtSource ** Die Anzahl der Verzeichnisse, die DataSync an Ihrem Quellspeicherort gefunden wurden. + DataSyncListet bei einem [Manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) nur auf, was in Ihrem Manifest enthalten ist (und nicht alles an Ihrem Quellspeicherort). + Bei einem [Include-Filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) wird nur das DataSync aufgelistet, was dem Filter an Ihrem Quellspeicherort entspricht. + DataSync Listet bei einem Ausschlussfilter alles auf, was sich an Ihrem Quellstandort befindet, bevor der Filter angewendet wird. Type: Long Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) # TaskExecutionListEntry Stellt einen einzelnen Eintrag in einer Liste von AWS DataSync Aufgabenausführungen dar, der mit dem [ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html)Vorgang zurückgegeben wird. ## Inhalt ** Status ** Der Status einer Aufgabenausführung. Weitere Informationen finden Sie unter [Status der Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Typ: Zeichenfolge Zulässige Werte: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` Erforderlich: Nein ** TaskExecutionArn ** Der Amazon-Ressourcenname (ARN) einer Aufgabenausführung. 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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` Erforderlich: Nein ** TaskMode ** Der Aufgabenmodus, den Sie verwenden. Weitere Informationen finden Sie unter [Auswählen eines Aufgabenmodus für Ihre Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) # TaskExecutionResultDetail Stellt detaillierte Informationen über das Ergebnis Ihrer AWS DataSync Aufgabenausführung bereit. ## Inhalt ** ErrorCode ** Ein Fehler, der während der Ausführung Ihrer Aufgabe DataSync aufgetreten ist. Sie können diese Informationen verwenden, um [Probleme zu beheben](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Typ: Zeichenfolge Erforderlich: Nein ** ErrorDetail ** Die ausführliche Beschreibung eines Fehlers, der bei der Ausführung Ihrer Aufgabe DataSync aufgetreten ist. Sie können diese Informationen verwenden, um [Probleme zu beheben](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Typ: Zeichenfolge Erforderlich: Nein ** PrepareDuration ** Die Zeit in Millisekunden, in der Ihre Aufgabe in dem Schritt ausgeführt wurde. `PREPARING` Weitere Informationen finden Sie unter Status der [Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Für Aufgaben im erweiterten Modus ist der Wert immer`0`. Weitere Informationen finden Sie unter [So wird Ihre Datenübertragung DataSync vorbereitet](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares). Type: Long Gültiger Bereich: Mindestwert 0. Erforderlich: Nein ** PrepareStatus ** Der Status des `PREPARING` Schritts für die Ausführung Ihrer Aufgabe. Weitere Informationen finden Sie unter [Status der Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Typ: Zeichenfolge Zulässige Werte: `PENDING | SUCCESS | ERROR` Erforderlich: Nein ** TotalDuration ** Die Zeit in Millisekunden, in der Ihre Aufgabenausführung ausgeführt wurde. Type: Long Gültiger Bereich: Mindestwert 0. Erforderlich: Nein ** TransferDuration ** Die Zeit in Millisekunden, in der Ihre Aufgabe in dem Schritt ausgeführt wurde. `TRANSFERRING` Weitere Informationen finden Sie unter Status der [Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Für Aufgaben im erweiterten Modus ist der Wert immer`0`. Weitere Informationen finden Sie unter [So werden Ihre Daten DataSync übertragen](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers). Type: Long Gültiger Bereich: Mindestwert 0. Erforderlich: Nein ** TransferStatus ** Der Status des `TRANSFERRING` Schritts für Ihre Aufgabenausführung. Weitere Informationen finden Sie unter [Status der Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Typ: Zeichenfolge Zulässige Werte: `PENDING | SUCCESS | ERROR` Erforderlich: Nein ** VerifyDuration ** Die Zeit in Millisekunden, zu der Ihre Aufgabe in dem Schritt ausgeführt wurde. `VERIFYING` Weitere Informationen finden Sie unter Status der [Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Für Aufgaben im erweiterten Modus ist der Wert immer`0`. Weitere Informationen finden Sie unter [So wird die Integrität Ihrer Daten DataSync überprüft](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works). Type: Long Gültiger Bereich: Mindestwert 0. Erforderlich: Nein ** VerifyStatus ** Der Status des `VERIFYING` Schritts für die Ausführung Ihrer Aufgabe. Weitere Informationen finden Sie unter [Status der Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Typ: Zeichenfolge Zulässige Werte: `PENDING | SUCCESS | ERROR` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) # TaskFilter Sie können API-Filter verwenden, um die Liste der von zurückgegebenen Ressourcen einzugrenzen`ListTasks`. Um beispielsweise alle Aufgaben an einem Quellspeicherort abzurufen, können Sie dies `ListTasks` mit dem Filternamen `LocationId` und `Operator Equals` mit dem ARN für den Speicherort verwenden. Weitere Informationen finden Sie unter [ DataSyncRessourcen filtern](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html). ## Inhalt ** Name ** Der Name des verwendeten Filters. Jeder API-Aufruf unterstützt eine Liste von Filtern, die für ihn verfügbar sind. Beispielsweise `LocationId` für `ListTasks`. Typ: Zeichenfolge Zulässige Werte: `LocationId | CreationTime` Erforderlich: Ja ** Operator ** Der Operator, der zum Vergleichen von Filterwerten verwendet wird (z. B. `Equals` oder`Contains`). Typ: Zeichenfolge Zulässige Werte: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith` Erforderlich: Ja ** Values ** Die Werte, nach denen Sie filtern möchten. Beispielsweise möchten Sie möglicherweise nur Aufgaben für einen bestimmten Zielort anzeigen. Typ: Zeichenfolgen-Array Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen. Pattern: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$` Erforderlich: Ja ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) # TaskListEntry Stellt einen einzelnen Eintrag in einer Aufgabenliste dar. `TaskListEntry`gibt ein Array zurück, das eine Liste von Aufgaben enthält, wenn die [ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html)Operation aufgerufen wird. Eine Aufgabe umfasst die zu synchronisierenden Quell- und Zieldateisysteme sowie die für die Aufgaben zu verwendenden Optionen. ## Inhalt ** Name ** Der Name der -Aufgabe. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ** Status ** Der Status der Aufgabe. Typ: Zeichenfolge Zulässige Werte: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` Erforderlich: Nein ** TaskArn ** Der Amazon-Ressourcenname (ARN) der Aufgabe. 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}:task/task-[0-9a-f]{17}$` Erforderlich: Nein ** TaskMode ** Der Aufgabenmodus, den Sie verwenden. Weitere Informationen finden Sie unter [Auswählen eines Aufgabenmodus für Ihre Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) # TaskReportConfig Gibt an, wie Sie einen Aufgabenbericht konfigurieren möchten, der detaillierte Informationen zu Ihrer AWS DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Aufgabenberichte](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). ## Inhalt ** Destination ** Gibt den Amazon S3 S3-Bucket an, in den Ihr Aufgabenbericht DataSync hochgeladen wird. Weitere Informationen finden Sie unter [Aufgabenberichte](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access). Typ: [ReportDestination](API_ReportDestination.md) Objekt Erforderlich: Nein ** ObjectVersionIds ** Gibt an, ob Ihr Aufgabenbericht die neue Version jedes Objekts enthält, das in einen S3-Bucket übertragen wurde. Dies gilt nur, wenn Sie die [Versionierung für Ihren Bucket aktivieren](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html). Denken Sie daran, dass die Dauer Ihrer Aufgabenausführung verlängert `INCLUDE` werden kann, wenn Sie diesen Wert auf festlegen. Typ: Zeichenfolge Zulässige Werte: `INCLUDE | NONE` Erforderlich: Nein ** OutputType ** Gibt den Typ des gewünschten Aufgabenberichts an: + `SUMMARY_ONLY`: Stellt die erforderlichen Details zu Ihrer Aufgabe bereit, einschließlich der Anzahl der übertragenen Dateien, Objekte und Verzeichnisse sowie der Übertragungsdauer. + `STANDARD`: Enthält vollständige Details zu Ihrer Aufgabe, einschließlich einer vollständigen Liste der Dateien, Objekte und Verzeichnisse, die übertragen, übersprungen, verifiziert wurden und mehr. Typ: Zeichenfolge Zulässige Werte: `SUMMARY_ONLY | STANDARD` Erforderlich: Nein ** Overrides ** Passt die Berichtsebene für Aspekte Ihres Aufgabenberichts an. Beispielsweise könnte Ihr Bericht im Allgemeinen nur Fehler enthalten, aber Sie könnten angeben, dass Sie eine Liste mit Erfolgen und Fehlern nur für die Dateien wünschen, die DataSync versucht wurden, an Ihrem Zielort zu löschen. Typ: [ReportOverrides](API_ReportOverrides.md) Objekt Erforderlich: Nein ** ReportLevel ** Gibt an, ob Ihr Aufgabenbericht nur die Fehler bei der Übertragung oder eine Liste der erfolgreichen und nicht erfolgreichen Übertragungen enthalten soll. + `ERRORS_ONLY`: In einem Bericht wird angezeigt, DataSync was nicht übertragen, übersprungen, verifiziert und gelöscht werden konnte. + `SUCCESSES_AND_ERRORS`: Ein Bericht zeigt, DataSync was übertragen, übersprungen, verifiziert und gelöscht werden konnte und was nicht. Typ: Zeichenfolge Zulässige Werte: `ERRORS_ONLY | SUCCESSES_AND_ERRORS` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) # TaskSchedule Konfiguriert Ihre AWS DataSync Aufgabe so, dass sie nach einem [Zeitplan](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) ausgeführt wird (in einem Mindestintervall von 1 Stunde). ## Inhalt ** ScheduleExpression ** Gibt Ihren Task-Zeitplan mithilfe eines Cron- oder Rate-Ausdrucks an. Verwenden Sie Cron-Ausdrücke für Aufgabenpläne, die zu einer bestimmten Uhrzeit und an einem bestimmten Tag ausgeführt werden. Mit dem folgenden Cron-Ausdruck wird beispielsweise ein Aufgabenplan erstellt, der jeden ersten Mittwoch im Monat um 8 Uhr ausgeführt wird: `cron(0 8 * * 3#1)` Verwenden Sie Ratenausdrücke für Aufgabenpläne, die in regelmäßigen Abständen ausgeführt werden. Mit dem folgenden Ratenausdruck wird beispielsweise ein Aufgabenplan erstellt, der alle 12 Stunden ausgeführt wird: `rate(12 hours)` Informationen zur Syntax von Cron- und Rate-Ausdrücken finden Sie im [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\+]*$` Erforderlich: Ja ** Status ** Gibt an, ob Ihr Aufgabenplan aktiviert oder deaktiviert werden soll. Ihr Zeitplan ist standardmäßig aktiviert, aber es kann Situationen geben, in denen Sie ihn deaktivieren müssen. Beispielsweise müssen Sie möglicherweise eine wiederkehrende Übertragung unterbrechen, um ein Problem mit Ihrer Aufgabe zu beheben oder Wartungsarbeiten an Ihrem Speichersystem durchzuführen. DataSync deaktiviert Ihren Zeitplan möglicherweise automatisch, wenn Ihre Aufgabe wiederholt mit demselben Fehler fehlschlägt. Weitere Informationen finden Sie unter [TaskScheduleDetails](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html). Typ: Zeichenfolge Zulässige Werte: `ENABLED | DISABLED` Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) # TaskScheduleDetails Stellt Informationen zu Ihrem AWS DataSync [Aufgabenplan](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) bereit. ## Inhalt ** DisabledBy ** Zeigt an, wie Ihr Taskplan deaktiviert wurde. + `USER`- Ihr Zeitplan wurde manuell mithilfe der [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)Operation oder der DataSync Konsole deaktiviert. + `SERVICE`- Ihr Zeitplan wurde automatisch deaktiviert DataSync, weil die Aufgabe wiederholt mit demselben Fehler fehlschlug. Typ: Zeichenfolge Zulässige Werte: `USER | SERVICE` Erforderlich: Nein ** DisabledReason ** Gibt einen Grund an, warum der Taskplan deaktiviert ist. Wenn Ihr Zeitplan von deaktiviert ist`USER`, wird eine `Manually disabled by user.` Meldung angezeigt. Wenn Ihr Zeitplan von deaktiviert ist`SERVICE`, wird Ihnen eine Fehlermeldung angezeigt, die Ihnen hilft zu verstehen, warum die Aufgabe immer wieder fehlschlägt. Informationen zur Behebung von DataSync Fehlern finden Sie unter [Problembehandlung bei DataSync Übertragungen](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 8192. Pattern: `^[\w\s.,'?!:;\/=|<>()-]*$` Erforderlich: Nein ** StatusUpdateTime ** Gibt an, wann sich der Status Ihres Taskplans das letzte Mal geändert hat. Wenn Ihr Zeitplan beispielsweise aufgrund eines wiederholten Fehlers DataSync automatisch deaktiviert wird, können Sie sehen, wann der Zeitplan deaktiviert wurde. Typ: Zeitstempel Erforderlich: Nein ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) # Häufige Fehler In diesem Abschnitt werden die Fehler aufgeführt, die bei den API-Aktionen aller AWS Dienste häufig auftreten. Informationen zu Fehlern, die spezifisch für eine API-Aktion für diesen Service sind, finden Sie unter dem Thema für diese API-Aktion. **AccessDeniedException** Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion. HTTP Status Code: 400 **IncompleteSignature** Die Anforderungssignatur entspricht nicht den AWS Standards. HTTP Status Code: 400 **InternalFailure** Die Anforderungsverarbeitung ist fehlgeschlagen, da ein unbekannter Fehler, eine Ausnahme oder ein Fehler aufgetreten ist. HTTP Status Code: 500 **InvalidAction** Die angeforderte Aktion oder Operation ist ungültig. Überprüfen Sie, ob die Aktion ordnungsgemäß eingegeben wurde. HTTP Status Code: 400 **InvalidClientTokenId** Das angegebene X.509-Zertifikat oder die angegebene AWS Zugriffsschlüssel-ID ist in unseren Aufzeichnungen nicht vorhanden. HTTP Status Code: 403 **NotAuthorized** Sie haben keine Berechtigung zum Ausführen dieser Aktion. HTTP Status Code: 400 **OptInRequired** Für die AWS Zugriffsschlüssel-ID ist ein Abonnement für den Dienst erforderlich. HTTP Status Code: 403 **RequestExpired** Die Anfrage erreichte den Service mehr als 15 Minuten nach dem Datumsstempel auf der Anfrage oder mehr als 15 Minuten nach dem Ablaufdatum der Anfrage (z. B. bei vorsignierter Anfrage URLs), oder der Datumsstempel auf der Anfrage liegt mehr als 15 Minuten in der future. HTTP Status Code: 400 **ServiceUnavailable** Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen. HTTP Status Code: 503 **ThrottlingException** Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt. HTTP Status Code: 400 **ValidationError** Die Eingabe erfüllt nicht die von einem AWS Dienst angegebenen Einschränkungen. HTTP Status Code: 400 # Geläufige Parameter Die folgende Liste enthält die Parameter, die alle Aktionen zum Signieren von Signature-Version-4-Anforderungen mit einer Abfragezeichenfolge verwenden. Alle aktionsspezifischen Parameter werden im Thema für diese Aktion aufgelistet. Weitere Informationen zu Signature Version 4 finden Sie unter [Signieren von AWS API-Anfragen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) im *IAM-Benutzerhandbuch*. **Action** Die auszuführende Aktion. Typ: Zeichenfolge Erforderlich: Ja **Version** Die API-Version, für die die Anfrage geschrieben wurde, ausgedrückt im Format YYYY-MM-DD. Typ: Zeichenfolge Erforderlich: Ja **X-Amz-Algorithm** Der Hashalgorithmus, den Sie zum Erstellen der Anforderungssignatur verwendet haben. Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen. Typ: Zeichenfolge Zulässige Werte: `AWS4-HMAC-SHA256` Required: Conditional **X-Amz-Credential** Der Wert des Anmeldeinformationsumfangs. Dabei handelt es sich um eine Zeichenfolge, die Ihren Zugriffsschlüssel, das Datum, die gewünschte Region und eine Zeichenfolge zur Beendigung („aws4\$1request“) beinhaltet. Der Wert wird im folgenden Format ausgedrückt: *Zugriffsschlüssel*/*JJJJMMTT*/*Region*/*Service*/aws4\$1request. Weitere Informationen finden Sie im *IAM-Benutzerhandbuch* unter [Erstellen einer signierten AWS API-Anfrage](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html). Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen. Typ: Zeichenfolge Required: Conditional **X-Amz-Date** Das Datum, das zum Erstellen der Signatur verwendet wird. Das Format muss das ISO 8601-Basisformat (JJJJMMTT'T'SSMMSS'Z') sein. Beispielsweise ist die folgende Datums- und Uhrzeitangabe ein gültiger X-Amz-Date Wert:`20120325T120000Z`. Bedingung: X-Amz-Date ist bei allen Anforderungen optional. Damit kann das Datum überschrieben werden, das zum Signieren von Anforderungen verwendet wird. Wenn der Date-Header im ISO 8601-Grundformat angegeben ist, X-Amz-Date ist dies nicht erforderlich. Wenn verwendet X-Amz-Date wird, überschreibt er immer den Wert des Date-Headers. Weitere Informationen finden Sie unter [Elemente einer AWS API-Anforderungssignatur](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) im *IAM-Benutzerhandbuch*. Typ: Zeichenfolge Required: Conditional **X-Amz-Security-Token** Das temporäre Sicherheitstoken, das durch einen Aufruf von AWS -Security-Token-Service (AWS STS) abgerufen wurde. Eine Liste der Services, die temporäre Sicherheits-Anmeldeinformationen von AWS STS unterstützen, finden Sie im *IAM-Benutzerhandbuch* unter [AWS-Services , die mit IAM funktionieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html). Bedingung: Wenn Sie temporäre Sicherheitsanmeldedaten von verwenden AWS STS, müssen Sie das Sicherheitstoken angeben. Typ: Zeichenfolge Required: Conditional **X-Amz-Signature** Gibt die hex-codierte Signatur an, die aus der zu signierenden Zeichenfolge und dem abgeleiteten Signaturschlüssel berechnet wurde. Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen. Typ: Zeichenfolge Required: Conditional **X-Amz-SignedHeaders** Gibt alle HTTP-Header an, die als Teil der kanonischen Anforderung enthalten waren. Weitere Informationen zur Angabe signierter Header finden Sie unter [Erstellen einer signierten AWS API-Anfrage](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) im *IAM-Benutzerhandbuch*. Bedingung: Geben Sie diesen Parameter an, wenn Sie Authentifizierungsinformationen in eine Abfragezeichenfolge anstatt in den HTTP-Autorisierungsheader aufnehmen. Typ: Zeichenfolge Required: Conditional