---
api_metadata:
  apiVersion: "{{.ApiVersion}}"
  import: "{{.Import}}"
  kind: "{{.Kind}}"
content_type: "api_reference"
description: "{{.Metadata.Description}}"
title: "{{.Metadata.Title}}"
weight: {{.Metadata.Weight}}
auto_generated: true
---

[//]: # (The file is auto-generated from the Go source code of the component using a generic generator,)
[//]: # (which is forked from [reference-docs](https://github.com/kubernetes-sigs/reference-docs.)
[//]: # (To update the reference content, please follow the `reference-api.sh`.)

{{if .ApiVersion}}`apiVersion: {{.ApiVersion}}`{{end}}

{{if .Import}}`import "{{.Import}}"`{{end}}

{{range .Sections}}
{{.Description | replace "<" "\\<" }}

<hr/>
{{range .Fields}}
{{ ""  | indent .Indent | indent .Indent}}- {{.Name}}{{if .Value}}: {{.Value}}{{end}}
{{if .Description}}
{{.Description | replace "<" "\\<" | indent 2 | indent .Indent | indent .Indent}}
{{- end}}
{{if .TypeDefinition}}
{{ ""  | indent .Indent | indent .Indent}}  <a name="{{.Type}}"></a>

{{.TypeDefinition | indent 2 | indent .Indent | indent .Indent}}
{{end}}
{{- end}}{{/* range .Fields */}}

{{range .FieldCategories}}
### {{.Name}} {{/* explicitly set fragment to keep capitalization */}}

{{range .Fields}}
{{ ""  | indent .Indent | indent .Indent}}- {{.Name}}{{if .Value}}: {{.Value}}{{end}}
{{if .Description}}
{{.Description | replace "<" "\\<" | indent 2 | indent .Indent | indent .Indent}}
{{- end}}
{{if .TypeDefinition}}
{{ ""  | indent .Indent | indent .Indent}}  <a name="{{.Type}}"></a>

{{.TypeDefinition | indent 2 | indent .Indent | indent .Indent}}
{{end}}
{{- end}}{{/* range .Fields */}}

{{- end}}{{/* range .FieldCategories */}}

{{range .Operations}}

### `{{.Verb}}` {{.Title}}

#### HTTP Request

{{.RequestMethod}} {{.RequestPath}}

#### Parameters

{{range .Parameters}}
- {{.Title}}

{{.Description | indent 2}}

{{end}}{{/* range .Parameters */}}

#### Response

{{range .Responses}}
{{.Code}}{{if .Type}} ({{.Type}}){{end}}: {{.Description}}
{{end}}{{/* range .Responses */}}

{{- end}}{{/* range .Operations */}}
{{- end}}{{/* range .Sections */}}