---
title: "Changes to Replace a Namespaced Persistent Volume Claim"
method: PUT
path: "/api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}"
---

# Changes to Replace a Namespaced Persistent Volume Claim

`PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 64 revisions.

- **2025-03-06** `272d90638842`: 4 warning, 2 info
- **2025-02-10** `5958f71d4dc7`: 24 breaking, 20 warning, 74 info
- **2024-07-30** `211079655b9a`: 2 breaking, 8 warning, 32 info

## Changes

- **2025-03-06** `272d90638842`: 4 warning, 2 info
  - added the new `FromStorageProfile` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/json)
  - added the new `FromStorageProfile` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/yaml)
  - added the new `FromStorageProfile` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `201` (media type: application/json)
  - added the new `FromStorageProfile` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `201` (media type: application/yaml)
  - added the new `FromStorageProfile` enum value to the request property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` (media type: application/json)
  - added the new `FromStorageProfile` enum value to the request property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` (media type: application/yaml)
- **2025-02-10** `5958f71d4dc7`: 24 breaking, 20 warning, 74 info
  - request property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` was restricted to a list of enum values (media type: application/json)
  - request property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` was restricted to a list of enum values (media type: application/yaml)
  - the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastProbeTime` request property type changed from no type to `string` (media type: application/json)
  - the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastTransitionTime` request property type changed from no type to `string` (media type: application/json)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/limits/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/json)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/limits/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/limits/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/json)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/limits/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/requests/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/json)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/requests/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/requests/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/json)
  - added `subschema #1, subschema #2` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/requests/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResources/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/json)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResources/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResources/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/json)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResources/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/capacity/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/json)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/capacity/additionalProperties/` response property `oneOf` list for the response status `200` (media type: application/yaml)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/capacity/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/json)
  - added `subschema #1, subschema #2` to the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/capacity/additionalProperties/` response property `oneOf` list for the response status `201` (media type: application/yaml)
  - the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastProbeTime` response's property type changed from no type to `string` for status `200` (media type: application/json)
  - the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastProbeTime` response's property type changed from no type to `string` for status `201` (media type: application/json)
  - the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastTransitionTime` response's property type changed from no type to `string` for status `200` (media type: application/json)
  - the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastTransitionTime` response's property type changed from no type to `string` for status `201` (media type: application/json)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/limits/additionalProperties/` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/limits/additionalProperties/` request property `allOf` list (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/requests/additionalProperties/` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources/allOf[#/components/schemas/k8s.io.v1.VolumeResourceRequirements]/requests/additionalProperties/` request property `allOf` list (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResources/additionalProperties/` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResources/additionalProperties/` request property `allOf` list (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/capacity/additionalProperties/` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.apimachinery.pkg.api.resource.Quantity` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/capacity/additionalProperties/` request property `allOf` list (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.v1.Time` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastProbeTime` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.v1.Time` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastProbeTime` request property `allOf` list (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.v1.Time` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastTransitionTime` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.v1.Time` from the `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/conditions/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimCondition]/lastTransitionTime` request property `allOf` list (media type: application/yaml)
  - added the new `Block` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/json)
  - added the new `Block` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/yaml)
  - added the new `Block` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `201` (media type: application/json)
  - added the new `Block` enum value to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `201` (media type: application/yaml)
  - …78 more
- **2024-07-30** `211079655b9a`: 2 breaking, 8 warning, 32 info
  - added `#/components/schemas/k8s.io.v1.VolumeResourceRequirements` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` request property `allOf` list (media type: application/json)
  - added `#/components/schemas/k8s.io.v1.VolumeResourceRequirements` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` request property `allOf` list (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.v1.ResourceRequirements` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/k8s.io.v1.ResourceRequirements` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` request property `allOf` list (media type: application/yaml)
  - removed the request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/resizeStatus` (media type: application/json)
  - removed the request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/resizeStatus` (media type: application/yaml)
  - removed the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/resizeStatus` from the response with the `200` status (media type: application/json)
  - removed the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/resizeStatus` from the response with the `200` status (media type: application/yaml)
  - removed the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/resizeStatus` from the response with the `201` status (media type: application/json)
  - removed the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/resizeStatus` from the response with the `201` status (media type: application/yaml)
  - added the new optional request property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeAttributesClassName` (media type: application/json)
  - added the new optional request property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeAttributesClassName` (media type: application/yaml)
  - added the new optional request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResourceStatuses` (media type: application/json)
  - added the new optional request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResourceStatuses` (media type: application/yaml)
  - added the new optional request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/currentVolumeAttributesClassName` (media type: application/json)
  - added the new optional request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/currentVolumeAttributesClassName` (media type: application/yaml)
  - added the new optional request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/modifyVolumeStatus` (media type: application/json)
  - added the new optional request property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/modifyVolumeStatus` (media type: application/yaml)
  - added the optional property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeAttributesClassName` to the response with the `200` status (media type: application/json)
  - added the optional property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeAttributesClassName` to the response with the `200` status (media type: application/yaml)
  - added the optional property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeAttributesClassName` to the response with the `201` status (media type: application/json)
  - added the optional property `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeAttributesClassName` to the response with the `201` status (media type: application/yaml)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResourceStatuses` to the response with the `200` status (media type: application/json)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResourceStatuses` to the response with the `200` status (media type: application/yaml)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResourceStatuses` to the response with the `201` status (media type: application/json)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/allocatedResourceStatuses` to the response with the `201` status (media type: application/yaml)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/currentVolumeAttributesClassName` to the response with the `200` status (media type: application/json)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/currentVolumeAttributesClassName` to the response with the `200` status (media type: application/yaml)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/currentVolumeAttributesClassName` to the response with the `201` status (media type: application/json)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/currentVolumeAttributesClassName` to the response with the `201` status (media type: application/yaml)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/modifyVolumeStatus` to the response with the `200` status (media type: application/json)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/modifyVolumeStatus` to the response with the `200` status (media type: application/yaml)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/modifyVolumeStatus` to the response with the `201` status (media type: application/json)
  - added the optional property `status/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimStatus]/modifyVolumeStatus` to the response with the `201` status (media type: application/yaml)
  - added `#/components/schemas/k8s.io.v1.VolumeResourceRequirements` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` response property `allOf` list for the response status `200` (media type: application/json)
  - added `#/components/schemas/k8s.io.v1.VolumeResourceRequirements` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` response property `allOf` list for the response status `200` (media type: application/yaml)
  - added `#/components/schemas/k8s.io.v1.VolumeResourceRequirements` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` response property `allOf` list for the response status `201` (media type: application/json)
  - added `#/components/schemas/k8s.io.v1.VolumeResourceRequirements` to the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` response property `allOf` list for the response status `201` (media type: application/yaml)
  - removed `#/components/schemas/k8s.io.v1.ResourceRequirements` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` response property `allOf` list for the response status `200` (media type: application/json)
  - removed `#/components/schemas/k8s.io.v1.ResourceRequirements` from the `spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/resources` response property `allOf` list for the response status `200` (media type: application/yaml)
  - …2 more

---

[Operation](https://skmtc.dev/harvester/apis/harvester-apis/docs/api/v1/namespaces/:namespace/persistentvolumeclaims/:name/put.md) - [API](https://skmtc.dev/harvester/apis/harvester-apis.md) - [Page](https://skmtc.dev/harvester/apis/harvester-apis/changes/api/v1/namespaces/:namespace/persistentvolumeclaims/:name/put)
