Beispiele für die Verwendung der AWS CLI mit Amazon EFS - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit Amazon EFS

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Amazon EFS nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-file-system verwendet wird.

AWS CLI

So erstellen Sie ein verschlüsseltes Dateisystem

Im folgenden create-file-system-Beispiel wird ein verschlüsseltes Dateisystem erstellt, das den Standard-CMK verwendet. Außerdem wird das Tag Name=my-file-system hinzugefügt.

aws efs create-file-system \
    --performance-mode generalPurpose \
    --throughput-mode bursting \
    --encrypted \
    --tags Key=Name,Value=my-file-system

Ausgabe:

{
    "OwnerId": "123456789012",
    "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example",
    "FileSystemId": "fs-c7a0456e",
    "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d",
    "CreationTime": 1595286880.0,
    "LifeCycleState": "creating",
    "Name": "my-file-system",
    "NumberOfMountTargets": 0,
    "SizeInBytes": {
        "Value": 0,
        "ValueInIA": 0,
        "ValueInStandard": 0
    },
    "PerformanceMode": "generalPurpose",
    "Encrypted": true,
    "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example",
    "ThroughputMode": "bursting",
    "Tags": [
        {
            "Key": "Name",
            "Value": "my-file-system"
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen von Amazon-EFS-Dateisystemen im Benutzerhandbuch zu Amazon Elastic File System.

Das folgende Codebeispiel zeigt, wie create-mount-target verwendet wird.

AWS CLI

So erstellen Sie ein Mount-Ziel

Im folgenden create-mount-target-Beispiel wird ein Mount-Ziel für das angegebene Dateisystem erstellt.

aws efs create-mount-target \
    --file-system-id fs-c7a0456e \
    --subnet-id subnet-02bf4c428bexample \
    --security-groups sg-068f739363example

Ausgabe:

{
    "OwnerId": "123456789012",
    "MountTargetId": "fsmt-f9a14450",
    "FileSystemId": "fs-c7a0456e",
    "SubnetId": "subnet-02bf4c428bexample",
    "LifeCycleState": "creating",
    "IpAddress": "10.0.1.24",
    "NetworkInterfaceId": "eni-02d542216aexample",
    "AvailabilityZoneId": "use2-az2",
    "AvailabilityZoneName": "us-east-2b",
    "VpcId": "vpc-0123456789abcdef0"
}

Weitere Informationen finden Sie unter Erstellen von Mount-Zielen im Benutzerhandbuch zu Amazon Elastic File System.

Das folgende Codebeispiel zeigt, wie delete-file-system verwendet wird.

AWS CLI

So löschen Sie ein Dateisystem

Im folgenden delete-file-system-Beispiel wird das angegebene Dateisystem gelöscht.

aws efs delete-file-system \
    --file-system-id fs-c7a0456e

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines Amazon-EFS-Dateisystems im Benutzerhandbuch zu Amazon Elastic File System.

Das folgende Codebeispiel zeigt, wie delete-mount-target verwendet wird.

AWS CLI

So löschen Sie ein Mount-Ziel

Im folgenden delete-mount-target-Beispiel wird das angegebene Mount-Ziel gelöscht.

aws efs delete-mount-target \
    --mount-target-id fsmt-f9a14450

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen von Mount-Zielen im Benutzerhandbuch zu Amazon Elastic File System.

Das folgende Codebeispiel zeigt, wie describe-file-systems verwendet wird.

AWS CLI

So beschreiben Sie ein Dateisystem

Im folgenden describe-file-systems-Beispiel wird das angegebene Dateisystem beschrieben.

aws efs describe-file-systems \
    --file-system-id fs-c7a0456e

Ausgabe:

{
    "FileSystems": [
        {
            "OwnerId": "123456789012",
            "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example",
            "FileSystemId": "fs-c7a0456e",
            "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d",
            "CreationTime": 1595286880.0,
            "LifeCycleState": "available",
            "Name": "my-file-system",
            "NumberOfMountTargets": 3,
            "SizeInBytes": {
                "Value": 6144,
                "Timestamp": 1600991437.0,
                "ValueInIA": 0,
                "ValueInStandard": 6144
            },
            "PerformanceMode": "generalPurpose",
            "Encrypted": true,
            "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example",
            "ThroughputMode": "bursting",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-file-system"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie im Benutzerhandbuch zu Amazon Elastic File System unter Managing EFS file systems.

Das folgende Codebeispiel zeigt, wie describe-mount-targets verwendet wird.

AWS CLI

So beschreiben Sie ein Mount-Ziel

Im folgenden describe-mount-targets-Beispiel wird das angegebene Mount-Ziel beschrieben.

aws efs describe-mount-targets \
    --mount-target-id fsmt-f9a14450

Ausgabe:

{
    "MountTargets": [
        {
            "OwnerId": "123456789012",
            "MountTargetId": "fsmt-f9a14450",
            "FileSystemId": "fs-c7a0456e",
            "SubnetId": "subnet-02bf4c428bexample",
            "LifeCycleState": "creating",
            "IpAddress": "10.0.1.24",
            "NetworkInterfaceId": "eni-02d542216aexample",
            "AvailabilityZoneId": "use2-az2",
            "AvailabilityZoneName": "us-east-2b",
            "VpcId": "vpc-0123456789abcdef0"
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen von Mount-Zielen im Benutzerhandbuch zu Amazon Elastic File System.

Das folgende Codebeispiel zeigt, wie describe-tags verwendet wird.

AWS CLI

So beschreiben Sie die Tags für ein Dateisystem

Im folgenden describe-tags-Beispiel werden die Tags das angegebene Dateisystem beschrieben.

aws efs describe-tags \
    --file-system-id fs-c7a0456e

Ausgabe:

{
    "Tags": [
        {
            "Key": "Name",
            "Value": "my-file-system"
        },
        {
            "Key": "Department",
            "Value": "Business Intelligence"
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten von Dateisystem-Tags im Benutzerhandbuch zu Amazon Elastic File System.

  • API-Details finden Sie in der AWS CLI-Befehlsreferenz unter DescribeTags.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So rufen Sie die Tags für eine Ressource ab

Im folgenden list-tags-for-resource-Beispiel werden die Tags abgerufen, die dem angegebenen Dateisystem zugeordnet sind.

aws efs list-tags-for-resource \
    --resource-id fs-c7a0456e

Ausgabe:

{
    "Tags": [
        {
            "Key": "Name",
            "Value": "my-file-system"
        },
        {
            "Key": "Department",
            "Value": "Business Intelligence"
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten von Dateisystem-Tags im Benutzerhandbuch zu Amazon Elastic File System.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So markieren Sie eine Ressource

Im folgenden tag-resource-Beispiel wird dem Dateisystem das Tag Department=Business Intelligence hinzugefügt.

aws efs tag-resource \
    --resource-id fs-c7a0456e \
    --tags Key=Department,Value="Business Intelligence"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwalten von Dateisystem-Tags im Benutzerhandbuch zu Amazon Elastic File System.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie ein Tag aus einer Ressource

Im folgenden untag-resource-Beispiel wird das Tag mit dem Tag-Schlüssel Department aus dem angegebenen Dateisystem entfernt.

aws efs untag-resource \
    --resource-id fs-c7a0456e \
    --tag-keys Department

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwalten von Dateisystem-Tags im Benutzerhandbuch zu Amazon Elastic File System.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.