Há mais exemplos do AWS SDK disponíveis no repositório do GitHub Documento de Exemplos do AWS SDK
Usar DeletePolicyVersion com uma CLI
Os exemplos de código a seguir mostram como usar o DeletePolicyVersion.
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
-
Para excluir uma versão de uma política gerenciada
Este exemplo exclui a versão identificada como
v2da política cujo ARN éarn:aws:iam::123456789012:policy/MySamplePolicy.aws iam delete-policy-version \ --policy-arnarn:aws:iam::123456789012:policy/MyPolicy\ --version-idv2Este comando não produz saída.
Para obter mais informações, consulte Políticas e permissões no IAM no Guia do usuário do AWS IAM.
-
Consulte detalhes da API em DeletePolicyVersion
na Referência de comandos da AWS CLI.
-
- PowerShell
-
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo exclui a versão identificada como
v2da política cujo ARN éarn:aws:iam::123456789012:policy/MySamplePolicy.Remove-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy -VersionID v2Exemplo 2: este exemplo exclui uma política excluindo primeiro todas as versões não padrão da política e depois excluindo a própria política. A primeira linha recupera o objeto da política. A segunda linha recupera todas as versões da política que não estão marcadas como padrão em uma compilação e, em seguida, usa esse comando para excluir cada política na compilação. A última linha remove a política em si, bem como a versão padrão restante. Observe que, para excluir com êxito uma política gerenciada, você também deve desassociar a política de qualquer usuário, grupo ou perfis usando os comandos
Unregister-IAMUserPolicy,Unregister-IAMGroupPolicyeUnregister-IAMRolePolicy. Veja o exemplo do cmdletRemove-IAMPolicy.$pol = Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy Get-IAMPolicyVersions -PolicyArn $pol.Arn | where {-not $_.IsDefaultVersion} | Remove-IAMPolicyVersion -PolicyArn $pol.Arn -force Remove-IAMPolicy -PolicyArn $pol.Arn -force-
Consulte detalhes da API em DeletePolicyVersion na Referência de cmdlets do Ferramentas da AWS para PowerShell (V4).
-
- Ferramentas para o PowerShell V5
-
Exemplo 1: este exemplo exclui a versão identificada como
v2da política cujo ARN éarn:aws:iam::123456789012:policy/MySamplePolicy.Remove-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy -VersionID v2Exemplo 2: este exemplo exclui uma política excluindo primeiro todas as versões não padrão da política e depois excluindo a própria política. A primeira linha recupera o objeto da política. A segunda linha recupera todas as versões da política que não estão marcadas como padrão em uma compilação e, em seguida, usa esse comando para excluir cada política na compilação. A última linha remove a política em si, bem como a versão padrão restante. Observe que, para excluir com êxito uma política gerenciada, você também deve desassociar a política de qualquer usuário, grupo ou perfis usando os comandos
Unregister-IAMUserPolicy,Unregister-IAMGroupPolicyeUnregister-IAMRolePolicy. Veja o exemplo do cmdletRemove-IAMPolicy.$pol = Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy Get-IAMPolicyVersions -PolicyArn $pol.Arn | where {-not $_.IsDefaultVersion} | Remove-IAMPolicyVersion -PolicyArn $pol.Arn -force Remove-IAMPolicy -PolicyArn $pol.Arn -force-
Para obter detalhes sobre a API, consulte DeletePolicyVersion na Ferramentas da AWS para PowerShell Cmdlet Reference (V5).
-