vCenter:Get Vcenter

Search (SHIFT+S)



Get Vcenter

GET /compute/vcenters/{id}

Shows the information for one vCenter server.

idthe URN of a ViPR vCenter

Required Roles

This call has no restrictions.


Response Body

All non-null attributes of the vCenter.

Field Description Type Notes
<vcenter>
<user_name> The login account name String
<ip_address> The vCenter server management IP address String
<port_number> The vCenter server management port Integer
<use_ssl> A flag which indicates whether SSL should be used when communicating with the vCenter Boolean Valid Values:
  •  true = use SSL
  •  false = do not use SSL
<os_version> The operating system version of the vcenter. String
<tenant>     Valid Values:
  •  String
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</tenant>      
<last_discovery_status_message> The last discovery status message for this system String
<system_type> A short mnemonic that indicates what kind of system is being represented String Valid Values:
  •  brocade
  •  isilon
  •  netapp
  •  mds = Cisco MDS series switch
  •  rp = RecoverPoint
  •  vmax
  •  vnxblock
  •  vnxfile
  •  vplex
<job_discovery_status> The status of the last discovery job for this system String Valid Values:
  •  CREATED
  •  IN_PROGRESS
  •  COMPLETE
  •  ERROR
<last_discovery_run_time> The timestamp for the last discovery job for this system Long
<last_metering_run_time> The timestamp for the last metric collection job for this system Long
<job_metering_status> The status of the last metric collection job for this system String Valid Values:
  •  CREATED
  •  IN_PROGRESS
  •  COMPLETE
  •  ERROR
<next_discovery_run_time> The timestamp for the next scheduled discovery job for this system Long
<next_metering_run_time> The timestamp for the next scheduled metric collection job for this system Long
<success_discovery_time> The latest timestamp when the system run Discovery successfully Long
<success_metering_time> The latest timestamp when the system run Metering successfully Long
<registration_status> Whether or not the system is registered with ViPR. A system must be registered before it can be managed by ViPR. String Valid Values:
  •  REGISTERED
  •  UNREGISTERED
<compatibility_status> Whether or not this system is compatible with ViPR String Valid Values:
  •  COMPATIBLE
  •  INCOMPATIBLE
  •  UNKNOWN
<native_guid> The native unique identifier for this resource

Network Transport Types:

  • FC = Fibre-Channel

Network System Types:

  • BROCADE
  • MDS

Storage System Types:

  • CELERRA = VNX File
  • CLARIION = VNX Block
  • ISILON
  • NETAPP
  • SYMMETRIX
String Valid Values:
  •  Network : transport-type+network-system-type+fabric-WWN
  •  NetworkSystem: network-system-type+management-IP-address+management-port
  •  StoragePool : storage-system-type+storage-system-serial-number+POOL+pool-native-id
  •  StoragePort : storage-system-type+storage-system-serial-number+PORT+port-network-id
  •  StorageSystem: storage-system-type+serial-number
  •  StorageTier, Auto-Tiering: storage-system-type+storage-system-serial-number+FASTPOLICY+policy-name
  •  StorageTier, VMAX: storage-system-type+storage-system-serial-number+TIER+tier-name
  •  StorageTier, VNX: storage-system-type+storage-system-serial-number+TIER+pool-name+tier-name
<name> The name assigned to this resource in ViPR. The resource name is set by a user and can be changed at any time. It is not a unique identifier. String
<id> An identifier that is generated by ViPR when the resource is created. The resource ID is guaranteed to be unique and immutable across all virtual data centers for all time. URI Valid Values:
  •  urn:storageos:resource-type:UUID:
<link> A hyperlink to the details for this resource
<creation_time> A timestamp that shows when this resource was created in ViPR DateTime Valid Values:
  •  YYYY-MM-DDTHH:mm:ssZ
<tags> Keywords and labels that can be added by a user to a resource to make it easy to find when doing a search.
<tag> String 0-* Elements
</tags>
<inactive> Whether or not the resource is inactive. When a user removes a resource, the resource is put in this state before it is removed from the ViPR database. Boolean Valid Values:
  •  true
  •  false
<global> Boolean
<remote> Boolean
<vdc>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</vdc>      
<internal> Whether or not the resource is an internal resource. Boolean Valid Values:
  •  true
  •  false
</vcenter>
Notes: