Upload Remote Bundle

Upload Remote Bundle
Import bundle from remote URL

Initiates an asynchronous download and import of a bundle from a remote URL onto installer.

Notes:

  • The remote URL must be accessible from the installer.
  • Bundle validation occurs during download - invalid bundles will result in FAILED status (broken download, incomplete bundle, bad metadata)
  • ERROR status is reserved for unexpected internal errors
Request
URI
POST
https://{api_host}/https://{api_host}:{port}/lh-appliance/bundles/remote
COPY
Query Parameters
string
type
Optional

Filter bundles by type. When specified, only bundles matching this type will be processed.

Enumeration: LICENSE_HUB, LICENSE_HUB_PATCH
Request Body
RemoteUpload of type(s) application/json
Required

Show optional properties

{
    "url": "https://example.com/resources/bundle.tar"
}
{
    "url": "string"
}
string As ^https?://.+
url
Required

HTTP(S) URL pointing to a valid bundle file. The URL must be accessible without authentication.

Authentication
This operation uses the following authentication methods.
Responses
202

Bundle import initiated successfully. The response contains a request ID and a status URL pointing to the bundle resource. Use the returned status_url to track download status and progress.

Returns AsyncApiResponse of type(s) application/json 
{
    "id": "b8f47985-22ed-3193-bca8-11c7b025cbce",
    "status_url": "/segmentation/default-ids-profiles/b8f47985-22ed-3193-bca8-11c7b025cbce/status"
}
string
id
Optional

UUID identifier of the response.

string
status_url
Optional

The URL to check the status of the operation.


400

Bad Request

Returns BadRequest of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


401

Unauthorized

Returns Unauthorized of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


403

Forbidden

Returns Forbidden of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


412

Precondition Failed

Returns PreconditionFailed of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


428

Precondition Required

Returns PreconditionRequired of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


429

Too Many Requests

Returns TooManyRequests of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


default

4XX and 5XX type errors with appropriate message

Returns Error of type(s) application/json 
{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}
integer
error_code
Required

HTTP Status or Application error code.

string
module_name
Optional

Module where the error happened.

string
error_message
Required

Message describing the error.


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"url":"string"}' https://{api_host}/https://{api_host}:{port}/lh-appliance/bundles/remote
On This Page
Package Management Operations
GET
Get Bundle
DELETE
Delete Bundle
GET
Get Bundles
POST
Upload Remote Bundle
POST
Upload Local Bundle
GET
Get Depot Health