What is a Fetcher?

Fetcher is a building block of the bots. Fetcher is used to fetch all the resources for the given data-source from the available integration. Fetcher code can be written in Python. Fetcher requires integration like AWS, Azure, GCP to fetch the resources so that any action can be performed on these resources. It will return a list of resources available in the integration, you choose. While writing Fetcher Code, The returned resources must be list of dicts which each contains "id" and "name" keys.

Example: >Let's say I have many EC2 instances in AWS. By creating the fetcher, I will get all the EC2 instances with their details created in all AWS regions. Now I can use these details to perform any automations.

How to create a Fetcher?

1. Login to the application.
   
2. On the left hand side, in the sidebar, click on Fetchers.
   
3. On the right hand side, click on + New.
   
4. Choose the integration type.
   
5. Give a name to fetcher and select client.
   
6. Provide your code under the code section.
   
7. Click on Create.
8. Now you need to Test your fetcher.

How to Test a Fetcher?

1. Login to the application.
2. On the left hand side, in the sidebar, click on Fetchers.
3. Click on the fetcher you want to test.
4. Click on Test on the top right.
5. Select your integration with which you want to test the fetcher.
6. Click on Run.

How to view a Fetcher?

1. Login to the application.
2. On the left hand side, in the sidebar, click on Fetcher.
3. Click on the name of the fetcher you want to view.