feat(client-partnercentral-selling): Add Tagging Support for Opportunity resources

Author: awstools

clients/client-partnercentral-selling/src/commands/CreateOpportunityCommand.ts

@@ -151,6 +151,12 @@ export interface CreateOpportunityCommandOutput extends CreateOpportunityRespons
  *       Phone: "STRING_VALUE",
  *     },
  *   ],
+ *   Tags: [ // TagList
+ *     { // Tag
+ *       Key: "STRING_VALUE", // required
+ *       Value: "STRING_VALUE", // required
+ *     },
+ *   ],
  * };
  * const command = new CreateOpportunityCommand(input);
  * const response = await client.send(command);

clients/client-partnercentral-selling/src/commands/ListOpportunitiesCommand.ts

@@ -36,7 +36,7 @@ export interface ListOpportunitiesCommandInput extends ListOpportunitiesRequest
 export interface ListOpportunitiesCommandOutput extends ListOpportunitiesResponse, __MetadataBearer {}
 
 /**
- * <p>This request accepts a list of filters that retrieve opportunity subsets as well as sort options. This feature is available to partners from <a href="https://partnercentral.awspartner.com/">Partner Central</a> using the <code>ListOpportunities</code> API action.</p> <p>To synchronize your system with Amazon Web Services, only list the opportunities that were newly created or updated. We recommend you rely on events emitted by the service into your Amazon Web Services account’s Amazon EventBridge default event bus, you can also use the <code>ListOpportunities</code> action.</p> <p>We recommend the following approach:</p> <ol> <li> <p>Find the latest <code>LastModifiedDate</code> that you stored, and only use the values that came from Amazon Web Services. Don’t use values generated by your system.</p> </li> <li> <p>When you send a <code>ListOpportunities</code> request, submit the date in ISO 8601 format in the <code>AfterLastModifiedDate</code> filter.</p> </li> <li> <p>Amazon Web Services only returns opportunities created or updated on or after that date and time. Use <code>NextToken</code> to iterate over all pages.</p> </li> </ol>
+ * <p>This request accepts a list of filters that retrieve opportunity subsets as well as sort options. This feature is available to partners from <a href="https://partnercentral.awspartner.com/">Partner Central</a> using the <code>ListOpportunities</code> API action.</p> <p>To synchronize your system with Amazon Web Services, list only the opportunities that were newly created or updated. We recommend you rely on events emitted by the service into your Amazon Web Services account’s Amazon EventBridge default event bus. You can also use the <code>ListOpportunities</code> action.</p> <p>We recommend the following approach:</p> <ol> <li> <p>Find the latest <code>LastModifiedDate</code> that you stored, and only use the values that came from Amazon Web Services. Don’t use values generated by your system.</p> </li> <li> <p>When you send a <code>ListOpportunities</code> request, submit the date in ISO 8601 format in the <code>AfterLastModifiedDate</code> filter.</p> </li> <li> <p>Amazon Web Services only returns opportunities created or updated on or after that date and time. Use <code>NextToken</code> to iterate over all pages.</p> </li> </ol>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-partnercentral-selling/src/commands/StartEngagementFromOpportunityTaskCommand.ts

@@ -40,7 +40,7 @@ export interface StartEngagementFromOpportunityTaskCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>This action initiates the engagement process from an existing opportunity by accepting the engagement invitation and creating a corresponding opportunity in the partner’s system. Similar to <code>StartEngagementByAcceptingInvitationTask</code>, this action is asynchronous and performs multiple steps before completion.</p>
+ * <p>Similar to <code>StartEngagementByAcceptingInvitationTask</code>, this action is asynchronous and performs multiple steps before completion. This action orchestrates a comprehensive workflow that combines multiple API operations into a single task to create and initiate an engagement from an existing opportunity. It automatically executes a sequence of operations including <code>GetOpportunity</code>, <code>CreateEngagement</code> (if it doesn't exist), <code>CreateResourceSnapshot</code>, <code>CreateResourceSnapshotJob</code>, <code>CreateEngagementInvitation</code> (if not already invited/accepted), and <code>SubmitOpportunity</code>. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-partnercentral-selling/src/models/models_0.ts

@@ -1265,13 +1265,13 @@ export interface ExpectedCustomerSpend {
   CurrencyCode: CurrencyCode | undefined;
 
   /**
-   * <p>Indicates how frequently the customer is expected to spend the projected amount. This can include values such as <code>Monthly</code>, <code>Quarterly</code>, or <code>Annually</code>. The default value is <code>Monthly</code>, representing recurring monthly spend.</p>
+   * <p>Indicates how frequently the customer is expected to spend the projected amount. Only the value <code>Monthly</code> is allowed for the <code>Frequency</code> field, representing recurring monthly spend.</p>
    * @public
    */
   Frequency: PaymentFrequency | undefined;
 
   /**
-   * <p>Specifies the name of the partner company that is expected to generate revenue from the opportunity. This field helps track the partner’s involvement in the opportunity.</p>
+   * <p>Specifies the name of the partner company that is expected to generate revenue from the opportunity. This field helps track the partner’s involvement in the opportunity. This field only accepts the value <code>AWS</code>. If any other value is provided, the system will automatically set it to <code>AWS</code>.</p>
    * @public
    */
   TargetCompany: string | undefined;
@@ -3300,13 +3300,13 @@ export interface LifeCycle {
   ReviewStatus?: ReviewStatus | undefined;
 
   /**
-   * <p>Indicates why an opportunity was sent back for further details. Partners must take corrective action based on the <code>ReviewComments</code>.</p>
+   * <p>Contains detailed feedback from Amazon Web Services when requesting additional information from partners. Provides specific guidance on what partners need to provide or clarify for opportunity validation, complementing the <code>ReviewStatusReason</code> field.</p>
    * @public
    */
   ReviewComments?: string | undefined;
 
   /**
-   * <p>Indicates the reason a decision was made during the opportunity review process. This field combines the reasons for both disqualified and action required statuses, and provide clarity for why an opportunity was disqualified or requires further action.</p>
+   * <p>Code indicating the validation decision during the Amazon Web Services opportunity review. Applies when status is <code>Rejected</code> or <code>Action Required</code>. Used to document validation results for AWS Partner Referrals and indicate when additional information is needed from partners as part of the APN Customer Engagement (ACE) program.</p>
    * @public
    */
   ReviewStatusReason?: string | undefined;
@@ -3739,6 +3739,12 @@ export interface CreateOpportunityRequest {
    * @public
    */
   OpportunityTeam?: Contact[] | undefined;
+
+  /**
+   * <p>A map of the key-value pairs of the tag or tags to assign.</p>
+   * @public
+   */
+  Tags?: Tag[] | undefined;
 }
 
 /**
@@ -5672,6 +5678,7 @@ export const AwsOpportunityLifeCycleFilterSensitiveLog = (obj: AwsOpportunityLif
  */
 export const ExpectedCustomerSpendFilterSensitiveLog = (obj: ExpectedCustomerSpend): any => ({
   ...obj,
+  ...(obj.Amount && { Amount: SENSITIVE_STRING }),
   ...(obj.CurrencyCode && { CurrencyCode: SENSITIVE_STRING }),
   ...(obj.EstimationUrl && { EstimationUrl: SENSITIVE_STRING }),
 });

clients/client-partnercentral-selling/src/protocols/Aws_json1_0.ts

@@ -1702,6 +1702,7 @@ const se_CreateOpportunityRequest = (input: CreateOpportunityRequest, context: _
     PrimaryNeedsFromAws: _json,
     Project: _json,
     SoftwareRevenue: _json,
+    Tags: _json,
   });
 };