List Virtual Machine Instances For All Namespaces
GET/apis/kubevirt.io/v1/virtualmachineinstances
Get a list of all VirtualMachineInstance objects.
Request
Query Parameters
The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server the server will respond with a 410 ResourceExpired error indicating the client must restart their list without the continue field. This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications.
A selector to restrict the list of returned objects by their fields. Defaults to everything.
If true, partially initialized resources are included in the response.
A selector to restrict the list of returned objects by their labels. Defaults to everything
limit is a maximum number of responses to return for a list call. If more items exist, the server will set the continue
field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true.
The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned.
When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history.
TimeoutSeconds for the list/watch call.
Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.
Responses
- 200
- 401
OK
- application/json
- application/json;stream=watch
- application/yaml
- Schema
- Example (from schema)
Schema
metadata object
{
"apiVersion": "string",
"items": [
{
"apiVersion": "string",
"kind": "string",
"metadata": {
"name": "string",
"namespace": "string"
},
"spec": {
"accessCredentials": [
{
"sshPublicKey": {
"propagationMethod": {
"configDrive": {},
"noCloud": {},
"qemuGuestAgent": {
"users": [
"string"
]
}
},
"source": {
"secret": {
"secretName": "string"
}
}
},
"userPassword": {
"propagationMethod": {
"qemuGuestAgent": {}
},
"source": {
"secret": {
"secretName": "string"
}
}
}
}
],
"affinity": {
"nodeAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"preference": {
"matchExpressions": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
],
"matchFields": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
]
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": {
"nodeSelectorTerms": [
{
"matchExpressions": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
],
"matchFields": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
]
}
]
}
},
"podAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
}
]
},
"podAntiAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
}
]
}
},
"architecture": "string",
"dnsConfig": {
"nameservers": [
"string"
],
"options": [
{
"name": "string",
"value": "string"
}
],
"searches": [
"string"
]
},
"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": "string",
"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": "string",
"serial": "string",
"shareable": true,
"tag": "string"
}
],
"downwardMetrics": {},
"filesystems": [
{
"name": "string",
"virtiofs": {}
}
],
"gpus": [
{
"deviceName": "string",
"name": "string",
"tag": "string",
"virtualGPUOptions": {
"display": {
"enabled": true,
"ramFB": {
"enabled": true
}
}
}
}
],
"hostDevices": [
{
"deviceName": "string",
"name": "string",
"tag": "string"
}
],
"inputs": [
{
"bus": "string",
"name": "string",
"type": "string"
}
],
"interfaces": [
{
"acpiIndex": 0,
"binding": {
"name": "string"
},
"bootOrder": 0,
"bridge": {},
"dhcpOptions": {
"bootFileName": "string",
"ntpServers": [
"string"
],
"privateOptions": [
{
"option": 0,
"value": "string"
}
],
"tftpServerName": "string"
},
"macAddress": "string",
"macvtap": {},
"masquerade": {},
"model": "string",
"name": "string",
"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": "string"
},
"tpm": {
"persistent": true
},
"useVirtioTransitional": true,
"watchdog": {
"i6300esb": {
"action": "string"
},
"name": "string"
}
},
"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": "string",
"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": "string"
},
"memory": {
"guest": "string",
"hugepages": {
"pageSize": "string"
},
"maxGuest": "string"
},
"resources": {
"limits": {},
"overcommitGuestOverhead": true,
"requests": {}
}
},
"evictionStrategy": "string",
"hostname": "string",
"livenessProbe": {
"exec": {
"command": [
"string"
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"path": "string",
"port": {},
"scheme": "HTTP"
},
"initialDelaySeconds": 0,
"periodSeconds": 0,
"successThreshold": 0,
"tcpSocket": {
"host": "string",
"port": {}
},
"timeoutSeconds": 0
},
"networks": [
{
"multus": {
"default": true,
"networkName": "string"
},
"name": "string",
"pod": {
"vmIPv6NetworkCIDR": "string",
"vmNetworkCIDR": "string"
}
}
],
"nodeSelector": {},
"priorityClassName": "string",
"readinessProbe": {
"exec": {
"command": [
"string"
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"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": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"matchLabelKeys": [
"string"
],
"maxSkew": 0,
"minDomains": 0,
"nodeAffinityPolicy": "string",
"nodeTaintsPolicy": "string",
"topologyKey": "string",
"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": "string",
"imagePullPolicy": "Always",
"imagePullSecret": "string",
"path": "string"
},
"dataVolume": {
"hotpluggable": true,
"name": "string"
},
"downwardAPI": {
"fields": [
{
"fieldRef": {
"apiVersion": "string",
"fieldPath": "string"
},
"mode": 0,
"path": "string",
"resourceFieldRef": {
"containerName": "string",
"divisor": {},
"resource": "string"
}
}
],
"volumeLabel": "string"
},
"downwardMetrics": {},
"emptyDisk": {
"capacity": {}
},
"ephemeral": {
"persistentVolumeClaim": {
"claimName": "string",
"readOnly": true
}
},
"hostDisk": {
"capacity": {},
"path": "string",
"shared": true,
"type": "string"
},
"memoryDump": {
"claimName": "string",
"hotpluggable": true,
"readOnly": true
},
"name": "string",
"persistentVolumeClaim": {
"claimName": "string",
"hotpluggable": true,
"readOnly": true
},
"secret": {
"optional": true,
"secretName": "string",
"volumeLabel": "string"
},
"serviceAccount": {
"serviceAccountName": "string"
},
"sysprep": {
"configMap": {
"name": "string"
},
"secret": {
"name": "string"
}
}
}
]
},
"status": {
"VSOCKCID": 0,
"activePods": {},
"conditions": [
{
"lastProbeTime": {},
"lastTransitionTime": {},
"message": "string",
"reason": "string",
"status": "string",
"type": "string"
}
],
"currentCPUTopology": {
"cores": 0,
"sockets": 0,
"threads": 0
},
"evacuationNodeName": "string",
"fsFreezeStatus": "string",
"guestOSInfo": {
"id": "string",
"kernelRelease": "string",
"kernelVersion": "string",
"machine": "string",
"name": "string",
"prettyName": "string",
"version": "string",
"versionId": "string"
},
"interfaces": [
{
"infoSource": "string",
"interfaceName": "string",
"ipAddress": "string",
"ipAddresses": [
"string"
],
"mac": "string",
"name": "string",
"queueCount": 0
}
],
"kernelBootStatus": {
"initrdInfo": {
"checksum": 0
},
"kernelInfo": {
"checksum": 0
}
},
"launcherContainerImageVersion": "string",
"machine": {
"type": "string"
},
"memory": {
"guestAtBoot": "string",
"guestCurrent": "string",
"guestRequested": "string"
},
"migrationMethod": "string",
"migrationState": {
"abortRequested": true,
"abortStatus": "string",
"completed": true,
"endTimestamp": "string",
"failed": true,
"migrationConfiguration": {
"allowAutoConverge": true,
"allowPostCopy": true,
"bandwidthPerMigration": "string",
"completionTimeoutPerGiB": 0,
"disableTLS": true,
"matchSELinuxLevelOnMigration": true,
"network": "string",
"nodeDrainTaintKey": "string",
"parallelMigrationsPerCluster": 0,
"parallelOutboundMigrationsPerNode": 0,
"progressTimeout": 0,
"unsafeMigrationOverride": true
},
"migrationPolicyName": "string",
"migrationUid": "string",
"mode": "string",
"sourceNode": "string",
"startTimestamp": "string",
"targetAttachmentPodUID": "string",
"targetCPUSet": [
0
],
"targetDirectMigrationNodePorts": {},
"targetNode": "string",
"targetNodeAddress": "string",
"targetNodeDomainDetected": true,
"targetNodeDomainReadyTimestamp": "string",
"targetNodeTopology": "string",
"targetPod": "string"
},
"migrationTransport": "string",
"nodeName": "string",
"phase": "string",
"phaseTransitionTimestamps": [
{
"phase": "string",
"phaseTransitionTimestamp": {}
}
],
"qosClass": "string",
"reason": "string",
"runtimeUser": 0,
"selinuxContext": "string",
"topologyHints": {
"tscFrequency": 0
},
"virtualMachineRevisionName": "string",
"volumeStatus": [
{
"containerDiskVolume": {
"checksum": 0
},
"hotplugVolume": {
"attachPodName": "string",
"attachPodUID": "string"
},
"memoryDumpVolume": {
"claimName": "string",
"endTimestamp": "string",
"startTimestamp": "string",
"targetFileName": "string"
},
"message": "string",
"name": "string",
"persistentVolumeClaimInfo": {
"accessModes": [
"string"
],
"capacity": {},
"filesystemOverhead": "string",
"preallocated": true,
"requests": {},
"volumeMode": "string"
},
"phase": "string",
"reason": "string",
"size": 0,
"target": "string"
}
]
}
}
],
"kind": "string",
"metadata": {
"continue": "string",
"remainingItemCount": 0,
"resourceVersion": "string",
"selfLink": "string"
}
}
- Schema
- Example (from schema)
Schema
metadata object
{
"apiVersion": "string",
"items": [
{
"apiVersion": "string",
"kind": "string",
"metadata": {
"name": "string",
"namespace": "string"
},
"spec": {
"accessCredentials": [
{
"sshPublicKey": {
"propagationMethod": {
"configDrive": {},
"noCloud": {},
"qemuGuestAgent": {
"users": [
"string"
]
}
},
"source": {
"secret": {
"secretName": "string"
}
}
},
"userPassword": {
"propagationMethod": {
"qemuGuestAgent": {}
},
"source": {
"secret": {
"secretName": "string"
}
}
}
}
],
"affinity": {
"nodeAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"preference": {
"matchExpressions": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
],
"matchFields": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
]
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": {
"nodeSelectorTerms": [
{
"matchExpressions": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
],
"matchFields": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
]
}
]
}
},
"podAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
}
]
},
"podAntiAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
}
]
}
},
"architecture": "string",
"dnsConfig": {
"nameservers": [
"string"
],
"options": [
{
"name": "string",
"value": "string"
}
],
"searches": [
"string"
]
},
"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": "string",
"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": "string",
"serial": "string",
"shareable": true,
"tag": "string"
}
],
"downwardMetrics": {},
"filesystems": [
{
"name": "string",
"virtiofs": {}
}
],
"gpus": [
{
"deviceName": "string",
"name": "string",
"tag": "string",
"virtualGPUOptions": {
"display": {
"enabled": true,
"ramFB": {
"enabled": true
}
}
}
}
],
"hostDevices": [
{
"deviceName": "string",
"name": "string",
"tag": "string"
}
],
"inputs": [
{
"bus": "string",
"name": "string",
"type": "string"
}
],
"interfaces": [
{
"acpiIndex": 0,
"binding": {
"name": "string"
},
"bootOrder": 0,
"bridge": {},
"dhcpOptions": {
"bootFileName": "string",
"ntpServers": [
"string"
],
"privateOptions": [
{
"option": 0,
"value": "string"
}
],
"tftpServerName": "string"
},
"macAddress": "string",
"macvtap": {},
"masquerade": {},
"model": "string",
"name": "string",
"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": "string"
},
"tpm": {
"persistent": true
},
"useVirtioTransitional": true,
"watchdog": {
"i6300esb": {
"action": "string"
},
"name": "string"
}
},
"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": "string",
"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": "string"
},
"memory": {
"guest": "string",
"hugepages": {
"pageSize": "string"
},
"maxGuest": "string"
},
"resources": {
"limits": {},
"overcommitGuestOverhead": true,
"requests": {}
}
},
"evictionStrategy": "string",
"hostname": "string",
"livenessProbe": {
"exec": {
"command": [
"string"
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"path": "string",
"port": {},
"scheme": "HTTP"
},
"initialDelaySeconds": 0,
"periodSeconds": 0,
"successThreshold": 0,
"tcpSocket": {
"host": "string",
"port": {}
},
"timeoutSeconds": 0
},
"networks": [
{
"multus": {
"default": true,
"networkName": "string"
},
"name": "string",
"pod": {
"vmIPv6NetworkCIDR": "string",
"vmNetworkCIDR": "string"
}
}
],
"nodeSelector": {},
"priorityClassName": "string",
"readinessProbe": {
"exec": {
"command": [
"string"
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"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": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"matchLabelKeys": [
"string"
],
"maxSkew": 0,
"minDomains": 0,
"nodeAffinityPolicy": "string",
"nodeTaintsPolicy": "string",
"topologyKey": "string",
"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": "string",
"imagePullPolicy": "Always",
"imagePullSecret": "string",
"path": "string"
},
"dataVolume": {
"hotpluggable": true,
"name": "string"
},
"downwardAPI": {
"fields": [
{
"fieldRef": {
"apiVersion": "string",
"fieldPath": "string"
},
"mode": 0,
"path": "string",
"resourceFieldRef": {
"containerName": "string",
"divisor": {},
"resource": "string"
}
}
],
"volumeLabel": "string"
},
"downwardMetrics": {},
"emptyDisk": {
"capacity": {}
},
"ephemeral": {
"persistentVolumeClaim": {
"claimName": "string",
"readOnly": true
}
},
"hostDisk": {
"capacity": {},
"path": "string",
"shared": true,
"type": "string"
},
"memoryDump": {
"claimName": "string",
"hotpluggable": true,
"readOnly": true
},
"name": "string",
"persistentVolumeClaim": {
"claimName": "string",
"hotpluggable": true,
"readOnly": true
},
"secret": {
"optional": true,
"secretName": "string",
"volumeLabel": "string"
},
"serviceAccount": {
"serviceAccountName": "string"
},
"sysprep": {
"configMap": {
"name": "string"
},
"secret": {
"name": "string"
}
}
}
]
},
"status": {
"VSOCKCID": 0,
"activePods": {},
"conditions": [
{
"lastProbeTime": {},
"lastTransitionTime": {},
"message": "string",
"reason": "string",
"status": "string",
"type": "string"
}
],
"currentCPUTopology": {
"cores": 0,
"sockets": 0,
"threads": 0
},
"evacuationNodeName": "string",
"fsFreezeStatus": "string",
"guestOSInfo": {
"id": "string",
"kernelRelease": "string",
"kernelVersion": "string",
"machine": "string",
"name": "string",
"prettyName": "string",
"version": "string",
"versionId": "string"
},
"interfaces": [
{
"infoSource": "string",
"interfaceName": "string",
"ipAddress": "string",
"ipAddresses": [
"string"
],
"mac": "string",
"name": "string",
"queueCount": 0
}
],
"kernelBootStatus": {
"initrdInfo": {
"checksum": 0
},
"kernelInfo": {
"checksum": 0
}
},
"launcherContainerImageVersion": "string",
"machine": {
"type": "string"
},
"memory": {
"guestAtBoot": "string",
"guestCurrent": "string",
"guestRequested": "string"
},
"migrationMethod": "string",
"migrationState": {
"abortRequested": true,
"abortStatus": "string",
"completed": true,
"endTimestamp": "string",
"failed": true,
"migrationConfiguration": {
"allowAutoConverge": true,
"allowPostCopy": true,
"bandwidthPerMigration": "string",
"completionTimeoutPerGiB": 0,
"disableTLS": true,
"matchSELinuxLevelOnMigration": true,
"network": "string",
"nodeDrainTaintKey": "string",
"parallelMigrationsPerCluster": 0,
"parallelOutboundMigrationsPerNode": 0,
"progressTimeout": 0,
"unsafeMigrationOverride": true
},
"migrationPolicyName": "string",
"migrationUid": "string",
"mode": "string",
"sourceNode": "string",
"startTimestamp": "string",
"targetAttachmentPodUID": "string",
"targetCPUSet": [
0
],
"targetDirectMigrationNodePorts": {},
"targetNode": "string",
"targetNodeAddress": "string",
"targetNodeDomainDetected": true,
"targetNodeDomainReadyTimestamp": "string",
"targetNodeTopology": "string",
"targetPod": "string"
},
"migrationTransport": "string",
"nodeName": "string",
"phase": "string",
"phaseTransitionTimestamps": [
{
"phase": "string",
"phaseTransitionTimestamp": {}
}
],
"qosClass": "string",
"reason": "string",
"runtimeUser": 0,
"selinuxContext": "string",
"topologyHints": {
"tscFrequency": 0
},
"virtualMachineRevisionName": "string",
"volumeStatus": [
{
"containerDiskVolume": {
"checksum": 0
},
"hotplugVolume": {
"attachPodName": "string",
"attachPodUID": "string"
},
"memoryDumpVolume": {
"claimName": "string",
"endTimestamp": "string",
"startTimestamp": "string",
"targetFileName": "string"
},
"message": "string",
"name": "string",
"persistentVolumeClaimInfo": {
"accessModes": [
"string"
],
"capacity": {},
"filesystemOverhead": "string",
"preallocated": true,
"requests": {},
"volumeMode": "string"
},
"phase": "string",
"reason": "string",
"size": 0,
"target": "string"
}
]
}
}
],
"kind": "string",
"metadata": {
"continue": "string",
"remainingItemCount": 0,
"resourceVersion": "string",
"selfLink": "string"
}
}
- Schema
- Example (from schema)
Schema
metadata object
{
"apiVersion": "string",
"items": [
{
"apiVersion": "string",
"kind": "string",
"metadata": {
"name": "string",
"namespace": "string"
},
"spec": {
"accessCredentials": [
{
"sshPublicKey": {
"propagationMethod": {
"configDrive": {},
"noCloud": {},
"qemuGuestAgent": {
"users": [
"string"
]
}
},
"source": {
"secret": {
"secretName": "string"
}
}
},
"userPassword": {
"propagationMethod": {
"qemuGuestAgent": {}
},
"source": {
"secret": {
"secretName": "string"
}
}
}
}
],
"affinity": {
"nodeAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"preference": {
"matchExpressions": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
],
"matchFields": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
]
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": {
"nodeSelectorTerms": [
{
"matchExpressions": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
],
"matchFields": [
{
"key": "string",
"operator": "DoesNotExist",
"values": [
"string"
]
}
]
}
]
}
},
"podAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
}
]
},
"podAntiAffinity": {
"preferredDuringSchedulingIgnoredDuringExecution": [
{
"podAffinityTerm": {
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
},
"weight": 0
}
],
"requiredDuringSchedulingIgnoredDuringExecution": [
{
"labelSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaceSelector": {
"matchExpressions": [
{
"key": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"namespaces": [
"string"
],
"topologyKey": "string"
}
]
}
},
"architecture": "string",
"dnsConfig": {
"nameservers": [
"string"
],
"options": [
{
"name": "string",
"value": "string"
}
],
"searches": [
"string"
]
},
"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": "string",
"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": "string",
"serial": "string",
"shareable": true,
"tag": "string"
}
],
"downwardMetrics": {},
"filesystems": [
{
"name": "string",
"virtiofs": {}
}
],
"gpus": [
{
"deviceName": "string",
"name": "string",
"tag": "string",
"virtualGPUOptions": {
"display": {
"enabled": true,
"ramFB": {
"enabled": true
}
}
}
}
],
"hostDevices": [
{
"deviceName": "string",
"name": "string",
"tag": "string"
}
],
"inputs": [
{
"bus": "string",
"name": "string",
"type": "string"
}
],
"interfaces": [
{
"acpiIndex": 0,
"binding": {
"name": "string"
},
"bootOrder": 0,
"bridge": {},
"dhcpOptions": {
"bootFileName": "string",
"ntpServers": [
"string"
],
"privateOptions": [
{
"option": 0,
"value": "string"
}
],
"tftpServerName": "string"
},
"macAddress": "string",
"macvtap": {},
"masquerade": {},
"model": "string",
"name": "string",
"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": "string"
},
"tpm": {
"persistent": true
},
"useVirtioTransitional": true,
"watchdog": {
"i6300esb": {
"action": "string"
},
"name": "string"
}
},
"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": "string",
"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": "string"
},
"memory": {
"guest": "string",
"hugepages": {
"pageSize": "string"
},
"maxGuest": "string"
},
"resources": {
"limits": {},
"overcommitGuestOverhead": true,
"requests": {}
}
},
"evictionStrategy": "string",
"hostname": "string",
"livenessProbe": {
"exec": {
"command": [
"string"
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"path": "string",
"port": {},
"scheme": "HTTP"
},
"initialDelaySeconds": 0,
"periodSeconds": 0,
"successThreshold": 0,
"tcpSocket": {
"host": "string",
"port": {}
},
"timeoutSeconds": 0
},
"networks": [
{
"multus": {
"default": true,
"networkName": "string"
},
"name": "string",
"pod": {
"vmIPv6NetworkCIDR": "string",
"vmNetworkCIDR": "string"
}
}
],
"nodeSelector": {},
"priorityClassName": "string",
"readinessProbe": {
"exec": {
"command": [
"string"
]
},
"failureThreshold": 0,
"guestAgentPing": {},
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"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": "string",
"operator": "string",
"values": [
"string"
]
}
],
"matchLabels": {}
},
"matchLabelKeys": [
"string"
],
"maxSkew": 0,
"minDomains": 0,
"nodeAffinityPolicy": "string",
"nodeTaintsPolicy": "string",
"topologyKey": "string",
"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": "string",
"imagePullPolicy": "Always",
"imagePullSecret": "string",
"path": "string"
},
"dataVolume": {
"hotpluggable": true,
"name": "string"
},
"downwardAPI": {
"fields": [
{
"fieldRef": {
"apiVersion": "string",
"fieldPath": "string"
},
"mode": 0,
"path": "string",
"resourceFieldRef": {
"containerName": "string",
"divisor": {},
"resource": "string"
}
}
],
"volumeLabel": "string"
},
"downwardMetrics": {},
"emptyDisk": {
"capacity": {}
},
"ephemeral": {
"persistentVolumeClaim": {
"claimName": "string",
"readOnly": true
}
},
"hostDisk": {
"capacity": {},
"path": "string",
"shared": true,
"type": "string"
},
"memoryDump": {
"claimName": "string",
"hotpluggable": true,
"readOnly": true
},
"name": "string",
"persistentVolumeClaim": {
"claimName": "string",
"hotpluggable": true,
"readOnly": true
},
"secret": {
"optional": true,
"secretName": "string",
"volumeLabel": "string"
},
"serviceAccount": {
"serviceAccountName": "string"
},
"sysprep": {
"configMap": {
"name": "string"
},
"secret": {
"name": "string"
}
}
}
]
},
"status": {
"VSOCKCID": 0,
"activePods": {},
"conditions": [
{
"lastProbeTime": {},
"lastTransitionTime": {},
"message": "string",
"reason": "string",
"status": "string",
"type": "string"
}
],
"currentCPUTopology": {
"cores": 0,
"sockets": 0,
"threads": 0
},
"evacuationNodeName": "string",
"fsFreezeStatus": "string",
"guestOSInfo": {
"id": "string",
"kernelRelease": "string",
"kernelVersion": "string",
"machine": "string",
"name": "string",
"prettyName": "string",
"version": "string",
"versionId": "string"
},
"interfaces": [
{
"infoSource": "string",
"interfaceName": "string",
"ipAddress": "string",
"ipAddresses": [
"string"
],
"mac": "string",
"name": "string",
"queueCount": 0
}
],
"kernelBootStatus": {
"initrdInfo": {
"checksum": 0
},
"kernelInfo": {
"checksum": 0
}
},
"launcherContainerImageVersion": "string",
"machine": {
"type": "string"
},
"memory": {
"guestAtBoot": "string",
"guestCurrent": "string",
"guestRequested": "string"
},
"migrationMethod": "string",
"migrationState": {
"abortRequested": true,
"abortStatus": "string",
"completed": true,
"endTimestamp": "string",
"failed": true,
"migrationConfiguration": {
"allowAutoConverge": true,
"allowPostCopy": true,
"bandwidthPerMigration": "string",
"completionTimeoutPerGiB": 0,
"disableTLS": true,
"matchSELinuxLevelOnMigration": true,
"network": "string",
"nodeDrainTaintKey": "string",
"parallelMigrationsPerCluster": 0,
"parallelOutboundMigrationsPerNode": 0,
"progressTimeout": 0,
"unsafeMigrationOverride": true
},
"migrationPolicyName": "string",
"migrationUid": "string",
"mode": "string",
"sourceNode": "string",
"startTimestamp": "string",
"targetAttachmentPodUID": "string",
"targetCPUSet": [
0
],
"targetDirectMigrationNodePorts": {},
"targetNode": "string",
"targetNodeAddress": "string",
"targetNodeDomainDetected": true,
"targetNodeDomainReadyTimestamp": "string",
"targetNodeTopology": "string",
"targetPod": "string"
},
"migrationTransport": "string",
"nodeName": "string",
"phase": "string",
"phaseTransitionTimestamps": [
{
"phase": "string",
"phaseTransitionTimestamp": {}
}
],
"qosClass": "string",
"reason": "string",
"runtimeUser": 0,
"selinuxContext": "string",
"topologyHints": {
"tscFrequency": 0
},
"virtualMachineRevisionName": "string",
"volumeStatus": [
{
"containerDiskVolume": {
"checksum": 0
},
"hotplugVolume": {
"attachPodName": "string",
"attachPodUID": "string"
},
"memoryDumpVolume": {
"claimName": "string",
"endTimestamp": "string",
"startTimestamp": "string",
"targetFileName": "string"
},
"message": "string",
"name": "string",
"persistentVolumeClaimInfo": {
"accessModes": [
"string"
],
"capacity": {},
"filesystemOverhead": "string",
"preallocated": true,
"requests": {},
"volumeMode": "string"
},
"phase": "string",
"reason": "string",
"size": 0,
"target": "string"
}
]
}
}
],
"kind": "string",
"metadata": {
"continue": "string",
"remainingItemCount": 0,
"resourceVersion": "string",
"selfLink": "string"
}
}
Unauthorized
- application/json
- application/json;stream=watch
- application/yaml
- Schema
Schema
string
- Schema
Schema
string