EFSExemplos da Amazon usando AWS CLI - AWS SDKExemplos de código
Ações

Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples.

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, é possível 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.