No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

eSight V300R010C00SPC200, 300, and 500 Self-Service Integration Guide 10

Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Virtual Resource Change Notification

Virtual Resource Change Notification

Message Subscription Interface

Function

This interface is used to subscribe to the virtual resource change notification based on the third-party system ID, open ID of the third-party system message receiving interface, URL of the third-party system message receiving interface, and subscription description.

URI

/rest/openapi/notification/virtual/res/event

Access Method

PUT

Parameter Description

Parameter

Mandatory/Optional

Location

Value Type

Description

openid

Mandatory

Request header parameter list

String

Indicates the session ID, which is used for Open API authentication.

NOTE:

A third-party system invokes the login interface of the security management module to obtain the value of this parameter.

systemID

Mandatory

Request entity parameter list

String

Indicates the third-party system ID.

NOTE:

The value can be an IP address of 1 to 64 characters, including digits (0-9), lowercase letters (a-z), uppercase letters (A-Z), and the following special characters: @ _ - ( ) , . ^ $ ~ ` !

openID

Mandatory

Request entity parameter list

String

Indicates the credential used by eSight to proactively connect to a third-party system, which is assigned by the third-party system.

NOTE:

The value consists of 1 to 1024 characters, including digits (0-9), lowercase letters (a-z), uppercase letters (A-Z), and the following special characters: @ _ - ( ) , . ^ $ ~ ` !

url

Mandatory

Request entity parameter list

String

Indicates the URL to which eSight sends a notification in POST mode.

NOTE:

For example, the URL can be http://10.10.10.10:8080/device. The URL correctness must be ensured by the notification subscriber. The IP address is specified in the Open API whitelist. The value consists of 1 to 1024 characters complying with the HTTP URL encoding specification.

dataType

Optional

Request entity parameter list

String

Indicates the value type of the data field in the notification.

NOTE:

Currently, only the JSON value type is supported. The default value is JSON.

desc

Optional

Request entity parameter list

String

Indicates the third-party system description.

NOTE:

The default value is null, indicating that the parameter is not specified. The value consists of 0 to 1024 characters. The character set is not restricted.

Result

Field

Value Type

Description

code

int

Indicates the operation return code. The options are as follows:

  • 0: successful
  • Others: failed. Value 1001 indicates that the license is invalid, 1002 indicates that the license cannot invoke the Open API, 1204 indicates that the authentication fails, 1501 indicates that no systemID is provided, 1502 indicates that the systemID is invalid, 1503 indicates that third-party system openID for authentication is not provided, 1504 indicates that third-party system openID for authentication is invalid, 1505 indicates that the dataType is not supported, 1506 indicates that the URL for receiving third-party messages is not provided, 1507 indicates that the URL for receiving third-party messages is invalid, 1508 indicates that the URL for receiving third-party messages is not in the Open API whitelist, 1509 indicates that the description provided is invalid, 1510 indicates that the requested resourceURI does not exist (that is, the resource corresponding to the entire request URL does not exist), and 1511 indicates that the subscription is invalid because the request URL is invalid.

data

String

The field is displayed as null.

description

String

Indicates the description of the interface invoking result.

Precautions

None

Example

Data Segment

Value

Request URL

PUT https://eSightIP: port/rest/openapi/notification/virtual/res/event HTTP/1.1

Request header

openid: 775c47f9-9a1b-43f9-a24b-2c3db1a55622;

Request entity

systemID=example%40system&openID=1b7a6992-5d5f-4091-a49f-ec2e09640a05&url=https%3A%2F%2FdemoIP%3AdemoPort%2Fnotification&dataType=JSON&desc=eSight+DesignIn+Demo

Response entity

{"code":0,"data":null,"description":"Operation success."}

Message Unsubscription Interface

Function

This interface is used to unsubscribe from the virtual resource change notification.

URI

/rest/openapi/notification/virtual/res/event

Access Method

DELETE

Parameter Description

Table 3-5 Parameter description

Parameter

Mandatory/Optional

Location

Value Type

Description

openid

Mandatory

Message header parameter list

String

Indicates the session ID, which is used for Open API authentication.

NOTE:

A third-party system invokes the login interface of the security management module to obtain the value of this parameter.

systemID

Mandatory

URL parameter list

String

Indicates the third-party system ID.

NOTE:

The value can be an IP address of 1 to 64 characters, including digits (0-9), lowercase letters (a-z), uppercase letters (A-Z), and the following special characters: @ _ - ( ) , . ^ $ ~ ` !

desc

Optional

URL parameter list

String

Indicates the third-party system description.

NOTE:

The default value is null, indicating that the parameter is not specified. The value consists of 0 to 1024 characters. The character set is not restricted.

Result

Field

Value Type

Description

code

int

Indicates the operation return code. The options are as follows:

  • 0: successful
  • Others: failed. Value 1001 indicates that the license is invalid, 1002 indicates that the license cannot invoke the Open API, 1204 indicates that the authentication fails, 1501 indicates that no systemID is provided, 1502 indicates that the systemID is invalid, and 1512 indicates that the unsubscription is invalid because the request URL is invalid.

data

String

The field is displayed as null.

description

String

Indicates the description of the interface invoking result.

Precautions

In the requests whose MIME type is application/x-www-form-urlencoded, space characters are encoded as plus signs and the plus signs are encoded as %2B.

Example

Data Segment

Value

Request URL

DELETE https://eSightIP:port/rest/openapi/notification/virtual/res/event?systemID=example%40system&desc=eSight+DesignIn+Demo+Unsubscription. HTTP/1.1

Request header

openid: 775c47f9-9a1b-43f9-a24b-2c3db1a55622;

Request entity

N/A

Response entity

{"code":0,"data":null,"description":"Operation success."}

Message Sending Interface

Message Data

Field

Value Type

Description

resourceURI

String

Indicates the resource type URI, which is the same as the URI of the message subscription interface. For change notifications, the URI has a fixed value of /rest/openapi/notification/virtual/res/event.

msgType

int

Indicates the message type. The options are as follows:

  • 1: added
  • 2: deleted
  • 3: updated

data

list

Indicates the data object that is described in JSON array. The alarm-related data structure is defined as follows:

Note:

If the message receiving address uses HTTP, the value of data is an encrypted string. The third-party system must decrypt the value using the values of KEY and IV in the configuration file and then parse the data object.

extendedData

String

Indicates the JSON extended data object represented by a character string. The value here is the null object {}.

description

String

Indicates the notification description.

timestamp

String

Indicates the timestamp when a notification is sent. The eSight server determines the value format.

The data object includes the following fields:

Field

Value Type

Description

generatedTime

String

Indicates the time when an event is generated, for example, 2017-06-26T15:45:07.501000.

resourceType

String

Indicates the resource type. The options are as follows: VM, HOST, PORT, VOLUME, HOSTNIC, and BOND.

eventType

String

Indicates the change type.

The options are as follows:

  • 1: added
  • 2: deleted
  • 3: updated

resourceDetail

Object

Indicates the resource change details (varying depending on the resource type), which is a JSON extended data object represented by a character string. The value here is the null object {}.

For VM changes, the resourceDetail field is set to the FsVmData object.

The FsVmData object includes the following fields:

Field

Value Type

Description

vmId

String

Indicates the VM ID.

systemDn

String

Indicates the DN of the OpenStack instance to which the VM belongs.

vmName

String

Indicates the VM name.

vmStatus

String

Indicates the VM current status.

projectId

String

Indicates the project ID.

domainId

String

Indicates the domain ID.

projectName

String

Indicates the project name.

domainName

String

Indicates the domain name.

description

String

Indicates the description.

vmUuid

String

Indicates the VM UUID.

ipAddrList

String

Indicates the IP address list, in which IP addresses are separated by semicolons (;).

macList

String

Indicates the MAC address list, in which MAC addresses are separated by semicolons (;).

flavorInfo

String

Indicates the VM specification.

flavorName

String

Indicates the specification name.

imageId

String

Indicates the image ID.

imageName

String

Indicates the image name.

securityGroupName

String

Indicates the security group name.

powerStatus

int

Indicates the power supply status. The options are as follows:

  • 0: unknown
  • 1: running
  • 3: stopped
  • 4: powered off
  • 6: crashed
  • 7: suspended
  • 9: creating

virtualType

String

Indicates the virtualization platform type.

createTime

long

Indicates the creation time.

azId

String

Indicates the ID of the AZ to which the VM belongs.

hostId

String

Indicates the ID of the OpenStack host to which the VM belongs.

vmGroupId

String

Indicates the VM group ID.

vmIdOnvEnv

String

Indicates the ID of the VM on the FusionCompute or vCenter platform.

mergeStatus

String

Indicates the VM status after merging. The options are as follows:

  • normal: working properly
  • poweroff: powered off
  • fault: faulty
  • other: others

volumeIdList

String

Indicates the bound volume ID list.

capacityData

CapacityData

Indicates the VM capacity.

The CapacityData object includes the following fields:

Field

Value Type

Description

cpuCores

int

Indicates the number of CPU cores.

cpuFreqsGhz

int

Indicates the CPU frequency (GHz).

memSize

int

Indicates the memory capacity (MB).

diskSize

int

Indicates the disk capacity (GB).

rootSize

int

Indicates the root disk capacity (GB).

swapSize

int

Indicates the swap disk capacity (GB).

ephemeralSize

int

Indicates the temporary disk capacity (GB).

For host resource changes, resourceDetail is set to the HostData object.

The HostData object includes the following fields:

Field

Value Type

Description

hostId

String

Indicates the host ID.

systemDn

String

Indicates the DN of the cloud platform.

physicalServerDn

String

Indicates the physical server DN.

hostName

String

Indicates the host name.

hostDesc

String

Indicates the description.

ipAddr

String

Indicates the host IP address.

bmcIp

String

Indicates the BMC IP address.

mgrIpAddr

String

Indicates the management IP address.

status

String

Indicates the initial status.

physicalCpu

int

Indicates the number of physical CPUs.

mergeStatus

String

Indicates the running status.

If the value of the request parameter systemType is FusionSphere, the options are as follows:

  • normal: working properly
  • offline: offline

If the value of the request parameter systemType is FusionCompute or vCenter Server, the options are as follows:

  • normal: working properly
  • fault: faulty
  • poweroff: powered off
  • other: others

isolationStatus

String

Indicates the isolation status.

If the value of the request parameter systemType is FusionSphere, the options are as follows:

  • isolated: isolated
  • nonisolated: not isolated

If the value of the request parameter systemType is not FusionSphere, the value is blank.

vendor

String

Indicates the server vendor.

model

String

Indicates the server model.

ntpIp1

String

Indicates IP address 1 or domain name 1 of the NTP server.

ntpIp2

String

Indicates IP address 2 or domain name 2 of the NTP server.

ntpIp3

String

Indicates IP address 3 or domain name 3 of the NTP server.

primaryDnsIp

String

Indicates the IP address of the primary DNS.

secondaryDnsIps

String

Indicates the IP address of the secondary DNS.

domainName

String

Indicates the domain name.

nicQuantity

int

Indicates the number of network adapters.

platformType

String

If the value of the request parameter systemType is FusionSphere, the options are as follows:

  • 1: FusionCompute
  • 2: KVM
  • 3: Ironic
  • 4: vCenter

If the value of the request parameter systemType is FusionCompute, the platformType field has a fixed value of FusionCompute. If the value of the request parameter is vCenter Server, the platformType field has a fixed value of vCenter Server.

fcHostExtData

FcHostExtData

Indicates the extended attribute of the FusionCompute host.

vcenterHostExtData

VcenterHostExtData

Indicates the extended attribute of the vCenter host.

fsHostExtData

FsHostExtData

Indicates the extended attribute of the FusionSphere host.

capacityData

CapacityData

Indicates the definition of the capacity data structure.

The FcHostExtData object includes the following fields:

Field

Value Type

Description

multiPathMode

String

Indicates the multipathing type set by the user.

hostMultiPathMode

String

Indicates the host multipathing type that takes effect.

ntpCycle

int

Indicates the NTP synchronization period, in seconds.

imcSetting

String

Indicates the current IMC settings.

maxImcSetting

String

Indicates the maximum IMC mode supported by the host CPU.

haState

String

Indicates the HA status.

haRole

String

Indicates the role in the HA system.

isFailOverHost

int

Indicates whether the host is specified as the failover host.

The VcenterHostExtData object includes the following fields:

Field

Value Type

Description

uuid

String

Indicates the hardware UUID.

overallStatus

String

Indicates the health status. The options are as follows:

  • green: normal
  • red: alarm
  • gray: unknown
  • yellow: warning

powerState

int

Indicates the power supply status.

bmcMacAddress

String

Indicates the BMC MAC address.

isDhcp

int

Indicates whether the DHCP mode is enabled.

osType

String

Indicates the type of the host operating system.

version

String

Indicates the host version number.

autoStartEnabled

int

Indicates whether automatic startup is enabled.

autoStartstartDelay

int

Indicates the auto-start delay.

autoStartstopAction

String

Indicates the stop action.

autoStartstopDelay

int

Indicates stopping delay.

autoStartwaitForHeartbeat

int

Indicates the heartbeat detection.

zoneName

String

Indicates the time zone name.

zonekey

String

Indicates the time zone attribute.

zonegmtOffset

int

Indicates the time zone offset.

zonedescription

String

Indicates the time zone description.

biosVersion

String

Indicates the BIOS version number.

biosReleaseDate

String

Indicates the BIOS release date.

cpuModel

String

Indicates the CPU model.

numHBAs

int

Indicates the number of HBAs.

powerCurrentPolicy

String

Indicates the current power supply policy.

powerHardwareSupport

String

Indicates the policy (power supply management technology) supported by the power.

powerSystemInfo

String

Indicates the power supply system information.

maxRunningVMs

int

Indicates the maximum number of VMs that can run concurrently.

maxSupportedVMs

int

Indicates the maximum number of supported VMs.

maxRegisteredVMs

int

Indicates the maximum number of registered VMs.

maxVcpusPerFtVm

int

Indicates the maximum number of CPUs per VM.

vmotionSupported

int

Indicates that VM migration is supported.

EvcSupported

int

Indicates that the EVC mode is supported.

The FsHostExtData object includes the following fields:

Field

Value Type

Description

hypervisorID

List

Indicates the Hypervisor ID list. IDs in the list are of the string type.

azId

String

Indicates the ID of the AZ to which the VM belongs.

hostGroupName

String

Indicates the name of the host group to which the host belongs.

clusterID

List

Indicates the cloud platform cluster ID list. IDs in the list are of the string type.

serviceStatus

String

Indicates the service status. The options are as follows:

  • up: normal
  • down: faulty

The CapacityData object includes the following fields:

Field

Value Type

Description

totalCapacity

Capacity

Indicates the host capacity.

freeCapacity

Capacity

Indicates the remaining host capacity.

vmStatistics

Statistics

Indicates the statistics of VMs deployed on the host.

The Capacity object includes the following fields:

Field

Value Type

Description

cpuCore

int

Indicates the number of CPU cores. If the return value is -1, the number of CPU cores cannot be queried.

cpuHz

int

Indicates the CPU frequency (MHz). This parameter is applicable only to FusionCompute and vCenter Server. If the return value is -1, the CPU frequency cannot be queried.

memSize

long

Indicates the memory capacity (MB). If the return value is -1, the memory capacity cannot be queried.

diskSize

long

Indicates the disk capacity (GB). This parameter is applicable only to FusionSphere. If the return value is -1, the disk capacity cannot be queried.

The Statistics object includes the following fields:

Field

Value Type

Description

total

int

Indicates the total number of VMs.

running

int

Indicates the number of VMs that are running.

fault

int

Indicates the number of faulty VMs.

poweroff

int

Indicates the number of VMs that are powered off.

other

int

Indicates the number of VMs in other states.

For virtual disk changes, resourceDetail is set to the VolumeData object.

The VolumeData object includes the following fields:

Field

Value Type

Description

vDiskId

string

Indicates the disk volume ID.

systemDn

string

Indicates the DN of the cloud platform.

name

String

Indicates the volume name.

status

String

Indicates the source volume status.

quantitySize

int

Indicates the maximum volume capacity (GB).

isBindtoVm

int

Indicates the volume binding status. The options are as follows:

  • 0: not bound
  • 1: bound

bindToVmIdList

String

Indicates the bound VM ID list, in which IDs are separated by semicolons (;).

srcVolumeUrn

String

Indicates the source volume ID.

description

String

Indicates the volume description.

shareType

String

Indicates the volume sharing type.

uuid

String

Indicates the volume UUID.

mergeStatus

String

Indicates the volume status after merging. The options are as follows:

  • available: available
  • used: used
  • fault: faulty
  • changing: performing the operation
  • removed: removed

projectId

String

Indicates the project ID.

domainId

String

Indicates the domain ID.

projectName

String

Indicates the project name.

domainName

String

Indicates the domain name.

azName

String

Indicates the AZ name.

snapshotId

String

Indicates the volume snapshot ID.

createdAt

long

Indicates the creation time (ms, UTC time).

updatedAt

long

Indicates the update time (ms, UTC time).

hostId

String

Indicates the ID of the host where the volume is located.

vDiskTypeId

String

Indicates the type ID of the disk to which the volume belongs.

lunId

String

Indicates the storage device LUN ID.

For virtual port changes, resourceDetail is set to the VnicData object.

The VnicData object includes the following fields:

Field

Value Type

Description

vNicId

String

Indicates the virtual port ID.

systemDn

String

Indicates the DN of the cloud platform.

name

String

Indicates the port name.

status

String

Indicates the status. The options are as follows:

  • ACTIVE: working properly
  • BUILD: building
  • DOWN: stopped
  • ERROR: error
  • REBUILD: rebuilding
  • N/A: unknown

adminStateUp

String

Indicates the management status. The options are as follows:

  • true
  • false

vifType

String

Indicates the type of which mechanism is used for the port.

macAddress

String

Indicates the MAC address list, in which MAC addresses are separated by semicolons (;).

description

String

Indicates the description.

networkId

String

Indicates the virtual network ID.

hostId

String

Indicates the host ID.

deviceId

String

Indicates the ID of the mounted device. If a VM is associated, the value is the VM UUID.

deviceOwner

String

Indicates the entity type that uses this port.

ipAddress

String

Indicates the IP address list, in which IP addresses are separated by semicolons (;).

projectId

String

Indicates the tenant ID.

pNicId

String

If the host port type is pNic, the value is the host port ID.

If the host port type is bond, the value is the bond name.

pNicType

String

Indicates the host port type. The options are as follows:

  • pNic: physical network port
  • bond: bond

overlayType

String

Indicates whether the scenario is a hybrid overlay scenario. If yes, the vSwitch type is CE1800V. The options are as follows:

  • Hybrid: hybrid overlay scenario
  • Others: not hybrid overlay scenario

createTime

long

Indicates the creation time (ms, UTC time).

updateTime

long

Indicates the update time (ms, UTC time).

For changes of the host physical network ports, resourceDetail is set to the PnicData object.

The PnicData object includes the following fields:

Field

Value Type

Description

pNicId

String

Indicates the ID of the host physical network port.

systemDn

String

Indicates the DN of the cloud platform.

name

String

Indicates the port name.

hostId

String

Indicates the host ID.

devName

String

Indicates the device name.

permanentMac

String

Indicates the MAC address.

description

String

Indicates the description.

bondName

String

Indicates the bond name.

mappingType

String

Indicates the mapping type. The options are as follows:

  • sr-iov: single-root I/O virtualization
  • kernel-ovs: kernel-mode OVS softswitch
  • user-evs: user-mode EVS softswitch
  • user-ovs: user-mode OVS softswitch
  • linux: Linux bridge
  • hw-ovs: hardware acceleration user-mode OVS softswitch
  • hw-evs: hardware acceleration user-mode EVS softswitch

physicalNetworkName

String

Indicates the physical network name.

status

String

Indicates the port status. The options are as follows:

  • UP
  • DOWN

speed

String

Indicates the rate.

For changes of the host trunk interface, resourceDetail is set to the BondData object.

The BondData object includes the following fields:

Field

Value Type

Description

systemDn

String

Indicates the DN of the cloud platform.

name

String

Indicates the bond name.

hostId

String

Indicates the host ID.

mode

String

Indicates the work mode. The options are as follows:

  • nobond: active/standby mode
  • active-standby: active/standby mode, which is the same as nobond
  • lacp: load balancing mode. l2_smac: load balancing mode based on the source MAC address. This option supports only the ovs mode.

pNicName

String

Indicates the active physical network port name.

If the active/standby mode is adopted, the value of this parameter should be the name of the active port.

If the LACP mode is adopted, the value should be left empty.

macAddress

String

Indicates the MAC address.

status

String

Indicates the status. The options are as follows:

  • UP
  • DOWN

mappingType

String

Indicates the mapping type. The options are as follows:

  • sr-iov: single-root I/O virtualization
  • kernel-ovs: kernel-mode OVS softswitch
  • user-evs: user-mode EVS softswitch
  • user-ovs: user-mode OVS softswitch
  • linux: Linux bridge
  • hw-ovs: hardware acceleration user-mode OVS softswitch
  • hw-evs: hardware acceleration user-mode EVS softswitch

physicalNetworkName

String

Indicates the physical network name.

Precautions

  • Currently, only change notifications of the following FusionSphere resources are supported: virtual resource hosts, VMs, virtual ports, virtual disks, host physical network ports, and host trunk interfaces.
  • The following VM fields can be changed: vmName, vmStatus, powerStatus, hostId, mergeStatus, cpuCores, memSize, diskSize, rootSize, swapSize, ephemeralSize, flavorInfo, and flavorName.
  • The following host fields can be changed: mergeStatus and status.
  • The following field of host physical network ports can be changed: status.
  • The following bond fields can be changed: status and macAddress.
  • The following fields of virtual disks can be changed: name, status, quantitySize, isBindtoVm, and bindToVmIdList.
  • The following fields of virtual ports can be changed: name, deviceId, deviceOwner, hostId, and vifType.
  • After receiving a message indicating that a VM is created, the third-party system needs to query the information about the VM, virtual ports, and virtual disks.

Example

The notification is sent in POST mode, and all notification data is saved in the body of the HTTP packet. Assume that the third-party system WebService provides the implementation request instance of javax.servlet.http.HttpServletRequest. The following message data can be obtained:

Invoking Method

Obtained Value

request.getParameter("resourceURI")

"/rest/openapi/notification/virtual/res/event"

request.getParameter("msgType")

1

request.getParameter("data")

"[{}]"

request.getParameter("description")

""

request.getParameter("timestamp")

"2016-11-26 17:44:20"

request.getParameter("extendedData")

"{}"

VM change message example:

{
"timestamp":"2017-07-06 21:02:20",
"extendedData":{

},
"resourceURI":"/rest/openapi/notification/virtual/res/event",
"description":"Virtual Resource notification.",
"data":[
{
"eventType":3,
"resourceType":"VM",
"resourceDetail":{
"vmId":"584d4232-91a0-4493-aff2-f9d2e76b211d",
"systemDn":"NE=34605412",
"vmName":"VM002",
"vmStatus":"ACTIVE",
"projectId":"9e97ce0119784a8890bfb86f8d8fc0ad",
"domainId":"default",
"projectName":"dc_system_dc1",
"domainName":"Default",
"description":null,
"vmUuid":"584d4232-91a0-4493-aff2-f9d2e76b211d",
"ipAddrList":"42.137.0.68;41.137.0.87",
"macList":"fa:16:3e:e6:5d:5e;fa:16:3e:59:ab:0e",
"flavorInfo":"1.00 MB-1.00 GB",
"flavorName":"l",
"imageId":"e09f62fb-ee85-4a8c-86cd-2beeb0f046a5",
"imageName":"test_image",
"securityGroupName":"ae793345_5655_485e_8933_fe0a4d863c13;ae793345_5655_485e_8933_fe0a4d863c13",
"powerStatus":0,
"virtualType":"KVM",
"createTime":1499935410000,
"azId":"az1.dc1",
"hostId":"602DD764-8145-E611-893E-75C951100860",
"vmGroupId" : "25baa427-9c35-47d7-b3d9-7ba2022bd209",
"vmIdOnvEnv":null,
"mergeStatus":"normal",
"volumeIdList":"",
"capacityData":{
"cpuCores":1,
"cpuFreqsGhz":0,
"memSize":512,
"diskSize":1,
"rootSize":1,
"swapSize":0,
"ephemeralSize":0
}
}
}
],
"msgType":1
}

Host change message example:

{
"timestamp":"2017-07-06 21:02:20",
"extendedData":{

},
"resourceURI":"/rest/openapi/notification/virtual/res/event",
"description":"Virtual Resource notification.",
"data":[
{
"eventType":3,
"resourceType":"HOST",
"resourceDetail":{
"hostId":"C0CFC3E4-465D-E511-8926-F40125E894D4",
"systemDn":"NE=34605909",
"physicalServerDn":null,
"hostName":"C0CFC3E4-465D-E511-8926-F40125E894D4",
"hostDesc":null,
"ipAddr":"172.28.0.3",
"bmcIp":"10.137.62.255",
"mgrIpAddr" : "192.168.16.213",
"status":"up",
"mergeStatus":"normal",
"isolationStatus" : "nonisolated",
"vendor":null,
"model":null,
"ntpIp1":null,
"ntpIp2":null,
"ntpIp3":null,
"primaryDnsIp":null,
"secondaryDnsIps":null,
"domainName":null,
"nicQuantity":0,
"physicalCpu":4,
"platformType":"KVM",
"fcHostExtData":null,
"vcenterHostExtData":null,
"fsHostExtData":{
"hostGroupName":null,
"serviceStatus":"down",
"azId":"az1.dc1",
"hypervisorID": ["1"],
"clusterID": []
},
"capacityData":{
"totalCapacity":{
"cpuCore":62,
"cpuHz":-1,
"memSize":65350,
"diskSize":2
},
"freeCapacity":{
"cpuCore":-1,
"cpuHz":-1,
"memSize":-1,
"diskSize":-1
},
"vmStatistics":{
"total":4,
"running":4,
"fault":0,
"poweroff":0,
"other":0
}
}
}
}
],
"msgType":1
}

Message example of virtual disk changes:

{
"timestamp":"2017-07-06 21:02:20",
"extendedData":{

},
"resourceURI":"/rest/openapi/notification/virtual/res/event",
"description":"Virtual Resource notification.",
"data":[
{
"eventType":3,
"resourceType":"VOLUME",
"resourceDetail":{
"vDiskId": "3d43f0e1-2beb-4c53-b428-105eb4899281",
"systemDn": "NE=34604315",
"name": "EVSin_WLT-volume-7d49",
"status": "in-use",
"quantitySize": 100,
"isBindtoVm": 1,
"bindToVmIdList": "b486c594-ef5c-4df3-b73f-df74f0d8e4af",
"srcVolumeUrn": null,
"description": null,
"shareType": "false",
"uuid": "3d43f0e1-2beb-4c53-b428-105eb4899281",
"mergeStatus": "used",
"projectId": "caf24fd36c74495e9ccc9db716de3831",
"domainId": "default",
"projectName": "vdc_WLT3",
"domainName": "Default",
"azName": "az1.dc3",
"snapshotId": null,
"createdAt": 1510539664000,
"updatedAt": 1510539754000,
"hostId": "cinder@ipsan1#StoragePool008",
"vDiskTypeId": "e89d2a47-46d1-4c1e-9d93-2df49f474d0b",
"lunId": "74495caf2c9db7cce38311g46d4fd36c"
}
}
],
"msgType":1
}

Message example of virtual port changes:

{
"timestamp":"2017-07-06 21:02:20",
"extendedData":{

},
"resourceURI":"/rest/openapi/notification/virtual/res/event",
"description":"Virtual Resource notification.",
"data":[
{
"eventType":3,
"resourceType":"PORT",
"resourceDetail":{
"vNicId": "291f77a5-d738-4aa4-817f-9547a293eab6",
"systemDn": "NE=34603013",
"name": "",
"status": "ACTIVE",
"adminStateUp": "true",
"vifType": "ovs",
"macAddress": "fa:16:3e:d6:fb:ed",
"description": "",
"networkId": "0941d81c-a94d-4d11-a731-fa5d8bfd6b4c",
"hostId": "0FAD8A38-98F0-F794-E611-D7D4ACE5C338",
"deviceId": "9a8c3c45-839f-4f29-945f-7b03078474a2",
"deviceOwner": "compute:az1.dc1",
"ipAddress": "192.168.123.75",
"projectId": "caf24fd36c74495e9ccc9db716de3831",
"pNicId": "trunk0",
"pNicType": "bond",
"overlayType": "Hybrid",
"createTime": 1512725375000,
"updateTime": 1521531561000
}
}
],
"msgType":1
}

Message example of host physical network port changes:

{
"timestamp":"2017-07-06 21:02:20",
"extendedData":{

},
"resourceURI":"/rest/openapi/notification/virtual/res/event",
"description":"Virtual Resource notification.",
"data":[
{
"eventType": 3,
"resourceType": "HOSTNIC",
"resourceDetail": {
"portId": "eth0",
"systemDn": "NE=34603009",
"name": "nic0",
"hostId": "0DAD8A38-98F0-B3A3-E611-D7D42A431615",
"devName": "eth0",
"permanentMac": "48:7B:6B:DA:36:1E",
"description": "Emulex Corporation OneConnect NIC (Lancer)",
"bondName": "trunk0",
"mappingType": "ovs",
"providerPhysicalNetwork": "physnet1",
"status": "UP",
"speed": "10000Mbps"
}
}
],
"msgType":3
}

Message example of bond changes:

{
"timestamp":"2017-07-06 21:02:20",
"extendedData":{

},
"resourceURI":"/rest/openapi/notification/virtual/res/event",
"description":"Virtual Resource notification.",
"data":[
{
"eventType": 3,
"resourceType": "BOND",
"resourceDetail": {
"systemDn": "NE=34603009",
"name": "trunk0",
"hostId": "0DAD8A38-98F0-B3A3-E611-D7D42A431615",
"mode": "nobond",
"macAddress": "48:7B:6B:DA:36:1E",
"status": "UP",
"mappingType": "ovs",
"providerPhysicalNetwork": "physnet1",
"pnicName": "nic0"
}
}
],
"msgType":3
}

The value null indicates that the actual value of an attribute is empty.

Translation
Download
Updated: 2019-10-30

Document ID: EDOC1100044386

Views: 15673

Downloads: 83

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next