Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Data Kiosk → Get Queries

AI-generated

Overview

This node operation interacts with the Amazon Selling Partner API's Data Kiosk resource to retrieve a list of queries. It allows users to filter queries by their processing statuses, specify the maximum number of queries to return per request (page size), and filter queries based on their creation time range. Additionally, it supports pagination through a token to fetch specific pages of results. This operation is useful for monitoring and managing query executions in the Data Kiosk, such as checking the status of submitted queries or retrieving recent query activity.

Use Case Examples

  1. A user wants to fetch all queries that are currently in progress or done, limiting the results to 20 per request.
  2. A user needs to retrieve queries created within a specific date range to analyze recent data kiosk activity.
  3. A user wants to paginate through query results using a pagination token to handle large sets of queries.

Properties

Name Meaning
Processing Statuses Filter queries by their processing status, such as CANCELLED, DONE, FATAL, IN_PROGRESS, or IN_QUEUE.
Page Size Maximum number of queries to return in the response, with a minimum of 1 and a maximum of 100.
Created Since Earliest creation time to include in the query results, used to filter queries created after this date and time.
Created Until Latest creation time to include in the query results, used to filter queries created before this date and time.
Pagination Token Token used to fetch a specific page of query results, enabling pagination through large result sets.

Output

JSON

  • queries - Array of query objects returned from the Data Kiosk, each representing a query with its details.
  • nextToken - Token string used to fetch the next page of query results, if more results are available.

Dependencies

  • Amazon Selling Partner API credentials

Troubleshooting

  • Ensure that the Amazon Selling Partner API credentials are correctly configured and have the necessary permissions to access the Data Kiosk resource.
  • Verify that the pagination token used is valid and corresponds to the current query context to avoid errors in fetching paginated results.
  • Check the date-time format for 'Created Since' and 'Created Until' fields to ensure they are valid ISO 8601 strings, as invalid formats may cause request failures.
  • If the node throws an 'Unknown resource' or 'Unknown operation' error, confirm that the resource and operation names are correctly set to 'Data Kiosk' and 'Get Queries' respectively.

Discussion