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. # PutLifecycleConfiguration Verwenden Sie diese Aktion, um den Speicher für Ihr Dateisystem zu verwalten. Eine `LifecycleConfiguration` besteht aus einem oder mehreren `LifecyclePolicy`-Objekten, die Folgendes definieren: + **`TransitionToIA`**— Wann müssen Dateien im Dateisystem vom primären Speicher (Standard-Speicherklasse) in den IA-Speicher (Infrequent Access) verschoben werden? + **`TransitionToArchive`**— Wann werden Dateien im Dateisystem aus ihrer aktuellen Speicherklasse (entweder IA oder Standardspeicher) in den Archivspeicher verschoben. Dateisysteme können nicht in den Archivspeicher übergehen, bevor sie in den IA-Speicher übergegangen sind. Daher TransitionToArchive muss entweder nicht gesetzt werden oder muss später als TransitionTo IA sein. **Anmerkung** Die Speicherklasse Archive ist nur für Dateisysteme verfügbar, die den Elastic Throughput-Modus und den Allzweck-Performance-Modus verwenden. + **`TransitionToPrimaryStorageClass`**— Gibt an, ob Dateien im Dateisystem zurück in den Primärspeicher (Standard-Speicherklasse) verschoben werden sollen, nachdem auf sie im IA- oder Archivspeicher zugegriffen wurde. Weitere Informationen finden Sie unter [Verwalten des Dateisystemspeichers](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). Jedes Amazon-EFS-Dateisystem unterstützt eine Lebenszykluskonfiguration, die für alle Dateien im Dateisystem gilt. Wenn ein `LifecycleConfiguration`-Objekt für das angegebene Dateisystem bereits existiert, ändert ein `PutLifecycleConfiguration`-Aufruf die bestehende Konfiguration. Ein `PutLifecycleConfiguration`-Aufruf mit einem leeren `LifecyclePolicies`-Array im Anfragekörper löscht alle vorhandenen `LifecycleConfiguration`. Geben Sie in der Anfrage Folgendes an: + Die ID für das Dateisystem, für das Sie das Lifecycle Management aktivieren, deaktivieren oder ändern. + Ein `LifecyclePolicies`-Array von `LifecyclePolicy`-Objekten, die festlegen, wann Dateien in den IA-Speicher, in den Archivspeicher und zurück in den Primärspeicher verschoben werden sollen. **Anmerkung** Amazon EFS erfordert, dass jedes `LifecyclePolicy`-Objekt nur einen einzigen Übergang hat, sodass das `LifecyclePolicies`-Array mit separaten `LifecyclePolicy`-Objekten strukturiert werden muss. Weitere Informationen finden Sie in den Beispielanforderungen im folgenden Abschnitt. Diese Operation erfordert Berechtigungen für die Operation `elasticfilesystem:PutLifecycleConfiguration`. Um ein `LifecycleConfiguration` Objekt auf ein verschlüsseltes Dateisystem anzuwenden, benötigen Sie dieselben AWS Key Management Service Berechtigungen wie bei der Erstellung des verschlüsselten Dateisystems. ## Anforderungssyntax ``` PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] } ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) ** Die ID des Dateisystems, für das Sie das `LifecycleConfiguration`-Objekt erstellen (Zeichenfolge). Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` Erforderlich: Ja ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) ** Ein Array von `LifecyclePolicy`-Objekten, die das `LifecycleConfiguration`-Objekt des Dateisystems definieren. Ein `LifecycleConfiguration` Objekt informiert das Lebenszyklusmanagement über Folgendes: + **`TransitionToIA`**— Wann müssen Dateien im Dateisystem vom primären Speicher (Standard-Speicherklasse) in den IA-Speicher (Infrequent Access) verschoben werden? + **`TransitionToArchive`**— Wann werden Dateien im Dateisystem aus ihrer aktuellen Speicherklasse (entweder IA oder Standardspeicher) in den Archivspeicher verschoben. Dateisysteme können nicht in den Archivspeicher übergehen, bevor sie in den IA-Speicher übergegangen sind. Daher TransitionToArchive muss es entweder nicht gesetzt werden oder muss später als TransitionTo IA sein. **Anmerkung** Die Speicherklasse Archive ist nur für Dateisysteme verfügbar, die den Elastic Throughput-Modus und den Allzweck-Performance-Modus verwenden. + **`TransitionToPrimaryStorageClass`**— Gibt an, ob Dateien im Dateisystem zurück in den Primärspeicher (Standard-Speicherklasse) verschoben werden sollen, nachdem auf sie im IA- oder Archivspeicher zugegriffen wurde. Wenn Sie den `put-lifecycle-configuration`-CLI-Befehl oder die `PutLifecycleConfiguration`-API-Aktion verwenden, verlangt Amazon EFS, dass jedes `LifecyclePolicy`-Objekt nur einen einzigen Übergang hat. Das bedeutet, dass `LifecyclePolicies` in einem Anfragetext als ein Array von `LifecyclePolicy`-Objekten strukturiert sein muss, ein Objekt für jeden Speicherübergang. Weitere Informationen finden Sie in den Beispielanforderungen im folgenden Abschnitt. Typ: Array von [LifecyclePolicy](API_LifecyclePolicy.md)-Objekten Array-Mitglieder: Maximale Anzahl von 3 Elementen. Erforderlich: Ja ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "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. ** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) ** Eine Reihe von Richtlinien für das Lebenszyklusmanagement. EFS unterstützt maximal eine Richtlinie pro Dateisystem. Typ: Array von [LifecyclePolicy](API_LifecyclePolicy.md)-Objekten Array-Mitglieder: Maximale Anzahl von 3 Elementen. ## Fehler ** BadRequest ** Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 400 ** FileSystemNotFound ** Wird zurückgegeben, wenn der angegebene `FileSystemId` Wert im Wert des Anforderers nicht vorhanden ist AWS-Konto. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 404 ** IncorrectFileSystemLifeCycleState ** Wird zurückgegeben, wenn der Lebenszyklusstatus des Dateisystems nicht „verfügbar“ ist. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 409 ** InternalServerError ** Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP Status Code: 500 ## Beispiele ### Erstellung einer Lebenszyklus-Konfiguration Im folgenden Beispiel wird mithilfe der `PutLifecycleConfiguration`-Aktion ein `LifecyclePolicy`-Objekt erstellt. In diesem Beispiel wird eine Lebenszyklusrichtlinie erstellt, die EFS anweist, Folgendes zu tun: + Verschieben Sie alle Dateien im Dateisystem, auf die in den letzten 30 Tagen nicht im Standardspeicher zugegriffen wurde, in den IA-Speicher. + Verschieben Sie alle Dateien im Dateisystem, auf die in den letzten 90 Tagen nicht im Standardspeicher zugegriffen wurde, in den Archivspeicher. + Verschieben Sie Dateien zurück in den Standardspeicher, nachdem auf sie im IA- oder Archivspeicher zugegriffen wurde. Die Speicherklasse Archive ist nur für Dateisysteme verfügbar, die den Elastic Throughput-Modus und den Allzweck-Performance-Modus verwenden. Weitere Informationen finden Sie unter [EFS-Speicherklassen](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) und [Verwalten von Dateisystemspeicher](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). #### Beispielanforderung ``` PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] } ``` #### Beispielantwort ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] } ``` ### Beispiel für eine put-lifecycle-configuration CLI-Anfrage Dieses Beispiel veranschaulicht eine Verwendung von PutLifecycleConfiguration. #### Beispielanforderung ``` aws efs put-lifecycle-configuration \ --file-system-id fs-0123456789abcdefb \ --lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"}, {"TransitionToIA":"AFTER_30_DAYS"}, {"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}] --region us-west-2 \ --profile adminuser ``` #### Beispielantwort ``` { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] } ``` ### Lebenszyklusmanagement deaktivieren Das folgende Beispiel deaktiviert das Lebenszyklusmanagement für das angegebene Dateisystem. #### Beispielanforderung ``` PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] } ``` #### Beispielantwort ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] } ``` ## 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/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)