Esempi di utilizzo di Amazon EFS AWS CLI

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

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

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Azioni

create-file-system

Il seguente esempio di codice mostra come usarecreate-file-system.

AWS CLI

Creare un file system crittografato

L’esempio create-file-system seguente 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 i dettagli sull'API, consulta CreateFileSystem AWS CLICommand Reference.

create-mount-target

Il seguente esempio di codice mostra come utilizzarecreate-mount-target.

AWS CLI

Come creare una destinazione di montaggio

L’esempio create-mount-target seguente 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 i dettagli sull'API, consulta CreateMountTarget AWS CLICommand Reference.

delete-file-system

Il seguente esempio di codice mostra come utilizzaredelete-file-system.

AWS CLI

Come eliminare un file system

L’esempio delete-file-system seguente 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 i dettagli sull'API, consulta DeleteFileSystem AWS CLICommand Reference.

delete-mount-target

Il seguente esempio di codice mostra come utilizzaredelete-mount-target.

AWS CLI

Come eliminare una destinazione di montaggio

L’esempio delete-mount-target seguente 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 i dettagli sull'API, consulta DeleteMountTarget AWS CLICommand Reference.

describe-file-systems

Il seguente esempio di codice mostra come utilizzaredescribe-file-systems.

AWS CLI

Come descrivere un file system

L’esempio describe-file-systems seguente 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 i dettagli sull'API, consulta DescribeFileSystems AWS CLICommand Reference.

describe-mount-targets

Il seguente esempio di codice mostra come utilizzaredescribe-mount-targets.

AWS CLI

Come descrivere una destinazione di montaggio

L’esempio describe-mount-targets seguente 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 i dettagli sull'API, consulta DescribeMountTargets AWS CLICommand Reference.

describe-tags

Il seguente esempio di codice mostra come utilizzaredescribe-tags.

AWS CLI

Come descrivere i tag di un file system

L’esempio describe-tags seguente 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 i dettagli sull'API, consulta DescribeTags AWS CLICommand Reference.

list-tags-for-resource

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag per una risorsa

L’esempio list-tags-for-resource seguente 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 i dettagli sull'API, consulta ListTagsForResource AWS CLICommand Reference.

tag-resource

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come taggare a una risorsa

L’esempio tag-resource seguente 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 i dettagli sull'API, consulta TagResource AWS CLICommand Reference.

untag-resource

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere un tag da una risorsa

L’esempio untag-resource seguente 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 sull'API, consulta UntagResource AWS CLICommand Reference.