Ejemplos de Amazon EFS con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de Amazon EFS con las Herramientas para PowerShell V4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante Herramientas de AWS para PowerShell V4 con Amazon EFS.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EFSMountTargetSecurityGroup.

Herramientas para PowerShell V4

Ejemplo 1: Se actualizan los grupos de seguridad en vigor para el destino de montaje especificado. Se pueden especificar hasta cinco con el formato “sg-xxxxxxxx”.

Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3
  • Para obtener información sobre la API, consulte ModifyMountTargetSecurityGroups en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EFSFileSystem.

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve la colección de todos los sistemas de archivos que son propiedad de la cuenta del autor de la llamada en la región.

Get-EFSFileSystem

Salida:

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

Ejemplo 2: Se devuelve información detallada del sistema de archivos especificado.

Get-EFSFileSystem -FileSystemId fs-1a2b3c4d

Ejemplo 3: Se devuelven los detalles de un sistema de archivos mediante el token de creación de idempotencia que se especificó en el momento de la creación del sistema de archivos.

Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555
  • Para obtener información sobre la API, consulte DescribeFileSystems en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EFSMountTarget.

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve la colección de destinos de montaje asociada al sistema de archivos especificado.

Get-EFSMountTarget -FileSystemId fs-1a2b3c4d

Salida:

FileSystemId : fs-1a2b3c4d IpAddress : 10.0.0.131 LifeCycleState : available MountTargetId : fsmt-1a2b3c4d NetworkInterfaceId : eni-1a2b3c4d OwnerId : 123456789012 SubnetId : subnet-1a2b3c4d
  • Para obtener información sobre la API, consulte DescribeMountTargets en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EFSMountTargetSecurityGroup.

Herramientas para PowerShell V4

Ejemplo 1: Se devuelven los identificadores de los grupos de seguridad actualmente asignados a la interfaz de red asociada al destino de montaje.

Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d

Salida:

sg-1a2b3c4d

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EFSTag.

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve la colección de etiquetas asociada actualmente al sistema de archivos especificado.

Get-EFSTag -FileSystemId fs-1a2b3c4d

Salida:

Key Value --- ----- Name My File System tagkey1 tagvalue1 tagkey2 tagvalue2
  • Para obtener información sobre la API, consulte DescribeTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EFSFileSystem.

Herramientas para PowerShell V4

Ejemplo 1: Se crea un nuevo sistema de archivos vacío. El token utilizado para garantizar la creación de idempotencia se generará automáticamente y se podrá acceder a él desde el miembro CreationToken del objeto devuelto.

New-EFSFileSystem

Salida:

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

Ejemplo 2: Se crea un nuevo sistema de archivos vacío mediante un token personalizado para garantizar la creación de idempotencia.

New-EFSFileSystem -CreationToken "MyUniqueToken"
  • Para obtener información sobre la API, consulte CreateFileSystem en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EFSMountTarget.

Herramientas para PowerShell V4

Ejemplo 1: Se crea un nuevo destino de montaje para un sistema de archivos. La subred especificada se utilizará para determinar la nube privada virtual (VPC) en la que se creará el destino de montaje y la dirección IP que se asignará automáticamente (del intervalo de direcciones de la subred). La dirección IP asignada se puede usar para montar posteriormente este sistema de archivos en una instancia de Amazon EC2. Como no se especificó ningún grupo de seguridad, la interfaz de red creada para el destino se asocia al grupo de seguridad predeterminado de la VPC de la subred.

New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d

Salida:

FileSystemId : fs-1a2b3c4d IpAddress : 10.0.0.131 LifeCycleState : creating MountTargetId : fsmt-1a2b3c4d NetworkInterfaceId : eni-1a2b3c4d OwnerId : 123456789012 SubnetId : subnet-1a2b3c4d

Ejemplo 2: Se crea un nuevo destino de montaje para el sistema de archivos especificado con una dirección IP asignada automáticamente. La interfaz de red creada para el destino de montaje está asociada a los grupos de seguridad especificados (se pueden especificar hasta cinco, con el formato “sg-xxxxxxxx”).

New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3

Ejemplo 3: Se crea un nuevo destino de montaje para el sistema de archivos especificado con la dirección IP especificada.

New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131
  • Para obtener información sobre la API, consulte CreateMountTarget en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EFSTag.

Herramientas para PowerShell V4

Ejemplo 1: Se aplica la colección de etiquetas al sistema de archivos especificado. Si ya existe una etiqueta con la clave especificada en el sistema de archivos, se actualiza el valor de la etiqueta.

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

Ejemplo 2: Se establece la etiqueta de nombre para el sistema de archivos especificado. Este valor se devuelve junto con otros detalles del sistema de archivos cuando se utiliza el cmdlet Get-EFSFileSystem.

New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"}
  • Para obtener información sobre la API, consulte CreateTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EFSFileSystem.

Herramientas para PowerShell V4

Ejemplo 1: Se elimina el sistema de archivos especificado que ya no está en uso (si el sistema de archivos tiene destinos de montaje, primero hay que eliminarlos). Se le solicitará confirmación antes de continuar con el cmdlet; para suprimir la confirmación, utilice el modificador -Force.

Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d
  • Para obtener información sobre la API, consulte DeleteFileSystem en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EFSMountTarget.

Herramientas para PowerShell V4

Ejemplo 1: Se elimina el destino de montaje especificado. Se le solicitará una confirmación antes de continuar con la operación. Para suprimir la petición, utilice el modificador -Force. Tenga en cuenta que esta operación interrumpe de manera forzosa cualquier montaje del sistema de archivos a través del destino; si es viable, puede considerar la posibilidad de desmontar el sistema de archivos antes de ejecutar este comando.

Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
  • Para obtener información sobre la API, consulte DeleteMountTarget en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EFSTag.

Herramientas para PowerShell V4

Ejemplo 1: Se elimina la colección de una o varias etiquetas de un sistema de archivos. Se le solicitará confirmación antes de continuar con el cmdlet; para suprimir la confirmación, utilice el modificador -Force.

Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2"
  • Para obtener información sobre la API, consulte DeleteTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).