1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. ApiGateway
  5. getUsagePlan
Oracle Cloud Infrastructure v2.30.0 published on Monday, Apr 14, 2025 by Pulumi

oci.ApiGateway.getUsagePlan

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.30.0 published on Monday, Apr 14, 2025 by Pulumi

This data source provides details about a specific Usage Plan resource in Oracle Cloud Infrastructure API Gateway service.

Gets a usage plan by identifier.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testUsagePlan = oci.ApiGateway.getUsagePlan({
    usagePlanId: testUsagePlanOciApigatewayUsagePlan.id,
});
Copy
import pulumi
import pulumi_oci as oci

test_usage_plan = oci.ApiGateway.get_usage_plan(usage_plan_id=test_usage_plan_oci_apigateway_usage_plan["id"])
Copy
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/apigateway"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := apigateway.GetUsagePlan(ctx, &apigateway.GetUsagePlanArgs{
			UsagePlanId: testUsagePlanOciApigatewayUsagePlan.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testUsagePlan = Oci.ApiGateway.GetUsagePlan.Invoke(new()
    {
        UsagePlanId = testUsagePlanOciApigatewayUsagePlan.Id,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.ApiGateway.ApiGatewayFunctions;
import com.pulumi.oci.ApiGateway.inputs.GetUsagePlanArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var testUsagePlan = ApiGatewayFunctions.getUsagePlan(GetUsagePlanArgs.builder()
            .usagePlanId(testUsagePlanOciApigatewayUsagePlan.id())
            .build());

    }
}
Copy
variables:
  testUsagePlan:
    fn::invoke:
      function: oci:ApiGateway:getUsagePlan
      arguments:
        usagePlanId: ${testUsagePlanOciApigatewayUsagePlan.id}
Copy

Using getUsagePlan

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getUsagePlan(args: GetUsagePlanArgs, opts?: InvokeOptions): Promise<GetUsagePlanResult>
function getUsagePlanOutput(args: GetUsagePlanOutputArgs, opts?: InvokeOptions): Output<GetUsagePlanResult>
Copy
def get_usage_plan(usage_plan_id: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetUsagePlanResult
def get_usage_plan_output(usage_plan_id: Optional[pulumi.Input[str]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetUsagePlanResult]
Copy
func GetUsagePlan(ctx *Context, args *GetUsagePlanArgs, opts ...InvokeOption) (*GetUsagePlanResult, error)
func GetUsagePlanOutput(ctx *Context, args *GetUsagePlanOutputArgs, opts ...InvokeOption) GetUsagePlanResultOutput
Copy

> Note: This function is named GetUsagePlan in the Go SDK.

public static class GetUsagePlan 
{
    public static Task<GetUsagePlanResult> InvokeAsync(GetUsagePlanArgs args, InvokeOptions? opts = null)
    public static Output<GetUsagePlanResult> Invoke(GetUsagePlanInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetUsagePlanResult> getUsagePlan(GetUsagePlanArgs args, InvokeOptions options)
public static Output<GetUsagePlanResult> getUsagePlan(GetUsagePlanArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: oci:ApiGateway/getUsagePlan:getUsagePlan
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

UsagePlanId This property is required. string
The ocid of the usage plan.
UsagePlanId This property is required. string
The ocid of the usage plan.
usagePlanId This property is required. String
The ocid of the usage plan.
usagePlanId This property is required. string
The ocid of the usage plan.
usage_plan_id This property is required. str
The ocid of the usage plan.
usagePlanId This property is required. String
The ocid of the usage plan.

getUsagePlan Result

The following output properties are available:

CompartmentId string
The OCID of the compartment in which the resource is created.
DefinedTags Dictionary<string, string>
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
DisplayName string
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My new resource
Entitlements List<GetUsagePlanEntitlement>
A collection of entitlements currently assigned to the usage plan.
FreeformTags Dictionary<string, string>
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id string
The OCID of a usage plan resource.
LifecycleDetails string
A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in a Failed state.
State string
The current state of the usage plan.
TimeCreated string
The time this resource was created. An RFC3339 formatted datetime string.
TimeUpdated string
The time this resource was last updated. An RFC3339 formatted datetime string.
UsagePlanId string
CompartmentId string
The OCID of the compartment in which the resource is created.
DefinedTags map[string]string
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
DisplayName string
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My new resource
Entitlements []GetUsagePlanEntitlement
A collection of entitlements currently assigned to the usage plan.
FreeformTags map[string]string
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id string
The OCID of a usage plan resource.
LifecycleDetails string
A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in a Failed state.
State string
The current state of the usage plan.
TimeCreated string
The time this resource was created. An RFC3339 formatted datetime string.
TimeUpdated string
The time this resource was last updated. An RFC3339 formatted datetime string.
UsagePlanId string
compartmentId String
The OCID of the compartment in which the resource is created.
definedTags Map<String,String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName String
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My new resource
entitlements List<GetUsagePlanEntitlement>
A collection of entitlements currently assigned to the usage plan.
freeformTags Map<String,String>
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id String
The OCID of a usage plan resource.
lifecycleDetails String
A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in a Failed state.
state String
The current state of the usage plan.
timeCreated String
The time this resource was created. An RFC3339 formatted datetime string.
timeUpdated String
The time this resource was last updated. An RFC3339 formatted datetime string.
usagePlanId String
compartmentId string
The OCID of the compartment in which the resource is created.
definedTags {[key: string]: string}
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName string
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My new resource
entitlements GetUsagePlanEntitlement[]
A collection of entitlements currently assigned to the usage plan.
freeformTags {[key: string]: string}
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id string
The OCID of a usage plan resource.
lifecycleDetails string
A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in a Failed state.
state string
The current state of the usage plan.
timeCreated string
The time this resource was created. An RFC3339 formatted datetime string.
timeUpdated string
The time this resource was last updated. An RFC3339 formatted datetime string.
usagePlanId string
compartment_id str
The OCID of the compartment in which the resource is created.
defined_tags Mapping[str, str]
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
display_name str
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My new resource
entitlements Sequence[apigateway.GetUsagePlanEntitlement]
A collection of entitlements currently assigned to the usage plan.
freeform_tags Mapping[str, str]
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id str
The OCID of a usage plan resource.
lifecycle_details str
A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in a Failed state.
state str
The current state of the usage plan.
time_created str
The time this resource was created. An RFC3339 formatted datetime string.
time_updated str
The time this resource was last updated. An RFC3339 formatted datetime string.
usage_plan_id str
compartmentId String
The OCID of the compartment in which the resource is created.
definedTags Map<String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName String
A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My new resource
entitlements List<Property Map>
A collection of entitlements currently assigned to the usage plan.
freeformTags Map<String>
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id String
The OCID of a usage plan resource.
lifecycleDetails String
A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in a Failed state.
state String
The current state of the usage plan.
timeCreated String
The time this resource was created. An RFC3339 formatted datetime string.
timeUpdated String
The time this resource was last updated. An RFC3339 formatted datetime string.
usagePlanId String

Supporting Types

GetUsagePlanEntitlement

Description This property is required. string
A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
Name This property is required. string
An entitlement name, unique within a usage plan.
Quotas This property is required. List<GetUsagePlanEntitlementQuota>
Quota policy for a usage plan.
RateLimits This property is required. List<GetUsagePlanEntitlementRateLimit>
Rate-limiting policy for a usage plan.
Targets This property is required. List<GetUsagePlanEntitlementTarget>
A collection of targeted deployments that the entitlement will be applied to.
Description This property is required. string
A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
Name This property is required. string
An entitlement name, unique within a usage plan.
Quotas This property is required. []GetUsagePlanEntitlementQuota
Quota policy for a usage plan.
RateLimits This property is required. []GetUsagePlanEntitlementRateLimit
Rate-limiting policy for a usage plan.
Targets This property is required. []GetUsagePlanEntitlementTarget
A collection of targeted deployments that the entitlement will be applied to.
description This property is required. String
A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
name This property is required. String
An entitlement name, unique within a usage plan.
quotas This property is required. List<GetUsagePlanEntitlementQuota>
Quota policy for a usage plan.
rateLimits This property is required. List<GetUsagePlanEntitlementRateLimit>
Rate-limiting policy for a usage plan.
targets This property is required. List<GetUsagePlanEntitlementTarget>
A collection of targeted deployments that the entitlement will be applied to.
description This property is required. string
A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
name This property is required. string
An entitlement name, unique within a usage plan.
quotas This property is required. GetUsagePlanEntitlementQuota[]
Quota policy for a usage plan.
rateLimits This property is required. GetUsagePlanEntitlementRateLimit[]
Rate-limiting policy for a usage plan.
targets This property is required. GetUsagePlanEntitlementTarget[]
A collection of targeted deployments that the entitlement will be applied to.
description This property is required. str
A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
name This property is required. str
An entitlement name, unique within a usage plan.
quotas This property is required. Sequence[apigateway.GetUsagePlanEntitlementQuota]
Quota policy for a usage plan.
rate_limits This property is required. Sequence[apigateway.GetUsagePlanEntitlementRateLimit]
Rate-limiting policy for a usage plan.
targets This property is required. Sequence[apigateway.GetUsagePlanEntitlementTarget]
A collection of targeted deployments that the entitlement will be applied to.
description This property is required. String
A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
name This property is required. String
An entitlement name, unique within a usage plan.
quotas This property is required. List<Property Map>
Quota policy for a usage plan.
rateLimits This property is required. List<Property Map>
Rate-limiting policy for a usage plan.
targets This property is required. List<Property Map>
A collection of targeted deployments that the entitlement will be applied to.

GetUsagePlanEntitlementQuota

OperationOnBreach This property is required. string
What the usage plan will do when a quota is breached: REJECT will allow no further requests ALLOW will continue to allow further requests
ResetPolicy This property is required. string
The policy that controls when quotas will reset. Example: CALENDAR
Unit This property is required. string
The unit of time over which rate limits are calculated. Example: SECOND
Value This property is required. int
The number of requests that can be made per time period.
OperationOnBreach This property is required. string
What the usage plan will do when a quota is breached: REJECT will allow no further requests ALLOW will continue to allow further requests
ResetPolicy This property is required. string
The policy that controls when quotas will reset. Example: CALENDAR
Unit This property is required. string
The unit of time over which rate limits are calculated. Example: SECOND
Value This property is required. int
The number of requests that can be made per time period.
operationOnBreach This property is required. String
What the usage plan will do when a quota is breached: REJECT will allow no further requests ALLOW will continue to allow further requests
resetPolicy This property is required. String
The policy that controls when quotas will reset. Example: CALENDAR
unit This property is required. String
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. Integer
The number of requests that can be made per time period.
operationOnBreach This property is required. string
What the usage plan will do when a quota is breached: REJECT will allow no further requests ALLOW will continue to allow further requests
resetPolicy This property is required. string
The policy that controls when quotas will reset. Example: CALENDAR
unit This property is required. string
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. number
The number of requests that can be made per time period.
operation_on_breach This property is required. str
What the usage plan will do when a quota is breached: REJECT will allow no further requests ALLOW will continue to allow further requests
reset_policy This property is required. str
The policy that controls when quotas will reset. Example: CALENDAR
unit This property is required. str
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. int
The number of requests that can be made per time period.
operationOnBreach This property is required. String
What the usage plan will do when a quota is breached: REJECT will allow no further requests ALLOW will continue to allow further requests
resetPolicy This property is required. String
The policy that controls when quotas will reset. Example: CALENDAR
unit This property is required. String
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. Number
The number of requests that can be made per time period.

GetUsagePlanEntitlementRateLimit

Unit This property is required. string
The unit of time over which rate limits are calculated. Example: SECOND
Value This property is required. int
The number of requests that can be made per time period.
Unit This property is required. string
The unit of time over which rate limits are calculated. Example: SECOND
Value This property is required. int
The number of requests that can be made per time period.
unit This property is required. String
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. Integer
The number of requests that can be made per time period.
unit This property is required. string
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. number
The number of requests that can be made per time period.
unit This property is required. str
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. int
The number of requests that can be made per time period.
unit This property is required. String
The unit of time over which rate limits are calculated. Example: SECOND
value This property is required. Number
The number of requests that can be made per time period.

GetUsagePlanEntitlementTarget

DeploymentId This property is required. string
The OCID of a deployment resource.
DeploymentId This property is required. string
The OCID of a deployment resource.
deploymentId This property is required. String
The OCID of a deployment resource.
deploymentId This property is required. string
The OCID of a deployment resource.
deployment_id This property is required. str
The OCID of a deployment resource.
deploymentId This property is required. String
The OCID of a deployment resource.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes
This Pulumi package is based on the oci Terraform Provider.
Oracle Cloud Infrastructure v2.30.0 published on Monday, Apr 14, 2025 by Pulumi