08af95d42e
* Trivial change to open release branch * Undo trivial change * add service ipvs overview * Add instructions on how to setup kubectl * Document conntrack dependency for kube-proxy * Add an a This is kind of jarring / missing an article. I'm guessing it should either be ' to a rack of bare metal servers.' or '...to racks of bare metal servers.'. * adding example responses for common issues - support request - code bug report * Trivial change to open release branch * Undo trivial change * Signed-off-by: Ziqi Zhao <zhaoziqi@qiniu.com> (#5366) Fix the not-working test case yaml for /doc/concepts/storage/volumes.md * kubectl-overview * temp fix for broken pod and deployment links * Update Table of Solutions for Juju * Revise certificates documentation (#5965) * Update review-issues.md Some edits for clarity and condensed language. * Update init-containers.md Fix leading spaces in commands. * Update kubectl-overview.md Fix format. * Update clc.md Fix format. * Update openstack-heat.md The url no need. just highlight. * Typo I believe this should be "users" not "uses" * making explicit hostname uniq requirement * Update scheduling-hugepages.md * Update update-daemon-set.md * fix redirection of PersistentVolume * Update hpa.md * update kubectl instruction * Use the format of kubeadm init * fix spelling error guarnatees to guarantees * add matchLabels description (#6020) * search and replace for k8s.github.io to website (#6019) * fix scale command of object-management (#6011) * Update replicaset.md (#6009) * Update secret.md (#6008) * specify password for mysql image (#5990) * specify password for mysql image * specify password for mysql image * link error for run-stateless-application-deployment.md (#5985) * link error for run-stateless-application-deployment.md * link error for run-stateless-application-deployment.md * Add performance implications of inter-pod affinity/anti-affinity (#5979) * 404 monthly maintenance - October 2017 (#5977) * Updated redirects * More redirects * Add conjure-up to Turnkey Cloud Solutions list (#5973) * Add conjure-up to Turnkey Cloud Solutions list * Changed wording slightly * change the StatefulSet to ReplicaSet in reference (#5968) * Clarification of failureThreshold of probes (#5963) * Mention usage of block storage version param (#5925) Mention usage of block storage version (bs-version) parameter to workaround attachment issues using older K8S versions on an OpenStack cloud with path-based endpoints. Resolves: https://github.com/kubernetes/kubernetes.github.io/issues/5924 * Update sysctl-cluster.md (#5894) Include guide on enabling unsafe sysctls in minikube * Avoid Latin phrases & format note (#5889) * Avoid Latin phrases & format note according the Documentation Style Guide * Update scratch.md * Update scratch.md * resolves jekyll rendering error (#5976) - chinese isn't understood for keys in YAML frontmatter in jekyll, so replaced it with the english equivalent that doesn't throw the following error on rendering: Error reading file src/kubernetes.github.io/cn/docs/concepts/cluster-administration/device-plugins.md: (<unknown>): could not find expected ':' while scanning a simple key at line 4 column 1 * Change VM to pod. (#6022) * Add link to custom metrics. (#6023) * Rephrase core group. (#6024) * Added explanation on context to when joining (#6018) * Update create-cluster-kubeadm.md (#5761) Update Canal version in pod network apply commands * Fixes issue #5620 (#5869) * Fixes issue #5620 Signed-off-by: Brad Topol <btopol@us.ibm.com> * Restructured so that review process is for both current and upcoming releases. Added content describing the use of tech reviewers. * Removed incorrect Kubernetes reviewer link. * Fixed tech reviewer URL to now use website * Update pod-priority-preemption.md fix-wrong-link-to-pod-preemption * pod-security-policy.md: add links to the page about admission plugins. * Adding all files for BlaBlaCar case study (#5857) * Adding all files for BlaBlaCar case study * Update blablacar.html * Fix changed URL for google containers * Add /docs/reference/auto-generated directory * correct the downwardapi redirect * Remove links using "here" * Rename to /docs/reference/generated directory * add Concept template * Change title to just Ingress * Link mistake (#6038) * link mistake * link mistake * skip title check for skip_title_check.txt * skip title check for skip_title_check.txt * remove doesn't exist link. * Fix podpreset task (#5705) * Add a simple pod manifest to pod overview (#5986) * Split PodPreset concept out from task doc (#5984) * Add selector spec description (#5789) * Add selector spec description * Fix selector field explanation * Put orphaned topics in TOC. (#6051) * static-pod example bad format in the final page (#6050) * static-pod example bad format in the final page * static-pod example bad format in the final page * static-pod example bad format in the final page * static-pod example bad format in the final page * static-pod example bad format in the final page * Fix `backoffLimit` field misplacement (#6042) It should be placed in JobSpec according to: https://github.com/kubernetes/kubernetes/blob/master/api/swagger-spec/batch_v1.json#L1488-L1514 * Update addons.md (#6061) * add info about VMware NSX-T CNI plugin (#5987) * add info about VMware NSX-T CNI plugin Hello, I'm VMware Networking and Security Architect and would like to include short information about our CNI plugin implementation similar to what other vendors did Best regards Emil Gagala * Update networking.md * Update networking.md * Update networking.md * Update: Using universal zsh configuration (#5669) * Update install-kubectl.md Zsh is not only oh-my-zsh, so I added universal configuration for zsh that also can be used in prezto. * fix merge error after rebase * Operating etcd cluster for Kubernetes bad format in the final page (#6056) * Operating etcd cluster for Kubernetes bad format in the final page * Update configure-upgrade-etcd.md * Update configure-upgrade-etcd.md * Usage note and warning tags. (#6053) * Usage note and warning tags. * Update configure-upgrade-etcd.md * Update configure-upgrade-etcd.md * Document jekyll includes snippets * Add jekyll includes to docs home toc - Remove extra kubernetes home in toc * document docker cgroupdriver req (#5937) * Update test blacklists (#6063) * Update toc check blacklist * Update title check blacklist * wip * wip * Fix typo * Document unconfined apparmor profile * Revert "Document the unconfined profile for AppArmor" (#6268) * CRD Validation: remove alpha warning, change enable instructions to (#6066) disable * Documented service annotation for AWS ELB SSL policy * kubeadm: add a note about the new `--print-join-command` flag. This is a new flag for the `kubeadm token create` command. * Add a note to PDB page * Improve Kubeadm reference doc (#6103) * automatically-generated kubeadm reference doc * user-mantained kubeadm reference doc * Documentation for CSIPersistentVolume * change replicaset documentation to use apps/v1 APIs * Update service.md ipvs alpha version -> beta version * Updated Deployment concept docs (#6494) * Updated Deployment concept docs * Addressed comments * Documentation for volume scheduling alpha feature * Update admission control docs for webhooks * Improve DNS documentation (#6479) * update ds for 1.9 * Update service.md * Update service.md * Revert "begin updating webhook documentation" (#6575) * Update version numbers to include 1.9 (#6518) * Update site versions for 1.9 * Removed 1.4 docs * Update _config.yml * Update _config.yml * updates for raw block devices * rbac: docs for aggregated cluster roles (#6474) * Added IPv6 information for Kubelet arguments (#6498) * Added IPv6 info to kube-proxy arguments * Added IPv6 information for argument for kubelet * Update PVC resizing documentation (#6487) * Updates for Windows Server version 1709 with K8s v1.8 (#6180) * Updated for WSv1709 and K8s v1.8 * Updated picture and CNI config * Fixed formatting on CNI Config * Updated docs to reference Microsoft/SDN GitHub docs * fix typo * Workaround for Jekyllr frontmatter * Added section on features and limitations, with example yaml files. * Update index.md * Added kubeadm section, few other small fixes * Few minor grammar fixes * Update access-cluster.md with a comment that for IPv6 the user should use [::1] for the localhost * Addressed a number of issues brought up against the base PR * Fixed windows-host-setup link * Rewrite PodSecurityPolicy guide * Update index.md Signed-off-by: Alin Balutoiu <abalutoiu@cloudbasesolutions.com> Signed-off-by: Alin Gabriel Serdean <aserdean@ovn.org> * Spelling correction and sentence capitalization. - Corrected the spelling error for storing, was put in as 'stoing'. - Capitalized list items. - Added '.' at end of sentences in the list items. * Update index.md * Update index.md * Addressed comments and rebased * Fixed formatting * Fixed formatting * Updated header link * Updated hyperlinks * Updated warning * formatting * formatting * formatting * Revert "Update access-cluster.md with a comment that for IPv6" This reverts commit31e4dbdc25. * Revert "fix typo" This reverts commitc05678752d. * Revert "Workaround for Jekyllr frontmatter" This reverts commitb84ac59624. * Fixed grammatical issues and reverted non-related commits * Revert "Rewrite PodSecurityPolicy guide" This reverts commit5d39cfeae4. * Revert "Spelling correction and sentence capitalization." This reverts commit47eed4346e. * Fixed auto-numbering * Minor formatting updates * CoreDNS feature documentation (#6463) * Initial placeholder PR for CoreDNS feature documentation * Remove from admin, add content * Fix missing endcapture * Add to tasks.yml * Review feedback * Postpone Deletion of a Persistent Volume Claim in case It Is Used by a Pod (#6415) * Postpone Deletion of a Persistent Volume Claim in case It Is Used by a Pod A new feature PVC Protection was added into K8s 1.9 that's why this documentation change is needed. * Added tag at the top of each new area. * Fix typo * Fix: switched on in (all kubelets) -> (all K8s components). * Added link to admission controller * Moved PVC Protection configuration into Before you begin section. * Added steps how to verify PVC Protection feature. * Fixes for admission controller plugin description and for PVC Protection description in PVC lifecycle. * Testing official rendering of enumerations (1., 2., 3., etc.) * Re-write to address comments from review. * Fixed definition when a PVC is in active use by a pod. * Change auditing docs page for 1.9 release (#6427) * Change auditing docs page for 1.9 release Signed-off-by: Mik Vyatskov <vmik@google.com> * Address review comments Signed-off-by: Mik Vyatskov <vmik@google.com> * Address review comments Signed-off-by: Mik Vyatskov <vmik@google.com> * Address review comments Signed-off-by: Mik Vyatskov <vmik@google.com> * Fix broken link Signed-off-by: Mik Vyatskov <vmik@google.com> * short circuit deny docs (#6536) * line wrap * short circuit deny * address comments * Add kubeadm 1.9 upgrade docs (#6485) * kubeadm: Improve kubeadm documentation for v1.9 (#6645) * Update admission control docs for webhooks (re-send #6368) (#6650) * Update admission control docs for webhooks * update in response to comments * Revamp rkt and add CRI-O as alternative runtime (#6371) Signed-off-by: Lorenzo Fontana <lo@linux.com> * Documented NLB for Kubernetes 1.9 (#6260) * Added IPV6 information to setup cluster using kubeadm (#6465) * Added IPV6 information to setup cluster using kubeadm * Updated kubeadm.md & create-cluster-kubeadm.md with IPv6 related information * Added IPv6 options for kubeadm --init & automated address binding for kube-proxy based on version of IP configured for API server) * Changes to kubeadm.md as per comments * Modified kubeadm.md and create-cluster-kubeadm.md * Implemented changes requested by zacharysarah * Removed autogenerated kubeadm.md changes * StatefulSet 1.9 updates. (#6550) * updates sts concept and tutorials to use 1.9 apps/v1 * Update statefulset.md * clarify pod name label * Garbage collection updates for 1.9 (#6555) * 1.9 gc policy update * carify deletion * Couple nits for dnsConfig doc (#6652) * Add doc for AllowedFlexVolume (#6563) * Update OpenStack Cloud Provider API support for v1.9 (#6638) * Flex volume is GA. Remove alpha notation. (#6666) * Update generated ref docs for Kubernetes and Federation components. (#6658) * Update generated ref docs for Kubernetes and Federation components. * Rename kubectl-options to kubectl. * Add title to kubectl. * Fix double synopsis. * Update Federation API ref docs for 1.9. (#6636) * Update federation API ref docs. * Move and redirect. * Move generated Federation docs to the generated directory. * Fix titles. * Type * Fix titles * Update auto-generated Kubernetes APi ref docs. (#6646) * Update kubectl commands for 1.9 (#6635) * add ExtendedResourceToleration admission controller (#6618) * Update API reference paths for v1.9 (#6681)
9530 lines
445 KiB
HTML
Executable File
9530 lines
445 KiB
HTML
Executable File
---
|
|
title: v1 Operations
|
|
notitle: true
|
|
---
|
|
|
|
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<meta name="generator" content="Asciidoctor 0.1.4">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Operations</title>
|
|
<style>
|
|
/* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
|
|
article, aside, details, figcaption, figure, footer, header, hgroup, main, nav, section, summary { display: block; }
|
|
audio, canvas, video { display: inline-block; }
|
|
audio:not([controls]) { display: none; height: 0; }
|
|
[hidden] { display: none; }
|
|
html { background: #fff; color: #000; font-family: sans-serif; -ms-text-size-adjust: 100%; -webkit-text-size-adjust: 100%; }
|
|
body { margin: 0; }
|
|
a:focus { outline: thin dotted; }
|
|
a:active, a:hover { outline: 0; }
|
|
h1 { font-size: 2em; margin: 0.67em 0; }
|
|
abbr[title] { border-bottom: 1px dotted; }
|
|
b, strong { font-weight: bold; }
|
|
dfn { font-style: italic; }
|
|
hr { -moz-box-sizing: content-box; box-sizing: content-box; height: 0; }
|
|
mark { background: #ff0; color: #000; }
|
|
code, kbd, pre, samp { font-family: monospace, serif; font-size: 1em; }
|
|
pre { white-space: pre-wrap; }
|
|
q { quotes: "\201C" "\201D" "\2018" "\2019"; }
|
|
small { font-size: 80%; }
|
|
sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }
|
|
sup { top: -0.5em; }
|
|
sub { bottom: -0.25em; }
|
|
img { border: 0; }
|
|
svg:not(:root) { overflow: hidden; }
|
|
figure { margin: 0; }
|
|
fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; }
|
|
legend { border: 0; padding: 0; }
|
|
button, input, select, textarea { font-family: inherit; font-size: 100%; margin: 0; }
|
|
button, input { line-height: normal; }
|
|
button, select { text-transform: none; }
|
|
button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; cursor: pointer; }
|
|
button[disabled], html input[disabled] { cursor: default; }
|
|
input[type="checkbox"], input[type="radio"] { box-sizing: border-box; padding: 0; }
|
|
input[type="search"] { -webkit-appearance: textfield; -moz-box-sizing: content-box; -webkit-box-sizing: content-box; box-sizing: content-box; }
|
|
input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; }
|
|
button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; }
|
|
textarea { overflow: auto; vertical-align: top; }
|
|
table { border-collapse: collapse; border-spacing: 0; }
|
|
*, *:before, *:after { -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
|
|
html, body { font-size: 100%; }
|
|
body { background: white; color: #222222; padding: 0; margin: 0; font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; font-weight: normal; font-style: normal; line-height: 1; position: relative; cursor: auto; }
|
|
a:hover { cursor: pointer; }
|
|
a:focus { outline: none; }
|
|
img, object, embed { max-width: 100%; height: auto; }
|
|
object, embed { height: 100%; }
|
|
img { -ms-interpolation-mode: bicubic; }
|
|
#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
|
|
.left { float: left !important; }
|
|
.right { float: right !important; }
|
|
.text-left { text-align: left !important; }
|
|
.text-right { text-align: right !important; }
|
|
.text-center { text-align: center !important; }
|
|
.text-justify { text-align: justify !important; }
|
|
.hide { display: none; }
|
|
.antialiased, body { -webkit-font-smoothing: antialiased; }
|
|
img { display: inline-block; vertical-align: middle; }
|
|
textarea { height: auto; min-height: 50px; }
|
|
select { width: 100%; }
|
|
p.lead, .paragraph.lead > p, #preamble > .sectionbody > .paragraph:first-of-type p { font-size: 1.21875em; line-height: 1.6; }
|
|
.subheader, #content #toctitle, .admonitionblock td.content > .title, .exampleblock > .title, .imageblock > .title, .videoblock > .title, .listingblock > .title, .literalblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, .sidebarblock > .title, .tableblock > .title, .verseblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title, .tableblock > caption { line-height: 1.4; color: #7a2518; font-weight: 300; margin-top: 0.2em; margin-bottom: 0.5em; }
|
|
div, dl, dt, dd, ul, ol, li, h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6, pre, form, p, blockquote, th, td { margin: 0; padding: 0; direction: ltr; }
|
|
a { color: #005498; text-decoration: underline; line-height: inherit; }
|
|
a:hover, a:focus { color: #00467f; }
|
|
a img { border: none; }
|
|
p { font-family: inherit; font-weight: normal; font-size: 1em; line-height: 1.6; margin-bottom: 1.25em; text-rendering: optimizeLegibility; }
|
|
p aside { font-size: 0.875em; line-height: 1.35; font-style: italic; }
|
|
h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { font-family: Georgia, "URW Bookman L", Helvetica, Arial, sans-serif; font-weight: normal; font-style: normal; color: #ba3925; text-rendering: optimizeLegibility; margin-top: 1em; margin-bottom: 0.5em; line-height: 1.2125em; }
|
|
h1 small, h2 small, h3 small, #toctitle small, .sidebarblock > .content > .title small, h4 small, h5 small, h6 small { font-size: 60%; color: #e99b8f; line-height: 0; }
|
|
h1 { font-size: 2.125em; }
|
|
h2 { font-size: 1.6875em; }
|
|
h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.375em; }
|
|
h4 { font-size: 1.125em; }
|
|
h5 { font-size: 1.125em; }
|
|
h6 { font-size: 1em; }
|
|
hr { border: solid #dddddd; border-width: 1px 0 0; clear: both; margin: 1.25em 0 1.1875em; height: 0; }
|
|
em, i { font-style: italic; line-height: inherit; }
|
|
strong, b { font-weight: bold; line-height: inherit; }
|
|
small { font-size: 60%; line-height: inherit; }
|
|
code { font-family: Consolas, "Liberation Mono", Courier, monospace; font-weight: normal; color: #6d180b; }
|
|
ul, ol, dl { font-size: 1em; line-height: 1.6; margin-bottom: 1.25em; list-style-position: outside; font-family: inherit; }
|
|
ul, ol { margin-left: 1.5em; }
|
|
ul li ul, ul li ol { margin-left: 1.25em; margin-bottom: 0; font-size: 1em; }
|
|
ul.square li ul, ul.circle li ul, ul.disc li ul { list-style: inherit; }
|
|
ul.square { list-style-type: square; }
|
|
ul.circle { list-style-type: circle; }
|
|
ul.disc { list-style-type: disc; }
|
|
ul.no-bullet { list-style: none; }
|
|
ol li ul, ol li ol { margin-left: 1.25em; margin-bottom: 0; }
|
|
dl dt { margin-bottom: 0.3125em; font-weight: bold; }
|
|
dl dd { margin-bottom: 1.25em; }
|
|
abbr, acronym { text-transform: uppercase; font-size: 90%; color: #222222; border-bottom: 1px dotted #dddddd; cursor: help; }
|
|
abbr { text-transform: none; }
|
|
blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
|
|
blockquote cite { display: block; font-size: inherit; color: #555555; }
|
|
blockquote cite:before { content: "\2014 \0020"; }
|
|
blockquote cite a, blockquote cite a:visited { color: #555555; }
|
|
blockquote, blockquote p { line-height: 1.6; color: #6f6f6f; }
|
|
.vcard { display: inline-block; margin: 0 0 1.25em 0; border: 1px solid #dddddd; padding: 0.625em 0.75em; }
|
|
.vcard li { margin: 0; display: block; }
|
|
.vcard .fn { font-weight: bold; font-size: 0.9375em; }
|
|
.vevent .summary { font-weight: bold; }
|
|
.vevent abbr { cursor: auto; text-decoration: none; font-weight: bold; border: none; padding: 0 0.0625em; }
|
|
@media only screen and (min-width: 768px) { h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 { line-height: 1.4; }
|
|
h1 { font-size: 2.75em; }
|
|
h2 { font-size: 2.3125em; }
|
|
h3, #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
|
|
h4 { font-size: 1.4375em; } }
|
|
.print-only { display: none !important; }
|
|
@media print { * { background: transparent !important; color: #000 !important; box-shadow: none !important; text-shadow: none !important; }
|
|
a, a:visited { text-decoration: underline; }
|
|
a[href]:after { content: " (" attr(href) ")"; }
|
|
abbr[title]:after { content: " (" attr(title) ")"; }
|
|
.ir a:after, a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; }
|
|
pre, blockquote { border: 1px solid #999; page-break-inside: avoid; }
|
|
thead { display: table-header-group; }
|
|
tr, img { page-break-inside: avoid; }
|
|
img { max-width: 100% !important; }
|
|
@page { margin: 0.5cm; }
|
|
p, h2, h3, #toctitle, .sidebarblock > .content > .title { orphans: 3; widows: 3; }
|
|
h2, h3, #toctitle, .sidebarblock > .content > .title { page-break-after: avoid; }
|
|
.hide-on-print { display: none !important; }
|
|
.print-only { display: block !important; }
|
|
.hide-for-print { display: none !important; }
|
|
.show-for-print { display: inherit !important; } }
|
|
table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
|
|
table thead, table tfoot { background: whitesmoke; font-weight: bold; }
|
|
table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #222222; text-align: left; }
|
|
table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #222222; }
|
|
table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
|
|
table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.6; }
|
|
.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
|
|
.clearfix:after, .float-group:after { clear: both; }
|
|
*:not(pre) > code { font-size: 0.9375em; padding: 1px 3px 0; white-space: nowrap; background-color: #f2f2f2; border: 1px solid #cccccc; -webkit-border-radius: 4px; border-radius: 4px; text-shadow: none; }
|
|
pre, pre > code { line-height: 1.4; color: inherit; font-family: Consolas, "Liberation Mono", Courier, monospace; font-weight: normal; }
|
|
kbd.keyseq { color: #555555; }
|
|
kbd:not(.keyseq) { display: inline-block; color: #222222; font-size: 0.75em; line-height: 1.4; background-color: #F7F7F7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; margin: -0.15em 0.15em 0 0.15em; padding: 0.2em 0.6em 0.2em 0.5em; vertical-align: middle; white-space: nowrap; }
|
|
kbd kbd:first-child { margin-left: 0; }
|
|
kbd kbd:last-child { margin-right: 0; }
|
|
.menuseq, .menu { color: #090909; }
|
|
p a > code:hover { color: #561309; }
|
|
#header, #content, #footnotes, #footer { width: 100%; margin-left: auto; margin-right: auto; margin-top: 0; margin-bottom: 0; max-width: 62.5em; *zoom: 1; position: relative; padding-left: 0.9375em; padding-right: 0.9375em; }
|
|
#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
|
|
#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
|
|
#header { margin-bottom: 2.5em; }
|
|
#header > h1 { color: black; font-weight: normal; border-bottom: 1px solid #dddddd; margin-bottom: -28px; padding-bottom: 32px; }
|
|
#header span { color: #6f6f6f; }
|
|
#header #revnumber { text-transform: capitalize; }
|
|
#header br { display: none; }
|
|
#header br + span { padding-left: 3px; }
|
|
#header br + span:before { content: "\2013 \0020"; }
|
|
#header br + span.author { padding-left: 0; }
|
|
#header br + span.author:before { content: ", "; }
|
|
#toc { border-bottom: 3px double #ebebeb; padding-bottom: 1.25em; }
|
|
#toc > ul { margin-left: 0.25em; }
|
|
#toc ul.sectlevel0 > li > a { font-style: italic; }
|
|
#toc ul.sectlevel0 ul.sectlevel1 { margin-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
|
|
#toc ul { list-style-type: none; }
|
|
#toctitle { color: #7a2518; }
|
|
@media only screen and (min-width: 1280px) { body.toc2 { padding-left: 20em; }
|
|
#toc.toc2 { position: fixed; width: 20em; left: 0; top: 0; border-right: 1px solid #ebebeb; border-bottom: 0; z-index: 1000; padding: 1em; height: 100%; overflow: auto; }
|
|
#toc.toc2 #toctitle { margin-top: 0; }
|
|
#toc.toc2 > ul { font-size: .95em; }
|
|
#toc.toc2 ul ul { margin-left: 0; padding-left: 1.25em; }
|
|
#toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
|
|
body.toc2.toc-right { padding-left: 0; padding-right: 20em; }
|
|
body.toc2.toc-right #toc.toc2 { border-right: 0; border-left: 1px solid #ebebeb; left: auto; right: 0; } }
|
|
#content #toc { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; border-width: 0; -webkit-border-radius: 4px; border-radius: 4px; }
|
|
#content #toc > :first-child { margin-top: 0; }
|
|
#content #toc > :last-child { margin-bottom: 0; }
|
|
#content #toc a { text-decoration: none; }
|
|
#content #toctitle { font-weight: bold; font-family: "Helvetica Neue", "Helvetica", Helvetica, Arial, sans-serif; font-size: 1em; padding-left: 0.125em; }
|
|
#footer { max-width: 100%; background-color: #222222; padding: 1.25em; }
|
|
#footer-text { color: #dddddd; line-height: 1.44; }
|
|
.sect1 { padding-bottom: 1.25em; }
|
|
.sect1 + .sect1 { border-top: 3px double #ebebeb; }
|
|
#content h1 > a.anchor, h2 > a.anchor, h3 > a.anchor, #toctitle > a.anchor, .sidebarblock > .content > .title > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { position: absolute; width: 1em; margin-left: -1em; display: block; text-decoration: none; visibility: hidden; text-align: center; font-weight: normal; }
|
|
#content h1 > a.anchor:before, h2 > a.anchor:before, h3 > a.anchor:before, #toctitle > a.anchor:before, .sidebarblock > .content > .title > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { content: '\00A7'; font-size: .85em; vertical-align: text-top; display: block; margin-top: 0.05em; }
|
|
#content h1:hover > a.anchor, #content h1 > a.anchor:hover, h2:hover > a.anchor, h2 > a.anchor:hover, h3:hover > a.anchor, #toctitle:hover > a.anchor, .sidebarblock > .content > .title:hover > a.anchor, h3 > a.anchor:hover, #toctitle > a.anchor:hover, .sidebarblock > .content > .title > a.anchor:hover, h4:hover > a.anchor, h4 > a.anchor:hover, h5:hover > a.anchor, h5 > a.anchor:hover, h6:hover > a.anchor, h6 > a.anchor:hover { visibility: visible; }
|
|
#content h1 > a.link, h2 > a.link, h3 > a.link, #toctitle > a.link, .sidebarblock > .content > .title > a.link, h4 > a.link, h5 > a.link, h6 > a.link { color: #ba3925; text-decoration: none; }
|
|
#content h1 > a.link:hover, h2 > a.link:hover, h3 > a.link:hover, #toctitle > a.link:hover, .sidebarblock > .content > .title > a.link:hover, h4 > a.link:hover, h5 > a.link:hover, h6 > a.link:hover { color: #a53221; }
|
|
.imageblock, .literalblock, .listingblock, .verseblock, .videoblock { margin-bottom: 1.25em; }
|
|
.admonitionblock td.content > .title, .exampleblock > .title, .imageblock > .title, .videoblock > .title, .listingblock > .title, .literalblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, .sidebarblock > .title, .tableblock > .title, .verseblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-align: left; font-weight: bold; }
|
|
.tableblock > caption { text-align: left; font-weight: bold; white-space: nowrap; overflow: visible; max-width: 0; }
|
|
table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
|
|
.admonitionblock > table { border: 0; background: none; width: 100%; }
|
|
.admonitionblock > table td.icon { text-align: center; width: 80px; }
|
|
.admonitionblock > table td.icon img { max-width: none; }
|
|
.admonitionblock > table td.icon .title { font-weight: bold; text-transform: uppercase; }
|
|
.admonitionblock > table td.content { padding-left: 1.125em; padding-right: 1.25em; border-left: 1px solid #dddddd; color: #6f6f6f; }
|
|
.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
|
|
.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background: white; -webkit-border-radius: 4px; border-radius: 4px; }
|
|
.exampleblock > .content > :first-child { margin-top: 0; }
|
|
.exampleblock > .content > :last-child { margin-bottom: 0; }
|
|
.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6, .exampleblock > .content p { color: #333333; }
|
|
.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6 { line-height: 1; margin-bottom: 0.625em; }
|
|
.exampleblock > .content h1.subheader, .exampleblock > .content h2.subheader, .exampleblock > .content h3.subheader, .exampleblock > .content .subheader#toctitle, .sidebarblock.exampleblock > .content > .subheader.title, .exampleblock > .content h4.subheader, .exampleblock > .content h5.subheader, .exampleblock > .content h6.subheader { line-height: 1.4; }
|
|
.exampleblock.result > .content { -webkit-box-shadow: 0 1px 8px #d9d9d9; box-shadow: 0 1px 8px #d9d9d9; }
|
|
.sidebarblock { border-style: solid; border-width: 1px; border-color: #d9d9d9; margin-bottom: 1.25em; padding: 1.25em; background: #f2f2f2; -webkit-border-radius: 4px; border-radius: 4px; }
|
|
.sidebarblock > :first-child { margin-top: 0; }
|
|
.sidebarblock > :last-child { margin-bottom: 0; }
|
|
.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6, .sidebarblock p { color: #333333; }
|
|
.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6 { line-height: 1; margin-bottom: 0.625em; }
|
|
.sidebarblock h1.subheader, .sidebarblock h2.subheader, .sidebarblock h3.subheader, .sidebarblock .subheader#toctitle, .sidebarblock > .content > .subheader.title, .sidebarblock h4.subheader, .sidebarblock h5.subheader, .sidebarblock h6.subheader { line-height: 1.4; }
|
|
.sidebarblock > .content > .title { color: #7a2518; margin-top: 0; line-height: 1.6; }
|
|
.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
|
|
.literalblock > .content pre, .listingblock > .content pre { background: none; border-width: 1px 0; border-style: dotted; border-color: #bfbfbf; -webkit-border-radius: 4px; border-radius: 4px; padding: 0.75em 0.75em 0.5em 0.75em; word-wrap: break-word; }
|
|
.literalblock > .content pre.nowrap, .listingblock > .content pre.nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
|
|
.literalblock > .content pre > code, .listingblock > .content pre > code { display: block; }
|
|
@media only screen { .literalblock > .content pre, .listingblock > .content pre { font-size: 0.8em; } }
|
|
@media only screen and (min-width: 768px) { .literalblock > .content pre, .listingblock > .content pre { font-size: 0.9em; } }
|
|
@media only screen and (min-width: 1280px) { .literalblock > .content pre, .listingblock > .content pre { font-size: 1em; } }
|
|
.listingblock > .content { position: relative; }
|
|
.listingblock:hover code[class*=" language-"]:before { text-transform: uppercase; font-size: 0.9em; color: #999; position: absolute; top: 0.375em; right: 0.375em; }
|
|
.listingblock:hover code.asciidoc:before { content: "asciidoc"; }
|
|
.listingblock:hover code.clojure:before { content: "clojure"; }
|
|
.listingblock:hover code.css:before { content: "css"; }
|
|
.listingblock:hover code.groovy:before { content: "groovy"; }
|
|
.listingblock:hover code.html:before { content: "html"; }
|
|
.listingblock:hover code.java:before { content: "java"; }
|
|
.listingblock:hover code.javascript:before { content: "javascript"; }
|
|
.listingblock:hover code.python:before { content: "python"; }
|
|
.listingblock:hover code.ruby:before { content: "ruby"; }
|
|
.listingblock:hover code.scss:before { content: "scss"; }
|
|
.listingblock:hover code.xml:before { content: "xml"; }
|
|
.listingblock:hover code.yaml:before { content: "yaml"; }
|
|
.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
|
|
.listingblock.terminal pre .command:not([data-prompt]):before { content: '$'; }
|
|
table.pyhltable { border: 0; margin-bottom: 0; }
|
|
table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; }
|
|
table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
|
|
.highlight.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #dddddd; }
|
|
.highlight.pygments .lineno { display: inline-block; margin-right: .25em; }
|
|
table.pyhltable .linenodiv { background-color: transparent !important; padding-right: 0 !important; }
|
|
.quoteblock { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 1px solid #dddddd; }
|
|
.quoteblock blockquote { margin: 0 0 1.25em 0; padding: 0 0 0.5625em 0; border: 0; }
|
|
.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
|
|
.quoteblock .attribution { margin-top: -.25em; padding-bottom: 0.5625em; font-size: inherit; color: #555555; }
|
|
.quoteblock .attribution br { display: none; }
|
|
.quoteblock .attribution cite { display: block; margin-bottom: 0.625em; }
|
|
table thead th, table tfoot th { font-weight: bold; }
|
|
table.tableblock.grid-all { border-collapse: separate; border-spacing: 1px; -webkit-border-radius: 4px; border-radius: 4px; border-top: 1px solid #dddddd; border-bottom: 1px solid #dddddd; }
|
|
table.tableblock.frame-topbot, table.tableblock.frame-none { border-left: 0; border-right: 0; }
|
|
table.tableblock.frame-sides, table.tableblock.frame-none { border-top: 0; border-bottom: 0; }
|
|
table.tableblock td .paragraph:last-child p, table.tableblock td > p:last-child { margin-bottom: 0; }
|
|
th.tableblock.halign-left, td.tableblock.halign-left { text-align: left; }
|
|
th.tableblock.halign-right, td.tableblock.halign-right { text-align: right; }
|
|
th.tableblock.halign-center, td.tableblock.halign-center { text-align: center; }
|
|
th.tableblock.valign-top, td.tableblock.valign-top { vertical-align: top; }
|
|
th.tableblock.valign-bottom, td.tableblock.valign-bottom { vertical-align: bottom; }
|
|
th.tableblock.valign-middle, td.tableblock.valign-middle { vertical-align: middle; }
|
|
p.tableblock.header { color: #222222; font-weight: bold; }
|
|
td > div.verse { white-space: pre; }
|
|
ol { margin-left: 1.75em; }
|
|
ul li ol { margin-left: 1.5em; }
|
|
dl dd { margin-left: 1.125em; }
|
|
dl dd:last-child, dl dd:last-child > :last-child { margin-bottom: 0; }
|
|
ol > li p, ul > li p, ul dd, ol dd, .olist .olist, .ulist .ulist, .ulist .olist, .olist .ulist { margin-bottom: 0.625em; }
|
|
ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
|
|
ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
|
|
ul.checklist li > p:first-child > i[class^="icon-check"]:first-child, ul.checklist li > p:first-child > input[type="checkbox"]:first-child { margin-right: 0.25em; }
|
|
ul.checklist li > p:first-child > input[type="checkbox"]:first-child { position: relative; top: 1px; }
|
|
ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
|
|
ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
|
|
ul.inline > li > * { display: block; }
|
|
.unstyled dl dt { font-weight: normal; font-style: normal; }
|
|
ol.arabic { list-style-type: decimal; }
|
|
ol.decimal { list-style-type: decimal-leading-zero; }
|
|
ol.loweralpha { list-style-type: lower-alpha; }
|
|
ol.upperalpha { list-style-type: upper-alpha; }
|
|
ol.lowerroman { list-style-type: lower-roman; }
|
|
ol.upperroman { list-style-type: upper-roman; }
|
|
ol.lowergreek { list-style-type: lower-greek; }
|
|
.hdlist > table, .colist > table { border: 0; background: none; }
|
|
.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
|
|
td.hdlist1 { padding-right: .8em; font-weight: bold; }
|
|
td.hdlist1, td.hdlist2 { vertical-align: top; }
|
|
.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em; }
|
|
.colist > table tr > td:first-of-type { padding: 0 .8em; line-height: 1; }
|
|
.colist > table tr > td:last-of-type { padding: 0.25em 0; }
|
|
.qanda > ol > li > p > em:only-child { color: #00467f; }
|
|
.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
|
|
.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0; }
|
|
.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em; }
|
|
.imageblock > .title { margin-bottom: 0; }
|
|
.imageblock.thumb, .imageblock.th { border-width: 6px; }
|
|
.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
|
|
.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
|
|
.image.left { margin-right: 0.625em; }
|
|
.image.right { margin-left: 0.625em; }
|
|
a.image { text-decoration: none; }
|
|
span.footnote, span.footnoteref { vertical-align: super; font-size: 0.875em; }
|
|
span.footnote a, span.footnoteref a { text-decoration: none; }
|
|
#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
|
|
#footnotes hr { width: 20%; min-width: 6.25em; margin: -.25em 0 .75em 0; border-width: 1px 0 0 0; }
|
|
#footnotes .footnote { padding: 0 0.375em; line-height: 1.3; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.2em; margin-bottom: .2em; }
|
|
#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
|
|
#footnotes .footnote:last-of-type { margin-bottom: 0; }
|
|
#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
|
|
.gist .file-data > table { border: none; background: #fff; width: 100%; margin-bottom: 0; }
|
|
.gist .file-data > table td.line-data { width: 99%; }
|
|
div.unbreakable { page-break-inside: avoid; }
|
|
.big { font-size: larger; }
|
|
.small { font-size: smaller; }
|
|
.underline { text-decoration: underline; }
|
|
.overline { text-decoration: overline; }
|
|
.line-through { text-decoration: line-through; }
|
|
.aqua { color: #00bfbf; }
|
|
.aqua-background { background-color: #00fafa; }
|
|
.black { color: black; }
|
|
.black-background { background-color: black; }
|
|
.blue { color: #0000bf; }
|
|
.blue-background { background-color: #0000fa; }
|
|
.fuchsia { color: #bf00bf; }
|
|
.fuchsia-background { background-color: #fa00fa; }
|
|
.gray { color: #606060; }
|
|
.gray-background { background-color: #7d7d7d; }
|
|
.green { color: #006000; }
|
|
.green-background { background-color: #007d00; }
|
|
.lime { color: #00bf00; }
|
|
.lime-background { background-color: #00fa00; }
|
|
.maroon { color: #600000; }
|
|
.maroon-background { background-color: #7d0000; }
|
|
.navy { color: #000060; }
|
|
.navy-background { background-color: #00007d; }
|
|
.olive { color: #606000; }
|
|
.olive-background { background-color: #7d7d00; }
|
|
.purple { color: #600060; }
|
|
.purple-background { background-color: #7d007d; }
|
|
.red { color: #bf0000; }
|
|
.red-background { background-color: #fa0000; }
|
|
.silver { color: #909090; }
|
|
.silver-background { background-color: #bcbcbc; }
|
|
.teal { color: #006060; }
|
|
.teal-background { background-color: #007d7d; }
|
|
.white { color: #bfbfbf; }
|
|
.white-background { background-color: #fafafa; }
|
|
.yellow { color: #bfbf00; }
|
|
.yellow-background { background-color: #fafa00; }
|
|
span.icon > [class^="icon-"], span.icon > [class*=" icon-"] { cursor: default; }
|
|
.admonitionblock td.icon [class^="icon-"]:before { font-size: 2.5em; text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5); cursor: default; }
|
|
.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #005498; color: #003f72; }
|
|
.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; text-shadow: 1px 1px 2px rgba(155, 155, 0, 0.8); color: #111; }
|
|
.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #bf6900; }
|
|
.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #bf3400; }
|
|
.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #bf0000; }
|
|
.conum { display: inline-block; color: white !important; background-color: #222222; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; width: 20px; height: 20px; font-size: 12px; font-weight: bold; line-height: 20px; font-family: Arial, sans-serif; font-style: normal; position: relative; top: -2px; letter-spacing: -1px; }
|
|
.conum * { color: white !important; }
|
|
.conum + b { display: none; }
|
|
.conum:after { content: attr(data-value); }
|
|
.conum:not([data-value]):empty { display: none; }
|
|
.literalblock > .content > pre, .listingblock > .content > pre { -webkit-border-radius: 0; border-radius: 0; }
|
|
|
|
</style>
|
|
</head>
|
|
<body class="article">
|
|
<div id="header">
|
|
</div>
|
|
<div id="content">
|
|
<div class="sect1">
|
|
<h2 id="_operations">Operations</h2>
|
|
<div class="sectionbody">
|
|
<div class="sect2">
|
|
<h3 id="_get_available_resources">get available resources</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">default</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_apiresourcelist">v1.APIResourceList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_configmap">list or watch objects of kind ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/configmaps</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_2">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmaplist">v1.ConfigMapList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_2">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_2">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_2">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_event">list or watch objects of kind Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/events</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_2">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_3">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_eventlist">v1.EventList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_3">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_3">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_3">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_namespace">list or watch objects of kind Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_3">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_4">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespacelist">v1.NamespaceList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_4">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_4">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_4">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_create_a_namespace">create a Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>POST /api/v1/namespaces</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_4">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_5">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">202</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Accepted</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_5">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_5">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_5">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_configmap_2">list or watch objects of kind ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/configmaps</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_5">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_6">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmaplist">v1.ConfigMapList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_6">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_6">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_6">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_collection_of_configmap">delete collection of ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/configmaps</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_6">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_7">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_7">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_7">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_7">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_create_a_configmap">create a ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>POST /api/v1/namespaces/{namespace}/configmaps</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_7">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_8">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">202</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Accepted</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_8">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_8">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_8">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_the_specified_configmap">read the specified ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/configmaps/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_8">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">export</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should this value be exported. Export strips fields that a user can not specify.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">exact</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should the export be exact. Exact export maintains cluster-specific fields like <em>Namespace</em>.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the ConfigMap</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_9">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_9">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_9">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_9">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_the_specified_configmap">replace the specified ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{namespace}/configmaps/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_9">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the ConfigMap</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_10">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_10">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_10">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_10">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_a_configmap">delete a ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/configmaps/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_10">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_deleteoptions">v1.DeleteOptions</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriodSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">orphanDependents</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object’s finalizers list. Either this field or PropagationPolicy may be set, but not both.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">propagationPolicy</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the ConfigMap</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_11">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_11">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_11">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_11">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_the_specified_configmap">partially update the specified ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{namespace}/configmaps/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_11">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the ConfigMap</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_12">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_configmap">v1.ConfigMap</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_12">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_12">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_12">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_event_2">list or watch objects of kind Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/events</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_12">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_13">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_eventlist">v1.EventList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_13">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_13">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_13">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_collection_of_event">delete collection of Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/events</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_13">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_14">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_14">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_14">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_14">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_create_an_event">create an Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>POST /api/v1/namespaces/{namespace}/events</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_14">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_15">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">202</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Accepted</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_15">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_15">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_15">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_the_specified_event">read the specified Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/events/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_15">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">export</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should this value be exported. Export strips fields that a user can not specify.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">exact</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should the export be exact. Exact export maintains cluster-specific fields like <em>Namespace</em>.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Event</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_16">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_16">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_16">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_16">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_the_specified_event">replace the specified Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{namespace}/events/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_16">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Event</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_17">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_17">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_17">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_17">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_an_event">delete an Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/events/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_17">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_deleteoptions">v1.DeleteOptions</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriodSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">orphanDependents</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object’s finalizers list. Either this field or PropagationPolicy may be set, but not both.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">propagationPolicy</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Event</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_18">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_18">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_18">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_18">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_the_specified_event">partially update the specified Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{namespace}/events/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_18">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Event</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_19">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_event">v1.Event</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_19">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_19">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_19">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_secret">list or watch objects of kind Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/secrets</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_19">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_20">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secretlist">v1.SecretList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_20">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_20">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_20">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_collection_of_secret">delete collection of Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/secrets</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_20">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_21">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_21">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_21">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_21">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_create_a_secret">create a Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>POST /api/v1/namespaces/{namespace}/secrets</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_21">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_22">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">202</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Accepted</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_22">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_22">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_22">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_the_specified_secret">read the specified Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/secrets/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_22">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">export</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should this value be exported. Export strips fields that a user can not specify.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">exact</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should the export be exact. Exact export maintains cluster-specific fields like <em>Namespace</em>.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Secret</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_23">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_23">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_23">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_23">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_the_specified_secret">replace the specified Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{namespace}/secrets/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_23">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Secret</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_24">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_24">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_24">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_24">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_a_secret">delete a Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/secrets/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_24">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_deleteoptions">v1.DeleteOptions</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriodSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">orphanDependents</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object’s finalizers list. Either this field or PropagationPolicy may be set, but not both.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">propagationPolicy</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Secret</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_25">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_25">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_25">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_25">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_the_specified_secret">partially update the specified Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{namespace}/secrets/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_25">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Secret</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_26">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secret">v1.Secret</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_26">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_26">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_26">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_service">list or watch objects of kind Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/services</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_26">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_27">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_servicelist">v1.ServiceList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_27">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_27">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_27">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_collection_of_service">delete collection of Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/services</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_27">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_28">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_28">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_28">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_28">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_create_a_service">create a Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>POST /api/v1/namespaces/{namespace}/services</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_28">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_29">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">202</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Accepted</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_29">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_29">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_29">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_the_specified_service">read the specified Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/services/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_29">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">export</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should this value be exported. Export strips fields that a user can not specify.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">exact</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should the export be exact. Exact export maintains cluster-specific fields like <em>Namespace</em>.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_30">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_30">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_30">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_30">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_the_specified_service">replace the specified Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{namespace}/services/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_30">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_31">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_31">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_31">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_31">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_a_service">delete a Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{namespace}/services/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_31">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_deleteoptions">v1.DeleteOptions</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriodSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">orphanDependents</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object’s finalizers list. Either this field or PropagationPolicy may be set, but not both.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">propagationPolicy</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_32">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_32">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_32">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_32">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_the_specified_service">partially update the specified Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{namespace}/services/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_32">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_33">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_33">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_33">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_33">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_status_of_the_specified_service">read status of the specified Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{namespace}/services/{name}/status</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_33">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_34">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_34">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_34">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_34">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_status_of_the_specified_service">replace status of the specified Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{namespace}/services/{name}/status</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_34">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_35">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_35">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_35">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_35">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_status_of_the_specified_service">partially update status of the specified Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{namespace}/services/{name}/status</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_35">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_36">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_service">v1.Service</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_36">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_36">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_36">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_the_specified_namespace">read the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_36">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">export</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should this value be exported. Export strips fields that a user can not specify.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">exact</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Should the export be exact. Exact export maintains cluster-specific fields like <em>Namespace</em>.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_37">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_37">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_37">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_37">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_the_specified_namespace">replace the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_37">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_38">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_38">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_38">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_38">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_delete_a_namespace">delete a Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>DELETE /api/v1/namespaces/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_38">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_deleteoptions">v1.DeleteOptions</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">gracePeriodSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">orphanDependents</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object’s finalizers list. Either this field or PropagationPolicy may be set, but not both.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">propagationPolicy</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_39">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_status">v1.Status</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_39">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_39">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_39">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_the_specified_namespace">partially update the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_39">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_40">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_40">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_40">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_40">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_finalize_of_the_specified_namespace">replace finalize of the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{name}/finalize</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_40">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_41">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_41">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_41">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_41">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_read_status_of_the_specified_namespace">read status of the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/namespaces/{name}/status</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_41">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_42">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_42">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_42">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_42">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_replace_status_of_the_specified_namespace">replace status of the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PUT /api/v1/namespaces/{name}/status</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_42">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_43">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">201</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Created</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_43">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_43">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_43">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_partially_update_status_of_the_specified_namespace">partially update status of the specified Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>PATCH /api/v1/namespaces/{name}/status</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_43">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">BodyParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">body</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_patch">v1.Patch</a></p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_44">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_namespace">v1.Namespace</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_44">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/merge-patch+json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/strategic-merge-patch+json</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_44">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_44">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_secret_2">list or watch objects of kind Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/secrets</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_44">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_45">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_secretlist">v1.SecretList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_45">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_45">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_45">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_list_or_watch_objects_of_kind_service_2">list or watch objects of kind Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/services</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_45">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_46">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_servicelist">v1.ServiceList</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_46">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_46">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_46">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_configmap">watch individual changes to a list of ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/configmaps</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_46">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_47">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_47">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_47">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_47">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_event">watch individual changes to a list of Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/events</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_47">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_48">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_48">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_48">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_48">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_namespace">watch individual changes to a list of Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_48">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_49">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_49">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_49">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_49">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_configmap_2">watch individual changes to a list of ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/configmaps</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_49">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_50">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_50">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_50">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_50">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_changes_to_an_object_of_kind_configmap">watch changes to an object of kind ConfigMap</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/configmaps/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_50">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the ConfigMap</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_51">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_51">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_51">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_51">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_event_2">watch individual changes to a list of Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/events</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_51">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_52">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_52">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_52">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_52">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_changes_to_an_object_of_kind_event">watch changes to an object of kind Event</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/events/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_52">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Event</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_53">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_53">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_53">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_53">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_secret">watch individual changes to a list of Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/secrets</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_53">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_54">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_54">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_54">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_54">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_changes_to_an_object_of_kind_secret">watch changes to an object of kind Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/secrets/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_54">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Secret</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_55">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_55">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_55">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_55">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_service">watch individual changes to a list of Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/services</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_55">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_56">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_56">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_56">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_56">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_changes_to_an_object_of_kind_service">watch changes to an object of kind Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{namespace}/services/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_56">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">object name and auth scope, such as for teams and projects</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Service</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_57">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_57">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_57">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_57">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_changes_to_an_object_of_kind_namespace">watch changes to an object of kind Namespace</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/namespaces/{name}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_57">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">PathParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">name of the Namespace</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">true</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_58">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_58">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_58">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_58">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_secret_2">watch individual changes to a list of Secret</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/secrets</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_58">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_59">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_59">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_59">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_59">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_watch_individual_changes_to_a_list_of_service_2">watch individual changes to a list of Service</h3>
|
|
<div class="listingblock">
|
|
<div class="content">
|
|
<pre>GET /api/v1/watch/services</pre>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_parameters_59">Parameters</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
<col style="width:16%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">Type</th>
|
|
<th class="tableblock halign-left valign-top">Name</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Required</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
<th class="tableblock halign-left valign-top">Default</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">pretty</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If <em>true</em>, then the output is pretty printed.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">labelSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their labels. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">fieldSelector</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">A selector to restrict the list of returned objects by their fields. Defaults to everything.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">includeUninitialized</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">If true, partially initialized resources are included in the response.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">watch</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">resourceVersion</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">timeoutSeconds</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">Timeout for the list/watch call.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">limit is a maximum number of responses to return for a list call. If more items exist, the server will set the <code>continue</code> field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
|
|
</p><p class="tableblock">The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">integer (int32)</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">QueryParameter</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">continue</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">string</p></td>
|
|
<td class="tableblock halign-left valign-top"></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_responses_60">Responses</h4>
|
|
<table class="tableblock frame-all grid-all" style="width:100%; ">
|
|
<colgroup>
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
<col style="width:33%;">
|
|
</colgroup>
|
|
<thead>
|
|
<tr>
|
|
<th class="tableblock halign-left valign-top">HTTP Code</th>
|
|
<th class="tableblock halign-left valign-top">Description</th>
|
|
<th class="tableblock halign-left valign-top">Schema</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock">success</p></td>
|
|
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../definitions#_v1_watchevent">v1.WatchEvent</a></p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_consumes_60">Consumes</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p><strong>/</strong></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_produces_60">Produces</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>application/json</p>
|
|
</li>
|
|
<li>
|
|
<p>application/yaml</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf</p>
|
|
</li>
|
|
<li>
|
|
<p>application/json;stream=watch</p>
|
|
</li>
|
|
<li>
|
|
<p>application/vnd.kubernetes.protobuf;stream=watch</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="sect3">
|
|
<h4 id="_tags_60">Tags</h4>
|
|
<div class="ulist">
|
|
<ul>
|
|
<li>
|
|
<p>apiv1</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="footer">
|
|
<div id="footer-text">
|
|
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|