Skip to main content

Manage workflows

Retrieve workflow

By ID

Retrieve an existing workflow by its ID:

Retrieve workflows by its type
WorkflowSearchResult result = WorkflowSearchRequest // (1)
.findById(client, "atlan-snowflake-miner-1714638976"); // (2)
  1. You can search for existing workflows through the WorkflowSearchRequest class.
  2. You can find workflows by their ID using the findById() helper method and providing the ID for one of the packages. In this example, we're retrieving a specific Snowflake miner package. Because this operation will retrieve information from Atlan, you must provide it an AtlanClient through which to connect to the tenant.

By type

Retrieve existing workflows by its type:

Retrieve workflows by its type
List<WorkflowSearchResult> results = WorkflowSearchRequest // (1)
.findByType(client, SnowflakeMiner.PREFIX, 5); // (2)
  1. You can search for existing workflows through the WorkflowSearchRequest class.
  2. You can find workflows by their type using the findByType() helper method and providing the prefix for one of the packages. In this example, we do so for the SnowflakeMiner. (You can also specify the maximum number of resulting workflows you want to retrieve as results.) Because this operation will retrieve information from Atlan, you must provide it an AtlanClient through which to connect to the tenant.

Create workflow credentials

To create workflow credentials for example, for Snowflake:

Coming soon

Retrieve all workflow credentials

To retrive all workflow credentials for example, for Snowflake:

Coming soon

Update workflow source credentials

To update workflow source credentials for example, for Snowflake:

Update workflow source credentials
Credential snowflakeCredential = client.credentials.get( // (1)
"972a87c1-28d7-8bf2-896d-ea5bd3e9c691"
).toCredential()
.authType("basic") // (2)
.username("username") // (3)
.password("password")
.extra("role", "role-here")
.extra("warehouse", "warehouse-here")
.build() // (4)

CredentialResponse response = snowflakeCredential.update(client) // (5)
  1. You can retrieve the workflow credential object by providing its GUID.
  2. You must specify the authentication type of the credential.
  3. You must provide the sensitive details such as the username, password, and extra when updating credentials. This behavior aligns with the Atlan workflow config update UI.
  4. Build the minimal Credential object.
  5. Now, use the update() method of the Credential object to update this new credentials in Atlan after initially testing it for successful validation. Because this operation will update details in Atlan, you must provide it an AtlanClient through which to connect to the tenant.

Hard-delete workflow credentials

Hard-deletes (also called a purge) are irreversible operations. The workflow credential is removed from Atlan entirely, so no longer appears in the UI and also no longer exists in Atlan's back-end.

To hard-delete (purge) an asset, you only need to provide the GUID for Snowflake:

Coming soon

Update workflow configuration

To update workflow configuration for example, for Snowflake:

Coming soon

Retrieve workflow run

By ID

Retrieve an existing workflow run by its ID:

Coming soon

By status and time range

Retrieve existing workflow runs by their status and time range:

Coming soon

Retrieve all workflow runs

By their phase:

To retrieve all existing workflow runs based on their phase, such as Succeeded, Running, Failed, etc

Coming soon

Stop running workflow

To stop a running workflow:

Coming soon

Delete workflow

To delete a workflow:

Delete a workflow
client.workflows.archive(
"atlan-snowflake-miner-1714638976"
); // (1)
  1. To delete an existing workflow, specify the name of the workflow as displayed in the UI (e.g: atlan-snowflake-miner-1714638976).
Was this page helpful?