Limits Quotas Functions
Package: DBMS_CLOUD_OCI_LM_QUOTAS
ADD_QUOTA_LOCK Function
Adds a lock to a resource.
Syntax
FUNCTION add_quota_lock (
quota_id varchar2,
add_lock_details dbms_cloud_oci_limits_add_lock_details_t,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_add_quota_lock_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of the quota. |
|
(required) |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource is updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
CREATE_QUOTA Function
Creates a new quota with the details supplied.
Syntax
FUNCTION create_quota (
create_quota_details dbms_cloud_oci_limits_create_quota_details_t,
opc_request_id varchar2 DEFAULT NULL,
opc_retry_token varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_create_quota_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) Request object for creating a new quota. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(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 can be rejected). |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
DELETE_QUOTA Function
Deletes the quota corresponding to the given OCID.
Syntax
FUNCTION delete_quota (
quota_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
is_lock_override number DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_delete_quota_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of the quota. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource is updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) Whether to override locks (if any exist). |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
GET_QUOTA Function
Gets the quota for the OCID specified.
Syntax
FUNCTION get_quota (
quota_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_get_quota_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of the quota. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
LIST_QUOTAS Function
Lists all quotas on resources from the given compartment.
Syntax
FUNCTION list_quotas (
compartment_id varchar2,
page varchar2 DEFAULT NULL,
limit number DEFAULT NULL,
name varchar2 DEFAULT NULL,
lifecycle_state varchar2 DEFAULT NULL,
sort_order varchar2 DEFAULT NULL,
sort_by varchar2 DEFAULT NULL,
opc_request_id varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_list_quotas_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of the parent compartment (remember that the tenancy is simply the root compartment). |
|
(optional) The value of the `opc-next-page` response header from the previous \"List\" call. |
|
(optional) The maximum number of items to return in a paginated \"List\" call. |
|
(optional) name |
|
(optional) Filters returned quotas based on the given state. Allowed values are: 'ACTIVE' |
|
(optional) The sort order to use, either 'asc' or 'desc'. By default, it is ascending. Allowed values are: 'ASC', 'DESC' |
|
(optional) The field to sort by. Only one sort order can be provided. Time created is default ordered as descending. Display name is default ordered as ascending. Allowed values are: 'NAME', 'TIMECREATED' |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
REMOVE_QUOTA_LOCK Function
Remove a lock from a resource.
Syntax
FUNCTION remove_quota_lock (
quota_id varchar2,
remove_lock_details dbms_cloud_oci_limits_remove_lock_details_t,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_remove_quota_lock_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of the quota. |
|
(required) |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource is updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
UPDATE_QUOTA Function
Updates the quota corresponding to given OCID with the details supplied.
Syntax
FUNCTION update_quota (
quota_id varchar2,
update_quota_details dbms_cloud_oci_limits_update_quota_details_t,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
is_lock_override number DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_lm_quotas_update_quota_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of the quota. |
|
(required) Request object for updating a quota. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource is updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) Whether to override locks (if any exist). |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://limits.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |