Uso de UpdateRoleDescription con un AWS SDK o la CLI

Los siguientes ejemplos de código muestran cómo utilizar UpdateRoleDescription.

CLI

AWS CLI

Cómo cambiar la descripción de un rol de IAM

El siguiente comando update-role cambia la descripción del rol de IAM de production-role a Main production role.

aws iam update-role-description \
    --role-name production-role \
    --description 'Main production role'

Salida:

{
    "Role": {
        "Path": "/",
        "RoleName": "production-role",
        "RoleId": "AROA1234567890EXAMPLE",
        "Arn": "arn:aws:iam::123456789012:role/production-role",
        "CreateDate": "2017-12-06T17:16:37+00:00",
        "AssumeRolePolicyDocument": {
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Effect": "Allow",
                    "Principal": {
                        "AWS": "arn:aws:iam::123456789012:root"
                    },
                    "Action": "sts:AssumeRole",
                    "Condition": {}
                }
            ]
        },
        "Description": "Main production role"
    }
}

Para obtener más información, consulte Modificación de un rol en la Guía del usuario de AWS IAM.

• Para obtener información sobre la API, consulte UpdateRoleDescription en la Referencia de comandos de la AWS CLI.

PowerShell

Herramientas para PowerShell

Ejemplo 1: en este ejemplo se actualiza la descripción de un rol de IAM en su cuenta.

Update-IAMRoleDescription -RoleName MyRoleName -Description "My testing role"

• Para obtener información sobre la API, consulte UpdateRoleDescription en la Referencia de Cmdlet de AWS Tools for PowerShell.

Para obtener una lista completa de las guías para desarrolladores del AWS SDK y ejemplos de código, consulte Uso de este servicio con un SDK de AWS. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.