Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/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
<a name="cli_2_efs_code_examples"></a>

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.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `create-file-system`
<a name="efs_CreateFileSystem_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [CreateFileSystem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/create-file-system.html)em *Referência de AWS CLI Comandos*. 

### `create-mount-target`
<a name="efs_CreateMountTarget_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [CreateMountTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/create-mount-target.html)em *Referência de AWS CLI Comandos*. 

### `delete-file-system`
<a name="efs_DeleteFileSystem_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/delete-efs-fs.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [DeleteFileSystem](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/delete-file-system.html)em *Referência de AWS CLI Comandos*. 

### `delete-mount-target`
<a name="efs_DeleteMountTarget_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [DeleteMountTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/delete-mount-target.html)em *Referência de AWS CLI Comandos*. 

### `describe-file-systems`
<a name="efs_DescribeFileSystems_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/managing.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [DescribeFileSystems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/describe-file-systems.html)em *Referência de AWS CLI Comandos*. 

### `describe-mount-targets`
<a name="efs_DescribeMountTargets_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [DescribeMountTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/describe-mount-targets.html)em *Referência de AWS CLI Comandos*. 

### `describe-tags`
<a name="efs_DescribeTags_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/describe-tags.html)em *Referência de AWS CLI Comandos*. 

### `list-tags-for-resource`
<a name="efs_ListTagsForResource_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*. 

### `tag-resource`
<a name="efs_TagResource_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/tag-resource.html)em *Referência de AWS CLI Comandos*. 

### `untag-resource`
<a name="efs_UntagResource_cli_2_topic"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-tags.html) no *Guia do usuário do Amazon Elastic File System*.  
+  Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/untag-resource.html)em *Referência de AWS CLI Comandos*.