Partially Update a Billing Cycle Specification
/billingCycleSpecification/{id}
Request
-
id(required): string
The resource's ID.
-
fields: string
Specifies the comma-separated properties to include in the response.
- application/json-patch+json
- application/json
- application/merge-patch+json
- application/json-patch-query+json
array-
Array of:
object JsonPatch
A JSON Patch document as defined by RFC 6902.
object-
from: string
A string that contains a JSON Pointer value.
-
op(required): string
Allowed Values:
[ "add", "remove", "replace", "move", "copy", "test" ]The operation to perform. -
path(required): string
A JSON Pointer.
-
value:
The value to use in the operation.
array-
Array of:
object JsonPatch
A JSON Patch document as defined by RFC 6902.
object-
from: string
A string that contains a JSON Pointer value.
-
op(required): string
Allowed Values:
[ "add", "remove", "replace", "move", "copy", "test" ]The operation to perform. -
path(required): string
A JSON Pointer.
-
value:
The value to use in the operation.
-
object
allOf
Entity_MVO
Represents a base entity schema for TM Forum Open APIs.
-
object
type
Describes when to initiate a billing cycle and its substeps.
object-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
billingDateShift: integer
The billing or settlement date offset, expressed in days from the start of the billing or settlement period.
-
description: string
The billing cycle specification's explanatory text.
-
frequency: string
The billing cycle frequency, for example monthly.
-
name: string
The billing cycle specification's short descriptive name.
-
paymentDueDateOffset: integer
The payment due date offset, expressed in days from the start of the billing period.
-
object
allOf
Entity_MVO
Represents a base entity schema for TM Forum Open APIs.
-
object
BillingCycleSpecificationOracle_MVO-allOf[1]
Describes when to initiate a billing cycle and its substeps.
-
object
allOf
Entity_MVO
Represents a base entity schema for TM Forum Open APIs.
-
object
type
Describes when to initiate a billing cycle and its substeps.
object-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
billingDateShift: integer
The billing or settlement date offset, expressed in days from the start of the billing or settlement period.
-
description: string
The billing cycle specification's explanatory text.
-
frequency: string
Allowed Values:
[ "monthly", "bi-monthly", "quarterly", "semiyearly", "yearly" ]The billing cycle frequency, for example monthly. -
name: string
The billing cycle specification's short descriptive name.
-
paymentDueDateOffset: integer
The payment due date offset, expressed in days from the start of the billing period.
-
validFor: object
TimePeriod
Represents a time period with a start date, an end date, or both.
object-
endDateTime: string
(date-time)
The end of the time period in IETF RFC 3339 format.Example:
1985-04-12T23:20:50.52Z -
startDateTime: string
(date-time)
The start of the time period in IETF RFC 3339 format.Example:
1985-04-12T23:20:50.52Z
object-
billingDateShift: integer
The billing or settlement date offset, expressed in days from the start of the billing or settlement period.
-
description: string
The billing cycle specification's explanatory text.
-
frequency: string
The billing cycle frequency, for example monthly.
-
name: string
The billing cycle specification's short descriptive name.
-
paymentDueDateOffset: integer
The payment due date offset, expressed in days from the start of the billing period.
Response
200 Response
-
object
allOf
Entity
Represents a base entity schema for TM Forum Open APIs.
-
object
BillingCycleSpecification-allOf[1]
Describes when to initiate a billing cycle and its substeps.
-
object
allOf
Entity
Represents a base entity schema for TM Forum Open APIs.
-
object
BillingCycleSpecificationOracle-allOf[1]
Describes when to initiate a billing cycle and its substeps.
object-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Addressable
Defines a base schema for addressable entities.
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
href: string
The hyperlink reference.
-
id: string
The ID.
object-
billingDateShift: integer
The billing or settlement date offset, expressed in days from the start of the billing or settlement period.
-
description: string
The billing cycle specification's explanatory text.
-
frequency: string
The billing cycle frequency, for example monthly.
-
name: string
The billing cycle specification's short descriptive name.
-
paymentDueDateOffset: integer
The payment due date offset, expressed in days from the start of the billing period.
object-
billingDateShift: integer
The billing or settlement date offset, expressed in days from the start of the billing or settlement period.
-
description: string
The billing cycle specification's explanatory text.
-
frequency: string
Allowed Values:
[ "monthly", "bi-monthly", "quarterly", "semiyearly", "yearly" ]The billing cycle frequency, for example monthly. -
name: string
The billing cycle specification's short descriptive name.
-
paymentDueDateOffset: integer
The payment due date offset, expressed in days from the start of the billing period.
202 Response
400 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
401 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
403 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
404 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
405 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
409 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
500 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
501 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
503 Response
-
object
Extensible
Represents a base extensible schema for TM Forum Open APIs. The entity must include @type.
-
object
Error-allOf[1]
object-
@baseType: string
The superclass.
-
@schemaLocation: string
The URI of a JSON Schema file that defines additional attributes and relationships.
-
@type(required): string
The subclass Extensible name.
object-
code(required): string
The application-specific error detail defined by the API or a common list.
-
message: string
Provides error details and corrective actions for a client user.
-
reason(required): string
Explains the error to a client user.
-
referenceError: string
The URI of documentation that describes the error.
-
status: string
The HTTP error code extension.
Examples
Example 1: Update the Description
The following example shows how to update the description for a billing cycle specification by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X PATCH 'http://host:port/brm/accountManagement/version/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591'
Request Body
The following is an example of the request body in JSON format.
{
"description": "patching description"
}
Response Body
The following is an example of the response body in JSON format.
{
"id": "0.0.0.1+-config-bill_cycle_specification+13591",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591",
"@type": "BillingCycleSpecification",
"name": "Post BCS-1-test-005",
"description": "patching description",
"billingDateShift": 4,
"frequency": "yearly",
"paymentDueDateOffset": 30
}
Example 2: Update the billingDateShift
The following example shows how to update the billingDateShift for a billing cycle specification by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X PATCH 'http://host:port/brm/accountManagement/version/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591'
Request Body
The following is an example of the request body in JSON format.
{
"billingDateShift": 14
}
Response Body
The following is an example of the response body in JSON format.
{
"id": "0.0.0.1+-config-bill_cycle_specification+13591",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591",
"@type": "BillingCycleSpecification",
"name": "Post BCS-1-test-005",
"description": "patching description",
"billingDateShift": 14,
"frequency": "yearly",
"paymentDueDateOffset": 30
}
Example 3: Update the paymentDueDateOffset
The following example shows how to update the paymentDueDateOffset for a billing cycle specification by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X PATCH 'http://host:port/brm/accountManagement/version/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591'
Request Body
The following is an example of the request body in JSON format.
{
"paymentDueDateOffset": 22
}
Response Body
The following is an example of the response body in JSON format.
{
"id": "0.0.0.1+-config-bill_cycle_specification+13591",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591",
"@type": "BillingCycleSpecification",
"name": "Post BCS-1-test-005",
"description": "patching description",
"billingDateShift": 14,
"frequency": "yearly",
"paymentDueDateOffset": 22
}
Example 4: Update the Frequency
The following example shows how to update the frequency for a billing cycle specification by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X PATCH 'http://host:port/brm/accountManagement/version/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591'
Request Body
The following is an example of the request body in JSON format.
{
"frequency": "monthly"
}
Response Body
The following is an example of the response body in JSON format.
{
"id": "0.0.0.1+-config-bill_cycle_specification+13591",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/0.0.0.1+-config-bill_cycle_specification+13591",
"@type": "BillingCycleSpecification",
"name": "Post BCS-1-test-005",
"description": "patching description",
"billingDateShift": 14,
"frequency": "monthly",
"paymentDueDateOffset": 22
}