LoadBalancerClient

class oci.load_balancer.LoadBalancerClient(config, **kwargs)

API for the Load Balancing service. Use this API to manage load balancers, backend sets, and related items. For more information, see [Overview of Load Balancing](/iaas/Content/Balance/Concepts/balanceoverview.htm).

__init__(config, **kwargs)

Creates a new service client

Parameters:
  • config (dict) -- Configuration keys and values as per SDK and Tool Configuration. The from_file() method can be used to load configuration from a file. Alternatively, a dict can be passed. You can validate_config the dict using validate_config()
  • service_endpoint (str) -- (optional) The endpoint of the service to call using this client. For example https://iaas.us-ashburn-1.oraclecloud.com. If this keyword argument is not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit need to specify a service endpoint.
  • timeout (float or tuple(float, float)) -- (optional) The connection and read timeouts for the client. The default is that the client never times out. This keyword argument can be provided as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout.
  • signer (AbstractBaseSigner) --

    (optional) The signer to use when signing requests made by the service client. The default is to use a Signer based on the values provided in the config parameter.

    One use case for this parameter is for Instance Principals authentication by passing an instance of InstancePrincipalsSecurityTokenSigner as the value for this keyword argument

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. Retry strategies can also be applied at the operation level by passing a retry_strategy keyword argument as part of calling the operation. Any value provided at the operation level will override whatever is specified at the client level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

change_load_balancer_compartment(load_balancer_id, change_load_balancer_compartment_details, **kwargs)

ChangeLoadBalancerCompartment Moves a load balancer into a different compartment within the same tenancy. For information about moving resources between compartments, see Moving Resources to a Different Compartment.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to move.

  • change_load_balancer_compartment_details (ChangeLoadBalancerCompartmentDetails) -- (required) The configuration details for moving a load balancer to a different compartment.
  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • if_match (str) --

    (optional) For optimistic concurrency control. Set the if-match parameter to the value of the ETag from a previous GET or POST response for that resource. The resource is moved only if the ETag you provide matches the resource's current ETag value.

    Example: example-etag

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_backend(create_backend_details, load_balancer_id, backend_set_name, **kwargs)

CreateBackend Adds a backend server to a backend set.

Parameters:
  • create_backend_details (CreateBackendDetails) -- (required) The details to add a backend server to a backend set.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and servers.

  • backend_set_name (str) --

    (required) The name of the backend set to add the backend server to.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_backend_set(create_backend_set_details, load_balancer_id, **kwargs)

CreateBackendSet Adds a backend set to a load balancer.

Parameters:
  • create_backend_set_details (CreateBackendSetDetails) -- (required) The details for adding a backend set.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer on which to add a backend set.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_certificate(create_certificate_details, load_balancer_id, **kwargs)

CreateCertificate Creates an asynchronous request to add an SSL certificate bundle.

Parameters:
  • create_certificate_details (CreateCertificateDetails) -- (required) The details of the certificate bundle to add.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer on which to add the certificate bundle.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_hostname(create_hostname_details, load_balancer_id, **kwargs)

CreateHostname Adds a hostname resource to the specified load balancer. For more information, see Managing Request Routing.

Parameters:
  • create_hostname_details (CreateHostnameDetails) -- (required) The details of the hostname resource to add to the specified load balancer.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to add the hostname to.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_listener(create_listener_details, load_balancer_id, **kwargs)

CreateListener Adds a listener to a load balancer.

Parameters:
  • create_listener_details (CreateListenerDetails) -- (required) Details to add a listener.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer on which to add a listener.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_load_balancer(create_load_balancer_details, **kwargs)

CreateLoadBalancer Creates a new load balancer in the specified compartment. For general information about load balancers, see Overview of the Load Balancing Service.

For the purposes of access control, you must provide the OCID of the compartment where you want the load balancer to reside. Notice that the load balancer doesn't have to be in the same compartment as the VCN or backend set. If you're not sure which compartment to use, put the load balancer in the same compartment as the VCN. For information about access control and compartments, see Overview of the IAM Service.

You must specify a display name for the load balancer. It does not have to be unique, and you can change it.

For information about Availability Domains, see Regions and Availability Domains. To get a list of Availability Domains, use the ListAvailabilityDomains operation in the Identity and Access Management Service API.

All Oracle Cloud Infrastructure resources, including load balancers, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the resource in the Console. Fore more information, see Resource Identifiers.

After you send your request, the new object's state will temporarily be PROVISIONING. Before using the object, first make sure its state has changed to RUNNING.

When you create a load balancer, the system assigns an IP address. To get the IP address, use the get_load_balancer() operation.

Parameters:
  • create_load_balancer_details (CreateLoadBalancerDetails) -- (required) The configuration details for creating a load balancer.
  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_path_route_set(create_path_route_set_details, load_balancer_id, **kwargs)

CreatePathRouteSet Adds a path route set to a load balancer. For more information, see Managing Request Routing.

Parameters:
  • create_path_route_set_details (CreatePathRouteSetDetails) -- (required) The details of the path route set to add.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to add the path route set to.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_rule_set(load_balancer_id, create_rule_set_details, **kwargs)

CreateRuleSet Creates a new rule set associated with the specified load balancer. For more information, see Managing Rule Sets.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • create_rule_set_details (CreateRuleSetDetails) -- (required) The configuration details for the rule set to create.
  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_backend(load_balancer_id, backend_set_name, backend_name, **kwargs)

DeleteBackend Removes a backend server from a given load balancer and backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and server.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend server.

    Example: example_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to remove.

    Example: 10.0.0.3:8080

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_backend_set(load_balancer_id, backend_set_name, **kwargs)

DeleteBackendSet Deletes the specified backend set. Note that deleting a backend set removes its backend servers from the load balancer.

Before you can delete a backend set, you must remove it from any active listeners.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set.

  • backend_set_name (str) --

    (required) The name of the backend set to delete.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_certificate(load_balancer_id, certificate_name, **kwargs)

DeleteCertificate Deletes an SSL certificate bundle from a load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the certificate bundle to be deleted.

  • certificate_name (str) --

    (required) The name of the certificate bundle to delete.

    Example: example_certificate_bundle

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_hostname(load_balancer_id, name, **kwargs)

DeleteHostname Deletes a hostname resource from the specified load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the hostname to delete.

  • name (str) --

    (required) The name of the hostname resource to delete.

    Example: example_hostname_001

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_listener(load_balancer_id, listener_name, **kwargs)

DeleteListener Deletes a listener from a load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the listener to delete.

  • listener_name (str) --

    (required) The name of the listener to delete.

    Example: example_listener

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_load_balancer(load_balancer_id, **kwargs)

DeleteLoadBalancer Stops a load balancer and removes it from service.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to delete.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_path_route_set(load_balancer_id, path_route_set_name, **kwargs)

DeletePathRouteSet Deletes a path route set from the specified load balancer.

To delete a path route rule from a path route set, use the update_path_route_set() operation.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the path route set to delete.

  • path_route_set_name (str) --

    (required) The name of the path route set to delete.

    Example: example_path_route_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

delete_rule_set(load_balancer_id, rule_set_name, **kwargs)

DeleteRuleSet Deletes a rule set from the specified load balancer.

To delete a rule from a rule set, use the update_rule_set() operation.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • rule_set_name (str) --

    (required) The name of the rule set to delete.

    Example: example_rule_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

get_backend(load_balancer_id, backend_set_name, backend_name, **kwargs)

GetBackend Gets the specified backend server's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and server.

  • backend_set_name (str) --

    (required) The name of the backend set that includes the backend server.

    Example: example_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to retrieve.

    Example: 10.0.0.3:8080

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Backend

Return type:

Response

get_backend_health(load_balancer_id, backend_set_name, backend_name, **kwargs)

BackendHealth Gets the current health status of the specified backend server.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend server health status to be retrieved.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend server to retrieve the health status for.

    Example: example_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to retrieve the health status for.

    Example: 10.0.0.3:8080

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type BackendHealth

Return type:

Response

get_backend_set(load_balancer_id, backend_set_name, **kwargs)

GetBackendSet Gets the specified backend set's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • backend_set_name (str) --

    (required) The name of the backend set to retrieve.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type BackendSet

Return type:

Response

get_backend_set_health(load_balancer_id, backend_set_name, **kwargs)

BackendSetHealth Gets the health status for the specified backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set health status to be retrieved.

  • backend_set_name (str) --

    (required) The name of the backend set to retrieve the health status for.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type BackendSetHealth

Return type:

Response

get_health_checker(load_balancer_id, backend_set_name, **kwargs)

GetHealthChecker Gets the health check policy information for a given load balancer and backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the health check policy to be retrieved.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the health check policy to be retrieved.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type HealthChecker

Return type:

Response

get_hostname(load_balancer_id, name, **kwargs)

GetHostname Gets the specified hostname resource's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • name (str) --

    (required) The name of the hostname resource to retrieve.

    Example: example_hostname_001

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Hostname

Return type:

Response

get_load_balancer(load_balancer_id, **kwargs)

GetLoadBalancer Gets the specified load balancer's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type LoadBalancer

Return type:

Response

get_load_balancer_health(load_balancer_id, **kwargs)

LoadBalancerHealth Gets the health status for the specified load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to return health status for.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type LoadBalancerHealth

Return type:

Response

get_path_route_set(load_balancer_id, path_route_set_name, **kwargs)

GetPathRouteSet Gets the specified path route set's configuration information.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • path_route_set_name (str) --

    (required) The name of the path route set to retrieve.

    Example: example_path_route_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type PathRouteSet

Return type:

Response

get_rule_set(load_balancer_id, rule_set_name, **kwargs)

GetRuleSet Gets the specified set of rules.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • rule_set_name (str) --

    (required) The name of the rule set to retrieve.

    Example: example_rule_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type RuleSet

Return type:

Response

get_work_request(work_request_id, **kwargs)

GetWorkRequest Gets the details of a work request.

Parameters:
  • work_request_id (str) --

    (required) The OCID of the work request to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type WorkRequest

Return type:

Response

list_backend_sets(load_balancer_id, **kwargs)

ListBackendSets Lists all backend sets associated with a given load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend sets to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of BackendSet

Return type:

Response

list_backends(load_balancer_id, backend_set_name, **kwargs)

ListBackends Lists the backend servers for a given load balancer and backend set.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and servers.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend servers.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of Backend

Return type:

Response

list_certificates(load_balancer_id, **kwargs)

ListCertificates Lists all SSL certificates bundles associated with a given load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the certificate bundles to be listed.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of Certificate

Return type:

Response

list_hostnames(load_balancer_id, **kwargs)

ListHostnames Lists all hostname resources associated with the specified load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the hostnames to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of Hostname

Return type:

Response

list_listener_rules(load_balancer_id, listener_name, **kwargs)

ListListenerRules Lists all of the rules from all of the rule sets associated with the specified listener. The response organizes the rules in the following order:

  • Access control rules
  • Allow method rules
  • Request header rules
  • Response header rules
Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the listener.

  • listener_name (str) -- (required) The name of the listener the rules are associated with.
  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of ListenerRuleSummary

Return type:

Response

list_load_balancer_healths(compartment_id, **kwargs)

ListLoadBalancerHealths Lists the summary health statuses for all load balancers in the specified compartment.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancers to return health status information for.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see List Pagination.

    Example: 50

  • page (str) --

    (optional) For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see List Pagination.

    Example: 3

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of LoadBalancerHealthSummary

Return type:

Response

list_load_balancers(compartment_id, **kwargs)

ListLoadBalancers Lists all load balancers in the specified compartment.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancers to list.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see List Pagination.

    Example: 50

  • page (str) --

    (optional) For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see List Pagination.

    Example: 3

  • detail (str) --

    (optional) The level of detail to return for each result. Can be full or simple.

    Example: full

  • sort_by (str) --

    (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

    Allowed values are: "TIMECREATED", "DISPLAYNAME"

  • sort_order (str) --

    (optional) The sort order to use, either ascending (ASC) or descending (DESC). The DISPLAYNAME sort order is case sensitive.

    Allowed values are: "ASC", "DESC"

  • display_name (str) --

    (optional) A filter to return only resources that match the given display name exactly.

    Example: example_load_balancer

  • lifecycle_state (str) --

    (optional) A filter to return only resources that match the given lifecycle state.

    Example: SUCCEEDED

    Allowed values are: "CREATING", "FAILED", "ACTIVE", "DELETING", "DELETED"

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of LoadBalancer

Return type:

Response

list_path_route_sets(load_balancer_id, **kwargs)

ListPathRouteSets Lists all path route sets associated with the specified load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the path route sets to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of PathRouteSet

Return type:

Response

list_policies(compartment_id, **kwargs)

ListPolicies Lists the available load balancer policies.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancer policies to list.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see List Pagination.

    Example: 50

  • page (str) --

    (optional) For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see List Pagination.

    Example: 3

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of LoadBalancerPolicy

Return type:

Response

list_protocols(compartment_id, **kwargs)

ListProtocols Lists all supported traffic protocols.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancer protocols to list.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see List Pagination.

    Example: 50

  • page (str) --

    (optional) For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see List Pagination.

    Example: 3

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of LoadBalancerProtocol

Return type:

Response

list_rule_sets(load_balancer_id, **kwargs)

ListRuleSets Lists all rule sets associated with the specified load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of RuleSet

Return type:

Response

list_shapes(compartment_id, **kwargs)

ListShapes Lists the valid load balancer shapes.

Parameters:
  • compartment_id (str) --

    (required) The OCID of the compartment containing the load balancer shapes to list.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see List Pagination.

    Example: 50

  • page (str) --

    (optional) For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see List Pagination.

    Example: 3

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of LoadBalancerShape

Return type:

Response

list_work_requests(load_balancer_id, **kwargs)

ListWorkRequests Lists the work requests for a given load balancer.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the work requests to retrieve.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • limit (int) --

    (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see List Pagination.

    Example: 50

  • page (str) --

    (optional) For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see List Pagination.

    Example: 3

  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of WorkRequest

Return type:

Response

update_backend(update_backend_details, load_balancer_id, backend_set_name, backend_name, **kwargs)

UpdateBackend Updates the configuration of a backend server within the specified backend set.

Parameters:
  • update_backend_details (UpdateBackendDetails) -- (required) Details for updating a backend server.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set and server.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the backend server.

    Example: example_backend_set

  • backend_name (str) --

    (required) The IP address and port of the backend server to update.

    Example: 10.0.0.3:8080

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_backend_set(update_backend_set_details, load_balancer_id, backend_set_name, **kwargs)

UpdateBackendSet Updates a backend set.

Parameters:
  • update_backend_set_details (UpdateBackendSetDetails) -- (required) The details to update a backend set.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the backend set.

  • backend_set_name (str) --

    (required) The name of the backend set to update.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_health_checker(health_checker, load_balancer_id, backend_set_name, **kwargs)

UpdateHealthChecker Updates the health check policy for a given load balancer and backend set.

Parameters:
  • health_checker (UpdateHealthCheckerDetails) -- (required) The health check policy configuration details.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the health check policy to be updated.

  • backend_set_name (str) --

    (required) The name of the backend set associated with the health check policy to be retrieved.

    Example: example_backend_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_hostname(update_hostname_details, load_balancer_id, name, **kwargs)

UpdateHostname Overwrites an existing hostname resource on the specified load balancer. Use this operation to change a virtual hostname.

Parameters:
  • update_hostname_details (UpdateHostnameDetails) -- (required) The configuration details to update a virtual hostname.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the virtual hostname to update.

  • name (str) --

    (required) The name of the hostname resource to update.

    Example: example_hostname_001

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_listener(update_listener_details, load_balancer_id, listener_name, **kwargs)

UpdateListener Updates a listener for a given load balancer.

Parameters:
  • update_listener_details (UpdateListenerDetails) -- (required) Details to update a listener.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the listener to update.

  • listener_name (str) --

    (required) The name of the listener to update.

    Example: example_listener

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_load_balancer(update_load_balancer_details, load_balancer_id, **kwargs)

UpdateLoadBalancer Updates a load balancer's configuration.

Parameters:
  • update_load_balancer_details (UpdateLoadBalancerDetails) -- (required) The details for updating a load balancer's configuration.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to update.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_network_security_groups(update_network_security_groups_details, load_balancer_id, **kwargs)

UpdateNetworkSecurityGroups Updates the network security groups associated with the specified load balancer.

Parameters:
  • update_network_security_groups_details (UpdateNetworkSecurityGroupsDetails) -- (required) The details for updating the NSGs associated with the specified load balancer.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer to update the NSGs for.

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_path_route_set(update_path_route_set_details, load_balancer_id, path_route_set_name, **kwargs)

UpdatePathRouteSet Overwrites an existing path route set on the specified load balancer. Use this operation to add, delete, or alter path route rules in a path route set.

To add a new path route rule to a path route set, the pathRoutes in the update_path_route_set_details() object must include both the new path route rule to add and the existing path route rules to retain.

Parameters:
  • update_path_route_set_details (UpdatePathRouteSetDetails) -- (required) The configuration details to update a path route set.
  • load_balancer_id (str) --

    (required) The OCID of the load balancer associated with the path route set to update.

  • path_route_set_name (str) --

    (required) The name of the path route set to update.

    Example: example_path_route_set

  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) -- (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (e.g., if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

update_rule_set(load_balancer_id, rule_set_name, update_rule_set_details, **kwargs)

UpdateRuleSet Overwrites an existing set of rules on the specified load balancer. Use this operation to add or alter the rules in a rule set.

To add a new rule to a set, the body must include both the new rule to add and the existing rules to retain.

Parameters:
  • load_balancer_id (str) --

    (required) The OCID of the specified load balancer.

  • rule_set_name (str) --

    (required) The name of the rule set to update.

    Example: example_rule_set

  • update_rule_set_details (UpdateRuleSetDetails) -- (required) The configuration details to update a set of rules.
  • opc_request_id (str) -- (optional) The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) --

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response