Exemples d’utilisation de l’AWS CLI avec Amazon EFS - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Amazon EFS

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Amazon EFS.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-file-system.

AWS CLI

Pour créer un système de fichiers chiffrés

L’exemple create-file-system suivant crée un système de fichiers chiffré à l’aide de la clé CMK par défaut. Il ajoute également la balise Name=my-file-system.

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

Sortie :

{
    "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"
        }
    ]
}

Pour plus d’informations, consultez Création de systèmes de fichiers Amazon EFS dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez CreateFileSystem dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-mount-target.

AWS CLI

Pour créer une cible de montage

L’exemple create-mount-target suivant crée une cible de montage pour le système de fichiers spécifié.

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

Sortie :

{
    "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"
}

Pour plus d’informations, consultez Création de cibles de montage dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez CreateMountTarget dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-file-system.

AWS CLI

Pour supprimer un système de fichiers

L’exemple delete-file-system suivant supprime le système de fichiers spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Suppression d’un système de fichiers Amazon EFS dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez DeleteFileSystem dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-mount-target.

AWS CLI

Pour supprimer une cible de montage

L’exemple delete-mount-target suivant supprime la cible de montage spécifiée.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Création de cibles de montage dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez DeleteMountTarget dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-file-systems.

AWS CLI

Pour décrire un système de fichiers

L’exemple describe-file-systems suivant décrit le système de fichiers spécifié.

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

Sortie :

{
    "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"
                }
            ]
        }
    ]
}

Pour plus d’informations, consultez Gestion des systèmes de fichiers Amazon EFS dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez DescribeFileSystems dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-mount-targets.

AWS CLI

Pour décrire une cible de montage

L’exemple describe-mount-targets suivant décrit la cible de montage spécifiée.

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

Sortie :

{
    "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"
        }
    ]
}

Pour plus d’informations, consultez Création de cibles de montage dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez DescribeMountTargets dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-tags.

AWS CLI

Pour décrire les balises d’un système de fichiers

L’exemple describe-tags suivant décrit les balises pour le système de fichiers spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Gestion des balises de système de fichiers dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez DescribeTags dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Pour récupérer les balises d’une ressource

L’exemple list-tags-for-resource suivant récupère les balises associées au système de fichiers spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Gestion des balises de système de fichiers dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Pour baliser une ressource

L’exemple tag-resource suivant ajoute la balise Department=Business Intelligence au système de fichiers spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Gestion des balises de système de fichiers dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Pour supprimer une balise d’une ressource

L’exemple untag-resource suivant supprime la balise avec la clé de balise Department du système de fichiers spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Gestion des balises de système de fichiers dans le Guide de l’utilisateur Amazon Elastic File System.

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.