L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Partner Central API Reference.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Informazioni di riferimento sulla configurazione
Questa pagina fornisce il riferimento completo per la connessione e la configurazione del server MCP Partner Central Agent.
Endpoint
| Proprietà | Valore |
|---|---|
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| Region | us-east-1(Virginia settentrionale) solo |
| Protocollo | JSON-RPC 2.0 su HTTPS |
| Streaming | Server-Sent Eventi (SSE) |
| Autenticazione | AWS Signature (versione 4) |
| Nome del servizio SigV4 | partnercentral-agents-mcp |
| Requisito TLS | TLS 1.2 o versioni successive |
autorizzazioni IAM
Tutte le azioni IAM utilizzano il partnercentral: prefisso se non diversamente specificato.
Accesso al protocollo MCP
Il modo più semplice per concedere l'accesso al protocollo MCP consiste nell'associare la policy AWSMcpServiceActionsFullAccess gestita alla tua identità IAM. Questa policy include tutte le autorizzazioni necessarie per interagire con il server MCP. Per un controllo granulare, puoi utilizzare la chiave aws:IsMcpServiceAction condition nelle tue policy IAM per definire le autorizzazioni in modo specifico per le azioni del servizio MCP.
| Azione | Description |
|---|---|
partnercentral:UseSession |
Crea, aggiorna e recupera sessioni di conversazione |
Gestione delle opportunità
| Azione | Description |
|---|---|
partnercentral:List* |
Elenca opportunità, soluzioni e altre risorse di Partner Central |
partnercentral:Get* |
Recupera i dettagli per opportunità individuali e altre risorse |
partnercentral:CreateOpportunity |
Crea un'opportunità |
partnercentral:UpdateOpportunity |
Modifica i campi delle opportunità (fase, data di chiusura, entrate, ecc.) |
partnercentral:SubmitOpportunity |
Invia un'opportunità di AWS revisione |
partnercentral:AssignOpportunity |
Assegna un'opportunità a un rappresentante partner |
partnercentral:AssociateOpportunity |
Collega un'opportunità a un'altra risorsa (soluzione, ecc.) |
partnercentral:DisassociateOpportunity |
Rimuovi un collegamento tra un'opportunità e un'altra risorsa |
partnercentral:StartEngagementFromOpportunityTask |
Invia opportunità per avviare un coinvolgimento partendo da un'opportunità |
Programmi di finanziamento
| Azione | Description |
|---|---|
partnercentral:ListBenefitAllocations |
Elenca le allocazioni di benefit disponibili per il tuo account |
partnercentral:ListBenefitApplications |
Elenca le domande di benefit presentate |
partnercentral:CreateBenefitApplication |
Crea una nuova richiesta di benefit (MAP, POC, WMP) |
partnercentral:GetBenefitApplication |
Recupera i dettagli di una specifica richiesta di benefit |
partnercentral:UpdateBenefitApplication |
Aggiorna una richiesta di benefit in sospeso |
partnercentral:AssociateBenefitApplicationResource |
Collega una risorsa a una richiesta di benefit |
partnercentral:DisassociateBenefitApplicationResource |
Rimuovere un collegamento a una risorsa da una domanda di benefit |
Accesso al Marketplace
| Azione | Description |
|---|---|
aws-marketplace:DescribeEntity |
Recupera i dettagli di un'entità del marketplace |
aws-marketplace:SearchAgreements |
Cerca gli accordi del marketplace |
aws-marketplace:ListEntities |
Elenca le entità del marketplace |
Agente di onboarding
Gestione degli account partner ()partnercentral:
| Azione | Description |
|---|---|
partnercentral:ListPartners |
Elenca le registrazioni dei partner per l'account |
partnercentral:GetPartner |
Recupera la registrazione del partner e i dettagli del profilo |
partnercentral:GetProfileVisibility |
Recupera la visibilità attuale del profilo () PUBLIC/PRIVATE |
partnercentral:GetAllianceLeadContact |
Recupera le informazioni di contatto del leader dell'alleanza |
partnercentral:GetProfileUpdateTask |
Controlla lo stato di un aggiornamento asincrono in sospeso del profilo |
partnercentral:StartProfileUpdateTask |
Invia un aggiornamento del profilo partner (asincrono) |
partnercentral:CancelProfileUpdateTask |
Annulla un'attività di aggiornamento del profilo in sospeso |
partnercentral:PutProfileVisibility |
Cambia la visibilità del profilo in PUBBLICA o PRIVATA |
partnercentral:PutAllianceLeadContact |
Aggiorna il contatto principale dell'alleanza (nome, titolo, email) |
partnercentral:SendEmailVerificationCode |
Invia un codice di verifica per le modifiche via e-mail domain/contact |
partnercentral:AssociateAwsTrainingCertificationEmailDomain |
Collega un dominio e-mail per il monitoraggio delle certificazioni di formazione |
partnercentral:DisassociateAwsTrainingCertificationEmailDomain |
Rimuovi un dominio e-mail di certificazione della formazione collegato |
partnercentral:GetAccountConnections |
Elenca le connessioni attive all'account (ad esempio, link sussidiari) |
partnercentral:GetConnectionInvitations |
Elenca gli inviti di connessione inviati e ricevuti in sospeso |
partnercentral:CreateConnectionInvitation |
Invia un invito alla connessione a un altro account AWS |
partnercentral:CancelConnectionInvitation |
Annullare un invito alla connessione in uscita in sospeso |
partnercentral:RespondConnectionInvitation |
Accetta o rifiuta un invito alla connessione in arrivo |
partnercentral:CancelConnection |
Annullare una connessione attiva all'account |
partnercentral:ManageConnectionPreferences |
Ottieni o aggiorna le preferenze di condivisione tra account connessi |
Configurazione venditore Marketplace (aws-marketplace):
| Azione | Description |
|---|---|
aws-marketplace:ListEntities |
Elenca le entità del Marketplace (ad es. entità venditrici) |
aws-marketplace:DescribeEntity |
Recupera i dettagli completi di un'entità Marketplace |
aws-marketplace:DescribeChangeSet |
Verifica lo stato di un set di modifiche inviato |
aws-marketplace:StartChangeSet |
Invia un set di modifiche al Marketplace (ad esempio, aggiornamento del profilo venditore) |
IAM — ruolo collegato al servizio ()iam:
| Azione | Description |
|---|---|
iam:GetRole |
Verifica se esiste il ruolo collegato al servizio Marketplace Resale Authorization |
iam:CreateServiceLinkedRole |
Crea il ruolo AWSServiceRoleForMarketplaceResaleAuthorization |
Ambienti di catalogo
| Catalogo | Description |
|---|---|
"AWS" |
Ambiente di produzione. Tutte le operazioni influiscono sui dati in tempo reale dei partner. |
"Sandbox" |
Ambiente di test isolato. Nessun impatto sui dati di produzione. Utilizzo per lo sviluppo e la convalida. |
Gestione della sessione
| Proprietà | Valore |
|---|---|
| Formato dell'ID della sessione | UUID v4 con session- prefisso (ad esempio,) session-550e8400-e29b-41d4-a716-446655440000 |
| Creazione di sessioni | Automatico alla prima sendMessage chiamata senza sessionId |
| Scadenza della sessione | 48 ore dalla creazione della sessione (scadenza assoluta, non basata sull'inattività) |
Caricamento di un file
| Proprietà | Valore |
|---|---|
| Numero massimo di file per messaggio | 3 |
| Limite di dimensione dell'immagine | 3,75 MB |
| Limite delle dimensioni del documento | 4,5 MB |
| Estensioni consentite | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| Bucket S3 (produzione) | file aws-partner-central-marketplace-ephemeral-writeonly-files |
| Percorso di caricamento | s3://{bucket}/{aws-account-id}/ |
| Requisito URI S3 | Deve includere il parametro di versionId interrogazione |
Workflow di caricamento
Carica il file nel bucket S3 appropriato con il prefisso AWS dell'ID dell'account.
Annota l'URI S3, incluso quello
versionIdrestituito dal caricamento.Includi il file come blocco di
documentcontenuto nellasendMessagechiamata.
Esempio di formato URI S3:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
Codici di errore
| Codice | Nome | Description |
|---|---|---|
-32001 |
AUTHENTICATION_FAILURE |
La firma SigV4 non è valida o le credenziali sono scadute |
-31004 |
TOOL_PERMISSION_DENIED |
L'identità IAM non dispone dell'azione richiesta per questa operazione partnercentral: |
-32002 |
ACCESS_DENIED |
Accesso generale negato (account non registrato, regione non corrispondente, ecc.) |
-32004 |
LIMIT_EXCEEDED |
Limite di tariffa o quota superati. Riprova con backoff esponenziale. |
-30001 |
RESOURCE_NOT_FOUND |
La risorsa richiesta (sessione, opportunità, ecc.) non esiste |
-32600 |
INVALID_REQUEST |
JSON-RPC Richiesta non valida o parametri non validi |
-32603 |
INTERNAL_ERROR |
Server-side errore. Riprova la richiesta . |
Limiti di frequenza
Il server impone limiti di tariffa per account:
| Operation | Tasso sostenuto | Scoppio |
|---|---|---|
sendMessage |
2 richieste al minuto | 10 |
| Tutte le altre operazioni | 10 richieste al minuto | 20 |
Se superi questi limiti, il server restituisce il codice di errore -32004 (LIMIT_EXCEEDED). Implementa il backoff esponenziale con jitter nel tuo client per gestire con garbo la limitazione della velocità.
Tipi di eventi Streaming (SSE)
Quando stream è impostato su true In una sendMessage chiamata, il server restituisce Server-Sent Events con questi tipi di eventi:
| Tipo di evento | Description |
|---|---|
stream_start |
Connessione di streaming stabilita |
assistant-response.start |
L'agente ha iniziato a generare una risposta |
assistant-response.delta |
Parte di testo incrementale della risposta dell'agente |
assistant-response.completed |
L'agente ha terminato la generazione della risposta |
server-tool-use |
L'agente sta richiamando uno strumento interno (operazione di lettura) |
server-tool-response |
Risultato della chiamata di uno strumento interno |
tool_approval_request |
L'agente richiede l'approvazione umana per un'operazione di scrittura |
stream_end |
Chiusura della connessione Stream |
done |
Evento finale che indica che il flusso SSE è completo |
Fasi successive
Guida agli strumenti: documentazione
sendMessageegetSessionstrumenti dettagliati