Exemplos do Amazon EFS usando AWS CLI - AWS Exemplos de código do SDK
Ações

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

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á.

Exemplos do Amazon EFS 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 o Amazon EFS.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis 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, em que você pode encontrar instruções sobre como configurar e executar o código.

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 exemplo create-file-system a seguir cria um sistema de arquivos criptografado usando a CMK padrão. Ele também adiciona a tag Name=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 ter mais informações, consulte Criar sistemas de arquivos do Amazon EFS no Guia do usuário do Amazon Elastic File System.

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

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

AWS CLI

Para criar um destino de montagem

O exemplo create-mount-target 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 Criar destinos de montagem no Guia do usuário do Amazon Elastic File System.

  • Para obter detalhes da API, consulte CreateMountTargetem 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 exemplo delete-file-system 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 ter mais informações, consulte Excluir um sistema de arquivos do Amazon EFS no Guia do usuário do Amazon Elastic File System.

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

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

AWS CLI

Para excluir um destino de montagem

O exemplo delete-mount-target 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 Criar destinos de montagem no Guia do usuário do Amazon Elastic File System.

  • Para obter detalhes da API, consulte DeleteMountTargetem 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 exemplo describe-file-systems 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 ter mais informações, consulte Gerenciar sistemas de arquivos do Amazon EFS 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 destino de montagem

O exemplo describe-mount-targets 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 Criar 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 exemplo describe-tags a seguir descreve as tags para o 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 Gerenciar tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

  • Para obter detalhes da API, consulte DescribeTagsem 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 para um recurso

O exemplo list-tags-for-resource 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 Gerenciar 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

Como marcar um recurso

O exemplo tag-resource 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 Gerenciar tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

  • Para obter detalhes da API, consulte TagResourceem 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 exemplo untag-resource a seguir remove a tag com a chave de tag Department 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 Gerenciar tags do sistema de arquivos no Guia do usuário do Amazon Elastic File System.

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