Consumption Of Licenses

Consumption Of Licenses
License usage upload

Facilitates the upload of VCF Operations usage data. The request body must contain the signed usage records in a Gzip-compressed file. Use the 'upload_id' in the response to check the Status Of Usage Upload.

Request
URI
POST
https://eapi.broadcom.com/vcf/license-usage/api/v1/tenants/{tenant_id}/license-usage/upload
COPY
Path Parameters
string
tenant_id
Required

ID of the tenant

Request Body

The API accepts a Gzip-compressed JWS file containing the list of usages.

UsageForLicenseRequest of type(s) multipart/form-data
Required

Show optional properties

{
    "file": "string"
}
{
    "file": "<binary_file_content>"
}
string As binary As binary
file
Required

Gzip-compressed usages file.

Authentication
This operation uses the following authentication methods.
Responses
200

Usage is uploaded/accepted, processing of data is yet to happen.

Returns UsageForLicenseUploadResponse of type(s) application/json 
{
    "upload_id": "2128894e-7154-430f-ab43-089eba89636d",
    "upload_status": "SUCCESS",
    "uploaded_on": "2026-03-27T08:29:01.879792220Z"
}
string
upload_id
Required

upload_id

string
upload_status
Required

The status of the operation.

  • UPLOADING: The usage file is getting uploaded to VCF Business Services Console.
  • SUCCESS: The usage file is uploaded successfully the usage processing is yet to start.
  • FAILED: The usage file upload has failed.
Possible values are : UPLOADING, SUCCESS, FAILED,
string
uploaded_on
Required

uploaded_on


400

Bad request

Returns ErrorResponse of type(s) application/json 
{
    "major_error_code": "USAGE_UPLOAD_FAILED",
    "minor_error_code": "FILE_TYPE_NOT_SUPPORTED",
    "message": "Only gzip file is supported."
}
array of string
parameter_list
Optional

parameter_list

string
message
Optional

message

string
major_error_code
Optional

major_error_code

string
minor_error_code
Optional

minor_error_code


401

Unauthorized

Returns ErrorResponse of type(s) application/json 
{
    "major_error_code": "401",
    "minor_error_code": "UNAUTHORIZED",
    "message": "Authentication failed"
}
array of string
parameter_list
Optional

parameter_list

string
message
Optional

message

string
major_error_code
Optional

major_error_code

string
minor_error_code
Optional

minor_error_code


403

Forbidden Request

Returns ErrorResponse of type(s) application/json 
{
    "major_error_code": "403",
    "minor_error_code": "ACCESS_DENIED",
    "message": "Access Denied"
}
array of string
parameter_list
Optional

parameter_list

string
message
Optional

message

string
major_error_code
Optional

major_error_code

string
minor_error_code
Optional

minor_error_code


409

Duplicate file uploaded

Returns ErrorResponse of type(s) application/json 
{
    "major_error_code": "USAGE_UPLOAD_FAILED",
    "minor_error_code": "DUPLICATE_FILE_UPLOADED",
    "message": "Duplicate file uploaded."
}
array of string
parameter_list
Optional

parameter_list

string
message
Optional

message

string
major_error_code
Optional

major_error_code

string
minor_error_code
Optional

minor_error_code


500

INTERNAL_SERVER_ERROR .In case upload has failed

Returns ErrorResponse of type(s) application/json 
{
    "major_error_code": "UPLOAD_ERROR",
    "minor_error_code": "UPLOAD_FAILED_UNKNOWN_ERROR",
    "message": "Usage Upload Failed"
}
array of string
parameter_list
Optional

parameter_list

string
message
Optional

message

string
major_error_code
Optional

major_error_code

string
minor_error_code
Optional

minor_error_code


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: multipart/form-data' -d '{"file":"string"}' https://{api_host}/vcf/license-usage/api/v1/tenants/{tenant_id}/license-usage/upload
On This Page
License Usage Operations
POST
Consumption Of Licenses
GET
Status Of Usage Upload