View a markdown version of this page

Usar AddRoleToInstanceProfile com uma CLI - AWS Identity and Access Management

Usar AddRoleToInstanceProfile com uma CLI

Os exemplos de código a seguir mostram como usar o AddRoleToInstanceProfile.

Exemplos de ações são trechos de código de programas maiores e devem ser executados em contexto. É possível ver essa ação em contexto nos seguintes exemplos de código:

CLI
AWS CLI

Adicionar um perfil a um perfil de instância

O comando add-role-to-instance-profile a seguir adiciona o perfil denominado S3Access ao perfil de instância denominado Webserver.

aws iam add-role-to-instance-profile \
    --role-name S3Access \
    --instance-profile-name Webserver

Este comando não produz saída.

Para criar um perfil de instância, use o comando create-instance-profile.

Para obter mais informações, consulte Uso de um perfil do IAM para conceder permissões a aplicações em execução em instâncias do Amazon EC2 no Guia do usuário do AWS IAM.

PowerShell
Ferramentas para PowerShell V4

Exemplo 1: este comando adiciona o perfil denominado S3Access a um perfil de instância existente denominado webserver. Para criar o perfil de instância, use o comando New-IAMInstanceProfile. Depois de criar o perfil de instância e associá-lo a um perfil usando esse comando, você pode anexá-lo a uma instância do EC2. Para isso, use o cmdlet New-EC2Instance com o parâmetro InstanceProfile_Arn ou InstanceProfile-Name para executar a nova instância.

Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"

  • Consulte detalhes da API em AddRoleToInstanceProfile na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).

Ferramentas para o PowerShell V5

Exemplo 1: este comando adiciona o perfil denominado S3Access a um perfil de instância existente denominado webserver. Para criar o perfil de instância, use o comando New-IAMInstanceProfile. Depois de criar o perfil de instância e associá-lo a um perfil usando esse comando, você pode anexá-lo a uma instância do EC2. Para isso, use o cmdlet New-EC2Instance com o parâmetro InstanceProfile_Arn ou InstanceProfile-Name para executar a nova instância.

Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"

  • Para obter detalhes sobre a API, consulte AddRoleToInstanceProfile na Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

Para ver uma lista completa dos guias de desenvolvedor e exemplos de código do SDK da AWS, consulte Using this service with an AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.