Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# AWS Marketplace Katalog-API-Beispiele mit SDK for Java 2.x
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS SDK for Java 2.x with AWS Marketplace Catalog API Aktionen ausführen und allgemeine Szenarien implementieren.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [AMI-Produkte](#ami_products)
+ [Angebote von Channel-Partnern](#channel_partner_offers)
+ [Container-Produkte](#container_products)
+ [Entitäten](#entities)
+ [Angebote](#offers)
+ [Produkte](#products)
+ [Wiederverkaufsgenehmigung](#resale_authorization)
+ [SaaS--Produkte](#saas_products)
+ [Dienstprogramme](#utilities)
## AMI-Produkte
### Hinzufügen einer Dimension zu einem vorhandenen AMI-Produkt und Aktualisieren der Preisbedingungen für das Angebot
Das folgende Codebeispiel zeigt, wie Sie eine Dimension zu einem vorhandenen AMI-Produkt hinzufügen und die Preisbedingungen für das Angebot aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Hinzufügen einer Region, in der ein AMI-Produkt bereitgestellt wird
Das folgende Codebeispiel zeigt, wie Sie eine Region hinzufügen, in der Sie ein AMI-Produkt bereitstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-east-2",
"us-west-2"
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines öffentlichen oder limitierten AMI-Produkts und eines öffentlichen Angebots mit stündlicher jährlicher Preisgestaltung
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches oder limitiertes AMI-Produkt und ein öffentliches Angebot mit stündlicher jährlicher Preisgestaltung erstellen. In diesem Beispiel wird entweder eine standardmäßige oder eine benutzerdefinierte EULA erstellt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines öffentlichen oder limitierten AMI-Produkts und eines öffentlichen Angebots mit stündlicher monatlicher Preisgestaltung
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches oder limitiertes AMI-Produkt und ein öffentliches Angebot mit stündlicher monatlicher Preisgestaltung erstellen. In diesem Beispiel wird entweder eine standardmäßige oder eine benutzerdefinierte EULA erstellt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines öffentlichen oder limitierten AMI-Produkts und eines öffentlichen Angebots mit stündlicher Preisgestaltung
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches oder limitiertes AMI-Produkt und ein öffentliches Angebot mit stündlicher Preisgestaltung erstellen. In diesem Beispiel wird entweder eine standardmäßige oder eine benutzerdefinierte EULA erstellt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines AMI-Produktentwurf mit einem Entwurf eines öffentlichen Angebots
Das folgende Codebeispiel zeigt, wie Sie einen AMI-Produktentwurf mit einem Entwurf eines öffentlichen Angebots erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Einschränken einer Region, in der ein AMI-Produkt bereitgestellt wird
Das folgende Codebeispiel zeigt, wie Sie eine Region einschränken, in der Sie ein AMI-Produkt bereitstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-west-2"
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Beschränken der Produktsichtbarkeit
Das folgende Codebeispiel zeigt, wie Sie die Sichtbarkeit von Produkten einschränken.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Angeben, ob AMI-Komponenten in neuen Regionen bereitgestellt werden
Das folgende Codebeispiel zeigt, wie angegeben wird, ob AMI-Assets in neuen Regionen bereitgestellt werden, die von AWS zur Unterstützung future Regionen entwickelt wurden.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateFutureRegionSupport",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"FutureRegionSupport": {
"SupportedRegions": [
"All"
]
}
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
## Angebote von Channel-Partnern
### Erstellen eines CPPO-Entwurfs für einen beliebigen Produkttyp
Das folgende Codebeispiel zeigt, wie Sie einen CPPO-Entwurf für einen beliebigen Produkttyp erstellen, sodass Sie ihn intern überprüfen können, bevor Sie ihn für Käufer veröffentlichen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "11111111-1111-1111-1111-111111111111",
"Name": "Test Offer",
"Description": "Test product"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Ersatzangebot zur Wiederverkaufsgenehmigung mit Vertragspreisen
Das folgende Codebeispiel zeigt, wie Sie ein privates Ersatzangebot zur Genehmigung des Wiederverkaufs aus einer bestehenden Vereinbarung mit Vertragspreisen erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Liste alle von einem Channel-Partner CPPOs erstellten
Das folgende Codebeispiel zeigt, wie alle von einem Vertriebspartner CPPOs erstellten Dateien aufgelistet werden.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
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;
}
}
```
+ Einzelheiten zur API finden Sie [ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)in der *AWS SDK for Java 2.x API-Referenz*.
### Auflisten aller gemeinsamen Genehmigungen des Wiederverkaufs, die einem Channel-Partner zur Verfügung stehen
Das folgende Codebeispiel zeigt, wie Sie alle gemeinsamen Genehmigung des Wiederverkaufs auflisten, die einem Channel-Partner zur Verfügung stehen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
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;
}
}
```
+ Einzelheiten zur API finden Sie [ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen eines CPPO und Anhängen einer Käufer-EULA
Das folgende Codebeispiel zeigt, wie Sie ein CPPO veröffentlichen und eine Käufer-EULA anhängen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen eines CPPO mithilfe einer einmaligen Wiederverkaufsgenehmigung und Aktualisieren des Preisaufschlags
Das folgende Codebeispiel zeigt, wie ein CPPO mithilfe einer einmaligen Wiederverkaufsgenehmigung für AMI-, SaaS- oder Container-Produkte veröffentlicht und der Preisaufschlag aktualisiert wird.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen eines CPPO-Entwurfs und Aktualisieren des Preisaufschlags
Das folgende Codebeispiel zeigt, wie Sie einen CPPO-Entwurf veröffentlichen und den Preisaufschlag aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren des Ablaufdatums eines CPPO
Das folgende Codebeispiel zeigt, wie das Ablaufdatum eines CPPO aktualisiert wird, um Käufern mehr Zeit zu geben, das Angebot zu bewerten und anzunehmen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2025-07-31"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
## Container-Produkte
### Erstellen eines Container-Produktentwurf mit einem Entwurf eines öffentlichen Angebots
Das folgende Codebeispiel zeigt, wie Sie einen Container-Produktentwurf mit einem Entwurf eines öffentlichen Angebots erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines limitierten Container-Produkts mit einem öffentlichen Angebot und Vertragspreisen
Das folgende Codebeispiel zeigt, wie Sie ein limitiertes Containerprodukt mit einem öffentlichen Angebot, Vertragspreisen und Standard-EULA erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
## Entitäten
### Beschreiben aller Entitäten in einem einzigen Anruf
Das folgende Codebeispiel zeigt, wie Sie alle Entitäten in einem einzigen Aufruf beschreiben.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
// 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()));
}
}
}
```
+ Einzelheiten zur API finden Sie [BatchDescribeEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/BatchDescribeEntities)in der *AWS SDK for Java 2.x API-Referenz*.
### Auflisten und Beschreiben aller Angebote, die einem Produkt zugeordnet sind
Das folgende Codebeispiel zeigt, wie Sie alle mit einem Produkt verbundenen Angebote auflisten und beschreiben.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
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;
}
}
```
+ Weitere API-Informationen finden Sie in den folgenden Themen der *AWS SDK for Java 2.x -API-Referenz*.
+ [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)
## Angebote
### Erstellen einer benutzerdefinierten Dimension für ein SaaS-Produkt und Erstellen eines privaten Angebots
Das folgende Codebeispiel zeigt, wie Sie eine benutzerdefinierte Dimension für ein SaaS-Produkt erstellen und ein privates Angebot erstellen.
**SDK für Java 2.x**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebotsentwurfs für ein AMI- oder SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie einen privaten Angebotsentwurf für ein beliebiges AMI- oder SaaS-Produkt erstellen, sodass Sie es intern überprüfen können, bevor Sie es für Käufer veröffentlichen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "Test Private Offer"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen Sie ein privates Angebot mit Vertrag und Pay-As-You-Go Preisen für ein SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit Vertrag und Pay-As-You-Go Preis für ein SaaS-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit Vertragspreisen und einem flexiblen Zahlungsplan für ein SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit Vertragspreisen und einem flexiblen Zahlungsplan für ein SaaS-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit Vertragspreisen für ein Container-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit Vertragspreisen für ein Container-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit Vertragspreisen für ein AMI-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit Vertragspreisen für ein AMI-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit stündlichen jährlichen Preisen und einem flexiblen Zahlungsplan für ein AMI-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit stündlichen jährlichen Preisen und einem flexiblen Zahlungsplan für ein AMI-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit stündlichen jährlichen Preisen für ein AMI-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit stündlichen jährlichen Preisen für ein AMI-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit stündlichen Preisen für ein AMI-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit stündlichen Preisen für ein AMI-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit Abonnementpreisen für ein SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit Abonnementpreisen für ein SaaS-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Angebots mit gestaffelten Preisen für ein SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein privates Angebot mit gestaffelten Preisen für ein SaaS-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines öffentlichen kostenlosen Testangebots mit Abonnementpreisen für ein SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches kostenloses Testangebot mit Abonnementpreisen für ein SaaS-Produkt erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines privaten Ersatzangebots mit Vertragspreisen
Das folgende Codebeispiel zeigt, wie Sie ein privates Ersatzangebot aus einer bestehenden Vereinbarung mit Vertragspreisen erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Beschreiben eines öffentlichen Angebots
Das folgende Codebeispiel veranschaulicht, wie Sie ein öffentliches Angebot beschreiben.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
// 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;
}
}
```
+ Einzelheiten zur API finden Sie [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)in der *AWS SDK for Java 2.x API-Referenz*.
### Ablaufen des Entwurfs eines privaten Angebots
Das folgende Codebeispiel zeigt, wie Sie das Ablaufdatum eines privaten Angebots auf ein Datum in der Vergangenheit festlegen, sodass Käufer das Angebot nicht mehr sehen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-01-01"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Auflisten aller privaten Angebote
Das folgende Codebeispiel zeigt, wie Sie alle privaten Angebote auflisten.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
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;
}
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Auflisten freigegebener öffentlicher und privater Angebote für eine bestimmte Produkt-ID
Das folgende Codebeispiel zeigt, wie Sie freigegebene öffentliche und private Angebote für eine bestimmte Produkt-ID auflisten.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
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;
}
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren Sie ein Angebot, um einen Vertrag mit Pay-As-You-Go Preisangaben anzuwenden
Das folgende Codebeispiel zeigt, wie ein Angebot aktualisiert wird, um einen Vertrag mit Pay-As-You-Go Preisgestaltung anzuwenden.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren eines Angebots, um einen stündlichen jährlichen Preis anzuwenden
Das folgende Codebeispiel zeigt, wie Sie ein Angebot aktualisieren, um einen stündlichen jährlichen Preis anzuwenden.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren eines Angebots, um das Targeting auf bestimmte geografische Regionen anzuwenden
Das folgende Codebeispiel zeigt, wie Sie ein Angebot aktualisieren, um das Targeting auf bestimmte geografische Regionen anzuwenden.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"ES",
"FR",
"AU"
]
}
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren des Namens und der Beschreibung eines öffentlichen Angebots
Das folgende Codebeispiel zeigt, wie Sie den Namen und die Beschreibung eines öffentlichen Angebots aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren der EULA eines Angebots
Das folgende Codebeispiel zeigt, wie Sie die EULA eines Angebots aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren des Ablaufdatums eines privaten Angebots auf ein zukünftiges Datum
Das folgende Codebeispiel zeigt, wie das Ablaufdatum eines privaten Angebots auf ein zukünftiges Datum aktualisiert wird, um Käufern mehr Zeit zu geben, das Angebot zu bewerten und anzunehmen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2026-01-01"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren der Dauer der kostenlosen Testversion eines öffentlichen kostenlosen Testangebots für ein SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie die Dauer der kostenlosen Testversion eines öffentlichen kostenlosen Testangebots für ein SaaS-Produkt aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren der Rückerstattungsrichtlinie eines Angebots
Das folgende Codebeispiel zeigt, wie Sie die Rückerstattungsrichtlinie eines Angebots aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
## Produkte
### Beschreiben eines AMI-, SaaS- oder Container-Produkts
Das folgende Codebeispiel zeigt, wie Sie ein AMI-, SaaS- oder Container-Produkt beschreiben und prüfen, ob es alle Informationen enthält, die Sie über das Produkt haben möchten.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
// 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;
}
}
```
+ Einzelheiten zur API finden Sie [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)in der *AWS SDK for Java 2.x API-Referenz*.
### Auflisten aller AMI-, SaaS- oder Container-Produkte und zugehöriger öffentlicher Angebote
Das folgende Codebeispiel zeigt, wie Sie alle AMI-, SaaS- oder Container-Produkte und zugehörige öffentliche Angebote auflisten.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
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;
}
}
```
+ Weitere API-Informationen finden Sie in den folgenden Themen der *AWS SDK for Java 2.x -API-Referenz*.
+ [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)
## Wiederverkaufsgenehmigung
### Erstellen eines Entwurfs einer Wiederverkaufsgenehmigung
Das folgende Codebeispiel zeigt, wie Sie den Entwurf einer Wiederverkaufsgenehmigung für einen beliebigen Produkttyp erstellen, sodass Sie ihn intern überprüfen können, bevor Sie ihn bei einem Vertriebspartner veröffentlichen.
**SDK für Java 2.x**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Beschreiben einer Wiederverkaufsgenehmigung
Das folgende Codebeispiel zeigt, wie Sie eine Wiederverkaufsgenehmigung beschreiben.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
// 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;
}
}
```
+ Einzelheiten zur API finden Sie [DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer einmaliger Wiederverkaufsgenehmigung mit einem privaten Angebot
Das folgende Codebeispiel zeigt, wie Sie eine einmalige Wiederverkaufsgenehmigung mit einem privaten Angebot veröffentlichten sodass ein Channel-Partner damit ein Channel Partner Private Offer (CPPO) erstellen kann.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung mit einem Ablaufdatum
Das folgende Codebeispiel zeigt, wie eine mehrfach verwendbare Wiederverkaufsgenehmigung mit einem Ablaufdatum für ein AMI-Produkt mit stündlichen jährlichen Preisen veröffentlicht wird, sodass ein Channel-Partner damit ein CPPO erstellen kann.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung mit einem Ablaufdatum und einer EULA
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung mit einem Ablaufdatum für einen beliebigen Produkttyp veröffentlichen und eine benutzerdefinierte EULA hinzufügen, die an den Käufer gesendet werden soll.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung mit einem Ablaufdatum und von Vertragsunterlagen für Wiederverkäufer
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung mit einem Ablaufdatum für einen beliebigen Produkttyp veröffentlichen und Vertragsunterlagen für Wiederverkäufer zwischen dem ISV- und dem Channel-Partner hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung mit Ablauf und Hinzufügen eines bestimmten Käuferkontos
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung mit einem Ablaufdatum für einen beliebigen Produkttyp veröffentlichen und ein bestimmtes Käuferkonto für den Wiederverkauf hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung ohne ein Ablaufdatum
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung ohne ein Ablaufdatum für ein AMI-Produkt mit stündlichen jährlichen Preisen veröffentlichen, sodass ein Channel-Partner damit ein CPPO erstellen kann.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung ohne Ablaufdatum und einer EULA
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung ohne Ablaufdatum für einen beliebigen Produkttyp veröffentlichen und eine benutzerdefinierte EULA hinzufügen, die an den Käufer gesendet werden soll.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung ohne Ablaufdatum und von Vertragsunterlagen für Wiederverkäufer
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung ohne Ablaufdatum für einen beliebigen Produkttyp veröffentlichen und Vertragsunterlagen für Wiederverkäufer zwischen dem ISV- und dem Channel-Partner hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer mehrfach verwendbaren Wiederverkaufsgenehmigung ohne Ablauf und Hinzufügen eines bestimmten Käuferkontos
Das folgende Codebeispiel zeigt, wie Sie eine mehrfach verwendbare Wiederverkaufsgenehmigung ohne Ablaufdatum für einen beliebigen Produkttyp veröffentlichen und ein bestimmtes Käuferkonto für den Wiederverkauf hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer einmaligen Wiederverkaufsgenehmigung und Hinzufügen eines flexiblen Zahlungsplans
Das folgende Codebeispiel zeigt, wie Sie eine einmalige Wiederverkaufsgenehmigung für einen beliebigen Produkttyp veröffentlichen und einen flexiblen Zahlungsplan hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer einmaligen Wiederverkaufsgenehmigung und Hinzufügen einer EULA
Das folgende Codebeispiel zeigt, wie Sie eine einmalige Wiederverkaufsgenehmigung für einen beliebigen Produkttyp veröffentlichen und eine benutzerdefinierte EULA hinzufügen, die an den Käufer gesendet werden soll.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer einmaligen Wiederverkaufsgenehmigung und Hinzufügen eines bestimmten Käuferkontos
Das folgende Codebeispiel zeigt, wie Sie eine einmalige Wiederverkaufsgenehmigung für einen beliebigen Produkttyp veröffentlichen und ein bestimmtes Käuferkonto für den Wiederverkauf hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
]
}
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer einmaligen Wiederverkaufsgenehmigung und Hinzufügen von Vertragsunterlagen für Wiederverkäufer
Das folgende Codebeispiel zeigt, wie Sie eine einmalige Wiederverkaufsgenehmigung für einen beliebigen Produkttyp veröffentlichen und Vertragsunterlagen für Wiederverkäufer zwischen dem ISV- und dem Channel-Partner hinzufügen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen einer einmaligen Wiederverkaufsgenehmigung und Hinzufügen, ob es sich um eine Verlängerung handelt
Das folgende Codebeispiel zeigt, wie Sie eine einmalige Wiederverkaufsgenehmigung für einen beliebigen Produkttyp veröffentlichen und hinzufügen, ob es sich um eine Verlängerung handelt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Beschränken der Wiederverkaufsgenehmigung
Das folgende Codebeispiel zeigt, wie Sie eine Wiederverkaufsgenehmigung beschränken.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren des Namens und der Beschreibung der einmaligen oder mehrfach verwendbaren Wiederverkaufsgenehmigung
Das folgende Codebeispiel zeigt, wie Sie den Namen und die Beschreibung einer einmaligen oder mehrfach verwendbaren Wiederverkaufsgenehmigung vor der Veröffentlichung für einen beliebigen Produkttyp aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"UpdateInformation",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
## SaaS--Produkte
### Erstellen eines SaaS-Produktentwurfs mit einem Entwurf eines öffentlichen Angebots
Das folgende Codebeispiel zeigt, wie Sie einen SaaS-Produktentwurf mit einem Entwurf eines öffentlichen Angebots erstellen.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines öffentlichen oder limitierten SaaS-Produkts und eines öffentlichen Angebots mit Vertragspreisen
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches oder limitiertes SaaS-Produkt und ein öffentliches Angebot mit nutzungsabhängiger Preisberechnung erstellen. In diesem Beispiel wird entweder eine standardmäßige oder eine benutzerdefinierte EULA erstellt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen Sie ein öffentliches oder begrenztes SaaS-Produkt und ein öffentliches Angebot mit Vertrag mit Pay-As-You-Go Preisgestaltung
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches oder begrenztes SaaS-Produkt und ein öffentliches Angebot mit einem Vertrag mit Pay-As-You-Go Preisgestaltung erstellen. In diesem Beispiel wird entweder eine standardmäßige oder eine benutzerdefinierte EULA erstellt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Erstellen eines öffentlichen oder limitierten SaaS-Produkts und eines öffentlichen Angebots mit Abonnementpreisen
Das folgende Codebeispiel zeigt, wie Sie ein öffentliches oder limitiertes SaaS-Produkt und ein öffentliches Angebot mit Abonnementpreisen erstellen. In diesen Beispielen wird entweder eine standardmäßige oder eine benutzerdefinierte EULA erstellt.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen eines SaaS-Produkts und des zugehörigen öffentlichen Angebots
Das folgende Codebeispiel zeigt, wie Sie ein SaaS-Produkt und das zugehörige öffentliche Angebot veröffentlichen. Das Produkt befindet sich standardmäßig in einem eingeschränkten Zustand.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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": {}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Veröffentlichen eines SaaS-Produkts und des zugehörigen öffentlichen Angebots anhand eines bestehenden Entwurfs
Das folgende Codebeispiel zeigt, wie Sie ein SaaS-Produkt und das zugehörige öffentliche Angebot anhand eines bestehenden Entwurfs veröffentlichen. Das Produkt befindet sich standardmäßig in einem eingeschränkten Zustand.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
```
{
"Catalog":"AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Public"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
### Aktualisieren der Dimensionen auf einem AMI- oder SaaS-Produkt
Das folgende Codebeispiel zeigt, wie Sie die Dimensionen auf einem AMI- oder SaaS-Produkt aktualisieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Um dieses Beispiel auszuführen, übergeben Sie das folgende JSON-Changeset an `RunChangesets` in *Dienstprogramme, um ein Changeset zu starten* aus dem Abschnitt **Dienstprogramme**.
```
{
"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"
}
]
}
]
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.
## Dienstprogramme
### Dienstprogramme zum Starten eines Changesets
Das folgende Codebeispiel zeigt, wie Sie Dienstprogramme zum Starten eines Changesets definieren.
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das Repository der [Codebibliothek der AWS Marketplace -API-Referenz](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) einrichten und ausführen.
Dienstprogramm zum Laden eines Changesets aus einer JSON-Datei und zum Starten der Verarbeitung.
```
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;
}
}
```
+ Einzelheiten zur API finden Sie [StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)in der *AWS SDK for Java 2.x API-Referenz*.