

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

# Usando AWS recursos compartilhados
<a name="getting-started-shared"></a>

Para começar a usar recursos que foram compartilhados com sua conta usando AWS Resource Access Manager, conclua as tarefas a seguir.

**Topics**
+ [Responder ao convite de compartilhamento de recursos](#getting-started-shared-respond-invitation)
+ [Uso dos recursos compartilhados com você](#getting-started-shared-use-resources)

## Responder ao convite de compartilhamento de recursos
<a name="getting-started-shared-respond-invitation"></a>

Se você receber um convite para participar de um compartilhamento de recurso, deverá aceitá-lo para obter acesso aos recursos compartilhados. 

Esse procedimento pode ocorrer nos seguintes cenários:
+ Se você faz parte de uma organização AWS Organizations e o compartilhamento em sua organização está ativado, os diretores da organização obtêm acesso automático aos recursos compartilhados sem convites.
+ Se você compartilhar com o Conta da AWS proprietário do recurso, os diretores dessa conta terão acesso automático aos recursos compartilhados sem convites.

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

**Para responder a um convite**

1. Abra a página **[Compartilhado comigo: compartilhamentos de recursos](https://console.aws.amazon.com/ram/home#SharedResourceShares:)** no console do AWS RAM .
**nota**  
Um compartilhamento de recursos é visível somente no Região da AWS local em que foi criado. Se um compartilhamento de recursos esperado não aparecer no console, talvez seja necessário alternar para outro Região da AWS usando o controle suspenso no canto superior direito.

1. Revise a lista de compartilhamentos de recursos aos quais você recebeu acesso.

   A coluna **Status** indica seu status atual de participação no compartilhamento de recursos. O status `Pending` indica que você foi adicionado a um compartilhamento de recursos, mas ainda não aceitou ou rejeitou o convite.

1. Para responder ao convite de compartilhamento de recursos, selecione o ID do compartilhamento de recursos e escolha **Aceitar compartilhamento de recursos** para aceitar o convite ou **Rejeitar compartilhamento de recursos** para recusá-lo. Se você rejeitar o convite, não terá acesso aos recursos. Se você aceitar o convite, terá acesso aos recursos.

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

Para começar, obtenha uma lista dos convites de compartilhamento de recursos que estão disponíveis para você. O comando de exemplo a seguir foi executado no `us-west-2` região e mostra que um compartilhamento de recursos está disponível no estado `PENDING`.

```
$ aws ram get-resource-share-invitations
{
    "resourceShareInvitations": [
        {
            "resourceShareInvitationArn": "arn:aws:ram:us-west-2:111122223333:resource-share-invitation/1234abcd-ef12-9876-5432-aaaaaa111111",
            "resourceShareName": "MyNewResourceShare",
            "resourceShareArn": "arn:aws:ram:us-west-2:111122223333:resource-share/1234abcd-ef12-9876-5432-bbbbbb222222",
            "senderAccountId": "111122223333",
            "receiverAccountId": "444455556666",
            "invitationTimestamp": "2021-09-15T15:00:32.568000-07:00",
            "status": "PENDING"
        }
    ]
}
```

Você pode usar o nome do recurso da Amazon (ARN) do convite do comando anterior como um parâmetro no próximo comando para aceitar esse convite.

```
$ aws ram accept-resource-share-invitation \
    --resource-share-invitation-arn arn:aws:ram:us-west-2:111122223333:resource-share-invitation/1234abcd-ef12-9876-5432-aaaaaa111111
{
    "resourceShareInvitation": {
        "resourceShareInvitationArn": "arn:aws:ram:us-west-2:111122223333:resource-share-invitation/1234abcd-ef12-9876-5432-aaaaaa111111",
        "resourceShareName": "MyNewResourceShare",
        "resourceShareArn": "arn:aws:ram:us-west-2:111122223333:resource-share/1234abcd-ef12-9876-5432-bbbbbb222222",
        "senderAccountId": "111122223333",
        "receiverAccountId": "444455556666",
        "invitationTimestamp": "2021-09-15T15:14:12.580000-07:00",
        "status": "ACCEPTED"
    }
}
```

A saída mostra que o `status` foi alterado para `ACCEPTED`. Os recursos incluídos nesse compartilhamento de recursos agora estão disponíveis para as entidades principais na conta de aceitação.

------

## Uso dos recursos compartilhados com você
<a name="getting-started-shared-use-resources"></a>

Após aceitar o convite para fazer parte de um recurso compartilhado, você será capaz de executar ações específicas nos recursos compartilhados. Essas ações variam de acordo com o tipo de recurso. Para obter mais informações, consulte [Recursos compartilháveis AWS](shareable.md). Os recursos estão disponíveis diretamente no console de serviço e nas API/CLI operações de cada recurso. Se o recurso for regional, você deverá usar o correto no console de serviço ou Região da AWS no comando API/CLI. Se o recurso for global, você deverá usar a região de origem designada, Leste dos EUA (Norte da Virgínia). `us-east-1` Para visualizar o recurso em AWS RAM, você deve abrir o AWS RAM console no Região da AWS qual o compartilhamento de recursos foi criado.