本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS Marketplace 使用适用于 Java 的 SDK 2.x 编目 API 示例
以下代码示例向您展示了如何使用 with Catalo AWS Marketplace g API 执行操作和实现常见场景。 AWS SDK for Java 2.x
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
**Topics**
+ [AMI 产品](#ami_products)
+ [渠道合作伙伴优惠](#channel_partner_offers)
+ [容器产品](#container_products)
+ [实体](#entities)
+ [优惠](#offers)
+ [产品](#products)
+ [转售授权](#resale_authorization)
+ [SaaS 产品](#saas_products)
+ [公用事业机构](#utilities)
## AMI 产品
### 向现有 AMI 产品添加维度并更新优惠定价条款
以下代码示例演示如何向现有 AMI 产品添加维度并更新优惠定价条款。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 添加部署 AMI 产品的区域
以下代码示例演示如何添加部署 AMI 产品的区域。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-east-2",
"us-west-2"
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建公开或受限 AMI 产品和按小时按年定价的公开优惠
以下代码示例演示如何创建公开或受限 AMI 产品和按小时按年定价的公开优惠。此示例创建标准或自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建公开或受限 AMI 产品和按小时按月定价的公开优惠
以下代码示例演示如何创建公开或受限 AMI 产品和按小时按月定价的公开优惠。此示例创建标准或自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建公开或受限 AMI 产品和按小时定价的公开优惠
以下代码示例演示如何创建公开或受限 AMI 产品和按小时定价的公开优惠。此示例创建标准或自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建采用公开优惠草稿的 AMI 产品草稿
以下代码示例演示如何创建采用公开优惠草稿的 AMI 产品草稿。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 限制部署 AMI 产品的区域
以下代码示例演示如何限制部署 AMI 产品的区域。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictRegions",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"Regions": [
"us-west-2"
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 限制产品可见性
以下代码示例演示如何限制产品可见性。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 指定是否在新区域中部署 AMI 资产
以下代码示例说明如何指定 AMI 资产是否部署在为支持 future 区域 AWS 而构建的新区域。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateFutureRegionSupport",
"Entity": {
"Type": "AmiProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"FutureRegionSupport": {
"SupportedRegions": [
"All"
]
}
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
## 渠道合作伙伴优惠
### 为任何产品类型创建 CPPO 草稿
以下代码示例演示如何为任何产品类型创建 CPPO 草稿，这样就可以在将它们发布给买家之前在内部进行审阅。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferUsingResaleAuthorization",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ResaleAuthorizationId": "11111111-1111-1111-1111-111111111111",
"Name": "Test Offer",
"Description": "Test product"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建采用合同定价的转售授权替代专属优惠
以下代码示例演示如何根据采用合同定价的现有协议创建转售授权替代专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 列出渠道合作伙伴 CPPOs 创建的所有内容
以下代码示例展示了如何列出渠道合作伙伴 CPPOs 创建的所有内容。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.core.document.Document;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
public class ListAllCppoOffers {
/*
* List all CPPOs created by a channel partner
*/
public static void main(String[] args) {
List cppoOfferIds = getAllCppoOfferIds();
ReferenceCodesUtils.formatOutput(cppoOfferIds);
}
public static List getAllCppoOfferIds() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
// get all offer entity ids
List entityIdList = new ArrayList();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
for (EntitySummary entitySummary : listEntitiesResponse.entitySummaryList()) {
entityIdList.add(entitySummary.entityId());
}
while (listEntitiesResponse.nextToken() != null) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
for (EntitySummary entitySummary : listEntitiesResponse.entitySummaryList()) {
entityIdList.add(entitySummary.entityId());
}
}
// filter for CPPO offers: ResaleAuthorizationId exists in Details
List cppoOfferIds = new ArrayList();
for (String entityId : entityIdList) {
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(entityId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
Document resaleAuthorizationDocument = describeEntityResponse.detailsDocument().asMap().get(ATTRIBUTE_RESALE_AUTHORIZATION_ID);
String resaleAuthorizationId = resaleAuthorizationDocument != null ? resaleAuthorizationDocument.asString() : "";
if (!resaleAuthorizationId.isEmpty()) {
cppoOfferIds.add(resaleAuthorizationId);
}
}
return cppoOfferIds;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)*中的。
### 列出渠道合作伙伴可获得的所有共享转售授权
以下代码示例演示如何列出渠道合作伙伴可获得的所有共享转售授权。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
public class ListAllSharedResaleAuthorizations {
/*
* list all resale authorizations shared to an account
*/
public static void main(String[] args) {
List responseList = getListEntityResponseList();
ReferenceCodesUtils.formatOutput(responseList);
}
public static List getListEntityResponseList() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
List responseList = new ArrayList();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_RESALE_AUTHORIZATION)
.maxResults(10)
.ownershipType(OWNERSHIP_TYPE_SHARED)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
responseList.add(listEntitiesResponse);
while (listEntitiesResponse.nextToken() != null) {
listEntitiesRequest = ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_RESALE_AUTHORIZATION)
.maxResults(10)
.ownershipType(OWNERSHIP_TYPE_SHARED)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
responseList.add(listEntitiesResponse);
}
return responseList;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[ListEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/ListEntities)*中的。
### 发布 CPPO 并附加买家 EULA
以下代码示例演示如何发布 CPPO 并附加买家 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 使用一次性转售授权发布 CPPO 并更新价格加成
以下代码示例演示如何对 AMI、SaaS 或容器产品使用一次性转售授权来发布 CPPO 并更新价格加成。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布 CPPO 草稿并更新价格加成
以下代码示例演示如何发布 CPPO 草稿和更新价格加成。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新 CPPO 的到期日期
以下代码示例演示如何更新 CPPO 的到期日期，让买家有更多时间评估和接受优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2025-07-31"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
## 容器产品
### 创建采用公开优惠草稿的容器产品草稿
以下代码示例演示如何创建采用公开优惠草稿的容器产品草稿。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建采用公开优惠和合同定价的受限容器产品
以下代码示例演示如何创建采用公开优惠、合同定价和标准 EULA 的受限容器产品。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
## 实体
### 在单次调用中描述所有实体
以下代码示例演示如何在单次调用中描述所有实体。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.BatchDescribeEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.BatchDescribeEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityDetail;
import software.amazon.awssdk.services.marketplacecatalog.model.BatchDescribeErrorDetail;
import java.util.Arrays;
import java.util.Map;
public class BatchDescribeEntities {
/*
* BatchDescribe my entities in a single call and
* check if it contains all the information I need to know about the entities.
*/
public static void main(String[] args) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
BatchDescribeEntitiesRequest batchDescribeEntitiesRequest =
BatchDescribeEntitiesRequest.builder()
.entityRequestList(Arrays.asList(
EntityRequest.builder()
.catalog(AWS_MP_CATALOG).entityId(OFFER_ID)
.build(),
EntityRequest.builder()
.catalog(AWS_MP_CATALOG).entityId(PRODUCT_ID)
.build()))
.build();
BatchDescribeEntitiesResponse batchDescribeEntitiesResponse = marketplaceCatalogClient.batchDescribeEntities(batchDescribeEntitiesRequest);
// Reading the successful entities response
Map entityDetailsMap = batchDescribeEntitiesResponse.entityDetails();
for (Map.Entry entry : entityDetailsMap.entrySet()) {
System.out.println("EntityId: " + entry.getKey());
ReferenceCodesUtils.formatOutput(entry.getValue());
}
// Logging the failed entities error details
Map entityErrorsMap = batchDescribeEntitiesResponse.errors();
for (Map.Entry entry : entityErrorsMap.entrySet()) {
System.out.println(String.format("EntityId: %s, ErrorCode: %s, ErrorMessage: %s", entry.getKey(),
entry.getValue().errorCode(), entry.getValue().errorMessage()));
}
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[BatchDescribeEntities](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/BatchDescribeEntities)*中的。
### 列出并描述与产品关联的所有优惠
以下代码示例演示如何列出并描述与产品关联的所有优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferProductIdFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListProductPrivateOffers {
private static MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
/*
* retrieve all private offer information related to a single product
*/
public static void main(String[] args) {
List entitySummaryList = getEntitySummaryList();
// for each offer id, output the offer detail using DescribeEntity API
for (EntitySummary entitySummary : entitySummaryList) {
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(entitySummary.entityId())
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
}
public static List getEntitySummaryList() {
// define list entities filters
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_BUYERACCOUNTS)
.build())
.productId(OfferProductIdFilter.builder()
.valueList(PRODUCT_ID)
.build())
.build())
.build();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER).maxResults(50)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
// save all entitySummary of the results into entitySummaryList
List entitySummaryList = new ArrayList();
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER).maxResults(50)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
return entitySummaryList;
}
}
```
+ 有关 API 详细信息，请参阅《AWS SDK for Java 2.x API Reference》**中的以下主题。
+ [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)
## 优惠
### 为 SaaS 产品创建自定义维度并创建专属优惠
以下代码示例演示如何为 SaaS 产品创建自定义维度并创建专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 AMI 或 SaaS 产品创建专属优惠草稿
以下代码示例演示如何为 AMI 或 SaaS 产品创建专属优惠草稿，以便您在向买家发布之前可以在内部对其进行审查。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-1111111111111",
"Name": "Test Private Offer"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 SaaS 产品创建包含合同和 Pay-As-You-Go定价的私人报价
以下代码示例显示如何为 SaaS 产品创建包含合同和 Pay-As-You-Go定价的私募报价。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 SaaS 产品创建采用合同定价和灵活付款时间表的专属优惠
以下代码示例演示如何为 SaaS 产品创建采用合同定价和灵活付款时间表的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为容器产品创建采用合同定价的专属优惠。
以下代码示例演示如何为容器产品创建采用合同定价的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 AMI 产品创建采用合同定价的专属优惠
以下代码示例演示如何为 AMI 产品创建采用合同定价的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 AMI 产品创建采用按小时按年定价和灵活付款时间表的专属优惠
以下代码示例演示如何为 AMI 产品创建采用按小时按年定价和灵活付款时间表的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 AMI 产品创建采用按小时按年定价的专属优惠
以下代码示例演示如何为 AMI 产品创建采用按小时按年定价的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 AMI 产品创建采用按小时定价的专属优惠
以下代码示例演示如何为 AMI 产品创建采用按小时定价的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 SaaS 产品创建采用订阅定价的专属优惠
以下代码示例演示如何为 SaaS 产品创建采用订阅定价的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 SaaS 产品创建采用分级合同定价的专属优惠
以下代码示例演示如何为 SaaS 产品创建采用分级合同定价的专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 为 SaaS 产品创建采用订阅定价的公开免费试用优惠
以下代码示例演示如何为 SaaS 产品创建采用订阅定价的公开免费试用优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建采用合同定价的替代专属优惠
以下代码示例演示如何根据采用合同定价的现有协议创建替代专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 描述公开优惠
以下代码示例演示如何描述公开优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
public class DescribeEntity {
/*
* Describe my AMI or SaaS or Container product and check if it contains all the information I need to know about the product
*/
public static void main(String[] args) {
String offerId = args.length > 0 ? args[0] : OFFER_ID;
DescribeEntityResponse describeEntityResponse = getDescribeEntityResponse(offerId);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
public static DescribeEntityResponse getDescribeEntityResponse(String offerId) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(offerId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
return describeEntityResponse;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)*中的。
### 使专属优惠草稿过期
以下代码示例演示如何将专属优惠的到期日期设置为过去的某个日期，这样买家就不会再看到该优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2023-01-01"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 列出所有专属优惠
以下代码示例演示如何列出所有专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferAvailabilityEndDateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferAvailabilityEndDateFilterDateRange;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferBuyerAccountsFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferReleaseDateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferReleaseDateFilterDateRange;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListAllPrivateOffers {
/*
* List all my private offers and sort or filter them by Offer Publish Date, Offer Expiry Date and Buyer IDs
*
* OfferTargetingFilter = BuyerAccounts (private offer);
* OfferBuyerAccountsFilter: Buyer IDs filter
* OfferAvailabilityEndDateFilter : Offer Expiry Date filter
* OfferReleaseDateFilter : Offer Publish Date filter
*/
private static MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
public static void main(String[] args) {
String offerReleaseDateAfterValue = "2023-01-01T23:59:59Z";
String offerAvailableEndDateAfterValue = "2040-12-24T23:59:59Z";
List entitySummaryList = getEntitySummaryList(offerReleaseDateAfterValue, offerAvailableEndDateAfterValue);
// for each offer id, output the offer detail using DescribeEntity API
for (EntitySummary entitySummary : entitySummaryList) {
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(entitySummary.entityId())
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
}
public static List getEntitySummaryList (String offerReleaseDateAfterValue, String offerAvailableEndDateAfterValue) {
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_BUYERACCOUNTS)
.build())
.buyerAccounts(OfferBuyerAccountsFilter.builder()
.wildCardValue(BUYER_ACCOUNT_ID)
.build())
.availabilityEndDate(OfferAvailabilityEndDateFilter.builder()
.dateRange(OfferAvailabilityEndDateFilterDateRange.builder()
.afterValue(offerAvailableEndDateAfterValue).build())
.build())
.releaseDate(OfferReleaseDateFilter.builder()
.dateRange(OfferReleaseDateFilterDateRange.builder()
.afterValue(offerReleaseDateAfterValue)
.build())
.build())
.build())
.build();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER).maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
List entitySummaryList = new ArrayList();
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
return entitySummaryList;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 列出针对特定产品 ID 发布的公开优惠和专属优惠
以下代码示例演示如何列出针对特定产品 ID 发布的公开优惠和专属优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.List;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferProductIdFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferStateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListProductPublicOrPrivateReleasedOffers {
/*
* List released Public/Private offers for a specific product id.
* Example below is to list released public offers.
* To change to released private offers, change OFFER_TARGETING_NONE (None) to OFFER_TARGETING_BUYERACCOUNTS(BuyerAccounts)
*/
public static void main(String[] args) {
List entitySummaryList = getEntitySummaryLIst();
ReferenceCodesUtils.formatOutput(entitySummaryList);
}
public static List getEntitySummaryLIst() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
// define list entities filters
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_NONE)
.build())
.state(OfferStateFilter.builder()
.valueListWithStrings(OFFER_STATE_RELEASED)
.build())
.productId(OfferProductIdFilter.builder()
.valueList(PRODUCT_ID)
.build())
.build())
.build();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
// save all entitySummary of the results into entitySummaryList
List entitySummaryList = new ArrayList();
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
entitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
return entitySummaryList;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新报价以应用带 Pay-As-You-Go定价的合同
以下代码示例显示如何更新报价以应用带 Pay-As-You-Go定价的合同。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新优惠以应用按小时按年定价
以下代码示例演示如何更新优惠以应用按小时按年定价。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新优惠以将目标应用于特定地理区域
以下代码示例演示如何更新优惠以将目标应用于特定地理区域。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"ES",
"FR",
"AU"
]
}
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新公开优惠的名称和描述
以下代码示例演示如何更新公开优惠的名称和描述。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新优惠的 EULA
以下代码示例演示如何更新优惠的 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 将专属优惠的到期日期更新为将来的日期
以下代码示例演示如何将专属优惠的到期日期更新为将来的日期，让买家有更多时间评估和接受优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"AvailabilityEndDate": "2026-01-01"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新 SaaS 产品的公开免费试用优惠的免费试用期限
以下代码示例演示如何更新 SaaS 产品的公开免费试用优惠的免费试用期限。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新优惠的退款政策
以下代码示例演示如何更新优惠的退款政策。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-1111111111111"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
## 产品
### 描述 AMI、SaaS 或容器产品
以下代码示例演示如何描述 AMI、SaaS 或容器产品，并检查它是否包含您想了解的有关该产品的所有信息。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
public class DescribeEntity {
/*
* Describe my AMI or SaaS or Container product and check if it contains all the information I need to know about the product
*/
public static void main(String[] args) {
String offerId = args.length > 0 ? args[0] : OFFER_ID;
DescribeEntityResponse describeEntityResponse = getDescribeEntityResponse(offerId);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
public static DescribeEntityResponse getDescribeEntityResponse(String offerId) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(offerId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
return describeEntityResponse;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)*中的。
### 列出所有 AMI、SaaS 或容器产品以及关联的公开优惠
以下代码示例演示如何列出所有 AMI、SaaS 或容器产品以及关联的公开优惠。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
package com.example.awsmarketplace.catalogapi;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.EntitySummary;
import software.amazon.awssdk.services.marketplacecatalog.model.EntityTypeFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.ListEntitiesResponse;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferFilters;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferProductIdFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferStateFilter;
import software.amazon.awssdk.services.marketplacecatalog.model.OfferTargetingFilter;
public class ListEntities {
/*
* List all my AMI or SaaS or Container products and associated public offers
*/
public static void main(String[] args) {
Map> allProductsWithOffers = getAllProductsWithOffers();
ReferenceCodesUtils.formatOutput(allProductsWithOffers);
}
public static Map> getAllProductsWithOffers() {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
Map> allProductsWithOffers = new HashMap> ();
// get all product entities
List productEntityList = new ArrayList();
ListEntitiesRequest listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(PRODUCT_TYPE_AMI)
.maxResults(10)
.nextToken(null)
.build();
ListEntitiesResponse listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
productEntityList.addAll(listEntitiesResponse.entitySummaryList());
while (listEntitiesResponse.nextToken() != null) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(PRODUCT_TYPE_AMI)
.maxResults(10)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
productEntityList.addAll(listEntitiesResponse.entitySummaryList());
}
// loop through each product entity and get the public released offers associated using product id filter
for ( EntitySummary productEntitySummary : productEntityList) {
EntityTypeFilters entityTypeFilters =
EntityTypeFilters.builder()
.offerFilters(OfferFilters.builder()
.targeting(OfferTargetingFilter.builder()
.valueListWithStrings(OFFER_TARGETING_NONE)
.build())
.state(OfferStateFilter.builder()
.valueListWithStrings(OFFER_STATE_RELEASED)
.build())
.productId(OfferProductIdFilter.builder()
.valueList(productEntitySummary.entityId())
.build())
.build())
.build();
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(null)
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
// save all entitySummary of the results into entitySummaryList
List offerEntitySummaryList = new ArrayList();
offerEntitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
while ( listEntitiesResponse.nextToken() != null && listEntitiesResponse.nextToken().length() > 0) {
listEntitiesRequest =
ListEntitiesRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityType(ENTITY_TYPE_OFFER)
.maxResults(10)
.entityTypeFilters(entityTypeFilters)
.nextToken(listEntitiesResponse.nextToken())
.build();
listEntitiesResponse = marketplaceCatalogClient.listEntities(listEntitiesRequest);
offerEntitySummaryList.addAll(listEntitiesResponse.entitySummaryList());
}
// save final results into map; key = product id; value = offer entity summary list
allProductsWithOffers.put(productEntitySummary.entityId(), offerEntitySummaryList);
}
return allProductsWithOffers;
}
}
```
+ 有关 API 详细信息，请参阅《AWS SDK for Java 2.x API Reference》**中的以下主题。
+ [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)
## 转售授权
### 创建转售授权草稿
以下代码示例演示如何为任何产品类型创建转售授权草稿，这样您就可以在将其发布给渠道合作伙伴之前在内部进行审查。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 描述转售授权
以下代码示例演示如何描述转售授权。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package com.example.awsmarketplace.catalogapi;
import static com.example.awsmarketplace.utils.ReferenceCodesConstants.*;
import com.example.awsmarketplace.utils.ReferenceCodesUtils;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import software.amazon.awssdk.services.marketplacecatalog.MarketplaceCatalogClient;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityRequest;
import software.amazon.awssdk.services.marketplacecatalog.model.DescribeEntityResponse;
public class DescribeEntity {
/*
* Describe my AMI or SaaS or Container product and check if it contains all the information I need to know about the product
*/
public static void main(String[] args) {
String offerId = args.length > 0 ? args[0] : OFFER_ID;
DescribeEntityResponse describeEntityResponse = getDescribeEntityResponse(offerId);
ReferenceCodesUtils.formatOutput(describeEntityResponse);
}
public static DescribeEntityResponse getDescribeEntityResponse(String offerId) {
MarketplaceCatalogClient marketplaceCatalogClient =
MarketplaceCatalogClient.builder()
.httpClient(ApacheHttpClient.builder().build())
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
DescribeEntityRequest describeEntityRequest =
DescribeEntityRequest.builder()
.catalog(AWS_MP_CATALOG)
.entityId(offerId)
.build();
DescribeEntityResponse describeEntityResponse = marketplaceCatalogClient.describeEntity(describeEntityRequest);
return describeEntityResponse;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[DescribeEntity](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/DescribeEntity)*中的。
### 发布采用专属优惠的一次性转售授权
以下代码示例演示如何发布采用专属优惠的一次性转售授权，以便渠道合作伙伴可以使用它来创建渠道合作伙伴专属优惠（CPPO）。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布带到期日期的多次使用转售授权
以下代码示例演示如何为采用按小时按年定价的 AMI 产品发布带到期日期的多次使用转售授权，以便渠道合作伙伴可以使用它来创建 CPPO。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布带到期日期的多次使用转售授权和 EULA
以下代码示例演示如何为任何产品类型发布带到期日期的多次使用转售授权，以及如何添加要发送给买家的自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布带到期日期的多次使用转售授权和经销商合同文档
以下代码示例演示如何为任何产品类型发布带到期日期的多次使用转售授权，以及如何在 ISV 和渠道合作伙伴之间添加经销商合同文档。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布带到期日期的多次使用转售授权，并添加特定的买家账户
以下代码示例演示如何为任何产品类型发布带到期日期的多次使用转售授权，以及如何为转售添加特定的买家账户。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布无到期日期的多次使用转售授权
以下代码示例演示如何为采用按小时按年定价的 AMI 产品发布无到期日期的多次使用转售授权，以便 CP 可以使用它来创建 CPPO。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布无到期日期的多次使用转售授权和 EULA
以下代码示例演示如何为任何产品类型发布无到期日期的多次使用转售授权，以及如何添加要发送给买家的自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布无到期日期的多次使用转售授权和经销商合同文档
以下代码示例演示如何为任何产品类型发布无到期日期的多次使用转售授权，以及如何在 ISV 和渠道合作伙伴之间添加经销商合同文档。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布无到期日期的多次使用转售授权，并添加特定的买家账户
以下代码示例演示如何为任何产品类型发布无到期日期的多次使用转售授权，以及如何为转售添加特定的买家账户。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布一次性转售授权并添加灵活的付款时间表
以下代码示例演示如何为任何产品类型发布一次性转售授权以及如何添加灵活的付款时间表。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布一次性转售授权并添加 EULA
以下代码示例演示如何为任何产品类型发布一次性转售授权，以及如何添加要发送给买家的自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布一次性转售授权并添加特定的买家账户
以下代码示例演示如何为任何产品类型发布一次性转售授权，以及如何为转售添加特定的买家账户。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
]
}
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布一次性转售授权并添加经销商合同文档
以下代码示例演示如何为任何产品类型发布一次性转售授权，以及如何在 ISV 和渠道合作伙伴之间添加经销商合同文档。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布一次性转售授权并添加它是否为续订
以下代码示例演示如何为任何产品类型发布一次性转售授权，以及添加它是否为续订。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 限制转售授权
以下代码示例演示如何限制转售授权。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictResaleAuthorization",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新一次性或多次使用转售授权的名称和描述
以下代码示例演示如何在为任何产品类型发布一次性或多次使用转售授权之前，更新此类授权的名称和描述。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType":"UpdateInformation",
"Entity": {
"Type": "ResaleAuthorization@1.0",
"Identifier": "resaleauthz-1111111111111"
},
"DetailsDocument": {
"Name": "TestResaleAuthorization",
"Description": "Worldwide ResaleAuthorization for Test Product"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
## SaaS 产品
### 创建采用公开优惠草稿的 SaaS 产品草稿
以下代码示例演示如何创建采用公开优惠草稿的 SaaS 产品草稿。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建公开或受限 SaaS 产品和按合同定价的公开优惠
以下代码示例演示如何创建公开或受限 SaaS 产品和按合同定价的公开优惠。此示例创建标准或自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建具有定价合同的公开或有限的 SaaS 产品和公开报 Pay-As-You-Go价
以下代码示例演示如何使用定价合同创建公开或有限的 SaaS 产品和公开报 Pay-As-You-Go价。此示例创建标准或自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 创建公开或受限 SaaS 产品和采用订阅定价的公开优惠
以下代码示例演示如何创建公开或受限 SaaS 产品和采用订阅定价的公开优惠。此示例创建标准或自定义 EULA。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 发布 SaaS 产品和关联的公开优惠
以下代码示例演示如何发布 SaaS 产品和关联的公开优惠。默认情况下，产品将处于受限状态。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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": {}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 根据现有草稿发布 SaaS 产品和关联的公开优惠
以下代码示例演示如何根据现有草稿发布 SaaS 产品和关联的公开优惠。默认情况下，产品将处于受限状态。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
```
{
"Catalog":"AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"ChangeName": "CreateProductChange",
"Entity": {
"Type": "SaaSProduct@1.0",
"Identifier": "prod-1111111111111"
},
"DetailsDocument": {
"TargetVisibility": "Public"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
### 更新 AMI 或 SaaS 产品的维度
以下代码示例演示如何更新 AMI 或 SaaS 产品的维度。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
要运行此示例，请将以下 JSON 更改集传递到**实用程序**部分的*启动更改集的实用程序*中的 `RunChangesets`。
```
{
"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"
}
]
}
]
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。
## 公用事业机构
### 用于启动更改集的实用程序
以下代码示例演示如何定义用于启动更改集的实用程序。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS Marketplace API Reference Code Library](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java#catalog-api-reference-code) 存储库中查找完整示例，了解如何进行设置和运行。
用于从 JSON 文件加载更改集并开始处理更改集的实用程序。
```
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;
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[StartChangeSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/marketplace-catalog-2018-09-17/StartChangeSet)*中的。