Patch a Namespaced Virtual Machine
PATCH/apis/kubevirt.io/v1/namespaces/:namespace/virtualmachines/:name
Patch a VirtualMachine object.
Request
Path Parameters
name stringrequired
Possible values: Value must match regular expression [a-z0-9][a-z0-9\-]*
Name of the resource
namespace stringrequired
Possible values: Value must match regular expression [a-z0-9][a-z0-9\-]*
Object name and auth scope, such as for teams and projects
- application/json-patch+json
- application/merge-patch+json
Bodyrequired
objectobject
Bodyrequired
objectobject
Responses
- 200
- 401
OK
- application/json
- Schema
- Example (auto)
Schema
apiVersionstringrequired
kindstringrequired
metadata object
spec objectrequired
status object
{
"apiVersion": "string",
"kind": "string",
"metadata": {
"name": "string",
"namespace": "string"
},
"spec": {
"dataVolumeTemplates": [
{
"apiVersion": "string",
"kind": "string",
"metadata": {
"name": "string",
"namespace": "string"
},
"spec": {
"checkpoints": [
{
"current": "",
"previous": ""
}
],
"contentType": "string",
"finalCheckpoint": true,
"preallocation": true,
"priorityClassName": "string",
"pvc": {
"accessModes": [
""
],
"dataSource": {
"apiGroup": "string",
"kind": "",
"name": ""
},
"dataSourceRef": {
"apiGroup": "string",
"kind": "",
"name": "",
"namespace": "string"
},
"resources": {
"claims": [
{
"name": ""
}
],
"limits": {},
"requests": {}
},
"selector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"storageClassName": "string",
"volumeMode": "string",
"volumeName": "string"
},
"source": {
"blank": {},
"gcs": {
"secretRef": "string",
"url": ""
},
"http": {
"certConfigMap": "string",
"extraHeaders": [
""
],
"secretExtraHeaders": [
""
],
"secretRef": "string",
"url": ""
},
"imageio": {
"certConfigMap": "string",
"diskId": "",
"secretRef": "string",
"url": ""
},
"pvc": {
"name": "",
"namespace": ""
},
"registry": {
"certConfigMap": "string",
"imageStream": "string",
"pullMethod": "string",
"secretRef": "string",
"url": "string"
},
"s3": {
"certConfigMap": "string",
"secretRef": "string",
"url": ""
},
"snapshot": {
"name": "",
"namespace": ""
},
"upload": {},
"vddk": {
"backingFile": "string",
"initImageURL": "string",
"secretRef": "string",
"thumbprint": "string",
"url": "string",
"uuid": "string"
}
},
"sourceRef": {
"kind": "",
"name": "",
"namespace": "string"
},
"storage": {
"accessModes": [
""
],
"dataSource": {
"apiGroup": "string",
"kind": "",
"name": ""
},
"dataSourceRef": {
"apiGroup": "string",
"kind": "",
"name": "",
"namespace": "string"
},
"resources": {
"claims": [
{
"name": ""
}
],
"limits": {},
"requests": {}
},
"selector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"storageClassName": "string",
"volumeMode": "string",
"volumeName": "string"
}
},
"status": {}
}
],
"instancetype": {
"inferFromVolume": "string",
"inferFromVolumeFailurePolicy": "string",
"kind": "string",
"name": "string",
"revisionName": "string"
},
"liveUpdateFeatures": {
"affinity": {},
"cpu": {
"maxSockets": 0
},
"memory": {
"maxGuest": "string"
}
},
"preference": {
"inferFromVolume": "string",
"inferFromVolumeFailurePolicy": "string",
"kind": "string",
"name": "string",
"revisionName": "string"
},
"runStrategy": "string",
"running": true,
"template": {
"metadata": {
"name": "string",
"namespace": "string"
},
"spec": {
"accessCredentials": [
{
"sshPublicKey": {
"propagationMethod": {
"configDrive": {},
"noCloud": {},
"qemuGuestAgent": {
"users": [
""
]
}
},
"source": {
"secret": {
"secretName": ""
}
}
},
"userPassword": {
"propagationMethod": {
"qemuGuestAgent": {}
},
"source": {
"secret": {
"secretName": ""
}
}
}
}
],
"affinity": {
"nodeAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"preference": {
"matchExpressions": [
{
"key": "",
"operator": "DoesNotExist",
"values": [
""
]
}
],
"matchFields": [
{
"key": "",
"operator": "DoesNotExist",
"values": [
""
]
}
]
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": {
"nodeSelectorTerms": [
{
"matchExpressions": [
{
"key": "",
"operator": "DoesNotExist",
"values": [
""
]
}
],
"matchFields": [
{
"key": "",
"operator": "DoesNotExist",
"values": [
""
]
}
]
}
]
}
},
"podAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaces": [
""
],
"topologyKey": ""
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaces": [
""
],
"topologyKey": ""
}
]
},
"podAntiAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaces": [
""
],
"topologyKey": ""
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"namespaces": [
""
],
"topologyKey": ""
}
]
}
},
"architecture": "string",
"dnsConfig": {
"nameservers": [
""
],
"options": [
{
"name": "string",
"value": "string"
}
],
"searches": [
""
]
},
"dnsPolicy": "ClusterFirst",
"domain": {
"chassis": {
"asset": "string",
"manufacturer": "string",
"serial": "string",
"sku": "string",
"version": "string"
},
"clock": {
"timer": {
"hpet": {
"present": true,
"tickPolicy": "string"
},
"hyperv": {
"present": true
},
"kvm": {
"present": true
},
"pit": {
"present": true,
"tickPolicy": "string"
},
"rtc": {
"present": true,
"tickPolicy": "string",
"track": "string"
}
},
"timezone": "string",
"utc": {
"offsetSeconds": 0
}
},
"cpu": {
"cores": 0,
"dedicatedCpuPlacement": true,
"features": [
{
"name": "",
"policy": "string"
}
],
"isolateEmulatorThread": true,
"maxSockets": 0,
"model": "string",
"numa": {
"guestMappingPassthrough": {}
},
"realtime": {
"mask": "string"
},
"sockets": 0,
"threads": 0
},
"devices": {
"autoattachGraphicsDevice": true,
"autoattachInputDevice": true,
"autoattachMemBalloon": true,
"autoattachPodInterface": true,
"autoattachSerialConsole": true,
"autoattachVSOCK": true,
"blockMultiQueue": true,
"clientPassthrough": {},
"disableHotplug": true,
"disks": [
{
"blockSize": {
"custom": {
"logical": 0,
"physical": 0
},
"matchVolume": {
"enabled": true
}
},
"bootOrder": 0,
"cache": "string",
"cdrom": {
"bus": "string",
"readonly": true,
"tray": "string"
},
"dedicatedIOThread": true,
"disk": {
"bus": "string",
"pciAddress": "string",
"readonly": true
},
"errorPolicy": "string",
"io": "string",
"lun": {
"bus": "string",
"readonly": true,
"reservation": true
},
"name": "",
"serial": "string",
"shareable": true,
"tag": "string"
}
],
"downwardMetrics": {},
"filesystems": [
{
"name": "",
"virtiofs": {}
}
],
"gpus": [
{
"deviceName": "",
"name": "",
"tag": "string",
"virtualGPUOptions": {
"display": {
"enabled": true,
"ramFB": {
"enabled": true
}
}
}
}
],
"hostDevices": [
{
"deviceName": "",
"name": "",
"tag": "string"
}
],
"inputs": [
{
"bus": "string",
"name": "",
"type": ""
}
],
"interfaces": [
{
"acpiIndex": 0,
"binding": {
"name": ""
},
"bootOrder": 0,
"bridge": {},
"dhcpOptions": {
"bootFileName": "string",
"ntpServers": [
""
],
"privateOptions": [
{
"option": 0,
"value": ""
}
],
"tftpServerName": "string"
},
"macAddress": "string",
"macvtap": {},
"masquerade": {},
"model": "string",
"name": "",
"passt": {},
"pciAddress": "string",
"ports": [
{
"name": "string",
"port": 0,
"protocol": "string"
}
],
"slirp": {},
"sriov": {},
"state": "string",
"tag": "string"
}
],
"logSerialConsole": true,
"networkInterfaceMultiqueue": true,
"rng": {},
"sound": {
"model": "string",
"name": ""
},
"tpm": {
"persistent": true
},
"useVirtioTransitional": true,
"watchdog": {
"i6300esb": {
"action": "string"
},
"name": ""
}
},
"features": {
"acpi": {
"enabled": true
},
"apic": {
"enabled": true,
"endOfInterrupt": true
},
"hyperv": {
"evmcs": {
"enabled": true
},
"frequencies": {
"enabled": true
},
"ipi": {
"enabled": true
},
"reenlightenment": {
"enabled": true
},
"relaxed": {
"enabled": true
},
"reset": {
"enabled": true
},
"runtime": {
"enabled": true
},
"spinlocks": {
"enabled": true,
"spinlocks": 0
},
"synic": {
"enabled": true
},
"synictimer": {
"direct": {
"enabled": true
},
"enabled": true
},
"tlbflush": {
"enabled": true
},
"vapic": {
"enabled": true
},
"vendorid": {
"enabled": true,
"vendorid": "string"
},
"vpindex": {
"enabled": true
}
},
"kvm": {
"hidden": true
},
"pvspinlock": {
"enabled": true
},
"smm": {
"enabled": true
}
},
"firmware": {
"bootloader": {
"bios": {
"useSerial": true
},
"efi": {
"persistent": true,
"secureBoot": true
}
},
"kernelBoot": {
"container": {
"image": "",
"imagePullPolicy": "Always",
"imagePullSecret": "string",
"initrdPath": "string",
"kernelPath": "string"
},
"kernelArgs": "string"
},
"serial": "string",
"uuid": "string"
},
"ioThreadsPolicy": "string",
"launchSecurity": {
"sev": {
"attestation": {},
"dhCert": "string",
"policy": {
"encryptedState": true
},
"session": "string"
}
},
"machine": {
"type": ""
},
"memory": {
"guest": "string",
"hugepages": {
"pageSize": "string"
},
"maxGuest": "string"
},
"resources": {
"limits": {},
"overcommitGuestOverhead": true,
"requests": {}
}
},
"evictionStrategy": "string",
"hostname": "string",
"livenessProbe": {
"exec": {
"command": [
""
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "",
"value": ""
}
],
"path": "string",
"port": {},
"scheme": "HTTP"
},
"initialDelaySeconds": 0,
"periodSeconds": 0,
"successThreshold": 0,
"tcpSocket": {
"host": "string",
"port": {}
},
"timeoutSeconds": 0
},
"networks": [
{
"multus": {
"default": true,
"networkName": ""
},
"name": "",
"pod": {
"vmIPv6NetworkCIDR": "string",
"vmNetworkCIDR": "string"
}
}
],
"nodeSelector": {},
"priorityClassName": "string",
"readinessProbe": {
"exec": {
"command": [
""
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "",
"value": ""
}
],
"path": "string",
"port": {},
"scheme": "HTTP"
},
"initialDelaySeconds": 0,
"periodSeconds": 0,
"successThreshold": 0,
"tcpSocket": {
"host": "string",
"port": {}
},
"timeoutSeconds": 0
},
"schedulerName": "string",
"startStrategy": "string",
"subdomain": "string",
"terminationGracePeriodSeconds": 0,
"tolerations": [
{
"effect": "NoExecute",
"key": "string",
"operator": "Equal",
"tolerationSeconds": 0,
"value": "string"
}
],
"topologySpreadConstraints": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "",
"operator": "",
"values": [
""
]
}
],
"matchLabels": {}
},
"matchLabelKeys": [
""
],
"maxSkew": 0,
"minDomains": 0,
"nodeAffinityPolicy": "string",
"nodeTaintsPolicy": "string",
"topologyKey": "",
"whenUnsatisfiable": "DoNotSchedule"
}
],
"volumes": [
{
"cloudInitConfigDrive": {
"networkData": "string",
"networkDataBase64": "string",
"networkDataSecretRef": {
"name": "string"
},
"secretRef": {
"name": "string"
},
"userData": "string",
"userDataBase64": "string"
},
"cloudInitNoCloud": {
"networkData": "string",
"networkDataBase64": "string",
"networkDataSecretRef": {
"name": "string"
},
"secretRef": {
"name": "string"
},
"userData": "string",
"userDataBase64": "string"
},
"configMap": {
"name": "string",
"optional": true,
"volumeLabel": "string"
},
"containerDisk": {
"image": "",
"imagePullPolicy": "Always",
"imagePullSecret": "string",
"path": "string"
},
"dataVolume": {
"hotpluggable": true,
"name": ""
},
"downwardAPI": {
"fields": [
{
"fieldRef": {
"apiVersion": "string",
"fieldPath": ""
},
"mode": 0,
"path": "",
"resourceFieldRef": {
"containerName": "string",
"divisor": {},
"resource": ""
}
}
],
"volumeLabel": "string"
},
"downwardMetrics": {},
"emptyDisk": {
"capacity": {}
},
"ephemeral": {
"persistentVolumeClaim": {
"claimName": "",
"readOnly": true
}
},
"hostDisk": {
"capacity": {},
"path": "",
"shared": true,
"type": ""
},
"memoryDump": {
"claimName": "",
"hotpluggable": true,
"readOnly": true
},
"name": "",
"persistentVolumeClaim": {
"claimName": "",
"hotpluggable": true,
"readOnly": true
},
"secret": {
"optional": true,
"secretName": "string",
"volumeLabel": "string"
},
"serviceAccount": {
"serviceAccountName": "string"
},
"sysprep": {
"configMap": {
"name": "string"
},
"secret": {
"name": "string"
}
}
}
]
}
}
},
"status": {
"conditions": [
{
"lastProbeTime": {},
"lastTransitionTime": {},
"message": "string",
"reason": "string",
"status": "",
"type": ""
}
],
"created": true,
"desiredGeneration": 0,
"memoryDumpRequest": {
"claimName": "",
"endTimestamp": "",
"fileName": "string",
"message": "string",
"phase": "",
"remove": true,
"startTimestamp": ""
},
"observedGeneration": 0,
"printableStatus": "string",
"ready": true,
"restoreInProgress": "string",
"snapshotInProgress": "string",
"startFailure": {
"consecutiveFailCount": 0,
"lastFailedVMIUID": "string",
"retryAfterTimestamp": ""
},
"stateChangeRequests": [
{
"action": "",
"data": {},
"uid": "string"
}
],
"volumeRequests": [
{
"addVolumeOptions": {
"disk": {
"blockSize": {
"custom": {
"logical": 0,
"physical": 0
},
"matchVolume": {
"enabled": true
}
},
"bootOrder": 0,
"cache": "string",
"cdrom": {
"bus": "string",
"readonly": true,
"tray": "string"
},
"dedicatedIOThread": true,
"disk": {
"bus": "string",
"pciAddress": "string",
"readonly": true
},
"errorPolicy": "string",
"io": "string",
"lun": {
"bus": "string",
"readonly": true,
"reservation": true
},
"name": "",
"serial": "string",
"shareable": true,
"tag": "string"
},
"dryRun": [
""
],
"name": "",
"volumeSource": {
"dataVolume": {
"hotpluggable": true,
"name": ""
},
"persistentVolumeClaim": {
"claimName": "",
"hotpluggable": true,
"readOnly": true
}
}
},
"removeVolumeOptions": {
"dryRun": [
""
],
"name": ""
}
}
],
"volumeSnapshotStatuses": [
{
"enabled": false,
"name": "",
"reason": "string"
}
]
}
}
Unauthorized
- application/json
- Schema
- Example (auto)
Schema
stringstring
"string"
- curl
- python
- go
- nodejs
- CURL
curl -L -X PATCH 'https://699c5de8cd2250875530e216--harvester-preview.netlify.app/apis/kubevirt.io/v1/namespaces/:namespace/virtualmachines/:name' \
-H 'Content-Type: application/json-patch+json' \
-H 'Accept: application/json' \
-d '{}'
