kubernetes reference apiVersion v1 kind ConfigMap title ConfigMap contenttype apireference ConfigMap holds configuration data for pods to consume apimetadata autogenerated true weight 1 import k8s io api core v1

Answer:
---
api_metadata:
  apiVersion: "v1"
  import: "k8s.io/api/core/v1"
  kind: "ConfigMap"
content_type: "api_reference"
description: "ConfigMap holds configuration data for pods to consume."
title: "ConfigMap"
weight: 1
auto_generated: true
---

`apiVersion: v1`

`import "k8s.io/api/core/v1"`

## ConfigMap {#ConfigMap}

ConfigMap holds configuration data for pods to consume.

- **apiVersion**: v1

- **kind**: ConfigMap

- **metadata** (ObjectMeta)

  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **binaryData** (map[string][]byte)

  BinaryData contains the binary data. Each key must consist of alphanumeric characters, '-', '_' or '.'. BinaryData can contain byte sequences that are not in the UTF-8 range. The keys stored in BinaryData must not overlap with the ones in the Data field, this is enforced during validation process. Using this field will require 1.10+ apiserver and kubelet.

- **data** (map[string]string)

  Data contains the configuration data. Each key must consist of alphanumeric characters, '-', '_' or '.'. Values with non-UTF-8 byte sequences must use the BinaryData field. The keys stored in Data must not overlap with the keys in the BinaryData field, this is enforced during validation process.

- **immutable** (boolean)

  Immutable, if set to true, ensures that data stored in the ConfigMap cannot be updated (only object metadata can be modified). If not set to true, the field can be modified at any time. Defaulted to nil.

## ConfigMapList {#ConfigMapList}

ConfigMapList is a resource containing a list of ConfigMap objects.

- **apiVersion**: v1

- **kind**: ConfigMapList

- **metadata** (ListMeta)

  More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **items** ([]ConfigMap), required

  Items is the list of ConfigMaps.

## Operations {#Operations}

### `get` read the specified ConfigMap

#### HTTP Request

GET /api/v1/namespaces/{namespace}/configmaps/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ConfigMap

- **namespace** (*in path*): string, required

  namespace

- **pretty** (*in query*): string

  pretty

#### Response

200 (ConfigMap): OK

401: Unauthorized

### `list` list or watch objects of kind ConfigMap

#### HTTP Request

GET /api/v1/namespaces/{namespace}/configmaps

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (ConfigMapList): OK

401: Unauthorized

### `list` list or watch objects of kind ConfigMap

#### HTTP Request

GET /api/v1/configmaps

#### Parameters

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (ConfigMapList): OK

401: Unauthorized

### `create` create a ConfigMap

#### HTTP Request

POST /api/v1/namespaces/{namespace}/configmaps

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **body**: ConfigMap, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (ConfigMap): OK

201 (ConfigMap): Created

202 (ConfigMap): Accepted

401: Unauthorized

### `update` replace the specified ConfigMap

#### HTTP Request

PUT /api/v1/namespaces/{namespace}/configmaps/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ConfigMap

- **namespace** (*in path*): string, required

  namespace

- **body**: ConfigMap, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (ConfigMap): OK

201 (ConfigMap): Created

401: Unauthorized

### `patch` partially update the specified ConfigMap

#### HTTP Request

PATCH /api/v1/namespaces/{namespace}/configmaps/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ConfigMap

- **namespace** (*in path*): string, required

  namespace

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (ConfigMap): OK

201 (ConfigMap): Created

401: Unauthorized

### `delete` delete a ConfigMap

#### HTTP Request

DELETE /api/v1/namespaces/{namespace}/configmaps/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ConfigMap

- **namespace** (*in path*): string, required

  namespace

- **body**: DeleteOptions

- **dryRun** (*in query*): string

  dryRun

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

#### Response

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

### `deletecollection` delete collection of ConfigMap

#### HTTP Request

DELETE /api/v1/namespaces/{namespace}/configmaps

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **body**: DeleteOptions

- **continue** (*in query*): string

  continue

- **dryRun** (*in query*): string

  dryRun

- **fieldSelector** (*in query*): string

  fieldSelector

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

#### Response

200 (Status): OK

401: Unauthorized

api metadata    apiVersion   v1    import   k8s io api core v1    kind   ConfigMap  content type   api reference  description   ConfigMap holds configuration data for pods to consume   title   ConfigMap  weight  1 auto generated  true           The file is auto generated from the Go source code of the component using a generic  generator  https   github com kubernetes sigs reference docs    To learn how to generate the reference documentation  please read  Contributing to the reference documentation   docs contribute generate ref docs    To update the reference content  please follow the   Contributing upstream   docs contribute generate ref docs contribute upstream   guide  You can file document formatting bugs against the  reference docs  https   github com kubernetes sigs reference docs   project        apiVersion  v1    import  k8s io api core v1        ConfigMap   ConfigMap   ConfigMap holds configuration data for pods to consume    hr       apiVersion    v1       kind    ConfigMap       metadata     a href    ObjectMeta  a      Standard object s metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      binaryData    map string   byte     BinaryData contains the binary data  Each key must consist of alphanumeric characters           or      BinaryData can contain byte sequences that are not in the UTF 8 range  The keys stored in BinaryData must not overlap with the ones in the Data field  this is enforced during validation process  Using this field will require 1 10  apiserver and kubelet       data    map string string     Data contains the configuration data  Each key must consist of alphanumeric characters           or      Values with non UTF 8 byte sequences must use the BinaryData field  The keys stored in Data must not overlap with the keys in the BinaryData field  this is enforced during validation process       immutable    boolean     Immutable  if set to true  ensures that data stored in the ConfigMap cannot be updated  only object metadata can be modified   If not set to true  the field can be modified at any time  Defaulted to nil          ConfigMapList   ConfigMapList   ConfigMapList is a resource containing a list of ConfigMap objects    hr       apiVersion    v1       kind    ConfigMapList       metadata     a href    ListMeta  a      More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      items       a href    ConfigMap  a    required    Items is the list of ConfigMaps          Operations   Operations      hr             get  read the specified ConfigMap       HTTP Request  GET  api v1 namespaces  namespace  configmaps  name        Parameters       name     in path    string  required    name of the ConfigMap       namespace     in path    string  required     a href    namespace  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ConfigMap  a    OK  401  Unauthorized        list  list or watch objects of kind ConfigMap       HTTP Request  GET  api v1 namespaces  namespace  configmaps       Parameters       namespace     in path    string  required     a href    namespace  a        allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    ConfigMapList  a    OK  401  Unauthorized        list  list or watch objects of kind ConfigMap       HTTP Request  GET  api v1 configmaps       Parameters       allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    ConfigMapList  a    OK  401  Unauthorized        create  create a ConfigMap       HTTP Request  POST  api v1 namespaces  namespace  configmaps       Parameters       namespace     in path    string  required     a href    namespace  a        body     a href    ConfigMap  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ConfigMap  a    OK  201   a href    ConfigMap  a    Created  202   a href    ConfigMap  a    Accepted  401  Unauthorized        update  replace the specified ConfigMap       HTTP Request  PUT  api v1 namespaces  namespace  configmaps  name        Parameters       name     in path    string  required    name of the ConfigMap       namespace     in path    string  required     a href    namespace  a        body     a href    ConfigMap  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ConfigMap  a    OK  201   a href    ConfigMap  a    Created  401  Unauthorized        patch  partially update the specified ConfigMap       HTTP Request  PATCH  api v1 namespaces  namespace  configmaps  name        Parameters       name     in path    string  required    name of the ConfigMap       namespace     in path    string  required     a href    namespace  a        body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ConfigMap  a    OK  201   a href    ConfigMap  a    Created  401  Unauthorized        delete  delete a ConfigMap       HTTP Request  DELETE  api v1 namespaces  namespace  configmaps  name        Parameters       name     in path    string  required    name of the ConfigMap       namespace     in path    string  required     a href    namespace  a        body     a href    DeleteOptions  a            dryRun     in query    string     a href    dryRun  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a          Response   200   a href    Status  a    OK  202   a href    Status  a    Accepted  401  Unauthorized        deletecollection  delete collection of ConfigMap       HTTP Request  DELETE  api v1 namespaces  namespace  configmaps       Parameters       namespace     in path    string  required     a href    namespace  a        body     a href    DeleteOptions  a            continue     in query    string     a href    continue  a        dryRun     in query    string     a href    dryRun  a        fieldSelector     in query    string     a href    fieldSelector  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a          Response   200   a href    Status  a    OK  401  Unauthorized


kubernetes reference kind Secret apiVersion v1 weight 2 contenttype apireference Secret holds secret data of a certain type apimetadata title Secret autogenerated true import k8s io api core v1

Answer:
---
api_metadata:
  apiVersion: "v1"
  import: "k8s.io/api/core/v1"
  kind: "Secret"
content_type: "api_reference"
description: "Secret holds secret data of a certain type."
title: "Secret"
weight: 2
auto_generated: true
---

`apiVersion: v1`

`import "k8s.io/api/core/v1"`

## Secret {#Secret}

Secret holds secret data of a certain type. The total bytes of the values in the Data field must be less than MaxSecretSize bytes.

- **apiVersion**: v1

- **kind**: Secret

- **metadata** (ObjectMeta)

  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **data** (map[string][]byte)

  Data contains the secret data. Each key must consist of alphanumeric characters, '-', '_' or '.'. The serialized form of the secret data is a base64 encoded string, representing the arbitrary (possibly non-string) data value here. Described in https://tools.ietf.org/html/rfc4648#section-4

- **immutable** (boolean)

  Immutable, if set to true, ensures that data stored in the Secret cannot be updated (only object metadata can be modified). If not set to true, the field can be modified at any time. Defaulted to nil.

- **stringData** (map[string]string)

  stringData allows specifying non-binary secret data in string form. It is provided as a write-only input field for convenience. All keys and values are merged into the data field on write, overwriting any existing values. The stringData field is never output when reading from the API.

- **type** (string)

  Used to facilitate programmatic handling of secret data. More info: https://kubernetes.io/docs/concepts/configuration/secret/#secret-types

## SecretList {#SecretList}

SecretList is a list of Secret.

- **apiVersion**: v1

- **kind**: SecretList

- **metadata** (ListMeta)

  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

- **items** ([]Secret), required

  Items is a list of secret objects. More info: https://kubernetes.io/docs/concepts/configuration/secret

## Operations {#Operations}

### `get` read the specified Secret

#### HTTP Request

GET /api/v1/namespaces/{namespace}/secrets/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the Secret

- **namespace** (*in path*): string, required

  namespace

- **pretty** (*in query*): string

  pretty

#### Response

200 (Secret): OK

401: Unauthorized

### `list` list or watch objects of kind Secret

#### HTTP Request

GET /api/v1/namespaces/{namespace}/secrets

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (SecretList): OK

401: Unauthorized

### `list` list or watch objects of kind Secret

#### HTTP Request

GET /api/v1/secrets

#### Parameters

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (SecretList): OK

401: Unauthorized

### `create` create a Secret

#### HTTP Request

POST /api/v1/namespaces/{namespace}/secrets

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **body**: Secret, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (Secret): OK

201 (Secret): Created

202 (Secret): Accepted

401: Unauthorized

### `update` replace the specified Secret

#### HTTP Request

PUT /api/v1/namespaces/{namespace}/secrets/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the Secret

- **namespace** (*in path*): string, required

  namespace

- **body**: Secret, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (Secret): OK

201 (Secret): Created

401: Unauthorized

### `patch` partially update the specified Secret

#### HTTP Request

PATCH /api/v1/namespaces/{namespace}/secrets/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the Secret

- **namespace** (*in path*): string, required

  namespace

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (Secret): OK

201 (Secret): Created

401: Unauthorized

### `delete` delete a Secret

#### HTTP Request

DELETE /api/v1/namespaces/{namespace}/secrets/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the Secret

- **namespace** (*in path*): string, required

  namespace

- **body**: DeleteOptions

- **dryRun** (*in query*): string

  dryRun

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

#### Response

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

### `deletecollection` delete collection of Secret

#### HTTP Request

DELETE /api/v1/namespaces/{namespace}/secrets

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **body**: DeleteOptions

- **continue** (*in query*): string

  continue

- **dryRun** (*in query*): string

  dryRun

- **fieldSelector** (*in query*): string

  fieldSelector

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

#### Response

200 (Status): OK

401: Unauthorized

api metadata    apiVersion   v1    import   k8s io api core v1    kind   Secret  content type   api reference  description   Secret holds secret data of a certain type   title   Secret  weight  2 auto generated  true           The file is auto generated from the Go source code of the component using a generic  generator  https   github com kubernetes sigs reference docs    To learn how to generate the reference documentation  please read  Contributing to the reference documentation   docs contribute generate ref docs    To update the reference content  please follow the   Contributing upstream   docs contribute generate ref docs contribute upstream   guide  You can file document formatting bugs against the  reference docs  https   github com kubernetes sigs reference docs   project        apiVersion  v1    import  k8s io api core v1        Secret   Secret   Secret holds secret data of a certain type  The total bytes of the values in the Data field must be less than MaxSecretSize bytes    hr       apiVersion    v1       kind    Secret       metadata     a href    ObjectMeta  a      Standard object s metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      data    map string   byte     Data contains the secret data  Each key must consist of alphanumeric characters           or      The serialized form of the secret data is a base64 encoded string  representing the arbitrary  possibly non string  data value here  Described in https   tools ietf org html rfc4648 section 4      immutable    boolean     Immutable  if set to true  ensures that data stored in the Secret cannot be updated  only object metadata can be modified   If not set to true  the field can be modified at any time  Defaulted to nil       stringData    map string string     stringData allows specifying non binary secret data in string form  It is provided as a write only input field for convenience  All keys and values are merged into the data field on write  overwriting any existing values  The stringData field is never output when reading from the API       type    string     Used to facilitate programmatic handling of secret data  More info  https   kubernetes io docs concepts configuration secret  secret types         SecretList   SecretList   SecretList is a list of Secret    hr       apiVersion    v1       kind    SecretList       metadata     a href    ListMeta  a      Standard list metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md types kinds      items       a href    Secret  a    required    Items is a list of secret objects  More info  https   kubernetes io docs concepts configuration secret         Operations   Operations      hr             get  read the specified Secret       HTTP Request  GET  api v1 namespaces  namespace  secrets  name        Parameters       name     in path    string  required    name of the Secret       namespace     in path    string  required     a href    namespace  a        pretty     in query    string     a href    pretty  a          Response   200   a href    Secret  a    OK  401  Unauthorized        list  list or watch objects of kind Secret       HTTP Request  GET  api v1 namespaces  namespace  secrets       Parameters       namespace     in path    string  required     a href    namespace  a        allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    SecretList  a    OK  401  Unauthorized        list  list or watch objects of kind Secret       HTTP Request  GET  api v1 secrets       Parameters       allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    SecretList  a    OK  401  Unauthorized        create  create a Secret       HTTP Request  POST  api v1 namespaces  namespace  secrets       Parameters       namespace     in path    string  required     a href    namespace  a        body     a href    Secret  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    Secret  a    OK  201   a href    Secret  a    Created  202   a href    Secret  a    Accepted  401  Unauthorized        update  replace the specified Secret       HTTP Request  PUT  api v1 namespaces  namespace  secrets  name        Parameters       name     in path    string  required    name of the Secret       namespace     in path    string  required     a href    namespace  a        body     a href    Secret  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    Secret  a    OK  201   a href    Secret  a    Created  401  Unauthorized        patch  partially update the specified Secret       HTTP Request  PATCH  api v1 namespaces  namespace  secrets  name        Parameters       name     in path    string  required    name of the Secret       namespace     in path    string  required     a href    namespace  a        body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    Secret  a    OK  201   a href    Secret  a    Created  401  Unauthorized        delete  delete a Secret       HTTP Request  DELETE  api v1 namespaces  namespace  secrets  name        Parameters       name     in path    string  required    name of the Secret       namespace     in path    string  required     a href    namespace  a        body     a href    DeleteOptions  a            dryRun     in query    string     a href    dryRun  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a          Response   200   a href    Status  a    OK  202   a href    Status  a    Accepted  401  Unauthorized        deletecollection  delete collection of Secret       HTTP Request  DELETE  api v1 namespaces  namespace  secrets       Parameters       namespace     in path    string  required     a href    namespace  a        body     a href    DeleteOptions  a            continue     in query    string     a href    continue  a        dryRun     in query    string     a href    dryRun  a        fieldSelector     in query    string     a href    fieldSelector  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a          Response   200   a href    Status  a    OK  401  Unauthorized


kubernetes reference autogenerated true CSINode holds information about all CSI drivers installed on a node contenttype apireference apimetadata apiVersion storage k8s io v1 weight 4 title CSINode import k8s io api storage v1 kind CSINode

Answer:
---
api_metadata:
  apiVersion: "storage.k8s.io/v1"
  import: "k8s.io/api/storage/v1"
  kind: "CSINode"
content_type: "api_reference"
description: "CSINode holds information about all CSI drivers installed on a node."
title: "CSINode"
weight: 4
auto_generated: true
---

`apiVersion: storage.k8s.io/v1`

`import "k8s.io/api/storage/v1"`

## CSINode {#CSINode}

CSINode holds information about all CSI drivers installed on a node. CSI drivers do not need to create the CSINode object directly. As long as they use the node-driver-registrar sidecar container, the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration. CSINode has the same name as a node. If the object is missing, it means either there are no CSI Drivers available on the node, or the Kubelet version is low enough that it doesn't create this object. CSINode has an OwnerReference that points to the corresponding node object.

- **apiVersion**: storage.k8s.io/v1

- **kind**: CSINode

- **metadata** (ObjectMeta)

  Standard object's metadata. metadata.name must be the Kubernetes node name.

- **spec** (CSINodeSpec), required

  spec is the specification of CSINode

## CSINodeSpec {#CSINodeSpec}

CSINodeSpec holds information about the specification of all CSI drivers installed on a node

- **drivers** ([]CSINodeDriver), required

  *Patch strategy: merge on key `name`*

  *Map: unique values on key name will be kept during a merge*

  drivers is a list of information of all CSI Drivers existing on a node. If all drivers in the list are uninstalled, this can become empty.

  *CSINodeDriver holds information about the specification of one CSI driver installed on a node*

  - **drivers.name** (string), required

    name represents the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver.

  - **drivers.nodeID** (string), required

    nodeID of the node from the driver point of view. This field enables Kubernetes to communicate with storage systems that do not share the same nomenclature for nodes. For example, Kubernetes may refer to a given node as "node1", but the storage system may refer to the same node as "nodeA". When Kubernetes issues a command to the storage system to attach a volume to a specific node, it can use this field to refer to the node name using the ID that the storage system will understand, e.g. "nodeA" instead of "node1". This field is required.

  - **drivers.allocatable** (VolumeNodeResources)

    allocatable represents the volume resources of a node that are available for scheduling. This field is beta.

    *VolumeNodeResources is a set of resource limits for scheduling of volumes.*

    - **drivers.allocatable.count** (int32)

      count indicates the maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not twice. The same rule applies for a unique volume that is shared among multiple pods on the same node. If this field is not specified, then the supported number of volumes on this node is unbounded.

  - **drivers.topologyKeys** ([]string)

    *Atomic: will be replaced during a merge*

    topologyKeys is the list of keys supported by the driver. When a driver is initialized on a cluster, it provides a set of topology keys that it understands (e.g. "company.com/zone", "company.com/region"). When a driver is initialized on a node, it provides the same topology keys along with values. Kubelet will expose these topology keys as labels on its own node object. When Kubernetes does topology aware provisioning, it can use this list to determine which labels it should retrieve from the node object and pass back to the driver. It is possible for different nodes to use different topology keys. This can be empty if driver does not support topology.

## CSINodeList {#CSINodeList}

CSINodeList is a collection of CSINode objects.

- **apiVersion**: storage.k8s.io/v1

- **kind**: CSINodeList

- **metadata** (ListMeta)

  Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **items** ([]CSINode), required

  items is the list of CSINode

## Operations {#Operations}

### `get` read the specified CSINode

#### HTTP Request

GET /apis/storage.k8s.io/v1/csinodes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the CSINode

- **pretty** (*in query*): string

  pretty

#### Response

200 (CSINode): OK

401: Unauthorized

### `list` list or watch objects of kind CSINode

#### HTTP Request

GET /apis/storage.k8s.io/v1/csinodes

#### Parameters

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (CSINodeList): OK

401: Unauthorized

### `create` create a CSINode

#### HTTP Request

POST /apis/storage.k8s.io/v1/csinodes

#### Parameters

- **body**: CSINode, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (CSINode): OK

201 (CSINode): Created

202 (CSINode): Accepted

401: Unauthorized

### `update` replace the specified CSINode

#### HTTP Request

PUT /apis/storage.k8s.io/v1/csinodes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the CSINode

- **body**: CSINode, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (CSINode): OK

201 (CSINode): Created

401: Unauthorized

### `patch` partially update the specified CSINode

#### HTTP Request

PATCH /apis/storage.k8s.io/v1/csinodes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the CSINode

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (CSINode): OK

201 (CSINode): Created

401: Unauthorized

### `delete` delete a CSINode

#### HTTP Request

DELETE /apis/storage.k8s.io/v1/csinodes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the CSINode

- **body**: DeleteOptions

- **dryRun** (*in query*): string

  dryRun

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

#### Response

200 (CSINode): OK

202 (CSINode): Accepted

401: Unauthorized

### `deletecollection` delete collection of CSINode

#### HTTP Request

DELETE /apis/storage.k8s.io/v1/csinodes

#### Parameters

- **body**: DeleteOptions

- **continue** (*in query*): string

  continue

- **dryRun** (*in query*): string

  dryRun

- **fieldSelector** (*in query*): string

  fieldSelector

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

#### Response

200 (Status): OK

401: Unauthorized

api metadata    apiVersion   storage k8s io v1    import   k8s io api storage v1    kind   CSINode  content type   api reference  description   CSINode holds information about all CSI drivers installed on a node   title   CSINode  weight  4 auto generated  true           The file is auto generated from the Go source code of the component using a generic  generator  https   github com kubernetes sigs reference docs    To learn how to generate the reference documentation  please read  Contributing to the reference documentation   docs contribute generate ref docs    To update the reference content  please follow the   Contributing upstream   docs contribute generate ref docs contribute upstream   guide  You can file document formatting bugs against the  reference docs  https   github com kubernetes sigs reference docs   project        apiVersion  storage k8s io v1    import  k8s io api storage v1        CSINode   CSINode   CSINode holds information about all CSI drivers installed on a node  CSI drivers do not need to create the CSINode object directly  As long as they use the node driver registrar sidecar container  the kubelet will automatically populate the CSINode object for the CSI driver as part of kubelet plugin registration  CSINode has the same name as a node  If the object is missing  it means either there are no CSI Drivers available on the node  or the Kubelet version is low enough that it doesn t create this object  CSINode has an OwnerReference that points to the corresponding node object    hr       apiVersion    storage k8s io v1       kind    CSINode       metadata     a href    ObjectMeta  a      Standard object s metadata  metadata name must be the Kubernetes node name       spec     a href    CSINodeSpec  a    required    spec is the specification of CSINode         CSINodeSpec   CSINodeSpec   CSINodeSpec holds information about the specification of all CSI drivers installed on a node   hr       drivers      CSINodeDriver   required     Patch strategy  merge on key  name         Map  unique values on key name will be kept during a merge       drivers is a list of information of all CSI Drivers existing on a node  If all drivers in the list are uninstalled  this can become empty      a name  CSINodeDriver    a     CSINodeDriver holds information about the specification of one CSI driver installed on a node         drivers name    string   required      name represents the name of the CSI driver that this object refers to  This MUST be the same name returned by the CSI GetPluginName   call for that driver         drivers nodeID    string   required      nodeID of the node from the driver point of view  This field enables Kubernetes to communicate with storage systems that do not share the same nomenclature for nodes  For example  Kubernetes may refer to a given node as  node1   but the storage system may refer to the same node as  nodeA   When Kubernetes issues a command to the storage system to attach a volume to a specific node  it can use this field to refer to the node name using the ID that the storage system will understand  e g   nodeA  instead of  node1   This field is required         drivers allocatable    VolumeNodeResources       allocatable represents the volume resources of a node that are available for scheduling  This field is beta        a name  VolumeNodeResources    a       VolumeNodeResources is a set of resource limits for scheduling of volumes            drivers allocatable count    int32         count indicates the maximum number of unique volumes managed by the CSI driver that can be used on a node  A volume that is both attached and mounted on a node is considered to be used once  not twice  The same rule applies for a unique volume that is shared among multiple pods on the same node  If this field is not specified  then the supported number of volumes on this node is unbounded         drivers topologyKeys      string        Atomic  will be replaced during a merge           topologyKeys is the list of keys supported by the driver  When a driver is initialized on a cluster  it provides a set of topology keys that it understands  e g   company com zone    company com region    When a driver is initialized on a node  it provides the same topology keys along with values  Kubelet will expose these topology keys as labels on its own node object  When Kubernetes does topology aware provisioning  it can use this list to determine which labels it should retrieve from the node object and pass back to the driver  It is possible for different nodes to use different topology keys  This can be empty if driver does not support topology          CSINodeList   CSINodeList   CSINodeList is a collection of CSINode objects    hr       apiVersion    storage k8s io v1       kind    CSINodeList       metadata     a href    ListMeta  a      Standard list metadata More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      items       a href    CSINode  a    required    items is the list of CSINode         Operations   Operations      hr             get  read the specified CSINode       HTTP Request  GET  apis storage k8s io v1 csinodes  name        Parameters       name     in path    string  required    name of the CSINode       pretty     in query    string     a href    pretty  a          Response   200   a href    CSINode  a    OK  401  Unauthorized        list  list or watch objects of kind CSINode       HTTP Request  GET  apis storage k8s io v1 csinodes       Parameters       allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    CSINodeList  a    OK  401  Unauthorized        create  create a CSINode       HTTP Request  POST  apis storage k8s io v1 csinodes       Parameters       body     a href    CSINode  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    CSINode  a    OK  201   a href    CSINode  a    Created  202   a href    CSINode  a    Accepted  401  Unauthorized        update  replace the specified CSINode       HTTP Request  PUT  apis storage k8s io v1 csinodes  name        Parameters       name     in path    string  required    name of the CSINode       body     a href    CSINode  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    CSINode  a    OK  201   a href    CSINode  a    Created  401  Unauthorized        patch  partially update the specified CSINode       HTTP Request  PATCH  apis storage k8s io v1 csinodes  name        Parameters       name     in path    string  required    name of the CSINode       body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    CSINode  a    OK  201   a href    CSINode  a    Created  401  Unauthorized        delete  delete a CSINode       HTTP Request  DELETE  apis storage k8s io v1 csinodes  name        Parameters       name     in path    string  required    name of the CSINode       body     a href    DeleteOptions  a            dryRun     in query    string     a href    dryRun  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a          Response   200   a href    CSINode  a    OK  202   a href    CSINode  a    Accepted  401  Unauthorized        deletecollection  delete collection of CSINode       HTTP Request  DELETE  apis storage k8s io v1 csinodes       Parameters       body     a href    DeleteOptions  a            continue     in query    string     a href    continue  a        dryRun     in query    string     a href    dryRun  a        fieldSelector     in query    string     a href    fieldSelector  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a          Response   200   a href    Status  a    OK  401  Unauthorized


kubernetes reference title StorageClass autogenerated true contenttype apireference kind StorageClass weight 8 apimetadata apiVersion storage k8s io v1 StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned import k8s io api storage v1

Answer:
---
api_metadata:
  apiVersion: "storage.k8s.io/v1"
  import: "k8s.io/api/storage/v1"
  kind: "StorageClass"
content_type: "api_reference"
description: "StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned."
title: "StorageClass"
weight: 8
auto_generated: true
---

`apiVersion: storage.k8s.io/v1`

`import "k8s.io/api/storage/v1"`

## StorageClass {#StorageClass}

StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned.

StorageClasses are non-namespaced; the name of the storage class according to etcd is in ObjectMeta.Name.

- **apiVersion**: storage.k8s.io/v1

- **kind**: StorageClass

- **metadata** (ObjectMeta)

  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **provisioner** (string), required

  provisioner indicates the type of the provisioner.

- **allowVolumeExpansion** (boolean)

  allowVolumeExpansion shows whether the storage class allow volume expand.

- **allowedTopologies** ([]TopologySelectorTerm)

  *Atomic: will be replaced during a merge*

  allowedTopologies restrict the node topologies where volumes can be dynamically provisioned. Each volume plugin defines its own supported topology specifications. An empty TopologySelectorTerm list means there is no topology restriction. This field is only honored by servers that enable the VolumeScheduling feature.

  *A topology selector term represents the result of label queries. A null or empty topology selector term matches no objects. The requirements of them are ANDed. It provides a subset of functionality as NodeSelectorTerm. This is an alpha feature and may change in the future.*

  - **allowedTopologies.matchLabelExpressions** ([]TopologySelectorLabelRequirement)

    *Atomic: will be replaced during a merge*

    A list of topology selector requirements by labels.

    *A topology selector requirement is a selector that matches given label. This is an alpha feature and may change in the future.*

    - **allowedTopologies.matchLabelExpressions.key** (string), required

      The label key that the selector applies to.

    - **allowedTopologies.matchLabelExpressions.values** ([]string), required

      *Atomic: will be replaced during a merge*

      An array of string values. One value must match the label to be selected. Each entry in Values is ORed.

- **mountOptions** ([]string)

  *Atomic: will be replaced during a merge*

  mountOptions controls the mountOptions for dynamically provisioned PersistentVolumes of this storage class. e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.

- **parameters** (map[string]string)

  parameters holds the parameters for the provisioner that should create volumes of this storage class.

- **reclaimPolicy** (string)

  reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete.

- **volumeBindingMode** (string)

  volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.

## StorageClassList {#StorageClassList}

StorageClassList is a collection of storage classes.

- **apiVersion**: storage.k8s.io/v1

- **kind**: StorageClassList

- **metadata** (ListMeta)

  Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **items** ([]StorageClass), required

  items is the list of StorageClasses

## Operations {#Operations}

### `get` read the specified StorageClass

#### HTTP Request

GET /apis/storage.k8s.io/v1/storageclasses/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the StorageClass

- **pretty** (*in query*): string

  pretty

#### Response

200 (StorageClass): OK

401: Unauthorized

### `list` list or watch objects of kind StorageClass

#### HTTP Request

GET /apis/storage.k8s.io/v1/storageclasses

#### Parameters

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (StorageClassList): OK

401: Unauthorized

### `create` create a StorageClass

#### HTTP Request

POST /apis/storage.k8s.io/v1/storageclasses

#### Parameters

- **body**: StorageClass, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (StorageClass): OK

201 (StorageClass): Created

202 (StorageClass): Accepted

401: Unauthorized

### `update` replace the specified StorageClass

#### HTTP Request

PUT /apis/storage.k8s.io/v1/storageclasses/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the StorageClass

- **body**: StorageClass, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (StorageClass): OK

201 (StorageClass): Created

401: Unauthorized

### `patch` partially update the specified StorageClass

#### HTTP Request

PATCH /apis/storage.k8s.io/v1/storageclasses/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the StorageClass

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (StorageClass): OK

201 (StorageClass): Created

401: Unauthorized

### `delete` delete a StorageClass

#### HTTP Request

DELETE /apis/storage.k8s.io/v1/storageclasses/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the StorageClass

- **body**: DeleteOptions

- **dryRun** (*in query*): string

  dryRun

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

#### Response

200 (StorageClass): OK

202 (StorageClass): Accepted

401: Unauthorized

### `deletecollection` delete collection of StorageClass

#### HTTP Request

DELETE /apis/storage.k8s.io/v1/storageclasses

#### Parameters

- **body**: DeleteOptions

- **continue** (*in query*): string

  continue

- **dryRun** (*in query*): string

  dryRun

- **fieldSelector** (*in query*): string

  fieldSelector

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

#### Response

200 (Status): OK

401: Unauthorized

api metadata    apiVersion   storage k8s io v1    import   k8s io api storage v1    kind   StorageClass  content type   api reference  description   StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned   title   StorageClass  weight  8 auto generated  true           The file is auto generated from the Go source code of the component using a generic  generator  https   github com kubernetes sigs reference docs    To learn how to generate the reference documentation  please read  Contributing to the reference documentation   docs contribute generate ref docs    To update the reference content  please follow the   Contributing upstream   docs contribute generate ref docs contribute upstream   guide  You can file document formatting bugs against the  reference docs  https   github com kubernetes sigs reference docs   project        apiVersion  storage k8s io v1    import  k8s io api storage v1        StorageClass   StorageClass   StorageClass describes the parameters for a class of storage for which PersistentVolumes can be dynamically provisioned   StorageClasses are non namespaced  the name of the storage class according to etcd is in ObjectMeta Name    hr       apiVersion    storage k8s io v1       kind    StorageClass       metadata     a href    ObjectMeta  a      Standard object s metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      provisioner    string   required    provisioner indicates the type of the provisioner       allowVolumeExpansion    boolean     allowVolumeExpansion shows whether the storage class allow volume expand       allowedTopologies      TopologySelectorTerm      Atomic  will be replaced during a merge       allowedTopologies restrict the node topologies where volumes can be dynamically provisioned  Each volume plugin defines its own supported topology specifications  An empty TopologySelectorTerm list means there is no topology restriction  This field is only honored by servers that enable the VolumeScheduling feature      a name  TopologySelectorTerm    a     A topology selector term represents the result of label queries  A null or empty topology selector term matches no objects  The requirements of them are ANDed  It provides a subset of functionality as NodeSelectorTerm  This is an alpha feature and may change in the future          allowedTopologies matchLabelExpressions      TopologySelectorLabelRequirement        Atomic  will be replaced during a merge           A list of topology selector requirements by labels        a name  TopologySelectorLabelRequirement    a       A topology selector requirement is a selector that matches given label  This is an alpha feature and may change in the future            allowedTopologies matchLabelExpressions key    string   required        The label key that the selector applies to           allowedTopologies matchLabelExpressions values      string   required         Atomic  will be replaced during a merge               An array of string values  One value must match the label to be selected  Each entry in Values is ORed       mountOptions      string      Atomic  will be replaced during a merge       mountOptions controls the mountOptions for dynamically provisioned PersistentVolumes of this storage class  e g    ro    soft    Not validated   mount of the PVs will simply fail if one is invalid       parameters    map string string     parameters holds the parameters for the provisioner that should create volumes of this storage class       reclaimPolicy    string     reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class  Defaults to Delete       volumeBindingMode    string     volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound   When unset  VolumeBindingImmediate is used  This field is only honored by servers that enable the VolumeScheduling feature          StorageClassList   StorageClassList   StorageClassList is a collection of storage classes    hr       apiVersion    storage k8s io v1       kind    StorageClassList       metadata     a href    ListMeta  a      Standard list metadata More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      items       a href    StorageClass  a    required    items is the list of StorageClasses         Operations   Operations      hr             get  read the specified StorageClass       HTTP Request  GET  apis storage k8s io v1 storageclasses  name        Parameters       name     in path    string  required    name of the StorageClass       pretty     in query    string     a href    pretty  a          Response   200   a href    StorageClass  a    OK  401  Unauthorized        list  list or watch objects of kind StorageClass       HTTP Request  GET  apis storage k8s io v1 storageclasses       Parameters       allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    StorageClassList  a    OK  401  Unauthorized        create  create a StorageClass       HTTP Request  POST  apis storage k8s io v1 storageclasses       Parameters       body     a href    StorageClass  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    StorageClass  a    OK  201   a href    StorageClass  a    Created  202   a href    StorageClass  a    Accepted  401  Unauthorized        update  replace the specified StorageClass       HTTP Request  PUT  apis storage k8s io v1 storageclasses  name        Parameters       name     in path    string  required    name of the StorageClass       body     a href    StorageClass  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    StorageClass  a    OK  201   a href    StorageClass  a    Created  401  Unauthorized        patch  partially update the specified StorageClass       HTTP Request  PATCH  apis storage k8s io v1 storageclasses  name        Parameters       name     in path    string  required    name of the StorageClass       body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    StorageClass  a    OK  201   a href    StorageClass  a    Created  401  Unauthorized        delete  delete a StorageClass       HTTP Request  DELETE  apis storage k8s io v1 storageclasses  name        Parameters       name     in path    string  required    name of the StorageClass       body     a href    DeleteOptions  a            dryRun     in query    string     a href    dryRun  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a          Response   200   a href    StorageClass  a    OK  202   a href    StorageClass  a    Accepted  401  Unauthorized        deletecollection  delete collection of StorageClass       HTTP Request  DELETE  apis storage k8s io v1 storageclasses       Parameters       body     a href    DeleteOptions  a            continue     in query    string     a href    continue  a        dryRun     in query    string     a href    dryRun  a        fieldSelector     in query    string     a href    fieldSelector  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a          Response   200   a href    Status  a    OK  401  Unauthorized