Utilizzo di Marketplace AWS API dell'accordo

Marketplace AWS è un catalogo digitale curato che i clienti possono utilizzare per trovare, acquistare, distribuire e gestire software, dati e servizi di terze parti per creare soluzioni e gestire le proprie attività. L' Marketplace AWS Agreement Service fornisce un'interfaccia API che aiuta Marketplace AWS acquirenti e venditori a gestire i propri contratti, tra cui la pubblicazione, la ricerca e il filtraggio degli accordi.

Concetti chiave

La tabella seguente descrive i concetti chiave utilizzati nell'API Marketplace AWS Agreement.

Concetto	Description
Accettatore	La parte che accetta la totalità o una parte dei termini estesi dal proponente in un accordo. Nei casi d'uso più comuni, gli accettatori sono gli acquirenti del prodotto.
Contratto	Un documento che vincola due parti, tra cui il proponente (di solito, il seller/ISV partner di canale) e l'accettante (in genere, l'acquirente) e definisce i termini e le condizioni applicabili tra di loro.
Richiesta di annullamento del contratto	Una richiesta avviata dal venditore (proponente) per annullare un contratto attivo. L'acquirente (accettatore) può accettare o rifiutare la richiesta di annullamento. Se accettato, il flusso di lavoro di annullamento dell'accordo viene eseguito in modo asincrono e lo stato dell'accordo diventa annullato. Se rifiutato, l'accordo rimane attivo e il venditore può inviare una nuova richiesta di annullamento.
Proposta di accordo	Entità che si riferisce all'insieme di terms/offer proposte da seller/proposer.
Richiesta di accordo	Entità che si riferisce alla risorsa creata a seguito dell'azione del cliente, che delinea creation/modification i parametri del contratto, il ciclo di vita della richiesta e il risultato stimato al momento dell'accettazione della richiesta.
Dimensione fatturabile	Elementi relativi al prezzo del prodotto. Ad esempio, le istanze Amazon Elastic Compute Cloud (Amazon EC2) per i prodotti Amazon Machine Image (AMI) o quelle premium rispetto agli utenti di sola lettura per i prodotti Software as a Service (SaaS).
Partner di canale (CP)	Organizzazioni autorizzate dal proprietario del prodotto (ISV) a rivendere i propri prodotti per loro conto su. Marketplace AWS
Fornitori di software indipendenti (ISV)	Venditori che pubblicano e gestiscono i propri prodotti in. Marketplace AWS
Intento	L'intento rappresenta la motivazione dell'acquirente durante la creazione del Contratto. Gli intenti attualmente supportati sono Nuovo, Modifica e Sostituisci durante il flusso di creazione dell'accordo.
Richiesta di pagamento	Una richiesta di pagamento avviata dal venditore (proponente) associata a un contratto. L'acquirente (accettatore) può accettare o rifiutare la richiesta di pagamento.
Proponente	La parte che estende la serie iniziale di termini di un accordo, in genere utilizzando un'offerta.
Ordini di acquisto	Le organizzazioni richiedono agli acquirenti di utilizzare gli ordini di acquisto per acquistare da fornitori approvati, tenere traccia di ciò che acquistano e garantire che la spesa sia prevista, preventivata, approvata e assegnata ai centri di costo responsabili.
Risorsa	Unità o risorsa in cui i venditori intendono vendere Marketplace AWS, spesso denominata prodotto di base. Un prodotto di base non è completo per il consumo da parte dell'acquirente finché non vengono aggiunte le informazioni sul prodotto, gli attributi di distribuzione e le informazioni di fatturazione. Un prodotto descrive le informazioni sul prodotto, gli attributi di distribuzione del software e il meccanismo di fatturazione dell'inserzione che un venditore intende vendere. Il prodotto deve essere abbinato a un'offerta per diventare un'unità negoziabile che possa essere venduta e utilizzata dagli acquirenti in. Marketplace AWS
Termine	Un'unità all'interno di un accordo che regola il modo in cui un accordo viene applicato (ad esempio, la determinazione dei prezzi).

Endpoint

È possibile accedere al servizio Marketplace AWS Agreement con i seguenti endpoint:

Endpoint	Region	Protocolli IP supportati
`agreement-marketplace.us-east-1.api.aws`	Stati Uniti orientali (Virginia settentrionale)	IPv4, IPv6

Permissions

L'API Agreements utilizza l'autenticazione AWS Signature Version 4 (SIGv4) standard. È necessario disporre di AWS credenziali valide e delle autorizzazioni IAM appropriate per chiamare l'API. Per informazioni dettagliate, vedi Controllo degli accessi per Marketplace AWS API Agreement.

Codici di errore

I seguenti codici di errore si applicano alle azioni di Marketplace AWS Agreement Service. È possibile restituire un singolo codice di errore per più casi d'uso. Fai riferimento alle descrizioni seguenti per identificare lo scenario specifico in cui si verifica ogni codice di errore. Questo elenco non è esaustivo e può essere aggiornato man mano che vengono rilasciate nuove funzionalità.

ValidationException

Codice di errore	Description
`INVALID_SOURCE_AGREEMENT_IDENTIFIER`	Restituito quando l'identificatore del contratto di origine non corrisponde al formato previsto o quando viene fornito un identificatore dell'accordo di origine per un intento che non lo richiede (ad esempio NEW).
`MISSING_SOURCE_AGREEMENT_IDENTIFIER`	Restituito quando l'identificatore dell'accordo di origine non viene fornito per un intento che ne richiede uno (ad esempio REPLACE o AMEND).
`INVALID_REQUESTED_TERM_CONFIGURATION`	Restituito quando la configurazione del termine richiesta non è valida. Scenari possibili: Viene fornita una configurazione per un termine che non ne accetta una. Manca una configurazione richiesta. Il valore del selettore non appartiene alla proposta di accordo. Le dimensioni possono contenere solo una dimensione quando non è consentita la selezione di più dimensioni. Una chiave di dimensione non è riconosciuta nella proposta di accordo o nei termini accettati. Il valore di una dimensione può essere 1 solo quando la configurazione della quantità non è abilitata per la dimensione. La configurazione contiene chiavi di dimensione duplicate. La configurazione non differisce dal contratto di origine.
`INVALID_AGREEMENT_PROPOSAL_IDENTIFIER`	Restituito quando l'identificatore della proposta di accordo non corrisponde al formato previsto o quando viene fornito un identificatore della proposta di accordo per un intento che non lo richiede (come AMEND).
`MISSING_AGREEMENT_PROPOSAL_IDENTIFIER`	Restituito quando l'identificatore della proposta di accordo non viene fornito per un intento che ne richiede uno (ad esempio NEW o REPLACE).
`INVALID_FILTER_NAME`	Restituito quando il nome del filtro fornito non è un filtro riconosciuto o quando nella richiesta sono inclusi nomi di filtro duplicati.
`INVALID_FILTER_VALUES`	Restituito quando i valori del filtro non sono validi, duplicati, vuoti, superano il conteggio massimo consentito o quando un filtro per intervallo di date specifica un `BeforeEndTime` valore che precede il valore. `AfterEndTime`
`INVALID_NEXT_TOKEN`	Restituito quando il token di paginazione non è valido, è scaduto, non può essere decrittografato o quando i parametri della richiesta sono cambiati tra chiamate impaginate.
`DUPLICATE_CHARGES`	Restituito quando la richiesta contiene identificatori di addebito duplicati o quando vengono forniti valori dell'ordine di acquisto diversi per lo stesso identificatore di addebito.
`UNSUPPORTED_FILTERS`	Restituito quando la combinazione di filtri fornita non è supportata. Le combinazioni di filtri supportate variano in base al tipo di parte. Controlla le combinazioni supportate nella documentazione pubblica.
`INVALID_PURCHASE_ORDER_REFERENCE`	Restituito quando il riferimento all'ordine di acquisto non soddisfa i requisiti di formato o quando un ordine di acquisto richiesto non viene fornito come configurato dall'amministratore dell'account.
`INVALID_CHARGE_AMOUNT`	Restituito quando l'importo dell'addebito non è valido. Scenari possibili: L'importo dell'addebito supera l'importo massimo totale dell'addebito per il periodo. Il formato dell'importo dell'addebito non corrisponde ai requisiti di valuta (ad esempio, troppe cifre decimali). Non è disponibile alcun importo residuo perché il contratto ha raggiunto l'importo massimo totale dell'addebito.
`UNSUPPORTED_ACTION`	Restituito quando l'operazione richiesta non è supportata per lo stato corrente della risorsa. Gli scenari specifici variano in base all'API: `UpdatePurchaseOrders`— La data di addebito è passata e il rinnovo automatico è disabilitato, la data di addebito è compresa tra 3 ore, l'addebito è un addebito di rimborso, la revisione dell'addebito non è l'ultima, gli ordini di acquisto non appartengono tutti allo stesso contratto o l'accordo non è attivo. `CreateAgreementRequest`— La modifica di un accordo con data futura non è supportata, la combinazione del tipo di risorsa e del tipo di termine non supporta l'intento richiesto, la sostituzione di un accordo attivo con un accordo con data futura non è consentita, la durata dell'accordo non può essere modificata durante la modifica, l'accordo non può essere aggiornato in questo momento (ad esempio, esistono diritti in sospeso), la proposta di accordo deve fare riferimento alla stessa risorsa dell'accordo di origine, la proposta di accordo deve essere diversa dall'accordo di origine oppure il tipo di accordo non supporta questa azione. `AcceptAgreementRequest`— La combinazione del tipo di risorsa e del tipo di termine non supporta questa azione, il tipo di accordo non supporta questa azione, esiste già un accordo attivo sulla stessa risorsa oppure l'accordo non può essere aggiornato in questo momento. `CancelAgreement`— L'accordo ha diritti in sospeso, il tipo di accordo non supporta l'annullamento, un accordo non `UsageBasedPricingTerm` può essere annullato mentre un accordo con `ConfigurableUpfrontPricingTerm` o `PaymentScheduleTerm` è ancora attivo sulla stessa risorsa oppure la combinazione di tipo di risorsa e tipo di termine non supporta l'annullamento. `GetBillingAdjustmentRequest`— Il contratto è un tipo di contratto diverso dall'acquisto oppure il chiamante è l'accettatore del contratto. `SendAgreementCancellationRequest`— Il tipo di accordo non supporta questa azione. `AcceptAgreementCancellationRequest`— Il tipo di accordo non supporta questa azione. `RejectAgreementCancellationRequest`— Il tipo di accordo non supporta questa azione. `CancelAgreementCancellationRequest`— Il tipo di accordo non supporta questa azione. `GetAgreementCancellationRequest`— Il contratto è un tipo di contratto non di acquisto.

ResourceNotFoundException

Le ResourceNotFoundException resourceType inclusioni e resourceId i campi che identificano la risorsa che non è stata trovata. La tabella seguente descrive gli scenari che possono causare questa eccezione per ogni tipo di risorsa.

Nota

Per motivi di sicurezza, viene restituito lo stesso errore se una risorsa non esiste o se il chiamante non vi ha accesso. Ciò impedisce l'enumerazione di identificatori di risorse validi.

Tipo di risorsa	Scenari possibili
`AgreementProposal`	Nessuna proposta di accordo trovata per l'identificatore specificato. L'offerta non è rivolta all'accettante. L'offerta non è disponibile nel paese dell'accettante.
`Agreement`	Non è stato trovato alcun accordo per l'identificatore specificato. Il chiamante non è né l'accettatore né il proponente dell'accordo.
`AgreementRequest`	Nessuna richiesta di accordo trovata per l'identificatore specificato. La richiesta di accordo appartiene a un altro chiamante. La richiesta di accordo è scaduta. La richiesta di accordo è stata sostituita da una successiva richiesta accettata sullo stesso prodotto o offerta. La proposta di accordo è diventata inattiva tra le due `CreateAgreementRequest` `AcceptAgreementRequest` chiamate a causa della ripubblicazione dell'offerta o della scadenza dell'offerta.
`Charge`	Nessun addebito trovato per l'identificatore fornito. L'addebito non rientra nell'accordo specificato.
`BillingAdjustmentRequest`	Nessuna richiesta di rettifica della fatturazione trovata per l'identificatore specificato. Il chiamante non è né l'accettatore né il proponente dell'accordo associato all'adeguamento.
`AgreementCancellationRequest`	Non è stata trovata alcuna richiesta di annullamento del contratto per l'identificatore specificato. Il chiamante non è né l'accettatore né il proponente dell'accordo associato alla richiesta di annullamento.
`PaymentRequest`	Nessuna richiesta di pagamento trovata per l'identificatore specificato. Il chiamante non è né l'accettatore né il proponente dell'accordo associato alla richiesta di pagamento.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Utilizzo dell'API Catalog

Utilizzo dell'API di misurazione