perpetual connector
Manage connectors.
perpetual connector delete
Delete a connector.
perpetual connector delete <id> [flags]
Changes: Stages its writes into a changeset.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Connector ID (CON_*). |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--base-version | string | Optional | Expected current version for optimistic concurrency. |
--changeset | string | Optional | Changeset (CHG_*) to stage into; REQUIRED (the CLI makes no live changes). |
Also accepts the global flags, including the sign-in flags.
perpetual connector export
Write a connector as a GitOps file.
perpetual connector export <id> [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Connector ID (CON_*). |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--dir | string | Optional | Directory for a new file (default .). |
--file | string | Optional | Existing .connector.yaml/.json file to edit in place. |
Also accepts the global flags, including the sign-in flags.
perpetual connector get
Get a connector.
perpetual connector get <id>
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Connector ID (CON_*). |
Also accepts the global flags, including the sign-in flags.
perpetual connector list
List connectors.
perpetual connector list [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--space | string, repeatable | Optional | Only these spaces: SPC_* ids, comma-separated or repeated. |
--filter | string | Optional | Raw OData $filter expression, passed to the server as is. |
--top | string | Optional | Items per page (server default 100). |
--skip | string | Optional | Number of items to skip. |
--all | boolean | Optional | Fetch every page (1000 items per request). |
Also accepts the global flags, including the sign-in flags.
perpetual connector status
Show the deployment status of connectors.
perpetual connector status [ids]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
ids | Optional | Connector ids. |
Also accepts the global flags, including the sign-in flags.
perpetual connector wait
Wait until a connector reaches a deployment status (requires --timeout).
perpetual connector wait <id> [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Connector id. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--timeout | string | Optional | Give up after this long, e.g. 90s, 10m, 1h (required; at most 24h). |
--until | string | Optional | Status to wait for (default DEPLOYED): DEPLOYED, FAILED, DEGRADED, UNDEPLOYED, ARCHIVED. One of DEPLOYED, FAILED, DEGRADED, UNDEPLOYED, ARCHIVED. |
--version | string | Optional | Wait for this committed version (default: the version committed when the wait starts). |
Also accepts the global flags, including the sign-in flags.
Perpetual CLI 0.5.0