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

# Compartilhamento de recursos entre contas em AWS HealthOmics
<a name="resource-sharing"></a>

Use o compartilhamento entre contas para compartilhar recursos com colaboradores sem criar cópias ou modificar as políticas de recursos do IAM. Os recursos a seguir oferecem suporte ao compartilhamento entre contas:
+ HealthOmics lojas variantes
+ HealthOmics lojas de anotações
+ Fluxos de trabalho privados

O compartilhamento de um recurso inclui as seguintes etapas: 

1. O proprietário do recurso cria um compartilhamento e especifica o ARN do recurso e o do assinante Conta da AWS pretendido. O compartilhamento de recursos permanece em estado pendente até que o assinante aceite o compartilhamento.

1. O assinante aceita o compartilhamento de recursos para ter acesso ao recurso. O compartilhamento de recursos passa para o estado de ativação.

1. O HealthOmics serviço fornece acesso ao recurso à conta do assinante.

1. O proprietário do recurso pode excluir o compartilhamento ou o assinante pode revogar seu acesso ao compartilhamento. O assinante não pode excluir o compartilhamento ou o recurso associado.

**Topics**
+ [Criando um compartilhamento](#create-share)
+ [Recuperar informações sobre um compartilhamento](#get-share)
+ [Veja as ações que você possui](#view-shares)
+ [Exibir ações aceitas de outras contas](#view-accepted-shares)
+ [Excluir um compartilhamento](#delete-share)

## Criando um compartilhamento
<a name="create-share"></a>

Você pode usar a operação da API **create-share** para criar um compartilhamento. O assinante principal é Conta da AWS o usuário que assinará o recurso compartilhado. O exemplo a seguir cria um compartilhamento para um armazenamento de variantes.

```
aws omics create-share \
    --resource-arn "arn:aws:omics:us-west-2:555555555555:variantStore/omics_dev_var_store" \ 
    --principal-subscriber "123456789012"  \
    --name "my_Share-123"
```

Se a criação for bem-sucedida, você receberá uma resposta com o ID e o status do compartilhamento.

```
{
"shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a",
     "name": "my_Share-123",
     "status": "PENDING"
}
```

O compartilhamento permanece **pendente** até que o assinante o aceite usando a operação da **accept-share** API.

```
 aws omics accept-share \
    --share-id "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a"
```

Depois que o assinante aceita o compartilhamento, o compartilhamento passa para o estado ativo.

```
{
"status": "ACTIVATING"
}
```

## Recuperar informações sobre um compartilhamento
<a name="get-share"></a>

Use a operação da API **get-share** para recuperar informações sobre o compartilhamento.

```
aws omics get-share --share-id "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a"
```

A resposta da API inclui informações de metadados sobre o compartilhamento.

```
{
  "share": 
    {
      "shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a",
      "name": "my_Share-123",
      "resourceArn": "arn:aws:omics:us-west-2:555555555555:variantStore/omics_dev_var_store",
      "principalSubscriber": "123456789012",
      "ownerId": "555555555555",
      "status": "PENDING"
    }
}
```

## Veja as ações que você possui
<a name="view-shares"></a>

Use a API **list-shares** para recuperar informações sobre cada um dos compartilhamentos que você possui.

```
aws omics list-shares  --resource-owner SELF
```

A resposta da API inclui os metadados de cada compartilhamento que você possui.

## Exibir ações aceitas de outras contas
<a name="view-accepted-shares"></a>

Use a API **list-shares** para ver todos os compartilhamentos que você aceitou de outras contas.

```
aws omics list-shares  --resource-owner OTHER   
```

A resposta da API inclui os metadados de cada compartilhamento que você aceitou.

## Excluir um compartilhamento
<a name="delete-share"></a>

Use a API **delete-share** para excluir um compartilhamento depois que você não precisar mais dele. 

```
aws omics delete-share \
    --share-id "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a"
```