Esempi di utilizzo di Amazon EFS con AWS CLI - AWS Command Line Interface
Operazioni

Esempi di utilizzo di Amazon EFS con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con Amazon EFS.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare create-file-system.

AWS CLI

Creare un file system crittografato

Nell’esempio seguente create-file-system crea un file system crittografato utilizzando la chiave gestita dal cliente (CMK) predefinita. Aggiunge anche il tag Name=my-file-system.

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

Output:

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

Per ulteriori informazioni, consulta Creazione di file system Amazon EFS nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta CreateFileSystem in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-mount-target.

AWS CLI

Come creare una destinazione di montaggio

Nell’esempio seguente create-mount-target crea una destinazione di montaggio per il file system specificato.

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

Output:

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

Per ulteriori informazioni, consulta Creazione di destinazioni di montaggio nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta CreateMountTarget in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-file-system.

AWS CLI

Per eliminare un file system

Nell’esempio seguente delete-file-system elimina il file system specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Cancellazione di un file system Amazon EFS nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta DeleteFileSystem in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-mount-target.

AWS CLI

Come eliminare una destinazione di montaggio

Nell’esempio seguente delete-mount-target elimina la destinazione di montaggio specificata.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Creazione di destinazioni di montaggio nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta DeleteMountTarget in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-file-systems.

AWS CLI

Come descrivere un file system

Nell’esempio seguente describe-file-systems descrive il file system specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei file system Amazon EFS nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta DescribeFileSystems in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-mount-targets.

AWS CLI

Come descrivere una destinazione di montaggio

Nell’esempio seguente describe-mount-targets descrive la destinazione di montaggio specificata.

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

Output:

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

Per ulteriori informazioni, consulta Creazione di destinazioni di montaggio nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta DescribeMountTargets in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-tags.

AWS CLI

Come descrivere i tag di un file system

Nell’esempio seguente describe-tags descrive i tag per il file system specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei tag del file system nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull’API, consulta DescribeTags in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come recuperare i tag di una risorsa

Nell’esempio seguente list-tags-for-resource recupera i tag associati al file system specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei tag del file system nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come aggiungere un tag a una risorsa

Nell’esempio seguente tag-resource aggiunge il tag Department=Business Intelligence al file system specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dei tag del file system nella Guida per l’utente di Amazon Elastic File System.

  • Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere un tag da una risorsa

Nell’esempio seguente untag-resource rimuove un tag con la chiave Department dal file system specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gestione dei tag del file system nella Guida per l’utente di Amazon Elastic File System.

  • Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.