本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 中的跨帳戶資源共用 AWS HealthOmics
<a name="resource-sharing"></a>

使用跨帳戶共用與協作者共用資源，而無需建立複本或修改 IAM 資源政策。下列資源支援跨帳戶共用：
+ HealthOmics 變體存放區
+ HealthOmics 註釋存放區
+ 私有工作流程

共用資源包含下列步驟：

1. 資源擁有者會建立共享，並指定資源的 ARN 和 AWS 帳戶 預期訂閱者的 。資源共享會保持待定狀態，直到訂閱者接受共享為止。

1. 訂閱者接受資源共享來存取資源。資源共用會轉換為啟用狀態。

1. HealthOmics 服務可讓訂閱者帳戶存取 資源。

1. 資源擁有者可以刪除共用，或訂閱者可以撤銷對共用的存取權。訂閱者無法刪除共用或相關聯的資源。

**Topics**
+ [建立共享](#create-share)
+ [擷取共享的相關資訊](#get-share)
+ [檢視您擁有的共享](#view-shares)
+ [從其他帳戶檢視接受的共享](#view-accepted-shares)
+ [刪除共享](#delete-share)

## 建立共享
<a name="create-share"></a>

您可以使用 **create-share** API 操作來建立共享。主要訂閱者是將訂閱共用資源 AWS 帳戶 之使用者的 。下列範例會為變體存放區建立共享。

```
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"
```

如果建立成功，您會收到共用 ID 和狀態的回應。

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

在訂閱者使用 **accept-share** API 操作接受共用之前，共用會保持**待定**狀態。

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

訂閱者接受共用後，共用會轉換為作用中狀態。

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

## 擷取共享的相關資訊
<a name="get-share"></a>

使用 **get-share** API 操作來擷取共用的相關資訊。

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

API 回應包含共享的中繼資料資訊。

```
{
  "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"
    }
}
```

## 檢視您擁有的共享
<a name="view-shares"></a>

使用 **list-shares** API 擷取您擁有的每個共享的相關資訊。

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

API 回應包含您擁有的每個共享的中繼資料。

## 從其他帳戶檢視接受的共享
<a name="view-accepted-shares"></a>

使用 **list-shares** API 來檢視您從其他帳戶接受的所有共用。

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

API 回應包含您接受的每個共用的中繼資料。

## 刪除共享
<a name="delete-share"></a>

在您不再需要共享之後，請使用 **delete-share** API 來刪除共享。

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