AWS code-library documentation change
Summary
Added detailed Java and Python SDK code examples for CreateOpportunity API, including credential configuration and request building logic
Security assessment
The changes add implementation examples but contain no security vulnerability fixes or security-specific guidance. The credential configuration shown (DefaultCredentialsProvider) is standard AWS SDK usage without security warnings or best practice recommendations.
Diff
diff --git a/code-library/latest/ug/partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md b/code-library/latest/ug/partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md index c46dc1d09..6e4489ed5 100644 --- a//code-library/latest/ug/partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md +++ b//code-library/latest/ug/partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md @@ -9 +9 @@ There are more AWS SDK examples available in the [AWS Doc SDK Examples](https:// -The following code example shows how to use `CreateOpportunity`. +The following code examples show how to use `CreateOpportunity`. @@ -139,0 +140,306 @@ Create an opportunity. +Java + + +**SDK for Java 2.x** + + +Create an opportunity. + + + package org.example; + + import java.time.Instant; + import java.util.ArrayList; + import java.util.List; + + import static org.example.utils.Constants.*; + + import org.example.entity.Root; + import org.example.utils.ReferenceCodesUtils; + import org.example.utils.StringSerializer; + + import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider; + import software.amazon.awssdk.http.apache.ApacheHttpClient; + import software.amazon.awssdk.regions.Region; + import software.amazon.awssdk.services.partnercentralselling.PartnerCentralSellingClient; + import software.amazon.awssdk.services.partnercentralselling.model.Account; + import software.amazon.awssdk.services.partnercentralselling.model.Address; + import software.amazon.awssdk.services.partnercentralselling.model.Contact; + import software.amazon.awssdk.services.partnercentralselling.model.CreateOpportunityRequest; + import software.amazon.awssdk.services.partnercentralselling.model.CreateOpportunityResponse; + import software.amazon.awssdk.services.partnercentralselling.model.Customer; + import software.amazon.awssdk.services.partnercentralselling.model.ExpectedCustomerSpend; + import software.amazon.awssdk.services.partnercentralselling.model.LifeCycle; + import software.amazon.awssdk.services.partnercentralselling.model.Marketing; + import software.amazon.awssdk.services.partnercentralselling.model.MonetaryValue; + import software.amazon.awssdk.services.partnercentralselling.model.NextStepsHistory; + import software.amazon.awssdk.services.partnercentralselling.model.Project; + import software.amazon.awssdk.services.partnercentralselling.model.SoftwareRevenue; + + import com.google.gson.Gson; + import com.google.gson.GsonBuilder; + import com.google.gson.ToNumberPolicy; + + public class CreateOpportunity { + + static final Gson GSON = new GsonBuilder() + .setObjectToNumberStrategy(ToNumberPolicy.LAZILY_PARSED_NUMBER) + .registerTypeAdapter(String.class, new StringSerializer()) + .create(); + + static PartnerCentralSellingClient client = PartnerCentralSellingClient.builder() + .region(Region.US_EAST_1) + .credentialsProvider(DefaultCredentialsProvider.create()) + .httpClient(ApacheHttpClient.builder().build()) + .build(); + + public static void main(String[] args) { + + String inputFile = "CreateOpportunity2.json"; + + if (args.length > 0) + inputFile = args[0]; + + CreateOpportunityResponse response = createOpportunity(inputFile); + + client.close(); + } + + static CreateOpportunityResponse createOpportunity(String inputFile) { + + String inputString = ReferenceCodesUtils.readInputFileToString(inputFile); + + Root root = GSON.fromJson(inputString, Root.class); + + List<NextStepsHistory> nextStepsHistories = new ArrayList<NextStepsHistory>(); + if ( root.lifeCycle != null && root.lifeCycle.nextStepsHistories != null) { + for (org.example.entity.NextStepsHistory nextStepsHistoryJson : root.lifeCycle.nextStepsHistories) { + NextStepsHistory nextStepsHistory = NextStepsHistory.builder() + .time(Instant.parse(nextStepsHistoryJson.time)) + .value(nextStepsHistoryJson.value) + .build(); + nextStepsHistories.add(nextStepsHistory); + } + } + + LifeCycle lifeCycle = null; + if ( root.lifeCycle != null ) { + lifeCycle = LifeCycle.builder() + .closedLostReason(root.lifeCycle.closedLostReason) + .nextSteps(root.lifeCycle.nextSteps) + .nextStepsHistory(nextStepsHistories) + .reviewComments(root.lifeCycle.reviewComments) + .reviewStatus(root.lifeCycle.reviewStatus) + .reviewStatusReason(root.lifeCycle.reviewStatusReason) + .stage(root.lifeCycle.stage) + .targetCloseDate(root.lifeCycle.targetCloseDate) + .build(); + } + + Marketing marketing = null; + if ( root.marketing != null ) { + marketing = Marketing.builder() + .awsFundingUsed(root.marketing.awsFundingUsed) + .campaignName(root.marketing.campaignName) + .channels(root.marketing.channels) + .source(root.marketing.source) + .useCases(root.marketing.useCases) + .build(); + + } + + Address address = null; + if ( root.customer != null && root.customer.account != null && root.customer.account.address != null ) { + address = Address.builder() + .city(root.customer.account.address.city) + .postalCode(root.customer.account.address.postalCode) + .stateOrRegion(root.customer.account.address.stateOrRegion) + .countryCode(root.customer.account.address.countryCode) + .streetAddress(root.customer.account.address.streetAddress) + .build(); + } + + Account account = null; + if ( root.customer != null && root.customer.account!= null) { + account = Account.builder() + .address(address) + .awsAccountId(root.customer.account.awsAccountId) + .duns(root.customer.account.duns) + .industry(root.customer.account.industry) + .otherIndustry(root.customer.account.otherIndustry) + .companyName(root.customer.account.companyName) + .websiteUrl(root.customer.account.websiteUrl) + .build(); + } + + List<Contact> contacts = new ArrayList<Contact>(); + if ( root.customer != null && root.customer.contacts != null) { + for (org.example.entity.Contact jsonContact : root.customer.contacts) { + Contact contact = Contact.builder() + .email(jsonContact.email) + .firstName(jsonContact.firstName) + .lastName(jsonContact.lastName) + .phone(jsonContact.phone) + .businessTitle(jsonContact.businessTitle) + .build(); + contacts.add(contact); + } + } + + Customer customer = Customer.builder() + .account(account) + .contacts(contacts) + .build(); + + Contact oportunityTeamContact = null; + if (root.opportunityTeam != null && root.opportunityTeam.get(0) != null ) { + oportunityTeamContact = Contact.builder() + .firstName(root.opportunityTeam.get(0).firstName) + .lastName(root.opportunityTeam.get(0).lastName) + .email(root.opportunityTeam.get(0).email) + .phone(root.opportunityTeam.get(0).phone) + .businessTitle(root.opportunityTeam.get(0).businessTitle) + .build(); + } + + List<ExpectedCustomerSpend> expectedCustomerSpends = new ArrayList<ExpectedCustomerSpend>(); + if ( root.project != null && root.project.expectedCustomerSpend != null) { + for (org.example.entity.ExpectedCustomerSpend expectedCustomerSpendJson : root.project.expectedCustomerSpend) { + ExpectedCustomerSpend expectedCustomerSpend = null; + expectedCustomerSpend = ExpectedCustomerSpend.builder() + .amount(expectedCustomerSpendJson.amount) + .currencyCode(expectedCustomerSpendJson.currencyCode) + .frequency(expectedCustomerSpendJson.frequency) + .targetCompany(expectedCustomerSpendJson.targetCompany) + .build(); + expectedCustomerSpends.add(expectedCustomerSpend); + } + } + + Project project = null; + if ( root.project != null) { + project = Project.builder() + .title(root.project.title) + .customerBusinessProblem(root.project.customerBusinessProblem) + .customerUseCase(root.project.customerUseCase) + .deliveryModels(root.project.deliveryModels) + .expectedCustomerSpend(expectedCustomerSpends) + .salesActivities(root.project.salesActivities) + .competitorName(root.project.competitorName) + .otherSolutionDescription(root.project.otherSolutionDescription) + .build(); + }