Work Request Management

This topic describes how to view the state of work requests associated with a given load balancer.

Note

The Load Balancing service does not use the common Work Requests API to support work request operations. Instead, the Load Balancing API supports Load Balancing work requests. See Using the Console to View Work Requests for information on viewing work requests for other services.

Work Request Status

Many of the Oracle Cloud Infrastructure Load Balancing service requests do not take effect immediately. In these cases, the request spawns an asynchronous workflow for fulfillment. To provide visibility for in-progress workflows, the Load Balancing service creates a work request object.

Because some operations depend on the completion of other operations, you must monitor each operation’s work request and confirm it has succeeded before proceeding to the next operation. For example, if you want to create a backend set  and add a backend server to the new set, you first must create the backend set. After that operation completes, you can add the backend server. If you try to add a backend server before the backend set creation completes, the system cannot ensure that the request to add the server succeeds.

You can monitor the request to add a backend set to determine when that workflow is complete, and then add the backend server.

The following table lists the work request states:

Status

Description

Accepted

The request is in the work request queue to be processed.

In Progress

A work request record exists for the specified request, but no associated WORK_COMPLETED record exists.

Succeeded

A work request record exists for this request and an associated WORK_COMPLETED record has the state Succeeded.

Failed

A work request record exists for this request and an associated WORK_COMPLETED record has the state Failed.

Listing Work Requests

List the work requests for a Load Balancer resource.

Use one of the following methods to display a list of work requests for a selected load balancer.

To list the work requests using the Console

Use the OCI Console to list the work requests for a Load Balancer resource.

  1. Open the navigation menu, click Networking, and then click Load Balancers.

  2. Select the Compartment from the list.

    All load balancers and network load balancers in that compartment are listed in tabular form.

  3. (optional) Select a State from the list to limit the load balancers displayed to that state.

  4. (optional) Uncheck Load Balancer under Type to only display load balancers.

  5. Select the load balancer whose rule set you want to delete.

    The Load Balancer Details dialog box appears.

  6. Click Work Requests under Resources.

    The Work Requests list appears. All work requests are listed in tabular form.

To list the work requests using the CLI

Use the command line interface (CLI) to list the work requests for a Load Balancer resource.

Enter the following command:

oci lb work-request list --load-balancer-id load_balancer_id [OPTIONS]

See the CLI online help for a list of options:

oci lb work-request list --help

See oci lb work-request list for a complete description of the command.

To list the work requests using the API

Use the API to list the work requests for a Load Balancer resource.

Run the ListWorkRequests method to delete a rule set from a load balancer. See ListWorkRequests for a complete description.

Getting Work Request Details

Get the details of a work request for a Load Balancer resource.

Use one of the following methods to get the details of a work request for a selected load balancer.

To get the details of a work request using the Console

Get the details of a work request for a Load Balancer resource.

  1. Open the navigation menu, click Networking, and then click Load Balancers.

  2. Select the Compartment from the list.

    All load balancers and network load balancers in that compartment are listed in tabular form.

  3. (optional) Select a State from the list to limit the load balancers displayed to that state.

  4. (optional) Uncheck Load Balancer under Type to only display load balancers.

  5. Select the load balancer whose rule set you want to delete.

    The Load Balancer Details dialog box appears.

  6. Click Work Requests under Resources.

    The Work Requests list appears. All work requests are listed in tabular form.

  7. Find the work request whose details you want to get from the list. The following details for each work request are displayed:

    • Status: See Work Request Status for a list of statuses and their descriptions.

    • Type: API method used for run the work request.

    • OCID: Oracle Cloud identifier of the work request.

    • Error Details: Details of any errors associated with the work.

    • Started: UTC-based date-time group when the work request was started.

    • Finished: UTC-based date-time group when the work request was finished.

To get the details of a work request using the CLI

Use the command line interface (CLI) to get the details of a work request for a Load Balancer resource.

Enter the following command:

oci lb work-request get --work-request-id work_request_id [OPTIONS]

See the CLI online help for a list of options:

oci lb work-request get --help

See oci lb work-request get for a complete description of the command.

To get the details of a work request using the API

Use the API to get the details of a work request for a Load Balancer resource.

Run the GetWorkRequest method to get the details of a work request for a load balancer. See GetWorkRequests for a complete description.