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

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 AWS Cloud9 con las Herramientas para PowerShell V4

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V4 con AWS Cloud9.

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

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene información sobre los entornos de desarrollo de AWS Cloud9 especificados.

Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX,1980b80e5f584920801c09086667f0EX

Salida:

Arn         : arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX
Description : Created from CodeStar.
Id          : 685f892f431b45c2b28cb69eadcdb0EX
Lifecycle   : Amazon.Cloud9.Model.EnvironmentLifecycle
Name        : my-demo-ec2-env
OwnerArn    : arn:aws:iam::123456789012:user/MyDemoUser
Type        : ec2

Arn         : arn:aws:cloud9:us-east-1:123456789012:environment:1980b80e5f584920801c09086667f0EX
Description :
Id          : 1980b80e5f584920801c09086667f0EX
Lifecycle   : Amazon.Cloud9.Model.EnvironmentLifecycle
Name        : my-demo-ssh-env
OwnerArn    : arn:aws:iam::123456789012:user/MyDemoUser
Type        : ssh

Ejemplo 2: En este ejemplo se obtiene información sobre el estado de ciclo de vida del entorno de desarrollo de AWS Cloud9 especificado.

(Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX).Lifecycle

Salida:

FailureResource Reason Status
--------------- ------ ------
                       CREATED

  • Para obtener información sobre la API, consulte DescribeEnvironments 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-C9EnvironmentList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene una lista de los identificadores de entorno de desarrollo de AWS Cloud9 disponibles.

Get-C9EnvironmentList

Salida:

685f892f431b45c2b28cb69eadcdb0EX
1980b80e5f584920801c09086667f0EX

  • Para obtener información sobre la API, consulte ListEnvironments 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-C9EnvironmentMembershipList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene información sobre los miembros de entorno de un entorno de desarrollo de AWS Cloud9 especificado.

Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX

Salida:

EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : read-write
UserArn       : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId        : AIDAJ3BA6O2FMJWCWXHEX

EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : owner
UserArn       : arn:aws:iam::123456789012:user/MyDemoUser
UserId        : AIDAJ3LOROMOUXTBSU6EX

Ejemplo 2: En este ejemplo se obtiene información sobre el propietario del entorno de desarrollo de AWS Cloud9 especificado.

Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission owner

Salida:

EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : owner
UserArn       : arn:aws:iam::123456789012:user/MyDemoUser
UserId        : AIDAJ3LOROMOUXTBSU6EX

Ejemplo 3: En este ejemplo se obtiene información sobre el miembro de entorno especificado de varios entornos de desarrollo de AWS Cloud9.

Get-C9EnvironmentMembershipList -UserArn arn:aws:iam::123456789012:user/MyDemoUser

Salida:

EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/17/2018 7:48:14 PM
Permissions   : owner
UserArn       : arn:aws:iam::123456789012:user/MyDemoUser
UserId        : AIDAJ3LOROMOUXTBSU6EX

EnvironmentId : 1980b80e5f584920801c09086667f0EX
LastAccess    : 1/16/2018 11:21:24 PM
Permissions   : owner
UserArn       : arn:aws:iam::123456789012:user/MyDemoUser
UserId        : AIDAJ3LOROMOUXTBSU6EX

  • Para obtener información sobre la API, consulte DescribeEnvironmentMemberships 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-C9EnvironmentStatus.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene información sobre el entorno de desarrollo de AWS Cloud9 especificado.

Get-C9EnvironmentStatus -EnvironmentId 349c86d4579e4e7298d500ff57a6b2EX

Salida:

Message                     Status
-------                     ------
Environment is ready to use ready

  • Para obtener información sobre la API, consulte DescribeEnvironmentStatus 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-C9EnvironmentEC2.

Herramientas para PowerShell V4

Ejemplo 1:En este ejemplo se crea un entorno de desarrollo de AWS Cloud9 con la configuración especificada, se lanza una instancia de Amazon Elastic Compute Cloud (Amazon EC2) y, a continuación, se realiza la conexión al entorno desde la instancia.

New-C9EnvironmentEC2 -Name my-demo-env -AutomaticStopTimeMinutes 60 -Description "My demonstration development environment." -InstanceType t2.micro -OwnerArn arn:aws:iam::123456789012:user/MyDemoUser -SubnetId subnet-d43a46EX

Salida:

ffd88420d4824eeeaeaa8a04bfde8cEX

  • Para obtener información sobre la API, consulte CreateEnvironmentEc2 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-C9EnvironmentMembership.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se añade el miembro de entorno especificado al entorno de desarrollo de AWS Cloud9 especificado.

New-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-write

Salida:

EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : read-write
UserArn       : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId        : AIDAJ3BA6O2FMJWCWXHEX

  • Para obtener información sobre la API, consulte CreateEnvironmentMembership 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-C9Environment.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el entorno de desarrollo de AWS Cloud9 especificado. Si hay una instancia de Amazon EC2 conectada al entorno, se termina también la instancia.

Remove-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX

  • Para obtener información sobre la API, consulte DeleteEnvironment 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-C9EnvironmentMembership.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el miembro de entorno especificado del entorno de desarrollo de AWS Cloud9 especificado.

Remove-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX

  • Para obtener información sobre la API, consulte DeleteEnvironmentMembership en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-C9Environment.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cambia la configuración especificada del entorno de desarrollo de AWS Cloud9 existente especificado.

Update-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Description "My changed demonstration development environment." -Name my-changed-demo-env

  • Para obtener información sobre la API, consulte UpdateEnvironment en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-C9EnvironmentMembership.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cambia la configuración del miembro de entorno existente especificado del entorno de desarrollo de AWS Cloud9 especificado.

Update-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-only

Salida:

EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : read-only
UserArn       : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId        : AIDAJ3BA6O2FMJWCWXHEX

  • Para obtener información sobre la API, consulte UpdateEnvironmentMembership en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).