<PackageReference Include="Relativity.Server.Testing.Framework.Api.SDK" Version="10.3.0" />

IInstanceSettingsService

public interface IInstanceSettingsService
Represents the instance settings API service.
void AddValue(string name, string section, string value, string delimiter)

Adds a value to an existing [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html).

InstanceSetting Create(InstanceSetting entity)

Creates the specified [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html).

void Delete(int id)

Deletes the [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html) by ArtifactId.

InstanceSetting Get(int id)

Gets the instance settings by the specified ID.

InstanceSetting Get(string name, string section)

Gets the instance setting by the specified name and section.

InstanceSetting Require(InstanceSetting entity)

Creates the specified [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html) if it does not exist.

If it does exist, it will be updated instead.

If [ArtifactID](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.Artifact.html#Relativity_Testing_Framework_Models_Artifact_ArtifactID) property of entity has positive value, gets entity by ID and returns it.If [Name](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.NamedArtifact.html#Relativity_Testing_Framework_Models_NamedArtifact_Name) and [InstanceSetting.Section](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html#Relativity_Testing_Framework_Models_InstanceSetting_Section) properties of entity have a value, gets entity by name and returns it if it exists.Otherwise creates a new entity using [ICreateStrategy<T>](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Strategies.ICreateStrategy-1.html).

InstanceSetting Require(string name, string section, string value)

Creates the specified [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html) if it does not exist.

The instance setting will be looked up by name and section. If it does exist, it will be updated instead.

void RequireContainsValue(string name, string section, string value, string delimiter)

Ensures that the value exists in the [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html) with the passed in name and section.

void RequireNotContainsValue(string name, string section, string value, string delimiter)

Ensures that the value does not exist in the [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html) with the passed in name and section.

If the value of the instance setting is an exact match, the entire instance setting will be deleted.

Otherwise, the value will just be removed from the delimited string.

void Update(InstanceSetting entity)

Updates the [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html) by specified entity.

If specified, the ArtifactId on the model will be used to locate the InstanceSetting.

Otherwise, the InstanceSetting will be looked up by Name and Section.

void UpdateValue(string name, string section, string value)

Updates value of an existing [InstanceSetting](https://relativitydev.github.io/relativity.testing.framework/api/Relativity.Testing.Framework.Models.InstanceSetting.html).