Skip to main content
Version: v1.1 (EOL)

Read a Virtual Machine Instance

GET 

/apis/kubevirt.io/v1/namespaces/{namespace:[a-z0-9][a-z0-9\-]*}/virtualmachineinstances/{name:[a-z0-9][a-z0-9\-]*}

Get a VirtualMachineInstance object.

Request

Path Parameters

    name stringrequired

    Name of the resource

    namespace stringrequired

    Object name and auth scope, such as for teams and projects

Query Parameters

    exact boolean

    Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'.

    export boolean

    Should this value be exported. Export strips fields that a user can not specify.

Responses

OK

Schema
    apiVersion stringrequired
    kind stringrequired
    metadata object
    name stringrequired
    namespace string
    spec objectrequired
    accessCredentials object[]
  • Array [
  • sshPublicKey object
    propagationMethod objectrequired
    configDrive object
    qemuGuestAgent object
    users string[]required
    source objectrequired
    secret object
    secretName stringrequired
    userPassword object
    propagationMethod objectrequired
    qemuGuestAgent object
    source objectrequired
    secret object
    secretName stringrequired
  • ]
  • affinity object
    nodeAffinity object
    preferredDuringSchedulingIgnoredDuringExecution object[]
  • Array [
  • preference objectrequired
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired

    Possible values: [DoesNotExist, Exists, Gt, In, Lt, NotIn]

    values string[]
  • ]
  • matchFields object[]
  • Array [
  • key stringrequired
    operator stringrequired

    Possible values: [DoesNotExist, Exists, Gt, In, Lt, NotIn]

    values string[]
  • ]
  • weight int32required

    Default value: 0

  • ]
  • requiredDuringSchedulingIgnoredDuringExecution object
    nodeSelectorTerms object[]required
  • Array [
  • matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired

    Possible values: [DoesNotExist, Exists, Gt, In, Lt, NotIn]

    values string[]
  • ]
  • matchFields object[]
  • Array [
  • key stringrequired
    operator stringrequired

    Possible values: [DoesNotExist, Exists, Gt, In, Lt, NotIn]

    values string[]
  • ]
  • ]
  • podAffinity object
    preferredDuringSchedulingIgnoredDuringExecution object[]
  • Array [
  • podAffinityTerm objectrequired
    labelSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaceSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaces string[]
    topologyKey stringrequired
    weight int32required

    Default value: 0

  • ]
  • requiredDuringSchedulingIgnoredDuringExecution object[]
  • Array [
  • labelSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaceSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaces string[]
    topologyKey stringrequired
  • ]
  • podAntiAffinity object
    preferredDuringSchedulingIgnoredDuringExecution object[]
  • Array [
  • podAffinityTerm objectrequired
    labelSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaceSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaces string[]
    topologyKey stringrequired
    weight int32required

    Default value: 0

  • ]
  • requiredDuringSchedulingIgnoredDuringExecution object[]
  • Array [
  • labelSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaceSelector object
    matchExpressions object[]
  • Array [
  • key stringrequired
    operator stringrequired
    values string[]
  • ]
  • matchLabels object
    property name* string
    namespaces string[]
    topologyKey stringrequired
  • ]
  • dnsConfig object
    nameservers string[]
    options object[]
  • Array [
  • name string
    value string
  • ]
  • searches string[]
    dnsPolicy string

    Possible values: [ClusterFirst, ClusterFirstWithHostNet, Default, None]

    domain objectrequired
    chassis object
    asset string
    manufacturer string
    serial string
    sku string
    version string
    clock object
    timer object
    hpet object
    present boolean
    tickPolicy string
    hyperv object
    present boolean
    kvm object
    present boolean
    pit object
    present boolean
    tickPolicy string
    rtc object
    present boolean
    tickPolicy string
    track string
    timezone string
    utc object
    offsetSeconds int32
    cpu object
    cores int64
    dedicatedCpuPlacement boolean
    features object[]
  • Array [
  • name stringrequired
    policy string
  • ]
  • isolateEmulatorThread boolean
    model string
    numa object
    guestMappingPassthrough object
    realtime object
    mask string
    sockets int64
    threads int64
    devices objectrequired
    autoattachGraphicsDevice boolean
    autoattachMemBalloon boolean
    autoattachPodInterface boolean
    autoattachSerialConsole boolean
    blockMultiQueue boolean
    clientPassthrough object
    disableHotplug boolean
    disks object[]
  • Array [
  • blockSize object
    custom object
    logical int32required

    Default value: 0

    physical int32required

    Default value: 0

    matchVolume object
    enabled boolean
    bootOrder int32
    cache string
    cdrom object
    bus string
    readonly boolean
    tray string
    dedicatedIOThread boolean
    disk object
    bus string
    pciAddress string
    readonly boolean
    io string
    lun object
    bus string
    readonly boolean
    name stringrequired
    serial string
    shareable boolean
    tag string
  • ]
  • filesystems object[]
  • Array [
  • name stringrequired
    virtiofs objectrequired
  • ]
  • gpus object[]
  • Array [
  • deviceName stringrequired
    name stringrequired
    tag string
    virtualGPUOptions object
    display object
    enabled boolean
    ramFB object
    enabled boolean
  • ]
  • hostDevices object[]
  • Array [
  • deviceName stringrequired
    name stringrequired
    tag string
  • ]
  • inputs object[]
  • Array [
  • bus string
    name stringrequired
    type stringrequired
  • ]
  • interfaces object[]
  • Array [
  • bootOrder int32
    bridge object
    dhcpOptions object
    bootFileName string
    ntpServers string[]
    privateOptions object[]
  • Array [
  • option int32required

    Default value: 0

    value stringrequired
  • ]
  • tftpServerName string
    macAddress string
    macvtap object
    masquerade object
    model string
    name stringrequired
    pciAddress string
    ports object[]
  • Array [
  • name string
    port int32required

    Default value: 0

    protocol string
  • ]
  • slirp object
    sriov object
    tag string
  • ]
  • networkInterfaceMultiqueue boolean
    rng object
    sound object
    model string
    name stringrequired
    tpm object
    useVirtioTransitional boolean
    watchdog object
    i6300esb object
    action string
    name stringrequired
    features object
    acpi object
    enabled boolean
    apic object
    enabled boolean
    endOfInterrupt boolean
    hyperv object
    evmcs object
    enabled boolean
    frequencies object
    enabled boolean
    ipi object
    enabled boolean
    reenlightenment object
    enabled boolean
    relaxed object
    enabled boolean
    reset object
    enabled boolean
    runtime object
    enabled boolean
    spinlocks object
    enabled boolean
    spinlocks int64
    synic object
    enabled boolean
    synictimer object
    direct object
    enabled boolean
    enabled boolean
    tlbflush object
    enabled boolean
    vapic object
    enabled boolean
    vendorid object
    enabled boolean
    vendorid string
    vpindex object
    enabled boolean
    kvm object
    hidden boolean
    pvspinlock object
    enabled boolean
    smm object
    enabled boolean
    firmware object
    bootloader object
    bios object
    useSerial boolean
    efi object
    secureBoot boolean
    kernelBoot object
    container object
    image stringrequired
    imagePullPolicy string

    Possible values: [Always, IfNotPresent, Never]

    imagePullSecret string
    initrdPath string
    kernelPath string
    kernelArgs string
    serial string
    uuid string
    ioThreadsPolicy string
    launchSecurity object
    sev object
    machine object
    type string
    memory object
    guest string
    hugepages object
    pageSize string
    resources object
    limits object
    property name* string

    Default value: [object Object]

    overcommitGuestOverhead boolean
    requests object
    property name* string

    Default value: [object Object]

    evictionStrategy string
    hostname string
    livenessProbe object
    exec object
    command string[]
    failureThreshold int32
    guestAgentPing object
    httpGet object
    host string
    httpHeaders object[]
  • Array [
  • name stringrequired
    value stringrequired
  • ]
  • path string
    port int-or-stringrequired

    Default value: [object Object]

    scheme string

    Possible values: [HTTP, HTTPS]

    initialDelaySeconds int32
    periodSeconds int32
    successThreshold int32
    tcpSocket object
    host string
    port int-or-stringrequired

    Default value: [object Object]

    timeoutSeconds int32
    networks object[]
  • Array [
  • multus object
    default boolean
    networkName stringrequired
    name stringrequired
    pod object
    vmIPv6NetworkCIDR string
    vmNetworkCIDR string
  • ]
  • nodeSelector object
    property name* string
    priorityClassName string
    readinessProbe object
    exec object
    command string[]
    failureThreshold int32
    guestAgentPing object
    httpGet object
    host string
    httpHeaders object[]
  • Array [
  • name stringrequired
    value stringrequired
  • ]
  • path string
    port int-or-stringrequired

    Default value: [object Object]

    scheme string

    Possible values: [HTTP, HTTPS]

    initialDelaySeconds int32
    periodSeconds int32
    successThreshold int32
    tcpSocket object
    host string
    port int-or-stringrequired

    Default value: [object Object]

    timeoutSeconds int32
    schedulerName string
    startStrategy string
    subdomain string
    terminationGracePeriodSeconds int64
    tolerations object[]
  • Array [
  • effect string

    Possible values: [NoExecute, NoSchedule, PreferNoSchedule]

    key string
    operator string

    Possible values: [Equal, Exists]

    tolerationSeconds int64
    value string
  • ]
  • volumes object[]
  • Array [
  • cloudInitConfigDrive object
    networkData string
    networkDataBase64 string
    networkDataSecretRef object
    name string
    secretRef object
    name string
    userData string
    userDataBase64 string
    cloudInitNoCloud object
    networkData string
    networkDataBase64 string
    networkDataSecretRef object
    name string
    secretRef object
    name string
    userData string
    userDataBase64 string
    configMap object
    name string
    optional boolean
    volumeLabel string
    containerDisk object
    image stringrequired
    imagePullPolicy string

    Possible values: [Always, IfNotPresent, Never]

    imagePullSecret string
    path string
    dataVolume object
    hotpluggable boolean
    name stringrequired
    downwardAPI object
    fields object[]
  • Array [
  • fieldRef object
    apiVersion string
    fieldPath stringrequired
    mode int32
    path stringrequired
    resourceFieldRef object
    containerName string
    divisor string

    Default value: [object Object]

    resource stringrequired
  • ]
  • volumeLabel string
    downwardMetrics object
    emptyDisk object
    capacity stringrequired

    Default value: [object Object]

    ephemeral object
    persistentVolumeClaim object
    claimName stringrequired
    readOnly boolean
    hostDisk object
    capacity string

    Default value: [object Object]

    path stringrequired
    shared boolean
    type stringrequired
    memoryDump object
    claimName stringrequired
    hotpluggable boolean
    readOnly boolean
    name stringrequired
    persistentVolumeClaim object
    claimName stringrequired
    hotpluggable boolean
    readOnly boolean
    secret object
    optional boolean
    secretName string
    volumeLabel string
    serviceAccount object
    serviceAccountName string
    sysprep object
    configMap object
    name string
    secret object
    name string
  • ]
  • status object
    activePods object
    property name* string
    conditions object[]
  • Array [
  • lastProbeTime string
    lastTransitionTime string
    message string
    reason string
    status stringrequired
    type stringrequired
  • ]
  • evacuationNodeName string
    fsFreezeStatus string
    guestOSInfo object
    id string
    kernelRelease string
    kernelVersion string
    machine string
    name string
    prettyName string
    version string
    versionId string
    interfaces object[]
  • Array [
  • infoSource string
    interfaceName string
    ipAddress string
    ipAddresses string[]
    mac string
    name string
  • ]
  • launcherContainerImageVersion string
    migrationMethod string
    migrationState object
    abortRequested boolean
    abortStatus string
    completed boolean
    endTimestamp string
    failed boolean
    migrationConfiguration object
    allowAutoConverge boolean
    allowPostCopy boolean
    bandwidthPerMigration string
    completionTimeoutPerGiB int64
    disableTLS boolean
    network string
    nodeDrainTaintKey string
    parallelMigrationsPerCluster int64
    parallelOutboundMigrationsPerNode int64
    progressTimeout int64
    unsafeMigrationOverride boolean
    migrationPolicyName string
    migrationUid string
    mode string
    sourceNode string
    startTimestamp string
    targetAttachmentPodUID string
    targetCPUSet int32[]
    targetDirectMigrationNodePorts object
    property name* int32

    Default value: 0

    targetNode string
    targetNodeAddress string
    targetNodeDomainDetected boolean
    targetNodeTopology string
    targetPod string
    migrationTransport string
    nodeName string
    phase string
    phaseTransitionTimestamps object[]
  • Array [
  • phase string
    phaseTransitionTimestamp string
  • ]
  • qosClass string
    reason string
    runtimeUser int64

    Default value: 0

    topologyHints object
    tscFrequency int64
    virtualMachineRevisionName string
    volumeStatus object[]
  • Array [
  • hotplugVolume object
    attachPodName string
    attachPodUID string
    memoryDumpVolume object
    claimName string
    endTimestamp string
    startTimestamp string
    targetFileName string
    message string
    name stringrequired
    persistentVolumeClaimInfo object
    accessModes string[]
    capacity object
    property name* string

    Default value: [object Object]

    filesystemOverhead string
    preallocated boolean
    requests object
    property name* string

    Default value: [object Object]

    volumeMode string
    phase string
    reason string
    size int64
    target stringrequired
  • ]