Comment on page
Getting started
To use the Tailer API, you first need to generate a JWT token from Google credentials in order to authenticate. Then you can send a first POST request to it using cURL.
google-jwt-generator.zip
1KB
Binary
Google JWT generator
To generate a Google JWT token:
- 1.Download and unzip the ZIP file above. You get a Python file named "google-jwt-generator.py".
- 2.
- 3.Run the following script using Python:python3 google-jwt-generator.py your-credentials.json
- 4.You can save the token in a shell variable:TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json`
To communicate with the Tailer API, you can use the cURL CLI.
Here is an example of request allowing you to check the status of a Tables to Tables data operation run:
TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
"account": "000099",
"environment": "DEV",
"configuration_type": "table-to-table",
"configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
"job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
"run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"
You can use the identity provided when you installed your tailer-sdk:
tailer auth get-token | awk '/User token :/ {print $4}'
You can use this to get your JWT token:
TAILER_API_JWT=`tailer auth get-token | awk '/User token :/ {print $4}'` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
"account": "000099",
"environment": "DEV",
"configuration_type": "table-to-table",
"configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
"job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
"run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"
Last modified 6mo ago