Oracle Cloud Infrastructure

Pulumi Official
Package maintained by Pulumi
v0.1.1 published on Tuesday, May 3, 2022 by Pulumi

getCategories

This data source provides the list of Categories in Oracle Cloud Infrastructure Optimizer service.

Lists the supported Cloud Advisor categories.

Example Usage

using Pulumi;
using Oci = Pulumi.Oci;

class MyStack : Stack
{
    public MyStack()
    {
        var testCategories = Output.Create(Oci.Optimizer.GetCategories.InvokeAsync(new Oci.Optimizer.GetCategoriesArgs
        {
            CompartmentId = @var.Compartment_id,
            CompartmentIdInSubtree = @var.Category_compartment_id_in_subtree,
            Name = @var.Category_name,
            State = @var.Category_state,
        }));
    }

}
package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Optimizer.GetCategories(ctx, &optimizer.GetCategoriesArgs{
			CompartmentId:          _var.Compartment_id,
			CompartmentIdInSubtree: _var.Category_compartment_id_in_subtree,
			Name:                   pulumi.StringRef(_var.Category_name),
			State:                  pulumi.StringRef(_var.Category_state),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import pulumi
import pulumi_oci as oci

test_categories = oci.Optimizer.get_categories(compartment_id=var["compartment_id"],
    compartment_id_in_subtree=var["category_compartment_id_in_subtree"],
    name=var["category_name"],
    state=var["category_state"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testCategories = oci.Optimizer.getCategories({
    compartmentId: _var.compartment_id,
    compartmentIdInSubtree: _var.category_compartment_id_in_subtree,
    name: _var.category_name,
    state: _var.category_state,
});

Coming soon!

Using getCategories

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 getCategories(args: GetCategoriesArgs, opts?: InvokeOptions): Promise<GetCategoriesResult>
function getCategoriesOutput(args: GetCategoriesOutputArgs, opts?: InvokeOptions): Output<GetCategoriesResult>
def get_categories(compartment_id: Optional[str] = None,
                   compartment_id_in_subtree: Optional[bool] = None,
                   filters: Optional[Sequence[_optimizer.GetCategoriesFilter]] = None,
                   name: Optional[str] = None,
                   state: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetCategoriesResult
def get_categories_output(compartment_id: Optional[pulumi.Input[str]] = None,
                   compartment_id_in_subtree: Optional[pulumi.Input[bool]] = None,
                   filters: Optional[pulumi.Input[Sequence[pulumi.Input[_optimizer.GetCategoriesFilterArgs]]]] = None,
                   name: Optional[pulumi.Input[str]] = None,
                   state: Optional[pulumi.Input[str]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetCategoriesResult]
func GetCategories(ctx *Context, args *GetCategoriesArgs, opts ...InvokeOption) (*GetCategoriesResult, error)
func GetCategoriesOutput(ctx *Context, args *GetCategoriesOutputArgs, opts ...InvokeOption) GetCategoriesResultOutput

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

public static class GetCategories 
{
    public static Task<GetCategoriesResult> InvokeAsync(GetCategoriesArgs args, InvokeOptions? opts = null)
    public static Output<GetCategoriesResult> Invoke(GetCategoriesInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetCategoriesResult> getCategories(GetCategoriesArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
  Function: oci:Optimizer/getCategories:getCategories
  Arguments:
    # Arguments dictionary

The following arguments are supported:

CompartmentId string

The OCID of the compartment.

CompartmentIdInSubtree bool

When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are returned depending on the the setting of accessLevel.

Filters List<GetCategoriesFilter>
Name string

Optional. A filter that returns results that match the name specified.

State string

A filter that returns results that match the lifecycle state specified.

CompartmentId string

The OCID of the compartment.

CompartmentIdInSubtree bool

When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are returned depending on the the setting of accessLevel.

Filters []GetCategoriesFilter
Name string

Optional. A filter that returns results that match the name specified.

State string

A filter that returns results that match the lifecycle state specified.

compartmentId String

The OCID of the compartment.

compartmentIdInSubtree Boolean

When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are returned depending on the the setting of accessLevel.

filters List<GetCategoriesFilter>
name String

Optional. A filter that returns results that match the name specified.

state String

A filter that returns results that match the lifecycle state specified.

compartmentId string

The OCID of the compartment.

compartmentIdInSubtree boolean

When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are returned depending on the the setting of accessLevel.

filters GetCategoriesFilter[]
name string

Optional. A filter that returns results that match the name specified.

state string

A filter that returns results that match the lifecycle state specified.

compartment_id str

The OCID of the compartment.

compartment_id_in_subtree bool

When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are returned depending on the the setting of accessLevel.

filters GetCategoriesFilter]
name str

Optional. A filter that returns results that match the name specified.

state str

A filter that returns results that match the lifecycle state specified.

compartmentId String

The OCID of the compartment.

compartmentIdInSubtree Boolean

When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are returned depending on the the setting of accessLevel.

filters List<Property Map>
name String

Optional. A filter that returns results that match the name specified.

state String

A filter that returns results that match the lifecycle state specified.

getCategories Result

The following output properties are available:

CategoryCollections List<GetCategoriesCategoryCollection>

The list of category_collection.

CompartmentId string

The OCID of the tenancy. The tenancy is the root compartment.

CompartmentIdInSubtree bool
Id string

The provider-assigned unique ID for this managed resource.

Filters List<GetCategoriesFilter>
Name string

The name assigned to the category.

State string

The category's current state.

CategoryCollections []GetCategoriesCategoryCollection

The list of category_collection.

CompartmentId string

The OCID of the tenancy. The tenancy is the root compartment.

CompartmentIdInSubtree bool
Id string

The provider-assigned unique ID for this managed resource.

Filters []GetCategoriesFilter
Name string

The name assigned to the category.

State string

The category's current state.

categoryCollections List<GetCategoriesCategoryCollection>

The list of category_collection.

compartmentId String

The OCID of the tenancy. The tenancy is the root compartment.

compartmentIdInSubtree Boolean
id String

The provider-assigned unique ID for this managed resource.

filters List<GetCategoriesFilter>
name String

The name assigned to the category.

state String

The category's current state.

categoryCollections GetCategoriesCategoryCollection[]

The list of category_collection.

compartmentId string

The OCID of the tenancy. The tenancy is the root compartment.

compartmentIdInSubtree boolean
id string

The provider-assigned unique ID for this managed resource.

filters GetCategoriesFilter[]
name string

The name assigned to the category.

state string

The category's current state.

category_collections GetCategoriesCategoryCollection]

The list of category_collection.

compartment_id str

The OCID of the tenancy. The tenancy is the root compartment.

compartment_id_in_subtree bool
id str

The provider-assigned unique ID for this managed resource.

filters GetCategoriesFilter]
name str

The name assigned to the category.

state str

The category's current state.

categoryCollections List<Property Map>

The list of category_collection.

compartmentId String

The OCID of the tenancy. The tenancy is the root compartment.

compartmentIdInSubtree Boolean
id String

The provider-assigned unique ID for this managed resource.

filters List<Property Map>
name String

The name assigned to the category.

state String

The category's current state.

Supporting Types

GetCategoriesCategoryCollection

GetCategoriesCategoryCollectionItem

CompartmentId string

The OCID of the compartment.

Description string

Text describing the category.

EstimatedCostSaving double

The estimated cost savings, in dollars, for the category.

ExtendedMetadata Dictionary<string, object>

Additional metadata key/value pairs for the category.

Id string

The unique OCID of the category.

Name string

Optional. A filter that returns results that match the name specified.

RecommendationCounts List<GetCategoriesCategoryCollectionItemRecommendationCount>

An array of RecommendationCount objects grouped by the level of importance assigned to the recommendation.

ResourceCounts List<GetCategoriesCategoryCollectionItemResourceCount>

An array of ResourceCount objects grouped by the status of the recommendation.

State string

A filter that returns results that match the lifecycle state specified.

TimeCreated string

The date and time the category details were created, in the format defined by RFC3339.

TimeUpdated string

The date and time the category details were last updated, in the format defined by RFC3339.

CompartmentId string

The OCID of the compartment.

Description string

Text describing the category.

EstimatedCostSaving float64

The estimated cost savings, in dollars, for the category.

ExtendedMetadata map[string]interface{}

Additional metadata key/value pairs for the category.

Id string

The unique OCID of the category.

Name string

Optional. A filter that returns results that match the name specified.

RecommendationCounts []GetCategoriesCategoryCollectionItemRecommendationCount

An array of RecommendationCount objects grouped by the level of importance assigned to the recommendation.

ResourceCounts []GetCategoriesCategoryCollectionItemResourceCount

An array of ResourceCount objects grouped by the status of the recommendation.

State string

A filter that returns results that match the lifecycle state specified.

TimeCreated string

The date and time the category details were created, in the format defined by RFC3339.

TimeUpdated string

The date and time the category details were last updated, in the format defined by RFC3339.

compartmentId String

The OCID of the compartment.

description String

Text describing the category.

estimatedCostSaving Double

The estimated cost savings, in dollars, for the category.

extendedMetadata Map<String,Object>

Additional metadata key/value pairs for the category.

id String

The unique OCID of the category.

name String

Optional. A filter that returns results that match the name specified.

recommendationCounts List<GetCategoriesCategoryCollectionItemRecommendationCount>

An array of RecommendationCount objects grouped by the level of importance assigned to the recommendation.

resourceCounts List<GetCategoriesCategoryCollectionItemResourceCount>

An array of ResourceCount objects grouped by the status of the recommendation.

state String

A filter that returns results that match the lifecycle state specified.

timeCreated String

The date and time the category details were created, in the format defined by RFC3339.

timeUpdated String

The date and time the category details were last updated, in the format defined by RFC3339.

compartmentId string

The OCID of the compartment.

description string

Text describing the category.

estimatedCostSaving number

The estimated cost savings, in dollars, for the category.

extendedMetadata {[key: string]: any}

Additional metadata key/value pairs for the category.

id string

The unique OCID of the category.

name string

Optional. A filter that returns results that match the name specified.

recommendationCounts GetCategoriesCategoryCollectionItemRecommendationCount[]

An array of RecommendationCount objects grouped by the level of importance assigned to the recommendation.

resourceCounts GetCategoriesCategoryCollectionItemResourceCount[]

An array of ResourceCount objects grouped by the status of the recommendation.

state string

A filter that returns results that match the lifecycle state specified.

timeCreated string

The date and time the category details were created, in the format defined by RFC3339.

timeUpdated string

The date and time the category details were last updated, in the format defined by RFC3339.

compartment_id str

The OCID of the compartment.

description str

Text describing the category.

estimated_cost_saving float

The estimated cost savings, in dollars, for the category.

extended_metadata Mapping[str, Any]

Additional metadata key/value pairs for the category.

id str

The unique OCID of the category.

name str

Optional. A filter that returns results that match the name specified.

recommendation_counts GetCategoriesCategoryCollectionItemRecommendationCount]

An array of RecommendationCount objects grouped by the level of importance assigned to the recommendation.

resource_counts GetCategoriesCategoryCollectionItemResourceCount]

An array of ResourceCount objects grouped by the status of the recommendation.

state str

A filter that returns results that match the lifecycle state specified.

time_created str

The date and time the category details were created, in the format defined by RFC3339.

time_updated str

The date and time the category details were last updated, in the format defined by RFC3339.

compartmentId String

The OCID of the compartment.

description String

Text describing the category.

estimatedCostSaving Number

The estimated cost savings, in dollars, for the category.

extendedMetadata Map<Any>

Additional metadata key/value pairs for the category.

id String

The unique OCID of the category.

name String

Optional. A filter that returns results that match the name specified.

recommendationCounts List<Property Map>

An array of RecommendationCount objects grouped by the level of importance assigned to the recommendation.

resourceCounts List<Property Map>

An array of ResourceCount objects grouped by the status of the recommendation.

state String

A filter that returns results that match the lifecycle state specified.

timeCreated String

The date and time the category details were created, in the format defined by RFC3339.

timeUpdated String

The date and time the category details were last updated, in the format defined by RFC3339.

GetCategoriesCategoryCollectionItemRecommendationCount

Count int

The count of resources.

Importance string

The level of importance assigned to the recommendation.

Count int

The count of resources.

Importance string

The level of importance assigned to the recommendation.

count Integer

The count of resources.

importance String

The level of importance assigned to the recommendation.

count number

The count of resources.

importance string

The level of importance assigned to the recommendation.

count int

The count of resources.

importance str

The level of importance assigned to the recommendation.

count Number

The count of resources.

importance String

The level of importance assigned to the recommendation.

GetCategoriesCategoryCollectionItemResourceCount

Count int

The count of resources.

Status string

The recommendation status of the resource.

Count int

The count of resources.

Status string

The recommendation status of the resource.

count Integer

The count of resources.

status String

The recommendation status of the resource.

count number

The count of resources.

status string

The recommendation status of the resource.

count int

The count of resources.

status str

The recommendation status of the resource.

count Number

The count of resources.

status String

The recommendation status of the resource.

GetCategoriesFilter

Name string

Optional. A filter that returns results that match the name specified.

Values List<string>
Regex bool
Name string

Optional. A filter that returns results that match the name specified.

Values []string
Regex bool
name String

Optional. A filter that returns results that match the name specified.

values List<String>
regex Boolean
name string

Optional. A filter that returns results that match the name specified.

values string[]
regex boolean
name str

Optional. A filter that returns results that match the name specified.

values Sequence[str]
regex bool
name String

Optional. A filter that returns results that match the name specified.

values List<String>
regex Boolean

Package Details

Repository
https://github.com/pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.