--- schema_version: "1" id: 0212d134189acbc6396dae87347d5d89280e2e21a0e544191afea5473c040665 title: Download Dedicated Load Balancer Logs collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/cloudhub/lb-download-logs.md canonical_url: https://docs.mulesoft.com/cloudhub/lb-download-logs source_site: docs.mulesoft.com content_type: documentation content_hash: ba5457d44d2c41af0042681fc28b66067b4da291772a8df45d7e9919bc476aec description: MuleSoft Documentation Site latest: true --- --- product: CloudHub --- # Download Dedicated Load Balancer Logs > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Download dedicated load balancer (DLB) logs using the CloudHub API. DLB log downloads run asynchronously. After initiating a request, check its status and retrieve the download URL when processing completes. Only one active download request per DLB is allowed at a time. DLB log downloads require two APIs: - Initiate Download - Download Log Status The download process runs as follows: 1. Fetch the authorization token. 2. Call the Initiate Download API. 3. Periodically check the request status using the Download Log Status API. 4. Retrieve the download URL when processing completes. ## Initiate Download API: Absolute Query Type Use the absolute query type to request logs for a specific time range by specifying `startTime` and `endTime`. If `queryType` is `ABSOLUTE`, `startTime` and `endTime` must be specified in ISO 8601 UTC format with microsecond precision (`YYYY-MM-DDTHH:mm:ss.SSSSSSZ`), for example, `2025-12-25T10:00:00.000000Z`. The `Z` suffix is required to indicate UTC. Requests that don’t match this format fail validation. ```bash curl --location -X POST 'https://anypoint.mulesoft.com/cloudhub/api/organizations/myOrgID/logs/download' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer myAccessToken' \ --data '{ "resourceType": "DLB_LOGS", "resourceName": "myDlbName", "queryType": "ABSOLUTE", "startTime": "2025-12-25T10:00:00.000000Z", "endTime": "2026-01-01T10:00:00.000000Z" }' ``` ### Sample Response The API returns a response similar to this: ```json { "executionName": "myDlbExecutionName", "startDate": "Fri Jan 02 17:38:09 UTC 2026", "status": "RUNNING", "message": "Log download request submitted successfully" } ``` ### Validations These validations apply to the request: - `resourceType` is a required parameter and must be `DLB_LOGS`. - `resourceName` is a required parameter and must be a valid DLB name associated with the requesting organization. - `queryType` is a required parameter and must be `RELATIVE` or `ABSOLUTE`. If `queryType` is `ABSOLUTE`, `startTime` and `endTime` are required parameters and must be in ISO 8601 UTC format with microsecond precision (`YYYY-MM-DDTHH:mm:ss.SSSSSSZ`). - `validityMinutes` is an optional parameter. Default value is 60 minutes. Allowed range is 10 to 1440 minutes. - `maxRows` is an optional parameter. Default value is 10,000. Maximum value is 500,000. ## Initiate Download API: Relative Query Type Use the relative query type to request logs for a preset time window (for example, the last 1, 3, 6, or 24 hours) by specifying a `timeRange` value. ```bash curl --location -X POST 'https://anypoint.mulesoft.com/cloudhub/api/organizations/myOrgID/logs/download' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer myAccessToken' \ --data '{ "resourceType": "DLB_LOGS", "resourceName": "myDlbName", "queryType": "RELATIVE", "timeRange": "LAST_3_HOURS", "maxRows": 500000, "validityMinutes": 60 }' ``` ### Validations These validations apply to the request: - `resourceType` is a required parameter and must be `DLB_LOGS`. - `resourceName` is a required parameter and must be a valid DLB name associated with the requesting organization. - `queryType` is a required parameter and must be `RELATIVE` or `ABSOLUTE`. If `queryType` is `RELATIVE`, `timeRange` is a required parameter and must be one of: - `LAST_1_HOUR` - `LAST_3_HOURS` - `LAST_6_HOURS` - `LAST_24_HOURS` - `validityMinutes` is an optional parameter. Default value is 60 minutes. Allowed range is 10 to 1440 minutes. - `maxRows` is an optional parameter. Default value is 10,000. Maximum value is 500,000. ## Download Log Status API Check the request status and retrieve the download URL when processing completes. ```bash curl --location -X GET 'https://anypoint.mulesoft.com/cloudhub/api/organizations/myOrgID/logs/download/status?executionName=myDlbExecutionName' \ --header 'Authorization: Bearer myAccessToken' ``` ### Validations These validations apply to the request: - `executionName` is a required query parameter. Use the value from the `executionName` field in the Initiate Download API response. - The execution name must be valid; missing, invalid, or unknown values are rejected. ### Sample Response While the logs are being processed, the API returns a response similar to this: ```json { "message": "Log download request is being processed", "resourceName": "myDlbName" } ``` ### Successful Execution Response When processing completes, the API returns a response similar to this, including the download URL: ```json { "message": "DLB logs processed successfully", "downloadUrl": "myLogsDownloadUrl", "expiresIn": "60 minutes", "token": "myDownloadUrlToken", "resourceName": "myDlbName" } ``` The `expiresIn` value defines the time window in which the download URL is valid. The `downloadUrl` is time-sensitive, so download the logs (`.zip` file) within this window. After the validity period ends, the URL expires and can’t be used; initiate a new download request to obtain a new URL. The download file is provided in compressed (`.zip`) format and requires the `token` value from the response to extract its contents. If you download the `.zip` file and retain the token before the download URL expires, you can extract the file later. However, the token can’t be recovered after it expires. ## Constraints These constraints apply to DLB log downloads: - Only one request per DLB can be executed at a time. - If a request is in progress for a DLB and another request is made for the same DLB, the request fails with HTTP 429. - Each request returns up to 10,000 most recent log rows. To retrieve more rows, specify the optional `maxRows` parameter in the request body (up to 500,000). To access older logs, make a request for a specific time range using the `ABSOLUTE` query type. ## See Also - [Dedicated Load Balancers](https://docs.mulesoft.com/cloudhub/cloudhub-dedicated-load-balancer)