
Huawei GetJobRun
CertifiedFetch the status and metadata of a DataArts Factory job run
Huawei GetJobRun
Fetch the status and metadata of a DataArts Factory job run
Retrieves the current status of a DataArts Studio (DataArts Factory) job run instance.
When instanceId is provided, the specific instance is fetched directly. When omitted, the
most recently created instance for the job is returned (resolved by querying the instance
list and selecting the newest entry by plan/start time).
This reports on plain job instances, whatever started them — a schedule, the console, or a
StartJobRun supplement-data run. It is not tied to StartJobRun: that task tracks its own
run by runName, and wait: true there polls the supplement-data run rather than the
individual instances it spawns.
This task performs a single fetch without polling.
type: io.kestra.plugin.huawei.dataarts.GetJobRunExamples
Get the latest run of a job.
id: dataarts_get_job_run
namespace: company.team
tasks:
- id: get_run
type: io.kestra.plugin.huawei.dataarts.GetJobRun
accessKeyId: "{{ secret('HUAWEI_AK') }}"
secretAccessKey: "{{ secret('HUAWEI_SK') }}"
region: eu-west-101
projectId: "{{ secret('HUAWEI_PROJECT_ID') }}"
jobName: my_etl_job
Follow one specific job run. The instance ID is not visible in the console and has no API of its own, so it is resolved once by a GetJobRun with instanceId omitted, then reused to re-read that same instance rather than whichever run is latest at the time.
id: dataarts_get_specific_run
namespace: company.team
tasks:
- id: resolve_latest
type: io.kestra.plugin.huawei.dataarts.GetJobRun
accessKeyId: "{{ secret('HUAWEI_AK') }}"
secretAccessKey: "{{ secret('HUAWEI_SK') }}"
region: eu-west-101
projectId: "{{ secret('HUAWEI_PROJECT_ID') }}"
jobName: my_etl_job
- id: get_run
type: io.kestra.plugin.huawei.dataarts.GetJobRun
accessKeyId: "{{ secret('HUAWEI_AK') }}"
secretAccessKey: "{{ secret('HUAWEI_SK') }}"
region: eu-west-101
projectId: "{{ secret('HUAWEI_PROJECT_ID') }}"
jobName: my_etl_job
instanceId: "{{ outputs.resolve_latest.instanceId }}"
Properties
jobName *Requiredstring
Name of the DataArts Factory job
Must match the job name exactly as defined in the DataArts Studio console.
accessKeyId string
Access Key (AK) used to authenticate with Huawei Cloud
Huawei Cloud access key used together with secretAccessKey to sign API requests. Required for AK/SK-based authentication; not required when providing a pre-obtained securityToken. Sensitive — always provide via {{ secret('NAME') }}.
domainId string
Huawei Cloud Account Domain ID
Identifies the Huawei Cloud account (domain). Required when authenticating against global services such as IAM, or when requesting a domain-scoped IAM token.
endpointOverride string
DataArts Studio endpoint URL override
Overrides the default endpoint derived from region. Use this when running against a
private endpoint, a non-standard deployment, or in tests.
When set, the region property is ignored for endpoint resolution. Format:
https://dayu.<region>.myhuaweicloud.com (without trailing slash).
instanceId integerstring
Job run instance ID to fetch
When set, fetches that specific instance. When omitted, the most recently started instance
for jobName is returned — which is the normal way to use this task.
The ID is the API's numeric instance_id. It is not the instanceId UUID in the
DataArts Studio console URL (that identifies the DataArts Studio service instance, an
unrelated entity), and it is not displayed anywhere in the console. Nor does StartJobRun
return one: that task creates a supplement-data run identified by runName, and the job
instances it spawns are separate entities. So the only source of a value for this property
is the instanceId output of a GetJobRun that ran with it omitted.
Setting it yields fewer outputs. The single-instance API returns a subset of what the
instance-list API does, so endTime, executeTime, submitTime, jobInstanceName and
jobId all come back empty here — verified against a live instance that had already
succeeded, so even endTime is absent. Leave instanceId unset unless you specifically
need a named instance rather than the latest one.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
projectId string
Huawei Cloud Project ID
Identifies the region-scoped project against which most regional services authenticate. Mutually exclusive with domainId for global services such as IAM.
region string
Huawei Cloud region
Region identifier such as eu-west-101, ap-southeast-1, or cn-north-4.
secretAccessKey string
Secret Key (SK) used to authenticate with Huawei Cloud
Huawei Cloud secret key paired with accessKeyId. Required for AK/SK-based authentication. Sensitive — always provide via {{ secret('NAME') }}.
securityToken string
Pre-obtained Huawei Cloud IAM token used as bearer credential for downstream API calls
When set, downstream Huawei tasks send this value in the X-Auth-Token header instead of signing requests with AK/SK. Sensitive.
temporaryCredentials string
Inline IAM credential exchange
When set, the connection layer calls the Huawei IAM STS API once per task execution and
uses the returned temporary AK/SK + security token instead of the static accessKeyId
and secretAccessKey properties.
Configure once via pluginDefaults to apply transparently to every task in a namespace
without per-task credential wiring:
pluginDefaults:
- type: io.kestra.plugin.huawei.obs
values:
region: eu-west-101
temporaryCredentials:
authMethod: PASSWORD
username: my-iam-user
password: "{{ secret('HUAWEI_IAM_PASSWORD') }}"
domainName: my-account-domain
durationSeconds: 3600
**Long-running tasks: ** the exchange runs once at execution start. For RealtimeTrigger
or long-running Consume tasks that outlive durationSeconds, credentials will expire
mid-run. Use long-lived AK/SK properties or refresh externally in that case.
io.kestra.plugin.huawei.TemporaryCredentialsConfig
PASSWORDPASSWORDTOKENAuthentication method
Controls which credentials are used to obtain the session token before exchanging for temporary STS credentials.
PASSWORD(default): provideusername,password, anddomainName.TOKEN: provide an existingiamToken(X-Auth-Token).
Account domain name (PASSWORD method only)
The Huawei Cloud account name (domain name) that owns the IAM user.
Required when authMethod is PASSWORD. Visible in the Huawei Cloud console under
My Credentials → Domain Name.
900Lifetime of the temporary credentials in seconds
How long the returned temporary AK/SK/security-token should remain valid. Huawei Cloud accepts values between 900 (15 minutes) and 86400 (24 hours). Defaults to 900 seconds.
myhuaweicloud.comHuawei Cloud IAM endpoint suffix
Domain suffix used to build the IAM endpoint URL when no explicit endpoint override is set.
Defaults to myhuaweicloud.com. Set to myhuaweicloud.eu for the European sovereign cloud
(region eu-west-101 / EU-Dublin).
IAM token to exchange (TOKEN method only)
An existing Huawei Cloud X-Auth-Token to exchange for temporary STS credentials.
Required when authMethod is TOKEN. Sensitive — always provide via {{ secret('NAME') }}.
IAM password (PASSWORD method only)
Password for the IAM user identified by username.
Required when authMethod is PASSWORD.
Sensitive — always provide via {{ secret('NAME') }}.
Project name for project-scoped tokens (PASSWORD method only)
Overrides the project name used for scope=PROJECT token requests.
Defaults to the task's region value when omitted, which is correct for most regions.
PROJECTPROJECTDOMAINToken scope (PASSWORD method only)
Scope of the session token obtained during password authentication.
PROJECT(default): token is scoped to the project matchingprojectName(or the task'sregionwhenprojectNameis omitted). Use for most downstream tasks.DOMAIN: token is scoped to the domain.
IAM username (PASSWORD method only)
Huawei Cloud IAM username. Required when authMethod is PASSWORD.
workspaceId string
DataArts Studio workspace ID
Identifies the DataArts Studio workspace to target. Required for all DataArts Factory operations when your account has multiple workspaces. When omitted, the default workspace is used.
Find the workspace ID in the DataArts Studio console under Workspaces → Settings.
Outputs
endTime string
date-timeEnd time; null if still running
executeTime string
durationHow long the instance took to execute
instanceId integer
Job run instance ID
jobId integer
ID of the job this instance belongs to
jobInstanceName string
Job run instance name, as shown in the console's job monitoring list
jobName string
Job name
planTime string
date-timeScheduled plan time
startTime string
date-timeActual start time
status string
Current status of the job run
submitTime string
date-timeSubmission time