# Compartilhar uma Reserva de capacidade
<a name="sharing-cr"></a>

Quando você compartilha uma reserva de capacidade de sua propriedade com outras Contas da AWS, você permite que elas executem instâncias em sua capacidade reservada. Se você compartilhar uma Reserva de capacidade aberta, lembre-se do seguinte, pois isso pode resultar em uso não intencional da Reserva de capacidade:
+ Se os consumidores tiverem instâncias em execução que correspondam aos atributos da Reserva de capacidade, tenham o parâmetro `CapacityReservationPreference` definido como `open` e ainda não estejam em execução na capacidade reservada, eles usarão a Reserva de capacidade compartilhada automaticamente.
+ Se os consumidores executarem instâncias que tenham atributos correspondentes (por exemplo, tipo de instância, plataforma, zona de disponibilidade e locação) e tiverem o parâmetro `CapacityReservationPreference` definido como `open`, as instâncias serão iniciadas automaticamente na reserva de capacidade compartilhada.

Para compartilhar uma Reserva de capacidade, é necessário adicioná-la um compartilhamento de recursos. Um compartilhamento de recursos é um recurso do AWS RAM que permite que você compartilhe seus recursos entre contas da AWS. Um compartilhamento de recursos especifica os recursos a serem compartilhados, e os consumidores com os quais compartilhá-los. Ao compartilhar uma Reserva de capacidade usando o console do Amazon EC2, você a adiciona a um compartilhamento de recursos existente. Para adicionar a reserva de capacidade a um novo compartilhamento de recursos, crie o compartilhamento de recursos usando o [console do AWS RAM](https://console.aws.amazon.com/ram).

Se você fizer parte de uma organização no AWS Organizations e ela tiver o compartilhamento habilitado, os consumidores da organização receberão acesso à reserva de capacidade se os [pré-requisitos de compartilhamento](capacity-reservation-sharing.md#sharing-cr-prereq) forem atendidos. Se a reserva de capacidade estiver compartilhada com contas externas, eles receberão um convite para ingressar no compartilhamento de recursos e acesso à reserva de capacidade compartilhada após aceitar o convite.

**Importante**  
Antes de executar instâncias em uma reserva de capacidade que seja compartilhada com você, verifique se tem acesso à reserva de capacidade compartilhada exibindo-a no console ou descrevendo-a usando o comando [describe-capacity-reservations](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservations.html) da AWS CLI. Se conseguir exibir a reserva de capacidade compartilhada no console ou descrevê-la usando a AWS CLI, ela está disponível para seu uso e é possível executar instâncias nela. Se tentar executar instâncias na reserva de capacidade e ela não estiver acessível devido a uma falha de compartilhamento, as instâncias serão executadas na capacidade sob demanda.

------
#### [ Console ]

**Para compartilhar uma Reserva de capacidade de sua propriedade usando o console do Amazon EC2**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, escolha **Reservas de Capacidade**.

1. Escolha a Reserva de capacidade a ser compartilhada e escolha **Actions (Ações)**, **Share reservation (Compartilhar reserva)**.

1. Selecione o compartilhamento de recursos ao qual adicionar a Reserva de capacidade e escolha **Share Reserva de capacidade (Compartilhar Reserva de capacidade)**.

   Pode levar alguns minutos para que os consumidores obtenham acesso à Reserva de capacidade compartilhada.

**Para compartilhar uma reserva de capacidade de sua propriedade usando o console do AWS RAM**  
Consulte [Creating a resource share](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) no *Guia do usuário do AWS RAM*.

------
#### [ AWS CLI ]

**Para compartilhar uma reserva de capacidade de sua propriedade**  
Use o comando [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).

```
aws ram create-resource-share \
    --name my-resource-share \
    --resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```

------
#### [ PowerShell ]

**Para compartilhar uma reserva de capacidade de sua propriedade**  
Use o cmdlet [New-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/New-RAMResourceShare.html).

```
New-RAMResourceShare `
    -Name my-resource-share `
    -ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```

------