Obter um perfil do IAM usando um AWS SDK

Os exemplos de código a seguir mostram como obter um perfil do IAM.

.NET

AWS SDK for .NET

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

using System;
using Amazon.IdentityManagement;
using Amazon.IdentityManagement.Model;

var client = new AmazonIdentityManagementServiceClient();

var response = await client.GetRoleAsync(new GetRoleRequest
{
    RoleName = "LambdaS3Role",
});

if (response.Role is not null)
{
    Console.WriteLine($"{response.Role.RoleName} with ARN: {response.Role.Arn}");
    Console.WriteLine($"{response.Role.Description}");
    Console.WriteLine($"Created: {response.Role.CreateDate} Last used on: { response.Role.RoleLastUsed}");
}

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for .NET.

Go

SDK for Go V2

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

	// GetRole

	getRoleResult, err := service.GetRole(context.Background(), &iam.GetRoleInput{
		RoleName: aws.String(ExampleRoleName),
	})

	if err != nil {
		panic("Couldn't get role! " + err.Error())
	}

	fmt.Println("☑️ GetRole results: ")
	fmt.Println("ARN: ", *getRoleResult.Role.Arn)
	fmt.Println("Name: ", *getRoleResult.Role.RoleName)
	fmt.Println("Created On: ", *getRoleResult.Role.CreateDate)

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for Go.

JavaScript

SDK para JavaScript V3

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

Crie o cliente.

import { IAMClient } from "@aws-sdk/client-iam";
// Set the AWS Region.
const REGION = "REGION"; // For example, "us-east-1".
// Create an IAM service client object.
const iamClient = new IAMClient({ region: REGION });
export { iamClient };

Obter a função.

// Import required AWS SDK clients and commands for Node.js.
import { iamClient } from "./libs/iamClient.js";
import { GetRoleCommand } from "@aws-sdk/client-iam";

// Set the parameters.
const params = {
  RoleName: "ROLE_NAME" /* required */
};

const run = async () => {
  try {
    const data = await iamClient.send(new GetRoleCommand(params));
    console.log("Success", data.Role);
  } catch (err) {
    console.log("Error", err);
  }
};
run();

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for JavaScript.

PHP

SDK for PHP

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

$uuid = uniqid();
$service = new IamService();

    public function getRole($roleName)
    {
        return $this->customWaiter(function () use ($roleName) {
            return $this->iamClient->getRole(['RoleName' => $roleName]);
        });
    }

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for PHP.

Python

SDK para Python (Boto3).

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

def get_role(role_name):
    """
    Gets a role by name.

    :param role_name: The name of the role to retrieve.
    :return: The specified role.
    """
    try:
        role = iam.Role(role_name)
        role.load()  # calls GetRole to load attributes
        logger.info("Got role with arn %s.", role.arn)
    except ClientError:
        logger.exception("Couldn't get role named %s.", role_name)
        raise
    else:
        return role

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for Python (Boto3).

Ruby

SDK for Ruby

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

  # Gets data about a role.
  #
  # @param name [String] The name of the role to look up.
  # @return [Aws::IAM::Role] The retrieved role.
  def get_role(name)
    role = @iam_resource.role(name)
    puts("Got data for role '#{role.name}'. Its ARN is '#{role.arn}'.")
  rescue Aws::Errors::ServiceError => e
    puts("Couldn't get data for role '#{name}' Here's why:")
    puts("\t#{e.code}: #{e.message}")
    raise
  else
    role
  end

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for Ruby.

Rust

SDK for Rust

nota

Esta documentação destina-se a um SDK na versão de previsualização. O SDK está sujeito a alterações e não deve ser usado em ambientes de produção.

dica

Para saber mais sobre como configurar e executar esse exemplo, consulte o GitHub.

pub async fn get_role(
    client: &iamClient,
    role_name: String,
) -> Result<GetRoleOutput, SdkError<GetRoleError>> {
    let response = client.get_role().role_name(role_name).send().await?;
    Ok(response)
}

• Para obter detalhes da API, consulte GetRole na Referência da API do AWS SDK for Rust.

Para obter uma lista completa dos Guias do desenvolvedor do SDK da AWS e exemplos de código, consulte Usar o IAM com um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.