View a markdown version of this page

Error responses - AWS Marketplace
ValidationExceptionResourceNotFoundException

Error responses

The following error codes may be returned for more than one use case. Use the descriptions below to understand the different scenarios in which each error code can occur. The scenarios listed are not exhaustive and may be updated as new features are added.

ValidationException

Error code Description
INVALID_SOURCE_AGREEMENT_IDENTIFIER Returned when the source agreement identifier does not match the expected format, or when a source agreement identifier is provided for an intent that does not require one (such as NEW).
MISSING_SOURCE_AGREEMENT_IDENTIFIER Returned when the source agreement identifier is not provided for an intent that requires one (such as REPLACE or AMEND).
INVALID_REQUESTED_TERM_CONFIGURATION

Returned when the requested term configuration is not valid. Possible scenarios:

  • A configuration is provided for a term that does not accept one.

  • A required configuration is missing.

  • The selector value does not belong to the agreement proposal.

  • The dimensions can only contain one dimension when multiple dimension selection is not allowed.

  • A dimension key is not recognized in the agreement proposal or accepted terms.

  • A dimension value can only be 1 when quantity configuration is not enabled for the dimension.

  • The configuration contains duplicate dimension keys.

  • The configuration does not differ from the source agreement.
INVALID_AGREEMENT_PROPOSAL_IDENTIFIER Returned when the agreement proposal identifier does not match the expected format, or when an agreement proposal identifier is provided for an intent that does not require one (such as AMEND).
MISSING_AGREEMENT_PROPOSAL_IDENTIFIER Returned when the agreement proposal identifier is not provided for an intent that requires one (such as NEW or REPLACE).
INVALID_FILTER_NAME Returned when the provided filter name is not a recognized filter, or when duplicate filter names are included in the request.
INVALID_FILTER_VALUES Returned when filter values are invalid, duplicated, empty, exceed the maximum allowed count, or when a date range filter specifies a BeforeEndTime value that precedes the AfterEndTime value.
INVALID_NEXT_TOKEN Returned when the pagination token is malformed, expired, cannot be decrypted, or when request parameters have changed between paginated calls.
DUPLICATE_CHARGES Returned when the request contains duplicate charge identifiers, or when different purchase order values are provided for the same charge identifier.
UNSUPPORTED_FILTERS Returned when the provided combination of filters is not supported. Supported filter combinations vary based on party type. Check the supported combinations in the public documentation.
INVALID_PURCHASE_ORDER_REFERENCE Returned when the purchase order reference does not meet format requirements, or when a required purchase order is not provided as configured by the account administrator.
INVALID_CHARGE_AMOUNT

Returned when the charge amount is not valid. Possible scenarios:

  • The charge amount exceeds the maximum total charge amount for the term.

  • The charge amount format does not match the currency requirements (for example, too many decimal places).

  • No remaining amount is available because the agreement has reached the maximum total charge amount.
UNSUPPORTED_ACTION

Returned when the requested operation is not supported for the current state of the resource. The specific scenarios vary by API:

  • UpdatePurchaseOrders – The charge date is in the past and auto renewal is disabled, the charge date is within 3 hours, the charge is a refund charge, the charge revision is not the latest, the purchase orders do not all belong to the same agreement, or the agreement is not active.

  • CreateAgreementRequest – Amending a future-dated agreement is not supported, the resource type and term type combination does not support the requested intent, replacing an active agreement with a future-dated agreement is not allowed, the agreement duration cannot be changed during amendment, the agreement cannot be updated at this time (for example, pending entitlements exist), the agreement proposal must refer to the same resource as the source agreement, the agreement proposal must differ from the source agreement, or the agreement type does not support this action.

  • AcceptAgreementRequest – The resource type and term type combination does not support this action, the agreement type does not support this action, an active agreement already exists on the same resource, or the agreement cannot be updated at this time.

  • CancelAgreement – The agreement has pending entitlements, the agreement type does not support cancellation, an agreement with UsageBasedPricingTerm cannot be cancelled while an agreement with ConfigurableUpfrontPricingTerm or PaymentScheduleTerm is still active on the same resource, or the resource type and term type combination does not support cancellation.

  • GetBillingAdjustmentRequest – The agreement is a non-purchase agreement type, or the caller is the acceptor of the agreement.

  • SendAgreementCancellationRequest – The agreement type does not support this action.

  • AcceptAgreementCancellationRequest – The agreement type does not support this action.

  • RejectAgreementCancellationRequest – The agreement type does not support this action.

  • CancelAgreementCancellationRequest – The agreement type does not support this action.

  • GetAgreementCancellationRequest – The agreement is a non-purchase agreement type.

ResourceNotFoundException

The ResourceNotFoundException includes resourceType and resourceId fields that identify the resource that could not be found. The following table describes the scenarios that can cause this exception for each resource type.

Note

For security reasons, the same error is returned whether a resource does not exist or the caller does not have access to it. This prevents enumeration of valid resource identifiers.

Resource type Possible scenarios
AgreementProposal

  • No agreement proposal found for the given identifier.

  • The offer is not targeted to the acceptor.

  • The offer is not available in the acceptor's country.
Agreement

  • No agreement found for the given identifier.

  • The caller is neither the acceptor nor the proposer of the agreement.
AgreementRequest

  • No agreement request found for the given identifier.

  • The agreement request belongs to another caller.

  • The agreement request has expired.

  • The agreement request has been superseded by a subsequent accepted request on the same product or offer.

  • The agreement proposal became inactive between CreateAgreementRequest and AcceptAgreementRequest calls due to offer republishing or offer expiration.
Charge

  • No charge found for the given identifier.

  • The charge does not belong to the specified agreement.
BillingAdjustmentRequest

  • No billing adjustment request found for the given identifier.

  • The caller is neither the acceptor nor the proposer of the agreement associated with the adjustment.
AgreementCancellationRequest

  • No agreement cancellation request found for the given identifier.

  • The caller is neither the acceptor nor the proposer of the agreement associated with the cancellation request.
PaymentRequest

  • No payment request found for the given identifier.

  • The caller is neither the acceptor nor the proposer of the agreement associated with the payment request.