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. # 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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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 Fehlertypen](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)