Exemplos do Amazon EFS usando ferramentas para PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

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 ferramentas para PowerShell V4

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a Ferramentas da AWS para PowerShell V4 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 Edit-EFSMountTargetSecurityGroup.

Ferramentas para PowerShell V4

Exemplo 1: atualiza os grupos de segurança em vigor para o destino de montagem especificado. Até 5 podem ser especificados, no formato “sg-xxxxxxxx".

Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3

O código de exemplo a seguir mostra como usar Get-EFSFileSystem.

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 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 DescribeFileSystemsem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar Get-EFSMountTarget.

Ferramentas para PowerShell V4

Exemplo 1: retorna a coleção dos 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 DescribeMountTargetsem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar Get-EFSMountTargetSecurityGroup.

Ferramentas para PowerShell V4

Exemplo 1: retorna os IDs dos grupos de segurança atualmente atribuídos à interface de rede associada ao destino de montagem.

Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d

Saída:

sg-1a2b3c4d

O código de exemplo a seguir mostra como usar Get-EFSTag.

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 DescribeTagsem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar New-EFSFileSystem.

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 CreateFileSystemem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar New-EFSMountTarget.

Ferramentas para PowerShell V4

Exemplo 1: cria um novo 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 montar esse sistema de arquivos em uma EC2 instância da Amazon. 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 novo 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é 5, 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 CreateMountTargetem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar New-EFSTag.

Ferramentas para PowerShell V4

Exemplo 1: aplica a coleção de tags ao sistema de arquivos especificado. Se uma tag com a chave especificada já existir no sistema de arquivos, o valor da tag será atualizado.

New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="tagkey1";Value="tagvalue1"},@{Key="tagkey2";Value="tagvalue2"}

Exemplo 2: define a tag de nome para o sistema de arquivos especificado. Esse valor é retornado junto com outros detalhes do sistema de arquivos quando o Get-EFSFileSystem cmdlet é usado.

New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"}
  • Para obter detalhes da API, consulte CreateTagsem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar Remove-EFSFileSystem.

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 DeleteFileSystemem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar Remove-EFSMountTarget.

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. Esta operação interrompe à força qualquer montagem do sistema de arquivos por meio do destino. Convém desmontar o sistema de arquivos antes de executar esse comando, se possível.

Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
  • Para obter detalhes da API, consulte DeleteMountTargetem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

O código de exemplo a seguir mostra como usar Remove-EFSTag.

Ferramentas para PowerShell V4

Exemplo 1: exclui a coleção de uma ou mais tags de um sistema de arquivos. Você recebe um prompt de confirmação antes que o cmdlet continue. Para ignorar a confirmação, use a opção -Force.

Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2"
  • Para obter detalhes da API, consulte DeleteTagsem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).