更新

请求参数

Path 参数

string

必需

The Id or Name of isolated_device

Body 参数application/json

isolated_device

object (IsolatedDeviceUpdateInput)

可选

description

string

资源描述

可选

dev_type

string

可选

device_path

string

可选

Host device path

name

string

资源名称

可选

pcie_info

object (IsolatedDevicePCIEInfo)

可选

reserved_cpu

integer <int64>

GPU 预留CPU

可选

reserved_memory

integer <int64>

GPU 预留内存

可选

reserved_storage

integer <int64>

GPU 预留磁盘

可选

示例

{
    "isolated_device": {
        "description": "string",
        "dev_type": "string",
        "device_path": "string",
        "name": "string",
        "pcie_info": {
            "lane_width": 0,
            "throughput": "string",
            "transfer_rate_per_lane": "string",
            "version": "string"
        },
        "reserved_cpu": 0,
        "reserved_memory": 0,
        "reserved_storage": 0
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

isolated_device

object (IsolateDeviceDetails)

可选

account

string

云账号名称

可选

示例值:

google-account

account_health_status

string

云账号监控状态

可选

account_id

string

云账号Id

可选

示例值:

4d3c8979-9dd0-439b-8d78-36fe1ab1666c

account_read_only

boolean

可选

account_status

string

云账号状态

可选

addr

string

可选

pci address of `Bus:Device.Function` format, or usb bus address of `bus.addr`

brand

string

云平台品牌

可选

示例值:

Google

can_delete

boolean

可选

资源是否可以删除, 若为flase, delete_fail_reason会返回不能删除的原因

示例值:

true

can_update

boolean

可选

资源是否可以更新, 若为false,update_fail_reason会返回资源不能删除的原因

示例值:

true

card_path

string

可选

GPU card path, like /dev/dri/cardX

cloud_env

string

云环境

可选

示例值:

public

cloudregion

string

区域的名称

可选

cloudregion_id

string

可用区的区域ID

可选

created_at

string <date-time>

资源创建时间

可选

delete_fail_reason

object (Error)

可选

deleted

boolean

资源是否被删除

可选

deleted_at

string <date-time>

资源删除时间

可选

description

string

资源描述信息

可选

dev_type

string

可选

PCI / GPU-HPC / GPU-VGA / USB / NIC

设备类型

device_path

string

可选

disk_index

integer

可选

guest disk index

environment

string

可选

Environment

external_id

string

可选

云上Id, 对应云上资源自身Id

framebuffer

string

可选

The frame buffer size in Mbytes

frl

string

可选

The frame rate limiter (FRL) configuration in frames per second

guest

string

云主机名称

可选

guest_id

string

云主机Id

可选

guest_status

string

云主机状态

可选

host

string

宿主机名称

可选

host_access_ip

string

宿主机管理IP

可选

host_access_mac

string

宿主机MAC

可选

host_billing_type

string

宿主机计费类型

可选

host_eip

string

可选

宿主机公网IP（如果有）

host_enabled

boolean

宿主是否启用

可选

host_id

string

可选

host_resource_type

string

可选

host_service_status

string

宿主机服务状态`

可选

host_sn

string

宿主机序列号

可选

host_status

string

宿主机状态

可选

host_type

string

宿主机类型

可选

string

资源UUID

可选

imported_at

string <date-time>

资源导入时间

可选

is_emulated

boolean

可选

是否是模拟资源, 部分从公有云上同步的资源并不真实存在, 例如宿主机
list 接口默认不会返回这类资源，除非显示指定 is_emulate=true 过滤参数

is_infiniband_nic

boolean

可选

Is infiniband nic

is_public

boolean

是否共享

可选

manager

string

云订阅名称

可选

示例值:

google-account

manager_domain

string

子订阅所在域名称

可选

示例值:

Default

manager_domain_id

string

子订阅所在域Id

可选

示例值:

default

manager_id

string

归属云订阅ID

可选

manager_project

string

子订阅所在项目名称

可选

示例值:

system

manager_project_id

string

子订阅所在项目Id

可选

示例值:

4d3c8979-9dd0-439b-8d78-36fe1ab1666c

max_instance

string

可选

The maximum number of vGPU instances per physical GPU

max_resolution

string

可选

The maximum resolution per display head, eg: 5120x2880

mdev_id

string

可选

Is vgpu physical funcion, That means it cannot be attached to guest

默认值:

"false" list:"domain" create:"domain_optional"`

metadata

object

标签

可选

model

string

可选

Specific device name read from lspci command, e.g. `Tesla K40m` ...

mps_memory_limit

integer <int64>

可选

MPS perdevice memory limit MB

mps_memory_total

integer <int64>

可选

MPS device memory total MB

mps_thread_percentage

integer <int64>

可选

MPS device thread percentage

name

string

资源名称

可选

network_index

integer <int64>

可选

guest network index

num_heads

string

可选

The maximum number of virtual display heads that the vGPU type supports
In computer graphics and display technology, the term "head" is commonly used to
describe the physical interface of a display device or display output.
It refers to a connection point on the monitor, such as HDMI, DisplayPort, or VGA interface.

numa_node

integer

可选

device numa node

nvme_size_mb

integer <int64>

可选

NVME disk size

ovs_offload_interface

string

可选

Offload interface name

pcie_info

object (IsolatedDevicePCIEInfo)

可选

provider

string

云平台名称

可选

示例值:

Google

public_scope

string

默认共享范围

可选

public_src

string

可选

共享设置的来源, local: 本地设置, cloud: 从云上同步过来

示例值:

local

region

string

区域的名称

可选

示例值:

Default

region_ext_id

string

纳管云区域的Id

可选

示例值:

59e7bc87-a6b3-4c39-8f02-c68e8243d4e4

region_external_id

string

可选

纳管云区域的组合Id(平台+Id)

示例值:

ZStack/59e7bc87-a6b3-4c39-8f02-c68e8243d4e4

region_id

string

区域的Id

可选

示例值:

default

render_path

string

可选

GPU render path, like /dev/dri/renderDX

reserved_cpu

integer <int64>

可选

reserved cpu count for isolated device

reserved_memory

integer <int64>

可选

reserved memory size for isolated device

reserved_storage

integer <int64>

可选

reserved storage size for isolated device

shared_domains

array[object (SharedDomain) {2}]

共享的域列表

可选

shared_projects

array[object (SharedProject) {4}]

共享的项目列表

可选

source

string

可选

资源来源, cloud: 从云上同步下来的资源, local: 从本地创建的资源或资源在本地更改过项目

update_fail_reason

object (Error)

可选

update_version

integer <int64>

资源被更新次数

可选

updated_at

string <date-time>

资源更新时间

可选

vendor_device_id

string

可选

wire_id

string

可选

Nic wire id

zone

string

可用区名称

可选

示例值:

北京一区

zone_ext_id

string

可选

纳管云的zoneId

zone_id

string

归属可用区ID

可选

示例

{
    "isolated_device": {
        "account": "google-account",
        "account_health_status": "string",
        "account_id": "4d3c8979-9dd0-439b-8d78-36fe1ab1666c",
        "account_read_only": true,
        "account_status": "string",
        "addr": "string",
        "brand": "Google",
        "can_delete": true,
        "can_update": true,
        "card_path": "string",
        "cloud_env": "public",
        "cloudregion": "string",
        "cloudregion_id": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "delete_fail_reason": {
            "class": "string",
            "code": 0,
            "details": "string"
        },
        "deleted": true,
        "deleted_at": "2019-08-24T14:15:22Z",
        "description": "string",
        "dev_type": "string",
        "device_path": "string",
        "disk_index": 0,
        "environment": "string",
        "external_id": "string",
        "framebuffer": "string",
        "frl": "string",
        "guest": "string",
        "guest_id": "string",
        "guest_status": "string",
        "host": "string",
        "host_access_ip": "string",
        "host_access_mac": "string",
        "host_billing_type": "string",
        "host_eip": "string",
        "host_enabled": true,
        "host_id": "string",
        "host_resource_type": "string",
        "host_service_status": "string",
        "host_sn": "string",
        "host_status": "string",
        "host_type": "string",
        "id": "string",
        "imported_at": "2019-08-24T14:15:22Z",
        "is_emulated": true,
        "is_infiniband_nic": true,
        "is_public": true,
        "manager": "google-account",
        "manager_domain": "Default",
        "manager_domain_id": "default",
        "manager_id": "string",
        "manager_project": "system",
        "manager_project_id": "4d3c8979-9dd0-439b-8d78-36fe1ab1666c",
        "max_instance": "string",
        "max_resolution": "string",
        "mdev_id": "\"false\" list:\"domain\" create:\"domain_optional\"`",
        "metadata": {
            "property1": "string",
            "property2": "string"
        },
        "model": "string",
        "mps_memory_limit": 0,
        "mps_memory_total": 0,
        "mps_thread_percentage": 0,
        "name": "string",
        "network_index": 0,
        "num_heads": "string",
        "numa_node": 0,
        "nvme_size_mb": 0,
        "ovs_offload_interface": "string",
        "pcie_info": {
            "lane_width": 0,
            "throughput": "string",
            "transfer_rate_per_lane": "string",
            "version": "string"
        },
        "provider": "Google",
        "public_scope": "string",
        "public_src": "local",
        "region": "Default",
        "region_ext_id": "59e7bc87-a6b3-4c39-8f02-c68e8243d4e4",
        "region_external_id": "ZStack/59e7bc87-a6b3-4c39-8f02-c68e8243d4e4",
        "region_id": "default",
        "render_path": "string",
        "reserved_cpu": 0,
        "reserved_memory": 0,
        "reserved_storage": 0,
        "shared_domains": [
            {
                "id": "string",
                "name": "string"
            }
        ],
        "shared_projects": [
            {
                "domain": "string",
                "domain_id": "string",
                "id": "string",
                "name": "string"
            }
        ],
        "source": "string",
        "update_fail_reason": {
            "class": "string",
            "code": 0,
            "details": "string"
        },
        "update_version": 0,
        "updated_at": "2019-08-24T14:15:22Z",
        "vendor_device_id": "string",
        "wire_id": "string",
        "zone": "北京一区",
        "zone_ext_id": "string",
        "zone_id": "string"
    }
}

更新

请求参数

示例代码

返回响应

pci address of Bus:Device.Function format, or usb bus address of bus.addr

PCI / GPU-HPC / GPU-VGA / USB / NIC

Specific device name read from lspci command, e.g. Tesla K40m ...

pci address of `Bus:Device.Function` format, or usb bus address of `bus.addr`

Specific device name read from lspci command, e.g. `Tesla K40m` ...