NetApp ONTAP GetStatus

NetApp ONTAP GetStatus

Certified
Enterprise Edition

Get ONTAP SnapMirror relationship status

Retrieves the current status of a SnapMirror relationship by UUID via GET /api/snapmirror/relationships/{uuid}. Returns the relationship state, health, lag time, and last transfer details.

yaml
type: io.kestra.plugin.ee.netapp.ontap.replication.GetStatus

Get the status of a SnapMirror relationship.

yaml
id: ontap_snapmirror_status
namespace: company.team

tasks:
  - id: get_status
    type: io.kestra.plugin.ee.netapp.ontap.replication.GetStatus
    host: "{{ secret('ONTAP_HOST') }}"
    username: admin
    password: "{{ secret('ONTAP_PASSWORD') }}"
    relationshipUuid: "{{ inputs.relationship_uuid }}"
Properties

ONTAP cluster management IP or hostname

Hostname or IP address of the ONTAP cluster management interface (for example: ontap.example.com or 192.168.1.10). The REST API is reached at https://{host}/api/.

ONTAP password

Password used for HTTP Basic authentication. Store this value as a Kestra secret and reference it via {{ secret('ONTAP_PASSWORD') }}.

Relationship UUID

UUID of the SnapMirror relationship to query.

ONTAP username

Username used for HTTP Basic authentication (for example: admin).

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.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

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

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

HTTP client configuration

Optional HTTP client overrides such as timeouts, TLS settings, and proxy. For example:

options: 
  timeout: 
    connectTimeout: PT10S
    readIdleTimeout: PT30S
  ssl: 
    insecureTrustAllCertificates: true # accept self-signed cluster certs (insecure — lab use only)
Definitions
allowFailedbooleanstring
Defaultfalse

If true, allow a failed response code (response code >= 400)

allowedResponseCodesarray
SubTypeinteger

List of response code allowed for this request

auth

The authentication to use.

type*object
passwordstring

The password for HTTP basic authentication.

usernamestring

The username for HTTP basic authentication.

type*object
tokenstring

The token for bearer token authentication.

type*object
passwordstring

The password for HTTP Digest authentication.

usernamestring

The username for HTTP Digest authentication.

defaultCharsetstring
DefaultUTF-8

The default charset for the request.

enabledTcpExtendedKeepAlivebooleanstring
Defaulttrue

Whether to enable TCP Keep-Alive extended socket options (TCP_KEEPIDLE, TCP_KEEPINTERVAL, TCP_KEEPCOUNT).

Set to false when running on Windows workers, as these extended socket options are not supported by the Windows JDK and will cause connection failures.

followRedirectsbooleanstring
Defaulttrue

Whether redirects should be followed automatically.

logsarray
SubTypestring
Possible Values
REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODY

The enabled log.

proxy

The proxy configuration.

addressstring

The address of the proxy server.

passwordstring

The password for proxy authentication.

portintegerstring

The port of the proxy server.

typestring
DefaultDIRECT
Possible Values
DIRECTHTTPSOCKS

The type of proxy to use.

usernamestring

The username for proxy authentication.

ssl

The SSL request options

insecureTrustAllCertificatesbooleanstring

Whether to disable checking of the remote SSL certificate.

Only applies if no trust store is configured. Note: This makes the SSL connection insecure and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.

timeout

The timeout configuration.

connectTimeoutstring

The time allowed to establish a connection to the server before failing.

readIdleTimeoutstring
DefaultPT5M

The time allowed for a read connection to remain idle before closing it.

Default443

ONTAP port

Port for the ONTAP REST API. Defaults to 443.

Defaulthttps

HTTP scheme

Protocol scheme used to reach the ONTAP REST API. Defaults to https. Set to http only for testing against local stubs; production clusters always use https.

DefaultPT5M

Async job wait timeout

Maximum time to wait for ONTAP asynchronous jobs (those that return HTTP 202 + a job UUID) to reach a terminal state. Defaults to PT5M (5 minutes). The job is polled every 2 seconds within this window.

Destination path

Destination endpoint in svm: volume format.

Healthy

true when the relationship is in a healthy, transferring state.

Lag time

ISO-8601 duration representing how far behind the destination is (for example: PT10M30S).

Last transfer end datetime

ISO-8601 timestamp of when the last transfer completed.

Last transfer type

For example: initialize, update, resync.

Source path

Source endpoint in svm: volume format.

Relationship state

For example: snapmirrored, broken_off, paused, uninitialized.

Relationship UUID