View a markdown version of this page

Verwendung der AWS Marketplace API zum Teilen von Ressourcen - AWS Marketplace
Voraussetzungen für die gemeinsame Nutzung AWS Marketplace entitiesTeilen Sie eine AWS Marketplace entity

Die AWS Marketplace API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwendung der AWS Marketplace API zum Teilen von Ressourcen

AWS Marketplace Catalog API integriert sich in AWS Resource Access Manager (AWS RAM), um die gemeinsame Nutzung von Ressourcen zu ermöglichen. Eine Ressource ist eine Entität, mit der Benutzer arbeiten können AWS Marketplace, z. B. ein Produkt, ein Angebot oder eine Wiederverkaufsgenehmigung. Mit AWS RAM können Sie einige AWS Marketplace Catalog API Ressourcen mit anderen AWS-Konten teilen. Sie können Ressourcen, die Ihnen gehören, gemeinsam nutzen, indem Sie eine gemeinsame Nutzung erstellen. Eine Ressourcenfreigabe gibt die Ressourcen an, die Sie gemeinsam nutzen möchten, und die Verbraucher, mit denen Sie sie teilen möchten.

Voraussetzungen für die gemeinsame Nutzung AWS Marketplace entities

Bevor Sie Entitäten teilen können AWS Marketplace Catalog API, müssen Sie die folgenden Voraussetzungen erfüllen:

  • Sie können Ihrer AWS Marketplace Entität nur eine Ressourcenrichtlinie zuordnen.

  • Um eine AWS Marketplace Entität gemeinsam zu nutzen, müssen Sie sie in Ihrer besitzen AWS-Konto. Diese Anforderung bedeutet, dass die Entität Ihrem Konto zugewiesen oder bereitgestellt werden muss. Sie können eine AWS Marketplace Entität, die mit Ihnen geteilt wurde, nicht teilen.

Teilen Sie eine AWS Marketplace entity

Mit der gemeinsamen Nutzung von AWS Marketplace Ressourcen können Entitätsinhaber ihre Entitäten mit anderen AWS-Konten teilen AWS Marketplace. Entity-owners können ISVs und Vertriebspartner sein. Zu den Entitäten, die gemeinsam genutzt werden können, gehören Produkte, Angebote und Weiterverkaufsberechtigungen.

Anmerkung

Derzeit können Sie nur Entitäten teilen. AWS Marketplace Zu den Entitäten gehören AmiProduct AudienceBrandingSettings,ContainerProduct,Experience, undProcurementPolicy.

Weitere Informationen zu AWS RAM finden Sie im AWS RAM Benutzerhandbuch. Weitere Informationen zur Verwaltung Ihrer gemeinsam genutzten Ressourcen finden Sie im AWS RAM Benutzerhandbuch unter Verwenden von gemeinsam genutzten AWS Ressourcen.

Als Sharing-Konto können Sie für die Ressourcen, die Sie teilen möchten, read/write den Schreibschutz oder beides festlegen. Diese Berechtigungen bestimmen, welche Operationen ein verbrauchendes Konto mit den Ressourcen ausführen kann, die mit ihm gemeinsam genutzt werden.

  • Gemeinsames Konto — Die Ressource, die gemeinsam genutzt wird und in der der AWS RAM Administrator die gemeinsame Nutzung der AWS Ressource mithilfe von AWS RAM.

  • Nutzerkonto — Das Konto AWS-Konto , für das eine Ressource gemeinsam genutzt wird. Bei der Ressourcenfreigabe kann ein ganzes Konto als Hauptkonto oder für einige Ressourcentypen einzelne Rollen oder Benutzer im Konto angegeben werden.

Um eine AWS Marketplace Entität gemeinsam zu nutzen, müssen Sie sie zu einer Ressourcenfreigabe hinzufügen. Eine Ressourcenfreigabe ist eine AWS RAM -Ressource, mit der Sie Ihre Ressourcen in mehreren AWS-Konten gemeinsam nutzen können. Eine Ressourcenfreigabe gibt die freizugebenden Ressourcen und die Konsumenten an, für die sie freigegeben werden. Wenn Sie eine Entität über die AWS Marketplace Konsole teilen, fügen Sie sie einer vorhandenen Ressourcenfreigabe hinzu. Um die AWS Marketplace Entität zu einer neuen Ressourcenfreigabe hinzuzufügen, müssen Sie zuerst die Ressourcenfreigabe mithilfe der AWS RAM Konsole erstellen.

Sie können eine AWS Marketplace Entität, die Ihnen gehört, mithilfe der AWS Marketplace Konsole, der AWS RAM Konsole oder der AWS Command Line Interface (AWS CLI) gemeinsam nutzen.

Um eine zu teilen AWS Marketplace Entität, deren Eigentümer Sie sind, verwenden Sie AWS RAM Konsole

Siehe Erstellen einer Ressourcenfreigabe im AWS RAM -Benutzerhandbuch.

Um ein zu teilen AWS Marketplace Entität, deren Eigentümer Sie sind, verwenden Sie AWS CLI

Verwenden Sie den Befehl create-resource-share.

Anmerkung

Für Ressourcentypen wie Entitäten, die ressourcenbasierte Richtlinien unterstützen, können Sie Ressourcen gemeinsam nutzen, AWS RAM um zusätzliche AWS RAM Funktionen zu nutzen. Weitere Informationen finden Sie unter Resource-based Richtlinie im AWS RAM Benutzerhandbuch. AWS RAM verwendet die AWS Marketplace Catalog API , um die Ressourcenrichtlinie automatisch anhand von Berechtigungen in einer Ressourcenfreigabe zu erstellen, und verwaltet diese Ressourcenrichtlinie für Sie.

Informationen dazu, wie Sie AWS ressourcenbasierte Richtlinien für Ihre AWS Marketplace Entität einrichten, anzeigen oder löschen können AWS RAM, finden Sie unter Zulassen von Aktionen für alle Ressourcen im AWS RAMBenutzerhandbuch.

Unterschiede zwischen der gemeinsamen Nutzung einer Entität über AWS RAM und die AWS Marketplace Catalog API

Sie können Ihre Entität nicht nur über teilen AWS RAM, sondern auch AWS ressourcenbasierte Richtlinien für Ihre Entitäten festlegen, anzeigen oder löschen. AWS Marketplace Catalog API Es gibt jedoch einige Unterschiede zwischen dem Teilen Ihrer Entität über AWS RAM und durch die. AWS Marketplace Catalog API

Wenn Sie eine Entität teilen über AWS RAM:

  • Wenn Sie Ihre Entität mit Konten teilen, die sich außerhalb von befinden AWS Organizations, muss das nutzende Konto zuerst Ihre Anfrage zum Teilen akzeptieren, bevor die Entität geteilt wird.

  • Das nutzende Konto kann die gemeinsam genutzte Entität ListEntities mit der OwnershipType Einstellung auf ermittelnSHARED.

  • Sie müssen mehrere Ressourcenkontingente einhalten. Weitere Informationen finden Sie unter Service Quotas für AWS RAM im AWS RAM User Guide.

Wenn Sie eine Entität gemeinsam nutzen über AWS Marketplace Catalog API:

  • Ihre Entität wird geteilt, sobald die PutResourcePolicy Anfrage erfolgreich ist, ohne dass das Nutzerkonto etwas dazu eingegeben hat.

  • Das nutzende Konto kann die gemeinsam genutzte Entität nicht erkennen, wenn die OwnershipType Einstellung auf SHARED gesetzt ist. ListEntities Stattdessen muss der Besitzer des gemeinsam genutzten Kontos das Nutzerkonto über die ID der gemeinsam genutzten Entität informieren.

Anmerkung

Wenn Ihr Anwendungsfall die gemeinsame Nutzung von Ressourcen erfordert, die möglicherweise die AWS RAM Dienstkontingente überschreiten, oder wenn Sie Ressourcen ohne direkte Eingaben des nutzenden Kontos gemeinsam nutzen möchten, sollten Sie die gemeinsame Nutzung über das in Betracht ziehen AWS Marketplace Catalog API. Für alle anderen Anwendungsfälle sollten Sie die Nutzung AWS RAM zur gemeinsamen Nutzung von AWS Marketplace Ressourcen in Betracht ziehen.

In den folgenden Abschnitten wird beschrieben, wie Sie AWS ressourcenbasierte Richtlinien für Ihre Entitäten mithilfe von einrichten, anzeigen oder löschen können. AWS Marketplace Catalog API

Fügen Sie Ihrer Ressource eine Richtlinie mit Schreibschutz hinzu

Mithilfe eines Freigabekontos können Sie für Ihre gemeinsam genutzte Ressource eine auf Ressourcen basierende Richtlinie mit Schreibschutz erstellen. Mit dieser Richtlinie kann der Principal nur die Details der Ressource einsehen, die mit ihm gemeinsam genutzt wird.

Anforderung

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

Antwort

HTTP/1.1 200
Content-type: application/json

{}

Fügen Sie Ihrer Ressource eine Ressourcenrichtlinie für Lese- und Schreibvorgänge hinzu

Als Sharing-Konto können Sie eine ressourcenbasierte Lese- und Schreibrichtlinie für Ihre gemeinsam genutzte Ressource erstellen. Mit dieser Richtlinie kann der Principal die Details einsehen und Schreibvorgänge auf der Ressource ausführen, die mit ihm gemeinsam genutzt wird.

Anforderung

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

Antwort

HTTP/1.1 200
Content-type: application/json

{}

Die für Ihre Ressource festgelegte Ressourcenrichtlinie anzeigen

Als Sharing-Konto können Sie die Ressourcenrichtlinie einsehen, die für Ihre gemeinsam genutzte Ressource festgelegt ist.

Anforderung

POST /GetResourcePolicy HTTP/1.1 
Content-type: application/json

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}

Antwort

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

Löschen Sie die Ressourcenrichtlinie für Ihre Ressource

Als Sharing-Konto können Sie die Ressourcenrichtlinie löschen, die für Ihre gemeinsam genutzte Ressource festgelegt ist.

Anforderung


POST /DeleteResourcePolicy HTTP/1.1 
Content-type: application/json

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}

Antwort

HTTP/1.1 200
Content-type: application/json

{}

Alle Ressourcen anzeigen, die Ihnen gehören und mit Ihnen geteilt wurden

Als Nutzerkonto können Sie die Ressourcen einsehen, die mit Ihnen geteilt werden.

Anmerkung

Sie können die Ressourcen, die für Sie freigegeben wurden, nur anzeigen, wenn die Ressourcen über geteilt wurden AWS RAM.

Anforderung


POST /ListEntities HTTP/1.1
Content-type: application/json
{
   "Catalog": "AWSMarketplace",
   "EntityType": "AmiProduct",
   "FilterList": [ 
      { 
         "Name": "EntityId",
         "ValueList": [ "example2-abcd-1234-5ef6" ]
      }
   ],
   "OwnershipType": "SHARED"
}

Antwort

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