Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Amazon EKS con herramientas para la PowerShell versión 4
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell versión 4 con Amazon EKS.
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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `Add-EKSResourceTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Add-EKSResourceTag`.
**Herramientas para la PowerShell versión 4**
**Ejemplo 1: Este cmdlet asocia las etiquetas especificadas a un recurso con el resourceArn especificado.**
```
Add-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -Tag @{Name = "EKSPRODCLUSTER"}
```
+ Para obtener más información sobre la API, consulte [TagResource Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-EKSCluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSCluster`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet devuelve información descriptiva sobre un clúster de Amazon EKS.**
```
Get-EKSCluster -Name "PROD"
```
**Salida:**
```
Arn : arn:aws:eks:us-west-2:012345678912:cluster/PROD
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken :
CreatedAt : 12/25/2019 6:46:17 AM
Endpoint : https://669608765450FBBE54D1D78A3D71B72C.gr8.us-west-2.eks.amazonaws.com
Identity : Amazon.EKS.Model.Identity
Logging : Amazon.EKS.Model.Logging
Name : PROD
PlatformVersion : eks.7
ResourcesVpcConfig : Amazon.EKS.Model.VpcConfigResponse
RoleArn : arn:aws:iam::012345678912:role/eks-iam-role
Status : ACTIVE
Tags : {}
Version : 1.14
```
+ Para obtener más información sobre la API, consulte [DescribeCluster Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-EKSClusterList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSClusterList`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet muestra los clústeres de Amazon EKS de la Cuenta de AWS región especificada.**
```
Get-EKSClusterList
```
**Salida:**
```
PROD
```
+ Para obtener más información sobre la API, consulte la *referencia [ListClusters](https://docs.aws.amazon.com/powershell/v4/reference)de Herramientas de AWS para PowerShell cmdlets (V4*).
### `Get-EKSFargateProfile`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSFargateProfile`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: este cmdlet devuelve información descriptiva sobre un perfil de Fargate AWS .**
```
Get-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"
```
**Salida:**
```
ClusterName : TEST
CreatedAt : 12/26/2019 12:34:47 PM
FargateProfileArn : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargate/42b7a119-e16b-a279-ce97-bdf303adec92
FargateProfileName : EKSFargate
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors : {Amazon.EKS.Model.FargateProfileSelector}
Status : ACTIVE
Subnets : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags : {}
```
+ Para obtener información sobre la API, consulte *Herramientas de AWS para PowerShell Cmdlet [DescribeFargateProfile](https://docs.aws.amazon.com/powershell/v4/reference)Reference (*V4).
### `Get-EKSFargateProfileList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSFargateProfileList`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet muestra los perfiles de AWS Fargate asociados al clúster especificado en la región especificada. Cuenta de AWS **
```
Get-EKSFargateProfileList -ClusterName "TEST"
```
**Salida:**
```
EKSFargate
EKSFargateProfile
```
+ Para obtener más información sobre la API, consulte [ListFargateProfiles](https://docs.aws.amazon.com/powershell/v4/reference)la referencia del *Herramientas de AWS para PowerShell cmdlet (*V4).
### `Get-EKSNodegroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSNodegroup`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet devuelve información descriptiva sobre un grupo de nodos de Amazon EKS.**
```
Get-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"
```
**Salida:**
```
AmiType : AL2_x86_64
ClusterName : PROD
CreatedAt : 12/25/2019 10:16:45 AM
DiskSize : 40
Health : Amazon.EKS.Model.NodegroupHealth
InstanceTypes : {t3.large}
Labels : {}
ModifiedAt : 12/25/2019 10:16:45 AM
NodegroupArn : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName : ProdEKSNodeGroup
NodeRole : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess :
Resources :
ScalingConfig : Amazon.EKS.Model.NodegroupScalingConfig
Status : CREATING
Subnets : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags : {}
Version : 1.14
```
+ Para obtener más información sobre la API, consulte [DescribeNodegroup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-EKSNodegroupList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSNodegroupList`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet muestra los grupos de nodos de Amazon EKS asociados al clúster especificado Cuenta de AWS en la región especificada.**
```
Get-EKSNodegroupList -ClusterName PROD
```
**Salida:**
```
ProdEKSNodeGroup
```
+ Para obtener más información sobre la API, consulte [ListNodegroups](https://docs.aws.amazon.com/powershell/v4/reference)la *referencia del Herramientas de AWS para PowerShell cmdlet (V4*).
### `Get-EKSResourceTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSResourceTag`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet muestra las etiquetas de un recurso de Amazon EKS.**
```
Get-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD"
```
**Salida:**
```
Key Value
--- -----
Name EKSPRODCLUSTER
```
+ Para obtener más información sobre la API, consulte [ListTagsForResource Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-EKSUpdate`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSUpdate`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet devuelve información descriptiva sobre una actualización del clúster de Amazon EKS o del grupo de nodos administrados asociado.**
```
Get-EKSUpdate -Name "PROD" -UpdateId "ee708232-7d2e-4ed7-9270-d0b5176f0726"
```
**Salida:**
```
CreatedAt : 12/25/2019 5:03:07 PM
Errors : {}
Id : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params : {Amazon.EKS.Model.UpdateParam}
Status : Successful
Type : LoggingUpdate
```
+ Para obtener más información sobre la API, consulte [DescribeUpdate Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-EKSUpdateList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-EKSUpdateList`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet muestra las actualizaciones asociadas a un clúster o grupo de nodos gestionados de Amazon EKS en su Cuenta de AWS región especificada.**
```
Get-EKSUpdateList -Name "PROD"
```
**Salida:**
```
ee708232-7d2e-4ed7-9270-d0b5176f0726
```
+ Para obtener más información sobre la API, consulte la *referencia [ListUpdates](https://docs.aws.amazon.com/powershell/v4/reference)de Herramientas de AWS para PowerShell cmdlets (V4*).
### `New-EKSCluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-EKSCluster`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: En este ejemplo se crea un nuevo clúster denominado “prod”.**
```
New-EKSCluster -Name prod -ResourcesVpcConfig @{SubnetIds=@("subnet-0a1b2c3d","subnet-3a2b1c0d");SecurityGroupIds="sg-6979fe18"} -RoleArn "arn:aws:iam::012345678901:role/eks-service-role"
```
**Salida:**
```
Arn : arn:aws:eks:us-west-2:012345678901:cluster/prod
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken :
CreatedAt : 12/10/2018 9:25:31 PM
Endpoint :
Name : prod
PlatformVersion : eks.3
ResourcesVpcConfig : Amazon.EKS.Model.VpcConfigResponse
RoleArn : arn:aws:iam::012345678901:role/eks-service-role
Status : CREATING
Version : 1.10
```
+ Para obtener más información sobre la API, consulte [CreateCluster Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `New-EKSFargateProfile`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-EKSFargateProfile`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet crea un perfil de AWS Fargate para su clúster de Amazon EKS. Debe tener al menos un perfil de Fargate en un clúster para poder programar pods en la infraestructura de Fargate.**
```
New-EKSFargateProfile -FargateProfileName EKSFargateProfile -ClusterName TEST -Subnet "subnet-02f6ff500ff2067a0", "subnet-0cd976f08d5fbfaae" -PodExecutionRoleArn arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole -Selector @{Namespace="default"}
```
**Salida:**
```
ClusterName : TEST
CreatedAt : 12/26/2019 12:38:21 PM
FargateProfileArn : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargateProfile/20b7a11b-8292-41c1-bc56-ffa5e60f6224
FargateProfileName : EKSFargateProfile
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors : {Amazon.EKS.Model.FargateProfileSelector}
Status : CREATING
Subnets : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags : {}
```
+ Para obtener más información sobre la API, consulte [CreateFargateProfile](https://docs.aws.amazon.com/powershell/v4/reference)la referencia de *Herramientas de AWS para PowerShell cmdlets (*V4).
### `New-EKSNodeGroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-EKSNodeGroup`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet crea un grupo de nodos de trabajo administrados para un clúster de Amazon EKS. Solo puede crear un grupo de nodos para el clúster que sea igual a la versión actual de Kubernetes para el clúster. Todos los grupos de nodos se crean con la última versión de la AMI para la versión secundaria correspondiente de Kubernetes del clúster.**
```
New-EKSNodeGroup -NodeGroupName "ProdEKSNodeGroup" -AmiType "AL2_x86_64" -DiskSize 40 -ClusterName "PROD" -ScalingConfig_DesiredSize 2 -ScalingConfig_MinSize 2 -ScalingConfig_MaxSize 5 -InstanceType t3.large -NodeRole "arn:aws:iam::012345678912:role/NodeInstanceRole" -Subnet "subnet-0d1a9fff35efa7691","subnet-0a3f4928edbc224d4"
```
**Salida:**
```
AmiType : AL2_x86_64
ClusterName : PROD
CreatedAt : 12/25/2019 10:16:45 AM
DiskSize : 40
Health : Amazon.EKS.Model.NodegroupHealth
InstanceTypes : {t3.large}
Labels : {}
ModifiedAt : 12/25/2019 10:16:45 AM
NodegroupArn : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName : ProdEKSNodeGroup
NodeRole : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess :
Resources :
ScalingConfig : Amazon.EKS.Model.NodegroupScalingConfig
Status : CREATING
Subnets : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags : {}
Version : 1.14
```
+ Para obtener más información sobre la API, consulte [CreateNodegroup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Remove-EKSCluster`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-EKSCluster`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet elimina el plano de control del clúster de Amazon EKS.**
```
Remove-EKSCluster -Name "DEV-KUBE-CL"
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSCluster (DeleteCluster)" on target "DEV-KUBE-CL".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Arn : arn:aws:eks:us-west-2:012345678912:cluster/DEV-KUBE-CL
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken :
CreatedAt : 12/25/2019 9:33:25 AM
Endpoint : https://02E6D31E3E4F8C15D7BE7F58D527776A.yl4.us-west-2.eks.amazonaws.com
Identity : Amazon.EKS.Model.Identity
Logging : Amazon.EKS.Model.Logging
Name : DEV-KUBE-CL
PlatformVersion : eks.7
ResourcesVpcConfig : Amazon.EKS.Model.VpcConfigResponse
RoleArn : arn:aws:iam::012345678912:role/eks-iam-role
Status : DELETING
Tags : {}
Version : 1.14
```
+ Para obtener más información sobre la API, consulte [DeleteCluster Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Remove-EKSFargateProfile`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-EKSFargateProfile`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet elimina un perfil de AWS Fargate. Al eliminar un perfil de Fargate, se eliminan todos los pods que se programaron en Fargate con el perfil.**
```
Remove-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSFargateProfile (DeleteFargateProfile)" on target "EKSFargate".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
ClusterName : TEST
CreatedAt : 12/26/2019 12:34:47 PM
FargateProfileArn : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargate/42b7a119-e16b-a279-ce97-bdf303adec92
FargateProfileName : EKSFargate
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors : {Amazon.EKS.Model.FargateProfileSelector}
Status : DELETING
Subnets : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags : {}
```
+ Para obtener información sobre la API, consulte *Herramientas de AWS para PowerShell Cmdlet [DeleteFargateProfile](https://docs.aws.amazon.com/powershell/v4/reference)*Reference (V4).
### `Remove-EKSNodegroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-EKSNodegroup`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet elimina un grupo de nodos de Amazon EKS de un clúster.**
```
Remove-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSNodegroup (DeleteNodegroup)" on target "ProdEKSNodeGroup".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
AmiType : AL2_x86_64
ClusterName : PROD
CreatedAt : 12/25/2019 10:16:45 AM
DiskSize : 40
Health : Amazon.EKS.Model.NodegroupHealth
InstanceTypes : {t3.large}
Labels : {}
ModifiedAt : 12/25/2019 11:01:16 AM
NodegroupArn : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName : ProdEKSNodeGroup
NodeRole : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess :
Resources : Amazon.EKS.Model.NodegroupResources
ScalingConfig : Amazon.EKS.Model.NodegroupScalingConfig
Status : DELETING
Subnets : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags : {}
Version : 1.14
```
+ Para obtener más información sobre la API, consulte [DeleteNodegroup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Remove-EKSResourceTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-EKSResourceTag`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet elimina las etiquetas especificadas de un recurso de EKS.**
```
Remove-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -TagKey "Name"
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSResourceTag (UntagResource)" on target "arn:aws:eks:us-west-2:012345678912:cluster/PROD".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
```
+ Para obtener más información sobre la API, consulte [UntagResource Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Update-EKSClusterConfig`
En el siguiente ejemplo de código, se muestra cómo utilizar `Update-EKSClusterConfig`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Actualiza la configuración de un clúster de Amazon EKS. El clúster seguirá funcionando durante la actualización.**
```
Update-EKSClusterConfig -Name "PROD" -Logging_ClusterLogging @{Types="api","audit","authenticator","controllerManager","scheduler",Enabled="True"}
```
**Salida:**
```
CreatedAt : 12/25/2019 5:03:07 PM
Errors : {}
Id : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params : {Amazon.EKS.Model.UpdateParam}
Status : InProgress
Type : LoggingUpdate
```
+ Para obtener más información sobre la API, consulte [UpdateClusterConfig Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Update-EKSClusterVersion`
En el siguiente ejemplo de código, se muestra cómo utilizar `Update-EKSClusterVersion`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: Este cmdlet actualiza un clúster de Amazon EKS a la versión de Kubernetes especificada. El clúster seguirá funcionando durante la actualización.**
```
Update-EKSClusterVersion -Name "PROD-KUBE-CL" -Version 1.14
```
**Salida:**
```
CreatedAt : 12/26/2019 9:50:37 AM
Errors : {}
Id : ef186eff-3b3a-4c25-bcfc-3dcdf9e898a8
Params : {Amazon.EKS.Model.UpdateParam, Amazon.EKS.Model.UpdateParam}
Status : InProgress
Type : VersionUpdate
```
+ Para obtener más información sobre la API, consulte [UpdateClusterVersion Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.