# Підтримка JSONPath

LLMS index: [llms.txt](/llms.txt)

---

<!-- overview -->

<a class='glossary-tooltip' title='Інструмент командного рядка для взаємодії з кластерами Kubernetes.' data-bs-toggle='tooltip' data-bs-placement='top' href='/uk/docs/reference/kubectl/' target='_blank' aria-label='Kubectl'>Kubectl</a> підтримує шаблони JSONPath як вихідний формат.

<!-- body -->

_Шаблон JSONPath_ складається з виразів JSONPath, які заключені в фігурні дужки `{` та `}`. Kubectl використовує вирази JSONPath для фільтрації конкретних полів у JSON-обʼєкті та форматування виводу. Окрім оригінального синтаксису шаблону JSONPath, дійсні наступні функції та синтаксис:

1. Використовуйте подвійні лапки для цитування тексту всередині виразів JSONPath.
2. Використовуйте оператори `range`, `end` для ітерації списків.
3. Використовуйте відʼємні індекси зрізу для кроку назад через список. Відʼємні індекси не "обгортають" список і є дійсними, поки \\( ( - index + listLength ) \ge 0 \\).


<div class="alert alert-info" role="note"><h4 class="alert-heading">Примітка:</h4><ul>
<li>
<p>Оператор <code>$</code> є необовʼязковим, оскільки вираз завжди починається стандартно з обʼєкта кореня.</p>
</li>
<li>
<p>Результат обʼєкта виводиться як його функція <code>String()</code>.</p>
</li>
</ul>
</div>


## Функції в JSONPath в Kubernetes {#functions}

```json
{
  "kind": "List",
  "items":[
    {
      "kind":"None",
      "metadata":{
        "name":"127.0.0.1",
        "labels":{
          "kubernetes.io/hostname":"127.0.0.1"
        }
      },
      "status":{
        "capacity":{"cpu":"4"},
        "addresses":[{"type": "LegacyHostIP", "address":"127.0.0.1"}]
      }
    },
    {
      "kind":"None",
      "metadata":{"name":"127.0.0.2"},
      "status":{
        "capacity":{"cpu":"8"},
        "addresses":[
          {"type": "LegacyHostIP", "address":"127.0.0.2"},
          {"type": "another", "address":"127.0.0.3"}
        ]
      }
    }
  ],
  "users":[
    {
      "name": "myself",
      "user": {}
    },
    {
      "name": "e2e",
      "user": {"username": "admin", "password": "secret"}
    }
  ]
}
```



 





<table><caption style="display: none;">Функції, їх параметри, приклад виклику та результат</caption>
	<thead>
			<tr>
					<th>Функція</th>
					<th>Опис</th>
					<th>Приклад</th>
					<th>Результат</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>text</code></td>
					<td>звичайний текст</td>
					<td><code>kind is {.kind}</code></td>
					<td><code>kind is List</code></td>
			</tr>
			<tr>
					<td><code>@</code></td>
					<td>поточний обʼєкт</td>
					<td><code>{@}</code></td>
					<td>той самий, що й вхід</td>
			</tr>
			<tr>
					<td><code>.</code> або <code>[]</code></td>
					<td>оператор доступу до дочірніх елементів</td>
					<td><code>{.kind}</code>, <code>{['kind']}</code> або <code>{['name\.type']}</code></td>
					<td><code>List</code></td>
			</tr>
			<tr>
					<td><code>..</code></td>
					<td>рекурсивний спуск</td>
					<td><code>{..name}</code></td>
					<td><code>127.0.0.1 127.0.0.2 myself e2e</code></td>
			</tr>
			<tr>
					<td><code>*</code></td>
					<td>універсальний символ. Отримати всі обʼєкти</td>
					<td><code>{.items[*].metadata.name}</code></td>
					<td><code>[127.0.0.1 127.0.0.2]</code></td>
			</tr>
			<tr>
					<td><code>[start:end:step]</code></td>
					<td>оператор індексу</td>
					<td><code>{.users[0].name}</code></td>
					<td><code>myself</code></td>
			</tr>
			<tr>
					<td><code>[,]</code></td>
					<td>оператор обʼєднання</td>
					<td><code>{.items[*]['metadata.name', 'status.capacity']}</code></td>
					<td><code>127.0.0.1 127.0.0.2 map[cpu:4] map[cpu:8]</code></td>
			</tr>
			<tr>
					<td><code>?()</code></td>
					<td>фільтр</td>
					<td><code>{.users[?(@.name==&quot;e2e&quot;)].user.password}</code></td>
					<td><code>secret</code></td>
			</tr>
			<tr>
					<td><code>range</code>, <code>end</code></td>
					<td>ітерація списку</td>
					<td><code>{range .items[*]}[{.metadata.name}, {.status.capacity}] {end}</code></td>
					<td><code>[127.0.0.1, map[cpu:4]] [127.0.0.2, map[cpu:8]]</code></td>
			</tr>
			<tr>
					<td><code>''</code></td>
					<td>інтерпретований рядок з лапками</td>
					<td><code>{range .items[*]}{.metadata.name}{'\t'}{end}</code></td>
					<td><code>127.0.0.1      127.0.0.2</code></td>
			</tr>
			<tr>
					<td><code>\</code></td>
					<td>символ екранування</td>
					<td><code>{.items[0].metadata.labels.kubernetes\.io/hostname}</code></td>
					<td><code>127.0.0.1</code></td>
			</tr>
	</tbody>
</table>


## Використання виразів JSONPath з kubectl {#use-with-kubectl}

Приклади використання `kubectl` та виразів JSONPath:

```shell
kubectl get pods -o json
kubectl get pods -o=jsonpath='{@}'
kubectl get pods -o=jsonpath='{.items[0]}'
kubectl get pods -o=jsonpath='{.items[0].metadata.name}'
kubectl get pods -o=jsonpath="{.items[*]['metadata.name', 'status.capacity']}"
kubectl get pods -o=jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.startTime}{"\n"}{end}'
kubectl get pods -o=jsonpath='{.items[0].metadata.labels.kubernetes\.io/hostname}'
```

Або за допомогою "my_pod" і "my_namespace" (налаштуйте ці назви відповідно до вашого середовища):

```shell
kubectl get pod/my_pod -n my_namespace -o=jsonpath='{@}'
kubectl get pod/my_pod -n my_namespace -o=jsonpath='{.metadata.name}'
kubectl get pod/my_pod -n my_namespace -o=jsonpath='{.status}'
```


<div class="alert alert-info" role="note"><h4 class="alert-heading">Примітка:</h4><p>У Windows потрібно <em>подвійні</em> лапки для будь-якого шаблону JSONPath, що містить пробіли (не одинарні лапки, як показано вище для bash). Це означає, що потрібно використовувати одинарні лапки або екрановані подвійні лапки для будь-яких літералів у шаблоні. Наприклад:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-cmd" data-lang="cmd"><span class="line"><span class="cl">kubectl get pods -o=jsonpath=<span class="s2">&#34;{range .items[*]}{.metadata.name}{&#39;\t&#39;}{.status.startTime}{&#39;\n&#39;}{end}&#34;</span>
</span></span><span class="line"><span class="cl">kubectl get pods -o=jsonpath=<span class="s2">&#34;{range .items[*]}{.metadata.name}{\&#34;</span>\t\<span class="s2">&#34;}{.status.startTime}{\&#34;</span>\n\<span class="s2">&#34;}{end}&#34;</span>
</span></span></code></pre></div></div>


## Регулярні вирази в JSONPath {#regular-expressions-in-jsonpath}

JSONPath регулярні вирази не підтримуються. Якщо ви хочете використовувати регулярні вирази, ви можете скористатися інструментом, таким як `jq`.

```shell
# kubectl не підтримує регулярні вирази для JSONpath виводу
# Наступна команда не працює
kubectl get pods -o jsonpath='{.items[?(@.metadata.name=~/^test$/)].metadata.name}'

# Наступна команда досягає бажаного результату
kubectl get pods -o json | jq -r '.items[] | select(.metadata.name | test("test-")).metadata.name'
```