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 *Requiredstring
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 *Requiredstring
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.
baseUrl 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.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
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.
