

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á.

# Crie um compartilhamento AWS RAM de recursos para seus recursos do Image Builder
<a name="manage-shared-resources-share"></a>

Para compartilhar um componente, imagem ou receita do Image Builder, você deve adicioná-lo a um compartilhamento AWS Resource Access Manager de recursos. O compartilhamento de recursos especifica os recursos a serem compartilhados e os consumidores com os quais compartilhá-los.

As seguintes opções estão disponíveis para compartilhar recursos:

## Opção 1: criar um compartilhamento de recursos de RAM
<a name="share-opt1-create-resource-share"></a>

Ao criar um compartilhamento de recursos de RAM, você pode compartilhar um componente, imagem ou fórmula de sua propriedade em uma única etapa. Use um dos métodos a seguir para criar seu compartilhamento de recursos:
+ 

**Console**  
Para criar seu compartilhamento de recursos usando o AWS RAM console, consulte [Compartilhar AWS recursos de sua propriedade](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) no *Guia AWS RAM do usuário*.
+ 

**AWS CLI**  
Para criar seu compartilhamento de recursos usando a interface da linha de AWS RAM comando, execute o **[create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html)** comando no AWS CLI.

## Opção 2: aplicar uma política de recursos e promover um compartilhamento de recursos existente
<a name="share-opt2-promote-resource-share"></a>

A segunda opção para compartilhar seus recursos envolve duas etapas, executando comandos no AWS CLI para ambas. A primeira etapa usa os comandos do Image Builder no AWS CLI para aplicar políticas baseadas em recursos ao recurso compartilhado. A segunda etapa promove o recurso para um compartilhamento de recursos de RAM usando o **[promote-resource-share-created-from-policy](https://docs.aws.amazon.com/cli/latest/reference/ram/promote-resource-share-created-from-policy.html)** AWS RAM comando no AWS CLI para garantir que o recurso esteja visível para todos os diretores com quem você o compartilhou.

1. 

**Aplicar a política de recursos**

   Para aplicar com êxito a política de recursos, você deve garantir que a conta com a qual está compartilhando tenha permissão para acessar quaisquer recursos subjacentes.

   Escolha a guia que corresponde ao seu tipo de recurso para o comando aplicável.

------
#### [ Image ]

   Você pode aplicar uma política de recursos a uma imagem para permitir que outras pessoas a usem como imagem base em suas fórmulas. 

   Execute o comando **[put-image-policy](https://docs.aws.amazon.com/cli/latest/reference//imagebuilder/put-image-policy.html)** Image Builder no AWS CLI, para identificar os AWS principais com os quais compartilhar a imagem.

   ```
   aws imagebuilder put-image-policy --image-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1 --policy '{ "Version": "2012-10-17",		 	 	  "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": ["imagebuilder:GetImage", "imagebuilder:ListImages"], "Resource": [ "arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-image/2019.12.03/1" ] } ] }'
   ```

------
#### [ Component ]

   Você pode aplicar uma política de recursos a um componente de compilação ou teste para permitir o compartilhamento entre contas. Este comando permite que outras contas usem seu componente em suas fórmulas. Para aplicar com êxito a política de recursos, você deve garantir que a conta com a qual você está compartilhando tenha permissão para acessar quaisquer recursos referidos pelo componente compartilhado, tais como arquivos hospedados em repositórios privados.

   Execute o comando **[put-component-policy](https://docs.aws.amazon.com/cli/latest/reference//imagebuilder/put-component-policy.html)** Image Builder no AWS CLI, para identificar os AWS principais com os quais compartilhar o componente.

   ```
   aws imagebuilder put-component-policy --component-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:component/{{my-example-component}}/2019.12.03/1 --policy '{ "Version": "2012-10-17",		 	 	  "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetComponent", "imagebuilder:ListComponents" ], "Resource": [ "arn:aws:imagebuilder:us-west-{{2:123456789012}}:component/{{my-example-component}}/2019.12.03/1" ] } ] }'
   ```

------
#### [ Image recipe ]

   Você pode aplicar uma política de recursos a uma fórmula de imagem para permitir o compartilhamento entre contas. Este comando permite que outras contas usem sua fórmula para criar imagens em suas contas. Para aplicar com êxito a política de recursos, você deve garantir que a conta com a qual você está compartilhando tenha permissão para acessar quaisquer recursos à qual a fórmula faz referência, tais como imagens de base e componentes selecionados.

   Execute o comando **[put-image-recipe-policy](https://docs.aws.amazon.com/cli/latest/reference//imagebuilder/put-image-recipe-policy.html)** Image Builder no AWS CLI, para identificar os AWS principais com os quais compartilhar a imagem.

   ```
   aws imagebuilder put-image-recipe-policy --image-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-recipe/{{my-example-image-recipe}}/2019.12.03 --policy '{ "Version": "2012-10-17",		 	 	  "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetImageRecipe", "imagebuilder:ListImageRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-recipe/{{my-example-image-recipe}}/2019.12.03" ] } ] }'
   ```

------
#### [ Container recipe ]

   Você pode aplicar uma política de recursos a uma fórmula de contêiner para permitir o compartilhamento entre contas. Este comando permite que outras contas usem sua fórmula para criar imagens em suas contas. Para aplicar com êxito a política de recursos, você deve garantir que a conta com a qual você está compartilhando tenha permissão para acessar quaisquer recursos à qual a fórmula faz referência, tais como imagens de base e componentes selecionados.

   Execute o comando **[put-container-recipe-policy](https://docs.aws.amazon.com/cli/latest/reference//imagebuilder/put-container-recipe-policy.html)** Image Builder no AWS CLI, para identificar os AWS principais com os quais compartilhar a imagem.

   ```
   aws imagebuilder put-container-recipe-policy --container-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:container-recipe/{{my-example-container-recipe}}/2021.12.03 --policy '{ "Version": "2012-10-17",		 	 	  "Statement": [ { "Effect": "Allow", "Principal": { "AWS": [ "123456789012" ] }, "Action": [ "imagebuilder:GetContainerRecipe", "imagebuilder:ListContainerRecipes" ], "Resource": [ "arn:aws:imagebuilder:us-west-{{2:123456789012}}:container-recipe/{{my-example-container-recipe}}/2021.12.03" ] } ] }'
   ```

------
**nota**  
Para definir as políticas corretas para compartilhar e não compartilhar um recurso, o proprietário do recurso deve ter permissões do `imagebuilder:put*`.

1. 

**Promover como compartilhamento de recursos de RAM**

   Para garantir que o recurso esteja visível para todos os diretores com quem você o compartilhou, execute o **[promote-resource-share-created-from-policy](https://docs.aws.amazon.com/cli/latest/reference/ram/promote-resource-share-created-from-policy.html)** AWS RAM comando no AWS CLI.