EFSExemplos da Amazon usando AWS CLI - AWS Command Line Interface
Ações

Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

EFSExemplos da Amazon usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com a AmazonEFS.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar create-file-system.

AWS CLI

Para criar um sistema de arquivos criptografado

O create-file-system exemplo a seguir cria um sistema de arquivos criptografado usando o padrãoCMK. Ele também adiciona a tagName=my-file-system.

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

Saída:

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

Para obter mais informações, consulte Criação de sistemas de EFS arquivos da Amazon no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte CreateFileSystemna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-mount-target.

AWS CLI

Para criar um alvo de montagem

O create-mount-target exemplo a seguir cria um destino de montagem para o sistema de arquivos especificado.

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

Saída:

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

Para obter mais informações, consulte Criação de destinos de montagem no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte CreateMountTargetna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-file-system.

AWS CLI

Para excluir um sistema de arquivos

O delete-file-system exemplo a seguir exclui o sistema de arquivos especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Excluir um sistema de EFS arquivos da Amazon no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte DeleteFileSystemna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-mount-target.

AWS CLI

Para excluir um alvo de montagem

O delete-mount-target exemplo a seguir exclui o destino de montagem especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Criação de destinos de montagem no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte DeleteMountTargetna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar describe-file-systems.

AWS CLI

Para descrever um sistema de arquivos

O describe-file-systems exemplo a seguir descreve o sistema de arquivos especificado.

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

Saída:

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

Para obter mais informações, consulte Gerenciamento de sistemas de EFS arquivos da Amazon no Guia do usuário do Amazon Elastic File System.

O código de exemplo a seguir mostra como usar describe-mount-targets.

AWS CLI

Para descrever um alvo de montagem

O describe-mount-targets exemplo a seguir descreve o destino de montagem especificado.

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

Saída:

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

Para obter mais informações, consulte Criação de destinos de montagem no Guia do usuário do Amazon Elastic File System.

O código de exemplo a seguir mostra como usar describe-tags.

AWS CLI

Para descrever as tags de um sistema de arquivos

O describe-tags exemplo a seguir descreve as tags do sistema de arquivos especificado.

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

Saída:

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

Para obter mais informações, consulte Gerenciamento de tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte DescribeTagsna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para recuperar as tags de um recurso

O list-tags-for-resource exemplo a seguir recupera as tags associadas ao sistema de arquivos especificado.

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

Saída:

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

Para obter mais informações, consulte Gerenciamento de tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Para marcar um recurso

O tag-resource exemplo a seguir adiciona a tag Department=Business Intelligence ao sistema de arquivos especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Gerenciamento de tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte TagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Para remover uma tag de um recurso

O untag-resource exemplo a seguir remove a tag com a chave da Department tag do sistema de arquivos especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Gerenciamento de tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

  • Para API obter detalhes, consulte UntagResourcena Referência de AWS CLI Comandos.