Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
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à.
# Esempi di codice per l'utilizzo dell'API Marketplace AWS Catalog AWS SDKs
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con un kit di sviluppo AWS software (SDK).
**Altre risorse**
+ **[Marketplace AWS Guida al venditore di Catalog API](https://docs.aws.amazon.com/marketplace/latest/userguide/what-is-marketplace.html)**: ulteriori informazioni su Marketplace AWS Catalog API.
+ **[Marketplace AWS Riferimento all'API del catalogo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html)**: dettagli su tutte le azioni disponibili dell'API Marketplace AWS del catalogo.
+ **[AWS Developer Center](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)**: esempi di codice che puoi filtrare per categoria o per ricerca completa.
+ **[AWS Esempi SDK](https://github.com/awsdocs/aws-doc-sdk-examples)**: GitHub repository con codice completo nelle lingue preferite. Include le istruzioni su come configurare ed eseguire il codice.
**Contents**
+ [Prodotti AMI](marketplace-catalog_code_examples_ami_products.md)
+ [Aggiungere una dimensione a un prodotto AMI esistente e aggiornare i termini e i prezzi dell’offerta](marketplace-catalog_example_marketplace-catalog_AddDimensionToAmiProductAndSetPriceInPublicOffer_section.md)
+ [Aggiungere una Regione in cui viene implementato un prodotto AMI](marketplace-catalog_example_marketplace-catalog_AddRegionExistingAmiProduct_section.md)
+ [Creare un prodotto AMI pubblico o limitato e un’offerta pubblica con tariffe orarie annuali](marketplace-catalog_example_marketplace-catalog_CreateLimitedAmiProductAndPublicOfferWithHourlyAnnualPricing_section.md)
+ [Creare un prodotto AMI pubblico o limitato e un’offerta pubblica con tariffe orarie mensili](marketplace-catalog_example_marketplace-catalog_CreateLimitedAmiProductAndPublicOfferWithHourlyMonthlyPricing_section.md)
+ [Creare un prodotto AMI pubblico o limitato e un’offerta pubblica con tariffe orarie](marketplace-catalog_example_marketplace-catalog_CreateLimitedAmiProductAndPublicOfferWithHourlyPricing_section.md)
+ [Creare una bozza di prodotto AMI con una bozza di offerta pubblica](marketplace-catalog_example_marketplace-catalog_CreateDraftAmiProductWithDraftPublicOffer_section.md)
+ [Limitare una Regione in cui un prodotto AMI viene distribuito](marketplace-catalog_example_marketplace-catalog_RestrictRegionExistingAmiProduct_section.md)
+ [Limitare la visibilità del prodotto](marketplace-catalog_example_marketplace-catalog_RestrictExistingAmi_section.md)
+ [Specificare se gli asset AMI vengono distribuiti in nuove Regioni](marketplace-catalog_example_marketplace-catalog_UpdateFutureRegionSupport_section.md)
+ [Offerte dei partner di canale](marketplace-catalog_code_examples_channel_partner_offers.md)
+ [Creare una bozza di offerta CPPO per qualsiasi tipo di prodotto](marketplace-catalog_example_marketplace-catalog_CreateDraftCppoOffer_section.md)
+ [Creare un’offerta privata di sostituzione dell’autorizzazione di rivendita e tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateResaleAuthorizationReplacementOffer_section.md)
+ [Elenca tutto ciò che CPPOs è stato creato da un partner di canale](marketplace-catalog_example_marketplace-catalog_ListAllCppoOffers_section.md)
+ [Elencare tutte le autorizzazioni di rivendita condivise disponibili per un partner di canale](marketplace-catalog_example_marketplace-catalog_ListAllSharedResaleAuthorizations_section.md)
+ [Pubblicare un’offerta CPPO e aggiungere un’EULA per l’acquirente](marketplace-catalog_example_marketplace-catalog_PublishCppoEula_section.md)
+ [Pubblicare un’offerta CPPO utilizzando l’autorizzazione di rivendita una tantum e aggiornare il markup dei prezzi](marketplace-catalog_example_marketplace-catalog_PublishOneTimeCppoWithPriceMarkup_section.md)
+ [Pubblicare una bozza di offerta CPPO e aggiornare il markup dei prezzi](marketplace-catalog_example_marketplace-catalog_PublishCppoPriceMarkup_section.md)
+ [Aggiornare la data di scadenza di un’offerta CPPO](marketplace-catalog_example_marketplace-catalog_UpdateCppoExpiryDate_section.md)
+ [Prodotti container](marketplace-catalog_code_examples_container_products.md)
+ [Creare una bozza di prodotto container con una bozza di offerta pubblica](marketplace-catalog_example_marketplace-catalog_CreateDraftContainerProductWithDraftPublicOffer_section.md)
+ [Creare un prodotto container limitato con offerta pubblica e tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateLimitedContainerProductPublicOffer_section.md)
+ [Entità](marketplace-catalog_code_examples_entities.md)
+ [Descrivere tutte le entità in un’unica chiamata](marketplace-catalog_example_marketplace-catalog_BatchDescribeEntities_section.md)
+ [Elencare e descrivere tutte le offerte associate a un prodotto](marketplace-catalog_example_marketplace-catalog_ListProductOffers_section.md)
+ [Offers (Offerte)](marketplace-catalog_code_examples_offers.md)
+ [Creare una dimensione personalizzata per un prodotto SaaS e creare un’offerta privata](marketplace-catalog_example_marketplace-catalog_CreateSaasProductCustomDimensionAndPrivateOffer_section.md)
+ [Creare una bozza di offerta privata per un prodotto AMI o SaaS](marketplace-catalog_example_marketplace-catalog_CreateDraftPrivateOffer_section.md)
+ [Crea un'offerta privata con contratto e Pay-As-You-Go prezzi per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractWithPayAsYouGoPricingForSaasProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali e un piano di pagamento flessibile per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractPricingWithFlexiblePaymentScheduleForSaasProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali per un prodotto container](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractPricingForContainerProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractPricingForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe orarie annuali e un piano di pagamento flessibile per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithHourlyAnnualPricingAndFlexiblePaymentScheduleForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe orarie annuali per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithHourlyAnnualPricingForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe orarie per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithHourlyPricingForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe di sottoscrizione per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithSubscriptionPricingForSaasProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali a livelli per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithTieredContractPricingForSaasProduct_section.md)
+ [Creare un’offerta di prova gratuita pubblica con tariffe di sottoscrizione per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePublicFreeTrialOfferWithSubscriptionPricingForSaasProduct_section.md)
+ [Creare un’offerta privata di sostituzione e tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateReplacementPrivateOfferWithContractPricing_section.md)
+ [Descrivere un’offerta pubblica](marketplace-catalog_example_marketplace-catalog_DescribeOffer_section.md)
+ [Impostare la data di scadenza di una bozza di offerta privata](marketplace-catalog_example_marketplace-catalog_ExpirePrivateOffer_section.md)
+ [Elencare tutte le offerte private](marketplace-catalog_example_marketplace-catalog_ListAllPrivateOffers_section.md)
+ [Elencare le offerte pubbliche e private rilasciate per un ID prodotto specifico](marketplace-catalog_example_marketplace-catalog_ListProductPublicOrPrivateReleasedOffers_section.md)
+ [Aggiorna un'offerta per applicare un contratto con prezzi Pay-As-You-Go](marketplace-catalog_example_marketplace-catalog_UpdateOfferWithContractAndPayAsYouGoPricing_section.md)
+ [Aggiornare un’offerta per applicare tariffe orarie annuali](marketplace-catalog_example_marketplace-catalog_UpdateOfferWithHourlyAnnualPricing_section.md)
+ [Aggiornare un’offerta per applicare il targeting a Regioni geografiche specifiche](marketplace-catalog_example_marketplace-catalog_UpdateOfferTargeting_section.md)
+ [Aggiornare il nome e la descrizione di un’offerta pubblica](marketplace-catalog_example_marketplace-catalog_UpdateOfferNameAndDescription_section.md)
+ [Aggiornare l’EULA di un’offerta](marketplace-catalog_example_marketplace-catalog_UpdateEula_section.md)
+ [Aggiornare la data di scadenza di un’offerta privata a una data futura](marketplace-catalog_example_marketplace-catalog_UpdateOfferExpirationDateOfPrivateOffer_section.md)
+ [Aggiornare la durata della prova gratuita di un’offerta di prova gratuita pubblica per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_UpdateFreeTrialDurationOfPublicFreeTrialOfferForSaasProduct_section.md)
+ [Aggiornare la policy di rimborso di un’offerta](marketplace-catalog_example_marketplace-catalog_UpdateRefundPolicy_section.md)
+ [Prodotti](marketplace-catalog_code_examples_products.md)
+ [Descrivere un prodotto AMI, SaaS o container](marketplace-catalog_example_marketplace-catalog_DescribeProduct_section.md)
+ [Elencare tutti i prodotti AMI, SaaS o container e le offerte pubbliche associate](marketplace-catalog_example_marketplace-catalog_ListProducts_section.md)
+ [Autorizzazione di rivendita](marketplace-catalog_code_examples_resale_authorization.md)
+ [Creare una bozza di autorizzazione di rivendita](marketplace-catalog_example_marketplace-catalog_DraftResaleauthAllproducttype_section.md)
+ [Descrivere un’autorizzazione di rivendita](marketplace-catalog_example_marketplace-catalog_DescribeResaleAuthorization_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum con un’offerta privata](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthPrivateoffer_section.md)
+ [Pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthExpirydateCppo_section.md)
+ [Pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza e un’EULA](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthExpirydateCustomEula_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso con una data di scadenza e la documentazione dell’accordo del rivenditore](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthExpirydateCustomresellerContractdoc_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso con scadenza e aggiungere un account acquirente specifico](marketplace-catalog_example_marketplace-catalog_PublishMultiuseResaleAuthorizationExpirydateSpecificBuyer_section.md)
+ [Pubblicare un’autorizzazione di rivendita multiuso senza una data di scadenza](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthNoExpirydateCppo_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso senza una data di scadenza e un’EULA](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthNoExpirydateCustomEula_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso senza una data di scadenza e la documentazione dell’accordo del rivenditore](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthNoExpirydateCustomresellerContractdoc_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso senza data di scadenza e aggiungere un account acquirente specifico](marketplace-catalog_example_marketplace-catalog_PublishMultiuseResaleAuthorizationNoExpirydateSpecificBuyer_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum e aggiungere un piano di pagamento flessibile](marketplace-catalog_example_marketplace-catalog_PublishOnetimeResaleAuthorizationFlexiblePayment_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum e aggiungere un’EULA](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthCustomEula_section.md)
+ [Pubblicare l’autorizzazione di rivendita una tantum e aggiungere un account acquirente specifico](marketplace-catalog_example_marketplace-catalog_PublishOnetimeResaleAuthorizationSpecificBuyer_section.md)
+ [Pubblicare l’autorizzazione di rivendita una tantum e aggiungere la documentazione dell’accordo del rivenditore](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthCustomresellerContractdoc_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum e specificare se si tratta di un rinnovo](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthRenewal_section.md)
+ [Limitare l’autorizzazione di rivendita](marketplace-catalog_example_marketplace-catalog_RestrictResaleAuthorization_section.md)
+ [Aggiornare il nome e la descrizione dell’autorizzazione di rivendita una tantum o multiuso](marketplace-catalog_example_marketplace-catalog_UpdateUnpublishedResaleAuthorization_section.md)
+ [Prodotti SaaS](marketplace-catalog_code_examples_saas_products.md)
+ [Creare una bozza di prodotto SaaS con una bozza di offerta pubblica](marketplace-catalog_example_marketplace-catalog_CreateDraftSaasProductWithDraftPublicOffer_section.md)
+ [Creare un prodotto SaaS pubblico o limitato e un’offerta pubblica con tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateLimitedSaasProductAndPublicOfferWithContractPricing_section.md)
+ [Crea un prodotto SaaS pubblico o limitato e un'offerta pubblica con contratto con prezzi Pay-As-You-Go](marketplace-catalog_example_marketplace-catalog_CreateLimitedSaasProductAndPublicOfferWithContractWithPayAsYouGoPricing_section.md)
+ [Creare un prodotto SaaS pubblico o limitato e un’offerta pubblica con tariffe di sottoscrizione](marketplace-catalog_example_marketplace-catalog_CreateLimitedSaasProductAndPublicOfferWithSubscriptionPricing_section.md)
+ [Pubblicare un prodotto SaaS e un’offerta pubblica associata](marketplace-catalog_example_marketplace-catalog_PublishSaasProductPublicOffer_section.md)
+ [Pubblicare un prodotto SaaS e un’offerta pubblica associata da una bozza esistente](marketplace-catalog_example_marketplace-catalog_PublishExistingSaas_section.md)
+ [Aggiornare le dimensioni in un’AMI o un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_UpdateNameDimensionSaasProduct_section.md)
+ [Utilità](marketplace-catalog_code_examples_utilities.md)
+ [Utilità per l’avvio di un set di modifiche](marketplace-catalog_example_marketplace-catalog_ChangeSetUtilities_section.md)
# Prodotti AMI per Marketplace AWS Catalog API
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Aggiungere una dimensione a un prodotto AMI esistente e aggiornare i termini e i prezzi dell’offerta](marketplace-catalog_example_marketplace-catalog_AddDimensionToAmiProductAndSetPriceInPublicOffer_section.md)
+ [Aggiungere una Regione in cui viene implementato un prodotto AMI](marketplace-catalog_example_marketplace-catalog_AddRegionExistingAmiProduct_section.md)
+ [Creare un prodotto AMI pubblico o limitato e un’offerta pubblica con tariffe orarie annuali](marketplace-catalog_example_marketplace-catalog_CreateLimitedAmiProductAndPublicOfferWithHourlyAnnualPricing_section.md)
+ [Creare un prodotto AMI pubblico o limitato e un’offerta pubblica con tariffe orarie mensili](marketplace-catalog_example_marketplace-catalog_CreateLimitedAmiProductAndPublicOfferWithHourlyMonthlyPricing_section.md)
+ [Creare un prodotto AMI pubblico o limitato e un’offerta pubblica con tariffe orarie](marketplace-catalog_example_marketplace-catalog_CreateLimitedAmiProductAndPublicOfferWithHourlyPricing_section.md)
+ [Creare una bozza di prodotto AMI con una bozza di offerta pubblica](marketplace-catalog_example_marketplace-catalog_CreateDraftAmiProductWithDraftPublicOffer_section.md)
+ [Limitare una Regione in cui un prodotto AMI viene distribuito](marketplace-catalog_example_marketplace-catalog_RestrictRegionExistingAmiProduct_section.md)
+ [Limitare la visibilità del prodotto](marketplace-catalog_example_marketplace-catalog_RestrictExistingAmi_section.md)
+ [Specificare se gli asset AMI vengono distribuiti in nuove Regioni](marketplace-catalog_example_marketplace-catalog_UpdateFutureRegionSupport_section.md)
# Aggiungi una dimensione a un prodotto AMI esistente e aggiorna i termini e i prezzi dell'offerta utilizzando un AWS SDK
Gli esempi di codice seguenti mostrano come aggiungere una dimensione a un prodotto AMI esistente e aggiornare le condizioni dei prezzi dell’offerta.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddDimensions",
"Entity": {
"Identifier": "prod-1111111111111",
"Type": "AmiProduct@1.0"
},
"DetailsDocument": [
{
"Key": "m7g.8xlarge",
"Description": "m7g.8xlarge",
"Name": "m7g.8xlarge",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m5.large",
"Price": "0.15"
},
{
"DimensionKey": "m7g.4xlarge",
"Price": "0.45"
},
{
"DimensionKey": "m7g.2xlarge",
"Price": "0.45"
},
{
"DimensionKey": "m7g.8xlarge",
"Price": "0.55"
}
]
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddDimensions",
"Entity": {
"Identifier": "prod-1111111111111",
"Type": "AmiProduct@1.0"
},
"DetailsDocument": [
{
"Key": "m7g.8xlarge",
"Description": "m7g.8xlarge",
"Name": "m7g.8xlarge",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m5.large",
"Price": "0.15"
},
{
"DimensionKey": "m7g.4xlarge",
"Price": "0.45"
},
{
"DimensionKey": "m7g.2xlarge",
"Price": "0.45"
},
{
"DimensionKey": "m7g.8xlarge",
"Price": "0.55"
}
]
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to add a dimension to an existing AMI product and update the offer pricing terms.
CAPI-23
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Add dimension for AMI product")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiungi una regione in cui viene distribuito un prodotto AMI utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiungere una Regione in cui implementare un prodotto AMI.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-east-2",
"us-west-2"
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-east-2",
"us-west-2"
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to add a region where my
AMI product is deployed
CAPI-25A
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Add a region where my AMI product is deployed",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto AMI pubblico o limitato e un'offerta pubblica con prezzi annuali orari utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un prodotto AMI pubblico o con limitazioni e un’offerta pubblica con prezzi orari annuali. Questo esempio crea un’EULA standard o personalizzata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Operating Systems"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Regions": [
"us-east-1"
]
}
},
{
"ChangeType": "AddInstanceTypes",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"InstanceTypes": [
"t2.micro"
]
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "Test AMI Version1.0",
"ReleaseNotes": "Test AMI Version"
},
"DeliveryOptions": [
{
"Details": {
"AmiDeliveryOptionDetails": {
"AmiSource": {
"AmiId": "ami-11111111111111111",
"AccessRoleArn": "arn:aws:iam::111111111111:role/AWSMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "10.0.14393",
"ScanningPort": 22
},
"UsageInstructions": "Test AMI Version",
"RecommendedInstanceType": "t2.micro",
"SecurityGroups": [
{
"IpProtocol": "tcp",
"IpRanges": [
"0.0.0.0/0"
],
"FromPort": 10,
"ToPort": 22
}
]
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "t2.micro",
"Description": "t2.micro",
"Name": "t2.micro",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with hourly-annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Operating Systems"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Regions": [
"us-east-1"
]
}
},
{
"ChangeType": "AddInstanceTypes",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"InstanceTypes": [
"t2.micro"
]
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "Test AMI Version1.0",
"ReleaseNotes": "Test AMI Version"
},
"DeliveryOptions": [
{
"Details": {
"AmiDeliveryOptionDetails": {
"AmiSource": {
"AmiId": "ami-11111111111111111",
"AccessRoleArn": "arn:aws:iam::111111111111:role/AWSMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "10.0.14393",
"ScanningPort": 22
},
"UsageInstructions": "Test AMI Version",
"RecommendedInstanceType": "t2.micro",
"SecurityGroups": [
{
"IpProtocol": "tcp",
"IpRanges": [
"0.0.0.0/0"
],
"FromPort": 10,
"ToPort": 22
}
]
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "t2.micro",
"Description": "t2.micro",
"Name": "t2.micro",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with hourly-annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a public or limited AMI
product and public offer with hourly-annual pricing and standard or custom EULA
CAPI-06
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create limited AMI product and public offer with hourly-annual pricing and standard EULA",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto AMI pubblico o limitato e un'offerta pubblica con prezzi mensili orari utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un prodotto AMI pubblico o con limitazioni e un’offerta pubblica con prezzi orari mensili. Questo esempio crea un’EULA standard o personalizzata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Operating Systems"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Regions": [
"us-east-1"
]
}
},
{
"ChangeType": "AddInstanceTypes",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"InstanceTypes": [
"t2.micro"
]
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "Test AMI Version1.0",
"ReleaseNotes": "Test AMI Version"
},
"DeliveryOptions": [
{
"Details": {
"AmiDeliveryOptionDetails": {
"AmiSource": {
"AmiId": "ami-11111111111111111",
"AccessRoleArn": "arn:aws:iam::111111111111:role/AWSMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "10.0.14393",
"ScanningPort": 22
},
"UsageInstructions": "Test AMI Version",
"RecommendedInstanceType": "t2.micro",
"SecurityGroups": [
{
"IpProtocol": "tcp",
"IpRanges": [
"0.0.0.0/0"
],
"FromPort": 10,
"ToPort": 22
}
]
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "t2.micro",
"Description": "t2.micro",
"Name": "t2.micro",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with hourly-monthly pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "15.0"
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Operating Systems"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Regions": [
"us-east-1"
]
}
},
{
"ChangeType": "AddInstanceTypes",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"InstanceTypes": [
"t2.micro"
]
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "Test AMI Version1.0",
"ReleaseNotes": "Test AMI Version"
},
"DeliveryOptions": [
{
"Details": {
"AmiDeliveryOptionDetails": {
"AmiSource": {
"AmiId": "ami-11111111111111111",
"AccessRoleArn": "arn:aws:iam::111111111111:role/AWSMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "10.0.14393",
"ScanningPort": 22
},
"UsageInstructions": "Test AMI Version",
"RecommendedInstanceType": "t2.micro",
"SecurityGroups": [
{
"IpProtocol": "tcp",
"IpRanges": [
"0.0.0.0/0"
],
"FromPort": 10,
"ToPort": 22
}
]
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "t2.micro",
"Description": "t2.micro",
"Name": "t2.micro",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with hourly-monthly pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "15.0"
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a public or limited AMI
product and public offer with hourly-monthly pricing and standard or custom EULA
CAPI-08
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"create limited AMI product and public offer with hourly-monthly pricing and standard EULA",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto AMI pubblico o limitato e un'offerta pubblica con prezzi orari utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un prodotto AMI pubblico o con limitazioni e un’offerta pubblica con prezzi orari. Questo esempio crea un’EULA standard o personalizzata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Operating Systems"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Regions": [
"us-east-1"
]
}
},
{
"ChangeType": "AddInstanceTypes",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"InstanceTypes": [
"t2.micro"
]
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "Test AMI Version1.0",
"ReleaseNotes": "Test AMI Version"
},
"DeliveryOptions": [
{
"Details": {
"AmiDeliveryOptionDetails": {
"AmiSource": {
"AmiId": "ami-11111111111111111",
"AccessRoleArn": "arn:aws:iam::111111111111:role/AWSMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "10.0.14393",
"ScanningPort": 22
},
"UsageInstructions": "Test AMI Version",
"RecommendedInstanceType": "t2.micro",
"SecurityGroups": [
{
"IpProtocol": "tcp",
"IpRanges": [
"0.0.0.0/0"
],
"FromPort": 10,
"ToPort": 22
}
]
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "t2.micro",
"Description": "t2.micro",
"Name": "t2.micro",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with hourly pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Operating Systems"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Regions": [
"us-east-1"
]
}
},
{
"ChangeType": "AddInstanceTypes",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"InstanceTypes": [
"t2.micro"
]
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "Test AMI Version1.0",
"ReleaseNotes": "Test AMI Version"
},
"DeliveryOptions": [
{
"Details": {
"AmiDeliveryOptionDetails": {
"AmiSource": {
"AmiId": "ami-11111111111111111",
"AccessRoleArn": "arn:aws:iam::111111111111:role/AWSMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "10.0.14393",
"ScanningPort": 22
},
"UsageInstructions": "Test AMI Version",
"RecommendedInstanceType": "t2.micro",
"SecurityGroups": [
{
"IpProtocol": "tcp",
"IpRanges": [
"0.0.0.0/0"
],
"FromPort": 10,
"ToPort": 22
}
]
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "t2.micro",
"Description": "t2.micro",
"Name": "t2.micro",
"Types": [
"Metered"
],
"Unit": "Hrs"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with hourly pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to Create a public or limited AMI product
and public offer with hourly pricing and standard or custom EULA
CAPI-07
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create limited AMI product and public offer with hourly pricing and standard EULA",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea una bozza di prodotto AMI con una bozza di offerta pubblica utilizzando un AWS SDK
Gli esempi di codice seguenti mostrano come creare una bozza di prodotto AMI con una bozza di offerta pubblica.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {
"ProductTitle": "Sample product"
}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier",
"Name": "Test Offer"
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier",
"Name": "Test Offer"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create an AMI draft product
with a draft public offer.
CAPI-02
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"AMI draft product with draft public offer",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Limita una regione in cui un prodotto AMI viene distribuito utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come limitare una Regione in cui implementare un prodotto AMI.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-west-2"
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-west-2"
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to restrict a region where my
AMI product is deployed
CAPI-25B
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Add a region where my AMI product is deployed",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Limita la visibilità del prodotto utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come limitare la visibilità del prodotto.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to change a product visibility to restricted
CAPI-17
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Restrict existing AMI")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Specificate se gli asset AMI vengono distribuiti in nuove regioni utilizzando un SDK AWS
I seguenti esempi di codice mostrano come specificare se gli asset AMI vengono distribuiti in nuove regioni create da AWS per supportare le regioni future.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateFutureRegionSupport",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"FutureRegionSupport": {
"SupportedRegions": [
"All"
]
}
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateFutureRegionSupport",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"FutureRegionSupport": {
"SupportedRegions": [
"All"
]
}
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to modify a product to support all future regions
CAPI-26
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update future region support")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Offerte dei partner di canale per Catalog API Marketplace AWS
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Creare una bozza di offerta CPPO per qualsiasi tipo di prodotto](marketplace-catalog_example_marketplace-catalog_CreateDraftCppoOffer_section.md)
+ [Creare un’offerta privata di sostituzione dell’autorizzazione di rivendita e tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateResaleAuthorizationReplacementOffer_section.md)
+ [Elenca tutto ciò che CPPOs è stato creato da un partner di canale](marketplace-catalog_example_marketplace-catalog_ListAllCppoOffers_section.md)
+ [Elencare tutte le autorizzazioni di rivendita condivise disponibili per un partner di canale](marketplace-catalog_example_marketplace-catalog_ListAllSharedResaleAuthorizations_section.md)
+ [Pubblicare un’offerta CPPO e aggiungere un’EULA per l’acquirente](marketplace-catalog_example_marketplace-catalog_PublishCppoEula_section.md)
+ [Pubblicare un’offerta CPPO utilizzando l’autorizzazione di rivendita una tantum e aggiornare il markup dei prezzi](marketplace-catalog_example_marketplace-catalog_PublishOneTimeCppoWithPriceMarkup_section.md)
+ [Pubblicare una bozza di offerta CPPO e aggiornare il markup dei prezzi](marketplace-catalog_example_marketplace-catalog_PublishCppoPriceMarkup_section.md)
+ [Aggiornare la data di scadenza di un’offerta CPPO](marketplace-catalog_example_marketplace-catalog_UpdateCppoExpiryDate_section.md)
# Crea una bozza di CPPO per qualsiasi tipo di prodotto utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare una bozza di offerta CPPO per qualsiasi tipo di prodotto in modo da poterla esaminare internamente prima della pubblicazione per gli acquirenti.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "11111111-1111-1111-1111-111111111111",
"Name": "Test Offer",
"Description": "Test product"
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "11111111-1111-1111-1111-111111111111",
"Name": "Test Offer name"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create “draft” CPPO
for any product type (AMI/SaaS/Container) that can be reviewed internally
before publishing to buyers
CAPI-60
"""
import os
import utils.start_changeset as sc # noqa: E402
import utils.stringify_details as sd # noqa: E402
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Create a draft CPPO offer for a product")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'autorizzazione alla rivendita (offerta privata sostitutiva) sulla base di un accordo esistente con prezzi contrattuali utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata sostitutiva dell’autorizzazione di rivendita a partire da un accordo esistente con tariffe contrattuali.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateReplacementOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateReplacementOfferResaleAuth",
"DetailsDocument": {
"AgreementId": "agmt-1111111111111111111111111",
"ResaleAuthorizationId": "resaleauthz-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test replacement offer for SaaSProduct using AWS Marketplace API Reference Codes",
"Description": "Test private resale replacement offer with contract pricing for SaaSProduct"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Duration": "P12M",
"Grants": [
{
"DimensionKey": "BasicService",
"MaxQuantity": 2
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementEndDate": "2024-01-30"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "0"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateReplacementOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateReplacementOfferResaleAuth",
"DetailsDocument": {
"AgreementId": "agmt-1111111111111111111111111",
"ResaleAuthorizationId": "resaleauthz-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test replacement offer for SaaSProduct using AWS Marketplace API Reference Codes",
"Description": "Test private resale replacement offer with contract pricing for SaaSProduct"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Duration": "P12M",
"Grants": [
{
"DimensionKey": "BasicService",
"MaxQuantity": 2
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementEndDate": "2024-01-30"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "0"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOfferResaleAuth.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a resale authorization replacement private offer
from an existing agreement with contract pricing
CAPI-96
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create resale authorization replacement private offer with contract pricing",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Elenca tutte le CPPOs creazioni create da un partner di canale utilizzando un SDK AWS
I seguenti esempi di codice mostrano come elencare tutti i prodotti CPPOs creati da un partner di canale.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.core.document.Document;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
public class ListAllCppoOffers {
/*
* List all CPPOs created by a channel partner
*/
public static void main(String[] args) {
List cppoOfferIds = getAllCppoOfferIds();
ReferenceCodesUtils.formatOutput(cppoOfferIds);
}
public static List getAllCppoOfferIds() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
// get all offer entity ids
List entityIdList = new ArrayList();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
for (EntitySummary entitySummary : listEntitiesResponse.entitySummaryList()) {
entityIdList.add(entitySummary.entityId());
}
while (listEntitiesResponse.nextToken() != null) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
for (EntitySummary entitySummary : listEntitiesResponse.entitySummaryList()) {
entityIdList.add(entitySummary.entityId());
}
}
// filter for CPPO offers: ResaleAuthorizationId exists in Details
List cppoOfferIds = new ArrayList();
for (String entityId : entityIdList) {
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(entityId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
Document resaleAuthorizationDocument = describeEntityResponse.detailsDocument().asMap().get(ATTRIBUTE_RESALE_AUTHORIZATION_ID);
String resaleAuthorizationId = resaleAuthorizationDocument != null ? resaleAuthorizationDocument.asString() : "";
if (!resaleAuthorizationId.isEmpty()) {
cppoOfferIds.add(resaleAuthorizationId);
}
}
return cppoOfferIds;
}
}
```
+ Per i dettagli sull'API, [ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to list all Channel Partner Offers
in an account
Program executed with no arguments:
ie. python3 list_all_cppo_offers.py
CAPI-93
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
mp_client = boto3.client("marketplace-catalog")
def get_offer_entities():
"""
Returns a list of all offers in the account
"""
next_token = "" # nosec: B105
response_list = []
try:
response = mp_client.list_entities(Catalog="AWSMarketplace", EntityType="Offer")
except ClientError as e:
logging.exception(f"Couldn't list entities. {e}")
raise
response_list.append(response)
# Results are paginated depending on number of entities returned
while "NextToken" in response:
next_token = response["NextToken"]
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType="Offer",
NextToken=next_token,
)
except ClientError as e:
logging.exception(f"Couldn't list entities. {e}")
raise
if "NextToken" in response:
response_list.append(response)
return response_list
def build_offer_list(response_list):
"""
Cleans up list_entities response list with just list of offer IDs
"""
offer_list = []
for response in response_list:
for entity in response["EntitySummaryList"]:
offer_list.append(entity["EntityId"])
return offer_list
def check_offer_resaleauth(offer_id):
"""
Checks to see if an offer is based on a resale authorization
"""
offer_response = describe_entity(offer_id)
offer_details = json.loads(offer_response["Details"])
if offer_details is None:
offer_details = offer_response["DetailsDocument"]
if "ResaleAuthorizationId" in offer_details and offer_details["ResaleAuthorizationId"] is not None:
return offer_id
else:
return None
def describe_entity(entity_id):
"""
General purpose describe entity call
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace",
EntityId=entity_id,
)
except ClientError as e:
logging.exception(f"Couldn't describe entity. {e}")
raise
return response
def get_resaleauth_offers():
"""
Returns a list of all offers in the account that are
based on a resale authorization
"""
resale_offer_list = []
response_list = get_offer_entities()
offer_list = build_offer_list(response_list)
for offer in offer_list:
print ("offer id " + offer)
offer_info = check_offer_resaleauth(offer)
if offer_info is not None:
resale_offer_list.append(offer_info)
return resale_offer_list
if __name__ == "__main__":
print(get_resaleauth_offers())
```
+ Per i dettagli sull'API, consulta [ListEntities AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/ListEntities)*SDK for Python (Boto3) API Reference*.
------
# Elenca tutte le autorizzazioni di rivendita condivise disponibili per un partner di canale utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come elencare tutte le autorizzazioni di rivendita condivise disponibili per un partner di canale.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
public class ListAllSharedResaleAuthorizations {
/*
* list all resale authorizations shared to an account
*/
public static void main(String[] args) {
List responseList = getListEntityResponseList();
ReferenceCodesUtils.formatOutput(responseList);
}
public static List getListEntityResponseList() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
List responseList = new ArrayList();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_RESALE_AUTHORIZATION)
.maxResults(10)
.ownershipType(OWNERSHIP_TYPE_SHARED)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
responseList.add(listEntitiesResponse);
while (listEntitiesResponse.nextToken() != null) {
listEntitiesRequest = ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_RESALE_AUTHORIZATION)
.maxResults(10)
.ownershipType(OWNERSHIP_TYPE_SHARED)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
responseList.add(listEntitiesResponse);
}
return responseList;
}
}
```
+ Per i dettagli sull'API, [ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to list all resale authorizations
shared to an account
Program executed with no arguments:
ie. python3 list_all_resale_authorizations.py
CAPI-94
"""
import logging
import boto3
import utils.helpers as hlp # noqa: E402
from botocore.exceptions import ClientError
mp_client = boto3.client("marketplace-catalog")
def get_shared_entities():
next_token = "" # nosec: B105
response_list = []
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType="ResaleAuthorization",
OwnershipType="SHARED",
)
except ClientError as e:
logging.exception(f"Couldn't list entities. {e}")
raise
response_list.append(response)
# Results can be paginated depending on number of entities returned
while "NextToken" in response:
next_token = response["NextToken"]
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType="ResaleAuthorization",
OwnershipType="SHARED",
NextToken=next_token,
)
except ClientError as e:
logging.exception(f"Couldn't list entities. {e}")
raise
if "NextToken" in response:
response_list.append(response)
return response_list
if __name__ == "__main__":
response_list = get_shared_entities()
hlp.pretty_print_datetime(response_list)
```
+ Per i dettagli sull'API, consulta [ListEntities AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/ListEntities)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un CPPO e aggiungi un EULA per l'acquirente utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’offerta CPPO e aggiungere un contratto di licenza con l’utente finale (EULA) per l’acquirente.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateCPPOoffer",
"DetailsDocument": {
"ResaleAuthorizationId":"resaleauthz-1111111111111",
"Name": "Test Offer",
"Description":"Test product"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": ["222222222222"]
}
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-07-31"
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P450D"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateCPPOoffer",
"DetailsDocument": {
"ResaleAuthorizationId":"resaleauthz-1111111111111",
"Name": "Test Offer",
"Description":"Test product"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": ["222222222222"]
}
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-07-31"
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P450D"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to publish CPPO
for any product type (AMI/SaaS/Container) and append buyer EULA
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Publish CPPO for any product type and append buyer EULA",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un CPPO utilizzando l'autorizzazione di rivendita una tantum e aggiorna il markup dei prezzi utilizzando un SDK AWS
I seguenti esempi di codice mostrano come pubblicare un’offerta CPPO utilizzando l’autorizzazione di rivendita una tantum su prodotti AMI, SaaS o Container e aggiornare il markup dei prezzi.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateCPPOoffer",
"DetailsDocument": {
"ResaleAuthorizationId":"resaleauthz-1111111111111",
"Name": "Test Offer",
"Description":"Test product"
}
},
{
"ChangeType": "UpdateMarkup",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Percentage" : "5.0"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": ["222222222222"]
}
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-07-31"
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P450D"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateCPPO",
"DetailsDocument": {
"ResaleAuthorizationId":"resaleauthz-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test Offer name",
"Description":"Test Offer description"
}
},
{
"ChangeType": "UpdateMarkup",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"Percentage" : "5.0"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": ["111111111111"]
}
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to Create CPPO using one-time resale
authorization on AMI, SaaS or Container products and update price markup
CAPI-63
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create CPPO using one-time resale authorization and update price markup"
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica una bozza di CPPO e aggiorna il markup dei prezzi utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare una bozza di offerta CPPO e aggiornare il markup dei prezzi.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateCPPOoffer",
"DetailsDocument": {
"ResaleAuthorizationId":"resaleauthz-1111111111111",
"Name": "Test Offer",
"Description":"Test product"
}
},
{
"ChangeType": "UpdateMarkup",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Percentage" : "5.0"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": ["222222222222"]
}
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-07-31"
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P450D"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateCPPOoffer.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateCPPO",
"DetailsDocument": {
"ResaleAuthorizationId":"resaleauthz-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test Offer name",
"Description":"Test Offer description"
}
},
{
"ChangeType": "UpdateMarkup",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"Percentage" : "5.0"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": ["111111111111"]
}
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P450D"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateCPPO.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to publish “draft” CPPO
for any product type (AMI/SaaS/Container) and update price markup
CAPI-72
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Publish draft CPPO for any product type adn update price markup"
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna la data di scadenza di un CPPO utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare la data di scadenza di un’offerta CPPO per dare agli acquirenti più tempo per valutare e accettare l’offerta.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2025-07-31"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2025-07-31"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update the expiry
date of a CPPO offer
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Update the expiry date of a CPPO offer"
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Prodotti contenitore per Catalog API Marketplace AWS
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Creare una bozza di prodotto container con una bozza di offerta pubblica](marketplace-catalog_example_marketplace-catalog_CreateDraftContainerProductWithDraftPublicOffer_section.md)
+ [Creare un prodotto container limitato con offerta pubblica e tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateLimitedContainerProductPublicOffer_section.md)
# Crea una bozza di prodotto contenitore con una bozza di offerta pubblica utilizzando un AWS SDK
Gli esempi di codice seguenti mostrano come creare una bozza di prodotto container con una bozza di offerta pubblica.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog":"AWSMarketplace",
"changeSet":[
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "ContainerProduct@1.0"
},
"DetailsDocument": {
"ProductTitle": "Sample product"
}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier",
"Name": "Test Offer"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog":"AWSMarketplace",
"ChangeSet":[
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "ContainerProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier",
"Name": "Test Offer"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create an container draft product
with a draft public offer.
CAPI-03
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create a draft container product with a draft public offer",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto container limitato con offerta pubblica e prezzi contrattuali utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un prodotto container con limitazioni e con un’offerta pubblica, tariffe contrattuali e un contratto di licenza con l’utente finale (EULA) standard.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "ContainerProduct@1.0"
},
"DetailsDocument": {},
"ChangeName": "CreateProductChange"
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"Categories": [
"Streaming solutions"
],
"ProductTitle": "ContainerProduct",
"AdditionalResources": [],
"LongDescription": "Long description goes here",
"SearchKeywords": [
"container streaming"
],
"ShortDescription": "Description1",
"Highlights": [
"Highlight 1",
"Highlight 2"
],
"SupportDescription": "No support available",
"VideoUrls": []
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "Cores",
"Description": "Cores per cluster",
"Name": "Cores",
"Types": [
"Entitled"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "AddRepositories",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Repositories": [
{
"RepositoryName": "uniquerepositoryname",
"RepositoryType": "ECR"
}
]
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
},
"ChangeName": "CreateOfferChange"
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"Constraints": {
"MultipleDimensionSelection": "Disallowed",
"QuantityConfiguration": "Disallowed"
},
"RateCard": [
{
"DimensionKey": "Cores",
"Price": "0.25"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "No refunds"
}
]
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Some container offer Name",
"Description": "Some interesting container offer description"
}
},
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "ContainerProduct@1.0"
},
"DetailsDocument": {},
"ChangeName": "CreateProductChange"
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"Categories": [
"Streaming solutions"
],
"ProductTitle": "ContainerProduct",
"AdditionalResources": [],
"LongDescription": "Long description goes here",
"SearchKeywords": [
"container streaming"
],
"ShortDescription": "Description1",
"Highlights": [
"Highlight 1",
"Highlight 2"
],
"SupportDescription": "No support available",
"VideoUrls": []
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "Cores",
"Description": "Cores per cluster",
"Name": "Cores",
"Types": [
"Entitled"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "AddRepositories",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"Repositories": [
{
"RepositoryName": "uniquerepositoryname",
"RepositoryType": "ECR"
}
]
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "ContainerProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
},
"ChangeName": "CreateOfferChange"
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"Constraints": {
"MultipleDimensionSelection": "Disallowed",
"QuantityConfiguration": "Disallowed"
},
"RateCard": [
{
"DimensionKey": "Cores",
"Price": "0.25"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "No refunds"
}
]
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Some container offer Name",
"Description": "Some interesting container offer description"
}
},
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create limited container
product with public offer, contract pricing and standard EULA
CAPI-15
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create limited container product with public offer contract pricing and standard EULA",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Entità per l'API Catalog Marketplace AWS
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Descrivere tutte le entità in un’unica chiamata](marketplace-catalog_example_marketplace-catalog_BatchDescribeEntities_section.md)
+ [Elencare e descrivere tutte le offerte associate a un prodotto](marketplace-catalog_example_marketplace-catalog_ListProductOffers_section.md)
# Descrivi tutte le entità in una singola chiamata utilizzando un AWS SDK
Gli esempi di codice seguenti mostrano come descrivere tutte le entità in una singola chiamata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.BatchDescribeEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.BatchDescribeEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityDetail;
import software.amazon.awssdk.services.marketplacecatalog.model.BatchDescribeErrorDetail;
import java.util.Arrays;
import java.util.Map;
public class BatchDescribeEntities {
/*
* BatchDescribe my entities in a single call and
* check if it contains all the information I need to know about the entities.
*/
public static void main(String[] args) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
BatchDescribeEntitiesRequest batchDescribeEntitiesRequest =
BatchDescribeEntitiesRequest.builder()
.entityRequestList(Arrays.asList(
EntityRequest.builder()
.catalog(AWS_MP_CATALOG).entityId(OFFER_ID)
.build(),
EntityRequest.builder()
.catalog(AWS_MP_CATALOG).entityId(PRODUCT_ID)
.build()))
.build();
BatchDescribeEntitiesResponse batchDescribeEntitiesResponse = marketplaceCatalogClient.batchDescribeEntities(batchDescribeEntitiesRequest);
// Reading the successful entities response
Map entityDetailsMap = batchDescribeEntitiesResponse.entityDetails();
for (Map.Entry entry : entityDetailsMap.entrySet()) {
System.out.println("EntityId: " + entry.getKey());
ReferenceCodesUtils.formatOutput(entry.getValue());
}
// Logging the failed entities error details
Map entityErrorsMap = batchDescribeEntitiesResponse.errors();
for (Map.Entry entry : entityErrorsMap.entrySet()) {
System.out.println(String.format("EntityId: %s, ErrorCode: %s, ErrorMessage: %s", entry.getKey(),
entry.getValue().errorCode(), entry.getValue().errorMessage()));
}
}
}
```
+ Per i dettagli sull'API, consulta la [BatchDescribeEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/BatchDescribeEntities)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to describe for multiple entities information in the AWS Marketplace Catalog
CAPI-98
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
PRODUCT_ID = "prod-1111111111111"
OFFER_ID = "offer-1111111111111"
MARKETPLACE_CATALOG = "AWSMarketplace"
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
def get_entities_information(mp_client):
"""
Returns information about a given product
Args: entity_id str: Entity to return
Returns: dict: Dictionary of product information
"""
entity_request_list_param = [
{'EntityId': PRODUCT_ID, 'Catalog': MARKETPLACE_CATALOG},
{'EntityId': OFFER_ID, 'Catalog': MARKETPLACE_CATALOG}
]
try:
response = mp_client.batch_describe_entities(
EntityRequestList=entity_request_list_param
)
return response
except ClientError as e:
logger.exception("Unexpected error: %s", e)
raise
def usage_demo():
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Looking for entities in the AWS Marketplace Catalog.")
print("-" * 88)
mp_client = boto3.client("marketplace-catalog")
response = get_entities_information(mp_client)
print("Successful entities response -")
pretty_print(response["EntityDetails"])
print("Failed entities response -")
pretty_print(response["Errors"])
if __name__ == "__main__":
usage_demo()
```
+ Per i dettagli sull'API, consulta [BatchDescribeEntities AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/BatchDescribeEntities)*SDK for Python (Boto3) API Reference*.
------
# Elenca e descrivi tutte le offerte associate a un prodotto utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come elencare e descrivere tutte le offerte associate a un prodotto.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferProductIdFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListProductPrivateOffers {
private static MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
/*
* retrieve all private offer information related to a single product
*/
public static void main(String[] args) {
List entitySummaryList = getEntitySummaryList();
// for each offer id, output the offer detail using DescribeEntity API
for (EntitySummary entitySummary : entitySummaryList) {
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(entitySummary.entityId())
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
}
public static List getEntitySummaryList() {
// define list entities filters
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_BUYERACCOUNTS)
.build())
.productId(OfferProductIdFilter.builder()
.valueList(PRODUCT_ID)
.build())
.build())
.build();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER).maxResults(50)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
// save all entitySummary of the results into entitySummaryList
List entitySummaryList = new ArrayList();
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER).maxResults(50)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
return entitySummaryList;
}
}
```
+ Per informazioni dettagliate sull’API, consulta i seguenti argomenti nella *documentazione di riferimento dell’API AWS SDK for Java 2.x *.
+ [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)
+ [ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è dell'altro GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to retrieve all offer information
related to a single product
CAPI-97
"""
import argparse
import logging
import boto3
from botocore.exceptions import ClientError
from utils import helpers
logger = logging.getLogger(__name__)
mp_client = boto3.client("marketplace-catalog")
def get_entity_information(entity_id):
"""
Returns information about a given entity
Args: entity_id str: Entity to return
Returns: dict: Dictionary of entity information
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace",
EntityId=entity_id,
)
return response
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Entity with ID %s not found.", entity_id)
else:
logger.error("Unexpected error: %s", e)
def list_entity_details(entity_type, entity_id):
"""
Returns details about a given entity and entity type
"""
entity_summary_list = []
# filter will return details for given entity_id with BuyerAccounts targeting
filter_list_param = {
'OfferFilters':{
'ProductId':{
'ValueList':[entity_id]
},
'Targeting': {
'ValueList': ["BuyerAccounts"]
}
}
}
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType=entity_type,
EntityTypeFilters = filter_list_param,
MaxResults=10
)
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Entity ID %s not found.", entity_id)
else:
logger.error("Unexpected error: %s", e)
# add results to entity_summary_list
entity_summary_list.extend(response["EntitySummaryList"])
# if there are more than 10 offers, paginate through the results
while "NextToken" in response and response["NextToken"] is not None:
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType=entity_type,
EntityTypeFilters = filter_list_param,
NextToken=response["NextToken"],
MaxResults=10
)
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Entity ID %s not found.", entity_id)
else:
logger.error("Unexpected error: %s", e)
# add results to entity_summary_list
entity_summary_list.extend(response["EntitySummaryList"])
return entity_summary_list
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument(
"--entity-id",
"-eid",
help="Provide Entity ID corresponding to a product to filter offers on",
required=True,
)
args = parser.parse_args()
# Gets a offers associated with the entity_id
response = list_entity_details(
"Offer",
entity_id=args.entity_id
)
if response: # if response is not empty
# list_entity_details returns a list of offers
for offer in response:
print("-"*128)
print(f"Terms for Offer ID: {offer['EntityId']}")
print("-"*128)
#retrieve offer information for each offer
entity_information = get_entity_information(offer["EntityId"])
helpers.pretty_print_datetime(entity_information)
else:
print(f"No information found for Entity ID: {args.entity_id}")
```
+ Per informazioni dettagliate sull’API, consulta i seguenti argomenti nella *documentazione di riferimento dell’API AWS SDK per Python (Boto3)*.
+ [DescribeEntity](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/DescribeEntity)
+ [ListEntities](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/ListEntities)
------
# Offerte per Marketplace AWS Catalog API
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Creare una dimensione personalizzata per un prodotto SaaS e creare un’offerta privata](marketplace-catalog_example_marketplace-catalog_CreateSaasProductCustomDimensionAndPrivateOffer_section.md)
+ [Creare una bozza di offerta privata per un prodotto AMI o SaaS](marketplace-catalog_example_marketplace-catalog_CreateDraftPrivateOffer_section.md)
+ [Crea un'offerta privata con contratto e Pay-As-You-Go prezzi per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractWithPayAsYouGoPricingForSaasProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali e un piano di pagamento flessibile per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractPricingWithFlexiblePaymentScheduleForSaasProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali per un prodotto container](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractPricingForContainerProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithContractPricingForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe orarie annuali e un piano di pagamento flessibile per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithHourlyAnnualPricingAndFlexiblePaymentScheduleForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe orarie annuali per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithHourlyAnnualPricingForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe orarie per un prodotto AMI](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithHourlyPricingForAmiProduct_section.md)
+ [Creare un’offerta privata con tariffe di sottoscrizione per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithSubscriptionPricingForSaasProduct_section.md)
+ [Creare un’offerta privata con tariffe contrattuali a livelli per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePrivateOfferWithTieredContractPricingForSaasProduct_section.md)
+ [Creare un’offerta di prova gratuita pubblica con tariffe di sottoscrizione per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_CreatePublicFreeTrialOfferWithSubscriptionPricingForSaasProduct_section.md)
+ [Creare un’offerta privata di sostituzione e tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateReplacementPrivateOfferWithContractPricing_section.md)
+ [Descrivere un’offerta pubblica](marketplace-catalog_example_marketplace-catalog_DescribeOffer_section.md)
+ [Impostare la data di scadenza di una bozza di offerta privata](marketplace-catalog_example_marketplace-catalog_ExpirePrivateOffer_section.md)
+ [Elencare tutte le offerte private](marketplace-catalog_example_marketplace-catalog_ListAllPrivateOffers_section.md)
+ [Elencare le offerte pubbliche e private rilasciate per un ID prodotto specifico](marketplace-catalog_example_marketplace-catalog_ListProductPublicOrPrivateReleasedOffers_section.md)
+ [Aggiorna un'offerta per applicare un contratto con prezzi Pay-As-You-Go](marketplace-catalog_example_marketplace-catalog_UpdateOfferWithContractAndPayAsYouGoPricing_section.md)
+ [Aggiornare un’offerta per applicare tariffe orarie annuali](marketplace-catalog_example_marketplace-catalog_UpdateOfferWithHourlyAnnualPricing_section.md)
+ [Aggiornare un’offerta per applicare il targeting a Regioni geografiche specifiche](marketplace-catalog_example_marketplace-catalog_UpdateOfferTargeting_section.md)
+ [Aggiornare il nome e la descrizione di un’offerta pubblica](marketplace-catalog_example_marketplace-catalog_UpdateOfferNameAndDescription_section.md)
+ [Aggiornare l’EULA di un’offerta](marketplace-catalog_example_marketplace-catalog_UpdateEula_section.md)
+ [Aggiornare la data di scadenza di un’offerta privata a una data futura](marketplace-catalog_example_marketplace-catalog_UpdateOfferExpirationDateOfPrivateOffer_section.md)
+ [Aggiornare la durata della prova gratuita di un’offerta di prova gratuita pubblica per un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_UpdateFreeTrialDurationOfPublicFreeTrialOfferForSaasProduct_section.md)
+ [Aggiornare la policy di rimborso di un’offerta](marketplace-catalog_example_marketplace-catalog_UpdateRefundPolicy_section.md)
# Crea una dimensione personalizzata per un prodotto SaaS e crea un'offerta privata utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare una dimensione personalizzata per un prodotto SaaS e creare un’offerta privata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": [
{
"Types": [
"Entitled"
],
"Description": "Custom Pricing 4 w/ terms and coverage to be defined in Private Offer",
"Unit": "Units",
"Key": "Custom4",
"Name": "Custom Pricing 4"
}
]
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
},
"ChangeName": "CreateOfferChange"
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Private Test Offer - SaaS Contract Product",
"Description": "Private Test Offer - SaaS Contract Product"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
},
"RateCard": [
{
"DimensionKey": "Custom4",
"Price": "300.0"
}
],
"Selector": {
"Type": "Duration",
"Value": "P36M"
}
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
],
"ChangeSetName": "PrivateOfferWithCustomDimension"
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": [
{
"Types": [
"Entitled"
],
"Description": "Custom Pricing 4 w/ terms and coverage to be defined in Private Offer",
"Unit": "Units",
"Key": "Custom4",
"Name": "Custom Pricing 4"
}
]
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
},
"ChangeName": "CreateOfferChange"
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Private Test Offer - SaaS Contract Product",
"Description": "Private Test Offer - SaaS Contract Product"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
},
"RateCard": [
{
"DimensionKey": "Custom4",
"Price": "300.0"
}
],
"Selector": {
"Type": "Duration",
"Value": "P36M"
}
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
],
"ChangeSetName": "PrivateOfferWithCustomDimension"
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a SaaS product custom dimension and private offer
CAPI-91
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "Create a SaaS product custom dimension and private offer"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea una bozza di offerta privata per un prodotto AMI o SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare una bozza di offerta privata per un prodotto AMI o SaaS in modo da poterla esaminare internamente prima della pubblicazione per gli acquirenti.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "Test Private Offer"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "Test Private Offer"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create “draft” Private Offer
for any AMI or SAAS product type that can be reviewed internally
before publishing to buyers
CAPI-30
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Private offer for AMI product")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con contratto e Pay-As-You-Go prezzi per un prodotto SaaS utilizzando un SDK AWS
I seguenti esempi di codice mostrano come creare un'offerta privata con contratto e Pay-As-You-Go prezzi per un prodotto SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è di più su. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with contract with PAYG pricing for my SaaS product
CAPI-34
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Create private offer with contract with PAYG pricing for my SaaS product",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi contrattuali e un programma di pagamento flessibile per un prodotto SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con tariffe contrattuali e un piano di pagamento flessibile per un prodotto SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Grants": [
{
"DimensionKey": "BasicService",
"MaxQuantity": 1
},
{
"DimensionKey": "PremiumService",
"MaxQuantity": 1
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P12M"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2024-02-01",
"ChargeAmount": "170.00"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Grants": [
{
"DimensionKey": "BasicService",
"MaxQuantity": 1
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P12M"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2024-02-01",
"ChargeAmount": "170.00"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Some kind of refund policy description"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer
with contract pricing and flexible payment schedule for my SaaS product
CAPI-39
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create private offer with contract pricing and flexible payment schedule for my SaaS product",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi contrattuali per un prodotto Container utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con tariffe contrattuali per un prodotto container.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for Container product using AWS Marketplace API Reference Code",
"Description": "Test private offer for Container product with contract pricing using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"Constraints": {
"MultipleDimensionSelection": "Disallowed",
"QuantityConfiguration": "Disallowed"
},
"RateCard": [
{
"DimensionKey": "ReqPerHour",
"Price": "0.25"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for Container product using AWS Marketplace API Reference Code",
"Description": "Test private offer for Container product with contract pricing using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"Constraints": {
"MultipleDimensionSelection": "Disallowed",
"QuantityConfiguration": "Disallowed"
},
"RateCard": [
{
"DimensionKey": "ReqPerHour",
"Price": "0.25"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer (target buyers)
for my Container product with contract pricing
CAPI-36
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"publish a private offer for my Container product with contract pricing",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi contrattuali per un prodotto AMI utilizzando un AWS SDK
Gli esempi di codice seguenti mostrano come creare un’offerta privata con tariffe contrattuali per un prodotto AMI.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "ReadOnlyUsers",
"Price": "220.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "ReadOnlyUsers",
"Price": "220.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with contract pricing for my AMI product
CAPI-35
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "create private offer with contract pricing for my AMI product"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi orari annuali e un programma di pagamento flessibile per un prodotto AMI utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con prezzi orari annuali e un piano di pagamento flessibile per un prodotto AMI.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.17"
}
]
}
]
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Duration": "P365D",
"Grants": [
{
"DimensionKey": "t2.micro",
"MaxQuantity": 1
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P650D"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2024-02-01",
"ChargeAmount": "170.00"
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.17"
}
]
}
]
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Duration": "P365D",
"Grants": [
{
"DimensionKey": "t2.micro",
"MaxQuantity": 1
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P650D"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2024-02-01",
"ChargeAmount": "170.00"
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with hourly annual pricing and flexible payment schedule for my AMI product
CAPI-XX
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Create private offer with hourly annual pricing and flexible payment schedule for my AMI product",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi orari annuali per un prodotto AMI utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con prezzi orari annuali per un prodotto AMI.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.17"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "220.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P650D"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly annual pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.17"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "220.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P650D"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with hourly annual pricing for my AMI product
CAPI-31
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "create private offer with hourly annual pricing for my AMI product"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi orari per un prodotto AMI utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con prezzi orari per un prodotto AMI.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2025-01-01"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P30D"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for AmiProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with hourly pricing for AmiProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2025-01-01"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "0.15"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P30D"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with hourly pricing for my AMI product
CAPI-32
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "create private offer with hourly pricing for my AMI product"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi di abbonamento per un prodotto SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con tariffe di sottoscrizione per un prodotto SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.13"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.22"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P30D"
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.13"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.22"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P30D"
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with subscription pricing for my SaaS product
CAPI-33
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "Create private offer with subscription pricing for my SaaS product"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata con prezzi contrattuali a più livelli per un prodotto SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata con tariffe contrattuali a livelli per un prodotto SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "120.00"
},
{
"DimensionKey": "PremiumService",
"Price": "200.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Disallowed",
"QuantityConfiguration": "Disallowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test private offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test private offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "120.00"
},
{
"DimensionKey": "PremiumService",
"Price": "200.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Disallowed",
"QuantityConfiguration": "Disallowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a private offer with tiered contract pricing for my SaaS product
CAPI-XX
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Create private offer with tiered contract pricing for my SaaS product",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta di prova gratuita pubblica con prezzi di abbonamento per un prodotto SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta pubblica gratuita con tariffe di sottoscrizione per un prodotto SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public free trial offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public free trial offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Free",
"Terms": [
{
"Type": "FreeTrialPricingTerm",
"Duration": "P20D",
"Grants": [
{
"DimensionKey": "WorkloadSmall"
},
{
"DimensionKey": "WorkloadMedium"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "prod-1111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public free trial offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public free trial offer with subscription pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Free",
"Terms": [
{
"Type": "FreeTrialPricingTerm",
"Duration": "P20D",
"Grants": [
{
"DimensionKey": "WorkloadSmall"
},
{
"DimensionKey": "WorkloadMedium"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a public free trial offer with subscription pricing for SaaS product
CAPI-13
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Create public free trial offer with subscription pricing for SaaS product",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un'offerta privata sostitutiva a partire da un accordo esistente con prezzi contrattuali utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un’offerta privata sostitutiva a partire da un accordo esistente con tariffe contrattuali.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateReplacementOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateReplacementOffer",
"DetailsDocument": {
"AgreementId": "agmt-1111111111111111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test replacement offer for SaaSProduct using AWS Marketplace API Reference Codes",
"Description": "Test private replacement offer with contract pricing for SaaSProduct"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Grants": [
{
"DimensionKey": "BasicService",
"MaxQuantity": 2
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementEndDate": "2024-01-30"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "0"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType" : "CreateReplacementOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateReplacementOffer",
"DetailsDocument": {
"AgreementId": "agmt-1111111111111111111111111"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test replacement offer for SaaSProduct using AWS Marketplace API Reference Codes",
"Description": "Test private replacement offer with contract pricing for SaaSProduct"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.0",
"Grants": [
{
"DimensionKey": "BasicService",
"MaxQuantity": 2
}
]
}
]
}
},
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementEndDate": "2024-01-30"
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2024-01-01",
"ChargeAmount": "0"
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateReplacementOffer.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a replacement private offer
from an existing agreement with contract pricing
CAPI-95
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create replacement private offer with contract pricing..",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Descrivi un'offerta pubblica utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come descrivere un’offerta pubblica.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
public class DescribeEntity {
/*
* Describe my AMI or SaaS or Container product and check if it contains all the information I need to know about the product
*/
public static void main(String[] args) {
String offerId = args.length > 0 ? args[0] : OFFER_ID;
DescribeEntityResponse describeEntityResponse = getDescribeEntityResponse(offerId);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
public static DescribeEntityResponse getDescribeEntityResponse(String offerId) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(offerId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
return describeEntityResponse;
}
}
```
+ Per i dettagli sull'API, consulta la [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) search for offer information in the AWS Marketplace Catalog
CAPI-29
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
OFFER_ID = "offer-1111111111111"
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
def get_offer_information(mp_client, entity_id):
"""
Returns information about a given offer
Args: entity_id str: Entity to return
Returns: dict: Dictionary of offer information
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace",
EntityId=entity_id,
)
return response
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Offer with ID %s not found.", entity_id)
else:
logger.error("Unexpected error: %s", e)
def usage_demo():
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Looking for an offer in the AWS Marketplace Catalog.")
print("-" * 88)
mp_client = boto3.client("marketplace-catalog")
pretty_print(get_offer_information(mp_client, OFFER_ID))
if __name__ == "__main__":
usage_demo()
```
+ Per i dettagli sull'API, consulta [DescribeEntity AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/DescribeEntity)*SDK for Python (Boto3) API Reference*.
------
# Far scadere un'offerta privata utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come impostare la data di scadenza di un’offerta privata su una data precedente in modo che gli acquirenti non vedano più l’offerta.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-01-01"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "Test Private Offer"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create “draft” Private Offer
for any AMI or SAAS product type that can be reviewed internally
before publishing to buyers
CAPI-30
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Private offer for AMI product")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Elenca tutte le offerte private utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come elencare tutte le offerte private.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferAvailabilityEndDateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferAvailabilityEndDateFilterDateRange;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferBuyerAccountsFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferReleaseDateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferReleaseDateFilterDateRange;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListAllPrivateOffers {
/*
* List all my private offers and sort or filter them by Offer Publish Date, Offer Expiry Date and Buyer IDs
*
* OfferTargetingFilter = BuyerAccounts (private offer);
* OfferBuyerAccountsFilter: Buyer IDs filter
* OfferAvailabilityEndDateFilter : Offer Expiry Date filter
* OfferReleaseDateFilter : Offer Publish Date filter
*/
private static MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
public static void main(String[] args) {
String offerReleaseDateAfterValue = "2023-01-01T23:59:59Z";
String offerAvailableEndDateAfterValue = "2040-12-24T23:59:59Z";
List entitySummaryList = getEntitySummaryList(offerReleaseDateAfterValue, offerAvailableEndDateAfterValue);
// for each offer id, output the offer detail using DescribeEntity API
for (EntitySummary entitySummary : entitySummaryList) {
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(entitySummary.entityId())
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
}
public static List getEntitySummaryList (String offerReleaseDateAfterValue, String offerAvailableEndDateAfterValue) {
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_BUYERACCOUNTS)
.build())
.buyerAccounts(OfferBuyerAccountsFilter.builder()
.wildCardValue(BUYER_ACCOUNT_ID)
.build())
.availabilityEndDate(OfferAvailabilityEndDateFilter.builder()
.dateRange(OfferAvailabilityEndDateFilterDateRange.builder()
.afterValue(offerAvailableEndDateAfterValue).build())
.build())
.releaseDate(OfferReleaseDateFilter.builder()
.dateRange(OfferReleaseDateFilterDateRange.builder()
.afterValue(offerReleaseDateAfterValue)
.build())
.build())
.build())
.build();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER).maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
List entitySummaryList = new ArrayList();
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
return entitySummaryList;
}
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) for listing offers in the AWS Marketplace Catalog
CAPI-40
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
# Constants
MAX_RESULTS = 10
CATALOG = "AWSMarketplace"
ENTITY_TYPE = "Offer"
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
def list_private_offers(mp_client, return_all_private_offers):
"""
This method retrieves list of all Private Offers for this account.
"""
entity_summary_list = []
filter_list_param = {
'OfferFilters': {
'Targeting': {
'ValueList': ["BuyerAccounts"]
}
}
}
try:
response = mp_client.list_entities(
Catalog=CATALOG,
EntityType=ENTITY_TYPE,
EntityTypeFilters=filter_list_param,
MaxResults=MAX_RESULTS
)
except ClientError as e:
logger.error("Could not complete list_entities request: %s", e)
raise
entity_summary_list.extend(response["EntitySummaryList"])
logger.info("Number of results in first iteration: %d " % len(entity_summary_list))
# Get subsequent pages of results if previous response contained a NextToken
while "NextToken" in response and return_all_private_offers:
try:
logger.info("Getting Next Token results: %s " % response["NextToken"])
response = mp_client.list_entities(
Catalog=CATALOG,
EntityType=ENTITY_TYPE,
EntityTypeFilters=filter_list_param,
MaxResults=MAX_RESULTS,
NextToken=response["NextToken"]
)
except ClientError as e:
logger.error("Could not complete list_entities request: %s", e)
raise
entity_summary_list.extend(response["EntitySummaryList"])
logger.info(
"Number of results in the current iteration: %d "
% len(response["EntitySummaryList"])
)
return entity_summary_list
def get_offer_details(mp_client, offer):
"""
Describe the details of the Offer.
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace", EntityId=offer["EntityId"]
)
return response
except ClientError:
logger.exception("Error: Couldn't get details of the Offer.")
raise
def usage_demo():
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Demo - List Private offers.")
print("-" * 88)
mp_client = boto3.client("marketplace-catalog")
# Get list of all Offers.
private_offers = list_private_offers(mp_client, False)
count = len(private_offers)
logger.info("Number of Offers: %d " % count)
offer_counter = 0
# Display details of each Offer.
for offer in private_offers:
print("-" * 88)
offer_counter += 1
print("Displaying Offer details for Offer# %d" % offer_counter)
entity = get_offer_details(mp_client, offer)
pretty_print(entity)
print("-" * 88)
if __name__ == "__main__":
usage_demo()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Elenca le offerte pubbliche e private rilasciate per un ID di prodotto specifico utilizzando un SDK AWS
L’esempio di codice seguente mostra come elencare le offerte pubbliche e private pubblicate per un ID prodotto specifico.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferProductIdFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferStateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListProductPublicOrPrivateReleasedOffers {
/*
* List released Public/Private offers for a specific product id.
* Example below is to list released public offers.
* To change to released private offers, change OFFER_TARGETING_NONE (None) to OFFER_TARGETING_BUYERACCOUNTS(BuyerAccounts)
*/
public static void main(String[] args) {
List entitySummaryList = getEntitySummaryLIst();
ReferenceCodesUtils.formatOutput(entitySummaryList);
}
public static List getEntitySummaryLIst() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
// define list entities filters
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_NONE)
.build())
.state(OfferStateFilter.builder()
.valueListWithStrings(OFFER_STATE_RELEASED)
.build())
.productId(OfferProductIdFilter.builder()
.valueList(PRODUCT_ID)
.build())
.build())
.build();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
// save all entitySummary of the results into entitySummaryList
List entitySummaryList = new ArrayList();
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
return entitySummaryList;
}
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
# Aggiorna un'offerta per applicare un contratto con Pay-As-You-Go prezzi utilizzando un AWS SDK
I seguenti esempi di codice mostrano come aggiornare un'offerta per applicare un contratto con Pay-As-You-Go prezzi.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da sapere GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update an offer to apply contract with PAYG pricing
CAPI-21
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update offer to apply contract with PAYG pricing")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna un'offerta per applicare prezzi orari annuali utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare un’offerta per applicare la tariffa oraria annua.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m5.large",
"Price": "0.13"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m5.large",
"Price": "20.03"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m5.large",
"Price": "0.13"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m5.large",
"Price": "20.03"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update an offer to apply hourly annual pricing
CAPI-20
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update offer with hourly annual pricing")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna un'offerta per applicare il targeting a aree geografiche specifiche utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare un’offerta per applicare il targeting ad aree geografiche specifiche.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"ES",
"FR",
"AU"
]
}
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"ES",
"FR",
"AU"
]
}
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update an offer to apply targeting to certain geographic regions.
CAPI-19
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update offer targeting")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna il nome e la descrizione di un'offerta pubblica utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare il nome e la descrizione di un’offerta pubblica.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update name and description of my offer
CAPI-18
"""
import os
import utils.start_changeset as sc # type: ignore
import utils.stringify_details as sd # type: ignore
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update name and description of my offer")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna l'EULA di un'offerta utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare il contratto di licenza con l’utente finale (EULA) di un’offerta.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update EULA of my offer
CAPI-18
"""
import os
import utils.start_changeset as sc # type: ignore
import utils.stringify_details as sd # type: ignore
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update EULA of my offer")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna la data di scadenza di un'offerta privata a una data futura utilizzando un AWS SDK
Gli esempi di codice seguenti mostrano come aggiornare la data di scadenza di un’offerta privata impostandola su una data futura per dare agli acquirenti più tempo per valutare e accettare l’offerta.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2026-01-01"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2026-01-01"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to set expiry date of a private offer to a date in the future so that my buyers get more time to evaluate and accept the offer.
CAPI-37
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update offer expiration date")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna la durata della prova gratuita di un'offerta di prova gratuita pubblica per un prodotto SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare la durata della prova gratuita di un’offerta di prova gratuita pubblica per un prodotto SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "FreeTrialPricingTerm",
"Duration": "P21D",
"Grants": [
{
"DimensionKey": "WorkloadSmall"
},
{
"DimensionKey": "WorkloadMedium"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "FreeTrialPricingTerm",
"Duration": "P21D",
"Grants": [
{
"DimensionKey": "WorkloadSmall"
},
{
"DimensionKey": "WorkloadMedium"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to change free trial duration for my SaaS product by modifying my free trial public offer
CAPI-14
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Change free trial duration for SaaS product")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna la politica di rimborso di un'offerta utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare la policy di rimborso di un’offerta.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update refund policy of my offer
CAPI-18
"""
import os
import utils.start_changeset as sc # type: ignore
import utils.stringify_details as sd # type: ignore
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Update refund policy of my public offer")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Prodotti per Catalog API Marketplace AWS
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Descrivere un prodotto AMI, SaaS o container](marketplace-catalog_example_marketplace-catalog_DescribeProduct_section.md)
+ [Elencare tutti i prodotti AMI, SaaS o container e le offerte pubbliche associate](marketplace-catalog_example_marketplace-catalog_ListProducts_section.md)
# Descrivi un prodotto AMI, SaaS o Container utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come descrivere un prodotto AMI, SaaS o container e verificare se contiene tutte le informazioni desiderate sul prodotto.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
public class DescribeEntity {
/*
* Describe my AMI or SaaS or Container product and check if it contains all the information I need to know about the product
*/
public static void main(String[] args) {
String offerId = args.length > 0 ? args[0] : OFFER_ID;
DescribeEntityResponse describeEntityResponse = getDescribeEntityResponse(offerId);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
public static DescribeEntityResponse getDescribeEntityResponse(String offerId) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(offerId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
return describeEntityResponse;
}
}
```
+ Per i dettagli sull'API, consulta la [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) search for product information in the AWS Marketplace Catalog
CAPI-28
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
PRODUCT_ID = "prod-1111111111111"
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
def get_product_information(mp_client, entity_id):
"""
Returns information about a given product
Args: entity_id str: Entity to return
Returns: dict: Dictionary of product information
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace",
EntityId=entity_id,
)
return response
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Product with ID %s not found.", entity_id)
else:
logger.error("Unexpected error: %s", e)
def usage_demo():
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Looking for a product in the AWS Marketplace Catalog.")
print("-" * 88)
mp_client = boto3.client("marketplace-catalog")
pretty_print(get_product_information(mp_client, PRODUCT_ID))
if __name__ == "__main__":
usage_demo()
```
+ Per i dettagli sull'API, consulta [DescribeEntity AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/DescribeEntity)*SDK for Python (Boto3) API Reference*.
------
# Elenca tutti i prodotti AMI, SaaS o Container e le offerte pubbliche associate utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come elencare tutti i prodotti AMI, SaaS o container e le offerte pubbliche associate.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferProductIdFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferStateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListEntities {
/*
* List all my AMI or SaaS or Container products and associated public offers
*/
public static void main(String[] args) {
Map> allProductsWithOffers = getAllProductsWithOffers();
ReferenceCodesUtils.formatOutput(allProductsWithOffers);
}
public static Map> getAllProductsWithOffers() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
Map> allProductsWithOffers = new HashMap> ();
// get all product entities
List productEntityList = new ArrayList();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(PRODUCT_TYPE_AMI)
.maxResults(10)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
productEntityList.addAll(listEntitiesResponse.entitySummaryList());
while (listEntitiesResponse.nextToken() != null) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(PRODUCT_TYPE_AMI)
.maxResults(10)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
productEntityList.addAll(listEntitiesResponse.entitySummaryList());
}
// loop through each product entity and get the public released offers associated using product id filter
for ( EntitySummary productEntitySummary : productEntityList) {
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_NONE)
.build())
.state(OfferStateFilter.builder()
.valueListWithStrings(OFFER_STATE_RELEASED)
.build())
.productId(OfferProductIdFilter.builder()
.valueList(productEntitySummary.entityId())
.build())
.build())
.build();
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
// save all entitySummary of the results into entitySummaryList
List offerEntitySummaryList = new ArrayList();
offerEntitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
offerEntitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
// save final results into map; key = product id; value = offer entity summary list
allProductsWithOffers.put(productEntitySummary.entityId(), offerEntitySummaryList);
}
return allProductsWithOffers;
}
}
```
+ Per informazioni dettagliate sull’API, consulta i seguenti argomenti nella *documentazione di riferimento dell’API AWS SDK for Java 2.x *.
+ [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)
+ [ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è dell'altro GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to display information about AMI products and their associated offers in the AWS Marketplace Catalog
CAPI-27
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
MAX_PAGE_RESULTS = 10
try:
mp_client = boto3.client("marketplace-catalog")
except ClientError as e:
logger.error("Could not create boto3 client.")
raise
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
def describe_entity(entity_id):
"""
Returns entity details
Args: entity_id str: The entity ID of the product or offer
Returns: dict: The entity details
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace", EntityId=entity_id
)
except ClientError as e:
logger.error("Could not complete describe_entity request.")
raise
# De-stringify the details
response["Details"] = json.loads(response["Details"])
return response
def get_entities(entity_type, visibility=None):
"""
Returns list of entities for provided entity_type
Args: entity_type str: Type of entity list to return, in our case AmiProduct or Offer
Returns: list: Abbreviated list of entity information
"""
EntitySummaryList = []
# Get the first page of results
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType=entity_type,
MaxResults=MAX_PAGE_RESULTS,
)
except ClientError as e:
logger.error("Could not complete list_entities request.")
raise
EntitySummaryList.extend(response["EntitySummaryList"])
# Get subsequent pages of results if previous response contained a NextToken
while "NextToken" in response:
try:
response = mp_client.list_entities(
Catalog="AWSMarketplace",
EntityType=entity_type,
MaxResults=MAX_PAGE_RESULTS,
NextToken=response["NextToken"],
)
except ClientError as e:
logger.error("Could not complete list_entities request.")
raise
EntitySummaryList.extend(response["EntitySummaryList"])
# if visibility is provided, filter the list to only include entities with that visibility
if visibility is not None:
EntitySummaryList = [
entity for entity in EntitySummaryList if entity["Visibility"] == visibility
]
return EntitySummaryList
def get_enhanced_product_list(entity_type):
"""
Returns an enhanced list of products with product details and offer details
Args: entity_type str: Type of entity list to return, in our case AmiProduct
Returns: list: Enhanced list of dictionary objects containing product and offer details
"""
product_list = get_entities(entity_type)
# Loop through product list and append product details to each product
for product in product_list:
# appends product details to product dictionary
product["ProductDetails"] = describe_entity(product["EntityId"])["Details"]
# creating an empty list for offer details
product["OfferDetailsList"] = []
return product_list
def attach_offer_details(product_list):
"""
Loops through offer information and appends offer details to product list
Args: product_list list: List of product dictionaries
Returns: list: Enhanced list of dictionary objects containing product and offer details
"""
offer_list = get_entities("Offer", "Public")
# Loop through offer list and append offer details to each product
for offer in offer_list:
offer["OfferDetails"] = describe_entity(offer["EntityId"])["Details"]
# Extracts product-id from offer
product_id = offer["OfferDetails"]["ProductId"]
# Determines if product-id referenced in offer matches product-id in product list
product_dict = next(
filter(lambda product: product["EntityId"] == product_id, product_list),
None,
)
# If product-id matches, appends offer details to product dictionary
if product_dict is not None:
# logger.info(f"Offer product Id {offer['OfferDetails']['ProductId']} found in product dictionary. Updating product dictionary with offer details")
product_dict["OfferDetailsList"].append(offer["OfferDetails"])
else:
# logger.info("Offer product Id {offer['OfferDetails']['ProductId']} not found. Skipping offer details update")
pass
return product_list
def usage_demo():
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Retrieving products and public offer information....")
print("-" * 88)
# Builds a list of products and their details
product_list = get_enhanced_product_list("AmiProduct")
# Queries offer information and attaches it to the product list
product_offer_list = attach_offer_details(product_list)
pretty_print(product_offer_list)
return product_offer_list
if __name__ == "__main__":
usage_demo()
```
+ Per informazioni dettagliate sull’API, consulta i seguenti argomenti nella *documentazione di riferimento dell’API AWS SDK per Python (Boto3)*.
+ [DescribeEntity](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/DescribeEntity)
+ [ListEntities](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/ListEntities)
------
# Autorizzazione alla rivendita per Marketplace AWS Catalog API
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Creare una bozza di autorizzazione di rivendita](marketplace-catalog_example_marketplace-catalog_DraftResaleauthAllproducttype_section.md)
+ [Descrivere un’autorizzazione di rivendita](marketplace-catalog_example_marketplace-catalog_DescribeResaleAuthorization_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum con un’offerta privata](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthPrivateoffer_section.md)
+ [Pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthExpirydateCppo_section.md)
+ [Pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza e un’EULA](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthExpirydateCustomEula_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso con una data di scadenza e la documentazione dell’accordo del rivenditore](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthExpirydateCustomresellerContractdoc_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso con scadenza e aggiungere un account acquirente specifico](marketplace-catalog_example_marketplace-catalog_PublishMultiuseResaleAuthorizationExpirydateSpecificBuyer_section.md)
+ [Pubblicare un’autorizzazione di rivendita multiuso senza una data di scadenza](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthNoExpirydateCppo_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso senza una data di scadenza e un’EULA](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthNoExpirydateCustomEula_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso senza una data di scadenza e la documentazione dell’accordo del rivenditore](marketplace-catalog_example_marketplace-catalog_MultiuseResaleauthNoExpirydateCustomresellerContractdoc_section.md)
+ [Pubblicare l’autorizzazione di rivendita multiuso senza data di scadenza e aggiungere un account acquirente specifico](marketplace-catalog_example_marketplace-catalog_PublishMultiuseResaleAuthorizationNoExpirydateSpecificBuyer_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum e aggiungere un piano di pagamento flessibile](marketplace-catalog_example_marketplace-catalog_PublishOnetimeResaleAuthorizationFlexiblePayment_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum e aggiungere un’EULA](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthCustomEula_section.md)
+ [Pubblicare l’autorizzazione di rivendita una tantum e aggiungere un account acquirente specifico](marketplace-catalog_example_marketplace-catalog_PublishOnetimeResaleAuthorizationSpecificBuyer_section.md)
+ [Pubblicare l’autorizzazione di rivendita una tantum e aggiungere la documentazione dell’accordo del rivenditore](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthCustomresellerContractdoc_section.md)
+ [Pubblicare un’autorizzazione di rivendita una tantum e specificare se si tratta di un rinnovo](marketplace-catalog_example_marketplace-catalog_OnetimeResaleauthRenewal_section.md)
+ [Limitare l’autorizzazione di rivendita](marketplace-catalog_example_marketplace-catalog_RestrictResaleAuthorization_section.md)
+ [Aggiornare il nome e la descrizione dell’autorizzazione di rivendita una tantum o multiuso](marketplace-catalog_example_marketplace-catalog_UpdateUnpublishedResaleAuthorization_section.md)
# Crea una bozza di autorizzazione alla rivendita per qualsiasi tipo di prodotto utilizzando un SDK AWS
I seguenti esempi di codice mostrano come creare bozze di autorizzazione di rivendita per qualsiasi tipo di prodotto in modo da poterle esaminare internamente prima della pubblicazione per un partner di canale.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a one-time resale authorization on my SaaS/AMI/Container product so my CP can use that to create Channel Partner Private Offer (CPPO)
CAPI-41
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "draft resale auth")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Descrivi un'autorizzazione alla rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come descrivere un’autorizzazione di rivendita.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
public class DescribeEntity {
/*
* Describe my AMI or SaaS or Container product and check if it contains all the information I need to know about the product
*/
public static void main(String[] args) {
String offerId = args.length > 0 ? args[0] : OFFER_ID;
DescribeEntityResponse describeEntityResponse = getDescribeEntityResponse(offerId);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
public static DescribeEntityResponse getDescribeEntityResponse(String offerId) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(offerId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
return describeEntityResponse;
}
}
```
+ Per i dettagli sull'API, consulta la [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è di più su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) search for product information in the AWS Marketplace Catalog
"""
import json
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
resaleAuthorizationId = "resaleauthz-1111111111111"
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
def get_product_information(mp_client, entity_id):
"""
Returns information about a given product
Args: entity_id str: Entity to return
Returns: dict: Dictionary of product information
"""
try:
response = mp_client.describe_entity(
Catalog="AWSMarketplace",
EntityId=entity_id,
)
return response
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceNotFoundException":
logger.error("Product with ID %s not found.", entity_id)
else:
logger.error("Unexpected error: %s", e)
def usage_demo():
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Looking for a product in the AWS Marketplace Catalog.")
print("-" * 88)
mp_client = boto3.client("marketplace-catalog")
pretty_print(get_product_information(mp_client, resaleAuthorizationId))
if __name__ == "__main__":
usage_demo()
```
+ Per i dettagli sull'API, consulta [DescribeEntity AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/DescribeEntity)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita una tantum con un'offerta privata utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita una tantum con un’offerta privata in modo che un partner di canale possa utilizzarla per creare un’offerta CPPO (Channel Partner Private Offer) privata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
}
]
}
```
+ Per i dettagli sull'API, consulta la [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)sezione *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a one-time resale authorization on my SaaS/AMI/Container product so my CP
can use that to create Channel Partner Private Offer (CPPO)
CAPI-42
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set, "onetime resale auth with private offer"
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita multiuso con una data di scadenza utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza per un prodotto AMI con tariffe orarie annuali in modo che un partner di canale possa utilizzarla per creare un’offerta CPPO.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a multi-use resale authorization with expiry date on my SaaS/AMI product so my CP can use that to create Channel Partner Private Offer (CPPO)
CAPI-48
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "multi-use resale auth with expiry date")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita multiuso con una data di scadenza e un EULA da inviare all'acquirente tramite un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza per qualsiasi tipo di prodotto e aggiungere un contratto di licenza con l’utente finale (EULA) personalizzato da inviare all’acquirente.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a multi-use resale authorization with expiry date on my SaaS/AMI/Container product and add custom EULA to be sent to the buyer
CAPI-56
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "multiuse resale auth with expiry date and custom EULA")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica l'autorizzazione alla rivendita multiuso con una data di scadenza e aggiungi la documentazione del contratto di rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza per qualsiasi tipo di prodotto e aggiungere la documentazione per il contratto del rivenditore tra fornitore di software indipendente (ISV) e partner di canale.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents": [
{
"Type": "CustomResellerContract",
"Url": "https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf"}
]
}
]
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-12-31"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents": [
{
"Type": "CustomResellerContract",
"Url": "https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf"}
]
}
]
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleUsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "t2.micro",
"Price": "150"
}
]
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a multi-use resale authorization with expiry date on my SaaS/AMI/Container product
and add reseller contract documentation between the ISV and channel partner
CAPI-57
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"multi use resale auth with contract doc",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica l'autorizzazione di rivendita multiuso con scadenza e aggiungi un account acquirente specifico per la rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso con una data di scadenza per qualsiasi tipo di prodotto e aggiungere un account acquirente specifico per la rivendita.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-05-31"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish multi-use resale authorization with expiry date for any product type (AMI/SaaS/Container) and add specific buyer account for the resale
CAPI-82
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Publish multi-use resale authorization with expiry date and add specific buyer account",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica l'autorizzazione di rivendita multiuso senza una data di scadenza utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso senza una data di scadenza per un prodotto AMI con tariffe orarie annuali in modo che un partner di canale possa utilizzarla per creare un’offerta CPPO.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a multi-use resale authorization with no expiry date on my SaaS/AMI product so my CP can use that to create Channel Partner Private Offer (CPPO)
CAPI-52
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "multi use resale auth with no expiry date")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita multiuso senza data di scadenza e aggiungi un EULA personalizzato utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso senza una data di scadenza per qualsiasi tipo di prodotto e aggiungere un contratto di licenza con l’utente finale (EULA) personalizzato da inviare all’acquirente.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a multi-use resale authorization with no expiry date on my SaaS/AMI/Container product and add custom EULA to be sent to the buyer
CAPI-58
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "multi use resale auth with no expiry date and custom EULA"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica l'autorizzazione alla rivendita multiuso senza data di scadenza e aggiungi la documentazione del contratto di rivenditore utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso senza una data di scadenza per qualsiasi tipo di prodotto e aggiungere la documentazione per il contratto del rivenditore tra fornitore di software indipendente (ISV) e partner di canale.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents": [
{
"Type": "CustomResellerContract",
"Url": "https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents": [
{
"Type": "CustomResellerContract",
"Url": "https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a multi-use resale authorization with no expiry date on my SaaS/AMI/Container product and add reseller contract documentation between the ISV and channel partner
CAPI-59
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set, "multi use resale auth with no expiry date and contract doc"
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica l'autorizzazione di rivendita multiuso senza data di scadenza e aggiungi un account acquirente specifico per la rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita multiuso senza una data di scadenza per qualsiasi tipo di prodotto e aggiungere un account acquirente specifico per la rivendita.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish multi-use resale authorization without expiry date for any product type (AMI/SaaS/Container) and add specific buyer account for the resale
CAPI-83
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"publish multi-use resale authorization without expiry date and add specific buyer account",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita una tantum e aggiungi un piano di pagamento flessibile utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e aggiungere un piano di pagamento flessibile.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleFixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.00",
"Duration": "P12M",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ResalePaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2023-09-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2023-12-01",
"ChargeAmount": "250.00"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-06-30",
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleFixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "0.00",
"Duration": "P12M",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
}
]
}
},
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ResalePaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2023-09-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2023-12-01",
"ChargeAmount": "250.00"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-06-30",
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish one-time resale authorization for any product type (AMI/SaaS/Container) and add Flexible payment schedule
CAPI-78
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "onetime resale auth with flexible payment schedule")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e aggiungi un EULA utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e aggiungere un contratto di licenza con l’utente finale (EULA) personalizzato da inviare all’acquirente.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a one-time resale authorization on my SaaS/AMI/Container product and add custom EULA to be sent to the buyer
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "onetime resale auth with custom EULA")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita una tantum e aggiungi un account acquirente specifico per la rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e aggiungere un account acquirente specifico per la rivendita.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": "1"
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111"
]
}
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish one-time resale authorization for any product type (AMI/SaaS/Container) and add specific buyer account for the resale
CAPI-81
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "onetime resale authorization for specific buyer account")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e aggiungi la documentazione del contratto di rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e aggiungere la documentazione per il contratto del rivenditore tra fornitore di software indipendente (ISV) e partner di canale.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
}
]
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "ReleaseResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ResaleConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "t2.small",
"Price": "150"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerLegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/sample-bucket/custom-eula.pdf"
}
]
},
{
"Type": "ResaleLegalTerm",
"Documents": [
{
"Type": "CustomResellerContract",
"Url": "https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf"
}
]
}
]
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish a one-time resale authorization on my SaaS/AMI/Container product and add reseller contract documentation between the ISV and channel partner
CAPI-47
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "onetime resale auth with reseller contract doc")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un'autorizzazione di rivendita una tantum per e aggiungi se si tratta di un rinnovo utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un’autorizzazione di rivendita una tantum per qualsiasi tipo di prodotto e specificare se si tratta di un rinnovo.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"222222222222"
]
}
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType":"UpdateInformation",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"PreExistingBuyerAgreement": {
"AcquisitionChannel": "AwsMarketplace",
"PricingModel": "Contract"
}
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateResaleAuthorization",
"ChangeName": "ResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"ResellerAccountId": "111111111111"
}
},
{
"ChangeType": "UpdateBuyerTargetingTerms",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "BuyerTargetingTerm",
"PositiveTargeting": {
"BuyerAccounts": [
"222222222222"
]
}
}
]
}
},
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"OffersMaxQuantity": 1
}
},
{
"ChangeType":"UpdateInformation",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "$ResaleAuthorization.Entity.Identifier"
},
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product",
"PreExistingBuyerAgreement": {
"AcquisitionChannel": "AwsMarketplace",
"PricingModel": "Contract"
}
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish one-time resale authorization for any product type (AMI/SaaS/Container)
and add whether it is renewal or not
CAPI-90
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(stringified_change_set, "onetime resale auth renewal")
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Limita l'autorizzazione alla rivendita utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come limitare un’autorizzazione di rivendita.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Restrict a authorization for any product type (AMI/SaaS/Container)
CAPI-84
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "Restrict resale authorization")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Aggiorna il nome e la descrizione dell'autorizzazione di rivendita monouso o multiuso utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare il nome e la descrizione dell’autorizzazione di rivendita una tantum o multiuso prima della pubblicazione per qualsiasi tipo di prodotto.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"UpdateInformation",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product"
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"UpdateInformation",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Update name/description of one-time or multi-use resale authorization before publishing for any product type (AMI/SaaS/Container)
CAPI-77
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"update name and description of one-time or multi-use resale authorization before publishing",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Prodotti SaaS per Catalog API Marketplace AWS
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Creare una bozza di prodotto SaaS con una bozza di offerta pubblica](marketplace-catalog_example_marketplace-catalog_CreateDraftSaasProductWithDraftPublicOffer_section.md)
+ [Creare un prodotto SaaS pubblico o limitato e un’offerta pubblica con tariffe contrattuali](marketplace-catalog_example_marketplace-catalog_CreateLimitedSaasProductAndPublicOfferWithContractPricing_section.md)
+ [Crea un prodotto SaaS pubblico o limitato e un'offerta pubblica con contratto con prezzi Pay-As-You-Go](marketplace-catalog_example_marketplace-catalog_CreateLimitedSaasProductAndPublicOfferWithContractWithPayAsYouGoPricing_section.md)
+ [Creare un prodotto SaaS pubblico o limitato e un’offerta pubblica con tariffe di sottoscrizione](marketplace-catalog_example_marketplace-catalog_CreateLimitedSaasProductAndPublicOfferWithSubscriptionPricing_section.md)
+ [Pubblicare un prodotto SaaS e un’offerta pubblica associata](marketplace-catalog_example_marketplace-catalog_PublishSaasProductPublicOffer_section.md)
+ [Pubblicare un prodotto SaaS e un’offerta pubblica associata da una bozza esistente](marketplace-catalog_example_marketplace-catalog_PublishExistingSaas_section.md)
+ [Aggiornare le dimensioni in un’AMI o un prodotto SaaS](marketplace-catalog_example_marketplace-catalog_UpdateNameDimensionSaasProduct_section.md)
# Crea una bozza di prodotto SaaS con una bozza di offerta pubblica utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare una bozza di prodotto SaaS con una bozza di offerta pubblica.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog":"AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"DetailsDocument": {
"ProductTitle": "Sample product"
}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier",
"Name": "Test Offer"
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog":"AWSMarketplace",
"ChangeSet":[
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier",
"Name": "Test Offer"
}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create an SaaS draft product
with a draft public offer.
CAPI-04
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Create a draft saas product with a draft public offer",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto SaaS pubblico o limitato e un'offerta pubblica con prezzi contrattuali utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un prodotto SaaS pubblico o con limitazioni e un’offerta pubblica con tariffe contrattuali. Questo esempio crea un’EULA standard o personalizzata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"ChangeName": "CreateProductChange",
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl":"https://sample.amazonaws.com/sample-saas-fulfillment-url"
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Description": "Basic Service",
"Name": "Basic Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "PremiumService",
"Description": "Premium Service",
"Name": "Premium Service",
"Types": [
"Entitled"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with contract pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P1M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "20"
},
{
"DimensionKey": "PremiumService",
"Price": "25"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
},
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"ChangeName": "CreateProductChange",
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl":"https://sample.amazonaws.com/sample-saas-fulfillment-url"
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Description": "Basic Service",
"Name": "Basic Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "PremiumService",
"Description": "Premium Service",
"Name": "Premium Service",
"Types": [
"Entitled"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with contract pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P1M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "20"
},
{
"DimensionKey": "PremiumService",
"Price": "25"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
},
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a
public or limited SaaS product and public offer with contract pricing and standard EULA
CAPI-11
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Create a limited saas product with a public offer with contract pricing",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto SaaS pubblico o limitato e un'offerta pubblica con contratto e Pay-As-You-Go prezzi utilizzando un SDK AWS
I seguenti esempi di codice mostrano come creare un prodotto SaaS pubblico o limitato e un'offerta pubblica con un contratto con Pay-As-You-Go prezzi. Questo esempio crea un’EULA standard o personalizzata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro su. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"ChangeName": "CreateProductChange",
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl":"https://sample.amazonaws.com/sample-saas-fulfillment-url"
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Description": "Basic Service",
"Name": "Basic Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "PremiumService",
"Description": "Premium Service",
"Name": "Premium Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "WorkloadSmall",
"Description": "Workload: Per medium instance",
"Name": "Workload: Per medium instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
},
{
"Key": "WorkloadMedium",
"Description": "Workload: Per large instance",
"Name": "Workload: Per large instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with contract pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"ChangeName": "CreateProductChange",
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl":"https://sample.amazonaws.com/sample-saas-fulfillment-url"
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Description": "Basic Service",
"Name": "Basic Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "PremiumService",
"Description": "Premium Service",
"Name": "Premium Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "WorkloadSmall",
"Description": "Workload: Per medium instance",
"Name": "Workload: Per medium instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
},
{
"Key": "WorkloadMedium",
"Description": "Workload: Per large instance",
"Name": "Workload: Per large instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with contract pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a
public or limited SaaS product and public offer with contract with PAYG pricing and standard EULA
CAPI-10
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(
change_set,
"Create limited SaaS product with public offer with contract with payg pricing",
)
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Crea un prodotto SaaS pubblico o limitato e un'offerta pubblica con prezzi di abbonamento utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come creare un prodotto SaaS pubblico o con limitazioni e un’offerta pubblica con tariffe di sottoscrizione. Questo esempio crea un’EULA standard o personalizzata.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"ChangeName": "CreateProductChange",
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl":"https://sample.amazonaws.com/sample-saas-fulfillment-url"
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "WorkloadSmall",
"Description": "Workload: Per medium instance",
"Name": "Workload: Per medium instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
},
{
"Key": "WorkloadMedium",
"Description": "Workload: Per large instance",
"Name": "Workload: Per large instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with contract pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"ChangeName": "CreateProductChange",
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://s3.amazonaws.com/logos/sample.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"PositiveTargeting": {
"BuyerAccounts": [
"111111111111",
"222222222222"
]
}
}
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl":"https://sample.amazonaws.com/sample-saas-fulfillment-url"
}
}
}
]
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "WorkloadSmall",
"Description": "Workload: Per medium instance",
"Name": "Workload: Per medium instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
},
{
"Key": "WorkloadMedium",
"Description": "Workload: Per large instance",
"Name": "Workload: Per large instance",
"Types": [
"ExternallyMetered"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"ChangeName": "CreateOfferChange",
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "Test public offer for SaaSProduct using AWS Marketplace API Reference Code",
"Description": "Test public offer with contract pricing for SaaSProduct using AWS Marketplace API Reference Code"
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "WorkloadSmall",
"Price": "0.15"
},
{
"DimensionKey": "WorkloadMedium",
"Price": "0.25"
}
]
}
]
}
]
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Absolutely no refund, period."
}
]
}
},
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to create a
public or limited SaaS product and public offer with subscription(usage) pricing and standard EULA
CAPI-09
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
change_set = sd.stringify_changeset(change_set_file)
def main():
sc.usage_demo(change_set, "public saas public offer with subscription pricing")
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un prodotto SaaS e un'offerta pubblica associata utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come pubblicare un prodotto SaaS e l’offerta pubblica associata. Per impostazione predefinita, lo stato del prodotto sarà limitato.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog":"AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://bucketname.s3.amazonaws.com/logo.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Description": "Basic Service",
"Name": "Basic Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "PremiumService",
"Description": "Premium Service",
"Name": "Premium Service",
"Types": [
"Entitled"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl": "https://www.aws.amazon.com/marketplace/management"
}
}
}
]
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "New Test Offer",
"Description": "New offer description"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P1M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "20"
},
{
"DimensionKey": "PremiumService",
"Price": "25"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
},
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog":"AWSMarketplace",
"ChangeSet":[
{
"ChangeType": "CreateProduct",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0"
},
"DetailsDocument": {}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"ProductTitle": "Sample product",
"ShortDescription": "Brief description",
"LongDescription": "Detailed description",
"Highlights": [
"Sample highlight"
],
"SearchKeywords": [
"Sample keyword"
],
"Categories": [
"Data Catalogs"
],
"LogoUrl": "https://bucketname.s3.amazonaws.com/logo.png",
"VideoUrls": [
"https://sample.amazonaws.com/awsmp-video-1"
],
"AdditionalResources": []
}
},
{
"ChangeType": "AddDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Description": "Basic Service",
"Name": "Basic Service",
"Types": [
"Entitled"
],
"Unit": "Units"
},
{
"Key": "PremiumService",
"Description": "Premium Service",
"Name": "Premium Service",
"Types": [
"Entitled"
],
"Unit": "Units"
}
]
},
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {
"DeliveryOptions": [
{
"Details": {
"SaaSUrlDeliveryOptionDetails": {
"FulfillmentUrl": "https://www.aws.amazon.com/marketplace/management"
}
}
}
]
}
},
{
"ChangeType": "ReleaseProduct",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "$CreateProductChange.Entity.Identifier"
},
"DetailsDocument": {}
},
{
"ChangeType": "CreateOffer",
"ChangeName": "CreateOfferChange",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "$CreateProductChange.Entity.Identifier"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Name": "New Test Offer",
"Description": "New offer description"
}
},
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "StandardEula",
"Version": "2022-07-14"
}
]
}
]
}
},
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
},
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Contract",
"Terms": [
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P1M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "20"
},
{
"DimensionKey": "PremiumService",
"Price": "25"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
},
{
"Selector": {
"Type": "Duration",
"Value": "P12M"
},
"RateCard": [
{
"DimensionKey": "BasicService",
"Price": "150"
},
{
"DimensionKey": "PremiumService",
"Price": "300"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
}
]
}
},
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
},
{
"ChangeType":"ReleaseOffer",
"Entity":{
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {}
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Publish my SaaS product and associated public offer (product will be in limited state by default)
CAPI-05A
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset1.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"publish saas product and associated public offer",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Pubblica un prodotto SaaS e un'offerta pubblica associata da una bozza esistente utilizzando un SDK AWS
L’esempio di codice seguente mostra come pubblicare un prodotto SaaS e l’offerta pubblica associata da una bozza esistente. Per impostazione predefinita, lo stato del prodotto sarà limitato.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
```
{
"Catalog":"AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Public"
}
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
# Aggiorna le dimensioni su un prodotto AMI o SaaS utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come aggiornare le dimensioni per un prodotto AMI o SaaS.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Per eseguire questo esempio, passa il seguente set di modifiche JSON a `RunChangesets` in *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-111111111111"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Types": [
"Entitled"
],
"Name": "Some new name",
"Description": "Some new description"
}
]
}
]
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateDimensions",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-111111111111"
},
"DetailsDocument": [
{
"Key": "BasicService",
"Types": [
"Entitled"
],
"Name": "Some new name",
"Description": "Some new description"
}
]
}
]
}
```
Esegui questo script per avviare il set di modifiche. Le funzioni helper sono definite *Utilità per l’avvio di un set di modifiche* nella sezione **Utilità**.
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0
"""
Purpose
Shows how to use the AWS SDK for Python (Boto3) to update (e.g name) dimensions on my AMI or SaaS product
CAPI-24
"""
import os
import utils.start_changeset as sc
import utils.stringify_details as sd
def main(change_set=None):
if change_set is None:
fname = "changeset.json"
change_set_file = os.path.join(os.path.dirname(__file__), fname)
stringified_change_set = sd.stringify_changeset(change_set_file)
else:
stringified_change_set = change_set
response = sc.usage_demo(
stringified_change_set,
"Update name dimensions on my AMI or SaaS product",
)
return response
if __name__ == "__main__":
main()
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------
# Utilità per l'API Catalog Marketplace AWS
I seguenti esempi di codice mostrano come utilizzare l'API Marketplace AWS Catalog con AWS SDKs.
**Topics**
+ [Utilità per l’avvio di un set di modifiche](marketplace-catalog_example_marketplace-catalog_ChangeSetUtilities_section.md)
# Utilità per avviare un changeset utilizzando un SDK AWS
Gli esempi di codice seguenti mostrano come definire le utilità per l’avvio di un set di modifiche.
------
#### [ Java ]
**SDK per Java 2.x**
C'è altro da fare. GitHub Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code).
Utilità per il caricamento di un set di modifiche da un file JSON e l’avvio della relativa elaborazione.
```
package com.example.awsmarketplace.catalogapi;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import org.apache.commons.io.IOUtils;
import org.apache.commons.lang3.StringUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.core.document.Document;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.protocols.json.internal.unmarshall.document.DocumentUnmarshaller;
import software.amazon.awssdk.protocols.jsoncore.JsonNodeParser;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.Change;
import software.amazon.awssdk.services.marketplacecatalog.model.Entity;
import software.amazon.awssdk.services.marketplacecatalog.model.StartChangeSetRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.StartChangeSetResponse;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.ToNumberPolicy;
import com.example.awsmarketplace.catalogapi.Entity.ChangeSet;
import com.example.awsmarketplace.catalogapi.Entity.ChangeSetEntity;
import com.example.awsmarketplace.catalogapi.Entity.Root;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import com.example.awsmarketplace.utils.StringSerializer;
/**
* Before running this Java V2 code example, convert all Details attribute to DetailsDocument if any
*/
public class RunChangesets {
private static final Gson GSON = new GsonBuilder()
.setObjectToNumberStrategy(ToNumberPolicy.LAZILY_PARSED_NUMBER)
.registerTypeAdapter(String.class, new StringSerializer())
.create();
public static void main(String[] args) {
// input json can be specified here or passed from input parameter
String inputChangeSetFile = "changeSets/offers/CreateReplacementOfferFromAGWithContractPricingDetailDocument.json";
if (args.length > 0)
inputChangeSetFile = args[0];
// parse the input changeset file to string for process
String changeSetsInput = readChangeSetToString(inputChangeSetFile);
// process the changeset request
try {
StartChangeSetResponse result = getChangeSetRequestResult(changeSetsInput);
ReferenceCodesUtils.formatOutput(result);
} catch (Exception e) {
e.printStackTrace();
}
}
public static StartChangeSetResponse getChangeSetRequestResult(String changeSetsInput) throws IOException {
//set up AWS credentials
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
//changeset list to save all the changesets in the changesets file
List changeSetLists = new ArrayList();
// read all changesets into object
Root root = GSON.fromJson(changeSetsInput, Root.class);
// process each changeset and add each changeset request to changesets list
for (ChangeSet cs : root.changeSet) {
ChangeSetEntity entity = cs.Entity;
String entityType = entity.Type;
String entityIdentifier = StringUtils.defaultIfBlank(entity.Identifier, null);
Document detailsDocument = getDocumentFromObject(cs.DetailsDocument);
Entity awsEntity =
Entity.builder()
.type(entityType)
.identifier(entityIdentifier)
.build();
Change inputChangeRequest =
Change.builder()
.changeType(cs.ChangeType)
.changeName(cs.ChangeName)
.entity(awsEntity)
.detailsDocument(detailsDocument)
.build();
changeSetLists.add(inputChangeRequest);
}
// process all changeset requests
StartChangeSetRequest startChangeSetRequest =
StartChangeSetRequest.builder()
.catalog(root.catalog)
.changeSet(changeSetLists)
.build();
StartChangeSetResponse result = marketplaceCatalogClient.startChangeSet(startChangeSetRequest);
return result;
}
public static Document getDocumentFromObject(Object detailsObject) {
String detailsString = "{}";
try {
detailsString = IOUtils.toString(new ByteArrayInputStream(GSON.toJson(detailsObject).getBytes()), "UTF-8");
} catch (IOException e) {
e.printStackTrace();
}
JsonNodeParser jsonNodeParser = JsonNodeParser.create();
Document doc = jsonNodeParser.parse(detailsString).visit(new DocumentUnmarshaller());
return doc;
}
public static String readChangeSetToString (String inputChangeSetFile) {
InputStream changesetInputStream = RunChangesets.class.getClassLoader().getResourceAsStream(inputChangeSetFile);
String changeSetsInput = null;
try {
changeSetsInput = IOUtils.toString(changesetInputStream, "UTF-8");
} catch (IOException e) {
e.printStackTrace();
}
return changeSetsInput;
}
}
```
+ Per i dettagli sull'API, [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)consulta *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK per Python (Boto3)**
C'è altro su GitHub. Trova l’esempio completo e scopri come eseguire la configurazione e l’esecuzione nel [repository di esempi di codice dell’API Marketplace AWS](https://github.com/aws-samples/aws-marketplace-reference-code/blob/main/python##catalog-api-reference-code).
Utilità per l’avvio di un set di modifiche.
```
"""
Purpose:
Generic function to start a changeset
"""
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
def generate_changeset(mp_client, change_set, change_set_name):
"""
Start changeset
"""
try:
response = mp_client.start_change_set(
Catalog="AWSMarketplace",
ChangeSet=change_set,
ChangeSetName=change_set_name,
)
logger.info("Changeset created!")
logger.info("ChangeSet ID: %s", response["ChangeSetId"])
logger.info("ChangeSet ARN: %s", response["ChangeSetArn"])
return response
except ClientError as e:
logger.exception("Unexpected error: %s", e)
raise
def usage_demo(change_set, change_set_name):
logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
print("-" * 88)
print("Executing changeset: " + change_set_name)
print("-" * 88)
mp_client = boto3.client("marketplace-catalog")
response = generate_changeset(mp_client, change_set, change_set_name)
return response
print("-" * 88)
```
Utilità per il caricamento di un set di modifiche da un file JSON.
```
"""
Purpose:
This module will stringify the details sections of a changeset file.
"""
import json
def pretty_print(response):
json_object = json.dumps(response, indent=4)
print(json_object)
# open json file from path
def open_json_file(filename):
with open(filename, "r") as f:
return json.load(f)
def stringify_details_sections(json_object):
"""
Loops through every change type in the changeset to look for non-empty
details section and stringifies them
"""
for change_type in json_object["ChangeSet"]:
# Only stringify details section if it is not empty
if "Details" in change_type and change_type["Details"] != "{}":
string_details = json.dumps(change_type["Details"])
change_type["Details"] = string_details
else:
pass
return json_object["ChangeSet"]
def stringify_changeset(file_path):
changeset_file = open_json_file(file_path)
changeset_stringified = stringify_details_sections(changeset_file)
return changeset_stringified
```
+ Per i dettagli sull'API, consulta [StartChangeSet AWS](https://docs.aws.amazon.com/goto/boto3/marketplace-catalog-2018-09-17/StartChangeSet)*SDK for Python (Boto3) API Reference*.
------