Huawei StartJobRun

Name of the DataArts Factory job to run

Must match the job name exactly as defined in the DataArts Studio console.

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') }}.

Treat the date range as day-granular

When true (the default), one instance is created per day in the range. Set to false for jobs scheduled at a finer granularity, where the range should follow the job's own schedule instead.

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.

End of the business-date range to run the job for

Accepts the same formats as startDate, except that a date-only value means the end of that day (23: 59: 59), so startDate: 2026-07-01 with endDate: 2026-07-31 covers all of July. Defaults to the end of the day startDate falls on, making the default a single-day run — the equivalent of a plain "run now".

Must be at least two seconds after startDate: DataArts compares the two as timestamps and rejects a zero-length or inverted range with DLF.30121.

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).

Polling interval while waiting for the run to complete

ISO-8601 duration (e.g. PT5S). Defaults to 5 seconds.

Maximum time to wait for the run to complete

ISO-8601 duration (e.g. PT30M, PT1H). Bounds both the wait for the run to become visible and the status polling that follows. When the deadline passes before the run reaches a terminal state, the task fails with a timeout error. Defaults to 1 hour.

Number of instances to run concurrently, from 1 to 5

Only meaningful when the date range spans more than one instance. Defaults to 1, which runs the range strictly in order. 5 is the maximum DataArts accepts; a value outside 1-5 fails the task before anything is submitted.

Reference (ref) of the pluginDefaults to apply to this task.

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.

Huawei Cloud region

Region identifier such as eu-west-101, ap-southeast-1, or cn-north-4.

Name to give the supplement-data run

Identifies the run for status polling and for StopJobRun. Must be unique within the workspace — reusing a name conflicts with the existing run. When omitted, a unique name is generated as kestra_<jobName>_<random>.

Daily window the run is allowed to execute in, as HH: mm-HH: mm

Omitted by default, which lets DataArts run the backfill immediately — its documented default of 00: 00-00: 00 does not restrict execution, verified live.

Set this only to confine a backfill to off-peak hours, e.g. 01: 00-05: 00.

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') }}.

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.

Start of the business-date range to run the job for

Accepts yyyy-MM-dd (start of that day), yyyy-MM-dd HH: mm: ss, or an ISO date-time — with or without a Z/+HH: mm offset. Times without an offset are read as UTC; times with one are converted to UTC. Defaults to the start of today (UTC).

DataArts itself requires the form 2026-07-28T00: 00: 00 +00 and does not parse any other spelling, so the value is converted for you. A value already in that exact form is sent through verbatim, which is the escape hatch if the required form ever changes.

Abort the remaining instances if one fails

When true (the default), a failed instance stops the rest of the range from running.

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.

Wait for the run to reach a terminal state

When true (the default), the task polls the run's status until it completes, then fails the Kestra task if the run did not succeed. Set to false to return as soon as the run has been accepted and is visible.

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.