Class XperiflowTimeSeriesForecastingClient
Namespace: Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting
Assembly: Xperiflow.dll
public class XperiflowTimeSeriesForecastingClient : IXperiflowTimeSeriesForecastingClient
Implements: Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.IXperiflowTimeSeriesForecastingClient
Properties
JsonSerializerSettings
protected JsonSerializerSettings JsonSerializerSettings { get; }
ReadResponseAsString
public bool ReadResponseAsString { get; set; }
Methods
GetAggregationTypeOptionsResourceAsync(XperiflowSessionInfo, MemoizedCacheInfo?, CancellationToken)
AggregationTypeOptionsResource
public virtual Task<GetAggregationTypeOptionsResourceContext> GetAggregationTypeOptionsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a list of acceptable options for the AggregationType_ enum located in the processing directory.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetAggregationTypeOptionsResourceContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFrequencyOverrideOptionsResourceAsync(XperiflowSessionInfo, MemoizedCacheInfo?, CancellationToken)
FrequencyOverridesOptionsResource
public virtual Task<GetFrequencyOverrideOptionsResourceContext> GetFrequencyOverrideOptionsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a list of acceptable options for the FrequencyOverrides_ enum located in the shared directory.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetMlTypeOptionsResourceAsync(XperiflowSessionInfo, MemoizedCacheInfo?, CancellationToken)
MLTypeOptionsResource
public virtual Task<GetMlTypeOptionsResourceContext> GetMlTypeOptionsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a list of acceptable options for the MLType_ enum located in the shared directory.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetMlTypeOptionsResourceContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetTuningStrategiesResourceAsync(XperiflowSessionInfo, MemoizedCacheInfo?, CancellationToken)
TuningStrategiesResource
public virtual Task<GetTuningStrategiesResourceResponseContext> GetTuningStrategiesResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve the available hyperparameter tuning strategies found in XperiFlow.
Possible status codes: 200, 500
Returns:
-
query_status (Dict)
-
If query was successful.
-
strategies (List/[str/])
-
A list of allowed hyperparameter tuning strategies
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetModelCollectionResourceAsync(XperiflowSessionInfo, string?, MemoizedCacheInfo?, CancellationToken)
ModelCollectionResource
public virtual Task<GetModelCollectionResourceResponseContext> GetModelCollectionResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, string? query = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a list of all Xperiflow models
Query Parameters
-
query (optional/[str/]): Pinq query filter expression * alias: str
-
name of metric
-
opttype: maximize, minimize
-
the way this metric is optimized
-
valuetype: percent, raw, log, squared, logsquared
-
the type of value this metric represents
-
aggregationtype: sum, mean, median
-
how this metric is aggregated
-
rangetype: upper_bounded, lower_bounded, unbounded, bounded
-
the range this metric can take on
-
bias: bool
-
whether the metric is dealing with magnitude of error, or sums together positive and negative errors (is biased)
-
common: bool
-
is this a common well known metric
-
goal: float
-
the optimal value for this metric
-
allowed_as_evaluation_metric: bool
-
can this metric be used as the evaluation metric
Returns
- collection (List/[Dict/[str, Any/]/]): Each dictionary will be a model including the name, parent class, and all class attributes of the model.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetModelCollectionResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.String | query | A pinq query string. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetMetricCollectionResourceAsync(XperiflowSessionInfo, string?, MemoizedCacheInfo?, CancellationToken)
MetricCollectionResource
public virtual Task<GetMetricCollectionResourceResponseContext> GetMetricCollectionResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, string? query = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a collection of all metrics.
Query Parameters
- query (Optional/[str/]): Pinq query filter expression
Returns
- collection (List/[Dict/[str, Any/]/]): Each dictionary will be a metric including the name, parent class, and all class attributes of the metric.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.String | query | A pinq query string. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetTransformerCollectionResourceAsync(XperiflowSessionInfo, int, string?, MemoizedCacheInfo?, CancellationToken)
TransformerCollectionResource
public virtual Task<GetTransformerCollectionResourceResponseContext> GetTransformerCollectionResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, string? query = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a collection of all transformers.
Query Parameters
- query (Optional/[str/]): Pinq query filter expression
Returns
- collection (List/[Dict/[str, Any/]/]): Each dictionary will be a transformer including the name, parent class, and all class attributes of the transformer.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.String | query | A pinq query string. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetSelectionAlgorithmCollectionResourceAsync(XperiflowSessionInfo, int, string?, MemoizedCacheInfo?, CancellationToken)
SelectionAlgorithmCollectionResource
public virtual Task<GetSelectionAlgorithmCollectionResourceResponseContext> GetSelectionAlgorithmCollectionResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, string? query = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns a list of all selection algorithms
Query Parameters
- query (optional/[str/]): Pinq query filter expression
Returns
- collection (List/[Dict/[str, Any/]/]): Each dictionary will be an algorithm including the name, parent class, and all class attributes of the algorithm.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.String | query | A pinq query string. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostBuildInfoAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo, int, int, IntItemsIdentifierContext, MemoizedCacheInfo?, CancellationToken)
BuildInfoAssignmentsGeneratorsResource
public virtual Task<NullDataXperiflowResponseContext> PostBuildInfoAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IntItemsIdentifierContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Set event and location IDs for a given top level xperimentbuild ID. This should be done at the target (not group) level.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.IntItemsIdentifierContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeletePipelineConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
PipelineConfigResource
public virtual Task<NullDataXperiflowResponseContext> DeletePipelineConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Resets all PPO Configs under the provided BuildInfo unique identifier to use Auto Modeling.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostBuildInfoAssignmentsLocationsResourceAsync(XperiflowSessionInfo, int, int, IntItemsIdentifierContext, MemoizedCacheInfo?, CancellationToken)
BuildInfoAssignmentsLocationsResource
public virtual Task<NullDataXperiflowResponseContext> PostBuildInfoAssignmentsLocationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IntItemsIdentifierContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Set location IDs for all target level xperimentbuilds for the given buildinfo.
Body Parameters: - location_ids: List[str] (guid)
- List of location IDs to assign to the xperimentbuild_id
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.IntItemsIdentifierContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoAssignmentsGeneratorsLocationsResourceAsync(XperiflowSessionInfo, int, int, IEnumerable<string>?, string?, int?, int?, string?, MemoizedCacheInfo?, CancellationToken)
BuildInfoAssignmentsGeneratorsLocationsResource
public virtual Task<GetBuildInfoAssignmentsGeneratorsLocationsResourceResponseContext> GetBuildInfoAssignmentsGeneratorsLocationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve Number of Events and Locations assigned to target level xperimentbuild ids for a given buildinfo id.
Returns:
-
filterable_data (paged DatatableContext): Count of Generators and Locations assigned to each target level xperimentbuild id.
Columns are: XperimentBuildID, Name, Summation, GeneratorCount, LocationCount
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetXperimentBuildAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo, int, int, IEnumerable<string>?, string?, int?, int?, string?, MemoizedCacheInfo?, CancellationToken)
XperimentBuildAssignmentsGeneratorsResource
public virtual Task<GetXperimentBuildAssignmentsGeneratorsResourceResponseContext> GetXperimentBuildAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int xperimentbuild_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve Generators and their assignment status for a given target level xperimentbuild ID.
Returns: - QueryPaginationDataTableResponseContext
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | xperimentbuild_id | the unique identifier associated with the xperimentbuild. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutXperimentBuildAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo, int, int, IntItemsIdentifierContext, MemoizedCacheInfo?, CancellationToken)
XperimentBuildAssignmentsGeneratorsResource
public virtual Task<NullDataXperiflowResponseContext> PutXperimentBuildAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int xperimentbuild_id, IntItemsIdentifierContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Set generator config IDs for a given target level xperimentbuild ID. This should be done at the target (not group) level.
Body Parameters:
- xperimentbuild_id: int - The target level xperimentbuild ID to set generators for - item_ids: List[int] - List of event
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | xperimentbuild_id | the unique identifier associated with the xperimentbuild. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.IntItemsIdentifierContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutXperimentBuildsAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo, int, int, BodyXperimentBuildsAssignmentsGeneratorsDto, MemoizedCacheInfo?, CancellationToken)
XperimentBuildsAssignmentsGeneratorsResource
public virtual Task<NullDataXperiflowResponseContext> PutXperimentBuildsAssignmentsGeneratorsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyXperimentBuildsAssignmentsGeneratorsDto body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Applies multiple generators or events to multiple xperiment builds.
Body Params:
-
project_id (str
{guid}
): The project unique identifier -
buildinfo_id (str
{guid}
): The build info unique identifier to commit the provided datasource to.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyXperimentBuildsAssignmentsGeneratorsDto | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetXperimentBuildAssignmentsLocationsResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
XperimentBuildAssignmentsLocationsResource
public virtual Task<GetXperimentBuildAssignmentsLocationsResourceResponseContext> GetXperimentBuildAssignmentsLocationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int xperimentbuild_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve Locations assigned to a given target level xperimentbuild ID.
Returns:
- locations_df (DatatableContext): Available locations to assign to the given target level xperimentbuild - locations_assigned_df (DatatableContext): Locations assigned to the given target level xperimentbuild
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | xperimentbuild_id | the unique identifier associated with the xperimentbuild. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostXperimentBuildAssignmentsLocationsResourceAsync(XperiflowSessionInfo, int, int, IntItemsIdentifierContext, MemoizedCacheInfo?, CancellationToken)
XperimentBuildAssignmentsLocationsResource
public virtual Task<NullDataXperiflowResponseContext> PostXperimentBuildAssignmentsLocationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int xperimentbuild_id, IntItemsIdentifierContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Set location IDs for a given target level xperimentbuild ID.
Body Parameters: - xperimentbuild_id: int The target level xperimentbuild ID to set locations for - location_ids: List[int] List of location IDs to assign to the xperimentbuild_id
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | xperimentbuild_id | the unique identifier associated with the xperimentbuild. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.IntItemsIdentifierContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutXperimentBuildsAssignmentsLocationsResourceAsync(XperiflowSessionInfo, int, int, BodyXperimentBuildsAssingmentsLocationsDto, MemoizedCacheInfo?, CancellationToken)
XperimentBuildsAssignmentsLocationsResource
public virtual Task<NullDataXperiflowResponseContext> PutXperimentBuildsAssignmentsLocationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyXperimentBuildsAssingmentsLocationsDto body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Set location IDs for a given target level xperimentbuild ID.
Body Parameters: - xperimentbuild_id: int The target level xperimentbuild ID to set locations for - location_ids: List[str] (guid) List of location IDs to assign to the xperimentbuild_id
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyXperimentBuildsAssingmentsLocationsDto | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostAttachDatabaseResourceAsync(XperiflowSessionInfo, BodyAttachDatabaseContext, MemoizedCacheInfo?, CancellationToken)
AttachDatabaseResource
public virtual Task<NullableIntItemIdentifierXperiflowResponseContext> PostAttachDatabaseResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, BodyAttachDatabaseContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Inserts a new project into the database
Body Params:
-
name: optional/[str/]
-
The project name
-
description: optional/[str/]
-
The project description
-
application: optional/[str/]
-
The project application name
-
database_resource: optional/[str/]
-
The project resource
-
database_schema: optional/[str/]
-
The database schema
-
ptype: optional/[str/]
-
The problem type
-
ttype: optional/[str/]
-
The time type
-
vtype: optional/[str/]
-
The vised type
Returns:
-
AttachDataBaseResponse
-
query_status: (querystatuscontext)
-
message: (str)
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyAttachDatabaseContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetAutoConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
AutoConfigResource
public virtual Task<GetAutoConfigResourceResponseContext> GetAutoConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieves the auto ppo context for the provided buildinfo ID.
Returns:
-
query_status (Dict)
-
If query was successful.
-
auto_ppo (Dict)
-
lower_bound_train_duration_seconds (int)
- The estimated least amount of time training can take.
-
train_inflation_factor (int)
- Factor to increase the lower estimated train time by
-
allow_negative_targets (bool)
- If target forecasts and inputs can be negative numbers.
-
deploy_strategy (str)
- "auto", "all", "best_three", or "best". Note "auto" will automatically determine the best option to use out of the other three options depending source data dataset properties (i.e number datapoints, number of targets, number of CPUs available etc.)
-
clean_missing_method (str)
- "zero" or "standard", whether to treat missing data as zeros or clean as we normally do
-
evaluation_metric (str)
- The evaluation metric to be used for all targets in the build
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetAutoConfigResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutAutoConfigResourceAsync(XperiflowSessionInfo, int, int, PutBodyAutoPpoContext, MemoizedCacheInfo?, CancellationToken)
AutoConfigResource
public virtual Task<NullDataXperiflowResponseContext> PutAutoConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, PutBodyAutoPpoContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Update the Auto PPO Configuration.
Body Parameters
/* train_inflation_factor: int
/* The amount to inflate the lower bound train time by. This inflation factor /* lower_bound_train_duration_seconds signifies how long the estimated run time will be for model training.
/* allow_negative_targets: bool
/* Whether or not to allow target values to be negative. All target historical values and prediction values that are less than zero will have their value clipped to be 0.
/* deploy_strategy: str
/* The deployment strategy to use when deploying the models into production (after training). Use "auto" if not sure. Auto will deploy a certain number of models per target dependent on a variety factors (i.e num datapoints per target, expected train time, etc)
/* clean_missing_method (str)
/* "zero" or "standard", whether to treat missing data as zeros or clean as we normally do
/* optimize_horizon(bool)
/* true or false, whether to optimize for the forecast range when training
/* evaluation_metric (str)
/* Must be a metric type such as "MeanAbsoluteError" or "MeanSquaredError". These metrics can be retrieved from the ModelingMetricsResource api.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.PutBodyAutoPpoContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetAutoConfigSummaryResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
AutoConfigSummaryResource
public virtual Task<GetAutoConfigSummaryResourceResponseContext> GetAutoConfigSummaryResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
API to get the total number of targets using auto modelling vs manual.
returns
query_status: QueryStatusContext
number_auto: int
number_manual: int
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoResourceAsync(XperiflowSessionInfo, int, int?, string?, MemoizedCacheInfo?, CancellationToken)
BuildInfoResource
public virtual Task<GetBuildInfoResourceResponseContext> GetBuildInfoResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int? buildinfo_id = null, string? by_latest_buildstate = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve the attributes and properties related to a particular buildinfo. This is useful for getting the status of a certain buildinfo.
Query Parameter Info
The api allows you to pull buildinfo in 3 different ways
-
Option 1: By BuildInfoID
-
Provide project_id and buildinfo_id will return the buildinfo corresponding to the buildinfo_id
-
Option 2: Provide only Project ID
-
Providing only project_id will return the latest buildinfo (no matter its buildstate) - This is provided in the URL
-
Option 3: By Latest Build State
-
Provide project_id and by_latest_buildstate (train, deploy) will return the latest buildinfo that is in the buildstate provided.
Returns:
-
query_status (Dict)
-
If query was successful.
-
buildinfo_id (str
{guid}
) -
The buildinfo ID. This will be the same as what was queried with.
-
mlclass_type (str)
-
The machine learning class type that is associated with this particular buildinfo.
-
start_time (str
{dt.datetime}
) -
The time at which the buildinfo was created. This is synonymous with the beginning of a model build process.
-
end_time (str
{dt.datetime}
) -
The time at which the buildinfo completed its modelbuild process. This will be set to "1900-01-01T00:00:00" in the event that the
buildinfo has completed its training state. * build_type (str)
-
Options for months to retrieve in consumption
-
build_state (str)
-
Options for hours to retrieve in consumption
-
mutable (bool)
-
Whether or not the associated buildinfo objects are still able to be altered.
-
is_online (bool)
-
Whether or not the buildinfo is currently online. An offline buildinfo would mean that its models are no longer active and have
been archived in favor of newer, rebuilt models. * buildinfo_output (Optional/[BuildInfoOutputContext/])
-
Various key value pairs related to the buildinfo. This will be None if this API is retrieved prior to the DataConfig job.
-
buildfill (Optional/[BuildFillOutputContext/])
-
Various key value paris related to the buildfill/rebuild information of this buildinfo. This will be None if the API is retrieve
prior to the DataConfig job.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetBuildInfoResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Nullable<System.Int32> | buildinfo_id | the unique identifier associated with the buildinfo. |
System.String | by_latest_buildstate | The latest build state to retrieve by |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutBuildInfoArchiveResourceAsync(XperiflowSessionInfo, int, int, BodyBuildInfoArchiveContext, MemoizedCacheInfo?, CancellationToken)
BuildInfoArchiveResource
public virtual Task<NullableIntItemIdentifierXperiflowResponseContext> PutBuildInfoArchiveResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyBuildInfoArchiveContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Convert a buildinfo (and corresponding xperimentbuilds) to offline status. Optionally create a new buildinfo with same buildfill (auto/manual and full/partial) as buildinfo that was archived. This api should only be run after a successful dataload for a project
Scenarios where request will be deemed unsuccessful:
-
Buildinfo is already offline
-
Buildinfo currently has an attached buidinfo state object that is not in a "finished" state (completed, syserror, syscanceled, etc.)
-
Buildinfo does not exist
-
BuildInfo is in a deployed state
-
Buildinfo does not have a statecollection object called "dataload"
-
Buildinfo "dataload" statecollection object is not completed
Body Parameters:
-
restart (bool):
-
If a new buildinfo should be created and returned. This should be set to true in the event of a "restart" as opposed to a "delete"
Returns:
-
modified (bool)
-
If buildinfo was successfully modified
-
msg (str)
-
Return message
-
buildinfo_id (Optional/[str
{guid}
/]): -
Will be the guid of the new buildinfo if restart is set to true and request is successful. Otherwise, will be null
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyBuildInfoArchiveContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoAuditResourceAsync(XperiflowSessionInfo, int, MemoizedCacheInfo?, CancellationToken)
BuildInfoAuditResource
public virtual Task<GetBuildInfoAuditResourceResponseContext> GetBuildInfoAuditResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieves a JSON DataTable of Deployed BuildInfo related information. Each record in this JSON DataTable corresponds to a Deployed BuildInfo.
Note: The "GroupingInfo" field is a JSON field within the JSON DataTable.
Returns:
-
Query status (querystatus)
-
buildinfo_history (datatable)
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetBuildInfoAuditResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoBacktestResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
BuildInfoBacktestResource
public virtual Task<GetBuildInfoBacktestResourceResponseContext> GetBuildInfoBacktestResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieves High level statistics from the pipeline run, win margins, and vm statistics
Returns:
-
query_status (Dict)
-
If query was successful.
-
model_deployed_df(DataTableContext)
-
The name of deployed models and the count deployed
-
pipeline_stats_df(DatatableContext)
-
Two column dataframe with the name of a statistics and the value
-
win_margin_df (DataTableContext):
-
DataFrame that contains the win margin of each target for their best model against their best baseline for every metric and the
corresponding portion of the dataset that these metrics were computed on. * vms_cpu (DataTableContext):
- Contains the average cpu utilization of all servers agaisnt time for the pipeline job.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
BuildInfoConfigResource
public virtual Task<GetBuildInfoConfigResourceResponseContext> GetBuildInfoConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
This will update the Output Context for a Buildinfo.
Input:
run_feature_generation: Optional[bool]
run_feature_transformation: Optional[bool]
run_feature_selection: Optional[bool]
allow_grouping: Optional[bool]
feature_generation_threshold: Optional[int]
feature_transformation_threshold: Optional[int]
feature_selection_threshold: Optional[int]
grouping_threshold: Optional[int]
Returns:
buildinfo_id: int
modified: bool
message: str
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetBuildInfoConfigResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutBuildInfoConfigResourceAsync(XperiflowSessionInfo, int, int, BodyBuildinfoConfigContext, MemoizedCacheInfo?, CancellationToken)
BuildInfoConfigResource
public virtual Task<NullDataXperiflowResponseContext> PutBuildInfoConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyBuildinfoConfigContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
This will update the Output Context for a Buildinfo.
Input:
run_feature_generation: Optional[bool]
run_feature_transformation: Optional[bool]
run_feature_selection: Optional[bool]
allow_grouping: Optional[bool]
feature_generation_threshold: Optional[int]
feature_transformation_threshold: Optional[int]
feature_selection_threshold: Optional[int]
grouping_threshold: Optional[int]
Returns:
buildinfo_id: int
modified: bool
message: str
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyBuildinfoConfigContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeleteBuildInfoConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
BuildInfoConfigResource
public virtual Task<NullDataXperiflowResponseContext> DeleteBuildInfoConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
This will reset the Output Context for a Buildinfo.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetModelThresholdsConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ModelThresholdsConfigResource
public virtual Task<GetModelThresholdsConfigResourceResponseContext> GetModelThresholdsConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve the model thresholds.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutModelThresholdsConfigResourceAsync(XperiflowSessionInfo, int, int, BodyModelThresholdsContext, MemoizedCacheInfo?, CancellationToken)
ModelThresholdsConfigResource
public virtual Task<NullDataXperiflowResponseContext> PutModelThresholdsConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyModelThresholdsContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Update the model thresholds.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyModelThresholdsContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeleteModelThresholdsConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ModelThresholdsConfigResource
public virtual Task<NullDataXperiflowResponseContext> DeleteModelThresholdsConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
This will reset the model thresholds.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetHierarchyConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
HierarchyConfigResource
public virtual Task<GetHierarchyConfigResourceResponseContext> GetHierarchyConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve the Hierarchical Config
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetHierarchyConfigResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostHierarchyConfigResourceAsync(XperiflowSessionInfo, int, int, BodyHierarchyConfigContext, MemoizedCacheInfo?, CancellationToken)
HierarchyConfigResource
public virtual Task<NullDataXperiflowResponseContext> PostHierarchyConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyHierarchyConfigContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Update the Hierarchical Config
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyHierarchyConfigContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeleteHierarchyConfigResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
HierarchyConfigResource
public virtual Task<NullDataXperiflowResponseContext> DeleteHierarchyConfigResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Deletes the Hierarchical Config
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfosResourceAsync(XperiflowSessionInfo, int, IEnumerable<string>?, string?, int?, int?, string?, bool?, MemoizedCacheInfo?, CancellationToken)
BuildInfosResource
public virtual Task<GetBuildInfosResourceResponseContext> GetBuildInfosResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, bool? include_offline = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve a datatable of buildinfo information with each row corresponding to a different buildinfo. Columns include ID, StarTime, EndTime, BuildType, BuildState, NumTargets, NumSingleTargets, NumGroups.
Query parameter is available to determine if offline buildinfos should be included in the table.
Returns:
-
query_status (Dict)
-
buildinfo_data(DataTableContext)
- Datatable containing buildinfos' information
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetBuildInfosResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
System.Nullable<System.Boolean> | include_offline | If to include offline buildinfos in the results. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoStateResourceAsync(XperiflowSessionInfo, int, string?, string?, int?, MemoizedCacheInfo?, CancellationToken)
BuildInfoStateResource
public virtual Task<GetBuildInfoStateResourceResponseContext> GetBuildInfoStateResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, string? by_latest_buildstate = null, string? buildinfo_state = null, int? buildinfo_id = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve the buildinfo state and related status variables that are tied to a particular buildinfo. This is useful for defining different page restrictions and getting how far through the pipeline a particular buildinfo is.
Definitions
It's important to call out the distinction between BuildInfo State and BuildState given that they are so close in name.
/* BuildInfo State: The distinct states that occur within a buildinfo
/* Build State: The current form of the BuildInfo object. This will either be "train" or "deploy".
Available BuildInfo States:
/* DataConfigOrchestrator
/* FeatureDataSourceValidationCommit
/* DataLoadOrchestrator
/* PipelineOrchestrator
/* FeaturePipelineOrchestrator
/* ModelingPipelineOrchestrator
/* DeployOrchestrator
/* ModelRebuildOrchestrator
Query Parameter Info
The api allows you to pull buildinfo state in 3 different ways (similar accessors to BuildInfo API). The optional buildinfo state string will look for that buildinfo state if provided, otherwise it will look for the latest buildinfo state based on starttime.
/* Option 1: By BuildInfoID + BuildInfoState
/* Provide project_id and buildinfo_id will search for the buildinfo states corresponding to the buildinfo_id
/* Option 2: Provide only Project ID + BuildInfoState
/* Providing only project_id will will search for the buildinfo states associated with the latest buildinfo (no matter its buildstate)
/* Option 3: By Latest Build State + BuildInfoState
/* Provide project_id and by_latest_buildstate (train, deploy) will search for the buildinfo states the latest buildinfo that is in
the buildstate provided.
Returns:
/* query_status (Dict)
/* If query was successful.
/* buildinfo_id (str {guid}
)
/* The buildinfo ID. This will be the same as what was queried with.
/* is_complete (bool)
/* Whether or not the "buildinfo_state" was found and was completed.
/* is_found (bool)
/* Whether or not the provided "buildinfo_state" was found with the associated "buildinfo_id".
/* activity_status (Optional/[str/])
/* The activity status of the "buildinfo_state" that was provided as the query parameter. This will be None if the "buildinfo_state"
was not found. /* state_name (Optional/[str/])
/* The "buildinfo_state" that was provided as the query parameter (just resurfacing in the the response). This will be None if the
"buildinfo_state" was not found /* state_type (Optional/[str/])
/* The underlying object that defines the state. Will either be "job" or "task". This will be None if the "is_found" is False.
/* state_id: (Optional/[str {Guid}
/]):
/* The underlying object ID that defines the state. This will either be a JobID or TaskID corresponding to the "state_type". This
will be None if the "is_found" is False.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetBuildInfoStateResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.String | by_latest_buildstate | The latest build state to retrieve by |
System.String | buildinfo_state | The current buildinfo state to check for if it's complete. If none, then gets the latest |
System.Nullable<System.Int32> | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildSummaryResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
BuildSummaryResource
public virtual Task<GetBuildSummaryResourceResponseContext> GetBuildSummaryResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
This returns the total number of targets (target level) and number of target groups (top level)
Returns:
-
query_status (Dict)
-
targets (int)
-
Number of total targets for the given buildinfo_id
-
single_targets (int)
-
Number of single targets for the given buildinfo_id
-
groups(int)
-
Number of groups for the given buildinfo_id
-
groups_and_single_targets (int)
-
Number of groups and single level targets for given buildinfo_id (essentially the sum of 'single_targets' and 'groups')
-
total_models_trained (Optional/[int/])
-
The total number of models trained for given buildinfo_id
-
total_modeliterations (Optional/[int/])
-
The total hyperparameter tuning iterations for given buildinfo_id
-
total_featuresgenerated (Optional/[int/])
-
The total features generated for given buildinfo_id
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetBuildSummaryResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetCrossValidationSplitsResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
CrossValidationSplitsResource
public virtual Task<GetCrossValidationSplitsResourceResponseContext> GetCrossValidationSplitsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get api for retrieving cross validation split blobs for a given project_id and buildinfo_id.
-
query_status (Dict)
-
If query was successful.
-
cv_strategy_type (str)
-
The name of the crossvalidation strategy type
-
splits List(str)
-
A list of cross validation split blobs for the given project_id and buildinfo_id
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetConsumptionGroupResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ConsumptionGroupResource
public virtual Task<GetConsumptionGroupResourceResponseContext> GetConsumptionGroupResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int consumption_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieves the Consumption group asked for by the id in the url
Returns:
-
query_status (Dict)
-
If query was successful.
-
consumption (ConsumptionContext):
-
Defines the consumption group and the options chosen.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | consumption_id | the unique identifier associated with the consumption group. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutConsumptionGroupResourceAsync(XperiflowSessionInfo, int, BodyConsumptionContext, int, MemoizedCacheInfo?, CancellationToken)
ConsumptionGroupResource
public virtual Task<NullDataXperiflowResponseContext> PutConsumptionGroupResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, BodyConsumptionContext body, int consumption_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
ConsumptionGroupResource
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyConsumptionContext | body | |
System.Int32 | consumption_id | the unique identifier associated with the consumption group. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeleteConsumptionGroupResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ConsumptionGroupResource
public virtual Task<NullDataXperiflowResponseContext> DeleteConsumptionGroupResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int consumption_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Deletes a consumption context in database by id.
Body Parameters:
-
project_id (str
{guid}
): -
The name of the location. Cannot match another location already inserted.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | consumption_id | the unique identifier associated with the consumption group. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetConsumptionGroupsResourceAsync(XperiflowSessionInfo, int, MemoizedCacheInfo?, CancellationToken)
ConsumptionGroupsResource
public virtual Task<GetConsumptionGroupsResourceResponseContext> GetConsumptionGroupsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
ConsumptionGroupsResource
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostConsumptionGroupsResourceAsync(XperiflowSessionInfo, int, BodyConsumptionPbmInputsDto, MemoizedCacheInfo?, CancellationToken)
ConsumptionGroupsResource
public virtual Task<PostConsumptionGroupsResourceResponseContext> PostConsumptionGroupsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, BodyConsumptionPbmInputsDto body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Inserts a consumption group into the database.
Body Parameters:
-
project_id (str
{int}
): -
The name of the location. Cannot match another location already inserted.
-
consumption (ConsumptionContext):
-
The consumption context defining the group. Ex :
"consumption":
{
"group_name": "group1",
"group_type": "time",
"output_table_name": "modelforecast",
"creation_time": "2021-09-17 07:42:27.8276660",
"attributes_context": {
"start_time": null,
"end_time": null,
"extraction_type": "batch",
"models_to_return": "all"
},
"uid": "{`{consumption_id}`}"
}
Returns
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyConsumptionPbmInputsDto | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostConsumptionPBMResourceAsync(XperiflowSessionInfo, int, BodyConsumptionPbmDto, MemoizedCacheInfo?, CancellationToken)
ConsumptionPBMResource
public virtual Task<NullableIntItemIdentifierXperiflowResponseContext> PostConsumptionPBMResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, BodyConsumptionPbmDto body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Create a new consumption workflow
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyConsumptionPbmDto | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetDataExplorationResourceAsync(XperiflowSessionInfo, int, int, bool, string?, MemoizedCacheInfo?, CancellationToken)
DataExplorationResource
public virtual Task<GetDataExplorationResourceResponseContext> GetDataExplorationResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, bool columndata_only, string? column_name = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns the Explore stats for source dataset
Returns:
-
frequency (str):
-
The frequency of the dataset. One of (
-
columndata_dataset (DataFrame):
-
The Json DataTable holding the columndata information.
-
timeseries_dataset (DataFrame):
-
The Json DataTable holding the time series data.
Note: The columndata_dataset "Name" column will match the values in the timeseries_dataset "Intersection" column.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetDataExplorationResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Boolean | columndata_only | |
System.String | column_name | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetDataExplorationOptionsResourceAsync(XperiflowSessionInfo, int, int, IEnumerable<string>?, string?, int?, int?, string?, string?, IEnumerable<string>?, MemoizedCacheInfo?, CancellationToken)
DataExplorationOptionsResource
public virtual Task<GetDataExplorationOptionsResourceResponseContext> GetDataExplorationOptionsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, string? filter_series = null, IEnumerable<string>? filter_mltypes = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Returns the Explore options for the source dataset. Designed to be used in conjunction with the DataExplorationResource.
Returns:
-
query_status (Dict)
- Contains key: "status" If the query succeeded or not
-
filterable_data(DataFrame):
- The Json DataTable holding the columndata information (Name, ShortName, Summation).
-
query_manager_column_info (List/[ColumnInfoContext/]):
- List of info for each column, if it can be filtered/ordered by/etc.
-
total_pages (int):
- The total pages for all records
-
total_records (int):
- The total records across all pages
-
records_per_page (int):
- The number of records per page
-
page (int):
- The page number of the query
-
order_bys (dict):
- Any order bys used in the query and how they were used (ASC/DESC)
-
filterable_series (List/[str/]):
- List of series that can be filtered by
-
filter_series (Optional/[str/]):
- The series used to filter in the query
-
filterable_mltypes (List/[str/]):
- List of mltypes that can be filtered by
-
filter_mltypes (Optional/[str/]):
- The mltype used to filter on
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
System.String | filter_series | |
System.Collections.Generic.IEnumerable<System.String> | filter_mltypes | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetBuildInfoAssignmentsSummaryResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
BuildInfoAssignmentsSummaryResource
public virtual Task<GetBuildInfoAssignmentsSummaryResourceResponseContext> GetBuildInfoAssignmentsSummaryResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
This returns location and generator assignment statistics for the specific buildinfo id
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostGeneratorPackagesApplyResourceAsync(XperiflowSessionInfo, int, int, GeneratorPackagesApplyBodyContext, MemoizedCacheInfo?, CancellationToken)
GeneratorPackagesApplyResource
public virtual Task<NullDataXperiflowResponseContext> PostGeneratorPackagesApplyResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, GeneratorPackagesApplyBodyContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
GeneratorPackagesApplyResource
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GeneratorPackagesApplyBodyContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFeatureEffectsResourceAsync(XperiflowSessionInfo, int, IEnumerable<int>?, IEnumerable<int>?, string?, bool?, bool?, int?, MemoizedCacheInfo?, CancellationToken)
FeatureEffectsResource
public virtual Task<GetFeatureEffectsResourceResponseContext> GetFeatureEffectsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, IEnumerable<int>? xperimentkernel_ids = null, IEnumerable<int>? xperimentbuild_ids = null, string? model_pinq = null, bool? all_deployed = null, bool? include_failed_models = null, int? num_models = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get api for retrieving feature effect statistics for a given xperimentkernel. If the xperimentkernel relates to a baseline model, the query status will be false because feature effect statistics should not exist. Xperimentkernels relating to non-baseline models should have a successful query.
-
query_status (QueryStatusContext)
-
If query was successful.
-
statistics (DataTableContext) - Contains the feature effect statistics data
-
FeatureName
-
FeatureValue
-
PredictionAvgValue
-
TargetAvgValue
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetFeatureEffectsResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Collections.Generic.IEnumerable<System.Int32> | xperimentkernel_ids | List of xperimentkernel ids to get metrics for |
System.Collections.Generic.IEnumerable<System.Int32> | xperimentbuild_ids | List of xperimentbuild ids to get metrics for. |
System.String | model_pinq | Optional[str]: A pinq query to get specific models for |
System.Nullable<System.Boolean> | all_deployed | If only deployed models should be shown |
System.Nullable<System.Boolean> | include_failed_models | If failed models should be shown |
System.Nullable<System.Int32> | num_models | Number of models |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFeaturesGeneratedResourceAsync(XperiflowSessionInfo, int, int, IEnumerable<string>?, string?, int?, int?, string?, MemoizedCacheInfo?, CancellationToken)
FeaturesGeneratedResource
public virtual Task<GetFeaturesGeneratedResourceResponseContext> GetFeaturesGeneratedResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Retrieve a table containing all of the generated features for a given project.
Returns:
-
query_status (Dict)
- If query was successful.
-
generated_features (DataTableContext):
- Table containing each generated feature in the project as a row
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFeaturesGeneratedDatatypesResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
FeaturesGeneratedDatatypesResource
public virtual Task<GetFeaturesGeneratedDatatypesResourceResponseContext> GetFeaturesGeneratedDatatypesResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get feature summary statistic by buildinfo id which contains in the features_summary_df two columns, one with the datatype name "dtype" and one with the number of columndatum of that datatype "dtype_count" given the buildinfo.
- query_status (Dict) - If query was successful. - features_summary_df (DatatableContext) - Each row is a datatype with count
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFeatureImpactResourceAsync(XperiflowSessionInfo, int, IEnumerable<int>?, IEnumerable<int>?, string?, bool?, bool?, int?, MemoizedCacheInfo?, CancellationToken)
FeatureImpactResource
public virtual Task<GetFeatureImpactResourceResponseContext> GetFeatureImpactResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, IEnumerable<int>? xperimentkernel_ids = null, IEnumerable<int>? xperimentbuild_ids = null, string? model_pinq = null, bool? all_deployed = null, bool? include_failed_models = null, int? num_models = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get api for retrieving feature Impact statistics for a list of xperimentkernel_ids. Can be either a list of a single str kernel_id or a list of multiple.
-
query_status (QueryStatusContext)
-
If query was successful.
-
statistics (DataTableContext) - Contains the feature Impact statistics data
-
FeatureName
-
FeatureImpact
-
XperimentKernelID
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetFeatureImpactResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Collections.Generic.IEnumerable<System.Int32> | xperimentkernel_ids | List of xperimentkernel ids to get metrics for |
System.Collections.Generic.IEnumerable<System.Int32> | xperimentbuild_ids | List of xperimentbuild ids to get metrics for. |
System.String | model_pinq | Optional[str]: A pinq query to get specific models for |
System.Nullable<System.Boolean> | all_deployed | If only deployed models should be shown |
System.Nullable<System.Boolean> | include_failed_models | If failed models should be shown |
System.Nullable<System.Int32> | num_models | Number of models |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFeatureTransformersDistributionResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
FeatureTransformersDistributionResource
public virtual Task<GetFeatureTransformersDistributionResourceResponseContext> GetFeatureTransformersDistributionResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get feature summary statistic by buildinfo id which is contained in the features_summary_df two columns, one with the transformer name "Transformer" and one with the number of columndatum of that used that transformer "transformer_count" given the buildinfo.
-
query_status (Dict)
-
If query was successful.
-
features_summary_df (DatatableContext)
-
Each row is a transformer with count
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetFeaturesSummaryResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
FeaturesSummaryResource
public virtual Task<GetFeaturesSummaryResourceResponseContext> GetFeaturesSummaryResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get feature summary statistic by buildinfo id which contains the latest of the following information in the features_summary_df
"total_unique_generated_features"
"total_unique_selected_features"
"max_feature_selection_rounds"
"feature_transformation_rounds"
"feature_engineering_duration"
- query_status (Dict) - If query was successful. - features_summary_df (DatatableContext) - One row with all the statistics above
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetFeaturesSummaryResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetGlobalFeatureGeneralizationResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
GlobalFeatureGeneralizationResource
public virtual Task<GetGlobalFeatureGeneralizationResourceResponseContext> GetGlobalFeatureGeneralizationResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get the global feature generalization statistic datatable by buildinfo id.
-
query_status (Dict)
- If query was successful.
-
features_summary_df (DatatableContext)
-
Each row is a feature with its with count
-
Columns:
-
feature_name: The feature name
-
short_name: Feature short name
-
dtype: The dtype of the feature
-
total: The total number of targets that this feature was eligible to be used with
-
utilized: The total number of targets that this feature was found useful for
-
utilization_percentage: The percentage of eligible targets that this feature was useful for.
-
-
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetForecastResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ForecastResource
public virtual Task<GetForecastResourceResponseContext> GetForecastResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get the forecast for the given project ID included in URL.
Returns:
-
"range_step": (int)
-
"collection_lag_step": (int)
-
query status
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetForecastResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutForecastResourceAsync(XperiflowSessionInfo, int, int, ForecastConfigCollectionContext, MemoizedCacheInfo?, CancellationToken)
ForecastResource
public virtual Task<NullDataXperiflowResponseContext> PutForecastResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, ForecastConfigCollectionContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Set the forecast for the given project_id.
Body Parameters:
-
range_step: int
-
How far forward to forecast from this given moment in time (number of datapoints)
-
collection_lag_step: int
-
The far backward in turns row steps the data source lags behind this given moment in time.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.ForecastConfigCollectionContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetForecastOptionsResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ForecastOptionsResource
public virtual Task<GetForecastOptionsResourceResponseContext> GetForecastOptionsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get the forecast options for the given project ID.
Returns:
-
query_status (Dict):
-
Contains key "status". If query succeeded.
-
steps(DataFrame):
-
The dataframe with steps options.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetForecastOptionsResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetForecastInfoResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
ForecastInfoResource
public virtual Task<GetForecastInfoResourceResponseContext> GetForecastInfoResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get the forecast info for the given project ID.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetForecastInfoResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetGroupingResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
GroupingResource
public virtual Task<GetGroupingResourceResponseContext> GetGroupingResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Gets Data for presentation on the Data Profile page of the Sensible ML application. In particular, this data retrieve the target distribution data in increments of 1 percentiles.
Returns:
-
query_status (Dict)
-
Contains status whether the query succeeded or not.
-
buildinfo_id (str
{guid}
) -
The buildinfo unique identifier.
-
grouping (GroupingContext):
-
The grouping methodology to use when grouping targets together.
Additional Notes on GroupingContext:
The grouping context is a dictionary that contains the following keys: * "option" (str): The option to use for grouping. The option can be one of the following:
-
"significance"
-
"cluster"
-
"none"
-
"80-20"
-
"auto"
-
"cluster"
-
"dimensions"
-
"uniform"
-
"data" (dict): additional data that is required for the specific option. The data is different for each option. * "enable_grouping_across_hierarchies" (Optional[bool]): If true, then the grouping will be applied across all hierarchies. If false, then the grouping will be applied within each hierarchy.
The grouping context supports the following options:
-
By Target Significance:
-
Description: Group targets based on their respective significance. Significance is determined by summing all values for each respective
target and dividing by the total overall sum of targets to get a "significance percentage" per target.
-
option: "significance"
-
data: VolumeData
-
"start" (int/[0 - 100/]): The starting percentage to group
-
"end" (int/[
{start}
- 100/]): The ending percent to group -
"detail" (Optional/[int/]):
-
None means no algorithmic clustering to cluster the significance range further
-
/-1 will auto cluster the significance range further and will automatically choose the best cluster for you.
-
greater than 1 will set the specific number of clusters for algorithmic clustering the significance range.)
-
-
-
By Clustering
-
Option: "cluster"
-
data: TargetGrouperByClusterContext
- num_clusters (int): If -1 then auto clustering, otherwise must be > 0 and the number will be the number of clusters.
-
No Grouping:
-
Description: No grouping will be applied an all targets will remain as single targets.
-
option: "None" Note that this is the string "None" not None as in no value.
-
data: None
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetGroupingResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostGroupingResourceAsync(XperiflowSessionInfo, int, int, GroupingContext, MemoizedCacheInfo?, CancellationToken)
GroupingResource
public virtual Task<NullDataXperiflowResponseContext> PostGroupingResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, GroupingContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Inserts or updates the Grouping Definition for a particular project and buildinfo.
Body_Parameters:
- project_id (str
{guid}
): - The name of the location. Cannot match another location already inserted. - buildinfo_id (str{guid}
): - The description of the location - grouping (GroupingContext): - See examples of "grouping" found in the (GET) Grouping API examples.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GroupingContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetGroupingOptionsResourceAsync(XperiflowSessionInfo, int, MemoizedCacheInfo?, CancellationToken)
GroupingOptionsResource
public virtual Task<GetGroupingOptionsResourceResponseContext> GetGroupingOptionsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get available grouping options by project id
/* query_status (Dict)
/* If query was successful.
/* options (DatatableContext)
/* Each row is key value pair for grouping options
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetGroupingOptionsResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetGeneratorCompatibilityResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
GeneratorCompatibilityResource
public virtual Task<GetGeneratorCompatibilityResourceResponseContext> GetGeneratorCompatibilityResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get generators and their compatibility/in use by buildinfo id and project id
-
query_status (Dict)
- If the query was successful.
-
compatibility_datatable (DatatableContext)
- Each row is a given generator and if it is compatible with the build
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetGeneratorConfigurationsResourceAsync(XperiflowSessionInfo, int, int, IEnumerable<string>?, string?, int?, int?, string?, MemoizedCacheInfo?, CancellationToken)
GeneratorConfigurationsResource
public virtual Task<GetGeneratorConfigurationsResourceResponseContext> GetGeneratorConfigurationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Get information regarding currently configured generators for a given buildinfo id
-
query_status (Dict)
- If query was successful.
-
configurations_datatable (DatatableContext)
- Each row is a given configuration
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostGeneratorConfigurationsResourceAsync(XperiflowSessionInfo, int, int, BodyGeneratorConfigurationsContext, MemoizedCacheInfo?, CancellationToken)
GeneratorConfigurationsResource
public virtual Task<PostGeneratorConfigurationsResourceResponseContext> PostGeneratorConfigurationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyGeneratorConfigurationsContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Insert a generator config for a given buildinfo id. The init kwargs will be validated upon post to verify they are correct, but the correct init kwargs can be seen from the GeneratorCollectionResource's init_kwargs. Exactly one of init_kwargs being set or use_generate_init_kwargs being true should be provided.
Body params:
-
generator (str): The generator to use
-
init_params_json (dict): The init params to use with the generator
-
fit_params_json (dict): The fit params to use with the generator
-
bypass_feature_selection (bool): If generated features should bypass feature selection. This defaults to False and should be used sparingly
-
scenario_features (bool): Whether the specified generator should be used as a scenario feature or not. This defaults to False
-
description (str, Optional): An optional description of the generator
Returns:
-
generator_config_id (int): The created id.
-
modified (bool): If query was successful.
-
message (str): Any necessary message.
Returns
created
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyGeneratorConfigurationsContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeleteGeneratorConfigurationsResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
GeneratorConfigurationsResource
public virtual Task<NullDataXperiflowResponseContext> DeleteGeneratorConfigurationsResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Delete all generator configs for a given buildinfo id. This will set back to pipeline default generator configs.
Query Params:
None
Returns:
-
generator_config_id (guid): The created id.
-
modified (bool): If query was successful.
-
message (str): Any necessary message.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostGeneratorConfigurationsBulkDeleteResourceAsync(XperiflowSessionInfo, int, int, IntItemsIdentifierContext, MemoizedCacheInfo?, CancellationToken)
GeneratorConfigurationsBulkDeleteResource
public virtual Task<NullDataXperiflowResponseContext> PostGeneratorConfigurationsBulkDeleteResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IntItemsIdentifierContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Delete a list of generator config ids for a given buildinfo id.
Body params:
- item_ids (List[Guid]): The generators to delete
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.IntItemsIdentifierContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PutGeneratorConfigurationResourceAsync(XperiflowSessionInfo, int, int, int, BodyGeneratorConfigurationContext, MemoizedCacheInfo?, CancellationToken)
GeneratorConfigurationResource
public virtual Task<NullDataXperiflowResponseContext> PutGeneratorConfigurationResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, int generator_config_id, BodyGeneratorConfigurationContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Update a given generator config id. The init kwargs will be validated upon post to verify they are correct, but the correct init kwargs can be seen from the GeneratorCollectionResource's init_kwargs. Exactly one of init_kwargs being set or use_generate_init_kwargs being true should be provided.
Body params:
-
init_kwargs (dict, optional): The init kwargs to use with the generator
-
use_generate_init_kwargs (bool, optional): If initkwargs should be generated. This defaults to False
-
bypass_feature_selection (bool, optional): If generated features should bypass feature selection. This defaults to False and should be used sparingly
Returns:
-
generator_config_id (guid): The updated id.
-
modified (bool): If query was successful.
-
message (str): Any necessary message.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Int32 | generator_config_id | the unique identifier associated with the generator config. |
Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.BodyGeneratorConfigurationContext | body | |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
DeleteGeneratorConfigurationResourceAsync(XperiflowSessionInfo, int, int, int, MemoizedCacheInfo?, CancellationToken)
GeneratorConfigurationResource
public virtual Task<NullDataXperiflowResponseContext> DeleteGeneratorConfigurationResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, int generator_config_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Delete a given generator config.
Query Params:
None
Returns:
-
generator_config_id (guid): The deleted id.
-
modified (bool): If query was successful.
-
message (str): Any necessary message.
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.NullDataXperiflowResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Int32 | generator_config_id | the unique identifier associated with the generator config. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetGroupingTargetDistributionResourceAsync(XperiflowSessionInfo, int, int, MemoizedCacheInfo?, CancellationToken)
GroupingTargetDistributionResource
public virtual Task<GetGroupingTargetDistributionResourceResponseContext> GetGroupingTargetDistributionResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Gets Data for presentation on the Data Profile page of the Sensible ML application. In particular, this data retrieve the target distribution data in increments of 1 percentiles.
Returns:
- grouping_distribution (DataTableContext) - The grouping distribution where each group broken down by significance and total number of targets. Note that all single series are treated as a group for comparison purposes. - total_targets (int) - The total number of targets present in this buildinfo.
Returns
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
GetScenariosResourceAsync(XperiflowSessionInfo, int, int, IEnumerable<string>?, string?, int?, int?, string?, MemoizedCacheInfo?, CancellationToken)
ScenariosResource
public virtual Task<GetScenariosResourceResponseContext> GetScenariosResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, IEnumerable<string>? fields = null, string? filter = null, int? page = null, int? records_per_page = null, string? order_bys = null, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Gets Scenarios that have been created for a given buildinfo id. This is a paged api and it is likely it will be filtered on forecast start date column
Returns
Task
< Workspace.XBR.Xperiflow.Core.RestApi.TimeSeriesForecasting.GetScenariosResourceResponseContext >
ok
Parameters
Type | Name | Description |
---|---|---|
Workspace.XBR.Xperiflow.Core.Session.XperiflowSessionInfo | x_OS_SessionInfo | OneStream session info header object. |
System.Int32 | project_id | The unique identifier associated with the project. |
System.Int32 | buildinfo_id | the unique identifier associated with the buildinfo. |
System.Collections.Generic.IEnumerable<System.String> | fields | A json list of column names to return in the request. |
System.String | filter | A json dictionary of a filter statement. |
System.Nullable<System.Int32> | page | The page to return if using pagination. |
System.Nullable<System.Int32> | records_per_page | The amount of records per page to return if using pagination. |
System.String | order_bys | A json dictionary containing an order by statement. |
Workspace.XBR.Xperiflow.Utilities.Http.MemoizedCacheInfo | cacheInfo | |
System.Threading.CancellationToken | cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Exceptions
Workspace.XBR.Xperiflow.Core.RestApi.Exceptions.XperiflowApiException A server side error occurred.
PostScenariosResourceAsync(XperiflowSessionInfo, int, int, BodyScenariosContext, MemoizedCacheInfo?, CancellationToken)
ScenariosResource
public virtual Task<PostScenariosResourceResponseContext> PostScenariosResourceAsync(XperiflowSessionInfo x_OS_SessionInfo, int project_id, int buildinfo_id, BodyScenariosContext body, MemoizedCacheInfo? cacheInfo = null, CancellationToken cancellationToken = default)
Remarks
Create a scenario with a given name, description, and forecast start date.