2026-08-11 11:22:55 -04:00
|
|
|
---
|
|
|
|
|
# Code generated by make gen. DO NOT EDIT.
|
2026-09-28 15:44:10 -04:00
|
|
|
title: "`coder ping`"
|
2026-10-20 18:51:44 -04:00
|
|
|
description: Ping a workspace.
|
2026-08-11 11:22:55 -04:00
|
|
|
---
|
|
|
|
|
|
2023-03-23 17:42:20 -05:00
|
|
|
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
|
|
|
|
|
|
|
|
|
Ping a workspace
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
coder ping [flags] <workspace>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Options
|
|
|
|
|
|
2024-03-15 11:24:38 -05:00
|
|
|
### --wait
|
2023-03-23 17:42:20 -05:00
|
|
|
|
2026-10-21 10:58:04 -07:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|-----------------------|
|
|
|
|
|
| Type | <code>duration</code> |
|
|
|
|
|
| Default | <code>1s</code> |
|
2023-03-23 17:42:20 -05:00
|
|
|
|
2024-03-15 11:24:38 -05:00
|
|
|
Specifies how long to wait between pings.
|
2023-03-23 17:42:20 -05:00
|
|
|
|
|
|
|
|
### -t, --timeout
|
|
|
|
|
|
2026-10-21 10:58:04 -07:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|-----------------------|
|
|
|
|
|
| Type | <code>duration</code> |
|
|
|
|
|
| Default | <code>5s</code> |
|
2023-03-23 17:42:20 -05:00
|
|
|
|
|
|
|
|
Specifies how long to wait for a ping to complete.
|
|
|
|
|
|
2024-03-15 11:24:38 -05:00
|
|
|
### -n, --num
|
2023-03-23 17:42:20 -05:00
|
|
|
|
2026-10-21 10:58:04 -07:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|------------------|
|
|
|
|
|
| Type | <code>int</code> |
|
2023-03-23 17:42:20 -05:00
|
|
|
|
2026-10-26 13:17:51 -04:00
|
|
|
Specifies the number of pings to perform. By default, pings will continue until interrupted. Required with --output json.
|
2025-02-24 07:38:17 +02:00
|
|
|
|
|
|
|
|
### --time
|
|
|
|
|
|
2026-10-21 10:58:04 -07:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|-------------------|
|
|
|
|
|
| Type | <code>bool</code> |
|
2025-02-24 07:38:17 +02:00
|
|
|
|
|
|
|
|
Show the response time of each pong in local time.
|
|
|
|
|
|
|
|
|
|
### --utc
|
|
|
|
|
|
2026-10-21 10:58:04 -07:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|-------------------|
|
|
|
|
|
| Type | <code>bool</code> |
|
2025-02-24 07:38:17 +02:00
|
|
|
|
|
|
|
|
Show the response time of each pong in UTC (implies --time).
|
2026-10-26 13:17:51 -04:00
|
|
|
|
|
|
|
|
### -c, --column
|
|
|
|
|
|
2026-10-26 13:44:04 -04:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|----------------------------------------------------------------------|
|
|
|
|
|
| Type | <code>[workspace\|total\|successful\|min\|avg\|max\|variance]</code> |
|
|
|
|
|
| Default | <code>workspace,total,successful,min,avg,max,variance</code> |
|
2026-10-26 13:17:51 -04:00
|
|
|
|
|
|
|
|
Columns to display in table output.
|
|
|
|
|
|
|
|
|
|
### -o, --output
|
|
|
|
|
|
2026-10-26 13:44:04 -04:00
|
|
|
| Property | Value |
|
|
|
|
|
|----------|--------------------------|
|
|
|
|
|
| Type | <code>table\|json</code> |
|
|
|
|
|
| Default | <code>table</code> |
|
2026-10-26 13:17:51 -04:00
|
|
|
|
|
|
|
|
Output format.
|