AWS PRM documentation change
Summary
Updated Partner Revenue Measurement FAQ with expanded implementation details, added new questions about User Agent String attribution frequency and tag restrictions, removed specific troubleshooting steps, and consolidated troubleshooting to a separate page.
Security assessment
The changes are administrative and instructional updates to Partner Revenue Measurement documentation. They clarify implementation methods (Marketplace Metering, Resource Tagging, User Agent String) and provide guidance for multi-partner scenarios and customer environments with tag restrictions. There is no mention of security vulnerabilities, patches, or incidents. The reference to CloudTrail logs for User Agent strings is for operational visibility and auditing, not a security feature introduction.
Diff
diff --git a/PRM/latest/aws-prm-onboarding-guide/prm-faqs.md b/PRM/latest/aws-prm-onboarding-guide/prm-faqs.md index f26e93efb..03fd33ed0 100644 --- a//PRM/latest/aws-prm-onboarding-guide/prm-faqs.md +++ b//PRM/latest/aws-prm-onboarding-guide/prm-faqs.md @@ -13 +13 @@ -Partner Revenue Measurement refers to AWS Partner Network's (APN) capabilities to track and quantify the impact AWS partners have on overall AWS revenue. Partner Revenue Measurement empowers AWS Partners to demonstrate their AWS revenue impact by tagging AWS resources with their product identifier. +Partner Revenue Measurement is a set of capabilities that enables AWS Partners to measure the AWS service consumption driven by their solutions and quantify their impact on overall AWS revenue. These capabilities empower AWS Partners to better understand their AWS revenue impact and product consumption patterns. Partner Revenue Measurement offers three implementation options: [AWS Marketplace Metering](./marketplace-metering.html), [Resource Tagging](./resource-tagging.html), and [User Agent String](./user-agent-string.html). @@ -17 +17 @@ Partner Revenue Measurement refers to AWS Partner Network's (APN) capabilities t -Partner Revenue Measurement supports AWS services for resource tagging. See [Resource Tagging supported services](./included-aws-services.html#resource-tagging-supported-services) for complete list. +Partner Revenue Measurement supports AWS services across implementation methods. The supported services vary by method. See [AWS Marketplace Metering included services](./included-aws-services-marketplace-metering.html), [Resource Tagging included services](./resource-tagging-included-services.html), and [User Agent String included services](./user-agent-included-services.html) for complete lists. @@ -33 +33 @@ Contact your AWS partner management team or [APN Support](https://partnercentral -Since an AWS resource can only have one tag with the 'aws-apn-id' key, you must remove the existing tag and add your new tag. For example, if an S3 bucket has a tag with key 'aws-apn-id' and value 'pc:5ugbbrmu7ud3u5hsipfzug61p', you need to remove that tag and add your own with key 'aws-apn-id' and value 'pc:5ugbbrmu7ud3u5hsipfzug61p'. +Since an AWS resource can only have one tag with the `aws-apn-id` key, only one partner identifier is allowed per resource. For multi-partner scenarios where multiple partners operate on the same AWS resource, consider using the [User Agent String](./user-agent-string.html) method instead. If you must use resource tagging, coordinate with the other partner and the customer to determine tag ownership before making changes. @@ -43,5 +43 @@ Partner Revenue Measurement currently supports only Commercial regions, not Euro -## 2\. Troubleshooting - -### 2.1 My tags are not showing revenue attribution. What should I check? - - * Verify tag format: Key must be **aws-apn-id** , value must start with **pc:** +### 1.9 How often does my partner solution need to make regular AWS API/CLI calls for User Agent based attribution? @@ -49 +45 @@ Partner Revenue Measurement currently supports only Commercial regions, not Euro - * Confirm product code matches AWS Marketplace listing exactly (see [Retrieve your product code](./product-code-retrieval.html)) +Your partner solution must make at least one regular AWS API/CLI call per resource per month. Attribution is evaluated on a monthly billing cycle. If no calls are made on a resource in a given month, that resource does not contribute to revenue attribution for that month. Attribution resumes the next month a qualifying call is made. In scenarios where your partner solution does not make frequent calls, you can use non-mutating, read-only calls (such as `Describe*` operations) to demonstrate continued interaction. Refer to the [included services](./user-agent-included-services.html) for supported API actions. @@ -51,5 +47 @@ Partner Revenue Measurement currently supports only Commercial regions, not Euro - * Ensure resources are in [supported services](./included-aws-services.html#resource-tagging-supported-services) - - * Check that resources are actively consuming AWS services and incurring spend. Partner Revenue Measurement tracks revenue attribution based on AWS service consumption. For example, IAM is a no-cost AWS service, so tagging IAM resources will not generate revenue attribution. Focus on tagging resources that incur charges such as EC2 instances, S3 buckets with storage, RDS databases, or Lambda functions with invocations - - * Verify tags are applied correctly using [AWS Tag Editor](./automated-tagging.html#tag-editor-bulk-tagging) or reach out to your AWS partner management team or [APN Support](https://partnercentral.awspartner.com/partnercentral2/s/support) (Partner Central login required) for assistance +### 1.10 What are my options if the customer's environment does not permit additional resource tags? @@ -56,0 +49 @@ Partner Revenue Measurement currently supports only Commercial regions, not Euro +Use the [User Agent String](./user-agent-string.html) method instead. User Agent strings do not require adding user-defined tags to any AWS resource, do not consume the customer's tag quota, and do not interfere with existing tag policies. The User Agent string is captured in AWS CloudTrail logs, which also provides the customer with operational visibility into partner solution activity for auditing and operational excellence purposes. @@ -57,0 +51 @@ Partner Revenue Measurement currently supports only Commercial regions, not Euro +## 2\. Troubleshooting @@ -58,0 +53 @@ Partner Revenue Measurement currently supports only Commercial regions, not Euro +For troubleshooting guidance across all implementation methods, see [Troubleshooting Partner Revenue Measurement](./troubleshooting.html).