API Gateway Usage Plans Functions

Package: DBMS_CLOUD_OCI_AG_USAGE_PLANS

CHANGE_USAGE_PLAN_COMPARTMENT Function

Changes the usage plan compartment.

Syntax

FUNCTION change_usage_plan_compartment (
  usage_plan_id varchar2,
  change_usage_plan_compartment_details dbms_cloud_oci_apigateway_change_usage_plan_compartment_details_t,
  opc_retry_token varchar2 DEFAULT NULL,
  if_match 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_ag_usage_plans_change_usage_plan_compartment_response_t;

Parameters

Parameter	Description
`usage_plan_id`	(required) The ocid of the usage plan.
`change_usage_plan_compartment_details`	(required) Details of the target compartment.
`opc_retry_token`	(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. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request might be rejected.
`if_match`	(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 will be updated or deleted only if the etag you provide matches the resource's current etag value.
`opc_request_id`	(optional) The client request id for tracing.
`region`	(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).
`endpoint`	(optional) The endpoint of the service to call using this function. e.g https://apigateway.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.
`credential_name`	(optional) The name of the credential for authenticating with the corresponding cloud native API.

CREATE_USAGE_PLAN Function

Creates a new usage plan.

Syntax

FUNCTION create_usage_plan (
  create_usage_plan_details dbms_cloud_oci_apigateway_create_usage_plan_details_t,
  opc_retry_token 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_ag_usage_plans_create_usage_plan_response_t;

Parameters

Parameter	Description
`create_usage_plan_details`	(required) Details for the new usage plan.
`opc_retry_token`	(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. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request might be rejected.
`opc_request_id`	(optional) The client request id for tracing.
`region`	(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).
`endpoint`	(optional) The endpoint of the service to call using this function. e.g https://apigateway.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.
`credential_name`	(optional) The name of the credential for authenticating with the corresponding cloud native API.

DELETE_USAGE_PLAN Function

Deletes the usage plan with the given identifier.

Syntax

FUNCTION delete_usage_plan (
  usage_plan_id varchar2,
  if_match 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_ag_usage_plans_delete_usage_plan_response_t;

Parameters

Parameter	Description
`usage_plan_id`	(required) The ocid of the usage plan.
`if_match`	(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 will be updated or deleted only if the etag you provide matches the resource's current etag value.
`opc_request_id`	(optional) The client request id for tracing.
`region`	(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).
`endpoint`	(optional) The endpoint of the service to call using this function. e.g https://apigateway.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.
`credential_name`	(optional) The name of the credential for authenticating with the corresponding cloud native API.

GET_USAGE_PLAN Function

Gets a usage plan by identifier.

Syntax

FUNCTION get_usage_plan (
  usage_plan_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_ag_usage_plans_get_usage_plan_response_t;

Parameters

Parameter	Description
`usage_plan_id`	(required) The ocid of the usage plan.
`opc_request_id`	(optional) The client request id for tracing.
`region`	(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).
`endpoint`	(optional) The endpoint of the service to call using this function. e.g https://apigateway.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.
`credential_name`	(optional) The name of the credential for authenticating with the corresponding cloud native API.

LIST_USAGE_PLANS Function

Returns a list of usage plans.

Syntax

FUNCTION list_usage_plans (
  compartment_id varchar2,
  display_name varchar2 DEFAULT NULL,
  lifecycle_state varchar2 DEFAULT NULL,
  limit number DEFAULT NULL,
  page 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_ag_usage_plans_list_usage_plans_response_t;

Parameters

Parameter	Description
`compartment_id`	(required) The ocid of the compartment in which to list resources.
`display_name`	(optional) A user-friendly name. Does not have to be unique, and it's changeable. Example: `My new resource`
`lifecycle_state`	(optional) A filter to return only resources that match the given lifecycle state. Example: `ACTIVE`
`limit`	(optional) The maximum number of items to return.
`page`	(optional) The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
`sort_order`	(optional) The sort order to use, either 'asc' or 'desc'. The default order depends on the sortBy value. Allowed values are: 'ASC', 'DESC'
`sort_by`	(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'
`opc_request_id`	(optional) The client request id for tracing.
`region`	(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).
`endpoint`	(optional) The endpoint of the service to call using this function. e.g https://apigateway.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.
`credential_name`	(optional) The name of the credential for authenticating with the corresponding cloud native API.

UPDATE_USAGE_PLAN Function

Updates the usage plan with the given identifier.

Syntax

FUNCTION update_usage_plan (
  usage_plan_id varchar2,
  update_usage_plan_details dbms_cloud_oci_apigateway_update_usage_plan_details_t,
  if_match 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_ag_usage_plans_update_usage_plan_response_t;

Parameters

Parameter	Description
`usage_plan_id`	(required) The ocid of the usage plan.
`update_usage_plan_details`	(required) The information to be updated.
`if_match`	(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 will be updated or deleted only if the etag you provide matches the resource's current etag value.
`opc_request_id`	(optional) The client request id for tracing.
`region`	(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix).
`endpoint`	(optional) The endpoint of the service to call using this function. e.g https://apigateway.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence.
`credential_name`	(optional) The name of the credential for authenticating with the corresponding cloud native API.

Oracle Cloud Infrastructure Documentation Try Free Tier

CHANGE_USAGE_PLAN_COMPARTMENT Function 🔗

CREATE_USAGE_PLAN Function 🔗

DELETE_USAGE_PLAN Function 🔗

GET_USAGE_PLAN Function 🔗

LIST_USAGE_PLANS Function 🔗

UPDATE_USAGE_PLAN Function 🔗

Oracle Cloud Infrastructure Documentation
Try Free Tier

CHANGE_USAGE_PLAN_COMPARTMENT Function

CREATE_USAGE_PLAN Function

DELETE_USAGE_PLAN Function

GET_USAGE_PLAN Function

LIST_USAGE_PLANS Function

UPDATE_USAGE_PLAN Function