AWS v6.71.0, Mar 7 25

AWS v6.71.0 published on Friday, Mar 7, 2025 by Pulumi

aws.auditmanager.getControl

Explore with Pulumi AI

AWS v6.71.0 published on Friday, Mar 7, 2025 by Pulumi

Example Usage

Basic Usage

TypeScript
Python
Go
C#
Java
YAML

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

const example = aws.auditmanager.getControl({
    name: "1. Risk Management",
    type: "Standard",
});

import pulumi
import pulumi_aws as aws

example = aws.auditmanager.get_control(name="1. Risk Management",
    type="Standard")

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/auditmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := auditmanager.LookupControl(ctx, &auditmanager.LookupControlArgs{
			Name: "1. Risk Management",
			Type: "Standard",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Auditmanager.GetControl.Invoke(new()
    {
        Name = "1. Risk Management",
        Type = "Standard",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.auditmanager.AuditmanagerFunctions;
import com.pulumi.aws.auditmanager.inputs.GetControlArgs;
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 example = AuditmanagerFunctions.getControl(GetControlArgs.builder()
            .name("1. Risk Management")
            .type("Standard")
            .build());

    }
}

variables:
  example:
    fn::invoke:
      function: aws:auditmanager:getControl
      arguments:
        name: 1. Risk Management
        type: Standard

With Framework Resource

TypeScript
Python
Go
C#
Java
YAML

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

const example = aws.auditmanager.getControl({
    name: "1. Risk Management",
    type: "Standard",
});
const example2 = aws.auditmanager.getControl({
    name: "2. Personnel",
    type: "Standard",
});
const exampleFramework = new aws.auditmanager.Framework("example", {
    name: "example",
    controlSets: [
        {
            name: "example",
            controls: [{
                id: example.then(example => example.id),
            }],
        },
        {
            name: "example2",
            controls: [{
                id: example2.then(example2 => example2.id),
            }],
        },
    ],
});

import pulumi
import pulumi_aws as aws

example = aws.auditmanager.get_control(name="1. Risk Management",
    type="Standard")
example2 = aws.auditmanager.get_control(name="2. Personnel",
    type="Standard")
example_framework = aws.auditmanager.Framework("example",
    name="example",
    control_sets=[
        {
            "name": "example",
            "controls": [{
                "id": example.id,
            }],
        },
        {
            "name": "example2",
            "controls": [{
                "id": example2.id,
            }],
        },
    ])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/auditmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := auditmanager.LookupControl(ctx, &auditmanager.LookupControlArgs{
			Name: "1. Risk Management",
			Type: "Standard",
		}, nil)
		if err != nil {
			return err
		}
		example2, err := auditmanager.LookupControl(ctx, &auditmanager.LookupControlArgs{
			Name: "2. Personnel",
			Type: "Standard",
		}, nil)
		if err != nil {
			return err
		}
		_, err = auditmanager.NewFramework(ctx, "example", &auditmanager.FrameworkArgs{
			Name: pulumi.String("example"),
			ControlSets: auditmanager.FrameworkControlSetArray{
				&auditmanager.FrameworkControlSetArgs{
					Name: pulumi.String("example"),
					Controls: auditmanager.FrameworkControlSetControlArray{
						&auditmanager.FrameworkControlSetControlArgs{
							Id: pulumi.String(example.Id),
						},
					},
				},
				&auditmanager.FrameworkControlSetArgs{
					Name: pulumi.String("example2"),
					Controls: auditmanager.FrameworkControlSetControlArray{
						&auditmanager.FrameworkControlSetControlArgs{
							Id: pulumi.String(example2.Id),
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Auditmanager.GetControl.Invoke(new()
    {
        Name = "1. Risk Management",
        Type = "Standard",
    });

    var example2 = Aws.Auditmanager.GetControl.Invoke(new()
    {
        Name = "2. Personnel",
        Type = "Standard",
    });

    var exampleFramework = new Aws.Auditmanager.Framework("example", new()
    {
        Name = "example",
        ControlSets = new[]
        {
            new Aws.Auditmanager.Inputs.FrameworkControlSetArgs
            {
                Name = "example",
                Controls = new[]
                {
                    new Aws.Auditmanager.Inputs.FrameworkControlSetControlArgs
                    {
                        Id = example.Apply(getControlResult => getControlResult.Id),
                    },
                },
            },
            new Aws.Auditmanager.Inputs.FrameworkControlSetArgs
            {
                Name = "example2",
                Controls = new[]
                {
                    new Aws.Auditmanager.Inputs.FrameworkControlSetControlArgs
                    {
                        Id = example2.Apply(getControlResult => getControlResult.Id),
                    },
                },
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.auditmanager.AuditmanagerFunctions;
import com.pulumi.aws.auditmanager.inputs.GetControlArgs;
import com.pulumi.aws.auditmanager.Framework;
import com.pulumi.aws.auditmanager.FrameworkArgs;
import com.pulumi.aws.auditmanager.inputs.FrameworkControlSetArgs;
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 example = AuditmanagerFunctions.getControl(GetControlArgs.builder()
            .name("1. Risk Management")
            .type("Standard")
            .build());

        final var example2 = AuditmanagerFunctions.getControl(GetControlArgs.builder()
            .name("2. Personnel")
            .type("Standard")
            .build());

        var exampleFramework = new Framework("exampleFramework", FrameworkArgs.builder()
            .name("example")
            .controlSets(            
                FrameworkControlSetArgs.builder()
                    .name("example")
                    .controls(FrameworkControlSetControlArgs.builder()
                        .id(example.applyValue(getControlResult -> getControlResult.id()))
                        .build())
                    .build(),
                FrameworkControlSetArgs.builder()
                    .name("example2")
                    .controls(FrameworkControlSetControlArgs.builder()
                        .id(example2.applyValue(getControlResult -> getControlResult.id()))
                        .build())
                    .build())
            .build());

    }
}

resources:
  exampleFramework:
    type: aws:auditmanager:Framework
    name: example
    properties:
      name: example
      controlSets:
        - name: example
          controls:
            - id: ${example.id}
        - name: example2
          controls:
            - id: ${example2.id}
variables:
  example:
    fn::invoke:
      function: aws:auditmanager:getControl
      arguments:
        name: 1. Risk Management
        type: Standard
  example2:
    fn::invoke:
      function: aws:auditmanager:getControl
      arguments:
        name: 2. Personnel
        type: Standard

Using getControl

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.

TypeScript
Python
Go
C#
Java
YAML

function getControl(args: GetControlArgs, opts?: InvokeOptions): Promise<GetControlResult>
function getControlOutput(args: GetControlOutputArgs, opts?: InvokeOptions): Output<GetControlResult>

def get_control(control_mapping_sources: Optional[Sequence[GetControlControlMappingSource]] = None,
                name: Optional[str] = None,
                type: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetControlResult
def get_control_output(control_mapping_sources: Optional[pulumi.Input[Sequence[pulumi.Input[GetControlControlMappingSourceArgs]]]] = None,
                name: Optional[pulumi.Input[str]] = None,
                type: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetControlResult]

func LookupControl(ctx *Context, args *LookupControlArgs, opts ...InvokeOption) (*LookupControlResult, error)
func LookupControlOutput(ctx *Context, args *LookupControlOutputArgs, opts ...InvokeOption) LookupControlResultOutput

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

public static class GetControl 
{
    public static Task<GetControlResult> InvokeAsync(GetControlArgs args, InvokeOptions? opts = null)
    public static Output<GetControlResult> Invoke(GetControlInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetControlResult> getControl(GetControlArgs args, InvokeOptions options)
public static Output<GetControlResult> getControl(GetControlArgs args, InvokeOptions options)

fn::invoke:
  function: aws:auditmanager/getControl:getControl
  arguments:
    # arguments dictionary

The following arguments are supported:

Name string: Name of the control.
Type string: Type of control. Valid values are Custom and Standard.
ControlMappingSources List<GetControlControlMappingSource>

Name string: Name of the control.
Type string: Type of control. Valid values are Custom and Standard.
ControlMappingSources []GetControlControlMappingSource

name String: Name of the control.
type String: Type of control. Valid values are Custom and Standard.
controlMappingSources List<GetControlControlMappingSource>

name string: Name of the control.
type string: Type of control. Valid values are Custom and Standard.
controlMappingSources GetControlControlMappingSource[]

name str: Name of the control.
type str: Type of control. Valid values are Custom and Standard.
control_mapping_sources Sequence[GetControlControlMappingSource]

name String: Name of the control.
type String: Type of control. Valid values are Custom and Standard.
controlMappingSources List<Property Map>

getControl Result

The following output properties are available:

ActionPlanInstructions string
ActionPlanTitle string
Arn string
Description string
Id string
Name string
Tags Dictionary<string, string>
TestingInformation string
Type string
ControlMappingSources List<GetControlControlMappingSource>

ActionPlanInstructions string
ActionPlanTitle string
Arn string
Description string
Id string
Name string
Tags map[string]string
TestingInformation string
Type string
ControlMappingSources []GetControlControlMappingSource

actionPlanInstructions String
actionPlanTitle String
arn String
description String
id String
name String
tags Map<String,String>
testingInformation String
type String
controlMappingSources List<GetControlControlMappingSource>

actionPlanInstructions string
actionPlanTitle string
arn string
description string
id string
name string
tags {[key: string]: string}
testingInformation string
type string
controlMappingSources GetControlControlMappingSource[]

action_plan_instructions str
action_plan_title str
arn str
description str
id str
name str
tags Mapping[str, str]
testing_information str
type str
control_mapping_sources Sequence[GetControlControlMappingSource]

actionPlanInstructions String
actionPlanTitle String
arn String
description String
id String
name String
tags Map<String>
testingInformation String
type String
controlMappingSources List<Property Map>

Supporting Types

GetControlControlMappingSource

SourceDescription string
SourceFrequency string
SourceId string
SourceName string
SourceSetUpOption string
SourceType string
TroubleshootingText string
SourceKeyword GetControlControlMappingSourceSourceKeyword

SourceDescription string
SourceFrequency string
SourceId string
SourceName string
SourceSetUpOption string
SourceType string
TroubleshootingText string
SourceKeyword GetControlControlMappingSourceSourceKeyword

sourceDescription String
sourceFrequency String
sourceId String
sourceName String
sourceSetUpOption String
sourceType String
troubleshootingText String
sourceKeyword GetControlControlMappingSourceSourceKeyword

sourceDescription string
sourceFrequency string
sourceId string
sourceName string
sourceSetUpOption string
sourceType string
troubleshootingText string
sourceKeyword GetControlControlMappingSourceSourceKeyword

source_description str
source_frequency str
source_id str
source_name str
source_set_up_option str
source_type str
troubleshooting_text str
source_keyword GetControlControlMappingSourceSourceKeyword

sourceDescription String
sourceFrequency String
sourceId String
sourceName String
sourceSetUpOption String
sourceType String
troubleshootingText String
sourceKeyword Property Map

GetControlControlMappingSourceSourceKeyword

KeywordInputType string
KeywordValue string

KeywordInputType string
KeywordValue string

keywordInputType String
keywordValue String

keywordInputType string
keywordValue string

keyword_input_type str
keyword_value str

keywordInputType String
keywordValue String

Package Details

Repository: AWS Classic pulumi/pulumi-aws
License: Apache-2.0
Notes: This Pulumi package is based on the aws Terraform Provider.

AWS v6.71.0 published on Friday, Mar 7, 2025 by Pulumi

pulumi/pulumi-aws

aws.auditmanager.getControl

On this page

On this page

Example Usage

Basic Usage

With Framework Resource

Using getControl

getControl Result

Supporting Types

GetControlControlMappingSource

GetControlControlMappingSourceSourceKeyword

Package Details

On this page

On this page