AWS Marketplace API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 [AWS Marketplace API 參考](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 AWS Marketplace API 共用資源
AWS Marketplace Catalog API 與 AWS Resource Access Manager (AWS RAM) 整合以啟用資源共用。*資源*是使用者可以使用的實體 AWS Marketplace，例如產品、優惠或轉售授權。您可以使用 AWS RAM與其他 共用一些 AWS Marketplace Catalog API 資源 AWS 帳戶。您可以透過建立資源共用來*共用您擁有的資源*。資源共用會指定您要共用的資源，以及要與其共用資源的消費者。
**Topics**
+ [共用 AWS Marketplace 實體的先決條件](#sharing-prereqs)
+ [共用 AWS Marketplace 實體](#share-marketplace-entity)
## 共用 AWS Marketplace 實體的先決條件
在 中共用實體之前 AWS Marketplace Catalog API，您必須符合下列先決條件：
+ 您只能將一個資源政策連接到您的 AWS Marketplace 實體。
+ 若要共用實體，您必須在 中擁有該 AWS Marketplace 實體 AWS 帳戶。此要求表示必須在您的帳戶中配置或佈建實體。您無法共用已與您共用的 AWS Marketplace 實體。
## 共用 AWS Marketplace 實體
透過 AWS Marketplace 資源共用，實體擁有者可以與其他 AWS 帳戶 共用其實體 AWS Marketplace。實體擁有者可以是 ISVs和頻道合作夥伴。可以共用的實體包括產品、優惠和轉售授權。
**注意**
目前，您只能共用實體。中的實體 AWS Marketplace 包括 `AmiProduct`、`Audience`、`BrandingSettings`、`Experience`、 `ContainerProduct`和 `ProcurementPolicy`。
如需 的詳細資訊 AWS RAM，請參閱[AWS RAM 《 使用者指南》](https://docs.aws.amazon.com/ram/latest/userguide/)。如需管理共用資源的詳細資訊，請參閱*AWS RAM 《 使用者指南*》中的[使用共用 AWS 資源](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-shared.html)。
作為*共用帳戶*，您可以對要共用的資源設定唯讀或同時設定讀取/寫入。這些許可決定*耗用帳戶*可以對與其共用的資源執行哪些操作。
+ **共用帳戶** – 共用的資源，以及 AWS RAM 管理員使用 在其中建立 AWS 資源共用的資源 AWS RAM。
+ **取用帳戶** – AWS 帳戶 共用資源的 。資源共享可以將整個帳戶指定為委託人，或針對某些資源類型指定為帳戶中的個別角色或使用者。
若要共用 AWS Marketplace 實體，您必須將其新增至資源共用。資源共用是可讓您在 AWS 帳戶之間共用資源的一種 AWS RAM 資源。資源共享指定要共用的資源，以及共用它們的消費者。當您使用 AWS Marketplace 主控台共用實體時，您可以將其新增至現有的資源共用。若要將 AWS Marketplace 實體新增至新的資源共享，您必須先使用 [AWS RAM 主控台](https://console.aws.amazon.com/ram)建立資源共享。
您可以使用 AWS Marketplace 主控台、主控台或 AWS Command Line Interface () AWS RAM 共用您擁有的 AWS Marketplace 實體AWS CLI。
**使用 AWS RAM 主控台共用您擁有的 AWS Marketplace 實體**
請參閱《AWS RAM 使用者指南》**中的[建立資源共享](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create)。
**使用 共用您擁有的 AWS Marketplace 實體 AWS CLI**
使用 [https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) 命令。
**注意**
對於支援資源型政策的實體等資源類型，您可以使用 AWS RAM 來共用資源，以使用其他 AWS RAM 功能。如需詳細資訊，請參閱*AWS RAM 《 使用者指南*》中的[資源型政策](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-terms-and-concepts.html#term-resource-based-policy)。 AWS RAM 使用 從資源共用中的許可 AWS Marketplace Catalog API 自動建構資源政策，並為您管理該資源政策。
如需有關如何透過 在您的 AWS Marketplace 實體上設定、檢視或刪除 AWS 資源型政策的資訊 AWS RAM，請參閱*AWS RAM**《 使用者指南*》中的[允許對所有資源執行動作](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/api-access-control.html#allowing-actions-on-all-resources)。
### 透過 AWS RAM 和 共用實體之間的差異 AWS Marketplace Catalog API
除了透過 共用實體之外 AWS RAM，您也可以透過 在實體上設定、檢視或刪除 AWS 資源型政策 AWS Marketplace Catalog API。不過，透過 AWS RAM 和透過 共用您的實體有一些差異 AWS Marketplace Catalog API。
當您透過下列方式共用實體時 AWS RAM：
+ 如果您與 外部的帳戶共用實體 AWS Organizations，則取用帳戶必須先接受共用請求，才能共用實體。
+ 耗用帳戶可以透過 來探索共用實體，`ListEntities`並將 `OwnershipType`設定為 `SHARED`。
+ 您必須遵守數個資源配額。如需詳細資訊，請參閱《AWS RAM 使用者指南》**中的 [AWS RAM的 Service Quotas](https://docs.aws.amazon.com/ram/latest/userguide/service-quotas.html)。
當您透過 共用實體時 AWS Marketplace Catalog API：
+ 一旦`PutResourcePolicy`請求成功且消耗帳戶沒有輸入，您的實體就會共用。
+ 耗用帳戶無法透過 發現共用實體，`ListEntities`並將 `OwnershipType`設定為 `SHARED`。相反地，共用帳戶的擁有者必須通知取用帳戶共用實體 ID。
**注意**
如果您的使用案例需要共用可能超過 AWS RAM 服務配額的資源，或者如果您想要共用資源而不直接從耗用帳戶輸入，請考慮透過 共用 AWS Marketplace Catalog API。對於所有其他使用案例，請考慮使用 AWS RAM 來共用 AWS Marketplace 資源。
下列各節詳細說明如何透過 設定、檢視或刪除 AWS 實體上的資源型政策 AWS Marketplace Catalog API。
**Topics**
+ [透過 AWS RAM 和 共用實體之間的差異 AWS Marketplace Catalog API](#differences-ram-capi)
+ [將唯讀政策連接至您的資源](#read-only-policy-resource)
+ [將讀取和寫入資源政策連接至您的資源](#read-and-write-resource-policy)
+ [檢視資源上的資源政策集](#view-resource-policy-set)
+ [刪除資源上的資源政策](#delete-resource-policy)
+ [檢視您擁有並與您共用的所有資源](#view-entities-owned)
### 將唯讀政策連接至您的資源
您可以使用共用帳戶，在共用資源上建立唯讀資源型政策。使用此政策，委託人只能檢視與其共用之資源的詳細資訊。
請求
```
POST /PutResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
"Policy": {
"Version": "2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::222233334444:root"
},
"Action": [
"aws-marketplace:DescribeEntity"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
]
}
}
}
```
回應
```
HTTP/1.1 200
Content-type: application/json
{}
```
### 將讀取和寫入資源政策連接至您的資源
作為共用帳戶，您可以在共用資源上建立以資源為基礎的讀取和寫入政策。透過此政策，委託人可以檢視詳細資訊，並對與其共用的資源執行寫入操作。
請求
```
POST /PutResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
"Policy": {
"Version": "2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::222233334444:root"
},
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
]
}
}
}
```
回應
```
HTTP/1.1 200
Content-type: application/json
{}
```
### 檢視資源上的資源政策集
作為共用帳戶，您可以檢視在共用資源上設定的資源政策。
請求
```
POST /GetResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}
```
回應
```
HTTP/1.1 200
Content-type: application/json
{
"Policy": {
"Version": "2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::222233334444:root"
},
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
]
}
}
}
```
### 刪除資源上的資源政策
身為共用帳戶，您可以刪除在共用資源上設定的資源政策。
請求
```
POST /DeleteResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}
```
回應
```
HTTP/1.1 200
Content-type: application/json
{}
```
### 檢視您擁有並與您共用的所有資源
作為取用帳戶，您可以檢視與您共用的資源。
**注意**
只有在透過 共用資源時，您才能檢視與您共用的資源 AWS RAM。
請求
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"FilterList": [
{
"Name": "EntityId",
"ValueList": [ "example2-abcd-1234-5ef6" ]
}
],
"OwnershipType": "SHARED"
}
```
回應
```
HTTP/1.1 200
Content-type: application/json
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
"EntityId": "example2-abcd-1234-5ef6",
"EntityType": "AmiProduct",
"LastModifiedDate": "2018-02-27T13:45:22Z",
"Name": "TestProduct",
"Visibility": "public"
}
],
"NextToken": ""
}
```