Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS SDKsコード例 次のコード例は、 AWS Software Development Kit (SDK) で AWS Partner Central を使用する方法を示しています。 *アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。 *シナリオ*は、1 つのサービス内から、または他の AWS のサービスと組み合わせて複数の関数を呼び出し、特定のタスクを実行する方法を示すコード例です。 **その他のリソース** + **[ パートナーセントラル入門ガイド](https://docs.aws.amazon.com/partner-central/latest/getting-started/what-is-partner-central.html)** – パートナーセントラルに関する詳細情報。 + **[ パートナーセントラル API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html)** – 使用可能なすべてのパートナーセントラルのアクションに関する詳細。 + **[AWS デベロッパーセンター](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** – カテゴリまたは全文検索でフィルタリングできるコード例。 + **[AWS SDK の例](https://github.com/awsdocs/aws-doc-sdk-examples)** – 完全なコードを優先言語で含む GitHub リポジトリ。コードの設定と実行に関する説明が記載されています。 **Contents** + [基本](partnercentral-selling_code_examples_basics.md) + [アクション](partnercentral-selling_code_examples_actions.md) + [`AssignOpportunity`](partnercentral-selling_example_partnercentral-selling_AssignOpportunity_section.md) + [`AssociateOpportunity`](partnercentral-selling_example_partnercentral-selling_AssociateOpportunity_section.md) + [`CreateOpportunity`](partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md) + [`DisassociateOpportunity`](partnercentral-selling_example_partnercentral-selling_DisassociateOpportunity_section.md) + [`GetAwsOpportunitySummary`](partnercentral-selling_example_partnercentral-selling_GetAwsOpportunitySummary_section.md) + [`GetEngagementInvitation`](partnercentral-selling_example_partnercentral-selling_GetEngagementInvitation_section.md) + [`GetOpportunity`](partnercentral-selling_example_partnercentral-selling_GetOpportunity_section.md) + [`ListEngagementInvitations`](partnercentral-selling_example_partnercentral-selling_ListEngagementInvitations_section.md) + [`ListOpportunities`](partnercentral-selling_example_partnercentral-selling_ListOpportunities_section.md) + [`ListSolutions`](partnercentral-selling_example_partnercentral-selling_ListSolutions_section.md) + [`RejectEngagementInvitation`](partnercentral-selling_example_partnercentral-selling_RejectEngagementInvitation_section.md) + [`StartEngagementByAcceptingInvitationTask`](partnercentral-selling_example_partnercentral-selling_StartEngagementByAcceptingInvitationTask_section.md) + [`StartEngagementFromOpportunityTask`](partnercentral-selling_example_partnercentral-selling_StartEngagementFromOpportunityTask_section.md) + [`UpdateOpportunity`](partnercentral-selling_example_partnercentral-selling_UpdateOpportunity_section.md) + [シナリオ](partnercentral-selling_code_examples_scenarios.md) + [オポチュニティの関連エンティティを更新する](partnercentral-selling_example_partnercentral-selling__UpdateAssociatedEntity_section.md) # AWS SDKs基本的な例 次のコード例は、 SDKs で AWS AWS Partner Central の基本を使用する方法を示しています。 **Contents** + [アクション](partnercentral-selling_code_examples_actions.md) + [`AssignOpportunity`](partnercentral-selling_example_partnercentral-selling_AssignOpportunity_section.md) + [`AssociateOpportunity`](partnercentral-selling_example_partnercentral-selling_AssociateOpportunity_section.md) + [`CreateOpportunity`](partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md) + [`DisassociateOpportunity`](partnercentral-selling_example_partnercentral-selling_DisassociateOpportunity_section.md) + [`GetAwsOpportunitySummary`](partnercentral-selling_example_partnercentral-selling_GetAwsOpportunitySummary_section.md) + [`GetEngagementInvitation`](partnercentral-selling_example_partnercentral-selling_GetEngagementInvitation_section.md) + [`GetOpportunity`](partnercentral-selling_example_partnercentral-selling_GetOpportunity_section.md) + [`ListEngagementInvitations`](partnercentral-selling_example_partnercentral-selling_ListEngagementInvitations_section.md) + [`ListOpportunities`](partnercentral-selling_example_partnercentral-selling_ListOpportunities_section.md) + [`ListSolutions`](partnercentral-selling_example_partnercentral-selling_ListSolutions_section.md) + [`RejectEngagementInvitation`](partnercentral-selling_example_partnercentral-selling_RejectEngagementInvitation_section.md) + [`StartEngagementByAcceptingInvitationTask`](partnercentral-selling_example_partnercentral-selling_StartEngagementByAcceptingInvitationTask_section.md) + [`StartEngagementFromOpportunityTask`](partnercentral-selling_example_partnercentral-selling_StartEngagementFromOpportunityTask_section.md) + [`UpdateOpportunity`](partnercentral-selling_example_partnercentral-selling_UpdateOpportunity_section.md) # AWS SDKsアクション 次のコード例は、 AWS SDKs を使用して個々の Partner Central アクションを実行する方法を示しています。それぞれの例には、GitHub へのリンクがあり、そこにはコードの設定と実行に関する説明が記載されています。 これらは Partner Central API を呼び出すもので、コンテキスト内で実行する必要がある大規模なプログラムからのコード抜粋です。アクションは [AWS SDKsシナリオ](partnercentral-selling_code_examples_scenarios.md) のコンテキスト内で確認できます。 以下の例には、最も一般的に使用されるアクションのみ含まれています。完全なリストについては、「[AWS パートナーセントラル API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html)」を参照してください。 **Topics** + [`AssignOpportunity`](partnercentral-selling_example_partnercentral-selling_AssignOpportunity_section.md) + [`AssociateOpportunity`](partnercentral-selling_example_partnercentral-selling_AssociateOpportunity_section.md) + [`CreateOpportunity`](partnercentral-selling_example_partnercentral-selling_CreateOpportunity_section.md) + [`DisassociateOpportunity`](partnercentral-selling_example_partnercentral-selling_DisassociateOpportunity_section.md) + [`GetAwsOpportunitySummary`](partnercentral-selling_example_partnercentral-selling_GetAwsOpportunitySummary_section.md) + [`GetEngagementInvitation`](partnercentral-selling_example_partnercentral-selling_GetEngagementInvitation_section.md) + [`GetOpportunity`](partnercentral-selling_example_partnercentral-selling_GetOpportunity_section.md) + [`ListEngagementInvitations`](partnercentral-selling_example_partnercentral-selling_ListEngagementInvitations_section.md) + [`ListOpportunities`](partnercentral-selling_example_partnercentral-selling_ListOpportunities_section.md) + [`ListSolutions`](partnercentral-selling_example_partnercentral-selling_ListSolutions_section.md) + [`RejectEngagementInvitation`](partnercentral-selling_example_partnercentral-selling_RejectEngagementInvitation_section.md) + [`StartEngagementByAcceptingInvitationTask`](partnercentral-selling_example_partnercentral-selling_StartEngagementByAcceptingInvitationTask_section.md) + [`StartEngagementFromOpportunityTask`](partnercentral-selling_example_partnercentral-selling_StartEngagementFromOpportunityTask_section.md) + [`UpdateOpportunity`](partnercentral-selling_example_partnercentral-selling_UpdateOpportunity_section.md) # AWS SDK `AssignOpportunity`で を使用する 次のサンプルコードは、`AssignOpportunity` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** 既存のオポチュニティを他のユーザーに再割り当てします。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.AssignOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.AssignOpportunityResponse; import software.amazon.awssdk.services.partnercentralselling.model.AssigneeContact; /* Purpose PC-API-07 Assigning a new owner */ public class AssignOpportunity { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; String assigneeFirstName = "John"; String assigneeLastName = "Doe"; String assigneeEmail = "test@test.com"; String businessTitle = "PartnerAccountManager"; AssignOpportunityResponse response = getResponse(opportunityId, assigneeFirstName, assigneeLastName, assigneeEmail, businessTitle); ReferenceCodesUtils.formatOutput(response); } static AssignOpportunityResponse getResponse(String opportunityId, String assigneeFirstName, String assigneeLastName, String assigneeEmail, String businessTitle) { AssignOpportunityRequest assignOpportunityRequest = AssignOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(opportunityId) .assignee(AssigneeContact.builder() .firstName(assigneeFirstName) .lastName(assigneeLastName) .email(assigneeEmail) .businessTitle(businessTitle) .build()) .build(); AssignOpportunityResponse response = client.assignOpportunity(assignOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[AssignOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/AssignOpportunity)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** 既存のオポチュニティを他のユーザーに再割り当てします。 ``` #!/usr/bin/env python """ Purpose PC-API-07 Assigning a new owner """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def assign_opportunity(identifier): assign_opportunity_request ={ "Catalog": CATALOG_TO_USE, "Identifier": identifier, "Assignee": { "BusinessTitle": "OpportunityOwner", "Email": "test@test.com", "FirstName": "John", "LastName": "Doe" } } try: # Perform an API call response = partner_central_client.assign_opportunity(**assign_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): identifier = "O4236468" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Assigning a new owner to an opportunity.") print("-" * 88) helper.pretty_print_datetime(assign_opportunity(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[AssignOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/AssignOpportunity)」を参照してください。** ------ # AWS SDK `AssociateOpportunity`で を使用する 次のサンプルコードは、`AssociateOpportunity` を使用する方法を説明しています。 アクション例は、より大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。次のコード例で、このアクションのコンテキストを確認できます。 + [オポチュニティの関連エンティティを更新する](partnercentral-selling_example_partnercentral-selling__UpdateAssociatedEntity_section.md) ------ #### [ Java ] **SDK for Java 2.x** オポチュニティとさまざまな関連エンティティとの正式な関連付けを作成します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.AssociateOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.AssociateOpportunityResponse; /* Purpose PC-API -11 Associating a product PC-API -12 Associating a solution PC-API -13 Associating an offer entity_type = Solutions | AWSProducts | AWSMarketplaceOffers */ public class AssociateOpportunity { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; String entityType = "Solutions"; String entityIdentifier = "S-0000000"; AssociateOpportunityResponse response = getResponse(opportunityId, entityType, entityIdentifier ); ReferenceCodesUtils.formatOutput(response); } static AssociateOpportunityResponse getResponse(String opportunityId, String entityType, String entityIdentifier) { AssociateOpportunityRequest associateOpportunityRequest = AssociateOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .opportunityIdentifier(opportunityId) .relatedEntityType(entityType) .relatedEntityIdentifier(entityIdentifier) .build(); AssociateOpportunityResponse response = client.associateOpportunity(associateOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x APIリファレンス*」の「[AssociateOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/AssociateOpportunity)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** オポチュニティとさまざまな関連エンティティとの正式な関連付けを作成します。 ``` #!/usr/bin/env python """ Purpose PC-API -11 Associating a product PC-API -12 Associating a solution PC-API -13 Associating an offer """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def associate_opportunity(entity_type, entity_identifier, opportunityIdentifier): associate_opportunity_request ={ "Catalog": CATALOG_TO_USE, "OpportunityIdentifier" : opportunityIdentifier, "RelatedEntityType" : entity_type, "RelatedEntityIdentifier" : entity_identifier } try: # Perform an API call response = partner_central_client.associate_opportunity(**associate_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): #entity_type = Solutions | AWSProducts | AWSMarketplaceOffers entity_type = "Solutions" entity_identifier = "S-0059717" opportunityIdentifier = "O5465588" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Associate Opportunity.") print("-" * 88) helper.pretty_print_datetime(associate_opportunity(entity_type, entity_identifier, opportunityIdentifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[AssociateOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/AssociateOpportunity)」を参照してください。** ------ # AWS SDK `CreateOpportunity`で を使用する 次のサンプルコードは、`CreateOpportunity` を使用する方法を説明しています。 ------ #### [ .NET ] **SDK for .NET** オポチュニティを作成します。 ``` // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. // PDX-License-Identifier: Apache-2.0 using System; using Newtonsoft.Json; using Amazon; using Amazon.Runtime; using Amazon.PartnerCentralSelling; using Amazon.PartnerCentralSelling.Model; namespace AWSExample { class Program { static readonly string catalogToUse = "AWS"; static async Task Main(string[] args) { // Initialize credentials from .aws/credentials file var credentials = new Amazon.Runtime.CredentialManagement.SharedCredentialsFile(); if (credentials.TryGetProfile("default", out var profile)) { AWSCredentials awsCredentials = profile.GetAWSCredentials(credentials); var client = new AmazonPartnerCentralSellingClient(awsCredentials); var request = new CreateOpportunityRequest { Catalog = catalogToUse, Origin = "Partner Referral", Customer = new Customer { Account = new Account { Address = new Address { CountryCode = "US", PostalCode = "99502", StateOrRegion = "Alaska" }, CompanyName = "TestCompanyName", Duns = "123456789", WebsiteUrl = "www.test.io", Industry = "Automotive" }, Contacts = new List { new Contact { Email = "test@test.io", FirstName = "John ", LastName = "Doe", Phone = "+14444444444", BusinessTitle = "test title" } } }, LifeCycle = new LifeCycle { ReviewStatus = "Submitted", TargetCloseDate = "2024-12-30" }, Marketing = new Marketing { Source = "None" }, OpportunityType = "Net New Business", PrimaryNeedsFromAws = new List { "Co-Sell - Architectural Validation" }, Project = new Project { Title = "Moin Test UUID", CustomerBusinessProblem = "Sandbox is not working as expected", CustomerUseCase = "AI Machine Learning and Analytics", DeliveryModels = new List { "SaaS or PaaS" }, ExpectedCustomerSpend = new List { new ExpectedCustomerSpend { Amount = "2000.0", CurrencyCode = "USD", Frequency = "Monthly", TargetCompany = "Ibexlabs" } }, SalesActivities = new List { "Initialized discussions with customer" } } }; try { var response = await client.CreateOpportunityAsync(request); Console.WriteLine(response.HttpStatusCode); string formattedJson = JsonConvert.SerializeObject(response, Formatting.Indented); Console.WriteLine(formattedJson); } catch (ValidationException ex) { Console.WriteLine("Validation error: " + ex.Message); } catch (AmazonPartnerCentralSellingException e) { Console.WriteLine("Failed:"); Console.WriteLine(e.RequestId); Console.WriteLine(e.ErrorCode); Console.WriteLine(e.Message); } } else { Console.WriteLine("Profile not found."); } } } } ``` + API の詳細については、「*AWS SDK for .NET API リファレンス*」の「[CreateOpportunity](https://docs.aws.amazon.com/goto/DotNetSDKV3/partnercentral-selling-2022-07-26/CreateOpportunity)」を参照してください。 ------ #### [ Java ] **SDK for Java 2.x** オポチュニティを作成します。 ``` 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 nextStepsHistories = new ArrayList(); 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 contacts = new ArrayList(); 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 expectedCustomerSpends = new ArrayList(); 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(); } SoftwareRevenue softwareRevenue = null; if ( root.softwareRevenue != null) { MonetaryValue monetaryValue = null; if ( root.softwareRevenue.value != null) { monetaryValue = MonetaryValue.builder() .amount(root.softwareRevenue.value.amount) .currencyCode(root.softwareRevenue.value.currencyCode) .build(); } softwareRevenue = SoftwareRevenue.builder() .deliveryModel(root.softwareRevenue.deliveryModel) .effectiveDate(root.softwareRevenue.effectiveDate) .expirationDate(root.softwareRevenue.expirationDate) .value(monetaryValue) .build(); } // Building the Actual CreateOpportunity Request CreateOpportunityRequest createOpportunityRequest = CreateOpportunityRequest.builder() .catalog(CATALOG_TO_USE) .clientToken(root.clientToken) .primaryNeedsFromAwsWithStrings(root.primaryNeedsFromAws) .opportunityType(root.opportunityType) .lifeCycle(lifeCycle) .marketing(marketing) .nationalSecurity(root.nationalSecurity) .origin(root.origin) .customer(customer) .project(project) .partnerOpportunityIdentifier(root.partnerOpportunityIdentifier) .opportunityTeam(oportunityTeamContact) .softwareRevenue(softwareRevenue) .build(); CreateOpportunityResponse response = client.createOpportunity(createOpportunityRequest); System.out.println("Successfully created: " + response); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[CreateOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/CreateOpportunity)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** オポチュニティを作成します。 ``` #!/usr/bin/env python import boto3 import logging import sys import os sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) import utils.helpers as helper import utils.stringify_details as sd from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" def create_opportunity(partner_central_client): create_opportunity_request = helper.remove_nulls(sd.stringify_json("src/create_opportunity/createOpportunity.json")) try: # Perform an API call response = partner_central_client.create_opportunity(**create_opportunity_request) helper.pretty_print_datetime(response) # Retrieve the opportunity details get_response = partner_central_client.get_opportunity( Identifier=response["Id"], Catalog=CATALOG_TO_USE ) helper.pretty_print_datetime(get_response) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Create Opportunity.") print("-" * 88) partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) create_opportunity(partner_central_client) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[CreateOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/CreateOpportunity)」を参照してください。** ------ # AWS SDK `DisassociateOpportunity`で を使用する 次のサンプルコードは、`DisassociateOpportunity` を使用する方法を説明しています。 アクション例は、より大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。次のコード例で、このアクションのコンテキストを確認できます。 + [オポチュニティの関連エンティティを更新する](partnercentral-selling_example_partnercentral-selling__UpdateAssociatedEntity_section.md) ------ #### [ Java ] **SDK for Java 2.x** オポチュニティと関連エンティティ間の既存の関連付けを削除します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.DisassociateOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.DisassociateOpportunityResponse; /* Purpose PC-API -14 Removing a Solution PC-API -15 Removing an offer PC-API -16 Removing a product entity_type = Solutions | AWSProducts | AWSMarketplaceOffers */ public class DisassociateOpportunity { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; String entityType = "Solutions"; String entityIdentifier = "S-0000000"; DisassociateOpportunityResponse response = getResponse(opportunityId, entityType, entityIdentifier ); ReferenceCodesUtils.formatOutput(response); } static DisassociateOpportunityResponse getResponse(String opportunityId, String entityType, String entityIdentifier) { DisassociateOpportunityRequest disassociateOpportunityRequest = DisassociateOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .opportunityIdentifier(opportunityId) .relatedEntityType(entityType) .relatedEntityIdentifier(entityIdentifier) .build(); DisassociateOpportunityResponse response = client.disassociateOpportunity(disassociateOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[DisassociateOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/DisassociateOpportunity)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** オポチュニティと関連エンティティ間の既存の関連付けを削除します。 ``` #!/usr/bin/env python """ Purpose PC-API -14 Removing a Solution PC-API -15 Removing an offer PC-API -16 Removing a product """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def disassociate_opportunity(entity_type, entity_identifier, opportunityIdentifier): disassociate_opportunity_request ={ "Catalog": CATALOG_TO_USE, "OpportunityIdentifier" : opportunityIdentifier, "RelatedEntityType" : entity_type, "RelatedEntityIdentifier" : entity_identifier } try: # Perform an API call response = partner_central_client.disassociate_opportunity(**disassociate_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): #entity_type = Solutions | AWSProducts | AWSMarketplaceOffers entity_type = "Solutions" entity_identifier = "S-0049999" opportunityIdentifier = "O4397574" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Get updated Opportunity.") print("-" * 88) helper.pretty_print_datetime(disassociate_opportunity(entity_type, entity_identifier, opportunityIdentifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[DisassociateOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/DisassociateOpportunity)」を参照してください。** ------ # AWS SDK `GetAwsOpportunitySummary`で を使用する 次のサンプルコードは、`GetAwsOpportunitySummary` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** AWS オポチュニティの概要を取得します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.GetAwsOpportunitySummaryRequest; import software.amazon.awssdk.services.partnercentralselling.model.GetAwsOpportunitySummaryResponse; /* * Purpose * PC-API-25 Retrieves a summary of an AWS Opportunity. */ public class GetAwsOpportunitySummary { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; GetAwsOpportunitySummaryResponse response = getResponse(opportunityId); ReferenceCodesUtils.formatOutput(response); } public static GetAwsOpportunitySummaryResponse getResponse(String opportunityId) { GetAwsOpportunitySummaryRequest getOpportunityRequest = GetAwsOpportunitySummaryRequest.builder() .catalog(Constants.CATALOG_TO_USE) .relatedOpportunityIdentifier(opportunityId) .build(); GetAwsOpportunitySummaryResponse response = client.getAwsOpportunitySummary(getOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[GetAwsOpportunitySummary](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/GetAwsOpportunitySummary)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** AWS オポチュニティの概要を取得します。 ``` #!/usr/bin/env python """ Purpose PC-API-25 Retrieves a summary of an AWS Opportunity. LifeCycle.ReviewStatus=Approved """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_opportunity(identifier): get_opportunity_request ={ "Catalog": CATALOG_TO_USE, "RelatedOpportunityIdentifier": identifier } try: # Perform an API call response = partner_central_client.get_aws_opportunity_summary(**get_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): identifier = "O5465588" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Get AWS Opportunity summary.") print("-" * 88) helper.pretty_print_datetime(get_opportunity(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[GetAwsOpportunitySummary](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/GetAwsOpportunitySummary)」を参照してください。** ------ # AWS SDK `GetEngagementInvitation`で を使用する 次のサンプルコードは、`GetEngagementInvitation` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** がパートナー AWS と共有しているエンゲージメントの招待の詳細を取得します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.GetEngagementInvitationRequest; import software.amazon.awssdk.services.partnercentralselling.model.GetEngagementInvitationResponse; /* * Purpose * PC-API-22 Get engagement invitation opportunity */ public class GetEngagementInvitation { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; GetEngagementInvitationResponse response = getResponse(opportunityId); ReferenceCodesUtils.formatOutput(response); } static GetEngagementInvitationResponse getResponse(String opportunityId) { GetEngagementInvitationRequest getOpportunityRequest = GetEngagementInvitationRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(opportunityId) .build(); GetEngagementInvitationResponse response = client.getEngagementInvitation(getOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[GetEngagementInvitation](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/GetEngagementInvitation)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** がパートナー AWS と共有しているエンゲージメントの招待の詳細を取得します。 ``` #!/usr/bin/env python """ Purpose PC-API-22 GetOpportunityEngagementInvitation - Retrieves details of a specific engagement invitation. This operation allows partners to view the invitation and its associated information, such as the customer, project, and lifecycle details. """ import json import logging import boto3 import utils.helpers as helper from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_opportunity_engagement_invitation(identifier): get_opportunity_engagement_invitation_request ={ "Catalog": CATALOG_TO_USE, "Identifier": identifier } try: # Perform an API call response = partner_central_client.get_engagement_invitation(**get_opportunity_engagement_invitation_request) return response except Exception as err: # Catch all client exceptions print(json.dumps(err.response)) def usage_demo(): identifier = "arn:aws:partnercentral-selling:us-east-1:aws:catalog/Sandbox/engagement-invitation/engi-0000000IS0Qga" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Given the ARN identifier, retrieve details of Opportunity Engagement Invitation.") print("-" * 88) helper.pretty_print_datetime(get_opportunity_engagement_invitation(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンス の「[GetEngagementInvitation](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/GetEngagementInvitation)」を参照してください。** ------ # AWS SDK `GetOpportunity`で を使用する 次のサンプルコードは、`GetOpportunity` を使用する方法を説明しています。 ------ #### [ .NET ] **SDK for .NET** オポチュニティを取得します。 ``` // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. // PDX-License-Identifier: Apache-2.0 using System; using Newtonsoft.Json; using Amazon; using Amazon.Runtime; using Amazon.PartnerCentralSelling; using Amazon.PartnerCentralSelling.Model; namespace AWSExample { class Program { static readonly string catalogToUse = "AWS"; static readonly string identifier = "O1111111"; static async Task Main(string[] args) { // Initialize credentials from .aws/credentials file var credentials = new Amazon.Runtime.CredentialManagement.SharedCredentialsFile(); if (credentials.TryGetProfile("default", out var profile)) { AWSCredentials awsCredentials = profile.GetAWSCredentials(credentials); var client = new AmazonPartnerCentralSellingClient(awsCredentials); var request = new GetOpportunityRequest { Catalog = catalogToUse, Identifier = identifier }; try { var response = await client.GetOpportunityAsync(request); Console.WriteLine(response.HttpStatusCode); string formattedJson = JsonConvert.SerializeObject(response, Formatting.Indented); Console.WriteLine(formattedJson); } catch(ValidationException ex) { Console.WriteLine("Validation error: " + ex.Message); } catch (AmazonPartnerCentralSellingException e) { Console.WriteLine("Failed:"); Console.WriteLine(e.RequestId); Console.WriteLine(e.ErrorCode); Console.WriteLine(e.Message); } } else { Console.WriteLine("Profile not found."); } } } } ``` + API の詳細については、「*AWS SDK for .NET API リファレンス*」の「[GetOpportunity](https://docs.aws.amazon.com/goto/DotNetSDKV3/partnercentral-selling-2022-07-26/GetOpportunity)」を参照してください。 ------ #### [ Go ] **SDK for Go V2** オポチュニティを取得します。 ``` package main import ( "context" "encoding/json" "fmt" "log" "github.com/aws/aws-sdk-go-v2/aws" "github.com/aws/aws-sdk-go-v2/config" "github.com/aws/aws-sdk-go-v2/service/partnercentralselling" ) func main() { config, err := config.LoadDefaultConfig(context.TODO()) if err != nil { log.Fatal(err) } config.Region = "us-east-1" client := partnercentralselling.NewFromConfig(config) output, err := client.GetOpportunity(context.TODO(), &partnercentralselling.GetOpportunityInput{ Identifier: aws.String("O1111111"), Catalog: aws.String("AWS"), }) if err != nil { log.Fatal(err) } log.Println("printing opportuniy...\n") jsonOutput, err := json.MarshalIndent(output, "", " ") fmt.Println(string(jsonOutput)) } ``` + API の詳細については、「*AWS SDK for Go API リファレンス*」の「[GetOpportunity](https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/partnercentralselling#Client.GetOpportunity)」を参照してください。 ------ #### [ Java ] **SDK for Java 2.x** オポチュニティを取得します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.GetOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.GetOpportunityResponse; /* * Purpose * PC-API-08 Get updated Opportunity */ public class GetOpportunity { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; GetOpportunityResponse response = getResponse(opportunityId); ReferenceCodesUtils.formatOutput(response); } public static GetOpportunityResponse getResponse(String opportunityId) { GetOpportunityRequest getOpportunityRequest = GetOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(opportunityId) .build(); GetOpportunityResponse response = client.getOpportunity(getOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[GetOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/GetOpportunity)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** オポチュニティを取得します。 ``` #!/usr/bin/env python """ Purpose PC-API -08 Get updated Opportunity given opportunity id """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_opportunity(identifier): get_opportunity_request ={ "Catalog": CATALOG_TO_USE, "Identifier": identifier } try: # Perform an API call response = partner_central_client.get_opportunity(**get_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): identifier = "O5465588" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Get updated Opportunity.") print("-" * 88) helper.pretty_print_datetime(get_opportunity(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[GetOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/GetOpportunity)」を参照してください。** ------ # AWS SDK `ListEngagementInvitations`で を使用する 次のサンプルコードは、`ListEngagementInvitations` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** パートナーに送信されたエンゲージメントの招待の一覧を取得します。 ``` package org.example; import java.util.ArrayList; import java.util.List; import org.example.utils.ReferenceCodesUtils; import static org.example.utils.Constants.*; 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.ListEngagementInvitationsRequest; import software.amazon.awssdk.services.partnercentralselling.model.ListEngagementInvitationsResponse; import software.amazon.awssdk.services.partnercentralselling.model.ParticipantType; import software.amazon.awssdk.services.partnercentralselling.model.EngagementInvitationSummary; public class ListEngagementInvitations { static PartnerCentralSellingClient client = PartnerCentralSellingClient.builder() .region(Region.US_EAST_1) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClient(ApacheHttpClient.builder().build()) .build(); public static void main(String[] args) { List opportunitySummaries = getResponse(); ReferenceCodesUtils.formatOutput(opportunitySummaries); } static List getResponse() { List opportunitySummaries = new ArrayList(); ListEngagementInvitationsRequest listOpportunityRequest = ListEngagementInvitationsRequest.builder() .catalog(CATALOG_TO_USE) .participantType(ParticipantType.RECEIVER) .maxResults(5) .build(); ListEngagementInvitationsResponse response = client.listEngagementInvitations(listOpportunityRequest); opportunitySummaries.addAll(response.engagementInvitationSummaries()); client.close(); return opportunitySummaries; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[ListEngagementInvitations](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/ListEngagementInvitations)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** パートナーに送信されたエンゲージメントの招待の一覧を取得します。 ``` #!/usr/bin/env python """ Purpose PC-API-21 ListEngagementInvitations - Retrieves a list of engagement invitations based on specified criteria. This operation allows partners to view all invitations to engagement. """ import json import logging import boto3 import utils.helpers as helper from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def list_engagement_invitations(): list_engagement_invitations_request ={ "Catalog": CATALOG_TO_USE, "MaxResults": 20 } try: # Perform an API call response = partner_central_client.list_engagement_invitations(**list_engagement_invitations_request) return response except Exception as err: # Catch all client exceptions print(json.dumps(err.response)) def usage_demo(): logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Retrieve list of Engagement Invitations.") print("-" * 88) helper.pretty_print_datetime(list_engagement_invitations()) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[ListEngagementInvitations](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/ListEngagementInvitations)」を参照してください。** ------ # AWS SDK `ListOpportunities`で を使用する 次のサンプルコードは、`ListOpportunities` を使用する方法を説明しています。 ------ #### [ .NET ] **SDK for .NET** オポチュニティを一覧表示します。 ``` // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. // PDX-License-Identifier: Apache-2.0 using System; using Newtonsoft.Json; using Amazon; using Amazon.Runtime; using Amazon.PartnerCentralSelling; using Amazon.PartnerCentralSelling.Model; namespace AWSExample { class Program { static readonly string catalogToUse = "Sandbox"; static async Task Main(string[] args) { // Initialize credentials from .aws/credentials file var credentials = new Amazon.Runtime.CredentialManagement.SharedCredentialsFile(); if (credentials.TryGetProfile("default", out var profile)) { AWSCredentials awsCredentials = profile.GetAWSCredentials(credentials); //var config = new AmazonPartnerCentralSellingConfig() //{ // ServiceURL = "https://partnercentral-selling.us-east-1.api.aws", //}; //var client = new AmazonPartnerCentralSellingClient(awsCredentials, config); var client = new AmazonPartnerCentralSellingClient(awsCredentials); var request = new ListOpportunitiesRequest { Catalog = catalogToUse, MaxResults = 2 }; try { var response = await client.ListOpportunitiesAsync(request); Console.WriteLine(response.HttpStatusCode); foreach (var opportunity in response.OpportunitySummaries) { Console.WriteLine("Opportunity id: " + opportunity.Id); } string formattedJson = JsonConvert.SerializeObject(response.OpportunitySummaries, Formatting.Indented); Console.WriteLine(formattedJson); } catch(ValidationException ex) { Console.WriteLine("Validation error: " + ex.Message); } catch (AmazonPartnerCentralSellingException e) { Console.WriteLine("Failed:"); Console.WriteLine(e.RequestId); Console.WriteLine(e.ErrorCode); Console.WriteLine(e.Message); } } else { Console.WriteLine("Profile not found."); } } } } ``` + API の詳細については、「*AWS SDK for .NET API リファレンス*」の「[ListOpportunities](https://docs.aws.amazon.com/goto/DotNetSDKV3/partnercentral-selling-2022-07-26/ListOpportunities)」を参照してください。 ------ #### [ Go ] **SDK for Go V2** オポチュニティを一覧表示します。 ``` package main import ( "context" "encoding/json" "fmt" "log" "github.com/aws/aws-sdk-go-v2/aws" "github.com/aws/aws-sdk-go-v2/config" "github.com/aws/aws-sdk-go-v2/service/partnercentralselling" ) func main() { config, err := config.LoadDefaultConfig(context.TODO()) if err != nil { log.Fatal(err) } config.Region = "us-east-1" client := partnercentralselling.NewFromConfig(config) output, err := client.ListOpportunities(context.TODO(), &partnercentralselling.ListOpportunitiesInput{ MaxResults: aws.Int32(2), Catalog: aws.String("AWS"), }) if err != nil { log.Fatal(err) } jsonOutput, err := json.MarshalIndent(output, "", " ") fmt.Println(string(jsonOutput)) } ``` + API の詳細については、「*AWS SDK for Go API リファレンス*」の「[ListOpportunities](https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/partnercentralselling#Client.ListOpportunities)」を参照してください。 ------ #### [ Java ] **SDK for Java 2.x** オポチュニティを一覧表示します。 ``` package org.example; import java.util.ArrayList; import java.util.List; import org.example.utils.ReferenceCodesUtils; import static org.example.utils.Constants.*; 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.ListOpportunitiesRequest; import software.amazon.awssdk.services.partnercentralselling.model.ListOpportunitiesResponse; import software.amazon.awssdk.services.partnercentralselling.model.OpportunitySummary; /* * Purpose * PC-API-18 Getting list of Opportunities */ public class ListOpportunititesPaging { static PartnerCentralSellingClient client = PartnerCentralSellingClient.builder() .region(Region.US_EAST_1) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClient(ApacheHttpClient.builder().build()) .build(); public static void main(String[] args) { List opportunitySummaries = getResponse(); ReferenceCodesUtils.formatOutput(opportunitySummaries); } private static List getResponse() { List opportunitySummaries = new ArrayList(); ListOpportunitiesRequest listOpportunityRequest = ListOpportunitiesRequest.builder() .catalog(CATALOG_TO_USE) .maxResults(5) .build(); ListOpportunitiesResponse response = client.listOpportunities(listOpportunityRequest); opportunitySummaries.addAll(response.opportunitySummaries()); while (response.nextToken() != null && response.nextToken().length() > 0) { listOpportunityRequest = ListOpportunitiesRequest.builder() .catalog(CATALOG_TO_USE) .maxResults(5) .nextToken(response.nextToken()) .build(); response = client.listOpportunities(listOpportunityRequest); opportunitySummaries.addAll(response.opportunitySummaries()); } client.close(); return opportunitySummaries; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[ListOpportunities](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/ListOpportunities)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** オポチュニティを一覧表示します。 ``` #!/usr/bin/env python """ Purpose PC-API -18 Getting list of Opportunities """ import json import logging import boto3 import utils.helpers as helper from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_list_of_opportunities(): opportunity_list = [] list_opportunities_request ={ "Catalog": CATALOG_TO_USE, "MaxResults": 20 } try: # Perform an API call response = partner_central_client.list_opportunities(**list_opportunities_request) opportunity_list.extend(response["OpportunitySummaries"]) while "NextToken" in response and response["NextToken"] is not None: list_opportunities_request["NextToken"] = response["NextToken"] response = partner_central_client.list_opportunities(**list_opportunities_request) opportunity_list.extend(response["OpportunitySummaries"]) return opportunity_list except Exception as err: # Catch all client exceptions print(json.dumps(err.response)) def usage_demo(): logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Getting list of Opportunities.") print("-" * 88) helper.pretty_print_datetime(get_list_of_opportunities()) if __name__ == "__main__": usage_demo() ``` + API の詳細については、*AWS SDK for Python (Boto3) API リファレンス*の「[ListOpportunities](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/ListOpportunities)」を参照してください。 ------ # AWS SDK `ListSolutions`で を使用する 次のサンプルコードは、`ListSolutions` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** パートナーがパートナーセントラルに登録したパートナーソリューションの一覧を取得します。 ``` package org.example; import java.util.ArrayList; import java.util.List; import static org.example.utils.Constants.*; import org.example.utils.ReferenceCodesUtils; 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.ListSolutionsRequest; import software.amazon.awssdk.services.partnercentralselling.model.ListSolutionsResponse; import software.amazon.awssdk.services.partnercentralselling.model.SolutionBase; /* * Purpose * PC-API-10 Getting list of solutions */ public class ListSolutions { static PartnerCentralSellingClient client = PartnerCentralSellingClient.builder() .region(Region.US_EAST_1) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClient(ApacheHttpClient.builder().build()) .build(); public static void main(String[] args) { List solutionSummaries = getResponse(); ReferenceCodesUtils.formatOutput(solutionSummaries); } static List getResponse() { List solutionSummaries = new ArrayList(); ListSolutionsRequest listSolutionsRequest = ListSolutionsRequest.builder() .catalog(CATALOG_TO_USE) .maxResults(5) .build(); ListSolutionsResponse response = client.listSolutions(listSolutionsRequest); solutionSummaries.addAll(response.solutionSummaries()); return solutionSummaries; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[ListSolutions](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/ListSolutions)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** パートナーがパートナーセントラルに登録したパートナーソリューションの一覧を取得します。 ``` #!/usr/bin/env python """ Purpose PC-API-10 Getting list of solutions """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_list_of_solutions(): list_solutions_request ={ "Catalog": CATALOG_TO_USE, "MaxResults": 20 } try: # Perform an API call response = partner_central_client.list_solutions(**list_solutions_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Getting list of solutions.") print("-" * 88) helper.pretty_print_datetime(get_list_of_solutions()) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[ListSolutions](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/ListSolutions)」を参照してください。** ------ # AWS SDK `RejectEngagementInvitation`で を使用する 次のサンプルコードは、`RejectEngagementInvitation` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** が AWS 共有した EngagementInvitation を拒否します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.RejectEngagementInvitationRequest; import software.amazon.awssdk.services.partnercentralselling.model.RejectEngagementInvitationResponse; /* * Purpose * PC-API-05 AWS Originated(AO) rejection */ public class RejectEngagementInvitation { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; RejectEngagementInvitationResponse response = getResponse(opportunityId); ReferenceCodesUtils.formatOutput(response); } static RejectEngagementInvitationResponse getResponse(String invitationId) { RejectEngagementInvitationRequest rejectOpportunityRequest = RejectEngagementInvitationRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(invitationId) .rejectionReason("Unable to support") .build(); RejectEngagementInvitationResponse response = client.rejectEngagementInvitation(rejectOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の[RejectEngagementInvitation](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/RejectEngagementInvitation)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** が AWS 共有した EngagementInvitation を拒否します。 ``` #!/usr/bin/env python """ Purpose PC-API-05 AWS Originated AO rejection - RejectOpportunityEngagementInvitation - Rejects a engagement invitation. This action indicates that the partner does not wish to participate in the engagement and provides a reason for the rejection. Upon rejection, a OpportunityEngagementInvitationRejected event is triggered. Subsequently, the invitation will no longer be available for the partner to act on. """ import json import logging import boto3 import utils.helpers as helper from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def reject_opportunity_engagement_invitation(identifier, reject_reason): reject_opportunity_engagement_invitation_request ={ "Catalog": CATALOG_TO_USE, "Identifier": identifier, "RejectionReason": reject_reason } try: # Perform an API call response = partner_central_client.reject_engagement_invitation(**reject_opportunity_engagement_invitation_request) return response except Exception as err: # Catch all client exceptions print(json.dumps(err.response)) def usage_demo(): identifier = "arn:aws:partnercentral:us-east-1::catalog/Sandbox/engagement-invitation/engi-0000002isviga" reject_reason = "Customer problem unclear" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Given the ARN identifier and reject reason, reject the Opportunity Engagement Invitation.") print("-" * 88) helper.pretty_print_datetime(reject_opportunity_engagement_invitation(identifier, reject_reason)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[RejectEngagementInvitation](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/RejectEngagementInvitation)」を参照してください。** ------ # AWS SDK `StartEngagementByAcceptingInvitationTask`で を使用する 次のサンプルコードは、`StartEngagementByAcceptingInvitationTask` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** EngagementInvitation を受け入れることでエンゲージメントを開始します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.StartEngagementByAcceptingInvitationTaskRequest; import software.amazon.awssdk.services.partnercentralselling.model.StartEngagementByAcceptingInvitationTaskResponse; import software.amazon.awssdk.services.partnercentralselling.model.GetEngagementInvitationRequest; import software.amazon.awssdk.services.partnercentralselling.model.GetEngagementInvitationResponse; import software.amazon.awssdk.services.partnercentralselling.model.InvitationStatus; /* Purpose PC-API-04: Start Engagement By Accepting InvitationTask for AWS Originated(AO) opportunity */ public class StartEngagementByAcceptingInvitationTask { static PartnerCentralSellingClient client = PartnerCentralSellingClient.builder() .region(Region.US_EAST_1) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClient(ApacheHttpClient.builder().build()) .build(); static String clientToken = "test-a30d161"; public static void main(String[] args) { String opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; StartEngagementByAcceptingInvitationTaskResponse response = getResponse(opportunityId); if ( response == null) { System.out.println("Opportunity is not AWS Originated."); } else { ReferenceCodesUtils.formatOutput(response); } } private static GetEngagementInvitationResponse getInvitation(String invitationId) { GetEngagementInvitationRequest getRequest = GetEngagementInvitationRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(invitationId) .build(); GetEngagementInvitationResponse response = client.getEngagementInvitation(getRequest); return response; } static StartEngagementByAcceptingInvitationTaskResponse getResponse(String invitationId) { if ( getInvitation(invitationId).status().equals(InvitationStatus.PENDING)) { StartEngagementByAcceptingInvitationTaskRequest acceptOpportunityRequest = StartEngagementByAcceptingInvitationTaskRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(invitationId) .clientToken(clientToken) .build(); StartEngagementByAcceptingInvitationTaskResponse response = client.startEngagementByAcceptingInvitationTask(acceptOpportunityRequest); return response; } return null; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[StartEngagementByAcceptingInvitationTask](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/StartEngagementByAcceptingInvitationTask)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** EngagementInvitation を受け入れることでエンゲージメントを開始します。 ``` #!/usr/bin/env python """ Purpose PC-API -11 Associating a product PC-API -12 Associating a solution PC-API -13 Associating an offer """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_opportunity(identifier): get_opportunity_request ={ "Identifier": identifier, "Catalog": CATALOG_TO_USE } try: # Perform an API call response = partner_central_client.get_engagement_invitation(**get_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def start_engagement_by_accepting_invitation_task(identifier): response = get_opportunity(identifier) if ( response['Status'] == 'PENDING') : accept_opportunity_engagement_invitation_request ={ "Catalog": CATALOG_TO_USE, "Identifier" : identifier, "ClientToken": "test-123456" } try: # Perform an API call response = partner_central_client.start_engagement_by_accepting_invitation_task(**accept_opportunity_engagement_invitation_request) return response except ClientError as err: # Catch all client exceptions print(err.response) return None else: return None def usage_demo(): identifier = "arn:aws:partnercentral:us-east-1::catalog/Sandbox/engagement-invitation/engi-0000002isusga" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Get updated Opportunity.") print("-" * 88) helper.pretty_print_datetime(start_engagement_by_accepting_invitation_task(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[StartEngagementByAcceptingInvitationTask](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/StartEngagementByAcceptingInvitationTask)」を参照してください。** ------ # AWS SDK `StartEngagementFromOpportunityTask`で を使用する 次のサンプルコードは、`StartEngagementFromOpportunityTask` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** エンゲージメントの招待を受け入れ、パートナーのシステムで対応するオポチュニティを作成することで、既存のオポチュニティからエンゲージメントプロセスを開始します。 ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.AwsSubmission; import software.amazon.awssdk.services.partnercentralselling.model.SalesInvolvementType; import software.amazon.awssdk.services.partnercentralselling.model.StartEngagementFromOpportunityTaskRequest; import software.amazon.awssdk.services.partnercentralselling.model.StartEngagementFromOpportunityTaskResponse; import software.amazon.awssdk.services.partnercentralselling.model.Visibility; /* * Purpose * PC-API-01 Partner Originated (PO) opp submission(Start Engagement From Opportunity Task for AO Originated Opportunity) */ public class StartEngagementFromOpportunityTask { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; StartEngagementFromOpportunityTaskResponse response = getResponse(opportunityId); ReferenceCodesUtils.formatOutput(response); } static StartEngagementFromOpportunityTaskResponse getResponse(String opportunityId) { StartEngagementFromOpportunityTaskRequest submitOpportunityRequest = StartEngagementFromOpportunityTaskRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(opportunityId) .clientToken("test-annjqwesdsd99") .awsSubmission(AwsSubmission.builder().involvementType(SalesInvolvementType.CO_SELL).visibility(Visibility.FULL).build()) .build(); StartEngagementFromOpportunityTaskResponse response = client.startEngagementFromOpportunityTask(submitOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[StartEngagementFromOpportunityTask](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/StartEngagementFromOpportunityTask)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** エンゲージメントの招待を受け入れ、パートナーのシステムで対応するオポチュニティを作成することで、既存のオポチュニティからエンゲージメントプロセスを開始します。 ``` #!/usr/bin/env python """ Purpose PC-API -11 Associating a product PC-API -12 Associating a solution PC-API -13 Associating an offer """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def start_engagement_from_opportunity_task(identifier): start_engagement_from_opportunity_task_request ={ "AwsSubmission": { "InvolvementType": "Co-Sell", "Visibility": "Full" }, "Catalog": CATALOG_TO_USE, "Identifier" : identifier, "ClientToken": "test-annjqwesdsd99" } try: # Perform an API call response = partner_central_client.start_engagement_from_opportunity_task(**start_engagement_from_opportunity_task_request) return response except ClientError as err: # Catch all client exceptions print(err.response) return None def usage_demo(): identifier = "O5465588" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Start Engagement from Opportunity Task.") print("-" * 88) helper.pretty_print_datetime(start_engagement_from_opportunity_task(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[StartEngagementFromOpportunityTask](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/StartEngagementFromOpportunityTask)」を参照してください。** ------ # AWS SDK `UpdateOpportunity`で を使用する 次のサンプルコードは、`UpdateOpportunity` を使用する方法を説明しています。 ------ #### [ Java ] **SDK for Java 2.x** オポチュニティを更新します。 ``` 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.Constants; 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.Customer; import software.amazon.awssdk.services.partnercentralselling.model.ExpectedCustomerSpend; import software.amazon.awssdk.services.partnercentralselling.model.GetOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.GetOpportunityResponse; import software.amazon.awssdk.services.partnercentralselling.model.LifeCycle; import software.amazon.awssdk.services.partnercentralselling.model.Marketing; import software.amazon.awssdk.services.partnercentralselling.model.NextStepsHistory; import software.amazon.awssdk.services.partnercentralselling.model.Project; import software.amazon.awssdk.services.partnercentralselling.model.ReviewStatus; import software.amazon.awssdk.services.partnercentralselling.model.UpdateOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.UpdateOpportunityResponse; import com.google.gson.Gson; import com.google.gson.GsonBuilder; import com.google.gson.ToNumberPolicy; /* * Purpose * PC-API-02/06 Update opportunity when LifeCycle.ReviewStatus is not Submitted or In-Review */ public class UpdateOpportunity { 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(); static String OPPORTUNITY_ORIGIN = ORIGIN_PARTNER_ORIGINATED; public static void main(String[] args) { String inputFile = "updateOpportunity.json"; if (args.length > 0) inputFile = args[0]; UpdateOpportunityResponse response = updateOpportunity(inputFile); client.close(); } public static GetOpportunityResponse getResponse(String opportunityId) { GetOpportunityRequest getOpportunityRequest = GetOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .identifier(opportunityId) .build(); GetOpportunityResponse response = client.getOpportunity(getOpportunityRequest); System.out.println(opportunityId + ":" + response); return response; } public static UpdateOpportunityResponse updateOpportunity(String inputFile) { String inputString = ReferenceCodesUtils.readInputFileToString(inputFile); Root root = GSON.fromJson(inputString, Root.class); GetOpportunityResponse response = getResponse(root.identifier); if (response != null && response.lifeCycle() != null && response.lifeCycle().reviewStatus() != null && response.lifeCycle().reviewStatus() != ReviewStatus.SUBMITTED && response.lifeCycle().reviewStatus() != ReviewStatus.IN_REVIEW) { List nextStepsHistories = new ArrayList(); 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().postalCode(root.customer.account.address.postalCode) .stateOrRegion(root.customer.account.address.stateOrRegion) .countryCode(root.customer.account.address.countryCode).build(); } Account account = null; if (root.customer != null && root.customer.account != null) { account = Account.builder().address(address).duns(root.customer.account.duns) .industry(root.customer.account.industry).companyName(root.customer.account.companyName) .websiteUrl(root.customer.account.websiteUrl).build(); } List contacts = new ArrayList(); 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(); List expectedCustomerSpends = new ArrayList(); 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(); } // Building the Actual CreateOpportunity Request UpdateOpportunityRequest updateOpportunityRequest = UpdateOpportunityRequest.builder().catalog(root.catalog) .identifier(root.identifier).lastModifiedDate(Instant.parse(root.lastModifiedDate)) .primaryNeedsFromAwsWithStrings(root.primaryNeedsFromAws).opportunityType(root.opportunityType) .lifeCycle(lifeCycle) .customer(customer) .project(project) .partnerOpportunityIdentifier(root.partnerOpportunityIdentifier) .marketing(marketing) .nationalSecurity(root.nationalSecurity) .opportunityType(root.opportunityType) .build(); UpdateOpportunityResponse updateResponse = client.updateOpportunity(updateOpportunityRequest); System.out.println("Successfully updated opportunity: " + updateResponse); return updateResponse; } else { System.out.println("Opportunity cannot be updated."); return null; } } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[UpdateOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/UpdateOpportunity)」を参照してください。 ------ #### [ Python ] **SDK for Python (Boto3)** オポチュニティを更新します。 ``` #!/usr/bin/env python """ Purpose PC-API-2 Updating Partner Originated Opportunity """ import logging import boto3 import sys import os sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) import utils.helpers as helper from botocore.client import ClientError import utils.stringify_details as sd from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def get_opportunity(identifier): get_opportunity_request ={ "Identifier": identifier, "Catalog": CATALOG_TO_USE } try: # Perform an API call response = partner_central_client.get_opportunity(**get_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def update_opportunity(): update_opportunity_request_orig = sd.stringify_json("src/update_opportunity/update_opportunity_technical_validation.json") update_opportunity_request = helper.remove_nulls(update_opportunity_request_orig) try: # Perform an API call response = partner_central_client.update_opportunity(**update_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def update_opportunity_if_eligible(identifier): response = get_opportunity(identifier) if response is not None: return update_opportunity() else: print("Failed to retrieve opportunity details") def usage_demo(): identifier = "O5465588" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Updating opportunity.") print("-" * 88) helper.pretty_print_datetime(update_opportunity_if_eligible(identifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、AWS SDK for Python (Boto3) API リファレンスの「[UpdateOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/UpdateOpportunity)」を参照してください。** ------ # AWS SDKsシナリオ 次のコード例は、 AWS SDKs を使用して Partner Central で一般的なシナリオを実装する方法を示しています。これらのシナリオは、パートナーセントラル内で複数の機能を呼び出すか、他の AWS のサービスと組み合わせて、特定のタスクを実行する方法を示します。各シナリオには、完全なソースコードへのリンクが含まれており、そこからコードの設定方法と実行方法に関する手順を確認できます。 シナリオは、サービスアクションをコンテキストで理解するのに役立つ中級レベルの経験を対象としています。 **Topics** + [オポチュニティの関連エンティティを更新する](partnercentral-selling_example_partnercentral-selling__UpdateAssociatedEntity_section.md) # オポチュニティの関連エンティティを更新する 次のコード例は、以下を実行する方法を示しています。 + 古いエンティティの関連付けを解除します。 + 新しいエンティティを関連付けます。 ------ #### [ Java ] **SDK for Java 2.x** GitHub には、その他のリソースもあります。[シナリオ](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/partner-central-api-sample-codes/java_preview)リポジトリで完全な例を見つけて、設定と実行の方法を確認してください。 オポチュニティの関連エンティティを更新する ``` package org.example; import static org.example.utils.Constants.*; import org.example.utils.Constants; import org.example.utils.ReferenceCodesUtils; 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.AssociateOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.AssociateOpportunityResponse; import software.amazon.awssdk.services.partnercentralselling.model.DisassociateOpportunityRequest; import software.amazon.awssdk.services.partnercentralselling.model.DisassociateOpportunityResponse; /* Purpose PC-API -17 Replacing a solution */ public class ReplaceSolution { 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 opportunityId = args.length > 0 ? args[0] : OPPORTUNITY_ID; String entityType = "Solutions"; String originalEntityIdentifier = "S-0000000"; String newEntityIdentifier = "S-0011111"; disassociateOppornitityResponse(opportunityId, entityType, originalEntityIdentifier ); AssociateOpportunityResponse associateOpportunityResponse = associateOpportunityResponse(opportunityId, entityType, newEntityIdentifier ); ReferenceCodesUtils.formatOutput(associateOpportunityResponse); } private static AssociateOpportunityResponse associateOpportunityResponse(String opportunityId, String entityType, String entityIdentifier) { AssociateOpportunityRequest associateOpportunityRequest = AssociateOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .opportunityIdentifier(opportunityId) .relatedEntityType(entityType) .relatedEntityIdentifier(entityIdentifier) .build(); AssociateOpportunityResponse response = client.associateOpportunity(associateOpportunityRequest); return response; } private static DisassociateOpportunityResponse disassociateOppornitityResponse(String opportunityId, String entityType, String entityIdentifier) { PartnerCentralSellingClient client = PartnerCentralSellingClient.builder() .region(Region.US_EAST_1) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClient(ApacheHttpClient.builder().build()) .build(); DisassociateOpportunityRequest disassociateOpportunityRequest = DisassociateOpportunityRequest.builder() .catalog(Constants.CATALOG_TO_USE) .opportunityIdentifier(opportunityId) .relatedEntityType(entityType) .relatedEntityIdentifier(entityIdentifier) .build(); DisassociateOpportunityResponse response = client.disassociateOpportunity(disassociateOpportunityRequest); return response; } } ``` + API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の以下のトピックを参照してください。 + [AssociateOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/AssociateOpportunity) + [DisassociateOpportunity](https://docs.aws.amazon.com/goto/SdkForJavaV2/partnercentral-selling-2022-07-26/DisassociateOpportunity) ------ #### [ Python ] **SDK for Python (Boto3)** GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/partner-central-api-sample-codes/python_preview/#code-examples)での設定と実行の方法を確認してください。 オポチュニティの関連エンティティを更新する ``` #!/usr/bin/env python """ Purpose PC-API -17 Replacing a solution """ import logging import boto3 import utils.helpers as helper from botocore.client import ClientError from utils.constants import CATALOG_TO_USE serviceName = "partnercentral-selling" partner_central_client = boto3.client( service_name=serviceName, region_name='us-east-1' ) def replace_solution(original_entity_identifier, new_entity_identifier, opportunityIdentifier): disassociate_opportunity_request ={ "Catalog": CATALOG_TO_USE, "OpportunityIdentifier" : opportunityIdentifier, "RelatedEntityType" : "Solutions", "RelatedEntityIdentifier" : original_entity_identifier } associate_opportunity_request ={ "Catalog": CATALOG_TO_USE, "OpportunityIdentifier" : opportunityIdentifier, "RelatedEntityType" : "Solutions", "RelatedEntityIdentifier" : new_entity_identifier } try: # Perform an API call response = partner_central_client.disassociate_opportunity(**disassociate_opportunity_request) response = partner_central_client.associate_opportunity(**associate_opportunity_request) return response except ClientError as err: # Catch all client exceptions print(err.response) def usage_demo(): original_entity_identifier = "S-0049999" new_entity_identifier = "S-0050014" opportunityIdentifier = "O4397574" logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") print("-" * 88) print("Replacing a solution.") print("-" * 88) helper.pretty_print_datetime(replace_solution(original_entity_identifier, new_entity_identifier, opportunityIdentifier)) if __name__ == "__main__": usage_demo() ``` + API の詳細については、『*AWS SDK for Python (Boto3) API リファレンス*』の以下のトピックを参照してください。 + [AssociateOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/AssociateOpportunity) + [DisassociateOpportunity](https://docs.aws.amazon.com/goto/boto3/partnercentral-selling-2022-07-26/DisassociateOpportunity) ------