[ aws . partnercentral-selling ]

get-aws-opportunity-summary

Description

Retrieves a summary of an AWS Opportunity. This summary includes high-level details about the opportunity sourced from AWS, such as lifecycle information, customer details, and involvement type. It is useful for tracking updates on the AWS opportunity corresponding to an opportunity in the partner’s account.

See also: AWS API Documentation

Synopsis

  get-aws-opportunity-summary
--catalog <value>
--related-opportunity-identifier <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Options

--catalog (string) [required]

Specifies the catalog in which the AWS Opportunity is located. Accepted values include AWS for production opportunities or Sandbox for testing purposes. The catalog determines which environment the opportunity data is pulled from.

Constraints:

• pattern: [a-zA-Z]+

--related-opportunity-identifier (string) [required]

The unique identifier for the related partner opportunity. Use this field to correlate an AWS opportunity with its corresponding partner opportunity.

Constraints:

• pattern: O[0-9]{1,19}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command’s default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

• on
• off
• auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

--cli-binary-format (string)

The formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary blobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS CLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a binary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

Disable cli pager for output.

--cli-auto-prompt (boolean)

Automatically prompt for CLI input parameters.

--no-cli-auto-prompt (boolean)

Disable automatically prompt for CLI input parameters.

Output

Catalog -> (string)

Specifies the catalog in which the AWS Opportunity exists. This is the environment (e.g., AWS or Sandbox ) where the opportunity is being managed.

Constraints:

• pattern: [a-zA-Z]+

RelatedOpportunityId -> (string)

Provides the unique identifier of the related partner opportunity, allowing partners to link the AWS Opportunity to their corresponding opportunity in their CRM system.

Constraints:

• pattern: O[0-9]{1,19}

Origin -> (string)

Specifies whether the AWS Opportunity originated from AWS or the partner. This helps distinguish between opportunities that were sourced by AWS and those referred by the partner.

Possible values:

• AWS Referral
• Partner Referral

InvolvementType -> (string)

Specifies the type of involvement AWS has in the opportunity, such as direct cosell or advisory support. This field helps partners understand the role AWS plays in advancing the opportunity.

Possible values:

• For Visibility Only
• Co-Sell

Visibility -> (string)

Defines the visibility level for the AWS Opportunity. Use Full visibility for most cases, while Limited visibility is reserved for special programs or sensitive opportunities.

Possible values:

• Full
• Limited

LifeCycle -> (structure)

Contains lifecycle information for the AWS Opportunity, including review status, stage, and target close date. This field is crucial for partners to monitor the progression of the opportunity.

TargetCloseDate -> (string)

Indicates the expected date by which the opportunity is projected to close. This field helps in planning resources and timelines for both the partner and AWS.

Constraints:

• pattern: [1-9][0-9]{3}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ClosedLostReason -> (string)

Indicates the reason why an opportunity was marked as Closed Lost . This helps in understanding the context behind the lost opportunity and aids in refining future strategies.

Possible values:

• Administrative
• Business Associate Agreement
• Company Acquired/Dissolved
• Competitive Offering
• Customer Data Requirement
• Customer Deficiency
• Customer Experience
• Delay / Cancellation of Project
• Duplicate
• Duplicate Opportunity
• Executive Blocker
• Failed Vetting
• Feature Limitation
• Financial/Commercial
• Insufficient Amazon Value
• Insufficient AWS Value
• International Constraints
• Legal / Tax / Regulatory
• Legal Terms and Conditions
• Lost to Competitor
• Lost to Competitor - Google
• Lost to Competitor - Microsoft
• Lost to Competitor - Other
• Lost to Competitor - Rackspace
• Lost to Competitor - SoftLayer
• Lost to Competitor - VMWare
• No Customer Reference
• No Integration Resources
• No Opportunity
• No Perceived Value of MP
• No Response
• Not Committed to AWS
• No Update
• On Premises Deployment
• Other
• Other (Details in Description)
• Partner Gap
• Past Due
• People/Relationship/Governance
• Platform Technology Limitation
• Preference for Competitor
• Price
• Product/Technology
• Product Not on AWS
• Security / Compliance
• Self-Service
• Technical Limitations
• Term Sheet Impasse

Stage -> (string)

Represents the current stage of the opportunity in its lifecycle, such as Qualification , Validation , or Closed Won . This helps in understanding the opportunity’s progress.

Possible values:

• Not Started
• In Progress
• Prospect
• Engaged
• Identified
• Qualify
• Research
• Seller Engaged
• Evaluating
• Seller Registered
• Term Sheet Negotiation
• Contract Negotiation
• Onboarding
• Building Integration
• Qualified
• On-hold
• Technical Validation
• Business Validation
• Committed
• Launched
• Deferred to Partner
• Closed Lost
• Completed
• Closed Incomplete

NextSteps -> (string)

Specifies the immediate next steps required to progress the opportunity. These steps are based on AWS guidance and the current stage of the opportunity.

Constraints:

• min: 0
• max: 255

NextStepsHistory -> (list)

Provides a historical log of previous next steps that were taken to move the opportunity forward. This helps in tracking the decision-making process and identifying any delays or obstacles encountered.

Constraints:

• min: 0
• max: 50

(structure)

Tracks the history of next steps associated with the opportunity. This field captures the actions planned for the future and their timeline.

Value -> (string) [required]

Represents the details of the next step recorded, such as follow-up actions or decisions made. This field helps in tracking progress and ensuring alignment with project goals.

Time -> (timestamp) [required]

Indicates the date and time when a particular next step was recorded or planned. This helps in managing the timeline for the opportunity.

OpportunityTeam -> (list)

Details the AWS opportunity team, including members involved. This information helps partners know who from AWS is engaged and what their role is.

(structure)

Represents an Amazon Web Services team member for the engagement. This structure includes details such as name, email, and business title.

Email -> (string)

Provides the Amazon Web Services team member’s email address.

Constraints:

• min: 0
• max: 80
• pattern: [a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?

FirstName -> (string)

Provides the Amazon Web Services team member’s first name.

Constraints:

• min: 0
• max: 80

LastName -> (string)

Provides the Amazon Web Services team member’s last name.

Constraints:

• min: 0
• max: 80

BusinessTitle -> (string)

Specifies the Amazon Web Services team member’s business title and indicates their organizational role.

Possible values:

• AWSSalesRep
• AWSAccountOwner
• WWPSPDM
• PDM
• PSM
• ISVSM

Insights -> (structure)

Provides insights into the AWS Opportunity, including engagement score and recommended actions that AWS suggests for the partner.

NextBestActions -> (string)

Provides recommendations from AWS on the next best actions to take in order to move the opportunity forward and increase the likelihood of success.

EngagementScore -> (string)

Represents a score assigned by AWS to indicate the level of engagement and potential success for the opportunity. This score helps partners prioritize their efforts.

Possible values:

• High
• Medium
• Low

InvolvementTypeChangeReason -> (string)

Provides a reason for any changes in the involvement type of AWS in the opportunity. This field is used to track why the level of AWS engagement has changed from For Visibility Only to Co-sell offering transparency into the partnership dynamics.

Possible values:

• Expansion Opportunity
• Change in Deal Information
• Customer Requested
• Technical Complexity
• Risk Mitigation

RelatedEntityIds -> (structure)

Lists related entity identifiers, such as AWS products or partner solutions, associated with the AWS Opportunity. These identifiers provide additional context and help partners understand which AWS services are involved.

AwsProducts -> (list)

Specifies the AWS products associated with the opportunity. This field helps track the specific products that are part of the proposed solution.

(string)

Solutions -> (list)

Specifies the partner solutions related to the opportunity. These solutions represent the partner’s offerings that are being positioned as part of the overall AWS opportunity.

(string)

Constraints:

• pattern: S-[0-9]{1,19}

Customer -> (structure)

Provides details about the customer associated with the AWS Opportunity, including account information, industry, and other customer data. These details help partners understand the business context of the opportunity.

Contacts -> (list)

Provides a list of customer contacts involved in the opportunity. These contacts may include decision makers, influencers, and other stakeholders within the customer’s organization.

(structure)

An object that contains a Customer Partner ‘s contact details.

Email -> (string)

The contact’s email address associated with the Opportunity .

Constraints:

• min: 0
• max: 80
• pattern: [a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?

FirstName -> (string)

The contact’s first name associated with the Opportunity .

Constraints:

• min: 0
• max: 80

LastName -> (string)

The contact’s last name associated with the Opportunity .

Constraints:

• min: 0
• max: 80

BusinessTitle -> (string)

The partner contact’s title (job title or role) associated with the Opportunity . BusinessTitle supports either PartnerAccountManager or OpportunityOwner .

Constraints:

• min: 0
• max: 80

Phone -> (string)

The contact’s phone number associated with the Opportunity .

Constraints:

• min: 0
• max: 40
• pattern: \+[1-9]\d{1,14}

Project -> (structure)

Provides details about the project associated with the AWS Opportunity, including the customer’s business problem, expected outcomes, and project scope. This information is crucial for understanding the broader context of the opportunity.

ExpectedCustomerSpend -> (list)

Indicates the expected spending by the customer over the course of the project. This value helps partners and AWS estimate the financial impact of the opportunity. Use the AWS Pricing Calculator to create an estimate of the customer’s total spend. If only annual recurring revenue (ARR) is available, distribute it across 12 months to provide an average monthly value.

Constraints:

• min: 0
• max: 10

(structure)

Provides an estimate of the revenue that the partner is expected to generate from the opportunity. This information helps partners assess the financial value of the project.

Amount -> (string) [required]

Represents the estimated monthly revenue that the partner expects to earn from the opportunity. This helps in forecasting financial returns.

Constraints:

• pattern: (0|([1-9][0-9]{0,30}))(\.[0-9]{0,2})?

CurrencyCode -> (string) [required]

Indicates the currency in which the revenue estimate is provided. This helps in understanding the financial impact across different markets.

Possible values:

• USD
• EUR
• GBP
• AUD
• CAD
• CNY
• NZD
• INR
• JPY
• CHF
• SEK
• AED
• AFN
• ALL
• AMD
• ANG
• AOA
• ARS
• AWG
• AZN
• BAM
• BBD
• BDT
• BGN
• BHD
• BIF
• BMD
• BND
• BOB
• BOV
• BRL
• BSD
• BTN
• BWP
• BYN
• BZD
• CDF
• CHE
• CHW
• CLF
• CLP
• COP
• COU
• CRC
• CUC
• CUP
• CVE
• CZK
• DJF
• DKK
• DOP
• DZD
• EGP
• ERN
• ETB
• FJD
• FKP
• GEL
• GHS
• GIP
• GMD
• GNF
• GTQ
• GYD
• HKD
• HNL
• HRK
• HTG
• HUF
• IDR
• ILS
• IQD
• IRR
• ISK
• JMD
• JOD
• KES
• KGS
• KHR
• KMF
• KPW
• KRW
• KWD
• KYD
• KZT
• LAK
• LBP
• LKR
• LRD
• LSL
• LYD
• MAD
• MDL
• MGA
• MKD
• MMK
• MNT
• MOP
• MRU
• MUR
• MVR
• MWK
• MXN
• MXV
• MYR
• MZN
• NAD
• NGN
• NIO
• NOK
• NPR
• OMR
• PAB
• PEN
• PGK
• PHP
• PKR
• PLN
• PYG
• QAR
• RON
• RSD
• RUB
• RWF
• SAR
• SBD
• SCR
• SDG
• SGD
• SHP
• SLL
• SOS
• SRD
• SSP
• STN
• SVC
• SYP
• SZL
• THB
• TJS
• TMT
• TND
• TOP
• TRY
• TTD
• TWD
• TZS
• UAH
• UGX
• USN
• UYI
• UYU
• UZS
• VEF
• VND
• VUV
• WST
• XAF
• XCD
• XDR
• XOF
• XPF
• XSU
• XUA
• YER
• ZAR
• ZMW
• ZWL

Constraints:

• pattern: USD

Frequency -> (string) [required]

Indicates how frequently the customer is expected to spend the projected amount. Only the value Monthly is allowed for the Frequency field, representing recurring monthly spend.

Possible values:

• Monthly

TargetCompany -> (string) [required]

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 AWS . If any other value is provided, the system will automatically set it to AWS .

Constraints:

• min: 1
• max: 80

EstimationUrl -> (string)

A URL providing additional information or context about the spend estimation.

Constraints:

• min: 4
• max: 255