Querying describeExport API (Multiple Signed URL Response)

Query Request

When the describeExport GQL query is executed, an S3 signed URL of the requested file is returned with its expiration time, if available, otherwise a 404 response is returned.

Argument: The DescribeExport query takes four arguments: customer, year, month, and type (e.g., “telemetry”). These parameters specify the customer and the time period for which the export data is being requested.

Query Response

Query Response for describeExport with single and multiple signed URL responses provided below.

API Limits and Usage

Each user is currently allowed up to 100 requests per second. If this limit is exceeded, ADA will respond with an HTTP 429 Too Many Requests status code. To manage and mitigate potential exploits, WAF (Web Application Firewall) rules are in place. API consumption is monitored through usage plans associated with each customer’s API key. At present, there are no quota limits based on usage.

QUERY
                    
                      query DescribeExport {
describeExport(
customer: "cib",
day: 1,
hour: 0,
month: 2,
year: 2023,
format: "parquet",
type: "telemetry"
) {
location
expires
statusCode
}
}
Multiple Signed URL Response
                    
                      {
"data": {
"describeExport": {
"location": "https://amazon-customer-data-external.s3.amazonaws.com/data/year%3D2024/month%3D08/day%3D01/cib-telemetry-2024-08-01-23-00-45-00.parquet?AWSAccessKeyId=ASIA6K5QIROCQO4WUWYW&Signature=kp8iJ4NNDInaZaZ7XKI4VOTORok%3D&x-amz-security-token=IQoJb3JpZ2luX2VjEAUaCXVzLWVhc3QtMSJIMEYCIQDv29OLupwG1s3IW4jSwnvUjTkPfCMn95GHQ0u4VsQQJwIhAO4aKJtvTGVntV51xk%2FseVNosihEqtY8yYJ1ThE27ylBKqgDCO7%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQABoMOTg1NTI3NzgyMjc3Igz%2FOJqZLajYnnCj2ZIq%2FAJn7Kk%2BzSkHwtWzGRVVWJlbgZ3mrdrOSyctF6%2FhFBohMdfexHRk%2BWqm%2BfoUfGrIINUhOp9ApwZNpcFGBshDMGKVNB4DrNqTdrwg4Y34j9rtL0Uqcw0e4HCFGCSmo7JhSllRuXAhSK5gQcBK1jzpCn9Uzst8Ot7W89gfukCeaQ5bHDfT5OrxGtq3k3uqHe4LsBTmB3r%2FFfbRTyEgsPgouZbL9ksrkOnGwQITJgznJhR6%2BUPpgplfhhAT74211kVjpP6V536AIUqKmgSEZ1Cpal3bEEtT5I%2FOhzewr9yoK2mDEFxqCRCK5Y1M0hnDqepVJ%2FvKnqiE1Cefin3S8B9VRwS2hpKKGVWOLx5h58lrDCceLaJ5zx89j6cqS24ho8FW0GoD7NilGlXe5GKaREOhdSYmC4aM8phG4wCgimPRSQ4L%2Fkc0flzclnU%2BiZttVLSdQluWl9YgaUx22fbCqd9LS0F8iq%2BbqAokM%2BMnLy3Ct4%2BwAO0UDtyhCkMAdepwiTC6rMi1BjqcATM%2Bo3ppVFomPj8LD17dNRYF1btGj9dh%2FUspEqgYm%2FOSXMG%2FuoUnnbip0mRw7aQBMU5SvHbRgS6ELC66pL6PDXWpj%2FDk0v1MYhmIDXakdqhpVTZoo7BTAbeD0wd66XZVHOuL9YG6W6wKfAkfYjehDthZLxVYP%2B66WXPz6iXGeWqW5%2BphDB65JVFSY9kCZ%2Bi%2BfciMNIegEioDe5AX6g%3D%3D&Expires=1722947432",
"expires": "2024-08-06T12:30:32.434168Z",
"statusCode": 200
}
}
}