Aikido ListAssets
CertifiedList Aikido cloud assets
Aikido ListAssets
List Aikido cloud assets
Lists cloud assets discovered across every connected cloud environment (or a single one via cloudId) and pages through every matching result. fetchType=STORE is recommended for large result sets: it streams results to internal storage instead of holding them all in memory or in the execution output.
type: io.kestra.plugin.aikido.clouds.ListAssetsExamples
Store every discovered EC2 instance for a given cloud
id: list_aikido_cloud_assets
namespace: company.security
inputs:
- id: cloud_id
type: STRING
tasks:
- id: list_assets
type: io.kestra.plugin.aikido.clouds.ListAssets
clientId: "{{ secret('AIKIDO_CLIENT_ID') }}"
clientSecret: "{{ secret('AIKIDO_CLIENT_SECRET') }}"
cloudId: "{{ inputs.cloud_id }}"
assetType: "AWS::EC2::Instance"
fetchType: STORE
Properties
clientId *string
OAuth2 client ID
Client ID of an Aikido API client with the OAuth2 scopes required by the tasks and triggers being used (for example issues: read, repositories: write). Client credentials are created in the Aikido console under Settings > API access.
clientSecret *string
OAuth2 client secret
Client secret of the Aikido API client. Exchanged for a short-lived JWT Bearer token on first use (and transparently refreshed before it expires); never logged or included in error messages.
assetType string
Filter by provider-specific asset type
For example AWS::EC2::Instance.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://app.aikido.devAikido API base URL
Base URL of the Aikido Security application for your account's region: https://app.aikido.dev (Europe, default), https://app.us.aikido.dev (United States), https://app.au.aikido.dev (Australia), or https://app.me.aikido.dev (Middle East). The OAuth2 token endpoint is derived from this same host, so a region override applies to both authentication and API calls.
cloudId integerstring
Filter by connected cloud ID
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch type
FETCH_ONE outputs the first matching asset, FETCH outputs every matching asset, STORE streams every matching asset to internal storage and returns a URI. Defaults to FETCH.
includeMetadata booleanstring
falseInclude full provider metadata on each asset
Defaults to false.
pageSize integerstring
20Page size
Internal pagination page size, from 10 to 100. Defaults to 20.
provider string
Filter by cloud provider
For example aws, azure, or gcp.
region string
Filter by region
search string
Free-text search across asset name and identifiers
Outputs
row
First fetched asset
Populated only when fetchType=FETCH_ONE.
io.kestra.plugin.aikido.clouds.CloudAsset
The display name of the asset
The provider-specific type of the asset
For example AWS::EC2::Instance.
The ID of the connected cloud this asset belongs to
The Aikido cloud asset ID
Full asset metadata, mirroring the cloud provider's own representation
Only populated when includeMetadata is enabled.
The cloud provider for this asset
The region where the asset is located
Projected metadata values selected through metadataFields
The provider-specific identifier of the asset
rows array
Fetched assets
Populated only when fetchType=FETCH.
io.kestra.plugin.aikido.clouds.CloudAsset
The display name of the asset
The provider-specific type of the asset
For example AWS::EC2::Instance.
The ID of the connected cloud this asset belongs to
The Aikido cloud asset ID
Full asset metadata, mirroring the cloud provider's own representation
Only populated when includeMetadata is enabled.
The cloud provider for this asset
The region where the asset is located
Projected metadata values selected through metadataFields
The provider-specific identifier of the asset
size integer
Number of assets fetched
uri string
uriStored data URI
Populated only when fetchType=STORE.
