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](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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.

# Arbeiten Sie mit dem privaten Marktplatz mit dem AWS Marketplace API
<a name="work-with-private-marketplace"></a>

Sie können den verwenden AWS Marketplace Catalog API , um einen *privaten Marktplatz* für Sie AWS-Konto oder Ihre [Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/) zu verwalten.

Alle Änderungstypen können nur über das Verwaltungskonto der Organisation oder über ein Mitgliedskonto aufgerufen werden, bei dem es sich um einen delegierten Administrator für den privaten Marktplatz handelt. Wenn Sie bereits Kunde bei einem privaten Marketplace sind und nicht über die AWS Organizations Integration für einen privaten Marketplace verfügen, können Sie einen privaten Marketplace von jedem Konto in Ihrer Organisation aus erstellen und verwalten, für das die `AWSPrivateMarketplaceAdminFullAccess` IAM-Richtlinie gilt.

 *Weitere Informationen zu privaten Marktplätzen finden Sie im Buyer [Guide unter Private Marktplätze](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-marketplace.html).AWS Marketplace * 

 In der folgenden Tabelle werden eine Reihe von Aufgaben zur Verwaltung privater Marktplätze und die für die einzelnen Aufgaben geltenden Änderungstypen beschrieben. 


| Aufgabe | Action | Typen ändern | 
| --- | --- | --- | 
| [Schaffung eines privaten Marktplatzes](#creating-a-private-marketplace) | `StartChangeSet` | `CreateExperience`<br />`CreateProcurementPolicy` | 
| [Änderung des Brandings eines privaten Marketplace-Erlebnisses](#private-marketplace-branding) | `StartChangeSet` | `CreateBrandingSettings`<br />`UpdateBrandingSettings` | 
| [Aktivierung oder Deaktivierung eines privaten Marketplace-Erlebnisses](#enable-private-marketplace) | `StartChangeSet` | `UpdateExperience` | 
| [Benutzeranfragen aktivieren oder deaktivieren](#private-marketplace-user-requests) | `StartChangeSet` | `UpdateProcurementPolicy` | 
| [Das Abrufen einer Liste von Produkten auf einem privaten Marktplatz](#private-marketplace-policy-details) | `DescribeEntity` | Nicht zutreffend | 
| [Produkte zu einem privaten Marktplatz hinzufügen oder daraus entfernen](#private-marketplace-add-products) | `StartChangeSet` | `AllowProductProcurement`<br />`DenyProductProcurement` | 
| [Produkte finden](#finding-product-ids) | Nicht zutreffend | Nicht zutreffend | 
| [Zusammenarbeit mit privaten Marktplätzen für AWS Organizations](#private-marketplace-organizations) | Nicht zutreffend | Nicht zutreffend | 
| [Principals mit Erlebnissen verknüpfen](#private-marketplace-associate-accounts) | `StartChangeSet` | `AssociateAudience`<br />`DisassociateAudience` | 
| [Archivierung und Reaktivierung eines privaten Marketplace-Erlebnisses](#archiving-and-reactivating-a-private-marketplace-experience-capi) | `StartChangeSet` | `RestrictExperience`<br />`ReviveExperience` | 

## Schaffung eines privaten Marktplatzes
<a name="creating-a-private-marketplace"></a>

Ein privater Marktplatz für einen AWS-Konto kann als eine Liste von Produkten betrachtet werden, die Benutzer über dieses Konto erwerben dürfen, und als Branding für den Marktplatz. In einer Organisation mit mehreren Konten können Sie die Gruppierung aus der so AWS Organizations genannten [Organisationseinheit (OU)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#organizationalunit) verwenden, um eine Verbindung zu einem Erlebnis herzustellen. Sie könnten beispielsweise eine Reihe von Produkten haben, die alle Accounts in der Organisation beschaffen dürfen, oder Sie könnten für jede Organisationseinheit in der Organisation eine eigene Produktliste erstellen. Sie können auch eine andere Produktliste für einzelne Konten in der Organisation haben. *Jede Liste zugelassener Produkte und Marken wird als Einkaufserlebnis bezeichnet.* 

In der AWS Marketplace Catalog API stehen vier Einheiten für ein Erlebnis:
+ `Experience`Entität — Diese Entität befindet sich auf der höchsten Erlebnisebene und umfasst zwei untergeordnete Entitäten.
+ `ProcurementPolicy`Entität — Diese Entität steht für die Produkte, die auf Ihrem privaten Marktplatz zugelassen und verweigert wurden.
+ `BrandingSettings`Entität — Sie können auch eine `BrandingSettings` Entität erstellen, um zu definieren, wie Ihr privater Marktplatz für Ihre Nutzer aussieht. 
+ `Audience`Entität — Sie müssen auch eine oder mehrere `Audience` Entitäten zuordnen, die die Gruppe, die Organisationseinheiten oder die Organisation definieren, für die das Erlebnis gilt. AWS-Konten

Die Schritte zur Erstellung eines Einkaufserlebnisses lauten wie folgt:

1. Erstellen Sie die `Experience` Entität.

1. Erstellen Sie eine `ProcurementPolicy` Entität, um die Liste der Produkte zu speichern, die für das Erlebnis zugelassen oder verweigert wurden.

1. (Optional) Erstellen Sie eine `BrandingSettings` Entität, um das Erscheinungsbild Ihres Marketplace-Erlebnisses anzupassen.

1. Ordnen Sie Ihrer Erfahrung Principals zu. Ein Principal kann eine AWS-Konto, eine OU oder die Organisation sein.

1. Aktivieren Sie das Erlebnis.

**Anmerkung**  
Wenn Ihr Konto Teil einer Organisation in ist AWS Organizations, finden Sie weitere Informationen unter[Zusammenarbeit mit privaten Marktplätzen für AWS Organizations](#private-marketplace-organizations).

**Erstellen Sie die `Experience` Entität**

Um die `Experience` Entität zu erstellen, verwenden Sie die `StartChangeSet` Aktion mit dem `CreateExperience` Wert für den `ChangeType` Parameter, um anzufordern, dass das Erlebnis von erstellt wird AWS Marketplace. Beachten Sie hierzu das folgende Codebeispiel.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateExperience",
      "DetailsDocument":
      {
        "Name": "ExamplePrivateMarketplace"
      },
      "Entity":
      {
        "Type": "Experience@1.0"
      }
    }
  ],
  "ChangeSetName": "Create Private Marketplace Example"
}
```

Bei dieser Aktion `Entity` handelt es sich um eine Vorlage für die Entität, die Sie erstellen möchten. Ihr wird zugewiesen`EntityId`, wenn sie erstellt wird. `ChangeSetName`identifiziert die Änderung, damit Sie sie später leichter finden können.

Die Antwort sieht wie folgt aus.

```
{
   "ChangeSetArn": "arn:...:AWSMarketplace/ChangeSet/abcd1234example5678frjzkz",
   "ChangeSetId": "abcd1234example5678frjzkz"
}
```

Die Antwort enthält eine`ChangeSetId`, anhand derer Sie den Status Ihrer Änderungsanfrage während der Bearbeitung abrufen können`DescribeChangeSet`. Sie können es auch verwenden`ListEntities`, um Ihre `Experience` Entität ohne die zu finden`ChangeSetId`. Weitere Informationen über Änderungssätze finden Sie unter [Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets).

Für eine neu erstellte `Experience` Entität gibt es standardmäßig keine Beschaffungsrichtlinie. Es wird auch mit Standardeinstellungen für das Branding erstellt. Weitere Informationen zu Branding-Einstellungen, einschließlich deren Anpassung, finden Sie unter[Änderung des Brandings eines privaten Marketplace-Erlebnisses](#private-marketplace-branding).

**Erstellen Sie eine `ProcurementPolicy` Entität**

Sie müssen eine `ProcurementPolicy` Entität erstellen. Standardmäßig ist eine neue `Experience` Entität deaktiviert, sodass Sie die Beschaffungsrichtlinie erstellen können, bevor Sie sie aktivieren.

**Anmerkung**  
Eine `Experience` Entität *ohne* Beschaffungsrichtlinie (Null) ermöglicht die Beschaffung aller Produkte auf Ihrer privaten Marketplace-Site. Für ein `Experience` Unternehmen mit einer *leeren* Beschaffungsrichtlinie stehen den Benutzern keine Produkte zur Beschaffung zur Verfügung.

Um Produkte auf Ihrer privaten Marketplace-Site zuzulassen oder abzulehnen, müssen Sie die Beschaffungsrichtlinie erstellen. Dazu rufen Sie erneut an`StartChangeSet`, diesmal jedoch mit dem `ChangeType` Aus`CreateProcurementPolicy`. Das folgende Codebeispiel erstellt eine leere Beschaffungsrichtlinie.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateProcurementPolicy",
      "DetailsDocument":
      {
        "Name": "ExampleProcurementPolicy"
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@1"
      }
    }
  ]
}
```

Die Entität, die `Entity` Sie in dieser Aktion angeben, ist die `Experience` Entität, in der Sie die Beschaffungsrichtlinie erstellen möchten. Daher müssen Sie den Bezeichner für die Entität angeben, die Sie zuvor erstellt haben. Verwenden Sie`ListEntities`, um die `Experience` Entität zu finden. Sie können die ID auch zurückgeben, indem Sie sie `DescribeChangeSet` zusammen mit der Änderungssatz-ID aus der `CreateExperience` Aktion verwenden

**Anmerkung**  
Dieses Beispiel zeigt den Bezeichner mit einer Revision von`1`. Weitere Hinweise zu Revisionen für Bezeichner finden Sie unter. [Kennung](catalog-apis.md#identifier)

Sie können den `CreateProcurementPolicy` Änderungstyp erneut verwenden`DescribeChangeSet`, um die Bearbeitung Ihrer Anfrage zu verfolgen.

**Anmerkung**  
Die Namen, die Sie `Experience` den `ProcurementPolicy` Objekten geben, kommen nicht vor AWS Marketplace. Die Namen dienen nur dazu, Ihnen das Auffinden der Entitäten in der API zu erleichtern.

Nachdem Sie die Beschaffungsrichtlinie erstellt haben, wird Ihr privater Marktplatz im angezeigt AWS-Managementkonsole. (Sie können auf die [Private Marketplace-Seite](https://aws.amazon.com/marketplace/privatemarketplace) gehen, um es zu sehen.) Nachdem Sie diese Schritte abgeschlossen haben, wird Ihr privater Marketplace deaktiviert, hat ein Standard-Branding, hat eine leere Beschaffungsrichtlinie und wird keinem Principal in Ihrer Organisation zugeordnet. Sie können das Branding aktualisieren und alle gewünschten Produkte hinzufügen, das Erlebnis einem oder mehreren Konten zuordnen und dann Ihren privaten Marktplatz aktivieren.

In den folgenden Abschnitten wird die Verwaltung Ihres privaten Marktplatzes mit dem beschrieben AWS Marketplace Catalog API.

## Änderung des Brandings eines privaten Marketplace-Erlebnisses
<a name="private-marketplace-branding"></a>

Sie können das Aussehen Ihres privaten Marktplatzes für Ihre Nutzer anpassen. Ohne Anpassung verfügt Ihr privater Marktplatz über die Standard-Branding-Einstellungen, die im Folgenden beschrieben werden. Zu den Aspekten des Brandings, die Sie auf einer privaten Marketplace-Site ändern können, gehören:
+ `Title`— Der Name, der für Ihren privaten Marktplatz angezeigt wird. Dies entspricht dem Feld **Name** in den **Profileinstellungen** des privaten Marktplatzes. Wenn Sie das `Title` auf setzen**Example**, wird der angezeigte Text **Example Private Marketplace** angezeigt. Die Standardeinstellung ist **Private Marketplace**.
+ `Information`— Der Absatz, der unter dem Namen auf Ihrem privaten Marktplatz angezeigt wird. Dies entspricht dem Feld **Beschreibung** in den **Profileinstellungen**. Die Standardeinstellung ist „Keine Informationen“. In diesem Fall wird eine allgemeine Beschreibung der privaten Marktplätze angezeigt.
+ `ThemeColor`— Die Farbe, die im Banner Ihres privaten Marktplatzes angezeigt wird. Dies ist eine Farbe im RGB-Hexadezimalformat. Dieser Wert entspricht dem Feld **Themenfarbe** in den **Profileinstellungen**. Der Standardwert ist `#232F3E`.
+ `LogoUrl`— Die URL, die auf eine Bilddatei verweist, die als Logo auf Ihrem privaten Marktplatz verwendet werden soll. Die URL muss öffentlich verfügbar sein (z. B. eine signierte Amazon S3 S3-URL). Die Datei muss entweder eine PNG- oder eine SVG-Datei sein und weniger als 500 KB groß sein. Falls erforderlich, wird die Bilddatei auf eine maximale Höhe von 30 Pixeln und eine maximale Breite von 100 Pixeln skaliert. Dies ist derselbe Wert wie bei der ****Logo-Auswahl**** in den **Profileinstellungen**. Standardmäßig wird kein Logo angezeigt.

Um diese Werte festzulegen, müssen Sie zuerst eine `BrandingSettings` Entität mit dem `CreateBrandingSettings` Änderungstyp erstellen. Sie können dann eine `UpdateBrandingSettings` Änderung anfordern, um das Branding festzulegen oder zu ändern. Sie müssen ein `BrandingSettings` Objekt nur einmal erstellen. Um dieses Objekt zu erstellen, rufen Sie es `StartChangeSet` mit dem `CreateBrandingSettings` Änderungstyp auf, wie im folgenden Codebeispiel gezeigt.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateBrandingSettings",
      "DetailsDocument":
      {
        "Name": "ExampleBrandingSettingsName"
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@2"
      }
    }
  ]
}
```

In diesem Beispiel wird die `Experience` Entität geändert, indem das `BrandingSettings` Objekt hinzugefügt wird. Die Revision des Entitätsbezeichners wurde auf erhöht. `2` Weitere Hinweise zu Revisionen für Identifikatoren finden Sie unter. [Kennung](catalog-apis.md#identifier)

**Anmerkung**  
Sie können alle Details der Branding-Einstellungen in dem Aufruf angeben, um die Entität für Branding-Einstellungen zu erstellen. Die Detailfacette ist für `CreateBrandingSettings` und `UpdateBrandingSettings` dieselbe.

Sie ändern die Einstellungen, indem Sie `StartChangeSet` mit dem `UpdateBrandingSettings` Änderungstyp aufrufen. Die Einstellungen sind Teil `Configuration` des `DetailsDocument` Objekts.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateBrandingSettings",
      "DetailsDocument":
      {
        "Name": "ExampleBrandingSettingsName",
        "Description": "Example description",
        "Configuration":
        {
          "Title": "ExampleName",
          "Information": "Example description.",
          "ThemeColor": "#0e7f74",
          "LogoUrl": "https://example.com/path/mylogo.png"
        }
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@3"
      }
    }
  ]
}
```

**Anmerkung**  
Die URL für das Logo wird verwendet, um während der Änderung des Updates eine Kopie zu erstellen. Wenn Sie nach Abschluss der Änderung die URL unter diesem Pfad entfernen oder ändern, hat dies keine Auswirkungen auf Ihren privaten Marktplatz, es sei denn, Sie stellen erneut eine Anfrage`UpdateBrandingSettings`.

## Aktivierung oder Deaktivierung eines privaten Marketplace-Erlebnisses
<a name="enable-private-marketplace"></a>

Wenn ein privater Marktplatz aktiviert ist (und über eine Beschaffungsrichtlinie verfügt), können Benutzer mit zugehörigen Konten nur Produkte kaufen, die Sie genehmigt haben. Wenn für ein Konto kein privater Marktplatz aktiviert ist, können Benutzer Produkte aus dem gesamten AWS Marketplace Katalog kaufen.

Um einen privaten Marktplatz zu aktivieren, verwenden Sie die `StartChangeRequest` Aktion mit dem `UpdateExperience` Änderungstyp.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateExperience",
      "DetailsDocument":
      {
        "Status": "Enabled"
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@4"
      }
    }
  ]
}
```

In ähnlicher Weise können Sie dieselbe Aktion und verwenden`ChangeType`, aber den Wert `Status` in ändern, `DetailsDocument` `Disabled` um einen privaten Marktplatz zu deaktivieren.

**Anmerkung**  
Wenn Sie eine private Marketplace-Site deaktivieren, behalten Sie Ihre Liste der zugelassenen und abgelehnten Produkte sowie Anpassungen, wie z. B. das Branding, bei. Wenn eine private Marketplace-Site deaktiviert ist, sehen Nutzer die private Marketplace-Site nicht mehr (obwohl sie möglicherweise weiterhin der Standarderfahrung der Organisation unterliegen). Wenn für ein Konto keine privaten Marketplace-Erlebnisse aktiviert sind, werden alle Einschränkungen aufgehoben, und Benutzer können alle Produkte öffentlich AWS Marketplace erwerben.

## Benutzeranfragen aktivieren oder deaktivieren
<a name="private-marketplace-user-requests"></a>

Benutzer in Ihrer Organisation können die gesamte Öffentlichkeit sehen AWS Marketplace, aber sie können nur die Produkte abonnieren, die Sie zugelassen haben. Standardmäßig können sie verlangen, dass ein Produkt, das nicht auf dem privaten Marketplace erhältlich ist, hinzugefügt wird. Diese Anfragen werden auf der Administratorseite des privaten Marktplatzes ([Private Marketplace](https://aws.amazon.com/marketplace/privatemarketplace/admin/)) angezeigt, auf der Sie entscheiden können, ob Sie die Anfrage annehmen oder ablehnen möchten (und ob Sie weitere Anfragen für dasselbe Produkt blockieren möchten). Mithilfe der Katalog-API können Sie die Anfragen nicht sehen oder darauf antworten.

Sie können die Möglichkeit für Benutzer aktivieren oder deaktivieren, Anfragen für Ihr privates Marketplace-Erlebnis zu erstellen. Verwenden Sie es `StartChangeSet` zusammen mit dem `UpdateProcurementPolicy` Änderungstyp. Die Möglichkeit, Anfragen zu stellen, ist im folgenden Codebeispiel deaktiviert.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateProcurementPolicy",
      "DetailsDocument":
      {
        "Configuration":
        {
          "PolicyResourceRequests": "Deny"
        }
      },
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example@5"
      }
    }
  ]
}
```

Um die Änderungsanforderungsfunktion für Benutzer zu aktivieren, verwenden Sie `Allow` statt `Deny` in`PolicyResourceRequests`.

Informationen zum Abrufen des aktuellen Status dieser Einstellung finden Sie im nächsten Abschnitt,[Das Abrufen einer Liste von Produkten auf einem privaten Marktplatz](#private-marketplace-policy-details).

## Das Abrufen einer Liste von Produkten auf einem privaten Marktplatz
<a name="private-marketplace-policy-details"></a>

Die Produkte, die auf einem privaten Marktplatz zugelassen (und verweigert) werden, sind Teil der Beschaffungspolitik des `Experience` Unternehmens. Um die Details zu den Beschaffungsrichtlinien auf einem privaten Marktplatz zu erhalten, erhalten Sie zunächst die Beschaffungsrichtlinien-ID von der `Experience` Entität und rufen dann `DescribeEntity` mit dieser ID an.

Um die Beschaffungsrichtlinien-ID zu erhalten, verwenden `DescribeEntity` Sie sie für die `Experience` Entität, an der Sie interessiert sind, wie im folgenden Befehl gezeigt.

```
GET /DescribeEntity?catalog=AWSMarketplace&entityId={{exp-example01}}
```

Nachfolgend finden Sie eine Beispielantwort.

```
{
  "Details": "{\"Name\":\"New Private Marketplace\", \"Status\":\"Enabled\", \"ProcurementPolicies\":[\"procpolicy-123example456\"], \"BrandingSettings\":[\"brandsettings-456example123\"]}",
  "DetailsDocument":
  {
    "Name": "New Private Marketplace",
    "Status": "Enabled",
    "ProcurementPolicies":
    [
      "procpolicy-123example456"
    ],
    "BrandingSettings":
    [
      "brandsettings-456example123"
    ]
  },
  "EntityArn": "arn:<...>:AWSMarketplace/Experience/exp-example-01",
  "EntityIdentifier": "exp-example01@6",
  "EntityType": "Experience@1.0",
  "LastModifiedDate": "2021-01-13T20:31:36Z"
}
```

**Anmerkung**  
Das `DetailsDocument` Attribut enthält die Entitätsdetails als JSON-Objekt. Das `Details` Legacy-Attribut enthält dasselbe JSON-Objekt als Zeichenfolge. 

Sie können die zurückgegebene `EntityId` Beschaffungsrichtlinie verwenden, um die Details abzurufen, wie im folgenden Befehl gezeigt.

```
GET /DescribeEntity?catalog=AWSMarketplace&entityId={{procpolicy-123example456}}
```

Dadurch werden die vollständigen Details der Richtlinie zurückgegeben, einschließlich zugelassener und abgelehnter Produkte. Nachfolgend finden Sie eine Beispielantwort.

```
{
  "Details": "{\"Name\":\"ExampleProcurementPolicy\", \"Statements\":[{\"Effect\":\"Allow\",\"Resources\":[{\"Type\":\"Product\",\"Ids\":[\"example1-1234-abcd-5678-90abcdef1234\"]},{\"Type\":\"Product\",\"Ids\":[\"example2-2345-bcde-6789-01bcdea2345\"]}]},{\"Effect\":\"Deny\",\"Resources\":[{\"Type\":\"Product\",\"Ids\":[\"example3-3456-cdef-7890-12defabc5678\"]}]}],\"Configuration\":{\"PolicyResourceRequests\":\"Allow\"}}",
  "DetailsDocument":
  {
    "Name": "ExampleProcurementPolicy",
    "Statements":
    [
      {
        "Effect": "Allow",
        "Resources":
        [
          {
            "Type": "Product",
            "Ids":
            [
              "example1-1234-abcd-5678-90abcdef1234"
            ]
          },
          {
            "Type": "Product",
            "Ids":
            [
              "example2-2345-bcde-6789-01bcdea2345"
            ]
          }
        ]
      },
      {
        "Effect": "Deny",
        "Resources":
        [
          {
            "Type": "Product",
            "Ids":
            [
              "example3-3456-cdef-7890-12defabc5678"
            ]
          }
        ]
      }
    ],
    "Configuration":
    {
      "PolicyResourceRequests": "Allow"
    }
  },
  "EntityArn": "arn:<...>AWSMarketplace/ProcurementPolicy/procpolicy-123example456",
  "EntityIdentifier": "procpolicy-123example456@4",
  "EntityType": "ProcurementPolicy@1.0",
  "LastModifiedDate": "2020-10-01T12:00:00Z"
}
```

In diesem Beispiel umfasst die Beschaffungsrichtlinie zwei zugelassene Produkte und ein abgelehntes Produkt. Die Richtlinie erlaubt Anfragen von Benutzerressourcen.

## Produkte zu einem privaten Marktplatz hinzufügen oder daraus entfernen
<a name="private-marketplace-add-products"></a>

Standardmäßig enthält ein privater Marktplatz keine zugelassenen Produkte. Verwenden Sie Änderungsanfragen, um ein Produkt hinzuzufügen oder zu entfernen. Verwenden Sie den `AllowProductProcurement` Änderungstyp, um ein Produkt hinzuzufügen. Verwenden Sie den `DenyProductProcurement` Änderungstyp, um ein Produkt zu entfernen. 

Das folgende Codebeispiel zeigt den `AllowProductProcurement` Änderungstyp mit der `StartChangeSet` Aktion, ein Produkt zu einer privaten Marketplace-Site hinzuzufügen.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "AllowProductProcurement",
      "DetailsDocument":
      {
        "Products":
        [
          {
            "Ids":
            [
              "example-1234-abcd-5678-90abcded1234"
            ],
            "Notes": "Useful product"
          }
        ]
      },
      "Entity":
      {
        "Identifier": "exp-1234example@6",
        "Type": "Experience@1.0"
      }
    }
  ]
}
```

Sie fügen das Produkt der `Experience` Entität für einen privaten Marktplatz hinzu, indem Sie`AllowProductProcurement`. Die Syntax zum Entfernen eines Produkts von einer privaten Marketplace-Site ist identisch, mit der Ausnahme, dass Sie `DenyProductProcurement` `ChangeType` anstelle von die Syntax verwenden`AllowProductProcurement`. Die Produkte werden der Zulassungsliste (oder Ablehnungsliste) der `ProcurementPolicy` Entität hinzugefügt, die in Ihrer `Experience` Entität enthalten ist.

**Anmerkung**  
Die Liste der Produkte in der `DetailsDocument` von Ihnen geänderten Version besteht aus einer Reihe von Produkten`Ids`, sodass Sie mehrere Produkte mit einem Aufruf hinzufügen (oder entfernen) können, indem Sie eine Liste mit Produktkennzeichnungen hinzufügen. Das Limit liegt bei 50 Produkten pro Anfrage.  
Das `Notes` Feld für die Liste von `Ids` ist nicht erforderlich. Sie können es jedoch verwenden, um aufzuzeichnen, warum eine Entscheidung getroffen wurde, eine Reihe von Produkten zuzulassen oder abzulehnen.

## Produkte finden
<a name="finding-product-ids"></a>

Wenn Sie sich die Einzelheiten Ihrer Einkaufsrichtlinien ansehen, können Sie die Produkt-IDs für die Produkte finden, die bereits auf einem privaten Marktplatz erhältlich sind. Das AWS Marketplace Catalog API bietet jedoch keine Möglichkeit, die Produkt-IDs für andere Produkte zu finden. Es gibt zwei Möglichkeiten, Produkt-IDs für die Verwendung mit dem Catalog API-Dienst abzurufen:
+ **Öffentlicher Marktplatz** — Nachdem Sie ein Produkt auf der öffentlichen Marketplace-Site gefunden haben, wählen Sie **Weiter abonnieren**, um eine Detailseite zu dem Produkt aufzurufen (Sie erhalten das Produkt dadurch nicht). Die URL wird die Produkt-ID als Parameter enthalten. In der URL {{ab1234cd-1234-abcd-5678-90abcdef1234}} steht `https://aws.amazon.com/marketplace/fulfillment?productId=ab1234cd-1234-abcd-5678-90abcdef1234&ref_=dtl_psb_continue` beispielsweise die Produkt-ID.
+ **AWS Marketplace Discovery-API** — Programmgesteuert können Sie mithilfe der Discovery-API auf die vollständige Liste der AWS Marketplace Produkte in der zugreifen. Die Discovery-API ist eine private API. Sie müssen Zugriff beantragen, um sie verwenden zu können. Weitere Informationen finden Sie unter [Zugriffskontrolle für die AWS Marketplace Discovery-API](discovery-api-access-control.md). 

## Zusammenarbeit mit privaten Marktplätzen für AWS Organizations
<a name="private-marketplace-organizations"></a>

Unabhängig davon, ob Sie mit einem privaten Marktplatz für Ihr Konto oder Ihre Organisation arbeiten, verwenden Sie dieselbe API. Es gibt jedoch Unterschiede, wenn Sie innerhalb Ihrer Organisation arbeiten:
+ Bevor Sie die Funktion „Private Marketplace“ in einer Organisation verwenden können, müssen Sie den [vertrauenswürdigen Zugriff aktivieren](https://docs.aws.amazon.com/organizations/latest/APIReference/API_EnableAWSServiceAccess.html), um dem privaten Marketplace Service (`private-marketplace.marketplace.amazonaws.com`) Zugriff auf Ihre AWS Organizations Daten zu gewähren. Sie müssen auch die mit [dem Dienst verknüpfte Rolle Private Marketplace im Verwaltungskonto erstellen](https://docs.aws.amazon.com/organizations/latest/APIReference/API_EnableAWSServiceAccess.html). Diese Rolle umfasst alle Berechtigungen, die Private Marketplace benötigt, um private Marketplace-Ressourcen in Ihrem Namen zu beschreiben AWS Organizations und zu aktualisieren. Diese Aktionen können nur über das Verwaltungskonto ausgeführt werden. Es wird empfohlen, diese Aktivierung über die private Marketplace-Administratorseite durchzuführen. *Wenn Sie ein neuer Kunde sind, finden Sie im Buyer Guide [weitere Informationen unter Private Marktplätze](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-using-service-linked-roles.html).AWS Marketplace * Wenn Sie bereits Kunde sind, finden Sie weitere Informationen unter [Private Marketplace-Site erstellen und verwalten](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-catalog-administration.html) im *AWS Marketplace Buyer Guide*. 
+ Private Marketplace-Ressourcen in einer Organisation werden im Verwaltungskonto erstellt und mit dem Mitgliedskonto geteilt, bei dem es sich um einen delegierten Administrator für private Marketplace-Sites handelt.
+ Wenn Sie Objekte auf einer privaten Marketplace-Site von einem Mitgliedskonto aus anbieten, das ein delegierter Administrator für eine private Marketplace-Site ist, müssen Sie diese mit dem `SharedWithMe` Filter ausdrücklich anfordern. Dies gilt sowohl `ListEntities` für Aktionen als auch für `ListChangeSets` Aktionen.

Um `Experience` Objekte in Ihrem eigenen Konto aufzulisten, rufen Sie `ListEntities` wie im folgenden Codebeispiel gezeigt auf.

```
POST /ListEntities HTTP/1.1
Content-Type: application/json

{
    "Catalog":"AWSMarketplace", 
    "EntityType":"Experience"
}
```

Um jedoch die Entitäten aufzulisten, die für Sie freigegeben wurden, müssen Sie ein Zeichen `FilterList` mit dem `Scope` Zeichen von hinzufügen`SharedWithMe`, wie im folgenden Codebeispiel gezeigt. AWS Marketplace Sucht daher außerhalb Ihres eigenen Kontos nach Entitäten, die mit Ihnen geteilt wurden.

```
POST /ListEntities HTTP/1.1
Content-Type: application/json

{"Catalog":"AWSMarketplace", 
"EntityType":"Experience",
 "FilterList": 
  [{
     "Name": "Scope",
     "ValueList":
      ["SharedWithMe"]
      }]}
```

In diesem Fall werden nur Entitäten außerhalb Ihres Kontos (die Entitäten für Ihre Organisation) zurückgegeben.

In ähnlicher Weise müssen Sie für einen Anruf `ListChangeSets` den Bereich festlegen, wie im folgenden Codebeispiel gezeigt.

```
POST /ListChangeSets HTTP/1.1
Content-Type: application/json

{"Catalog":"AWSMarketplace", 
 "FilterList": 
  [{
     "Name": "Scope",
     "ValueList":
      ["SharedWithMe"]
      }]}
```

Dadurch werden Änderungssätze zurückgegeben, die für eine gemeinsame private Marketplace-Site Ihrer Organisation gelten.

## Principals mit Erlebnissen verknüpfen
<a name="private-marketplace-associate-accounts"></a>

Ein privates Marketplace-Erlebnis muss mit einem oder mehreren Principals verknüpft sein, damit es Auswirkungen auf Ihr Unternehmen hat. Für ein einzelnes AWS-Konto Erlebnis müssen Sie das Konto mit dem Erlebnis verknüpfen, um den privaten Marktplatz nutzen zu können. In einer Organisation können Sie mehrere Erlebnisse für verschiedene Schulleiter anbieten. 

**Anmerkung**  
Das Erlebnis, das der Organisation zugeordnet ist, ist der Standard für alle anderen Konten in der Organisation. Die Verknüpfung eines Mitgliedskontos oder einer Organisationseinheit mit einer anderen Benutzererfahrung führt direkt zu einer anderen Benutzererfahrung für das Mitgliedskonto oder die untergeordneten Konten der Organisationseinheit.
Wenn Sie ein aktueller privater Marketplace-Kunde ohne die AWS Organizations Integration für einen privaten Marketplace sind, ist das Erlebnis, das mit dem Verwaltungskonto verknüpft ist, der Standard für alle anderen Konten in der Organisation.

Um einem Erlebnis einen Principal zuzuordnen, verwenden Sie den `AssociateAudience` Änderungstyp für die `StartChangeSet` Aktion, wie im folgenden Codebeispiel gezeigt.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-example01@1"
      },
      "ChangeType": "AssociateAudience",
      "DetailsDocument":
      {
        "Name": "AudienceName",
        "Description": "Audience example.",
        "Principals":
        [
          "012345678901",
          "ou-abcd-01234567",
          "o-0123456789"
        ]
      }
    }
  ],
  "ChangeSetName": "Set Audience for experience 01"
}
```

Die *Zielgruppe* ist die Liste der *Principals*, die dem `Experience` zugeordnet sind. Ein Principal ist eine AWS-Konto Organisationseinheit oder Organisation, die durch ihre ID definiert wird. `Principals`ist eine Liste, sodass Sie mehrere Principals angeben können, die dem Erlebnis zugeordnet werden sollen. Nach dem ersten Anruf werden bei nachfolgenden Aufrufen des `AssociateAudience` Änderungstyps der Zuordnung für das Erlebnis Principals hinzugefügt.

Sie können Konten auch aus einem Erlebnis entfernen. Verwenden Sie dazu den `DisassociateAudience` Änderungstyp, wie im folgenden Codebeispiel gezeigt.

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-example01@02"
      },
      "ChangeType": "DisassociateAudience",
      "DetailsDocument":
      {
        "Principals":
        [
          "012345678901",
          "ou-abcd-01234567",
          "o-0123456789"
        ]
      }
    }
  ],
  "ChangeSetName": "Disassociate audience example"
}
```

**Anmerkung**  
Ein Schulleiter kann nur einem Erlebnis direkt zugeordnet werden. Um einen Schulleiter nicht mehr direkt mit einem Erlebnis zu einem anderen Erlebnis zu verbinden, müssen Sie ihn von der ersten Erfahrung trennen und ihn dann der zweiten zuordnen.

## Archivierung und Reaktivierung eines privaten Marketplace-Erlebnisses
<a name="archiving-and-reactivating-a-private-marketplace-experience-capi"></a>

Sie können ein privates Marketplace-Erlebnis entfernen, indem Sie es archivieren. Archivierte Erlebnisse können nicht aktualisiert oder zur Verwaltung von Konten in Ihrer Organisation verwendet werden. Wenn Sie Zielgruppen haben, die mit einem archivierten Erlebnis verknüpft sind, können Sie sie einem anderen Erlebnis zuordnen. Wenn Sie sich entscheiden, das Erlebnis zu einem späteren Zeitpunkt zu nutzen, können Sie es jederzeit wieder aktivieren. Administratoren des Verwaltungskontos oder eines Mitgliedskontos, bei dem es sich um einen delegierten Administrator für den privaten Marktplatz handelt, sind berechtigt, Erlebnisse zu archivieren und zu reaktivieren. Wenn Sie ein aktueller privater Marketplace-Kunde ohne die AWS Organizations Integration für den privaten Marktplatz sind, sind Administratoren des Kontos, das das Erlebnis erstellt hat, berechtigt, Erlebnisse zu archivieren und zu reaktivieren.

**Anmerkung**  
Bevor Sie ein Erlebnis archivieren, müssen Sie es deaktivieren. Informationen zur Deaktivierung eines Erlebnisses finden Sie im *AWS Marketplace Buyer Guide* unter [Konfiguration Ihres privaten Marktplatzes](https://docs.aws.amazon.com/marketplace/latest/buyerguide/private-catalog-administration.html#configure-your-private-marketplace).

Um ein Erlebnis zu archivieren, verwenden Sie den `RestrictExperience` Änderungstyp zusammen mit der `StartChangeSet` Aktion, wie im folgenden Codebeispiel gezeigt.

```
POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictExperience",
      "DetailsDocument":
      {},
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example"
      }
    }
  ]
}
```

Um ein Erlebnis zu reaktivieren, verwenden Sie den `ReviveExperience` Änderungstyp zusammen mit der `StartChangeSet` Aktion, wie im folgenden Codebeispiel gezeigt.

```
POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "ReviveExperience",
      "DetailsDocument":
      {},
      "Entity":
      {
        "Type": "Experience@1.0",
        "Identifier": "exp-1234example"
      }
    }
  ]
}
```

## Fehler in der privaten Marketplace-API
<a name="private-marketplace-error-codes"></a>

Die folgenden Fehler beziehen sich spezifisch auf die Aktionen für private Marktplätze in der AWS Marketplace Katalog-API.


<table>
<thead>
  <tr><th>Änderungstyp</th><th>Fehlercode</th><th>Fehlermeldung</th><th>Description</th></tr>
</thead>
<tbody>
  <tr><td colspan="4">Errors returned directly by the StartChangeSet action</td></tr>
  <tr><td>Alle</td><td>422</td><td>Dokument ist nicht gültiges JSON-Format</td><td>Es wurde eine ungültige JSON-Eingabe verwendet. Überprüfen Sie Ihre Syntax.</td></tr>
  <tr><td>AllowProductProcurement, DenyProductProcurement</td><td>422</td><td>Werte im IDS-Array müssen eindeutig sein</td><td>Sie können dasselbe Produkt nicht mehrmals in eine einzige Änderungsanforderung aufnehmen.</td></tr>
  <tr><td>AllowProductProcurement, DenyProductProcurement</td><td>422</td><td>Die kumulierte Anzahl der Werte im IDS-Array muss kleiner oder gleich 50 sein</td><td>Sie können in einer einzigen Änderungsanforderung bis zu 50 Produkte zulassen oder ablehnen.</td></tr>
  <tr><td colspan="4">Errors found by calling the DescribeChangeSet action</td></tr>
  <tr><td>CreateBrandingSettings, UpdateBrandingSettings</td><td>UNGÜLTIGE\_URL</td><td>Das Bild konnte nicht von der Eingabe-URL abgerufen werden</td><td>Sie müssen eine gültige, erreichbare URL für das Logofeld in `BrandingSettings` angeben.</td></tr>
  <tr><td>CreateBrandingSettings, UpdateBrandingSettings</td><td>INVALID\_IMAGE</td><td>Die Bildverifizierung für Typ, Inhalt oder Dateigröße ist fehlgeschlagen. Nur PNG- und SVG-Dateitypen mit einer Größe von weniger als oder gleich 500 KB werden unterstützt.</td><td>Ihre Bilddatei muss den Logo-Anforderungen für die Branding-Einstellungen entsprechen.</td></tr>
  <tr><td>AllowProductProcurement, DenyProductProcurement</td><td>ENTITY\_NOT\_FOUND</td><td>Die Beschaffungspolitik fehlt in Experience</td><td>Sie müssen eine erstellen, `ProcurementPolicy` bevor Sie Produkte zulassen oder ablehnen.</td></tr>
  <tr><td>CreateProcurementPolicy</td><td>ENTITY\_ALREADY\_EXISTS</td><td>Für Experience gibt es eine Beschaffungsrichtlinie</td><td>Sie können nur eine einzige Beschaffungsrichtlinie für einen privaten Marktplatz haben.</td></tr>
  <tr><td>UpdateProcurementPolicy</td><td>ENTITY\_NOT\_FOUND</td><td>Die Beschaffungspolitik fehlt in Experience</td><td>Sie müssen eine erstellen, `ProcurementPolicy` bevor Sie die Beschaffungsrichtlinie aktualisieren.</td></tr>
  <tr><td>CreateBrandingSettings</td><td>ENTITY\_ALREADY\_EXISTS</td><td>Branding-Einstellungen sind für Experience vorhanden</td><td>Sie können nur eine einzige Branding-Einstellung für einen privaten Marktplatz verwenden.</td></tr>
  <tr><td>UpdateBrandingSettings</td><td>ENTITY\_NOT\_FOUND</td><td>Branding-Einstellungen fehlen in Experience</td><td>Sie müssen eine `BrandingSettings` Entität erstellen, bevor Sie die Branding-Einstellungen aktualisieren können.</td></tr>
  <tr><td>AssociateAudience</td><td>CALLER\_NOT\_AUTHORIZED</td><td>Der Anrufer ist nicht berechtigt, die Aktion auszuführen</td><td>Sie müssen über die erforderlichen Berechtigungen verfügen, um die Aktion aufrufen zu können. Die hinzugefügten Konten müssen sich in derselben Organisation befinden.</td></tr>
  <tr><td>CreateExperience</td><td>CALLER\_NOT\_AUTHORIZED</td><td>Der Anrufer ist nicht berechtigt, ein Erlebnis zu erstellen. </td><td>Sie müssen über die erforderlichen Berechtigungen verfügen, um ein Erlebnis zu erstellen.</td></tr>
  <tr><td>AssociateAudience</td><td>ENTITY\_ALREADY\_EXISTS</td><td>Dem Konto {accountId} ist bereits ein Erlebnis zugeordnet. Trennen Sie vor der Aktualisierung die Zuordnung zu früheren Erlebnissen</td><td>Sie können einem Konto nur ein einziges Erlebnis zuordnen. Trennen Sie die Verknüpfung des aktuellen Erlebnisses, bevor Sie ein neues Erlebnis verknüpfen. </td></tr>
  <tr><td>AssociateAudience, DisassociateAudience</td><td>ENTITY\_IN\_USE</td><td>Für das ausgewählte Konto ist bereits eine widersprüchliche Änderung im Gange. Versuchen Sie es später erneut</td><td>Sie können die Zuordnung zu einem Konto nicht ändern, solange bereits eine weitere Änderungsanforderung zur Änderung der Zuordnung bearbeitet wird.</td></tr>
</tbody>
</table>


## Entitätstypen, die von Private Marketplace definiert sind
<a name="entity-types-defined-by-private-marketplace"></a>

In der folgenden Tabelle sind die Entitätstypen, der Zweck und die Aktionen für private Marketplace-Entitäten aufgeführt, für die sie jeweils spezifiziert werden können. Jeder Entitätstyp kann verwendet werden, um einen Amazon-Ressourcennamen (ARN) anzugeben, der in der AWS Identity and Access Management (IAM) -Richtlinie verwendet werden kann. Weitere Informationen zu ARN-Formaten finden Sie unter[API-Entitäten katalogisieren](catalog-apis.md#catalog-api-entities).


| Entität | Zweck | Aktionen | 
| --- | --- | --- | 
| `Experience` | Speichert die Einstellungen der obersten Ebene für einen privaten Marketplace | `StartChangeSet`<br />`DescribeEntity` | 
| `BrandingSettings` | Speichert die Branding-Einstellungen für einen privaten Marktplatz | `DescribeEntity` | 
| `ProcurementPolicy` | Speichert die Beschaffungseinstellungen und Produktlisten auf einer privaten Marketplace-Site | `DescribeEntity` | 
| `Audience` | Speichert die Details von Auftraggebern, die mit einer privaten Marketplace-Site verknüpft sind | `DescribeEntity` |