Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Partner Central 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.
Konfigurationsreferenz
Diese Seite enthält die vollständige Referenz für die Verbindung mit dem Partner Central Agent MCP Server und dessen Konfiguration.
Endpoint
| Eigenschaft | Wert |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Region | us-east-1Nur (Nord-Virginia) |
| Protocol (Protokoll) | JSON-RPC 2.0 über HTTPS |
| Streaming | Server-Sent Ereignisse (SSE) |
| Authentifizierung | AWS Signaturversion 4 |
| SigV4-Dienstname | partnercentral-agents-mcp |
| TLS-Anforderung | TLS 1.2 oder höher |
IAM-Berechtigungen
Alle IAM-Aktionen verwenden das partnercentral: Präfix, sofern nicht anders angegeben.
Zugriff auf das MCP-Protokoll
Als authentifizierte AWS Identität haben Sie standardmäßig Protokollzugriff auf den MCP Server. Für den Protokollzugriff benötigen Sie kein explizites IAM-Allow.
Für die OAuth-Authentifizierung sind die folgenden Anmeldeberechtigungen erforderlich:
| Action | Description |
|---|---|
signin:AuthorizeOAuth2Access |
Autorisiert den browserbasierten OAuth-Flow |
signin:CreateOAuth2Token |
Gibt OAuth-Zugriffstoken aus und aktualisiert sie |
Um den MCP-Zugriff einzuschränken, wenden Sie ein explizites Deny-On an. partnercentral:InvokeMcp
Verwaltung von Geschäftschancen
| Action | Description |
|---|---|
partnercentral:List* |
Listen Sie Chancen, Lösungen und andere Partner Central-Ressourcen auf |
partnercentral:Get* |
Rufen Sie Details zu einzelnen Geschäftschancen und anderen Ressourcen ab |
partnercentral:CreateOpportunity |
Erstellen Sie eine Gelegenheit |
partnercentral:UpdateOpportunity |
Ändern Sie die Opportunity-Felder (Phase, Abschlussdatum, Umsatz usw.) |
partnercentral:SubmitOpportunity |
Reichen Sie eine Gelegenheit zur AWS Überprüfung ein |
partnercentral:AssignOpportunity |
Weisen Sie einem Partnervertreter eine Verkaufschance zu |
partnercentral:AssociateOpportunity |
Verknüpfen Sie eine Opportunity mit einer anderen Ressource (Lösung usw.) |
partnercentral:DisassociateOpportunity |
Eine Verknüpfung zwischen einer Opportunity und einer anderen Ressource entfernen |
partnercentral:StartEngagementFromOpportunityTask |
Reichen Sie Opportunities ein, um ein Engagement von einer Opportunity aus zu starten |
Förderprogramme
| Action | Description |
|---|---|
partnercentral:ListBenefitAllocations |
Listen Sie die verfügbaren Leistungszuweisungen für Ihr Konto auf |
partnercentral:ListBenefitApplications |
Listen Sie die eingereichten Leistungsanträge auf |
partnercentral:CreateBenefitApplication |
Erstellen Sie einen neuen Leistungsantrag (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Rufen Sie die Details eines bestimmten Leistungsantrags ab |
partnercentral:UpdateBenefitApplication |
Aktualisieren Sie einen ausstehenden Leistungsantrag |
partnercentral:AssociateBenefitApplicationResource |
Verknüpfen Sie eine Ressource mit einem Leistungsantrag |
partnercentral:DisassociateBenefitApplicationResource |
Einen Link zu einer Ressource aus einem Leistungsantrag entfernen |
Zugriff auf den Marktplatz
| Action | Description |
|---|---|
aws-marketplace:DescribeEntity |
Rufen Sie die Details einer Marketplace-Entität ab |
aws-marketplace:SearchAgreements |
Suchen Sie nach Marktplatz-Vereinbarungen |
aws-marketplace:ListEntities |
Listet Marktplatz-Unternehmen auf |
Onboarding-Agent
Verwaltung von Partnerkonten (partnercentral):
| Action | Description |
|---|---|
partnercentral:ListPartners |
Partnerregistrierungen für das Konto auflisten |
partnercentral:GetPartner |
Rufen Sie die Partnerregistrierung und die Profildetails ab |
partnercentral:GetProfileVisibility |
Ruft die aktuelle Sichtbarkeit des Profils ab (PUBLIC/PRIVATE) |
partnercentral:GetAllianceLeadContact |
Ruft die Kontaktinformationen des Allianzleiters ab |
partnercentral:GetProfileUpdateTask |
Überprüfen Sie den Status einer ausstehenden asynchronen Profilaktualisierung |
partnercentral:StartProfileUpdateTask |
Reichen Sie ein Partnerprofil-Update ein (asynchron) |
partnercentral:CancelProfileUpdateTask |
Stornieren Sie eine ausstehende Aufgabe zur Profilaktualisierung |
partnercentral:PutProfileVisibility |
Ändern Sie die Sichtbarkeit des Profils auf ÖFFENTLICH oder PRIVAT |
partnercentral:PutAllianceLeadContact |
Aktualisiere den Hauptkontakt der Allianz (Name, Titel, E-Mail) |
partnercentral:SendEmailVerificationCode |
Senden Sie einen Bestätigungscode für Änderungen per E-Mail domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Verknüpfen Sie eine E-Mail-Domain zur Nachverfolgung der Schulungszertifizierung |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Entfernen Sie eine verknüpfte E-Mail-Domain für Schulungen und Zertifizierungen |
partnercentral:GetAccountConnections |
Listet aktive Kontoverbindungen auf (z. B. Links zu Tochterunternehmen) |
partnercentral:GetConnectionInvitations |
Listet ausstehende gesendete und empfangene Verbindungseinladungen auf |
partnercentral:CreateConnectionInvitation |
Eine Verbindungseinladung an ein anderes AWS Konto senden |
partnercentral:CancelConnectionInvitation |
Stornieren Sie eine ausstehende Einladung zu einer ausgehenden Verbindung |
partnercentral:RespondConnectionInvitation |
Eine eingehende Verbindungseinladung annehmen oder ablehnen |
partnercentral:CancelConnection |
Stornieren Sie eine aktive Kontoverbindung |
partnercentral:ManageConnectionPreferences |
Einstellungen zum Teilen zwischen verbundenen Konten abrufen oder aktualisieren |
Einrichtung des Marketplace-Verkäufers (aws-marketplace):
| Action | Description |
|---|---|
aws-marketplace:ListEntities |
Listet Marketplace-Unternehmen auf (z. B. Verkäuferunternehmen) |
aws-marketplace:DescribeEntity |
Rufen Sie die vollständigen Details einer Marketplace-Entität ab |
aws-marketplace:DescribeChangeSet |
Überprüfen Sie den Status eines übermittelten Änderungssatzes |
aws-marketplace:StartChangeSet |
Reichen Sie einen Marketplace-Änderungssatz ein (z. B. Aktualisierung des Verkäuferprofils) |
IAM — serviceverknüpfte Rolle ()iam:
| Action | Description |
|---|---|
iam:GetRole |
Prüfen Sie, ob die serviceverknüpfte Rolle Marketplace Resale Authorization existiert |
iam:CreateServiceLinkedRole |
Erstellen Sie die Rolle AWSServiceRoleForMarketplaceResaleAuthorization |
Umgebungen katalogisieren
| Katalog | Description |
|---|---|
"AWS" |
Produktionsumgebung. Alle Operationen wirken sich auf Live-Partnerdaten aus. |
"Sandbox" |
Isolierte Testumgebung. Keine Auswirkungen auf die Produktionsdaten. Verwendung für Entwicklung und Validierung. |
Verwaltung von Sitzungen
| Eigenschaft | Wert |
|---|---|
| Format der Sitzungs-ID | UUID v4 mit session- Präfix (z. B.) session-550e8400-e29b-41d4-a716-446655440000 |
| Erstellung einer Sitzung | Automatisch beim ersten sendMessage Anruf ohne sessionId |
| Ablauf der Sitzung | 48 Stunden ab Sitzungserstellung (absoluter Ablauf, nicht aufgrund von Inaktivität) |
Datei-Upload
| Eigenschaft | Wert |
|---|---|
| Max. Anzahl der Dateien pro Nachricht | 3 |
| Begrenzung der Bildgröße | 3,75 MB |
| Begrenzung der Dokumentgröße | 4,5 MB |
| Erlaubte Erweiterungen | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| S3-Bucket (Produktion) | aws-partner-central-marketplace-ephemeral-writeonly-files |
| Pfad hochladen | s3://{bucket}/{aws-account-id}/ |
| S3-URI-Anforderung | Muss den versionId Abfrageparameter enthalten |
Arbeitsablauf hochladen
Laden Sie Ihre Datei unter Ihrem AWS Konto-ID-Präfix in den entsprechenden S3-Bucket hoch.
Notieren Sie sich die S3-URI einschließlich der vom Upload
versionIdzurückgegebenen.Fügen Sie die Datei als
documentInhaltsblock in IhrensendMessageAnruf ein.
Beispiel für ein S3-URI-Format:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Fehlercodes
| Code | Name | Description |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
Die SigV4-Signatur ist ungültig oder die Anmeldeinformationen sind abgelaufen |
-31004 |
TOOL_PERMISSION_DENIED |
Der IAM-Identität fehlt die für diesen partnercentral: Vorgang erforderliche Aktion |
-32002 |
ACCESS_DENIED |
Allgemeiner Zugriff verweigert (Konto nicht registriert, Region stimmt nicht überein usw.) |
-32004 |
LIMIT_EXCEEDED |
Ratenlimit oder Kontingent überschritten. Versuchen Sie es erneut mit exponentiellem Backoff. |
-30001 |
RESOURCE_NOT_FOUND |
Die angeforderte Ressource (Sitzung, Gelegenheit usw.) ist nicht vorhanden |
-32600 |
INVALID_REQUEST |
Falsch formatierte JSON-RPC Anfrage oder ungültige Parameter |
-32603 |
INTERNAL_ERROR |
Server-side Fehler. Wiederholen Sie die Anforderung. |
Ratenbegrenzungen
Der Server setzt Gebührenbeschränkungen pro Konto durch:
| Operation | Anhaltender Tarif | Burst |
|---|---|---|
sendMessage |
2 Anfragen pro Minute | 10 |
| Alle anderen Vorgänge | 10 Anfragen pro Minute | 20 |
Wenn Sie diese Grenzwerte überschreiten, gibt der Server den Fehlercode -32004 (LIMIT_EXCEEDED) zurück. Implementieren Sie exponentielles Backoff mit Jitter in Ihrem Client, um die Ratenbegrenzung ordnungsgemäß zu handhaben.
Streaming-Ereignistypen (SSE)
Wenn true in einem sendMessage Aufruf auf gesetzt stream ist, gibt der Server Server-Sent Ereignisse mit den folgenden Ereignistypen zurück:
| Ereignistyp | Description |
|---|---|
stream_start |
Die Stream-Verbindung wurde hergestellt |
assistant-response.start |
Der Agent hat begonnen, eine Antwort zu generieren |
assistant-response.delta |
Inkrementeller Textteil der Antwort des Agenten |
assistant-response.completed |
Der Agent hat die Generierung der Antwort abgeschlossen |
server-tool-use |
Der Agent ruft ein internes Tool auf (Lesevorgang) |
server-tool-response |
Ergebnis eines internen Toolaufrufs |
tool_approval_request |
Der Agent fordert eine menschliche Genehmigung für einen Schreibvorgang an |
stream_end |
Die Stream-Verbindung wird geschlossen |
done |
Letztes Ereignis, das angibt, dass der SSE-Stream abgeschlossen ist |
Nächste Schritte
Werkzeugreferenz — Detaillierte Dokumentation für
sendMessageundgetSessionTools
