1. REST API Reference for Launch Cloud Service
  2. Tasks
  3. Usage Specification

Get all usage specifications

get

https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/usageManagement/v2/usageSpecification

Request

Query Parameters
  • The description of the resource.
  • Project Id
  • The comma-separated field names that are returned in the response. The field names are the names that you specify when you create or retrieve a resource.
  • The unique identifier of the resource item.
  • The current lifecycle status of the resource.
  • The number of resources to be returned in the response. The minimum value that can be specified is 1, and the maximum value that can be specified is 100,000. If the specified value is greater than 100,000, then it defaults to 100,000.
  • The name of the resource.
  • The record number from which the retrieval starts. The default value is zero. If no value is specified, then it defaults to zero. The value zero indicates that the retrieval will start from the beginning of the collection.
  • The current version of the resource.
  • enrich objects with usedBy information

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

OK
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : UsageSpecificationOracle
Title: UsageSpecificationOracle
Match All
Show Source
  • UsageSpecification
    Title: UsageSpecification
    Discriminator: { "propertyName":"@type", "mapping":{ "UsageSpecification":"#/components/schemas/UsageSpecification", "UsageSpecificationOracle":"#/components/schemas/UsageSpecificationOracle" } }
    The Usage Specification resource represents a set of usage characteristics and relationships.
  • UsageSpecificationOracle-allOf[1]
Nested Schema : UsageSpecification
Type: object
Title: UsageSpecification
Discriminator: @type

Discriminator Values

The Usage Specification resource represents a set of usage characteristics and relationships.
Show Source
Nested Schema : UsageSpecificationOracle-allOf[1]
Type: object
Show Source
Nested Schema : meteringRule
Type: array
Show Source
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
Project Reference
Show Source
Nested Schema : requestSpecification
Type: array
Show Source
  • RequestSpecificationRefOracle
    Title: RequestSpecificationRefOracle
    A list of request level specification references (RequestSpecificationRef [*]). A list of request level specifications related to this usage specification, and which will need to be satisfiable for corresponding usage instances.
Nested Schema : MeteringRule
Type: object
Title: MeteringRule
A metering rule
Show Source
Nested Schema : meteringExpression
Type: array
Show Source
Nested Schema : TimePeriodOracle
Type: object
Title: TimePeriodOracle
Validity period of the related party
Show Source
Nested Schema : MeteringExpression
Type: object
Title: MeteringExpression
A metering expression
Show Source
Nested Schema : meteringExpressionRelationship
Type: object
Show Source
Nested Schema : value
A discrete value that the relationship can take on.
Match One Schema
Show Source
Nested Schema : MeteringExpressionRelationship
Type: object
Title: MeteringExpressionRelationship
An expression relationship
Show Source
Nested Schema : value-oneOf[1]
Type: object
Nested Schema : RequestSpecificationRefOracle
Type: object
Title: RequestSpecificationRefOracle
A list of request level specification references (RequestSpecificationRef [*]). A list of request level specifications related to this usage specification, and which will need to be satisfiable for corresponding usage instances.
Show Source

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.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

401 Response

Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

404 Response

Your request includes a resource URI that doesn't exist.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

405 Response

HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

500 Response

The server encountered something unexpected that prevented it from completing the request.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source
Back to Top

Examples

The following example shows how to get usage specifications by submitting a GET request on the REST resource using cURL. 

Command: curl -u username:password -X GET https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/usageManagement/v2/usageSpecification

Example of Response Body

The following example shows the contents of the response body in JSON format:

[
    {
        "id": "Usage_Spec_1456",
        "name": "Service_Usage",
        "description": "The specification for service call usage.",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/usageManagement/v2/usageSpecification/Usage_Spec_1456",
        "lifecycleStatus": "In design",
        "validFor": {
            "startDateTime": "2020-01-18T00:00:00.000Z",
            "endDateTime": "2021-02-20T16:42:23.000Z"
        },
        "@type": "UsageSpecificationOracle",
        "@baseType": "UsageSpecification",
        "created": "2020-09-29T21:40:16.000Z",
        "createdBy": "booth",
        "lastUpdate": "2020-09-29T21:40:19.000Z",
        "lastUpdatedBy": "booth",
        "version": "1.0",
        "usageSpecCharacteristic": [
            {
                "name": "Size",
                "description": "Size Color",
                "valueType": "STRING",
                "extensible": true,
                "configurable": true,
                "isInvoiceable": true,
                "isServiceId": true,
                "isTransient": false,
                "isUnique": true,
                "regex": "mrregex",
                "minCardinality": 0,
                "maxCardinality": 1,
                "validFor": {
                    "startDateTime": "2020-01-18T00:00:00.000Z",
                    "endDateTime": "2021-02-20T16:42:23.000Z"
                },
                "transient": false,
                "serviceId": true,
                "unique": true,
                "invoiceable": true
            }
        ],
        "project": {
            "id": "Pinnacle_Financials",
            "name": "Pinnacle Financials Implementation"
        }
    },
    ...
]
Back to Top