Create a Product Specification
post
https://{hostname}:{port}/scd/tmf-api/productCatalogManagement/v5/productSpecification
This operation creates a Product Specification entity.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ProductSpecificationOracle
Title:
ProductSpecificationOracle
Match All
Show Source
-
object
ProductSpecification
Title:
ProductSpecification
Discriminator:{ "propertyName":"@type", "mapping":{ "ProductSpecification":"#/components/schemas/ProductSpecification", "ProductSpecificationOracle":"#/components/schemas/ProductSpecificationOracle" } }
-
object
properties
Nested Schema : ProductSpecification
Type:
object
Title:
ProductSpecification
Discriminator: @type
Discriminator Values
Show Source-
@baseType: string
base class type (immediate parent) of the product specification
-
@schemaLocation: string
hyperlink reference to schema describing this object
-
@type: string
class type of the product specification
-
attachment: array
attachment
-
brand: string
The manufacturer or trademark of the specification
-
bundledProductSpecification: array
bundledProductSpecification
-
description: string
A narrative that explains in detail what the product specification is
-
href: string
Reference of the product specification
-
id: string
Maximum Length:
30
Unique identifier of the product specification -
isBundle: boolean
isBundle determines whether a productSpecification represents a single productSpecification (false), or a bundle of productSpecification (true).
-
lastUpdate(required): string
(date-time)
Date and time of the last update
-
lifecycleStatus(required): string
Used to indicate the current lifecycle status
-
name(required): string
Name of the product specification
-
productNumber: string
An identification number assigned to uniquely identity the specification
-
productSpecCharacteristic: array
productSpecCharacteristic
-
productSpecificationRelationship: array
productSpecificationRelationship
- relatedParty: array relatedParty
-
resourceSpecification: array
resourceSpecification
-
serviceSpecification: array
serviceSpecification
-
targetProductSchema: object
TargetProductSchema
Title:
TargetProductSchema
The reference object to the schema and type of target product which is described by product specification -
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
Product specification version
Nested Schema : properties
Type:
Show Source
object
-
created: string
(date-time)
Date and time of the creation
-
createdBy: string
name of the person who created item
-
lastUpdatedBy: string
name of the person who updated item
-
project(required): object
ProjectRef
Title:
ProjectRef
The existing project is retrieved by ID or name. If the project doesn't exist, a new project is created with the specified name and ID.
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
The existing project is retrieved by ID or name. If the project doesn't exist, a new project is created with the specified name and ID.
Show Source
-
href: string
Unique reference of the project/initiative
-
id: string
Unique identifier of the project/initiative
-
name: string
Name of the project/initiative. It is required to create a new project
-
version: string
Version of the project/initiative
Response
Supported Media Types
- application/json
201 Response
Created: Your request is successful and a new resource has been created.
Root Schema : schema
Type:
Show Source
array
-
Array of:
ProductSpecificationOracle
Title:
ProductSpecificationOracle
Nested Schema : ProductSpecificationOracle
Title:
ProductSpecificationOracle
Match All
Show Source
-
object
ProductSpecification
Title:
ProductSpecification
Discriminator:{ "propertyName":"@type", "mapping":{ "ProductSpecification":"#/components/schemas/ProductSpecification", "ProductSpecificationOracle":"#/components/schemas/ProductSpecificationOracle" } }
-
object
properties
Nested Schema : ProductSpecification
Type:
object
Title:
ProductSpecification
Discriminator: @type
Discriminator Values
Show Source-
@baseType: string
base class type (immediate parent) of the product specification
-
@schemaLocation: string
hyperlink reference to schema describing this object
-
@type: string
class type of the product specification
-
attachment: array
attachment
-
brand: string
The manufacturer or trademark of the specification
-
bundledProductSpecification: array
bundledProductSpecification
-
description: string
A narrative that explains in detail what the product specification is
-
href: string
Reference of the product specification
-
id: string
Maximum Length:
30
Unique identifier of the product specification -
isBundle: boolean
isBundle determines whether a productSpecification represents a single productSpecification (false), or a bundle of productSpecification (true).
-
lastUpdate(required): string
(date-time)
Date and time of the last update
-
lifecycleStatus(required): string
Used to indicate the current lifecycle status
-
name(required): string
Name of the product specification
-
productNumber: string
An identification number assigned to uniquely identity the specification
-
productSpecCharacteristic: array
productSpecCharacteristic
-
productSpecificationRelationship: array
productSpecificationRelationship
- relatedParty: array relatedParty
-
resourceSpecification: array
resourceSpecification
-
serviceSpecification: array
serviceSpecification
-
targetProductSchema: object
TargetProductSchema
Title:
TargetProductSchema
The reference object to the schema and type of target product which is described by product specification -
validFor: object
TimePeriod
Title:
TimePeriod
The period for which the productOffering is valid -
version: string
Product specification version
Nested Schema : properties
Type:
Show Source
object
-
created: string
(date-time)
Date and time of the creation
-
createdBy: string
name of the person who created item
-
lastUpdatedBy: string
name of the person who updated item
-
project(required): object
ProjectRef
Title:
ProjectRef
The existing project is retrieved by ID or name. If the project doesn't exist, a new project is created with the specified name and ID.
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
The existing project is retrieved by ID or name. If the project doesn't exist, a new project is created with the specified name and ID.
Show Source
-
href: string
Unique reference of the project/initiative
-
id: string
Unique identifier of the project/initiative
-
name: string
Name of the project/initiative. It is required to create a new project
-
version: string
Version of the project/initiative
400 Response
Bad Request: Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Root Schema : Error
Title:
Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Match All
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source
-
object
Extensible
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Error":"#/components/schemas/Error" } }
Nested Schema : Discriminator: @type
Type:
object
Discriminator: @type
Discriminator Values
Show Source-
code(required): string
Application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
URI of documentation describing the error.
-
status: string
HTTP Error code extension
Nested Schema : Extensible
Type:
object
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type(required): string
When sub-classing, this defines the sub-class Extensible name
401 Response
Unauthorized: Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Title:
Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Match All
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source
-
object
Extensible
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Error":"#/components/schemas/Error" } }
Nested Schema : Discriminator: @type
Type:
object
Discriminator: @type
Discriminator Values
Show Source-
code(required): string
Application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
URI of documentation describing the error.
-
status: string
HTTP Error code extension
Nested Schema : Extensible
Type:
object
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type(required): string
When sub-classing, this defines the sub-class Extensible name
404 Response
Not Found: Your request includes a resource URI that doesn't exist.
Root Schema : Error
Title:
Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Match All
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source
-
object
Extensible
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Error":"#/components/schemas/Error" } }
Nested Schema : Discriminator: @type
Type:
object
Discriminator: @type
Discriminator Values
Show Source-
code(required): string
Application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
URI of documentation describing the error.
-
status: string
HTTP Error code extension
Nested Schema : Extensible
Type:
object
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type(required): string
When sub-classing, this defines the sub-class Extensible name
405 Response
Method Not Allowed: HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Title:
Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Match All
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source
-
object
Extensible
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Error":"#/components/schemas/Error" } }
Nested Schema : Discriminator: @type
Type:
object
Discriminator: @type
Discriminator Values
Show Source-
code(required): string
Application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
URI of documentation describing the error.
-
status: string
HTTP Error code extension
Nested Schema : Extensible
Type:
object
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type(required): string
When sub-classing, this defines the sub-class Extensible name
500 Response
Internal Server Error: The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Title:
Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Match All
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Show Source
-
object
Extensible
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Error":"#/components/schemas/Error" } }
Nested Schema : Discriminator: @type
Type:
object
Discriminator: @type
Discriminator Values
Show Source-
code(required): string
Application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
URI of documentation describing the error.
-
status: string
HTTP Error code extension
Nested Schema : Extensible
Type:
object
Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
Show Source
-
@baseType: string
When sub-classing, this defines the super-class
-
@schemaLocation: string
(uri)
A URI to a JSON-Schema file that defines additional attributes and relationships
-
@type(required): string
When sub-classing, this defines the sub-class Extensible name