Local Processing Agent Management Private Previewlink
Our REST API supports the following local processing agent management actions:
- Create a Local Processing Agent
- List Local Processing Agents
- Retrieve Local Processing Agent Details
- Delete a Local Processing Agent
- Regenerate authentication keys for a Local Processing Agent
Create a Local Processing Agentlink
Creates a new local processing agent within your Fivetran account.
Requestlink
POST https://api.fivetran.com/v1/local-processing-agents
{
"group_id": "string",
"display_name": "string",
"env_type": "DOCKER",
"accept_terms": true
}
Payload parameterslink
Name | Description | Possible Values |
---|---|---|
group_id (required) | The unique identifier for the group or group within the Fivetran system. | |
display_name (required) | The unique name for the local processing agent. | |
env_type (required) | The environment type; the data processing location. | The only supported type is DOCKER |
accept_terms (required) | The boolean specifying whether the caller accepts the Fivetran On-Prem Software License Addendum. | true or false |
Responselink
HTTP 201 Created
{
"code": "Success",
"message": "Success",
"data": {
"id": "string",
"display_name": "string",
"group_id": "string",
"registered_at": "1970-01-01T00:00:00.000000Z",
"files": {
"config_json": "string",
"auth_json": "string",
"docker_compose_yaml": "string"
}
}
}
Name | Description |
---|---|
id | The unique identifier for the local processing agent within the Fivetran system. |
display_name | The unique name for the local processing agent. |
group_id | The group ID. |
registered_at | The timestamp of the time the local processing agent was created in your account. |
files.config_json | Base64-encoded content of the config.json file. |
files.auth_json | Base64-encoded content of the auth.json file. |
files.docker_compose_yaml | Base64-encoded content of the compose file for the chosen containerization type. |
HTTP 400 BAD REQUEST
The name is missing or the license not accepted in the payload.
HTTP 404 NOT_FOUND
The specified group is not found.
HTTP 409 CONFLICT
A local processing agent with same name already exists.
List Local Processing Agentslink
Returns a list of local processing agents with usage within your Fivetran account.
Requestlink
GET https://api.fivetran.com/v1/local-processing-agents
Query parameterslink
Name | Description |
---|---|
groupId | The optional filter. When used, the response will only contain information for the agents with the specified group. |
cursor | The paging cursor, read more about pagination |
limit | The number of records to fetch per page, accepts a number in the range 1..1000, the default value is 100. |
Responselink
HTTP 200 OK
{
"code": "Success",
"data": {
"items": [
{
"id": "string",
"display_name": "string",
"group_id": "string",
"registered_at": "1970-01-01T00:00:00.000000Z",
"usage": [
{
"connection_id": "string",
"schema": "string",
"service": "string"
}
]
}
],
"next_cursor": "eyJza2lwIjoyfQ"
}
}
Fieldslink
Name | Description |
---|---|
items | The collection of local processing agents with usage. |
next_cursor | The value of the cursor parameter for the next page. |
Retrieve Local Processing Agent detailslink
Retrieves the details of the specified local processing agent.
Requestlink
GET https://api.fivetran.com/v1/local-processing-agents/{agent_id}
Path parameterslink
Name | Description |
---|---|
agent_id (required) | The unique identifier for the local processing agent within your Fivetran account. |
Responselink
HTTP 200 OK
{
"code": "Success",
"data": {
"id": "string",
"display_name": "string",
"group_id": "string",
"registered_at": "1970-01-01T00:00:00.000000Z",
"usage": [
{
"connection_id": "string",
"schema": "string",
"service": "string"
}
]
}
}
Name | Description |
---|---|
id | The unique identifier for the local processing agent within the Fivetran system. |
display_name | The unique name for the local processing agent. |
registred_at | The timestamp of the time the local processing agent was created in your account. |
usage .connectionId | The unique identifier of the connection associated with the agent. |
usage .schema | The connection schema name. |
usage .service | The connection type. |
HTTP 404 NOT_FOUND
A local processing agent with the specified ID is not found.
Delete a Local Processing Agentlink
Deletes the specified local processing agent from your Fivetran account.
Requestlink
DELETE https://api.fivetran.com/v1/local-processing-agents/{agent_id}
Path parameterslink
Name | Description |
---|---|
agent_id (required) | The unique identifier for the local processing agent within your Fivetran account. |
Responselink
HTTP 200 OK
{
"code": "Success"
}
HTTP 400 BAD REQUEST
An error occurred during the removal process.
HTTP 404 NOT_FOUND
A local processing agent with the specified ID is not found.
HTTP 409 CONFLICT
A local processing agent with the specified ID has associated connections.
Regenerate Keyslink
Regenerates authentication keys for the specified local processing agent.
Requestlink
PATCH https://api.fivetran.com/v1/local-processing-agents/{agent_id}/re-auth
Path parameterslink
Name | Description |
---|---|
agent_id (required) | The unique identifier for the local processing agent within your Fivetran account. |
Responselink
HTTP 200 Success
{
"code": "Success",
"message": "Success",
"data": {
"id": "string",
"display_name": "string",
"group_id": "string",
"registered_at": "1970-01-01T00:00:00.000000Z",
"files": {
"config_json": "string",
"auth_json": "string",
"docker_compose_yaml": "string"
}
}
}
Name | Description |
---|---|
id | The unique identifier for the local processing agent within the Fivetran system. |
display_name | The unique name for the local processing agent. |
group_id | The group ID. |
registered_at | The timestamp of the time the local processing agent was created in your account. |
files.config_json | Base64-encoded content of the config.json file. |
files.auth_json | Base64-encoded content of the auth.json file. |
files.docker_compose_yaml | Base64-encoded content of the compose file for the chosen containerization type. |