Skip to main content
API Explorer|API Explorer
Compute Management/Host Related Interfaces/PCI Device Related APIs
POSTPCI Device Related APIsSince 0.6SynchronousAuth Required

Create PCI Device Offering

Create PCI Device Offering

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

This API requires no request parameters.

Responses

200 OK

On success, this API returns the following response structure.

  • successbooleanRequired

    操作是否成功。

  • errorErrorCodeRequired

    Error code. If not null, the operation failed. This field is null when the operation succeeds. See error

    • codeStringRequired

      Error code, a globally unique identifier of the error, e.g. SYS.1000, HOST.1001

    • descriptionStringRequired

      Brief description of the error

    • detailsStringRequired

      Detailed error information

    • elaborationStringRequired

      Reserved field, defaults to null

    • opaqueLinkedHashMapRequired

      Reserved field, defaults to null

    • causeErrorCodeRequired

      Root cause, the source error that caused the current error, null if no original error

  • inventoryPciDeviceOfferingInventoryRequired

    See inventory

    • uuidStringRequired

      UUID of the resource, uniquely identifies the resource

    • nameStringRequired

      Resource name

    • descriptionStringRequired

      Resource description

    • vendorIdStringRequired

      Vendor ID

    • deviceIdStringRequired

      Device ID

    • subvendorIdStringRequired

      Sub-vendor ID

    • subdeviceIdStringRequired

      Sub-device ID

    • ramSizeStringRequired

      GPU memory capacity

    • createDateTimestampRequired

      Create date

    • lastOpDateTimestampRequired

      Last update date

    • typePciDeviceOfferingTypeRequired

      See type

      • GPU_VideoPciDeviceOfferingTypeRequired

        GPU video

      • GPU_AudioPciDeviceOfferingTypeRequired

        GPU audio

      • GenericPciDeviceOfferingTypeRequired

        Generic device

    • attachedInstanceOfferingsListRequired

      See attachedInstanceOfferings

      • idlongRequired

        资源ID。

      • instanceOfferingUuidStringRequired

        Compute offering UUID

      • pciDeviceOfferingUuidStringRequired

        No description provided.

      • pciDeviceCountIntegerRequired

        pci设备数量。

      • metadataPciDeviceMetaDataRequired

        See metadata

        • metaDataStringRequired

          元数据。

        • metaDataEntriesListRequired

          See metaDataEntries

          • keyStringRequired

            Key

          • valueStringRequired

            Value

          • opPciDeviceMetaDataOperatorRequired

            See op

            • EqualPciDeviceMetaDataOperatorRequired

              Equal

            • UnequalPciDeviceMetaDataOperatorRequired

              Unequal

    • matchedPciDevicesListRequired

      See matchedPciDevices

      • pciDeviceUuidStringRequired

        No description provided.

      • pciDeviceOfferingUuidStringRequired

        No description provided.

Endpoint

POST/zstack/v1/pci-device/pci-device-offerings

/zstack/v1/pci-device/pci-device-offerings

Operation ID

CreatePciDeviceOffering

Permalink

Request Example

curl -X POST 'http://{host}/zstack/v1/pci-device/pci-device-offerings' -H 'Authorization: OAuth {sessionUuid}'

Response Example

200
{ "inventory": { "type": "GPU_Video", "vendorId": "10de", "deviceId": "0e0f", "subvendorId": "10de", "subdeviceId": "118b" } }

Change History

This API has no change history records yet.

View all change history