

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 básicos para o Amazon EFS usando AWS SDKs
<a name="efs_code_examples_basics"></a>

Os exemplos de código a seguir mostram como usar os conceitos básicos do Amazon Elastic File System com AWS SDKs. 

**Contents**
+ [Ações](efs_code_examples_actions.md)
  + [`CreateFileSystem`](efs_example_efs_CreateFileSystem_section.md)
  + [`CreateMountTarget`](efs_example_efs_CreateMountTarget_section.md)
  + [`DeleteFileSystem`](efs_example_efs_DeleteFileSystem_section.md)
  + [`DeleteMountTarget`](efs_example_efs_DeleteMountTarget_section.md)
  + [`DescribeFileSystems`](efs_example_efs_DescribeFileSystems_section.md)
  + [`DescribeMountTargets`](efs_example_efs_DescribeMountTargets_section.md)
  + [`DescribeTags`](efs_example_efs_DescribeTags_section.md)

# Ações para o Amazon EFS usando AWS SDKs
<a name="efs_code_examples_actions"></a>

Os exemplos de código a seguir demonstram como realizar ações individuais do Amazon EFS com AWS SDKs. Cada exemplo inclui um link para GitHub, onde você pode encontrar instruções para configurar e executar o código. 

 Os exemplos a seguir incluem apenas as ações mais utilizadas. Consulte uma lista completa na [Referência de API do Amazon Elastic File System](https://docs.aws.amazon.com/efs/latest/ug/api-reference.html). 

**Topics**
+ [`CreateFileSystem`](efs_example_efs_CreateFileSystem_section.md)
+ [`CreateMountTarget`](efs_example_efs_CreateMountTarget_section.md)
+ [`DeleteFileSystem`](efs_example_efs_DeleteFileSystem_section.md)
+ [`DeleteMountTarget`](efs_example_efs_DeleteMountTarget_section.md)
+ [`DescribeFileSystems`](efs_example_efs_DescribeFileSystems_section.md)
+ [`DescribeMountTargets`](efs_example_efs_DescribeMountTargets_section.md)
+ [`DescribeTags`](efs_example_efs_DescribeTags_section.md)

# Usar `CreateFileSystem` com uma CLI
<a name="efs_example_efs_CreateFileSystem_section"></a>

Os exemplos de código a seguir mostram como usar o `CreateFileSystem`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: cria um sistema de arquivos vazio. O token usado para garantir a criação idempotente será gerado automaticamente e poderá ser acessado pelo membro `CreationToken` do objeto retornado.**  

```
New-EFSFileSystem
```
**Saída**:  

```
CreationTime         : 5/26/2015 4:02:38 PM
CreationToken        : 1a2bff54-85e0-4747-bd95-7bc172c4f555
FileSystemId         : fs-1a2b3c4d
LifeCycleState       : creating
Name                 :
NumberOfMountTargets : 0
OwnerId              : 123456789012
SizeInBytes          : Amazon.ElasticFileSystem.Model.FileSystemSize
```
**Exemplo 2: cria um sistema de arquivos vazio usando um token personalizado para garantir uma criação idempotente.**  

```
New-EFSFileSystem -CreationToken "MyUniqueToken"
```
+  Para obter detalhes da API, consulte [CreateFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: cria um sistema de arquivos vazio. O token usado para garantir a criação idempotente será gerado automaticamente e poderá ser acessado pelo membro `CreationToken` do objeto retornado.**  

```
New-EFSFileSystem
```
**Saída**:  

```
CreationTime         : 5/26/2015 4:02:38 PM
CreationToken        : 1a2bff54-85e0-4747-bd95-7bc172c4f555
FileSystemId         : fs-1a2b3c4d
LifeCycleState       : creating
Name                 :
NumberOfMountTargets : 0
OwnerId              : 123456789012
SizeInBytes          : Amazon.ElasticFileSystem.Model.FileSystemSize
```
**Exemplo 2: cria um sistema de arquivos vazio usando um token personalizado para garantir uma criação idempotente.**  

```
New-EFSFileSystem -CreationToken "MyUniqueToken"
```
+  Para obter detalhes da API, consulte [CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

# Usar `CreateMountTarget` com uma CLI
<a name="efs_example_efs_CreateMountTarget_section"></a>

Os exemplos de código a seguir mostram como usar o `CreateMountTarget`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: cria um destino de montagem para um sistema de arquivos. A sub-rede especificada será usada para determinar a nuvem privada virtual (VPC) na qual o destino de montagem será criado e o endereço IP que será atribuído automaticamente (do intervalo de endereços da sub-rede). O endereço IP atribuído pode ser usado para, em seguida, montar esse sistema de arquivos em uma instância do Amazon EC2. Como nenhum grupo de segurança foi especificado, a interface de rede criada para o destino está associada ao grupo de segurança padrão para a VPC da sub-rede.**  

```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d
```
**Saída**:  

```
FileSystemId       : fs-1a2b3c4d
IpAddress          : 10.0.0.131
LifeCycleState     : creating
MountTargetId      : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId            : 123456789012
SubnetId           : subnet-1a2b3c4d
```
**Exemplo 2: cria um destino de montagem para o sistema de arquivos especificado com endereço IP atribuído automaticamente. A interface de rede criada para o destino de montagem está associada aos grupos de segurança especificados (até cinco, no formato “sg-xxxxxxxx”, podem ser especificados).**  

```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3
```
**Exemplo 3: cria um destino de montagem para o sistema de arquivos especificado com o endereço IP especificado.**  

```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131
```
+  Para obter detalhes da API, consulte [CreateMountTarget](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: cria um destino de montagem para um sistema de arquivos. A sub-rede especificada será usada para determinar a nuvem privada virtual (VPC) na qual o destino de montagem será criado e o endereço IP que será atribuído automaticamente (do intervalo de endereços da sub-rede). O endereço IP atribuído pode ser usado para, em seguida, montar esse sistema de arquivos em uma instância do Amazon EC2. Como nenhum grupo de segurança foi especificado, a interface de rede criada para o destino está associada ao grupo de segurança padrão para a VPC da sub-rede.**  

```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d
```
**Saída**:  

```
FileSystemId       : fs-1a2b3c4d
IpAddress          : 10.0.0.131
LifeCycleState     : creating
MountTargetId      : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId            : 123456789012
SubnetId           : subnet-1a2b3c4d
```
**Exemplo 2: cria um destino de montagem para o sistema de arquivos especificado com endereço IP atribuído automaticamente. A interface de rede criada para o destino de montagem está associada aos grupos de segurança especificados (até cinco, no formato “sg-xxxxxxxx”, podem ser especificados).**  

```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3
```
**Exemplo 3: cria um destino de montagem para o sistema de arquivos especificado com o endereço IP especificado.**  

```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131
```
+  Para obter detalhes da API, consulte [CreateMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

# Usar `DeleteFileSystem` com uma CLI
<a name="efs_example_efs_DeleteFileSystem_section"></a>

Os exemplos de código a seguir mostram como usar o `DeleteFileSystem`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: exclui o sistema de arquivos especificado que não está mais em uso (se o sistema de arquivos tiver destinos de montagem, eles deverão ser removidos primeiro). É solicitada uma confirmação antes que o cmdlet continue. Para ignorar a confirmação, use a opção `-Force`.**  

```
Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
+  Para obter detalhes da API, consulte [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: exclui o sistema de arquivos especificado que não está mais em uso (se o sistema de arquivos tiver destinos de montagem, eles deverão ser removidos primeiro). É solicitada uma confirmação antes que o cmdlet continue. Para ignorar a confirmação, use a opção `-Force`.**  

```
Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
+  Para obter detalhes da API, consulte [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

# Usar `DeleteMountTarget` com uma CLI
<a name="efs_example_efs_DeleteMountTarget_section"></a>

Os exemplos de código a seguir mostram como usar o `DeleteMountTarget`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: exclui o destino de montagem especificado. A confirmação será solicitada antes que a operação continue. Para suprimir o prompt, use a opção `-Force`. Observe que essa operação interrompe à força qualquer montagem do sistema de arquivos por meio do destino. Convém considerar a desmontagem do sistema de arquivos antes de executar esse comando, se possível.**  

```
Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
```
+  Para obter detalhes da API, consulte [DeleteMountTarget](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: exclui o destino de montagem especificado. A confirmação será solicitada antes que a operação continue. Para suprimir o prompt, use a opção `-Force`. Observe que essa operação interrompe à força qualquer montagem do sistema de arquivos por meio do destino. Convém considerar a desmontagem do sistema de arquivos antes de executar esse comando, se possível.**  

```
Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
```
+  Para obter detalhes da API, consulte [DeleteMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

# Usar `DescribeFileSystems` com uma CLI
<a name="efs_example_efs_DescribeFileSystems_section"></a>

Os exemplos de código a seguir mostram como usar o `DescribeFileSystems`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: retorna a coleção de todos os sistemas de arquivos de propriedade da conta do chamador na região.**  

```
Get-EFSFileSystem
```
**Saída**:  

```
CreationTime         : 5/26/2015 4:02:38 PM
CreationToken        : 1a2bff54-85e0-4747-bd95-7bc172c4f555
FileSystemId         : fs-1a2b3c4d
LifeCycleState       : available
Name                 :
NumberOfMountTargets : 0
OwnerId              : 123456789012
SizeInBytes          : Amazon.ElasticFileSystem.Model.FileSystemSize

CreationTime         : 5/26/2015 4:06:23 PM
CreationToken        : 2b4daa14-85e0-4747-bd95-7bc172c4f555
FileSystemId         : fs-4d3c2b1a
...
```
**Exemplo 2: retorna os detalhes do sistema de arquivos especificado.**  

```
Get-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
**Exemplo 3: retorna os detalhes de um sistema de arquivos usando o token de criação de idempotência que foi especificado no momento em que o sistema de arquivos foi criado.**  

```
Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555
```
+  Para obter detalhes da API, consulte [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: retorna a coleção de todos os sistemas de arquivos de propriedade da conta do chamador na região.**  

```
Get-EFSFileSystem
```
**Saída**:  

```
CreationTime         : 5/26/2015 4:02:38 PM
CreationToken        : 1a2bff54-85e0-4747-bd95-7bc172c4f555
FileSystemId         : fs-1a2b3c4d
LifeCycleState       : available
Name                 :
NumberOfMountTargets : 0
OwnerId              : 123456789012
SizeInBytes          : Amazon.ElasticFileSystem.Model.FileSystemSize

CreationTime         : 5/26/2015 4:06:23 PM
CreationToken        : 2b4daa14-85e0-4747-bd95-7bc172c4f555
FileSystemId         : fs-4d3c2b1a
...
```
**Exemplo 2: retorna os detalhes do sistema de arquivos especificado.**  

```
Get-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
**Exemplo 3: retorna os detalhes de um sistema de arquivos usando o token de criação de idempotência que foi especificado no momento em que o sistema de arquivos foi criado.**  

```
Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555
```
+  Para obter detalhes da API, consulte [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

# Usar `DescribeMountTargets` com uma CLI
<a name="efs_example_efs_DescribeMountTargets_section"></a>

Os exemplos de código a seguir mostram como usar o `DescribeMountTargets`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: retorna a coleção de destinos de montagem associados ao sistema de arquivos especificado.**  

```
Get-EFSMountTarget -FileSystemId fs-1a2b3c4d
```
**Saída**:  

```
FileSystemId       : fs-1a2b3c4d
IpAddress          : 10.0.0.131
LifeCycleState     : available
MountTargetId      : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId            : 123456789012
SubnetId           : subnet-1a2b3c4d
```
+  Para obter detalhes da API, consulte [DescribeMountTargets](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: retorna a coleção de destinos de montagem associados ao sistema de arquivos especificado.**  

```
Get-EFSMountTarget -FileSystemId fs-1a2b3c4d
```
**Saída**:  

```
FileSystemId       : fs-1a2b3c4d
IpAddress          : 10.0.0.131
LifeCycleState     : available
MountTargetId      : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId            : 123456789012
SubnetId           : subnet-1a2b3c4d
```
+  Para obter detalhes da API, consulte [DescribeMountTargets](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

# Usar `DescribeTags` com uma CLI
<a name="efs_example_efs_DescribeTags_section"></a>

Os exemplos de código a seguir mostram como usar o `DescribeTags`.

------
#### [ CLI ]

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

------
#### [ PowerShell ]

**Ferramentas para PowerShell V4**  
**Exemplo 1: retorna a coleção de tags atualmente associadas ao sistema de arquivos especificado.**  

```
Get-EFSTag -FileSystemId fs-1a2b3c4d
```
**Saída**:  

```
Key         Value
---         -----
Name        My File System
tagkey1     tagvalue1
tagkey2     tagvalue2
```
+  Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: retorna a coleção de tags atualmente associadas ao sistema de arquivos especificado.**  

```
Get-EFSTag -FileSystemId fs-1a2b3c4d
```
**Saída**:  

```
Key         Value
---         -----
Name        My File System
tagkey1     tagvalue1
tagkey2     tagvalue2
```
+  Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------