/**
  * Updates an existing permission item object.
  * This action is available only to Kaltura system administrators.
  * 
  * @action update
  * @param int $permissionItemId The permission item's unique identifier
  * @param KalturaPermissionItem $permissionItem The updated permission item parameters
  * @return KalturaPermissionItem The updated permission item object
  *
  * @throws KalturaErrors::INVALID_OBJECT_ID
  */
 public function updateAction($permissionItemId, KalturaPermissionItem $permissionItem)
 {
     $dbPermissionItem = PermissionItemPeer::retrieveByPK($permissionItemId);
     if (!$dbPermissionItem) {
         throw new KalturaAPIException(KalturaErrors::INVALID_OBJECT_ID, $permissionItemId);
     }
     $dbPermissionItem = $permissionItem->toUpdatableObject($dbPermissionItem, array('type'));
     $dbPermissionItem->save();
     $permissionItem = new KalturaPermissionItem();
     $permissionItem->fromObject($dbPermissionItem);
     return $permissionItem;
 }