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 Signatur, Version 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
Die einfachste Methode, Zugriff auf das MCP-Protokoll zu gewähren, besteht darin, die AWSMcpServiceActionsFullAccess verwaltete Richtlinie an Ihre IAM-Identität anzuhängen. Diese Richtlinie umfasst alle Berechtigungen, die für die Interaktion mit dem MCP-Server erforderlich sind. Für eine detaillierte Steuerung können Sie den aws:IsMcpServiceAction Bedingungsschlüssel in Ihren IAM-Richtlinien verwenden, um Berechtigungen speziell für MCP-Serviceaktionen einzuschränken.
| Action | Description |
|---|---|
partnercentral:UseSession |
Konversationssitzungen erstellen, aktualisieren und abrufen |
Verwaltung von Geschäftschancen
| Action | Description |
|---|---|
partnercentral:List* |
Nennen Sie Möglichkeiten, Lösungen und andere Ressourcen von Partner Central |
partnercentral:Get* |
Rufen Sie Details zu einzelnen Geschäftschancen und anderen Ressourcen ab |
partnercentral:CreateOpportunity |
Schaffen Sie eine Geschäftschance |
partnercentral:UpdateOpportunity |
Ändern Sie die Opportunity-Felder (Phase, Abschlussdatum, Umsatz usw.) |
partnercentral:SubmitOpportunity |
Reichen Sie eine Opportunity zur AWSÜberprüfung ein |
partnercentral:AssignOpportunity |
Weisen Sie einem Vertreter eines Partners eine Verkaufschance zu |
partnercentral:AssociateOpportunity |
Verknüpfen Sie eine Opportunity mit einer anderen Ressource (Lösung usw.) |
partnercentral:DisassociateOpportunity |
Entfernen Sie eine Verknüpfung zwischen einer Opportunity und einer anderen Ressource |
partnercentral:StartEngagementFromOpportunityTask |
Reichen Sie Möglichkeiten ein, um ein Engagement von einer Verkaufschance aus zu starten |
Förderprogramme
| Action | Description |
|---|---|
partnercentral:ListBenefitAllocations |
Führen Sie die verfügbaren Leistungszuweisungen für Ihr Konto auf |
partnercentral:ListBenefitApplications |
Führen Sie die eingereichten Leistungsanträge auf |
partnercentral:CreateBenefitApplication |
Erstellen Sie einen neuen Leistungsantrag (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Rufen Sie Details zu einem bestimmten Leistungsantrag ab |
partnercentral:UpdateBenefitApplication |
Aktualisieren Sie einen ausstehenden Leistungsantrag |
partnercentral:AssociateBenefitApplicationResource |
Verknüpfen Sie eine Ressource mit einem Leistungsantrag |
partnercentral:DisassociateBenefitApplicationResource |
Entfernen Sie einen Ressourcenlink aus einem Leistungsantrag |
Zugang zum Marketplace
| Action | Description |
|---|---|
aws-marketplace:DescribeEntity |
Rufen Sie Details einer Marketplace-Entität ab |
aws-marketplace:SearchAgreements |
Suchen Sie nach Marktplatz-Vereinbarungen |
aws-marketplace:ListEntities |
Marktplatz-Entitäten auflisten |
Onboarding-Agent
Verwaltung von Partnerkonten (partnercentral):
| Action | Description |
|---|---|
partnercentral:ListPartners |
Partnerregistrierungen für das Konto auflisten |
partnercentral:GetPartner |
Rufen Sie die Partnerregistrierungs- und Profildetails ab |
partnercentral:GetProfileVisibility |
Rufen Sie die aktuelle Profilsichtbarkeit ab (PUBLIC/PRIVATE) |
partnercentral:GetAllianceLeadContact |
Rufen Sie 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 |
Aktualisieren Sie den Hauptkontakt der Allianz (Name, Titel, E-Mail) |
partnercentral:SendEmailVerificationCode |
Senden Sie einen Bestätigungscode für E-Mail-basierte Änderungen domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Verknüpfen Sie eine E-Mail-Domain für die Nachverfolgung von Schulungszertifikaten |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Entfernen Sie eine verknüpfte E-Mail-Domain für Schulungszertifikate |
partnercentral:GetAccountConnections |
Listet aktive Kontoverbindungen auf (z. B. Links zu Tochterunternehmen) |
partnercentral:GetConnectionInvitations |
Führt ausstehende gesendete und empfangene Verbindungseinladungen auf |
partnercentral:CreateConnectionInvitation |
Senden Sie eine Verbindungseinladung an ein anderes AWS Konto |
partnercentral:CancelConnectionInvitation |
Stornieren Sie eine ausstehende Einladung zu einer ausgehenden Verbindung |
partnercentral:RespondConnectionInvitation |
Nehmen Sie eine eingehende Verbindungseinladung an oder lehnen Sie sie ab |
partnercentral:CancelConnection |
Kündigen Sie eine aktive Kontoverbindung |
partnercentral:ManageConnectionPreferences |
Ruft die Einstellungen für die gemeinsame Nutzung zwischen verbundenen Konten ab oder aktualisiert sie |
Einrichtung des Marketplace-Verkäufers (aws-marketplace):
| Action | Description |
|---|---|
aws-marketplace:ListEntities |
Marketplace-Entitäten auflisten (z. B. Verkäuferentitäten) |
aws-marketplace:DescribeEntity |
Vollständige Details einer Marketplace-Entität abrufen |
aws-marketplace:DescribeChangeSet |
Überprüfen Sie den Status eines eingereichten Änderungssatzes |
aws-marketplace:StartChangeSet |
Einen Marketplace-Änderungssatz einreichen (z. B. Aktualisierung des Verkäuferprofils) |
IAM — serviceverknüpfte Rolle ()iam:
| Action | Description |
|---|---|
iam:GetRole |
Prüfen Sie, ob die mit dem Service verknüpfte Rolle Marketplace Resale Authorization existiert |
iam:CreateServiceLinkedRole |
Erstellen Sie die Rolle AWSServiceRoleForMarketplaceResaleAuthorization |
Katalogumgebungen
| Katalog | Description |
|---|---|
"AWS" |
Produktionsumgebung. Alle Operationen wirken sich auf Live-Partnerdaten aus. |
"Sandbox" |
Isolierte Testumgebung. Keine Auswirkungen auf die Produktionsdaten. Für die Entwicklung und Validierung verwenden. |
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 nach der Erstellung der Sitzung (absoluter Ablauf, nicht aufgrund von Inaktivität) |
Datei-Upload
| Eigenschaft | Wert |
|---|---|
| Max. Anzahl an Dateien pro Nachricht | 3 |
| Größenbeschränkung für Bilder | 3,75 MB |
| Begrenzung der Dokumentgröße | 4,5 MB |
| Zulässige Erweiterungen | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| S3-Bucket (Produktion) | aws-partner-central-marketplace-ephemeral-writeonly-Dateien |
| Pfad hochladen | s3://{bucket}/{aws-account-id}/ |
| S3-URI-Anforderung | Muss einen 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.Nehmen Sie die Datei als
documentInhaltsblock in IhrensendMessageAnruf auf.
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 |
Die IAM-Identität verfügt nicht über die erforderliche partnercentral: Aktion für diesen Vorgang |
-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 |
Fehlerhafte JSON-RPC Anfrage oder ungültige Parameter |
-32603 |
INTERNAL_ERROR |
Server-side Fehler. Wiederholen Sie die Anforderung. |
Ratenbegrenzungen
Der Server erzwingt Ratenbegrenzungen pro Konto:
| Operation | Kontinuierliche Rate | 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 problemlos zu handhaben.
Streaming-Ereignistypen (SSE)
Wenn true bei einem sendMessage Anruf auf gesetzt stream ist, gibt der Server Server-Sent Ereignisse mit den folgenden Ereignistypen zurück:
| Ereignistyp | Description |
|---|---|
stream_start |
Stream-Verbindung hergestellt |
assistant-response.start |
Der Agent hat mit der Generierung einer Antwort begonnen |
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 Tool-Aufrufs |
tool_approval_request |
Der Agent bittet um die Genehmigung eines menschlichen Benutzers für einen Schreibvorgang |
stream_end |
Stream-Verbindung wird geschlossen |
done |
Letztes Ereignis, das anzeigt, dass der SSE-Stream abgeschlossen ist |
Nächste Schritte
Tool-Referenz — Detaillierte Dokumentation für
sendMessageundgetSessionTools