As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CodeDeploy referência de permissões
<a name="auth-and-access-control-permissions-reference"></a>

Use a tabela a seguir ao configurar o acesso e escrever políticas de permissões que podem ser anexadas a uma identidade do IAM (políticas baseadas em identidade). A tabela lista cada operação da CodeDeploy API, as ações para as quais você pode conceder permissões para realizar a ação e o formato do ARN do recurso a ser usado para conceder permissões. Você especifica as ações no campo `Action` das políticas. Você especifica um ARN, com ou sem um caractere curinga (\*), como o valor do recurso no campo `Resource` das políticas.

Você pode usar chaves AWS de condição abrangentes em suas CodeDeploy políticas para expressar condições. Para obter uma lista completa AWS de chaves gerais, consulte [Chaves disponíveis](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#AvailableKeys) no *Guia do usuário do IAM*.

Para especificar uma ação, use o prefixo `codedeploy:` seguido pelo nome da operação API (por exemplo, `codedeploy:GetApplication` e `codedeploy:CreateApplication`). Para especificar várias ações em uma única declaração, separe-as com vírgulas (por exemplo, `"Action": ["codedeploy:action1", "codedeploy:action2"]`).

**Usando caracteres curinga**

Você pode usar um caractere curinga (\*) no seu ARN para especificar várias ações ou recursos. Por exemplo, `codedeploy:*` especifica todas as CodeDeploy ações e `codedeploy:Get*` especifica todas as CodeDeploy ações que começam com a palavra. `Get` O exemplo a seguir concede acesso a todos os grupos de implantação com nomes que começam com `West` e estão associados a aplicativos com nomes que começam com `Test`. 

```
arn:aws:codedeploy:us-west-2:444455556666:deploymentgroup:Test*/West*
```

É possível usar curingas com os seguintes recursos listados na tabela:
+ {{application-name}}
+ {{deployment-group-name}}
+ {{deployment-configuration-name}}
+ {{instance-ID}}

Os curingas não podem ser usados com {{region}} ou{{account-id}}. Para obter mais informações sobre curingas, consulte [Identificadores do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html), no *Manual do usuário do IAM*. 

**nota**  
 No ARN de cada ação, dois-pontos (:) vêm logo após o recurso. Você também pode usar uma barra (/) para vir logo após o recurso. Para obter mais informações, consulte [CodeDeployexemplos de ARNs](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-codedeploy). 

Use as barras de rolagem para ver o restante da tabela.


**CodeDeploy Operações de API e permissões necessárias para ações**  

<table>
<thead>
  <tr><th>CodeDeploy Operações de API</th><th>Permissões obrigatórias (ações de API)</th><th>Recursos</th></tr>
</thead>
<tbody>
  <tr><td>[AddTagsToOnPremisesInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_AddTagsToOnPremisesInstances.html)</td><td>`codedeploy:AddTagsToOnPremisesInstances`<br />Necessário para adicionar tags a uma ou mais instâncias on-premises.</td><td>arn:aws:codedeploy: ::instance/ {{region}} {{account-id}} {{instance-ID}}</td></tr>
  <tr><td>[BatchGetApplicationRevisions](https://docs.aws.amazon.com/codedeploy/latest/APIReference/BatchGetApplicationRevisions.html)</td><td>`codedeploy:BatchGetApplicationRevisions`<br />Necessário para obter informações sobre várias revisões de aplicativo associadas ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[BatchGetApplications](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetApplications.html)</td><td>`codedeploy:BatchGetApplications`<br />Necessário para obter informações sobre vários aplicativos associados ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: \* {{region}} {{account-id}}</td></tr>
  <tr><td>[BatchGetDeploymentGroups](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentGroups.html)</td><td>`codedeploy:BatchGetDeploymentGroups`<br />Necessário para obter informações sobre vários grupos de implantação associados ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[BatchGetDeploymentInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentInstances.html)</td><td>codedeploy:BatchGetDeploymentInstancesNecessário para obter informações sobre uma ou mais instâncias em um grupo de implantação.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[BatchGetDeployments](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeployments.html)</td><td>`codedeploy:BatchGetDeployments`<br />Necessário para obter informações sobre várias implantações associadas ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[BatchGetOnPremisesInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetOnPremisesInstances.html)</td><td>`codedeploy:BatchGetOnPremisesInstances`<br />Necessário para obter informações sobre uma ou mais instâncias on-premises.</td><td>arn: aws:codedeploy::: \* {{region}} {{account-id}}</td></tr>
  <tr><td>[ContinueDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ContinueDeployment.html)</td><td>`codedeploy:ContinueDeployment`<br />Necessário durante uma blue/green implantação para iniciar o processo de registro de instâncias em um ambiente substituto com um balanceador de carga do Elastic Load Balancing.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[CreateApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateApplication.html)</td><td>`codedeploy:CreateApplication`<br />Necessário para criar um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[CreateDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html)¹</td><td>`codedeploy:CreateDeployment`<br />Necessário para criar uma implantação para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[CreateDeploymentConfig](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeploymentConfig.html)</td><td>`codedeploy:CreateDeploymentConfig`<br />Necessário para criar uma configuração de implantação personalizada associada ao usuário do .</td><td>arn:aws:codedeploy: ::deploymentconfig: {{region}} {{account-id}} {{deployment-configuration-name}} </td></tr>
  <tr><td>[CreateDeploymentGroup](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeploymentGroup.html)</td><td>`codedeploy:CreateDeploymentGroup`<br />Necessário para criar um grupo de implantação para um aplicativo associado ao usuário.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[DeleteApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteApplication.html)</td><td>`codedeploy:DeleteApplication`<br />Necessário para excluir um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[DeleteDeploymentConfig](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteDeploymentConfig.html)</td><td>`codedeploy:DeleteDeploymentConfig`<br />Necessário para excluir uma configuração de implantação personalizada associada ao usuário do .</td><td>arn:aws:codedeploy: ::deploymentconfig: {{region}} {{account-id}} {{deployment-configuration-name}} </td></tr>
  <tr><td>[DeleteDeploymentGroup](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteDeploymentGroup.html)</td><td>`codedeploy:DeleteDeploymentGroup`<br />Necessário para excluir um grupo de implantação para um aplicativo associado ao usuário.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[DeregisterOnPremisesInstance](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeregisterOnPremisesInstance.html)</td><td>`codedeploy:DeregisterOnPremisesInstance`<br />Necessário para cancelar o registro de uma instância on-premises.</td><td>arn:aws:codedeploy: ::instance/ {{region}} {{account-id}} {{instance-ID}}</td></tr>
  <tr><td>[GetApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetApplication.html)</td><td>`codedeploy:GetApplication`<br />Necessário para obter informações sobre um único aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[GetApplicationRevision](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetApplicationRevision.html)</td><td>`codedeploy:GetApplicationRevision`<br />Necessário para obter informações sobre uma única revisão de aplicativo para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[GetDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeployment.html)</td><td>`codedeploy:GetDeployment`<br />Necessário para obter informações sobre uma única implantação em um grupo de implantação para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[GetDeploymentConfig](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentConfig.html)</td><td>`codedeploy:GetDeploymentConfig`<br />Necessário para obter informações sobre uma única configuração de implantação associada ao usuário do .</td><td>arn:aws:codedeploy: ::deploymentconfig: {{region}} {{account-id}} {{deployment-configuration-name}} </td></tr>
  <tr><td>[GetDeploymentGroup](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentGroup.html)</td><td>`codedeploy:GetDeploymentGroup`<br />Necessário para obter informações sobre um único grupo de implantação para um aplicativo associado ao usuário.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[GetDeploymentInstance](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentInstance.html)</td><td>`codedeploy:GetDeploymentInstance`<br />Necessário para obter informações sobre uma única instância em uma implantação associada ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[GetDeploymentTarget](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentTarget.html)</td><td>`codedeploy:GetDeploymentTarget`<br />Obrigatório para obter informações sobre um destino em uma implantação associada ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[GetOnPremisesInstance](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetOnPremisesInstance.html)</td><td>`codedeploy:GetOnPremisesInstance`<br />Necessário para obter informações sobre uma única instância on-premises.</td><td>arn:aws:codedeploy: ::instance/ {{region}} {{account-id}} {{instance-ID}}</td></tr>
  <tr><td>[ListApplicationRevisions](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListApplicationRevisions.html)</td><td>`codedeploy:ListApplicationRevisions`<br />Necessário para obter informações sobre todas as revisões de aplicativo para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: \* {{region}} {{account-id}}</td></tr>
  <tr><td>[ListApplications](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListApplications.html)</td><td>`codedeploy:ListApplications`<br />Necessário para obter informações sobre todos os aplicativos associados ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: \* {{region}} {{account-id}}</td></tr>
  <tr><td>[ListDeploymentConfigs](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentConfigs.html)</td><td>`codedeploy:ListDeploymentConfigs`<br />Necessário para obter informações sobre todas as configurações de implantação associadas ao usuário do .</td><td>arn:aws:codedeploy: ::deploymentconfig: \* {{region}} {{account-id}}</td></tr>
  <tr><td>[ListDeploymentGroups](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentGroups.html)</td><td>`codedeploy:ListDeploymentGroups`<br />Necessário para obter informações sobre todos os grupos de implantação de um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação: /\* {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[ListDeploymentInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentInstances.html)</td><td>`codedeploy:ListDeploymentInstances`<br />Necessário para obter informações sobre todas as instâncias em uma implantação associada ao usuário ou à AWS conta.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[ListDeployments](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeployments.html)</td><td>`codedeploy:ListDeployments`<br />Necessário para obter informações sobre todas as implantações em um grupo de implantação associado ao usuário, ou para obter todas as implantações associadas ao usuário.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[ListDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentTargets.html)</td><td>`codedeploy:ListDeploymentTargets`<br />Obrigatório para obter informações sobre todos os destinos em uma implantação associada ao usuário.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[ListGitHubAccountTokenNames](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListGitHubAccountTokenNames.html)</td><td>`codedeploy:ListGitHubAccountTokenNames`<br />Necessário para obter uma lista dos nomes das conexões armazenadas GitHub nas contas. </td><td>arn: aws:codedeploy::: \* {{region}} {{account-id}}</td></tr>
  <tr><td>[ListOnPremisesInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListOnPremisesInstances.html)</td><td>`codedeploy:ListOnPremisesInstances`<br />Necessário para obter uma lista de um ou mais nomes de instâncias on-premises.</td><td>arn: aws:codedeploy::: \* {{region}} {{account-id}}</td></tr>
  <tr><td>PutLifecycleEventHookExecutionStatus</td><td>`codedeploy:PutLifecycleEventHookExecutionStatus`<br />Obrigatório para fornecer notificação sobre o status da execução de um evento de gancho de ciclo de vida.</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[RegisterApplicationRevision](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_RegisterApplicationRevision.html)</td><td>`codedeploy:RegisterApplicationRevision`<br />Necessário para registrar informações sobre uma revisão de aplicativo para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[RegisterOnPremisesInstance](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_RegisterOnPremisesInstance.html)</td><td>`codedeploy:RegisterOnPremisesInstance`<br />Necessário para registrar uma instância local no CodeDeploy.</td><td>arn:aws:codedeploy: ::instance/ {{region}} {{account-id}} {{instance-ID}}</td></tr>
  <tr><td>[RemoveTagsFromOnPremisesInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_RemoveTagsFromOnPremisesInstances.html)</td><td>`codedeploy:RemoveTagsFromOnPremisesInstances`<br />Necessário para remover tags de uma ou mais instâncias on-premises.</td><td>arn:aws:codedeploy: ::instance/ {{region}} {{account-id}} {{instance-ID}}</td></tr>
  <tr><td>[SkipWaitTimeForInstanceTermination](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_SkipWaitTimeForInstanceTermination.html)</td><td>`codedeploy:SkipWaitTimeForInstanceTermination`<br />Necessário em uma blue/green implantação para substituir um tempo de espera especificado e começar a encerrar instâncias no ambiente original imediatamente.</td><td>arn:aws:codedeploy: ::instance/ {{region}} {{account-id}} {{instance-ID}}</td></tr>
  <tr><td>[StopDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_StopDeployment.html)</td><td>`codedeploy:StopDeployment`<br />Necessário para interromper uma implantação em andamento em um grupo de implantação para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td>[UpdateApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_UpdateApplication.html)³</td><td>`codedeploy:UpdateApplication`<br />Necessário para alterar informações sobre um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::aplicativo: {{region}} {{account-id}} {{application-name}}</td></tr>
  <tr><td>[UpdateDeploymentGroup](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_UpdateDeploymentGroup.html)³</td><td>`codedeploy:UpdateDeploymentGroup`<br />Necessário para alterar informações sobre um único grupo de implantação para um aplicativo associado ao usuário do .</td><td>arn:aws:codedeploy: ::grupo de implantação:/{{region}}{{account-id}}{{application-name}}{{deployment-group-name}}</td></tr>
  <tr><td colspan="3">¹ Ao especificar permissões `CreateDeployment`, também é necessário especificar permissões `GetDeploymentConfig` para a configuração de implantação e permissões `GetApplicationRevision` ou `RegisterApplicationRevision` para a revisão do aplicativo. Além disso, se você incluir o parâmetro `overrideAlarmConfiguration` em sua chamada de API `CreateDeployment`, deverá especificar a permissão `UpdateDeploymentGroup`.<br />² Válido para `ListDeployments` ao fornecer um grupo de implantação específico, mas não ao listar todas as implantações associadas ao usuário.<br />³ Para `UpdateApplication`, é necessário ter permissões `UpdateApplication` para os nomes de aplicativos novos e antigos. Para ações `UpdateDeploymentGroup` que envolvem a alteração do nome de um grupo de implantação, é necessário ter permissões `UpdateDeploymentGroup` para os nomes de grupos de implantação novos e antigos. </td></tr>
</tbody>
</table>