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:
+ [CreateAccessPoint](API_CreateAccessPoint.md)
+ [CreateFileSystem](API_CreateFileSystem.md)
+ [CreateMountTarget](API_CreateMountTarget.md)
+ [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md)
+ [CreateTags](API_CreateTags.md)
+ [DeleteAccessPoint](API_DeleteAccessPoint.md)
+ [DeleteFileSystem](API_DeleteFileSystem.md)
+ [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md)
+ [DeleteMountTarget](API_DeleteMountTarget.md)
+ [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md)
+ [DeleteTags](API_DeleteTags.md)
+ [DescribeAccessPoints](API_DescribeAccessPoints.md)
+ [DescribeAccountPreferences](API_DescribeAccountPreferences.md)
+ [DescribeBackupPolicy](API_DescribeBackupPolicy.md)
+ [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md)
+ [DescribeFileSystems](API_DescribeFileSystems.md)
+ [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md)
+ [DescribeMountTargets](API_DescribeMountTargets.md)
+ [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md)
+ [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md)
+ [DescribeTags](API_DescribeTags.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md)
+ [PutAccountPreferences](API_PutAccountPreferences.md)
+ [PutBackupPolicy](API_PutBackupPolicy.md)
+ [PutFileSystemPolicy](API_PutFileSystemPolicy.md)
+ [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateFileSystem](API_UpdateFileSystem.md)
+ [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md)
# CreateAccessPoint
Erstellt einen EFS-Zugangspunkt. Ein Zugangspunkt ist eine anwendungsspezifische Ansicht in ein EFS-Dateisystem, die einen Betriebssystembenutzer und eine Gruppe sowie einen Dateisystempfad auf jede über den Zugangspunkt erfolgte Dateisystemanforderung anwendet. Der Betriebssystembenutzer und die Gruppe überschreiben alle vom NFS-Client bereitgestellten Identitätsinformationen. Der Dateisystempfad wird als Stammverzeichnis des Zugangspunkts verfügbar gemacht. Anwendungen, die den Zugangspunkt verwenden, können nur auf Daten in einem eigenen Verzeichnis und die darunter liegende Ebene zugreifen. Ein Dateisystem kann maximal 10.000 Zugriffspunkte haben, sofern Sie keine Erhöhung beantragen. Weitere Informationen finden Sie unter [Mounten eines Dateisystems mithilfe von EFS-Zugangspunkten](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html).
**Anmerkung**
Wenn mehrere Anfragen zur Erstellung von Zugriffspunkten auf demselben Dateisystem schnell hintereinander gesendet werden und das Dateisystem fast die maximale Anzahl an Zugriffspunkten erreicht, kann es bei diesen Anfragen zu einer Drosselung der Antwort kommen. Dadurch wird sichergestellt, dass das Dateisystem den angegebenen Grenzwert nicht überschreitet.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:CreateAccessPoint`.
Zugangspunkte können bei der Erstellung mit einem Tag versehen werden. Wenn Tags in der Aktion angegeben werden, mit der die Zugangspunkte erstellt werden, führt IAM eine zusätzliche Autorisierung für die Aktion `elasticfilesystem:TagResource` aus, um die Berechtigungen der Benutzer zum Erstellen von Tags zu überprüfen. Daher müssen Sie explizite Berechtigungen für die Verwendung der Aktion `elasticfilesystem:TagResource` gewähren. Weitere Informationen finden Sie unter [Erteilen der Berechtigung zum Taggen von Ressourcen während der Erstellung](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).
## Anforderungssyntax
```
POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"FileSystemId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ClientToken](#API_CreateAccessPoint_RequestSyntax) **
Eine Zeichenfolge mit bis zu 64 ASCII-Zeichen, die Amazon EFS verwendet, um eine idempotente Erstellung sicherzustellen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
Erforderlich: Ja
** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) **
Die ID des EFS-Dateisystems, für das der Zugangspunkt Zugang gewährt.
Typ: 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
** [PosixUser](#API_CreateAccessPoint_RequestSyntax) **
Der Betriebssystembenutzer und die Gruppe, die auf alle über den Zugangspunkt getätigten Dateisystemanfragen angewendet wurden.
Typ: [PosixUser](API_PosixUser.md) Objekt
Erforderlich: Nein
** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) **
Gibt das Verzeichnis auf dem EFS-Dateisystem an, das der Zugangspunkt als Stammverzeichnis des Dateisystems für NFS-Clients verfügbar macht, die den Zugangspunkt verwenden. Die Clients, die den Zugangspunkt verwenden, können nur auf das Stammverzeichnis und die darunter liegende Ebene zugreifen. Wenn das angegebene Verzeichnis `RootDirectory` > `Path` nicht vorhanden ist, wird es von EFS unter Anwendung der `CreationInfo`-Einstellungen erstellt, wenn ein Client eine Verbindung zu einem Zugangspunkt herstellt. Wenn Sie ein `RootDirectory` angeben, müssen Sie den `Path` und die `CreationInfo` bereitstellen.
Amazon EFS erstellt nur dann ein Stammverzeichnis, wenn Sie CreationInfo: OwnUid, ownGID und Berechtigungen für das Verzeichnis angegeben haben. Wenn Sie diese Informationen nicht angeben, erstellt Amazon EFS das Stammverzeichnis nicht. Wenn das Stammverzeichnis nicht existiert, schlagen Mount-Versuche beim Zugangspunkt fehl.
Typ: [RootDirectory](API_RootDirectory.md) Objekt
Erforderlich: Nein
** [Tags](#API_CreateAccessPoint_RequestSyntax) **
Erzeugt Tags, die dem Zugangspunkt zugeordnet sind. Jedes Tag ist ein Schlüssel-Wert-Paar, wobei jeder Schlüssel eineindeutig sein muss. Weitere Informationen finden Sie im * AWS Allgemeinen* [Referenzhandbuch unter AWS Ressourcen](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) kennzeichnen.
Typ: Array von [Tag](API_Tag.md)-Objekten
Erforderlich: Nein
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "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.
** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) **
Der eindeutige Amazon-Ressourcenname (ARN), der dem Zugangspunkt zugeordnet ist.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$`
** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) **
Die von Amazon EFS zugewiesene ID des Zugangspunkts.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) **
Die Opaque-Zeichenfolge, die in der Anforderung angegeben wird, um eine idempotente Erstellung zu gewährleisten.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) **
Die ID des EFS-Dateisystems, auf das der Zugangspunkt angewendet wird.
Typ: 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})$`
** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) **
Identifiziert die Lebenszyklusphase des Zugangspunkts.
Typ: Zeichenfolge
Zulässige Werte: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateAccessPoint_ResponseSyntax) **
Der Name dieses Zugangspunkts. Dies ist der Wert des `Name`-Tags.
Typ: Zeichenfolge
** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) **
Identifiziert den AWS-Konto , dem die Access Point-Ressource gehört.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.
Pattern: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) **
Die vollständige POSIX-Identität, einschließlich der Benutzer-ID, der Gruppen-ID und der sekundären Gruppe IDs auf dem Access Point, die für alle Dateioperationen von NFS-Clients verwendet wird, die den Access Point verwenden.
Typ: [PosixUser](API_PosixUser.md) Objekt
** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) **
Das Verzeichnis im EFS-Dateisystem, das der Zugangspunkt als Stammverzeichnis für NFS-Clients verfügbar macht, die den Zugangspunkts verwenden.
Typ: [RootDirectory](API_RootDirectory.md) Objekt
** [Tags](#API_CreateAccessPoint_ResponseSyntax) **
Die mit dem Zugangspunkt verknüpften Tags, dargestellt als ein Array von Tag-Objekten.
Typ: Array von [Tag](API_Tag.md)-Objekten
## Fehler
** AccessPointAlreadyExists **
Wird zurückgegeben, wenn der Zugangspunkt, den Sie erstellen möchten, bereits existiert, und zwar mit dem Erstellungstoken, das Sie in der Anfrage angegeben haben.
** 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
** AccessPointLimitExceeded **
Wird zurückgegeben, wenn die AWS-Konto bereits die maximal zulässige Anzahl von Zugriffspunkten pro Dateisystem erstellt hat. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region).
** 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: 403
** 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
** ThrottlingException **
Wird zurückgegeben, wenn die API-Aktion `CreateAccessPoint` zu schnell aufgerufen wird und sich die Anzahl der Zugangspunkte im Dateisystem dem [Grenzwert von 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region) nähert.
** 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: 429
## 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/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
# CreateFileSystem
Erstellt ein leeres Dateisystem Die Operation erfordert ein Erstellungs-Token in der Anforderung, die Amazon EFS verwendet, um eine idempotente Erstellung zu gewährleisten (der Aufruf der Operation mit demselben Erstellungs-Token hat keine Wirkung). Wenn derzeit kein Dateisystem existiert, das dem des Aufrufers AWS-Konto mit dem angegebenen Erstellungstoken gehört, führt diese Operation Folgendes aus:
+ Erstellt ein leeres Dateisystem Das Dateisystem hat eine von Amazon EFS zugewiesene ID und den anfänglichen Lebenszyklusstatus `creating`.
+ Wird mit der Beschreibung des erstellten Dateisystems zurückgegeben.
Andernfalls gibt diese Operation einen `FileSystemAlreadyExists`-Fehler mit der ID des vorhandenen Dateisystems zurück.
**Anmerkung**
Bei Basis-Anwendungsfällen können Sie eine zufällig generierte UUID für das Erstellungs-Token verwenden.
Mit der idempotenten Operation können Sie den `CreateFileSystem`-Aufruf wiederholen, ohne das Risiko einzugehen, ein zusätzliches Dateisystem zu erstellen. Dies kann passieren, wenn ein erster Aufruf in einer Weise fehlschlägt, bei der ungewiss ist, ob tatsächlich ein Dateisystem erstellt wurde. Ein Beispiel könnte sein, dass ein Timeout für die Transportschicht aufgetreten ist oder Ihre Verbindung zurückgesetzt wurde. Solange Sie dasselbe Erstellungs-Token verwenden, kann der Client bei einer erfolgreichen Erstellung eines Dateisystems über den Fehler `FileSystemAlreadyExists` auf dessen Vorhandensein schließen.
Weitere Informationen finden Sie unter [Erstellen eines Dateisystems](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) im *Amazon Elastic File System-Benutzerhandbuch*.
**Anmerkung**
Der `CreateFileSystem`-Aufruf wird zurückgegeben, während der Lebenszyklusstatus des Dateisystems noch `creating` ist. Sie können den Erstellungsstatus des Dateisystems überprüfen, indem Sie die Operation [DescribeFileSystems](API_DescribeFileSystems.md)aufrufen. Diese gibt unter anderem den Status des Dateisystems zurück.
Diese Operation nimmt einen optionalen Parameter `PerformanceMode` entgegen, den Sie für das Dateisystem wählen. Wir empfehlen `generalPurpose` `PerformanceMode` für alle Dateisysteme. Der `maxIO` Modus ist ein Leistungstyp der vorherigen Generation, der für stark parallelisierte Workloads konzipiert wurde, die höhere Latenzen als der Modus tolerieren können. `generalPurpose` `MaxIO`Der Modus wird für One-Zone-Dateisysteme oder Dateisysteme, die Elastic Throughput verwenden, nicht unterstützt.
Der `PerformanceMode` kann nicht geändert werden, nachdem das Dateisystem erstellt wurde. Weitere Informationen finden Sie unter [Amazon EFS: Leistungsmodi](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).
Sie können den Durchsatzmodus für das Dateisystem mit dem Parameter `ThroughputMode` festlegen.
Nachdem das Dateisystem vollständig erstellt wurde, setzt Amazon EFS seinen Lebenszyklusstatus auf `available`, woraufhin Sie in Ihrer VPC ein oder mehrere Mount-Ziele für das Dateisystem erstellen können. Weitere Informationen finden Sie unter [CreateMountTarget](API_CreateMountTarget.md). Sie mounten Ihr Amazon EFS-Dateisystem mithilfe des Mount-Ziels auf einer EC2 Instance in Ihrer VPC. Weitere Informationen finden Sie unter [Funktionsweise von Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:CreateFileSystem`.
Dateisysteme können bei der Erstellung mit einem Tag versehen werden. Wenn Tags in der Aktion angegeben werden, mit der die Zugangspunkte erstellt werden, führt IAM eine zusätzliche Autorisierung für die Aktion `elasticfilesystem:TagResource` aus, um die Berechtigungen der Benutzer zum Erstellen von Tags zu überprüfen. Daher müssen Sie explizite Berechtigungen für die Verwendung der Aktion `elasticfilesystem:TagResource` gewähren. Weitere Informationen finden Sie unter [Erteilen der Berechtigung zum Taggen von Ressourcen während der Erstellung](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html).
## Anforderungssyntax
```
POST /2015-02-01/file-systems HTTP/1.1
Content-type: application/json
{
"AvailabilityZoneName": "string",
"Backup": boolean,
"CreationToken": "string",
"Encrypted": boolean,
"KmsKeyId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
Geben Sie für One Zone-Dateisysteme die AWS Availability Zone an, in der das Dateisystem erstellt werden soll. Verwenden Sie das Format `us-east-1a`, um die Availability Zone anzugeben. Weitere Informationen zu One Zone-Dateisystemen finden Sie unter [EFS-Dateisystemtypen](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) im *Amazon EFS-Benutzerhandbuch*.
Dateisysteme mit einer Zone sind nicht in allen Availability Zones verfügbar AWS-Regionen , in denen Amazon EFS verfügbar ist.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
Erforderlich: Nein
** [Backup](#API_CreateFileSystem_RequestSyntax) **
Gibt an, ob für das Dateisystem, das Sie erstellen, automatische Backups aktiviert sind. Stellen Sie den Wert auf `true` ein, um automatische Backups zu aktivieren. Wenn Sie ein One-Zone-Dateisystem erstellen, sind automatische Backups standardmäßig aktiviert. Weitere Informationen finden Sie unter [Automatisierte Backups](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) im *Amazon-EFS-Benutzerhandbuch*.
Der Standardwert ist `false`. Wenn Sie jedoch einen `AvailabilityZoneName` angeben, lautet die Standardeinstellung `true`.
AWS Backup ist nicht überall verfügbar AWS-Regionen , wo Amazon EFS verfügbar ist.
Typ: Boolesch
Erforderlich: Nein
** [CreationToken](#API_CreateFileSystem_RequestSyntax) **
Eine Zeichenfolge mit maximal 64 ASCII-Zeichen. Amazon EFS verwendet diese, um eine idempotente Erstellung zu gewährleisten.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
Erforderlich: Ja
** [Encrypted](#API_CreateFileSystem_RequestSyntax) **
Ein boolescher Wert, der, wenn „true“, ein verschlüsseltes Dateisystem erstellt. Wenn Sie ein verschlüsseltes Dateisystem erstellen, haben Sie die Möglichkeit, einen vorhandenen AWS Key Management Service Schlüssel (KMS-Schlüssel) anzugeben. Wenn Sie keinen KMS-Schlüssel angeben, wird der standardmäßige KMS-Schlüssel für Amazon EFS, `/aws/elasticfilesystem`, verwendet, um das verschlüsselte Dateisystem zu schützen.
Typ: Boolesch
Erforderlich: Nein
** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **
Die ID des KMS-Schlüssels zum Schutz des verschlüsselten Dateisystems. Dieser Parameter ist nur erforderlich, wenn Sie einen nicht standardmäßigen KMS-Schlüssel verwenden möchten. Wenn dieser Parameter nicht angegeben ist, wird der standardmäßige KMS-Schlüssel für Amazon EFS verwendet. Sie können die ID des KMS-Schlüssels in den folgenden Formaten angeben:
+ Schlüssel-ID – Eine eindeutige Kennzeichnung des Schlüssels, z. B. `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN – Ein Amazon-Ressourcenname (ARN) für den Schlüssel, z. B. `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Schlüsselalias: Ein zuvor erstellter Anzeigename für einen Schlüssel, z. B. `alias/projectKey1`.
+ Schlüsselalias-ARN – Ein ARN für einen Schlüsselalias, z. B. `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
Wenn Sie dies verwenden`KmsKeyId`, müssen Sie den [CreateFileSystemParameter:Encrypted auf true](#efs-CreateFileSystem-request-Encrypted) setzen.
EFS akzeptiert nur symmetrische KMS-Schlüssel. Sie können für Amazon-EFS-Dateisysteme keine asymmetrischen KMS-Schlüssel verwenden.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen.
Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
Erforderlich: Nein
** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **
Der Leistungsmodus des Dateisystems. Wir empfehlen für alle Dateisysteme den `generalPurpose`-Leistungsmodus. Dateisysteme, die den `maxIO`-Leistungsmodus verwenden, können auf einen höheren Gesamtdurchsatz und mehr Operationen pro Sekunde skaliert werden, wobei bei den meisten Dateioperationen etwas höhere Latenzen auftreten. Der Leistungsmodus kann nach dem Anlegen des Dateisystems nicht mehr geändert werden. Der Modus `maxIO` wird in Dateisystemen, die One-Zone-Speicherklassen verwenden, nicht unterstützt.
Aufgrund der höheren Latenzen pro Vorgang beim Modus „Max. E/A“ empfehlen wir, für alle Dateisysteme den Allzweckleistungsmodus zu verwenden.
Der Standardwert ist `generalPurpose`.
Typ: Zeichenfolge
Zulässige Werte: `generalPurpose | maxIO`
Erforderlich: Nein
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **
Der Durchsatz, gemessen in Mebibyte pro Sekunde (MiBps), den Sie für ein Dateisystem bereitstellen möchten, das Sie gerade erstellen. Erforderlich, wenn `ThroughputMode` auf `provisioned` festgelegt wird. Gültige Werte sind 1—3414 MiBps, wobei die Obergrenze von der Region abhängt. Um diesen Grenzwert zu erhöhen, wenden Sie sich an. Support Weitere Informationen finden Sie unter [Amazon-EFS-Kontingente, die Sie erhöhen können](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) im *Amazon-EFS-Benutzerhandbuch*.
Type: Double
Gültiger Bereich: Mindestwert 1.0.
Erforderlich: Nein
** [Tags](#API_CreateFileSystem_RequestSyntax) **
Wird verwendet, um ein oder mehrere Tags zu erstellen, die dem Dateisystem zugeordnet sind. Jeder Tag ist ein benutzerdefiniertes Schlüssel-Wert-Paar. Name Ihres Dateisystems bei der Erstellung durch Einschließen eines `"Key":"Name","Value":"{value}"`-Schlüssel-Wert-Paars. Jeder Schlüssel muss eindeutig sein. Weitere Informationen finden Sie im * AWS Allgemeinen Referenzhandbuch* unter [AWS Ressourcen taggen](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
Typ: Array von [Tag](API_Tag.md)-Objekten
Erforderlich: Nein
** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **
Gibt den Durchsatzmodus für das Dateisystem an. Der Modus kann `bursting`, `provisioned` oder `elastic` sein. Wenn `ThroughputMode` auf `provisioned` festgelegt ist, müssen Sie zudem einen Wert für `ProvisionedThroughputInMibps` angeben. Nachdem Sie das Dateisystem erstellt haben, können Sie den bereitgestellten Durchsatz des Dateisystems verringern oder mit bestimmten Zeitbeschränkungen zwischen den Durchsatzmodi wechseln. Weitere Informationen finden Sie unter [Angeben des Durchsatzes im Modus „Bereitgestellt“](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) im *Amazon-EFS-Benutzerhandbuch*.
Der Standardwert ist `bursting`.
Typ: Zeichenfolge
Zulässige Werte: `bursting | provisioned | elastic`
Erforderlich: Nein
## Antwortsyntax
```
HTTP/1.1 201
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) **
Die eindeutige und konsistente Kennung der Availability Zone, in der sich das Dateisystem befindet. Sie ist nur für One-Zone-Dateisysteme gültig. `use1-az1`Ist beispielsweise eine Availability Zone ID für die US-East-1 AWS-Region, und sie hat in jedem Fall den gleichen Standort. AWS-Konto
Typ: Zeichenfolge
** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) **
Beschreibt die AWS Availability Zone, in der sich das Dateisystem befindet, und ist nur für One Zone-Dateisysteme gültig. Weitere Informationen finden Sie unter [Verwenden von EFS-Speicherklassen](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) im *Amazon-EFS-Benutzerhandbuch*.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [CreationTime](#API_CreateFileSystem_ResponseSyntax) **
Die Zeit, zu der das Dateisystem erstellt wurde, in Sekunden (seit 1970-01-01T00:00:00Z).
Typ: Zeitstempel
** [CreationToken](#API_CreateFileSystem_ResponseSyntax) **
Die Opaque-Zeichenfolge, die in der Anforderung angegeben wird.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [Encrypted](#API_CreateFileSystem_ResponseSyntax) **
Ein boolescher Wert, der mit True anzeigt, dass das Dateisystem verschlüsselt ist.
Typ: Boolescher Wert
** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **
Der Amazon-Ressourcenname (ARN) für das EFS-Dateisystem, im Format `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Beispiel mit Beispieldaten: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Typ: Zeichenfolge
** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) **
Die von Amazon EFS zugewiesene ID des Dateisystems.
Typ: 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})$`
** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) **
Gibt den Schutz des Dateisystems an.
Typ: [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) Objekt
** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **
Die ID eines, das zum Schutz des verschlüsselten Dateisystems AWS KMS key verwendet wird.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen.
Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) **
Die Lebenszyklusphase des Dateisystems.
Typ: Zeichenfolge
Zulässige Werte: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateFileSystem_ResponseSyntax) **
Sie können einem Dateisystem Tags hinzufügen, einschließlich eines `Name`-Tags. Weitere Informationen finden Sie unter [CreateFileSystem](#API_CreateFileSystem). Wenn das Dateisystem über ein `Name`-Tag verfügt, gibt Amazon EFS den Wert in diesem Feld zurück.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) **
Die aktuelle Anzahl von Mounting-Zielen, die das Dateisystem aufweist. Weitere Informationen finden Sie unter [CreateMountTarget](API_CreateMountTarget.md).
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0.
** [OwnerId](#API_CreateFileSystem_ResponseSyntax) **
AWS-Konto Derjenige, der das Dateisystem erstellt hat.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.
Pattern: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) **
Der Leistungsmodus des Dateisystems.
Typ: Zeichenfolge
Zulässige Werte: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **
Die Menge des bereitgestellten Durchsatzes, gemessen in MiBps, für das Dateisystem. Gültig für Dateisysteme, bei denen `ThroughputMode` auf `provisioned` eingestellt ist.
Type: Double
Gültiger Bereich: Mindestwert 1.0.
** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) **
Die letzte bekannte gemessene Größe (in Bytes) der im Dateisystem gespeicherten Daten im Feld `Value` und die Zeit, zu der diese Größe ermittelt wurde, im Feld `Timestamp`. Der Wert `Timestamp` ist die ganzzahlige Anzahl der Sekunden seit 1970-01-01T00:00:00Z. Der Wert `SizeInBytes` steht nicht für die Größe eines konsistenten Snapshots des Dateisystems, ist aber letztlich konsistent, wenn keine Schreibvorgänge im Dateisystem vorgenommen werden. Das heißt, `SizeInBytes` steht nur dann für die tatsächliche Größe, wenn das Dateisystem länger als einige Stunden nicht verändert wurde. Andernfalls entspricht der Wert nicht exakt der Größe, die das Dateisystem zu einem beliebigen Zeitpunkt hatte.
Typ: [FileSystemSize](API_FileSystemSize.md) Objekt
** [Tags](#API_CreateFileSystem_ResponseSyntax) **
Die Tags, die dem Dateisystem zugeordnet sind, dargestellt als ein Array von `Tag`-Objekten.
Typ: Array von [Tag](API_Tag.md)-Objekten
** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) **
Zeigt den Durchsatzmodus des Dateisystems an. Weitere Informationen finden Sie unter [Durchsatzmod](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)i im *Amazon-EFS-Benutzerhandbuch*.
Typ: Zeichenfolge
Zulässige Werte: `bursting | provisioned | elastic`
## 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
** FileSystemAlreadyExists **
Wird zurückgegeben, wenn das Dateisystem, das Sie erstellen möchten, bereits existiert, und zwar mit dem Erstellungstoken, das Sie angegeben haben.
** 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
** FileSystemLimitExceeded **
Wird zurückgegeben, wenn die AWS-Konto bereits die maximal zulässige Anzahl von Dateisystemen pro Konto erstellt hat.
** 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: 403
** InsufficientThroughputCapacity **
Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um zusätzlichen Durchsatz bereitzustellen. Dieser Wert kann zurückgegeben werden, wenn Sie versuchen, ein Dateisystem im Modus „Bereitgestellter Durchsatz“ zu erstellen, wenn Sie versuchen, den bereitgestellten Durchsatz eines vorhandenen Dateisystems zu erhöhen oder wenn Sie versuchen, ein vorhandenes Dateisystem vom Modus „Bursting Throughput“ auf „Bereitgestellter Durchsatz“ umzustellen. Bitte versuchen Sie es später erneut.
** 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: 503
** 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
** ThroughputLimitExceeded **
Wird zurückgegeben, wenn der Durchsatzmodus oder die Menge des bereitgestellten Durchsatzes nicht geändert werden können, weil die Durchsatzgrenze von 1024 erreicht MiB/s wurde.
** 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
** UnsupportedAvailabilityZone **
Wird zurückgegeben, wenn die angeforderte Amazon-EFS-Funktion in der angegebenen Availability Zone 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: 400
## Beispiele
### Erstellen eines verschlüsselten Dateisystems
Im folgenden Beispiel wird eine POST-Anforderung gesendet, um ein Dateisystem in der Region `us-west-2` mit aktivierten automatischen Backups zu erstellen. Die Anforderung gibt `myFileSystem1` als Erstellungstoken für Idempotenz an.
#### Beispielanforderung
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem1",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"Encrypted": true,
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Beispielantwort
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
### Erstellen eines verschlüsselten EFS-Dateisystems mit One-Zone-Verfügbarkeit
Im folgenden Beispiel wird eine POST-Anforderung gesendet, um ein Dateisystem in der Region `us-west-2` mit aktivierten automatischen Backups zu erstellen. Das Dateisystem wird über einen One-Zone-Speicher in der Availability Zone `us-west-2b` verfügen.
#### Beispielanforderung
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem2",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"AvailabilityZoneName": "us-west-2b",
"Encrypted": true,
"ThroughputMode": "elastic",
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Beispielantwort
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"AvailabilityZoneId": "usew2-az2",
"AvailabilityZoneName": "us-west-2b",
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
## 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/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)
# CreateMountTarget
Erstellt ein Mountingziel für ein Dateisystem Anschließend können Sie das Dateisystem mithilfe des Mount-Ziels auf EC2 Instanzen mounten. Weitere Informationen zu Mount-Zielen finden Sie unter [Mount-Ziele verwalten](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html).
Um ein Mount-Ziel für ein EFS-Dateisystem zu erstellen, muss der Lebenszyklusstatus des Dateisystems sein`available`. Weitere Informationen finden Sie unter [DescribeFileSystems](API_DescribeFileSystems.md).
Nach der Erstellung des Mount-Ziels gibt Amazon EFS eine Antwort zurück, die eine `MountTargetId` und eine IP-Adresse (`IpAddress`oder`Ipv6Address`) enthält. Sie verwenden diese IP-Adresse, wenn Sie das Dateisystem in einer EC2 Instance mounten. Sie können außerdem den DNS-Namen des Mount-Ziels beim Mounten des Dateisystems verwenden. Die EC2 Instanz, auf der Sie das Dateisystem mithilfe des Mount-Ziels mounten, kann den DNS-Namen des Mount-Ziels in seine IP-Adresse auflösen. Weitere Informationen finden Sie unter [So funktioniert Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Beachten Sie, dass Sie Mount-Ziele für ein Dateisystem nur in einer VPC erstellen können. Es kann nur ein Mount-Ziel pro Availability Zone geben. Weitere Informationen finden Sie unter [Bereitstellungsziele erstellen](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html).
Wenn die Anfrage die Anforderungen erfüllt, geht Amazon EFS wie folgt vor:
+ Erstellt ein neues Mount-Ziel im angegebenen Subnetz.
+ Erstellt eine neue Netzwerkschnittstelle im Subnetz mit folgenden Eigenschaften:
+ Die Beschreibung`Mount target fsmt-id for file system fs-id `, bei der ` fsmt-id ` es sich um die Mount-Ziel-ID ` fs-id ` handelt, und um die. `FileSystemId`
+ Die `requesterManaged` Eigenschaft der Netzwerkschnittstelle ist auf eingestellt`true`, und der `requesterId` Wert, der auf gesetzt ist`EFS`.
Jedes Mount-Ziel hat eine entsprechende, vom Anforderer verwaltete EC2 Netzwerkschnittstelle. Nachdem die Netzwerkschnittstelle erstellt wurde, setzt Amazon EFS das `NetworkInterfaceId` Feld in der Beschreibung des Mount-Ziels auf die Netzwerkschnittstellen-ID und die IP-Adresse auf deren Adresse. Wenn die Erstellung der Netzwerkschnittstelle fehlschlägt, schlägt die gesamte `CreateMountTarget`-Operation fehl.
**Anmerkung**
Der Aufruf von `CreateMountTarget` gibt erst nach der Erstellung der Netzwerkschnittstelle einen Wert zurück. Da aber der Status des Mountingziel weiterhin `creating` lautet, können Sie ihn durch Aufruf der Operation [DescribeMountTargets](API_DescribeMountTargets.md) überprüfen, die unter anderem den Status des Mountingziels zurückgibt.
Diese Operation erfordert Berechtigungen für die folgende Dateisystemaktion:
+ `elasticfilesystem:CreateMountTarget`
Für diesen Vorgang sind auch Berechtigungen für die folgenden EC2 Amazon-Aktionen erforderlich:
+ `ec2:DescribeSubnets`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:CreateNetworkInterface`
## Anforderungssyntax
```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string",
"IpAddress": "string",
"IpAddressType": "string",
"Ipv6Address": "string",
"SecurityGroups": [ "string" ],
"SubnetId": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
Die ID des Dateisystems, für das das Bereitstellungsziel erstellt werden soll.
Typ: 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
** [IpAddress](#API_CreateMountTarget_RequestSyntax) **
Wenn das `IpAddressType` Mount-Ziel IPv4 (`IPV4_ONLY`oder`DUAL_STACK`) lautet, geben Sie die zu IPv4 verwendende Adresse an. Wenn Sie keine angeben`IpAddress`, wählt Amazon EFS eine ungenutzte IP-Adresse aus dem Subnetz aus, für `SubnetId` das angegeben ist.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Maximale Länge beträgt 15 Zeichen.
Pattern: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
Erforderlich: Nein
** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **
Der IP-Adresstyp für das Mount-Ziel. Die möglichen Werte sind `IPV4_ONLY` (nur IPv4 Adressen), `IPV6_ONLY` (nur IPv6 Adressen) und `DUAL_STACK` (Dual-Stack, beide IPv6 Adressen IPv4 und Adressen). Wenn Sie keinen angeben`IpAddressType`, `IPV4_ONLY` wird verwendet.
Das `IPAddressType` muss dem IP-Typ des Subnetzes entsprechen. Darüber hinaus überschreibt der `IPAddressType` Parameter den Wert, der als Standard-IP-Adresse für das Subnetz in der VPC festgelegt ist. Wenn beispielsweise `IPAddressType` is `IPV4_ONLY` und is`true`, dann `AssignIpv6AddressOnCreation` IPv4 wird es für das Mount-Ziel verwendet. Weitere Informationen finden Sie unter [Ändern des öffentlichen IP-Adressierungsattributs Ihres Subnetzes](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html).
Typ: Zeichenfolge
Zulässige Werte: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`
Erforderlich: Nein
** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **
Wenn das `IPAddressType` für das Einhängeziel IPv6 (`IPV6_ONLY`oder`DUAL_STACK`) lautet, geben Sie die zu verwendende IPv6 Adresse an. Wenn Sie keine angeben`Ipv6Address`, wählt Amazon EFS eine ungenutzte IP-Adresse aus dem Subnetz aus, für `SubnetId` das angegeben ist.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 3. Die maximale Länge beträgt 39.
Erforderlich: Nein
** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **
VPC-Sicherheitsgruppe IDs in der Form`sg-xxxxxxxx`. Diese müssen für dieselbe VPC wie das angegebene Subnetz gelten. Die maximale Anzahl von Sicherheitsgruppen hängt vom Kontingent ab. Weitere Informationen finden Sie unter [Amazon VPC-Kontingente](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) im *Amazon VPC-Benutzerhandbuch* (siehe Tabelle mit **Sicherheitsgruppen**). Wenn Sie keine Sicherheitsgruppe angeben, verwendet Amazon EFS die Standardsicherheitsgruppe für die VPC des Subnetzes.
Typ: Zeichenfolgen-Array
Array-Mitglieder: Maximale Anzahl von 100 Elementen.
Längenbeschränkungen: Mindestlänge von 11. Maximale Länge von 43.
Pattern: `^sg-[0-9a-f]{8,40}`
Erforderlich: Nein
** [SubnetId](#API_CreateMountTarget_RequestSyntax) **
Die ID des Subnetzes, in dem das Bereitstellungsziel hinzugefügt werden soll. Verwenden Sie für One-Zone-Dateisysteme, das Subnetz, das der Availability Zone des Dateisystems zugeordnet ist. Der Subnetztyp muss derselbe Typ sein wie der. `IpAddressType`
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 15 Zeichen. Maximale Länge beträgt 47 Zeichen.
Pattern: `^subnet-[0-9a-f]{8,40}$`
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "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.
** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **
Die eindeutige und konsistente Kennung der Availability Zone, in der sich das Mountingziel befindet. `use1-az1`Ist beispielsweise eine AZ-ID für die Region us-east-1 und sie hat in jeder Region den gleichen Standort. AWS-Konto
Typ: Zeichenfolge
** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **
Der Name der Availability Zone, in der sich das Mountingziel befindet. Availability Zones werden den jeweiligen Namen unabhängig voneinander zugeordnet. AWS-Konto Beispielsweise ist die Availability Zone `us-east-1a` für Sie AWS-Konto möglicherweise nicht derselbe Standort wie `us-east-1a` für eine andere AWS-Konto.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **
Die ID des Dateisystems, für das das Mountingziel erstellt werden soll.
Typ: 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})$`
** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **
Die IPv4 Adresse für das Mount-Ziel.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Maximale Länge beträgt 15 Zeichen.
Pattern: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **
Die IPv6 Adresse für das Mount-Ziel.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 3. Die maximale Länge beträgt 39.
** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **
Der Lebenszyklusstatus des Mounting-Ziels.
Typ: Zeichenfolge
Zulässige Werte: `creating | available | updating | deleting | deleted | error`
** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **
Vom System zugewiesene ID für das Mountingziel.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 13 Zeichen. Maximale Länge beträgt 45 Zeichen.
Pattern: `^fsmt-[0-9a-f]{8,40}$`
** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **
Die ID der Netzwerkschnittstelle, die Amazon EFS bei der Erstellung des Mountingziels erstellt hat.
Typ: Zeichenfolge
** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **
AWS-Konto ID, der die Ressource gehört.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.
Pattern: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **
Die ID des Subnetzes des Mountingziels.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 15 Zeichen. Maximale Länge beträgt 47 Zeichen.
Pattern: `^subnet-[0-9a-f]{8,40}$`
** [VpcId](#API_CreateMountTarget_ResponseSyntax) **
Die ID der Virtual Private Cloud (VPC), in der das Mountingziel konfiguriert ist.
Typ: Zeichenfolge
## Fehler
** AvailabilityZonesMismatch **
Wird zurückgegeben, wenn sich die Availability Zone, die für das Mount-Ziel angegeben wurde, von der Availability Zone des Dateisystems unterscheidet. Weitere Informationen finden Sie unter [Redundanz von regionalem und One-Zone-Speicher](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs).
** 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
** BadRequest **
Wird zurückgegeben, wenn die Anforderung falsch formatiert 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
** IpAddressInUse **
Wird zurückgegeben, wenn in der Anfrage eine IP-Adresse (`IpAddress`oder`Ipv6Address`) angegeben wurde, die bereits im Subnetz verwendet wird.
** 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
** MountTargetConflict **
Wird zurückgegeben, wenn das Mountingziel eine der auf der Grundlage der vorhandenen Mountingziele des Dateisystems angegebenen Einschränkungen verletzen würde.
** 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
** NetworkInterfaceLimitExceeded **
Das aufrufende Konto hat den Grenzwert für elastische Netzwerkschnittstellen für die spezifische AWS-Region erreicht. Löschen Sie entweder einige Netzwerkschnittstellen oder fordern Sie eine Erhöhung des Kontingents an. Weitere Informationen finden Sie unter [Amazon VPC-Kontingente](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) im *Amazon VPC-Benutzerhandbuch* (siehe den Eintrag **Netzwerkschnittstellen pro Region** in der Tabelle **Netzwerkschnittstellen**).
** 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
** NoFreeAddressesInSubnet **
Hat „Nein“ zurückgegeben `IpAddress` oder `Ipv6Address` wurde in der Anfrage angegeben und es gibt keine freien IP-Adressen im angegebenen Subnetz.
** 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
** SecurityGroupLimitExceeded **
Wird zurückgegeben, wenn die in der Anfrage `SecurityGroups` angegebene Anzahl von Daten den Grenzwert überschreitet, der auf dem Kontingent basiert. Löschen Sie entweder einige Sicherheitsgruppen oder fordern Sie eine Erhöhung des Kontokontingents an. Weitere Informationen finden Sie unter [Amazon VPC-Kontingente](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) im *Amazon VPC-Benutzerhandbuch* (siehe Tabelle mit **Sicherheitsgruppen**).
** 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
** SecurityGroupNotFound **
Wird zurückgegeben, wenn eine der angegebenen Sicherheitsgruppen nicht in der Virtual Private Cloud (VPC) des Subnetzes vorhanden 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: 400
** SubnetNotFound **
Wird zurückgegeben, wenn in der Anforderung kein Subnetz mit der ID `SubnetId` angegeben wurde.
** 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
** UnsupportedAvailabilityZone **
Wird zurückgegeben, wenn die angeforderte Amazon-EFS-Funktion in der angegebenen Availability Zone 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: 400
## Beispiele
### Erstellen Sie ein Mount-Ziel an einer verfügbaren IPv4 Adresse in einem Subnetz
Die folgende Anfrage spezifiziert nur das Dateisystem und das Subnetz für das Mount-Ziel. Das Ziel wird an einer verfügbaren IPv4 Adresse im angegebenen Subnetz erstellt, wobei die Standardsicherheitsgruppe der VPC zugeordnet ist.
#### Beispielanforderung
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Erstellen Sie ein Mount-Ziel an einer bestimmten Adresse IPv4
Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz, die Sicherheitsgruppe und die IPv4 Adresse, die für das Mount-Ziel verwendet werden sollen.
#### Beispielanforderung
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Erstellen Sie ein Mount-Ziel an einer bestimmten Adresse IPv6
Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz, die Sicherheitsgruppe und die IPv6 Adresse, die für das Mount-Ziel verwendet werden sollen.
#### Beispielanforderung
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"IpAddressType": "IPV6_ONLY",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Erstellen Sie ein Mount-Ziel an einer verfügbaren IPv4 Adresse im Dual-Stack-Subnetz
Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz und den Adresstyp für das Mount-Ziel. Das Ziel wird an einer verfügbaren IPv4 Adresse im angegebenen Dual-Stack-Subnetz erstellt, wobei die Standardsicherheitsgruppe der VPC zugeordnet ist.
#### Beispielanforderung
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "251839141158",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Erstellen Sie ein Mount-Ziel für ein bestimmtes IPv4 und IPv6 für Adressen im Dual-Stack-Subnetz
Die folgende Anfrage spezifiziert das Dateisystem, das Subnetz, die Sicherheitsgruppe, die Adresse und die IPv4 IPv6 Adresse für das Mount-Ziel. Das Ziel wird an den angegebenen IPv4 IPv6 Adressen in einem Dual-Stack-Subnetz erstellt.
#### Beispielanforderung
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddressType": "DUAL_STACK",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
## 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/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)
# CreateReplicationConfiguration
Erstellt eine Replikationskonfiguration für ein neues oder ein vorhandenes EFS-Dateisystem. Weitere Informationen finden Sie unter [Amazon-EFS-Replikation](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) im *Amazon-EFS-Benutzerhandbuch*. In der Replikationskonfiguration ist Folgendes festgelegt:
+ **Quelldateisystem** — Das EFS-Dateisystem, das Sie replizieren möchten.
+ **Zieldateisystem** — Das Zieldateisystem, in das das Quelldateisystem repliziert wird. In einer Replikationskonfiguration kann es nur ein Zieldateisystem geben.
**Anmerkung**
Ein Dateisystem kann nur Teil einer Replikationskonfiguration sein.
Die Zielparameter für die Replikationskonfiguration hängen davon ab, ob Sie in ein neues Dateisystem oder in ein vorhandenes Dateisystem replizieren und ob Sie über ein anderes Dateisystem replizieren. AWS-Konten Weitere Informationen finden Sie unter [DestinationToCreate](API_DestinationToCreate.md).
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:CreateReplicationConfiguration`. Darüber hinaus sind je nachdem, wie Sie Dateisysteme replizieren, weitere Berechtigungen erforderlich. Weitere Informationen finden Sie unter [Erforderliche Berechtigungen für die Replikation](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) im *Amazon EFS-Benutzerhandbuch*.
## Anforderungssyntax
```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string",
"RoleArn": "string"
}
]
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
Gibt das Amazon-EFS-Dateisystem an, das Sie replizieren möchten. Dieses Dateisystem kann in einer anderen Replikationskonfiguration kein Quell- oder Zieldateisystem sein.
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.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
Ein Array von Objekten, die eine Zielkonfiguration beschreiben. Es wird nur ein Zielkonfigurationsobjekt unterstützt.
Typ: Array von [DestinationToCreate](API_DestinationToCreate.md)-Objekten
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "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_CreateReplicationConfiguration_ResponseSyntax) **
Der Zeitpunkt der Erstellung der Replikationskonfiguration.
Typ: Zeitstempel
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
Ein Array von Zielobjekten. Es wird nur ein Zielobjekt unterstützt.
Typ: Array von [Destination](API_Destination.md)-Objekten
** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Der Amazon-Ressourcenname (ARN) des ursprünglichen EFS-Dateisystems in der Replikationskonfiguration.
Typ: Zeichenfolge
** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Der Amazon-Ressourcenname (ARN) des aktuellen EFS-Dateisystems in der Replikationskonfiguration.
Typ: Zeichenfolge
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
Die ID des Amazon-EFS-Quelldateisystems, das repliziert wird.
Typ: 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})$`
** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID des Dateisystems, AWS-Konto in dem sich das Quelldateisystem befindet.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.
Pattern: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **
Das, AWS-Region in dem sich das EFS-Quelldateisystem befindet.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`
## 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
** ConflictException **
Wird zurückgegeben, wenn das Quelldateisystem in einer Replikation verschlüsselt, das Zieldateisystem jedoch unverschlüsselt 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
** FileSystemLimitExceeded **
Wird zurückgegeben, wenn die AWS-Konto bereits die maximal zulässige Anzahl von Dateisystemen pro Konto erstellt hat.
** 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: 403
** 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
** InsufficientThroughputCapacity **
Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um zusätzlichen Durchsatz bereitzustellen. Dieser Wert kann zurückgegeben werden, wenn Sie versuchen, ein Dateisystem im Modus „Bereitgestellter Durchsatz“ zu erstellen, wenn Sie versuchen, den bereitgestellten Durchsatz eines vorhandenen Dateisystems zu erhöhen oder wenn Sie versuchen, ein vorhandenes Dateisystem vom Modus „Bursting Throughput“ auf „Bereitgestellter Durchsatz“ umzustellen. Bitte versuchen Sie es später erneut.
** 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: 503
** 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
** ReplicationNotFound **
Wird zurückgegeben, wenn das angegebene Dateisystem keine Replikationskonfiguration aufweist.
** ErrorCode **
ReplicationNotFound
** 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
** ThroughputLimitExceeded **
Wird zurückgegeben, wenn der Durchsatzmodus oder die Menge des bereitgestellten Durchsatzes nicht geändert werden können, da die Durchsatzgrenze von 1024 erreicht MiB/s wurde.
** 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
** UnsupportedAvailabilityZone **
Wird zurückgegeben, wenn die angeforderte Amazon-EFS-Funktion in der angegebenen Availability Zone 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: 400
** ValidationException **
Wird zurückgegeben, wenn der AWS Backup Dienst in dem Land, AWS-Region in dem die Anfrage gestellt wurde, 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: 400
## 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/CreateReplicationConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
# CreateTags
**Anmerkung**
VERALTET – `CreateTags` ist veraltet und wird nicht mehr unterstützt. Sie können Tags für EFS-Ressourcen mit der API-Aktion [TagResource](API_TagResource.md) erstellen.
Erstellt oder überschreibt einem Dateisystem zugeordnete Tags Jeder Tag ist ein Schlüssel/Wert-Paar. Wenn ein in der Anforderung angegebener Tag-Schlüssel bereits im Dateisystem vorhanden ist, wird dessen Wert durch diesen Vorgang mit dem in der Anforderung angegebenen Wert überschrieben. Wenn Sie das Tag `Name` zum Dateisystem hinzufügen, gibt Amazon EFS es als Antwort auf den die Operation [DescribeFileSystems](API_DescribeFileSystems.md) zurück.
Diese Operation setzt eine Berechtigung für die `elasticfilesystem:CreateTags`-Aktion voraus.
## Anforderungssyntax
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_CreateTags_RequestSyntax) **
Die ID des Dateisystems, dessen Tags Sie ändern möchten (Zeichenfolge). Durch diese Operation werden nur die Tags geändert, nicht das Dateisystem.
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.
** [Tags](#API_CreateTags_RequestSyntax) **
Ein Array von `Tag`-Objekten, die hinzugefügt werden sollen. Jedes `Tag`-Objekt ist ein Schlüssel-Wert-Paar.
Typ: Array von [Tag](API_Tag.md)-Objekten
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
** 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
## 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/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags)
# DeleteAccessPoint
Löscht den angegebenen Zugangspunkt. Nach Abschluss des Löschvorgangs können sich neue Clients nicht mehr mit den Zugangspunkten verbinden. Clients, die zum Zeitpunkt des Löschvorgangs mit dem Zugangspunkte verbunden waren, funktionieren bis zur Beendigung der Verbindung weiter.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DeleteAccessPoint`.
## Anforderungssyntax
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
Die ID des Zugangspunkts, den Sie löschen möchten.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
Erforderlich: Ja
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
** AccessPointNotFound **
Wird zurückgegeben, wenn der angegebene `AccessPointId` 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
** 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
** 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
## 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/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
# DeleteFileSystem
Löscht ein Dateisystem und verhindert endgültig den Zugriff auf seinen Inhalt Nach der Zurückgabe ist das Dateisystem nicht mehr vorhanden und Sie können nicht auf Inhalte des gelöschten Dateisystems zugreifen.
Sie müssen Mountingziele, die an ein Dateisystem angehängt sind, manuell löschen, bevor Sie ein EFS-Dateisystem löschen können. Dieser Schritt wird für Sie ausgeführt, wenn Sie die AWS Konsole zum Löschen eines Dateisystems verwenden.
**Anmerkung**
Sie können kein Dateisystem löschen, das Teil einer EFS-Replikationskonfiguration ist. Sie müssen zuerst die Replikationskonfiguration löschen.
Verwendete Dateisysteme können nicht gelöscht werden. Das bedeutet, dass Sie gegebenenfalls zuerst die Mountingziele des Dateisystems löschen müssen. Weitere Informationen erhalten Sie unter [DescribeMountTargets](API_DescribeMountTargets.md) und [DeleteMountTarget](API_DeleteMountTarget.md).
**Anmerkung**
Der `DeleteFileSystem`-Aufruf wird zurückgegeben, während der Systemstatus des Dateisystems noch `deleting` lautet. Sie können den Löschstatus des Dateisystems überprüfen, indem Sie den die Operation [DescribeFileSystems](API_DescribeFileSystems.md) aufrufen, die eine Liste der Dateisysteme in Ihrem Konto zurückgibt. Wenn Sie die Dateisystem-ID oder das Erstellungstoken für das gelöschte Dateisystem übergeben, gibt die [DescribeFileSystems](API_DescribeFileSystems.md) den Fehler `404 FileSystemNotFound` zurück.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DeleteFileSystem`.
## Anforderungssyntax
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
Die ID des Dateisystems, das Sie löschen möchten.
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
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
** FileSystemInUse **
Wird zurückgegeben, wenn ein Dateisystem Mountingziele hat.
** 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
** 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
** 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
### Löschen eines Dateisystems
Das folgende Beispiel sendet eine DELETE-Anforderung an den Endpunkt `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`), um ein Dateisystem zu löschen, dessen ID `fs-01234567` lautet.
#### Beispielanforderung
```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## 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/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
# DeleteFileSystemPolicy
Löscht die `FileSystemPolicy` für das angegebene Dateisystem. Die Standardeinstellung für `FileSystemPolicy` wird wirksam, sobald die vorhandene Richtlinie gelöscht wurde. Weitere Informationen zur standardmäßigen Dateisystemrichtlinie finden Sie unter [Verwenden von ressourcenbasierten Richtlinien mit EFS](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html).
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DeleteFileSystemPolicy`.
## Anforderungssyntax
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
Gibt das EFS-Dateisystem an, für das die `FileSystemPolicy` gelöscht werden soll.
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
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
## 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/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
# DeleteMountTarget
Löscht das angegebene Mountingziel
Wenn Sie das gelöschte Mountingziel verwenden, werden bei dieser Operation zwangsweise alle Dateisystem-Mounts aufgehoben. Dies könnte zu einer Störung der Instances oder Anwendungen führen, die diese Mounts verwenden. Um zu verhindern, dass Anwendungen abrupt getrennt werden, sollten Sie erwägen, alle Mounts des Mountingziels aufzuheben, sofern dies möglich ist. Bei dieser Operation wird auch die zugehörige Netzwerkschnittstelle gelöscht. Nicht festgeschriebene Schreibvorgänge können verloren gehen, jedoch bleibt das Dateisystem selbst intakt, wenn ein Mountingziel durch diese Operation aufgehoben wird. Das von Ihnen erstellte Dateisystem bleibt erhalten. Sie können eine EC2 Instance in Ihrer VPC mounten, indem Sie ein anderes Mount-Ziel verwenden.
Diese Operation erfordert Berechtigungen für die folgende Dateisystemaktion:
+ `elasticfilesystem:DeleteMountTarget`
**Anmerkung**
Der Aufruf gibt `DeleteMountTarget` zurück, solange der Status des Mountingziels `deleting` lautet. Sie können überprüfen, ob das Mountingziel gelöscht wurde, indem Sie die Operation [DescribeMountTargets](API_DescribeMountTargets.md) aufrufen, die eine Liste von Beschreibungen der Mountingziele für das angegebene Dateisystem zurückgibt.
Für den Vorgang sind außerdem Berechtigungen für die folgende EC2 Amazon-Aktion auf der Netzwerkschnittstelle des Mount-Ziels erforderlich:
+ `ec2:DeleteNetworkInterface`
## Anforderungssyntax
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
Die ID des Mountingziels, das gelöscht werden soll (Zeichenfolge).
Längenbeschränkungen: Mindestlänge von 13. Maximale Länge beträgt 45 Zeichen.
Pattern: `^fsmt-[0-9a-f]{8,40}$`
Erforderlich: Ja
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
** DependencyTimeout **
Bei dem Service ist beim Versuch, der Anforderung nachzukommen, eine Zeitüberschreitung aufgetreten, und der Client sollte den Aufruf wiederholen.
** 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: 504
** 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
** MountTargetNotFound **
Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.
** 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
## Beispiele
### Entfernen des Mountingziels eines Dateisystems
Im folgenden Beispiel wird eine DELETE-Anfrage gesendet, um ein bestimmtes Mountingziel zu löschen.
#### Beispielanforderung
```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/DeleteMountTarget)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
# DeleteReplicationConfiguration
Löscht eine Replikationskonfiguration. Durch das Löschen einer Replikationskonfiguration wird der Replikationsvorgang beendet. Nach dem Löschen einer Replikationskonfiguration wird das Zieldateisystem wieder `Writeable` und der Schutz vor Überschreibungen der Replikation wird wieder aktiviert. Weitere Informationen finden Sie unter [Löschen einer Replikationskonfiguration](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html).
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DeleteReplicationConfiguration`.
## Anforderungssyntax
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
Bei der Replikation zwischen AWS-Konten oder zwischen diesen AWS-Regionen löscht Amazon EFS die Replikationskonfiguration standardmäßig sowohl aus dem Quell- als auch aus dem Zielkonto oder der Region (`ALL_CONFIGURATIONS`). Wenn es ein Konfigurations- oder Berechtigungsproblem gibt, das Amazon EFS daran hindert, die Replikationskonfiguration von beiden Seiten zu löschen, können Sie den `LOCAL_CONFIGURATION_ONLY` Modus verwenden, um die Replikationskonfiguration nur von der lokalen Seite zu löschen (dem Konto oder der Region, von der aus der Löschvorgang durchgeführt wird).
Verwenden Sie den `LOCAL_CONFIGURATION_ONLY` Modus nur für den Fall, dass Amazon EFS die Replikationskonfiguration nicht sowohl im Quell- als auch im Zielkonto oder in der Region löschen kann. Wenn Sie die lokale Konfiguration löschen, kann die Konfiguration im anderen Konto oder in der anderen Region nicht wiederhergestellt werden.
Verwenden Sie diesen Modus außerdem nicht für die Replikation mit demselben Konto und derselben Region, da dies zu einem Ausnahmefehler führt. BadRequest
Zulässige Werte: `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY`
** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **
Die ID des Quelldateisystems in der Replikationskonfiguration.
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
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
** 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
** ReplicationNotFound **
Wird zurückgegeben, wenn das angegebene Dateisystem keine Replikationskonfiguration aufweist.
** ErrorCode **
ReplicationNotFound
** 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
## 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/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
# DeleteTags
**Anmerkung**
VERALTET – `DeleteTags` ist veraltet und wird nicht mehr unterstützt. Sie können Tags mit der API-Aktion [UntagResource](API_UntagResource.md) aus einer EFS-Ressource entfernen.
Löscht die angegebenen Tags aus einem Dateisystem Wenn die Anforderung `DeleteTags` einen nicht vorhandenen Tag-Schlüssel enthält, wird sie von Amazon EFS ignoriert, ohne dass ein Fehler ausgegeben wird. Weitere Informationen zu Tags und damit verbundenen Einschränkungen finden Sie unter [Tag-Einschränkungen](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) im * AWS Fakturierung und Kostenmanagement Benutzerhandbuch*.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DeleteTags`.
## Anforderungssyntax
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
Die ID des Dateisystems, dessen Tags Sie löschen möchten (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.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
Eine Liste der Tag-Schlüssel, die gelöscht werden sollen.
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 128 Zeichen.
Pattern: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
** 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
## 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/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags)
# DescribeAccessPoints
Gibt die Beschreibung eines bestimmten Amazon-EFS-Zugangspunkts zurück, sofern die `AccessPointId` angegeben ist. Wenn Sie eine `FileSystemId` für EFS angeben, werden Beschreibungen aller Zugangspunkte für dieses Dateisystem zurückgegeben. Sie können in der Anfrage entweder eine `AccessPointId` oder eine `FileSystemId` angeben, nicht jedoch beide.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DescribeAccessPoints`.
## Anforderungssyntax
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(Optional) Gibt einen EFS-Zugangspunkt an, der in der Antwort beschrieben werden soll; ist eine sich mit `FileSystemId` ausschließende Option.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) **
(Optional) Wenn Sie eine `FileSystemId` angeben, gibt EFS alle Zugangspunkte für dieses Dateisystem zurück; ist eine sich mit `AccessPointId` ausschließende Option.
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})$`
** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **
(Optional) Wenn Sie alle Zugangspunkte eines Dateisystems abrufen, können Sie optional den Parameter `MaxItems` angeben, um die Anzahl der in einer Antwort zurückgegebenen Objekte zu begrenzen. Der Standardwert lautet 100.
Gültiger Bereich: Mindestwert 1.
** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **
`NextToken` ist vorhanden, wenn die Antwort paginiert ist. Sie können `NextMarker` in der nachfolgenden Anforderung verwenden, um die nächste Seite mit Beschreibungen von Zugangspunkten abzurufen.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "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.
** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **
Ein Array mit Beschreibungen von Zugangspunkten.
Typ: Array von [AccessPointDescription](API_AccessPointDescription.md)-Objekten
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
Vorhanden, wenn es mehr Zugangspunkte gibt, als in der Antwort zurückgegeben wurden. Sie können das NextMarker in der nachfolgenden Anfrage verwenden, um die zusätzlichen Beschreibungen abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
## Fehler
** AccessPointNotFound **
Wird zurückgegeben, wenn der angegebene `AccessPointId` Wert in dem 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
** 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
** 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
## 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/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
# DescribeAccountPreferences
Gibt die Kontoeinstellungen für das Konto zurück, das dem Benutzer AWS-Konto zugeordnet ist, der die Anfrage gestellt hat, in der aktuellen Version AWS-Region.
## Anforderungssyntax
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(Optional) Wenn Sie alle Kontoeinstellungen abrufen, können Sie optional den Parameter `MaxItems` angeben, um die Anzahl der in einer Antwort zurückgegebenen Objekte zu begrenzen. Der Standardwert lautet 100.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1.
Erforderlich: Nein
** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **
(Optional) Sie können `NextToken` in einer nachfolgenden Anfrage verwenden, um die nächste Seite mit Einstellungen zum AWS-Konto abzurufen, wenn die Antwortnutzlast paginiert wurde.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
Erforderlich: Nein
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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_DescribeAccountPreferences_ResponseSyntax) **
Vorhanden, wenn es mehr Datensätze gibt, als in der Antwort zurückgegeben wurden. Sie können `NextToken` in einer nachfolgenden Anforderung verwenden, um die zusätzlichen Beschreibungen abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **
Beschreibt die Einstellung für die Ressourcen-ID, die dem Benutzer AWS-Konto zugeordnet ist, der die Anfrage gestellt hat, in der aktuellen Version AWS-Region.
Typ: [ResourceIdPreference](API_ResourceIdPreference.md) Objekt
## Fehler
** 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
## 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/DescribeAccountPreferences)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
# DescribeBackupPolicy
Gibt die Backup-Richtlinie für das angegebene EFS-Dateisystem zurück.
## Anforderungssyntax
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
Gibt an, für welches EFS-Dateisystem die `BackupPolicy` abgerufen werden soll.
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
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"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.
** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **
Beschreibt die Backup-Richtlinie des Dateisystems und gibt an, ob automatische Backups aktiviert oder deaktiviert sind.
Typ: [BackupPolicy](API_BackupPolicy.md) Objekt
## 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
** 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
** PolicyNotFound **
Wird zurückgegeben, wenn die angegebene IAM-Richtlinie oder Ressourcenrichtlinie nicht gefunden oder darauf zugegriffen werden kann. Je nach ausgeführter Aktion kann der Fehler auch zurückgegeben werden, wenn die Standard-Dateisystemrichtlinie für das EFS-Dateisystem gültig ist oder wenn keine Backup-Richtlinie angegeben 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: 404
** ValidationException **
Wird zurückgegeben, wenn der AWS Backup Dienst in dem Land, AWS-Region in dem die Anfrage gestellt wurde, 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: 400
## 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/DescribeBackupPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
# DescribeFileSystemPolicy
Gibt die `FileSystemPolicy` für das angegebene EFS-Dateisystem zurück.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DescribeFileSystemPolicy`.
## Anforderungssyntax
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
Gibt an, für welches EFS-Dateisystem die `FileSystemPolicy` abgerufen werden soll.
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
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "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.
** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) **
Gibt das EFS-Dateisystem an, für das die `FileSystemPolicy` gilt.
Typ: 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})$`
** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) **
Die `FileSystemPolicy` im JSON-Fomat für das EFS-Dateisystem.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 20 000.
Pattern: `[\s\S]+`
## 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
** 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
** PolicyNotFound **
Wird zurückgegeben, wenn die angegebene IAM-Richtlinie oder Ressourcenrichtlinie nicht gefunden oder darauf zugegriffen werden kann. Je nach ausgeführter Aktion kann der Fehler auch zurückgegeben werden, wenn die Standard-Dateisystemrichtlinie für das EFS-Dateisystem gültig ist oder wenn keine Backup-Richtlinie angegeben 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: 404
## Beispiele
### Beispiel
Dieses Beispiel veranschaulicht eine Verwendung von DescribeFileSystemPolicy.
#### Beispielanforderung
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### Beispielantwort
```
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
}
]
}
}
```
## 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/DescribeFileSystemPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
# DescribeFileSystems
Gibt die Beschreibung eines bestimmten Amazon-EFS-Dateisystems zurück, wenn entweder das Dateisystem `CreationToken` oder die `FileSystemId` angegeben ist. Andernfalls gibt es Beschreibungen aller Dateisysteme zurück, die dem Aufrufer gehören, AWS-Konto auf dem AWS-Region Endpunkt, den Sie aufrufen.
Beim Abrufen aller Dateisystembeschreibungen können Sie optional den Parameter `MaxItems` angeben, um die Anzahl der Beschreibungen in einer Antwort zu begrenzen. Diese Zahl wird automatisch auf 100 gesetzt. Wenn weitere Dateisystembeschreibungen übrig bleiben, gibt Amazon EFS in der Antwort einen `NextMarker`, ein Opaque-Token, zurück. In diesem Fall sollten Sie eine nachfolgende Anforderung senden, bei der der Anforderungsparameter `Marker` auf den Wert `NextMarker` gesetzt ist.
Um eine Liste der Dateisystembeschreibungen abzurufen, wird diese Operation in einem iterativen Prozess verwendet, wobei `DescribeFileSystems` zuerst ohne den `Marker` und dann von der Operation so lange aufgerufen wird, bis die Antwort keine `NextMarker` mehr aufweist, wobei der Parameter `Marker` auf den Wert `NextMarker` aus der vorherigen Antwort gesetzt ist.
Die Reihenfolge der Dateisysteme, die in der Antwort auf einen `DescribeFileSystems`- Aufruf zurückgegeben werden, und die Reihenfolge der Dateisysteme, die in den Antworten einer Iteration mit mehreren Aufrufen zurückgegeben werden, ist nicht angegeben.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DescribeFileSystems`.
## Anforderungssyntax
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(Optional) Beschränkt die Liste auf das Dateisystem mit diesem Erstellungstoken (Zeichenfolge). Ein Erstellungstoken geben Sie bei der Erstellung eines Amazon-EFS-Dateisystems an.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **
(Optional) ID des Dateisystems, dessen Beschreibung Sie abrufen möchten (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})$`
** [Marker](#API_DescribeFileSystems_RequestSyntax) **
(Optional) Opaque-Paginierungstoken, das von einer vorherigen `DescribeFileSystems`-Operation zurückgegeben wurde (Zeichenfolge). Falls vorhanden, gibt es an, dass die Liste an der Stelle fortgesetzt werden soll, an der der Aufruf, der eine Ausgabe zurückgibt, abgebrochen wurde.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **
(Optional) Gibt die maximale Anzahl der Dateisysteme an, die in der Antwort zurückgegeben werden können (Ganzzahl). Diese Zahl wird automatisch auf 100 gesetzt. Die Antwort wird mit 100 Dateisystemen pro Seite paginiert, sofern es mehr als 100 Dateisysteme gibt.
Gültiger Bereich: Mindestwert 1.
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystems": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
],
"Marker": "string",
"NextMarker": "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.
** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **
Ein Array von Dateisystembeschreibungen.
Typ: Array von [FileSystemDescription](API_FileSystemDescription.md)-Objekten
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
Vorhanden, falls vom Aufrufer in der Anforderung angegeben (Zeichenfolge).
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **
Vorhanden, wenn es mehr Dateisysteme gibt, als in der Antwort zurückgegeben wurden (Zeichenfolge). Sie können `NextMarker` in einer nachfolgenden Anforderung verwenden, um die Beschreibungen abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
## 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
** 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
### Abrufen einer Liste von 10 Dateisystemen
Im folgenden Beispiel wird eine GET-Anfrage an den `file-systems` Endpunkt (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`) gesendet. Die Anforderung gibt einen `MaxItems`-Abfrageparameter an, um die Anzahl der Dateisystembeschreibungen auf 10 zu begrenzen.
#### Beispielanforderung
```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}
```
## 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/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
# DescribeLifecycleConfiguration
Gibt das aktuelle `LifecycleConfiguration` Objekt für das angegebene EFS-Dateisystem zurück. Bei der Lebenszyklusverwaltung wird das `LifecycleConfiguration`-Objekt verwendet, um zu ermitteln, wann Dateien zwischen Speicherklassen verschoben werden müssen. In einem Dateisystem ohne `LifecycleConfiguration`-Objekt gibt der Aufruf in der Antwort ein leeres Array zurück.
Diese Operation erfordert Berechtigungen für die Operation `elasticfilesystem:DescribeLifecycleConfiguration`.
## Anforderungssyntax
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
Die ID des Dateisystems, dessen `LifecycleConfiguration`-Objekt Sie abrufen möchten (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
Der Anforderung besitzt keinen Anforderungstext.
## 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_DescribeLifecycleConfiguration_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
** 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
### Abrufen der Lebenszykluskonfiguration für ein Dateisystem
Die folgende Anforderung ruft das `LifecycleConfiguration`-Objekt für das angegebene Dateisystem ab.
#### Beispielanforderung
```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
## 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/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
# DescribeMountTargets
Gibt die Beschreibungen aller aktuellen Mountziele oder eines bestimmten Mountziels für ein Dateisystem zurück Wenn alle aktuellen Mountingziele angefordert werden, ist die Reihenfolge der Mountingziele, die in der Antwort zurückgegeben werden, nicht angegeben.
Für diesen Vorgang sind Berechtigungen für die Aktion `elasticfilesystem:DescribeMountTargets` erforderlich, entweder für die Dateisystem-ID, die Sie in `FileSystemId` angeben, oder für das Dateisystem des Mountingziels, das Sie in `MountTargetId` angeben.
Der entsprechende CLI-Befehl lautet`describe-mount-targets`.
## Anforderungssyntax
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(Optional) Die ID des Zugangspunkts, dessen Mountingziele Sie auflisten möchten. Sie muss in der Anforderung enthalten sein, falls keine `FileSystemId` oder `MountTargetId` in der Anforderung enthalten ist. Akzeptiert entweder eine Zugangspunkt-ID oder einen ARN als Eingabe.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) **
(Optional) ID des Dateisystems, dessen Mountingziele Sie auflisten möchten (Zeichenfolge). Sie muss in der Anforderung enthalten sein, falls keine `AccessPointId` oder `MountTargetId` in der Anforderung enthalten ist. Akzeptiert entweder eine Dateisystem-ID oder einen ARN als Eingabe.
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})$`
** [Marker](#API_DescribeMountTargets_RequestSyntax) **
(Optional) Opaque-Paginierungstoken, das von einer vorherigen `DescribeMountTargets`-Operation zurückgegeben wurde (Zeichenfolge). Falls vorhanden, gibt es an, dass die Liste an der Stelle fortgesetzt werden soll, an der der vorherige Aufruf, der eine Ausgabe zurückgibt, abgebrochen wurde.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **
(Optional) Die maximale Anzahl der Mountingziele, die in der Antwort zurückgegeben werden können. Derzeit wird diese Anzahl automatisch auf 10 gesetzt, und andere Werte werden ignoriert. Die Antwort wird mit 100 Mountingzielen pro Seite paginiert, sofern es mehr als 100 Mountingziele gibt.
Gültiger Bereich: Mindestwert 1.
** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **
(Optional) ID des Mountingziels, das beschrieben werden soll (Zeichenfolge). Sie muss in der Anforderung enthalten sein, falls keine `FileSystemId` in der Anforderung enthalten ist. Akzeptiert entweder eine Mountingziel-ID oder einen ARN als Eingabe.
Längenbeschränkungen: Mindestlänge von 13. Maximale Länge beträgt 45 Zeichen.
Pattern: `^fsmt-[0-9a-f]{8,40}$`
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "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.
** [Marker](#API_DescribeMountTargets_ResponseSyntax) **
Wenn die Anforderung den `Marker` enthält, wird dieser Wert in der Antwort in diesem Feld zurückgegeben.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **
Gibt die Mountingziele des Dateisystems als Array von `MountTargetDescription`-Objekten zurück.
Typ: Array von [MountTargetDescription](API_MountTargetDescription.md)-Objekten
** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **
Wenn ein Wert vorhanden ist, sind weitere Mountingziele verfügbar, die zurückgegeben werden. In einer nachfolgenden Anforderung können Sie `Marker` angeben, um den nächsten Satz von Mountingzielen abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
## Fehler
** AccessPointNotFound **
Wird zurückgegeben, wenn der angegebene `AccessPointId` 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
** 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
** 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
** MountTargetNotFound **
Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.
** 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
## Beispiele
### Abrufen von Beschreibungen von Mountingzielen, die für ein Dateisystem erstellt wurden
Die folgende Anforderung ruft Beschreibungen von Mountingzielen ab, die für das angegebene Dateisystem erstellt wurden.
#### Beispielanforderung
```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357
{
"MountTargets":[
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-01234567",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"LifeCycleState":"added",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
]
}
```
## 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/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
# DescribeMountTargetSecurityGroups
Gibt die Sicherheitsgruppen zurück, die derzeit für ein Mountziel gültig sind Sie setzt voraus, dass die Netzwerkschnittstelle des Mountingziels erstellt wurde und der Lebenszyklusstatus des Mountingziels nicht `deleted` lautet.
Diese Operation erfordert außerdem Berechtigungen für die folgenden Aktionen:
+ Aktion `elasticfilesystem:DescribeMountTargetSecurityGroups` im Dateisystem des Mountingziels.
+ Aktion `ec2:DescribeNetworkInterfaceAttribute` in der Netzwerkschnittstelle des Mountingziels.
## Anforderungssyntax
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
Die ID des Mountingziels, dessen Sicherheitsgruppen Sie abrufen möchten.
Längenbeschränkungen: Mindestlänge von 13. Maximale Länge beträgt 45 Zeichen.
Pattern: `^fsmt-[0-9a-f]{8,40}$`
Erforderlich: Ja
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "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.
** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **
Ein Array von Sicherheitsgruppen.
Typ: Zeichenfolgen-Array
Array-Mitglieder: Maximale Anzahl von 100 Elementen.
Längenbeschränkungen: Mindestlänge von 11. Maximale Länge von 43.
Pattern: `^sg-[0-9a-f]{8,40}`
## 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
** IncorrectMountTargetState **
Wird zurückgegeben, wenn das Mountingziel nicht den richtigen Status für die Operation aufweist.
** 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
** MountTargetNotFound **
Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.
** 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
## Beispiele
### Rufen Sie Sicherheitsgruppen ab, die für ein Dateisystem aktiv sind
Im folgenden Beispiel werden die Sicherheitsgruppen, die für die einem Mountingziel zugeordnete Netzwerkschnittstelle gelten, abgerufen.
#### Beispielanforderung
```
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## 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/DescribeMountTargetSecurityGroups)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
# DescribeReplicationConfigurations
Ruft die Replikationskonfiguration für ein bestimmtes Dateisystem ab. Wenn kein Dateisystem angegeben ist, werden alle Replikationskonfigurationen für das AWS-Konto in AWS-Region an abgerufen.
## Anforderungssyntax
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
Sie können die Replikationskonfiguration für ein bestimmtes Dateisystem abrufen, indem Sie dessen Dateisystem-ID angeben. Bei der konto- und regionsübergreifenden Replikation kann ein Konto nur die Replikationskonfiguration für ein Dateisystem in seiner eigenen Region beschreiben.
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})$`
** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) **
(Optional) Um die Anzahl der in einer Antwort zurückgegebenen Objekte zu begrenzen, können Sie den Parameter `MaxItems` angeben. Der Standardwert lautet 100.
Gültiger Bereich: Mindestwert 1.
** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) **
`NextToken` ist vorhanden, wenn die Antwort paginiert ist. Sie können `NextToken` in einer nachfolgenden Anfrage verwenden, um die nächste Ausgabeseite abzurufen.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Replications": [
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "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_DescribeReplicationConfigurations_ResponseSyntax) **
Sie können `NextToken` aus der vorherigen Antwort in einer nachfolgenden Anfrage verwenden, um die zusätzlichen Beschreibungen abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **
Die Sammlung von Replikationskonfigurationen, die zurückgegeben werden.
Typ: Array von [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)-Objekten
## 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
** 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
** ReplicationNotFound **
Wird zurückgegeben, wenn das angegebene Dateisystem keine Replikationskonfiguration aufweist.
** ErrorCode **
ReplicationNotFound
** 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
** ValidationException **
Wird zurückgegeben, wenn der AWS Backup Dienst in dem Land, AWS-Region in dem die Anfrage gestellt wurde, 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: 400
## 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/DescribeReplicationConfigurations)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
# DescribeTags
**Anmerkung**
VERALTET – Die Aktion `DescribeTags` ist veraltet und wird nicht mehr unterstützt. Verwenden Sie die API-Aktion `ListTagsForResource`, um Tags anzuzeigen, die mit EFS-Ressourcen verknüpft sind.
Gibt die einem Dateisystem zugeordneten Tags zurück Die Reihenfolge der Tags, die in der Antwort auf einen `DescribeTags`- Aufruf zurückgegeben werden, und die Reihenfolge der Tags, die in den Antworten einer Iteration mit mehreren Aufrufen zurückgegeben werden (bei Verwendung der Paginierung), ist nicht angegeben.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DescribeTags`.
## Anforderungssyntax
```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_DescribeTags_RequestSyntax) **
Die ID des Dateisystems, dessen Tag-Set Sie abrufen möchten.
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
** [Marker](#API_DescribeTags_RequestSyntax) **
(Optional) Ein Opaque-Paginierungstoken, das von einer vorherigen `DescribeTags`-Operation zurückgegeben wurde (Zeichenfolge). Falls vorhanden, gibt es an, dass die Liste an der Stelle fortgesetzt werden soll, an der der vorherige Aufruf abgebrochen wurde.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [MaxItems](#API_DescribeTags_RequestSyntax) **
(Optional) Die maximale Anzahl der Dateisystem-Tags, die in der Antwort zurückgegeben werden können. Derzeit wird diese Anzahl automatisch auf 100 gesetzt, und andere Werte werden ignoriert. Die Antwort wird mit 100 Tags pro Seite paginiert, sofern es mehr als 100 Tags gibt.
Gültiger Bereich: Mindestwert 1.
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"NextMarker": "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.
** [Marker](#API_DescribeTags_ResponseSyntax) **
Wenn die Anfrage einen `Marker` enthält, wird dieser Wert in der Antwort in diesem Feld zurückgegeben.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [NextMarker](#API_DescribeTags_ResponseSyntax) **
Wenn ein Wert vorhanden ist, sind weitere Tags verfügbar, die zurückgegeben werden. In einer nachfolgenden Anfrage können Sie den Wert von `NextMarker` als Wert des Parameters `Marker` in der nächsten Anfrage angeben, um den nächsten Satz an Tags abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [Tags](#API_DescribeTags_ResponseSyntax) **
Gibt Tags, die dem Dateisystem zugeordnet sind, als ein Array von `Tag`-Objekten zurück.
Typ: Array von [Tag](API_Tag.md)-Objekten
## 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
** 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
### Abrufen aller einem Dateisystem zugeordneten Tags
Die folgende Anforderung ruft Tags (Schlüssel-Wert-Paare) ab, die dem angegebenen Dateisystem zugeordnet sind.
#### Beispielanforderung
```
GET /2015-02-01/tags/fs-01234567/ HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215404Z
Authorization: <...>
```
#### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 288
{
"Tags":[
{
"Key":"Name",
"Value":"my first file system"
},
{
"Key":"Fleet",
"Value":"Development"
},
{
"Key":"Developer",
"Value":"Alice"
}
]
}
```
## 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/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags)
# ListTagsForResource
Listet alle Tags für eine EFS-Ressource der obersten Ebene auf. Sie müssen die ID der Ressource angeben, für die Sie die Tags abrufen wollen.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DescribeAccessPoints`.
## Anforderungssyntax
```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [MaxResults](#API_ListTagsForResource_RequestSyntax) **
(Optional) Gibt die maximale Anzahl der Tag-Objekte an, die in der Antwort zurückgegeben werden können. Der Standardwert lautet 100.
Gültiger Bereich: Mindestwert 1.
** [NextToken](#API_ListTagsForResource_RequestSyntax) **
(Optional) Sie können `NextToken` in einer nachfolgenden Anfrage verwenden, um die nächste Seite mit Zugangspunktbeschreibungen abzurufen, wenn die Antwortnutzlast paginiert wurde.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [ResourceId](#API_ListTagsForResource_RequestSyntax) **
Gibt die EFS-Ressource an, für die Sie Tags abrufen möchten. Mit diesem API-Endpunkt können Sie Tags für EFS-Dateisysteme und Zugangspunkte abrufen.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Erforderlich: Ja
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"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) **
`NextToken` ist vorhanden, wenn die Antwort-Payload paginiert ist. Sie können `NextToken` in einer nachfolgenden Anfrage verwenden, um die nächste Zugangspunktseite abzurufen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern: `.+`
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
Ein Array der Tags für die angegebene EFS-Ressource.
Typ: Array von [Tag](API_Tag.md)-Objekten
## Fehler
** AccessPointNotFound **
Wird zurückgegeben, wenn der angegebene `AccessPointId` 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
** 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
** 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
## 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/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource)
# ModifyMountTargetSecurityGroups
Ändert den Satz der Sicherheitsgruppen, die für ein Mountingziel gültig sind.
Wenn Sie ein Mountingziel erstellen, wird in Amazon EFS auch eine neue Netzwerkschnittstelle erstellt. Weitere Informationen finden Sie unter [CreateMountTarget](API_CreateMountTarget.md). Durch diese Operation werden die Sicherheitsgruppen, die für die einem Mountingziel zugeordnete Netzwerkschnittstelle gelten, durch die in der Anforderung angegebenen `SecurityGroups` ersetzt. Sie setzt voraus, dass die Netzwerkschnittstelle des Mountingziels erstellt wurde und der Lebenszyklusstatus des Mountingziels nicht `deleted` lautet.
Die Operation erfordert Berechtigungen für die folgende Dateisystemaktion:
+ Aktion `elasticfilesystem:ModifyMountTargetSecurityGroups` im Dateisystem des Mountingziels.
+ Aktion `ec2:ModifyNetworkInterfaceAttribute` in der Netzwerkschnittstelle des Mountingziels.
## Anforderungssyntax
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
Die ID des Mountingziels, dessen Sicherheitsgruppen Sie ändern möchten.
Längenbeschränkungen: Mindestlänge von 13. Maximale Länge beträgt 45 Zeichen.
Pattern: `^fsmt-[0-9a-f]{8,40}$`
Erforderlich: Ja
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
Eine Reihe von VPC-Sicherheitsgruppen IDs.
Typ: Zeichenfolgen-Array
Array-Mitglieder: Maximale Anzahl von 100 Elementen.
Längenbeschränkungen: Mindestlänge von 11. Maximale Länge von 43.
Pattern: `^sg-[0-9a-f]{8,40}`
Erforderlich: Nein
## Antwortsyntax
```
HTTP/1.1 204
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP-204-Antwort mit leerem HTTP-Textinhalt zurück.
## 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
** IncorrectMountTargetState **
Wird zurückgegeben, wenn das Mountingziel nicht den richtigen Status für die Operation aufweist.
** 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
** MountTargetNotFound **
Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.
** 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
** SecurityGroupLimitExceeded **
Wird zurückgegeben, wenn die in der Anfrage `SecurityGroups` angegebene Anzahl von Objekten das Limit überschreitet, das auf dem Kontingent basiert. Löschen Sie entweder einige Sicherheitsgruppen oder fordern Sie eine Erhöhung des Kontokontingents an. Weitere Informationen finden Sie unter [Amazon VPC-Kontingente](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) im *Amazon VPC-Benutzerhandbuch* (siehe Tabelle mit **Sicherheitsgruppen**).
** 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
** SecurityGroupNotFound **
Wird zurückgegeben, wenn eine der angegebenen Sicherheitsgruppen nicht in der Virtual Private Cloud (VPC) des Subnetzes vorhanden 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: 400
## Beispiele
### Ersetzen der Sicherheitsgruppen eines Mountingziels
Im folgenden Beispiel werden die Sicherheitsgruppen, die für die einem Mountingziel zugeordnete Netzwerkschnittstelle gelten, ersetzt.
#### Beispielanforderung
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### Beispielantwort
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
# PutAccountPreferences
Verwenden Sie diesen Vorgang, um die Kontopräferenz in der aktuellen Version so festzulegen AWS-Region , dass IDs für das neue EFS-Dateisystem eine lange Ressource mit 17 Zeichen (63 Bit) oder eine kurze Ressource mit 8 Zeichen (32 Bit) verwendet und Zielressourcen bereitgestellt werden. Alle vorhandenen Ressourcen IDs sind von den Änderungen, die Sie vornehmen, nicht betroffen. Sie können die ID-Präferenz während des Anmeldezeitraums festlegen, wenn EFS auf Long Resource IDs umsteigt. Weitere Informationen finden Sie unter [Amazon EFS-Ressourcen verwalten IDs](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html).
**Anmerkung**
Seit Oktober 2021 wird bei dem Versuch, die Ressourcen-ID in der Voreinstellung für das Konto auf das kurze 8-stellige Format zu ändern, eine Fehlermeldung ausgegeben. Wenden Sie sich an den AWS Support, wenn Sie eine Fehlermeldung erhalten und die Abkürzung IDs für Dateisystem und Mount-Zielressourcen verwenden müssen.
## Anforderungssyntax
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
Gibt die EFS-Ressourcen-ID-Einstellung an AWS-Konto, die für den Benutzer in der aktuellen Version AWS-Region entweder `LONG_ID` (17 Zeichen) oder `SHORT_ID` (8 Zeichen) festgelegt werden soll.
Seit Oktober 2021 wird eine Fehlermeldung ausgegeben, wenn in der Voreinstellung für das Konto `SHORT_ID`ausgewählt wird. Wenden Sie sich an den AWS Support, wenn Sie eine Fehlermeldung erhalten und die Abkürzung IDs für Dateisystem und Mount-Zielressourcen verwenden müssen.
Typ: Zeichenfolge
Zulässige Werte: `LONG_ID | SHORT_ID`
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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.
** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **
Beschreibt den Ressourcentyp und seine ID-Präferenz für den AWS-Konto Benutzer in der aktuellen Version AWS-Region.
Typ: [ResourceIdPreference](API_ResourceIdPreference.md) Objekt
## 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
** 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
## 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/PutAccountPreferences)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
# PutBackupPolicy
Aktualisiert die Backup-Richtlinie des Dateisystems. Mit dieser Aktion können Sie automatische Backups des Dateisystems starten oder beenden.
## Anforderungssyntax
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
Gibt an, für welches EFS-Dateisystem die Backup-Richtlinie aktualisiert werden soll.
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.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
Die in der `PutBackupPolicy`-Anforderung enthaltene Backup-Richtlinie.
Typ: [BackupPolicy](API_BackupPolicy.md) Objekt
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"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.
** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **
Beschreibt die Backup-Richtlinie des Dateisystems und gibt an, ob automatische Backups aktiviert oder deaktiviert sind.
Typ: [BackupPolicy](API_BackupPolicy.md) Objekt
## 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
** ValidationException **
Wird zurückgegeben, wenn der AWS Backup Dienst in dem Land, AWS-Region in dem die Anfrage gestellt wurde, 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: 400
## 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/PutBackupPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
# PutFileSystemPolicy
Wendet eine `FileSystemPolicy` auf ein Amazon-EFS-Dateisystem an. Eine Dateisystemrichtlinie ist eine auf IAM-Ressourcen basierende Richtlinie und kann mehrere Richtlinienanweisungen enthalten. Ein Dateisystem hat immer genau eine Dateisystemrichtlinie. Dabei kann es sich um die Standardrichtlinie oder um eine explizite Richtlinie handeln, die mithilfe dieser API-Operation festgelegt oder aktualisiert wurde. Die Zeichenbeschränkung von EFS-Dateisystemrichtlinien liegt bei 20.000. Wenn eine explizite Richtlinie festgelegt wird, hat diese Vorrang vor der Standardrichtlinie. Weitere Informationen zur Standard-Dateisystemrichtlinie finden Sie unter [EFS-Standarddateisystemrichtlinie](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy).
**Anmerkung**
Die Zeichenbeschränkung von EFS-Dateisystemrichtlinien liegt bei 20.000.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:PutFileSystemPolicy`.
## Anforderungssyntax
```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json
{
"BypassPolicyLockoutSafetyCheck": boolean,
"Policy": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **
Die ID des EFS-Dateisystems, für das Sie die `FileSystemPolicy` erstellen oder aktualisieren möchten.
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.
** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **
(Optional) Ein boolescher Wert, der angibt, ob die `FileSystemPolicy`-Sperrsicherheitsprüfung umgangen werden soll oder nicht. Die Sperrsicherheitsprüfung bestimmt, ob die Richtlinie in der Anforderung den IAM-Prinzipal, der die Anforderung stellt, sperrt oder daran hindert, zukünftige `PutFileSystemPolicy`-Anforderungen an dieses Dateisystem zu stellen. Setzen Sie `BypassPolicyLockoutSafetyCheck` nur dann auf `True`, wenn Sie verhindern möchten, dass der IAM-Prinzipal, der die Anforderung stellt, nachfolgende `PutFileSystemPolicy`-Anforderungen an dieses Dateisystem stellt. Der Standardwert ist `False`.
Typ: Boolesch
Erforderlich: Nein
** [Policy](#API_PutFileSystemPolicy_RequestSyntax) **
Die `FileSystemPolicy`, die Sie erstellen. Akzeptiert eine Richtliniendefinition im JSON-Format. Die Zeichenbeschränkung von EFS-Dateisystemrichtlinien liegt bei 20.000. Weitere Informationen zu den Elementen, aus denen sich eine Dateisystemrichtlinie zusammensetzt, finden Sie unter [Ressourcenbasierte Richtlinien in Amazon](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies) EFS.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 20 000.
Pattern: `[\s\S]+`
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "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.
** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) **
Gibt das EFS-Dateisystem an, für das die `FileSystemPolicy` gilt.
Typ: 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})$`
** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) **
Die `FileSystemPolicy` im JSON-Fomat für das EFS-Dateisystem.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 20 000.
Pattern: `[\s\S]+`
## 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
** InvalidPolicyException **
Wird zurückgegeben, wenn `FileSystemPolicy` falsch formatiert ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter. Wird zurückgegeben, wenn bei der Sicherheitsüberprüfung der Richtlinie 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-Statuscode: 400
## Beispiele
### Erstellen Sie ein EFS FileSystemPolicy
Die folgende Anforderung erstellt eine`FileSystemPolicy`, die es allen AWS Prinzipalen ermöglicht, das angegebene EFS-Dateisystem mit Lese- und Schreibberechtigungen zu mounten.
#### Beispielanforderung
```
PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
}
]
}
```
#### Beispielantwort
```
{
"Version": "2012-10-17",
"Id": "1",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
"Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567"
}
]
}
```
## 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/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
# 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)
# TagResource
Erstellt ein Tag für eine EFS-Ressource. Mit diesem API-Vorgang können Sie Tags für EFS-Dateisysteme und Zugangspunkte erstellen.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:TagResource`.
## Anforderungssyntax
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [ResourceId](#API_TagResource_RequestSyntax) **
Die ID, die die EFS-Ressource angibt, für die Sie ein Tag erstellen möchten.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Erforderlich: Ja
## Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [Tags](#API_TagResource_RequestSyntax) **
Ein Array von `Tag`-Objekten, die hinzugefügt werden sollen. Jedes `Tag`-Objekt ist ein Schlüssel-Wert-Paar.
Typ: Array von [Tag](API_Tag.md)-Objekten
Erforderlich: Ja
## Antwortsyntax
```
HTTP/1.1 200
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
** AccessPointNotFound **
Wird zurückgegeben, wenn der angegebene `AccessPointId` 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
** 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
** 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
### Tags in einem Dateisystem erstellen
Die folgende Anforderung erstellt drei Tags (`"key1"``"key2"`, und`"key3"`) im angegebenen Dateisystem.
#### Beispielanforderung
```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
#### Beispielantwort
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)
# UntagResource
Entfernt Tags aus einer EFS-Ressource. Mit diesem API-Vorgang können Sie Tags aus EFS-Dateisystemen und Zugangspunkten entfernen.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:UntagResource`.
## Anforderungssyntax
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [ResourceId](#API_UntagResource_RequestSyntax) **
Gibt die EFS-Ressource an, von der Sie Tags entfernen möchten.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Erforderlich: Ja
** [TagKeys](#API_UntagResource_RequestSyntax) **
Die Schlüssel der Schlüssel-Wert-Tag-Paare, die Sie aus der angegebenen EFS-Ressource entfernen möchten.
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 128 Zeichen.
Pattern: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Erforderlich: Ja
## Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
## Antwortsyntax
```
HTTP/1.1 200
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
## Fehler
** AccessPointNotFound **
Wird zurückgegeben, wenn der angegebene `AccessPointId` 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
** 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
** 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
## 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/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource)
# UpdateFileSystem
Aktualisiert den Durchsatz oder die Menge des bereitgestellten Durchsatzes eines vorhandenen Dateisystems.
## Anforderungssyntax
```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **
Die ID des Dateisystems, das Sie aktualisieren möchten.
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.
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **
(Optional) Der Durchsatz, gemessen in Mebibyte pro Sekunde (MiBps), den Sie für ein Dateisystem bereitstellen möchten, das Sie erstellen. Erforderlich, wenn `ThroughputMode` auf `provisioned` festgelegt wird. Gültige Werte sind 1—3414 MiBps, wobei die Obergrenze von der Region abhängt. Um diesen Grenzwert zu erhöhen, wenden Sie sich an. Support Weitere Informationen finden Sie unter [Amazon-EFS-Kontingente, die Sie erhöhen können](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) im *Amazon-EFS-Benutzerhandbuch*.
Type: Double
Gültiger Bereich: Mindestwert 1.0.
Erforderlich: Nein
** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) **
(Optional) Aktualisiert den Durchsatzmodus des Dateisystems. Wenn Sie Ihren Durchsatzmodus nicht aktualisieren, müssen Sie diesen Wert in Ihrer Anfrage nicht angeben. Wenn Sie `ThroughputMode` in `provisioned` ändern, müssen Sie auch einen Wert für `ProvisionedThroughputInMibps` festlegen.
Typ: Zeichenfolge
Zulässige Werte: `bursting | provisioned | elastic`
Erforderlich: Nein
## Antwortsyntax
```
HTTP/1.1 202
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 202-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) **
Die eindeutige und konsistente Kennung der Availability Zone, in der sich das Dateisystem befindet. Sie ist nur für One-Zone-Dateisysteme gültig. `use1-az1`Ist beispielsweise eine Availability Zone ID für die US-East-1 AWS-Region, und sie hat in jedem Fall den gleichen Standort. AWS-Konto
Typ: Zeichenfolge
** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) **
Beschreibt die AWS Availability Zone, in der sich das Dateisystem befindet, und ist nur für One Zone-Dateisysteme gültig. Weitere Informationen finden Sie unter [Verwenden von EFS-Speicherklassen](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) im *Amazon-EFS-Benutzerhandbuch*.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) **
Die Zeit, zu der das Dateisystem erstellt wurde, in Sekunden (seit 1970-01-01T00:00:00Z).
Typ: Zeitstempel
** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) **
Die Opaque-Zeichenfolge, die in der Anforderung angegeben wird.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern: `.+`
** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) **
Ein boolescher Wert, der mit True anzeigt, dass das Dateisystem verschlüsselt ist.
Typ: Boolescher Wert
** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **
Der Amazon-Ressourcenname (ARN) für das EFS-Dateisystem, im Format `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Beispiel mit Beispieldaten: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Typ: Zeichenfolge
** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) **
Die von Amazon EFS zugewiesene ID des Dateisystems.
Typ: 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})$`
** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) **
Gibt den Schutz des Dateisystems an.
Typ: [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) Objekt
** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **
Die ID eines, das zum Schutz des verschlüsselten Dateisystems AWS KMS key verwendet wird.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen.
Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_UpdateFileSystem_ResponseSyntax) **
Die Lebenszyklusphase des Dateisystems.
Typ: Zeichenfolge
Zulässige Werte: `creating | available | updating | deleting | deleted | error`
** [Name](#API_UpdateFileSystem_ResponseSyntax) **
Sie können einem Dateisystem Tags hinzufügen, einschließlich eines `Name`-Tags. Weitere Informationen finden Sie unter [CreateFileSystem](API_CreateFileSystem.md). Wenn das Dateisystem über ein `Name`-Tag verfügt, gibt Amazon EFS den Wert in diesem Feld zurück.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) **
Die aktuelle Anzahl von Mounting-Zielen, die das Dateisystem aufweist. Weitere Informationen finden Sie unter [CreateMountTarget](API_CreateMountTarget.md).
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0.
** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) **
AWS-Konto Derjenige, der das Dateisystem erstellt hat.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.
Pattern: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) **
Der Leistungsmodus des Dateisystems.
Typ: Zeichenfolge
Zulässige Werte: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **
Die Menge des bereitgestellten Durchsatzes, gemessen in MiBps, für das Dateisystem. Gültig für Dateisysteme, bei denen `ThroughputMode` auf `provisioned` eingestellt ist.
Type: Double
Gültiger Bereich: Mindestwert 1.0.
** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) **
Die letzte bekannte gemessene Größe (in Bytes) der im Dateisystem gespeicherten Daten im Feld `Value` und die Zeit, zu der diese Größe ermittelt wurde, im Feld `Timestamp`. Der Wert `Timestamp` ist die ganzzahlige Anzahl der Sekunden seit 1970-01-01T00:00:00Z. Der Wert `SizeInBytes` steht nicht für die Größe eines konsistenten Snapshots des Dateisystems, ist aber letztlich konsistent, wenn keine Schreibvorgänge im Dateisystem vorgenommen werden. Das heißt, `SizeInBytes` steht nur dann für die tatsächliche Größe, wenn das Dateisystem länger als einige Stunden nicht verändert wurde. Andernfalls entspricht der Wert nicht exakt der Größe, die das Dateisystem zu einem beliebigen Zeitpunkt hatte.
Typ: [FileSystemSize](API_FileSystemSize.md) Objekt
** [Tags](#API_UpdateFileSystem_ResponseSyntax) **
Die Tags, die dem Dateisystem zugeordnet sind, dargestellt als ein Array von `Tag`-Objekten.
Typ: Array von [Tag](API_Tag.md)-Objekten
** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) **
Zeigt den Durchsatzmodus des Dateisystems an. Weitere Informationen finden Sie unter [Durchsatzmod](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)i im *Amazon-EFS-Benutzerhandbuch*.
Typ: Zeichenfolge
Zulässige Werte: `bursting | provisioned | elastic`
## 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
** InsufficientThroughputCapacity **
Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um zusätzlichen Durchsatz bereitzustellen. Dieser Wert kann zurückgegeben werden, wenn Sie versuchen, ein Dateisystem im Modus „Bereitgestellter Durchsatz“ zu erstellen, wenn Sie versuchen, den bereitgestellten Durchsatz eines vorhandenen Dateisystems zu erhöhen oder wenn Sie versuchen, ein vorhandenes Dateisystem vom Modus „Bursting Throughput“ auf „Bereitgestellter Durchsatz“ umzustellen. Bitte versuchen Sie es später erneut.
** 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: 503
** 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
** ThroughputLimitExceeded **
Wird zurückgegeben, wenn der Durchsatzmodus oder die Menge des bereitgestellten Durchsatzes nicht geändert werden können, da die Durchsatzgrenze von 1024 erreicht MiB/s wurde.
** 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
** TooManyRequests **
Wird zurückgegeben, wenn Sie nicht mindestens 24 Stunden warten, bevor Sie entweder den Durchsatzmodus ändern oder den Wert für den bereitgestellten Durchsatz verringern.
** 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: 429
## 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/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
# UpdateFileSystemProtection
Aktualisiert den Schutz für ein Dateisystem.
Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:UpdateFileSystemProtection`.
## Anforderungssyntax
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
Die ID des zu aktualisierenden Dateisystems.
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.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
Der Status des Replikationsüberschreibschutzes des Dateisystems.
+ `ENABLED` – Das Dateisystem kann nicht als Zieldateisystem in einer Replikationskonfiguration verwendet werden. Das Dateisystem ist beschreibbar. Der Überschreibschutz für die Replikation ist standardmäßig `ENABLED`.
+ `DISABLED` – Das Dateisystem kann als Zieldateisystem in einer Replikationskonfiguration verwendet werden. Das Dateisystem ist schreibgeschützt und kann nur durch EFS-Replikation geändert werden.
+ `REPLICATING` – Das Dateisystem wird als Zieldateisystem in einer Replikationskonfiguration verwendet. Das Dateisystem ist schreibgeschützt und wird nur durch die EFS-Replikation geändert.
Wenn die Replikationskonfiguration gelöscht wird, wird der Replikationsüberschreibschutz des Dateisystems wieder aktiviert und das Dateisystem wird beschreibbar.
Typ: Zeichenfolge
Zulässige Werte: `ENABLED | DISABLED | REPLICATING`
Erforderlich: Nein
## Antwortsyntax
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "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.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **
Der Status des Replikationsüberschreibschutzes des Dateisystems.
+ `ENABLED` – Das Dateisystem kann nicht als Zieldateisystem in einer Replikationskonfiguration verwendet werden. Das Dateisystem ist beschreibbar. Der Überschreibschutz für die Replikation ist standardmäßig `ENABLED`.
+ `DISABLED` – Das Dateisystem kann als Zieldateisystem in einer Replikationskonfiguration verwendet werden. Das Dateisystem ist schreibgeschützt und kann nur durch EFS-Replikation geändert werden.
+ `REPLICATING` – Das Dateisystem wird als Zieldateisystem in einer Replikationskonfiguration verwendet. Das Dateisystem ist schreibgeschützt und wird nur durch EFS-Replikation geändert.
Wenn die Replikationskonfiguration gelöscht wird, wird der Replikationsüberschreibschutz des Dateisystems wieder aktiviert und das Dateisystem wird beschreibbar.
Typ: Zeichenfolge
Zulässige Werte: `ENABLED | DISABLED | REPLICATING`
## 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
** InsufficientThroughputCapacity **
Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um zusätzlichen Durchsatz bereitzustellen. Dieser Wert kann zurückgegeben werden, wenn Sie versuchen, ein Dateisystem im Modus „Bereitgestellter Durchsatz“ zu erstellen, wenn Sie versuchen, den bereitgestellten Durchsatz eines vorhandenen Dateisystems zu erhöhen oder wenn Sie versuchen, ein vorhandenes Dateisystem vom Modus „Bursting Throughput“ auf „Bereitgestellter Durchsatz“ umzustellen. Bitte versuchen Sie es später erneut.
** 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: 503
** 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
** ReplicationAlreadyExists **
Wird zurückgegeben, wenn das Dateisystem bereits in einer Replikationskonfiguration enthalten 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
** ThroughputLimitExceeded **
Wird zurückgegeben, wenn der Durchsatzmodus oder die Menge des bereitgestellten Durchsatzes nicht geändert werden können, da die Durchsatzgrenze von 1024 erreicht MiB/s wurde.
** 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
** TooManyRequests **
Wird zurückgegeben, wenn Sie nicht mindestens 24 Stunden warten, bevor Sie entweder den Durchsatzmodus ändern oder den Wert für den bereitgestellten Durchsatz verringern.
** 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: 429
## 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/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)