Silently adding an extra resource and potentially creating a new service definition

If you want assign an extra resource to a booking, regardless of whether it is already running or not, this may not be possible in the usual way if the selected service definition does not have any free nodes.

In that case, you can use the AddResource and TryAddResource methods to add the resource anyway. With these methods, DataMiner SRM will first try to find a compatible free node in the service definition. If no such node is found, it will search for a compatible service definition and update the booking accordingly. If no compatible service definitions are found, it will create a new service definition and assign it to the booking.

The methods use the node label to identify a node in the service definition.

Here is a code sample:

using System;
using Skyline.DataMiner.Automation;
using Skyline.DataMiner.Core.SRM;
using Skyline.DataMiner.Core.SRM.Extensions.Reservations;

public class Script
{
   public void Run(Engine engine)
   {
      // Update with relevant data
      var reservationGuid = Guid.NewGuid();
      var resourceGuid = Guid.NewGuid();
      var nodeLabel = "Decoder";

      var reservation = SrmManagers.ResourceManager.GetReservationInstance(reservationGuid);
      var bookingManager = reservation.FindBookingManager();

      bookingManager.TryAddResource(engine, ref reservation, resourceGuid, nodeLabel);

      // Example of passing a service definition template as an extra parameter to the TryAddResource method
      var existingServiceDefinitionGuid = Guid.Parse(engine.GetScriptParam("ServiceDefinitionGuid").Value);
      bookingManager.TryAddResource(engine, ref reservation, resourceGuid, nodeLabel, existingServiceDefinitionGuid);
   }
}

Note

In case a service definition needs to be created, it will not be a template.
In case no label is provided, SRM will try to identify a free node based on function type.
In case a free and compatible node is found, but it has a non-matching label, that node will be picked.
In case no label is provided and a new service definition needs to be created, the function name will be used as the label.
From SRM 1.2.33 onwards, it is possible to pass the desired service definition as a parameter to the AddResource and TryAddResource methods. From SRM 1.2.35 onwards, you need to make sure that the passed service definition is compatible with the booking and contains a node with the provided label, as otherwise undesired behavior may occur.

Table of Contents

Silently adding an extra resource and potentially creating a new service definition

Note