Collect Data from Source
post
/data/collect
Collects data from your data source, such as a database, and stores it in an object file.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Match All
Specifies the input parameters for the request.
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
type
Specifies the input parameters for the request.
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : type
Type:
objectSpecifies the input parameters for the request.
Show Source
-
data_source_type(required): array
data_source_type
Specifies the list of data sources.
-
delta_data(required): boolean
Indicates whether newly fetched data should be appended to existing data. Set this to true if you need to append the training data. Set this to false if you want to fetch complete data without appending anything.
-
query_builder(required): array
query_builder
Specifies the list of queries and their join conditions.
-
storage_details: array
storage_details
Specifies the data storage location and connection details.
-
tech_choice(required): string
Specifies the third-party library to use for data collection: spark, dataflow, or datascience.
Nested Schema : query_builder
Type:
arraySpecifies the list of queries and their join conditions.
Show Source
Nested Schema : storage_details
Type:
arraySpecifies the data storage location and connection details.
Show Source
Nested Schema : QueryBuilder
Match All
Specifies the queries and their join conditions.
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
QueryBuilder-allOf[1]
Specifies the queries and their join conditions.
Nested Schema : QueryBuilder-allOf[1]
Type:
objectSpecifies the queries and their join conditions.
Show Source
-
join_condition: array
join_condition
Specifies the join conditions used to construct the queries. This is an optional input which can be used to join the data from two queries.
-
queries(required): array
queries
Specifies the list of queries.
Nested Schema : join_condition
Type:
arraySpecifies the join conditions used to construct the queries. This is an optional input which can be used to join the data from two queries.
Show Source
Nested Schema : JoinConditions
Match All
List of join conditions used to combine queries.
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
JoinConditions-allOf[1]
List of join conditions used to combine queries.
Nested Schema : JoinConditions-allOf[1]
Type:
objectList of join conditions used to combine queries.
Show Source
-
join(required): array
join
Specifies the names of the queries to join.
-
join_column: array
join_column
Specifies the column used to join the queries.
-
join_type: string
Specifies the join type to use instead of the default (natural join).
-
name(required): string
Specifies the query name, which serves as a unique identifier.
Nested Schema : QueryList
Match All
Specifies the list of queries to run.
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
QueryList-allOf[1]
Specifies the list of queries to run.
Nested Schema : QueryList-allOf[1]
Type:
objectSpecifies the list of queries to run.
Show Source
-
name(required): string
Specifies the query name, which serves as a unique identifier.
-
query(required): string
Specifies the query to run.
Nested Schema : StorageDetails
Match All
Defines the queries to run and the join conditions used to combine them.
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
StorageDetails-allOf[1]
Defines the queries to run and the join conditions used to combine them.
Nested Schema : StorageDetails-allOf[1]
Type:
objectDefines the queries to run and the join conditions used to combine them.
Show Source
-
output_file_type(required): string
Specifies the file type to use when storing the data: json, csv, or pickle.
-
path: string
Specifies the storage path where the data is saved.
-
storage_connection_details: array
storage_connection_details
Specifies the connection parameters for the storage location.
-
storage_type: string
Specifies the type of storage to use: pvc or object_storage.
Nested Schema : storage_connection_details
Type:
arraySpecifies the connection parameters for the storage location.
Show Source
-
Array of:
object items
Additional Properties Allowed:
true
Nested Schema : items
Type:
objectAdditional Properties Allowed:
trueExamples
Back to Top
Response
200 Response
The request was completed successfully.
Nested Schema : CollectResponse
Match All
Specifies the output returned by the operation.
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
CollectResponse-allOf[1]
Specifies the output returned by the operation.
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : CollectResponse-allOf[1]
Type:
objectSpecifies the output returned by the operation.
Show Source
-
status(required): string
Indicates the status of the data being fetched from the data source.
400 Response
The request could not be processed because it contains missing or invalid information.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
401 Response
The request is not authorized.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
403 Response
The user does not have authorization to perform this request.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
404 Response
The requested resource cannot be found.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
405 Response
The method is not allowed.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
409 Response
The request could not be processed due to a conflict with the existing state of the resource.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
500 Response
The system has encountered an internal server error.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
501 Response
The request was not implemented.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
503 Response
The service is unavailable.
Root Schema : Error
Match All
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "CacheRequest":"#/components/schemas/CacheRequest", "FetchRequest":"#/components/schemas/FetchRequest", "CollectRequest":"#/components/schemas/CollectRequest", "QueryBuilder":"#/components/schemas/QueryBuilder", "QueryList":"#/components/schemas/QueryList", "JoinConditions":"#/components/schemas/JoinConditions", "StorageDetails":"#/components/schemas/StorageDetails", "CollectResponse":"#/components/schemas/CollectResponse", "FetchResponse":"#/components/schemas/FetchResponse", "CacheResponse":"#/components/schemas/CacheResponse", "Error":"#/components/schemas/Error" } }Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`. -
object
Error-allOf[1]
Indicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Nested Schema : Discriminator: @type
Type:
objectDiscriminator: @type
Discriminator Values
- CacheRequest
- FetchRequest
- CollectRequest
- QueryBuilder
- QueryList
- JoinConditions
- StorageDetails
- CollectResponse
- FetchResponse
- CacheResponse
- Error
Base extensible schema for use with TM Forum Open APIs. When used in a schema, the entity must be extended by specifying `@type`.
Show Source
-
@baseType: string
Specifies the superclass while subclassing.
-
@schemaLocation: string
(uri)
Provides a URI to the JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
When subclassing, specifies the extensible name of the subclass.
Nested Schema : Error-allOf[1]
Type:
objectIndicates an error response from the API, usually accompanied by an HTTP status code (3xx, 4xx, or 5xx).
Show Source
-
code(required): string
Provides application-specific details, as defined by the API or a common list.
-
message: string
Provides additional error details and recommended corrective actions to display to the client user.
-
reason(required): string
Provides an explanation of the error to display to the client user.
-
referenceError: string
(uri)
Provides a URI to documentation that describes the error.
-
status: string
Specifies the extended HTTP error code.
Examples
This example shows the cURL command for sending a Create the Data Set request:
curl -X POST 'http://hostname:port/data/collect' -d @file.json
where:
-
hostname is the host name of the application server.
-
port is the port for the application server.
-
file.json is the JSON file that specifies the details of the data to collect.
Example of Request Body
Following is a sample request body.
{
"@type": "CollectRequest",
"data_source_type": [
"oracledb"
],
"tech_choice": "spark",
"delta_data": false,
"storage_details": [
{
"@type": "StorageDetails",
"path": "/mnt/data_services/",
"output_file_type": "json",
"storage_type": "pvc"
}
],
"query_builder": [
{
"@type": "QueryBuilder",
"queries": [
{
"@type": "QueryList",
"name": "account_data",
"query": "select a.poid_id0 as acct_cd, a.currency as crncy_cd, b.country as cntry_name, b.state as state_name, b.city as city_name from account_t a left join account_nameinfo_t b on b.obj_id0 = a.poid_id0 where b.country <> 'null'"
},
{
"@type": "QueryList",
"name": "msisdn_data",
"query": "select s.account_obj_id0, s.poid_type, a.name as msisdn from service_t s left join service_alias_list_t a on a.obj_id0 = s.poid_id0 where a.rec_id = 0"
},
{
"@type": "QueryList",
"name": "balance_group_data",
"query": "select d.poid_id0 as bal_grp_cd, d.ACCOUNT_OBJ_ID0 as acct_cd, b.rec_id2 as acct_bal_typ_cd, b.VALID_TO as bal_expry_dt, e.VALID_FROM as bal_begin_dt, e.CURRENT_BAL as bal_amt, e.GRANTED_BAL as orgnl_bkt_amt, e.GRANTOR_OBJ_ID0 as prod_sbrp_cd, e.GRANTOR_OBJ_TYPE as prod_sbrp_typ_cd from bal_grp_t d left join bal_grp_sub_bals_t e on e.obj_id0 = d.poid_id0 inner join (select rec_id2, max(valid_to) as valid_to from bal_grp_sub_bals_t group by rec_id2) b on e.rec_id2 = b.rec_id2 and e.valid_to = b.valid_to"
},
{
"@type": "QueryList",
"name": "service_data",
"query": "select ACCOUNT_OBJ_ID0 as acct_cd, BAL_GRP_OBJ_ID0 as bal_grp_cd, poid_id0 as ser_srvc_cd, poid_type as ser_srvc_typ_cd, name as ser_srvc_name from service_t where poid_type not like '%/pcm_client' and poid_type not like '%/admin_client'"
},
{
"@type": "QueryList",
"name": "purchased_product_data",
"query": "select ACCOUNT_OBJ_ID0 as acct_cd, CYCLE_START_T as cycl_strt_dt, CYCLE_END_T as cycl_end_dt, PLAN_OBJ_ID0 as prod_ofr_cd, PRODUCT_OBJ_ID0 as prod_spec_cd, POID_ID0 as prod_sbrp_cd, PURCHASE_START_T as prod_sbrp_strt_dt, PURCHASE_END_T as prod_sbrp_end_dt, SERVICE_OBJ_ID0 as ser_srvc_cd, DEAL_OBJ_ID0 as deal_cd from purchased_product_t"
},
{
"@type": "QueryList",
"name": "product_data",
"query": "select poid_id0 as prod_spec_cd, name as shrt_name, permitted from product_t"
},
{
"@type": "QueryList",
"name": "deal_data",
"query": "select d.poid_id0 as deal_cd, d.permitted, d.name, p.PRODUCT_OBJ_ID0 as prod_spec_cd from deal_t d left join deal_products_t p on p.obj_id0 = d.poid_id0"
},
{
"@type": "QueryList",
"name": "plan_data",
"query": "select distinct p.POID_ID0 as prod_ofr_cd, p.NAME as prod_ofr_name, d.PERMITTED as srvc_typ_cd, pd.DEAL_OBJ_ID0 as deal_cd from PLAN_T p left join PLAN_SERVICES_DEALS_T pd on pd.OBJ_ID0 = p.POID_ID0 left join DEAL_T d on d.POID_ID0 = pd.DEAL_OBJ_ID0"
},
{
"@type": "QueryList",
"name": "rate_data",
"query": "select r.POID_ID0 as prod_ofr_price_cd, r.RATE_PLAN_OBJ_ID0 as prod_ofr_price_typ_cd, rp.PRODUCT_OBJ_ID0 as prod_spec_cd, rp.EVENT_TYPE as evt_typ_cd, rb.ELEMENT_ID as elmnt_cd, rb.SCALED_AMOUNT as scaled_amt from rate_t r left join rate_plan_t rp on rp.POID_ID0 = r.RATE_PLAN_OBJ_ID0 left join rate_bal_impacts_t rb on rb.obj_id0 = r.POID_ID0"
},
{
"@type": "QueryList",
"name": "event_data",
"query": "select i.ACCOUNT_OBJ_ID0 as acct_cd, i.OFFERING_OBJ_ID0 as prod_ofr_cd, i.PRODUCT_OBJ_ID0 as prod_spec_cd, i.RESOURCE_ID as acct_bal_typ_cd, e.SERVICE_OBJ_TYPE as service_type, sum(e.net_quantity) as usage from event_t e left join event_bal_impacts_t i on i.OBJ_ID0 = e.POID_ID0 where i.OFFERING_OBJ_ID0 <> 0 group by i.ACCOUNT_OBJ_ID0, i.OFFERING_OBJ_ID0, i.PRODUCT_OBJ_ID0, i.RESOURCE_ID, e.SERVICE_OBJ_TYPE"
},
{
"@type": "QueryList",
"name": "deal_data_2",
"query": "select i.ACCOUNT_OBJ_ID0 as acct_cd, i.OFFERING_OBJ_ID0 as prod_ofr_cd, p.DEAL_OBJ_ID0 as deal_cd from event_bal_impacts_t i left join event_t e on i.OBJ_ID0 = e.POID_ID0 left join purchased_product_t p on p.POID_ID0 = i.OFFERING_OBJ_ID0 where e.POID_TYPE = '/event/billing/product/fee/cycle/cycle_forward_monthly' and i.OFFERING_OBJ_ID0 <> 0"
},
{
"@type": "QueryList",
"name": "over_usage_data",
"query": "select i.ACCOUNT_OBJ_ID0 as acct_cd, i.OFFERING_OBJ_ID0 as prod_ofr_cd, i.PRODUCT_OBJ_ID0 as prod_spec_cd, EXTRACT(MONTH FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400)) as MONTH, EXTRACT(YEAR FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400)) as YEAR, e.SERVICE_OBJ_ID0 as srvc_cd, sum(i.AMOUNT) as amt, sum (e.NET_QUANTITY) / ABS(NULLIF(rb.SCALED_AMOUNT, 0)) as USAGE_OVER_GRANT from event_bal_impacts_t i left join event_t e on i.OBJ_ID0 = e.POID_ID0 left join rate_plan_t rp on rp.PRODUCT_OBJ_ID0 = i.PRODUCT_OBJ_ID0 left join rate_t r on rp.POID_ID0 = r.RATE_PLAN_OBJ_ID0 left join rate_bal_impacts_t rb on rb.obj_id0 = r.poid_id0 where rp.event_type = '/event/billing/product/fee/cycle/cycle_forward_monthly' and e.POID_TYPE like '/event/session%' and e.service_obj_type <> '/service/pcm_client' and i.OFFERING_OBJ_ID0 <> 0 group by i.ACCOUNT_OBJ_ID0, i.OFFERING_OBJ_ID0, e.SERVICE_OBJ_ID0, i.PRODUCT_OBJ_ID0, rb.SCALED_AMOUNT, EXTRACT(MONTH FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400)), EXTRACT(YEAR FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400))"
},
{
"@type": "QueryList",
"name": "usage_details",
"query": "select i.ACCOUNT_OBJ_ID0 as acct_cd, i.OFFERING_OBJ_ID0 as prod_ofr_cd, i.PRODUCT_OBJ_ID0 as prod_spec_cd, i.RESOURCE_ID as acct_bal_typ_cd, EXTRACT(MONTH FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400)) as MONTH, EXTRACT(YEAR FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400)) as YEAR, e.SERVICE_OBJ_ID0 as srvc_cd, substr(e.SERVICE_OBJ_TYPE, instr (e.SERVICE_OBJ_TYPE, '/', -1) + 1) as ser_srvc_name, sum (e.NET_QUANTITY) / ABS(NULLIF(rb.SCALED_AMOUNT, 0)) as USAGE from event_bal_impacts_t i left join event_t e on i.OBJ_ID0 = e.POID_ID0 left join rate_plan_t rp on rp.PRODUCT_OBJ_ID0 = i.PRODUCT_OBJ_ID0 left join rate_t r on rp.POID_ID0 = r.RATE_PLAN_OBJ_ID0 left join rate_bal_impacts_t rb on rb.obj_id0 = r.poid_id0 where rp.event_type = '/event/billing/product/fee/cycle/cycle_forward_monthly' and e.POID_TYPE like '/event/session%' and i.RESOURCE_ID <> 840 and e.service_obj_type <> '/service/pcm_client' and i.OFFERING_OBJ_ID0 <> 0 group by i.ACCOUNT_OBJ_ID0, i.OFFERING_OBJ_ID0, e.SERVICE_OBJ_ID0, i.PRODUCT_OBJ_ID0, rb.SCALED_AMOUNT, e.SERVICE_OBJ_TYPE, i.RESOURCE_ID, EXTRACT(MONTH FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400)), EXTRACT(YEAR FROM (TO_DATE('01/01/1970', 'dd/mm/yyyy') + e.CREATED_T/86400))"
}
],
"join_condition": [
{
"@type": "JoinConditions",
"name": "joined_data",
"join": [
"service_data",
"purchased_product_data"
]
},
{
"@type": "JoinConditions",
"name": "left_join_1",
"join": [
"event_data",
"purchased_product_data"
],
"join_type": "left",
"join_column": [
"acct_cd_1",
"acct_cd"
]
}
]
}
]
}
Example of Response Body
If successful, the response code 200 is returned with a response body. For example:
{
"@type": "CollectResponse",
"status": "Data Fetch Successful"
}