"requestReceivedDateTime": "2016-08-05T03:14:50.108Z", "requestCompletedDateTime": "2016-08-05T03:14:50.334Z"
}
Output data format
The output data contains customer contact records, product code, product ID, subscription start date, and the AWS account ID of the customer. A summary of the fields is shown in the following table. Each output file contains a comma-separated header, followed by the records containing customer data and subscription information. Each record contains a “Create”, “Update”, or “Delete” operation type to indicate whether the record is newly created, modified, or deleted since the “From Date” indicated in the API request. The overall file format adheres to the RFC4180 standard.
If multiple operations have occurred on a record in the time frame specified by the “from-date”
parameter API request, only the most recent data will be reflected or exported. For example, if a customer creates and then updates a record, the record returned will be different depending on the specified “from-date”. If the “from-date” is prior to the date at which the record was created, only a CREATE record will be passed in the output data set, and the record will reflect the most recently entered details. If the “from-date” is after the record was created, but before it was updated, only an UPDATE record will be passed in the output data set. If the from-date is after the record was updated, no record will be passed. Likewise, if a customer creates and then deletes a record, only the “DELETE” will appear in the output file.
If you would like to receive the full dataset, as opposed to a set of updates, specify any date prior to the date when you onboarded to the program. To receive only incremental data since your last request, specify the endDateTime from the dataSetCoverageRange from the metadata JSON file resulting from your previous request.
Field Format Description
Product ID 36-character hexadecimal string Unique identifier for the product in AWS Marketplace (GUID).
Required field; always appears in every record.
Product Code 25-character alphanumeric
string Unique identifier for the
product, associated with billing and available in Amazon Elastic Compute Cloud (Amazon EC2) instance metadata.
Required field; always appears in every record.
Customer Guid 36-character hexadecimal string Unique GUID identifying the customer contact data record.
This will be unique for each record that appears in the output file.
Required field; always appears in every record.
Subscription Guid 36-character hexadecimal string Unique GUID corresponding to the customer’s product subscription. A customer can
Product Support Connection
Field Format Description
have multiple subscriptions to the same product.
Required field; always appears in every record.
Subscription Start Date ISO 8601 date/time, with UTC time zone.
The format is YYYY-MM-DDTHH:mm:ss.nnnZ, where YYYY is year, MM is month, DD is day, HH is hour from 00-23, mm is minute of hour from 00-59, ss is second of minute from 00-59, and nnn is millisecond of second from 000-9999, such as
“2016-04-07T14:05:15.275Z”
Start date of the customer’s product subscription.
Required field; always appears in every record.
Organization String with a maximum length
of 255 characters Organization name provided by the customer.
Always appears in records with operation type “Update” or
“Create.” Does not appear in records with operation type
“Delete.”
AWS Customer Id 12-digit numeric string which
may include leading zeroes The AWS customer ID for the customer subscribed to the product.
Required field; always appears in every record.
Given Name String with a maximum length
of 100 characters Given name or first name for the point of contact provided by the customer.
Always appears in records with operation type “Update” or
“Create.” Does not appear in records with operation type
“Delete.”
Surname String with a maximum length
of 100 characters Surname (family name or last name) for the point of contact provided by the customer.
Always appears in records with operation type “Update” or
“Create.” Does not appear in records with operation type
“Delete.”
Product Support Connection
Field Format Description
Telephone Number String with a maximum length of 25 characters. May include international phone numbers.
Telephone number provided by the customer.
Always appears in records with operation type “Update” or
“Create.” Does not appear in records with operation type
“Delete.”
Email String with a maximum length
of 254 characters Email address provided by the customer.
Always appears in records with operation type “Update” or
“Create.” Does not appear in records with operation type
“Delete.”
Title String with a maximum length
of 255 characters Job title provided by the customer.
Optional field. Will sometimes occur in records with operation type “Update” or “Create.”
Does not appear in records with operation type “Delete.”
Country Code 2-character ISO 3166 country
code Country code provided by the
customer.
Optional field. Will sometimes occur in records with operation type “Update” or “Create.”
Does not appear in records with operation type “Delete.”
ZIP Code 5-digit string Zip code provided by the
customer; applicable to USA only.
Optional field. Will sometimes occur in records with operation type “Update” or “Create.”
Does not appear in records with operation type “Delete.”
Product Support Connection
Field Format Description
Operation Time ISO 8601 date/time, with UTC time zone. The format is YYYY-MM-DDTHH:mm:ss.nnnZ (YYYY is year, MM is month, DD is day of month, HH is hour of day from 00-23, mm is minute of hour from 00-59, ss is second of minute from 00-59 and nnn is millisecond of second from 000-9999), such as
“2016-04-07T14:05:15.275Z”
Indicates the date/time when the record was most recently created, updated, or deleted by the customer.
Required field; always appears in every record.
Operation Type String; possible values are
“CREATE”, “UPDATE”, or
“DELETE”
CREATE: Indicates that the record has been newly created since the from-date specified in the API request.
UPDATE: Indicates that the record has been updated since the from-date specified in the API request.
DELETE: Indicates that the record has been deleted since the from-date specified in the API request.
Required field; always appears in every record.
An example of the output file format is shown below.
Product Id,Product Code,Customer Guid,Subscription Guid,Subscription Start Date,Organization,AWS Customer Id,Given Name,Surname,Telephone Number,Email,Title,Country Code,ZIP Code,Operation Time,Operation Type Inc -- European Sales Division,111122223333,Ravi,Smith,555-111-1010,[email protected],Head of IT,ES,,2016-04-07T14:05:15.145Z,CREATE
4b898955-84fa-4cfb-8f43-98287ad69c06,4gzp2symm0v9zidfrn9f854w6,1b4a2b5f-2c5d-4779-
b0c7-2878b0f45cfc,cad371fb-6f2c-4537-a054-1a7afc6312fd,2016-05-01T00:00:00.000Z,,000011112222,,,,,,,,2016-04-22T14:36:24.054Z,DELETE
More resources in AWS Marketplace Management Portal
3f4300eb-bfa0-4610-8d68- d8ba71baaa50,3qtu9xydxldrj8c5jyldy1lqo,91c72621-6cf4-4d69-8ebe-073ff4f8ab9e,d118eb96-55ce-4752-909c-eedcfdcd6647,2015-11-30T00:00:00.000Z,Example Inc -- Design
Division,333344445555,Nathan,Zhenyuan,555-2222-1010,[email protected],Sr. Program Manager,US,98109,2016-04-07T14:05:15.275Z,CREATE
3f4300eb-bfa0-4610-8d68-d8ba71baaa50,3qtu9xydxldrj8c5jyldy1lqo,2ae0be12-7397-4fdb-a1c7-ead17967002c,d118eb96-55ce-4752-909c-eedcfdcd6647,2016-05-01T00:00:00.000Z,Example Inc --Design
Division,333344445555,Abdul,Alves,555-676-8989,[email protected],,,,2016-05-11T05:26:51.000Z,UPDATE ...
NoteWhen a customer deletes their contact information from the PSC program, you will see a record in the output .csv file that indicates an operation type “DELETE.” After a customer deletes their data, the API no longer transmits contact information such as name, telephone number, email, and so forth. Each delete record consists of the data required to uniquely identify the record to be deleted. Delete records contain product ID, product code, operation time, customer GUID, subscription GUID, subscription start date, AWS Customer ID, operation time, and operation type.
If a customer opts out of Product Support Connection by deleting their contact information, you should also remove the contact information from your records. Because the customer contact data will not be included in the DELETE record, you will need to look up the record in your system by using the unique Customer GUID.
A delete record will also be sent if a customer terminates a subscription.
If you have questions or would like more information about participating in AWS Marketplace Product Support Connection, contact the AWS Marketplace Seller Operations team.