Jump to

• Request
• Response
• Examples

Delete a Usage Consumption Object

delete

{apiRoot}/queryUsageConsumption/{id}

Deletes the usage consumption object specified by the ID.

Request

Path Parameters

• id(required): string
  The ID of the usage consumption object.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json;charset=utf-8

204 Response

The usage consumption object was deleted successfully.

400 Response

The request isn't valid.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

401 Response

The client doesn't have the correct privileges.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

403 Response

The request wasn't authorized.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

404 Response

The server couldn't find the requested object.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

405 Response

This method isn't supported for the requested resource.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

409 Response

The request couldn't be processed due to a conflict. An item already exists.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

500 Response

An internal server error occurred.

Body ()

Root Schema : Error

Type: object

An error.

Show Source

• @baseType: string
  When sub-classing, this defines the super class.
• @schemaLocation: string (uri)
  The 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
  The error code, which contains application-relevant detail.
• message: string
  Additional details about the error as well as possible corrective actions.
• reason(required): string
  The reason for the error that can be shown to a client user.
• referenceError: string (uri)
  The URI to the documentation describing the error.
• status: string
  The HTTP error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"The error code, which contains application-relevant detail."
        },
        "reason":{
            "type":"string",
            "description":"The reason for the error that can be shown to a client user."
        },
        "message":{
            "type":"string",
            "description":"Additional details about the error as well as possible corrective actions."
        },
        "status":{
            "type":"string",
            "description":"The HTTP error code extension."
        },
        "referenceError":{
            "type":"string",
            "description":"The URI to the documentation describing the error.",
            "format":"uri"
        },
        "@baseType":{
            "type":"string",
            "description":"When sub-classing, this defines the super class."
        },
        "@schemaLocation":{
            "type":"string",
            "description":"The 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":"An error."
}

Back to Top

Examples

The following example shows how to delete a usage consumption object by submitting a DELETE request on the REST resource using cURL. For more information about cURL, see "Use cURL".

curl -X DELETE "apiroot/queryUsageConsumption/6500000427" -H "accept: */*"

where apiRoot is for accessing the HTTP Gateway server at either http://hostname:httpPort or https://hostname:httpsPort.

Example of Response Body

If successful, the response code 204 is returned with no response body.

If the request fails, the response includes the appropriate HTTP code. For a 4xx/5xx code, the message body also contains a ProblemDetails structure with the cause attribute set to the appropriate application error.

Back to Top