使用 AWS Marketplace API 共用資源

共用 AWS Marketplace 實體的先決條件共用 AWS Marketplace 實體

AWS Marketplace Catalog API 與 AWS Resource Access Manager (AWS RAM) 整合以啟用資源共用。資源是使用者可以使用的實體 AWS Marketplace，例如產品、優惠或轉售授權。您可以使用 AWS RAM與其他共用一些 AWS Marketplace Catalog API 資源 AWS 帳戶。您可以透過建立資源共用來共用您擁有的資源。資源共用會指定您要共用的資源，以及要與其共用資源的消費者。

注意

目前，您只能共用實體。中的實體 AWS Marketplace 包括 AmiProduct、Audience、BrandingSettings、Experience、 ContainerProduct和 ProcurementPolicy。

如需的詳細資訊 AWS RAM，請參閱AWS RAM 《使用者指南》。如需管理共用資源的詳細資訊，請參閱AWS RAM 《使用者指南》中的使用共用 AWS 資源。

作為共用帳戶，您可以對要共用的資源設定唯讀或同時設定讀取/寫入。這些許可決定耗用帳戶可以對與其共用的資源執行哪些操作。

共用帳戶 – 共用的資源，以及 AWS RAM 管理員使用在其中建立 AWS 資源共用的資源 AWS RAM。
取用帳戶 – AWS 帳戶共用資源的。資源共享可以將整個帳戶指定為委託人，或針對某些資源類型指定為帳戶中的個別角色或使用者。

若要共用 AWS Marketplace 實體，您必須將其新增至資源共用。資源共用是可讓您在 AWS 帳戶之間共用資源的一種 AWS RAM 資源。資源共享指定要共用的資源，以及共用它們的消費者。當您使用 AWS Marketplace 主控台共用實體時，您可以將其新增至現有的資源共用。若要將 AWS Marketplace 實體新增至新的資源共享，您必須先使用 AWS RAM 主控台建立資源共享。

您可以使用 AWS Marketplace 主控台、主控台或 AWS Command Line Interface () AWS RAM 共用您擁有的 AWS Marketplace 實體AWS CLI。

使用 AWS RAM 主控台共用您擁有的 AWS Marketplace 實體

請參閱《AWS RAM 使用者指南》中的建立資源共享。

使用共用您擁有的 AWS Marketplace 實體 AWS CLI

使用 create-resource-share 命令。

注意

對於支援資源型政策的實體等資源類型，您可以使用 AWS RAM 來共用資源，以使用其他 AWS RAM 功能。如需詳細資訊，請參閱AWS RAM 《使用者指南》中的資源型政策。 AWS RAM 使用從資源共用中的許可 AWS Marketplace Catalog API 自動建構資源政策，並為您管理該資源政策。

如需有關如何透過在您的 AWS Marketplace 實體上設定、檢視或刪除 AWS 資源型政策的資訊 AWS RAM，請參閱AWS RAM《使用者指南》中的允許對所有資源執行動作。

透過 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。

當您透過共用實體時 AWS Marketplace Catalog API：

一旦PutResourcePolicy請求成功且消耗帳戶沒有輸入，您的實體就會共用。
耗用帳戶無法透過發現共用實體，ListEntities並將 OwnershipType設定為 SHARED。相反地，共用帳戶的擁有者必須通知取用帳戶共用實體 ID。

注意

如果您的使用案例需要共用可能超過 AWS RAM 服務配額的資源，或者如果您想要共用資源而不直接從耗用帳戶輸入，請考慮透過共用 AWS Marketplace Catalog API。對於所有其他使用案例，請考慮使用 AWS RAM 來共用 AWS Marketplace 資源。

下列各節詳細說明如何透過設定、檢視或刪除 AWS 實體上的資源型政策 AWS Marketplace Catalog API。

將唯讀政策連接至您的資源

您可以使用共用帳戶，在共用資源上建立唯讀資源型政策。使用此政策，委託人只能檢視與其共用之資源的詳細資訊。

請求


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": "" 
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用私有市集

使用 AWSSDKs

使用 AWS Marketplace API 共用資源

目錄

共用 AWS Marketplace 實體的先決條件

共用 AWS Marketplace 實體

注意