Create or update a service specification
put
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/serviceCatalogManagement/v3/serviceSpecification/{id}
Request
Path Parameters
-
id(required): string
The unique identifier of the resource item.
Supported Media Types
- application/json
Root Schema : ServiceSpecificationOracle
Title:
ServiceSpecificationOracle
Match All
Show Source
-
object
ServiceSpecification
Title:
ServiceSpecification
Discriminator:{ "propertyName":"@type", "mapping":{ "ServiceSpecification":"#/components/schemas/ServiceSpecification", "ServiceSpecificationOracle":"#/components/schemas/ServiceSpecificationOracle" } }
ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instantiated. By sharing the same specification, these services would therefore share the same set of characteristics. -
object
type
Nested Schema : ServiceSpecification
Type:
object
Title:
ServiceSpecification
Discriminator: @type
Discriminator Values
ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instantiated. By sharing the same specification, these services would therefore share the same set of characteristics.
Show Source
-
@baseType: string
Immediate base (class) type of the Service Specification
-
@schemaLocation: string
A link to the schema describing this Service Specification
-
@type: string
Class type of the Service Specification
-
attachment: array
attachment
-
description: string
A string. A narrative that explains in detail what the service specification is.
-
href: string
A string. Reference of the service specification.
-
id: string
Maximum Length:
30
A string. Unique identifier of the service specification. -
isBundle: boolean
A boolean. isBundle determines whether a ServiceSpecification represents a single ServiceSpecification (false), or a bundle of ServiceSpecification (true).
-
lastUpdate: string
(date-time)
A date time (DateTime). Date and time of the last update of the service specification.
-
lifecycleStatus: string
A string. Used to indicate the current lifecycle status of the service specification.
-
name(required): string
A string. Name of the service specification.
- relatedParty: array relatedParty
-
resourceSpecification: array
resourceSpecification
-
serviceLevelSpecification: array
serviceLevelSpecification
-
serviceSpecCharacteristic: array
serviceSpecCharacteristic
-
serviceSpecRelationship: array
serviceSpecRelationship
-
targetServiceSchema: object
TargetServiceSchema
Title:
TargetServiceSchema
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
A string. Service specification version.
Nested Schema : type
Type:
Show Source
object
-
applicationName: string
name of the external application
-
created: string
(date-time)
Date and time of creation
-
createdBy: string
name of the person who created
-
externalId: string
id of the external application
-
lastUpdatedBy: string
name of the person who updated
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
serviceCode: string
Code to service specification
-
versionState: number
Version state of the Service Specification
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
Project Reference
Show Source
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the project
-
name: string
Name of the project
-
version: string
Version of the project
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : ServiceSpecificationOracle
Title:
ServiceSpecificationOracle
Match All
Show Source
-
object
ServiceSpecification
Title:
ServiceSpecification
Discriminator:{ "propertyName":"@type", "mapping":{ "ServiceSpecification":"#/components/schemas/ServiceSpecification", "ServiceSpecificationOracle":"#/components/schemas/ServiceSpecificationOracle" } }
ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instantiated. By sharing the same specification, these services would therefore share the same set of characteristics. -
object
type
Nested Schema : ServiceSpecification
Type:
object
Title:
ServiceSpecification
Discriminator: @type
Discriminator Values
ServiceSpecification is a class that offers characteristics to describe a type of service. Functionally, it acts as a template by which Services may be instantiated. By sharing the same specification, these services would therefore share the same set of characteristics.
Show Source
-
@baseType: string
Immediate base (class) type of the Service Specification
-
@schemaLocation: string
A link to the schema describing this Service Specification
-
@type: string
Class type of the Service Specification
-
attachment: array
attachment
-
description: string
A string. A narrative that explains in detail what the service specification is.
-
href: string
A string. Reference of the service specification.
-
id: string
Maximum Length:
30
A string. Unique identifier of the service specification. -
isBundle: boolean
A boolean. isBundle determines whether a ServiceSpecification represents a single ServiceSpecification (false), or a bundle of ServiceSpecification (true).
-
lastUpdate: string
(date-time)
A date time (DateTime). Date and time of the last update of the service specification.
-
lifecycleStatus: string
A string. Used to indicate the current lifecycle status of the service specification.
-
name(required): string
A string. Name of the service specification.
- relatedParty: array relatedParty
-
resourceSpecification: array
resourceSpecification
-
serviceLevelSpecification: array
serviceLevelSpecification
-
serviceSpecCharacteristic: array
serviceSpecCharacteristic
-
serviceSpecRelationship: array
serviceSpecRelationship
-
targetServiceSchema: object
TargetServiceSchema
Title:
TargetServiceSchema
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
A string. Service specification version.
Nested Schema : type
Type:
Show Source
object
-
applicationName: string
name of the external application
-
created: string
(date-time)
Date and time of creation
-
createdBy: string
name of the person who created
-
externalId: string
id of the external application
-
lastUpdatedBy: string
name of the person who updated
-
project: object
ProjectRef
Title:
ProjectRef
Project Reference -
serviceCode: string
Code to service specification
-
versionState: number
Version state of the Service Specification
Nested Schema : ProjectRef
Type:
object
Title:
ProjectRef
Project Reference
Show Source
-
href: string
Unique reference of the project
-
id(required): string
Unique identifier of the project
-
name: string
Name of the project
-
version: string
Version of the project
400 Response
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
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
404 Response
Your request includes a resource URI that doesn't exist.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
object
Title:
Show Source
Error
-
@schemaLocation: string
It provides a link to the schema describing a REST resource.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list)
-
message: string
Text that provide more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
Text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
url pointing to documentation describing the error
-
status: string
http error code extension like 400-2
Examples
The following example shows how to create or update a service specification by submitting a PUT request on the REST resource using cURL. In this example, we will add a resource specification to the service specification.
curl PUT "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/serviceCatalogManagement/v3/serviceSpecification/Serv_Spec_132"
Example of Request Body
The following shows an example of the request body.
{ "id": "Test_ServicSpec_30032022334", "name": "Test_ServicSpec_30032022334", "description": "Service specification for Test_ServicSpec_30032022334" }
Example of Response Body
The following shows an example of the response body.
{ "id": "Test_ServicSpec_30032022334", "name": "Test_ServicSpec_30032022334", "description": "Service specification for Test_ServicSpec_30032022334", "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/serviceCatalogManagement/v3/serviceSpecification/Test_ServicSpec_30032022334/Test_ServicSpec_30032022334", "version": "1.0", "lifecycleStatus": "", "created": "2022-03-30T11:36:53.000Z", "createdBy": "booth", "lastUpdate": "2022-05-27T07:25:37.000Z", "lastUpdatedBy": "booth", "isBundle": false, "@type": "ServiceSpecificationOracle" }