REST API Reference for Oracle Communications Order and Service Management Cloud Native

Cancel a Service Order

post

https://serverRoot/tmf-api/serviceOrdering/v4.1.0.1.0/cancelServiceOrder

This operation creates a CancelServiceOrder entity.

Request

There are no request parameters for this operation.

Supported Media Types

application/json;charset=utf-8

Root Schema : schema

Type: object

Request for the cancellation of an existing Service order. Skipped properties: id,href,state,effectiveCancellationDate,completionMessage,errorMessage

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: string

When sub-classing, this defines the sub-class Extensible name.
cancellationReason: string

Reason why the order is cancelled.
requestedCancellationDate: string (date-time)

Date when the submitter wants the order to be cancelled.
serviceOrder(required): object ServiceOrderRef

Service Order reference. Useful to understand through which Service order the service was instantiated in the service inventory.

{
    "required":[
        "serviceOrder"
    ],
    "type":"object",
    "properties":{
        "cancellationReason":{
            "type":"string",
            "description":"Reason why the order is cancelled."
        },
        "requestedCancellationDate":{
            "type":"string",
            "description":"Date when the submitter wants the order to be cancelled.",
            "format":"date-time"
        },
        "serviceOrder":{
            "$ref":"#/components/schemas/ServiceOrderRef"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class Extensible name."
        }
    },
    "description":"Request for the cancellation of an existing Service order.\nSkipped properties: id,href,state,effectiveCancellationDate,completionMessage,errorMessage"
}

Nested Schema : ServiceOrderRef

Type: object

Service Order reference. Useful to understand through which Service order the service was instantiated in the service inventory.

Show Source

@baseType: string

When sub-classing, this defines the super-class.
@referredType: string

The actual type of the target instance when needed for disambiguation.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

When sub-classing, this defines the sub-class Extensible name.
href: string (uri)

Hyperlink reference.
id(required): string

Unique identifier.
name: string

Name of the related service order.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier."
        },
        "href":{
            "type":"string",
            "description":"Hyperlink reference.",
            "format":"uri"
        },
        "name":{
            "type":"string",
            "description":"Name of the related service order."
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class Extensible name."
        },
        "@referredType":{
            "type":"string",
            "description":"The actual type of the target instance when needed for disambiguation."
        }
    },
    "description":"Service Order reference. Useful to understand through which Service order the service was instantiated in the service inventory."
}

Response

Supported Media Types

application/json;charset=utf-8

201 Response

Created

Root Schema : CancelServiceOrder

Type: object

Request for cancellation an existing Service order.

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: string

When sub-classing, this defines the sub-class Extensible name.
cancellationReason: string

Reason why the order is cancelled.
completionMessage: string

An optional message describing the completion of the task if it is done as expected or it is denied for a reason (such as an order in PoNR state).
effectiveCancellationDate: string (date-time)

Date when the order is cancelled.
errorMessage: object ErrorMessage

Represents an error.
href: string (uri)

Hyperlink reference
id: string

unique identifier
requestedCancellationDate: string (date-time)

Date when the submitter wants the order to be cancelled.
serviceOrder: object ServiceOrderRef

Service Order reference. Useful to understand through which Service order the service was instantiated in the service inventory.
state: string

Allowed Values: [ "acknowledged", "terminatedWithError", "inProgress", "done", "queued", "terminated", "skipped" ]

Possible values for the state of a task.

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"unique identifier"
        },
        "href":{
            "type":"string",
            "description":"Hyperlink reference",
            "format":"uri"
        },
        "cancellationReason":{
            "type":"string",
            "description":"Reason why the order is cancelled."
        },
        "completionMessage":{
            "type":"string",
            "description":"An optional message describing the completion of the task if it is done as expected or it is denied for a reason (such as an order in PoNR state)."
        },
        "effectiveCancellationDate":{
            "type":"string",
            "description":"Date when the order is cancelled.",
            "format":"date-time"
        },
        "requestedCancellationDate":{
            "type":"string",
            "description":"Date when the submitter wants the order to be cancelled.",
            "format":"date-time"
        },
        "errorMessage":{
            "$ref":"#/components/schemas/ErrorMessage"
        },
        "serviceOrder":{
            "$ref":"#/components/schemas/ServiceOrderRef"
        },
        "state":{
            "$ref":"#/components/schemas/TaskStateType"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class Extensible name."
        }
    },
    "description":"Request for cancellation an existing Service order."
}

Nested Schema : ErrorMessage

Type: object

Represents an error.

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: string

When sub-classing, this defines the sub-class Extensible name.
code: string

error code
message: string

More details and corrective actions related to the error.
reason: string

Explanation of the reason for the error.
referenceError: string (uri)

URI of documentation describing the error.
status: string

Error code extension. (Example, sys-ABC-2001)

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"error code"
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "description":"Error code extension. (Example, sys-ABC-2001)"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class Extensible name."
        }
    },
    "description":"Represents an error."
}

Nested Schema : ServiceOrderRef

Type: object

Service Order reference. Useful to understand through which Service order the service was instantiated in the service inventory.

Show Source

@baseType: string

When sub-classing, this defines the super-class.
@referredType: string

The actual type of the target instance when needed for disambiguation.
@schemaLocation: string (uri)

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

When sub-classing, this defines the sub-class Extensible name.
href: string (uri)

Hyperlink reference.
id(required): string

Unique identifier.
name: string

Name of the related service order.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier."
        },
        "href":{
            "type":"string",
            "description":"Hyperlink reference.",
            "format":"uri"
        },
        "name":{
            "type":"string",
            "description":"Name of the related service order."
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class Extensible name."
        },
        "@referredType":{
            "type":"string",
            "description":"The actual type of the target instance when needed for disambiguation."
        }
    },
    "description":"Service Order reference. Useful to understand through which Service order the service was instantiated in the service inventory."
}

400 Response

Bad Request

Root Schema : Error

Type: object

Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx).

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: string

When sub-classing, this defines the sub-class entity name.
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 shown to a client user.
reason(required): string

Explanation of the reason for the error shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
state: string

HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error shown to a client user."
        },
        "state":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class entity name."
        }
    },
    "description":"Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx)."
}

401 Response

Unauthorized

Root Schema : Error

Type: object

Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx).

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: string

When sub-classing, this defines the sub-class entity name.
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 shown to a client user.
reason(required): string

Explanation of the reason for the error shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
state: string

HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error shown to a client user."
        },
        "state":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class entity name."
        }
    },
    "description":"Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx)."
}

403 Response

Forbidden

Root Schema : Error

Type: object

Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx).

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: string

When sub-classing, this defines the sub-class entity name.
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 shown to a client user.
reason(required): string

Explanation of the reason for the error shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
state: string

HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error shown to a client user."
        },
        "state":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class entity name."
        }
    },
    "description":"Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx)."
}

405 Response

Method Not allowed

Root Schema : Error

Type: object

Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx).

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: string

When sub-classing, this defines the sub-class entity name.
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 shown to a client user.
reason(required): string

Explanation of the reason for the error shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
state: string

HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error shown to a client user."
        },
        "state":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class entity name."
        }
    },
    "description":"Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx)."
}

409 Response

Conflict

Root Schema : Error

Type: object

Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx).

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: string

When sub-classing, this defines the sub-class entity name.
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 shown to a client user.
reason(required): string

Explanation of the reason for the error shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
state: string

HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error shown to a client user."
        },
        "state":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class entity name."
        }
    },
    "description":"Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx)."
}

500 Response

Internal Server Error

Root Schema : Error

Type: object

Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx).

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: string

When sub-classing, this defines the sub-class entity name.
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 shown to a client user.
reason(required): string

Explanation of the reason for the error shown to a client user.
referenceError: string (uri)

URI of documentation describing the error.
state: string

HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common list."
        },
        "reason":{
            "type":"string",
            "description":"Explanation of the reason for the error shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error shown to a client user."
        },
        "state":{
            "type":"string",
            "description":"HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super-class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "description":"When sub-classing, this defines the sub-class entity name."
        }
    },
    "description":"Used when an API throws an error. Typically, with an HTTP error response-code (3xx, 4xx, 5xx)."
}