Package com.pulumi.aws.cfg

Class RecorderStatus

java.lang.Object

com.pulumi.resources.Resource

com.pulumi.resources.CustomResource

com.pulumi.aws.cfg.RecorderStatus

public class RecorderStatus
extends com.pulumi.resources.CustomResource

Manages status (recording / stopped) of an AWS Config Configuration Recorder. > **Note:** Starting Configuration Recorder requires a Delivery Channel to be present. Use of `dependsOn` (as shown below) is recommended to avoid race conditions. ## Example Usage

 
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.s3.Bucket;
 import com.pulumi.aws.s3.BucketArgs;
 import com.pulumi.aws.cfg.DeliveryChannel;
 import com.pulumi.aws.cfg.DeliveryChannelArgs;
 import com.pulumi.aws.iam.IamFunctions;
 import com.pulumi.aws.iam.inputs.GetPolicyDocumentArgs;
 import com.pulumi.aws.iam.inputs.GetPolicyDocumentStatementArgs;
 import com.pulumi.aws.iam.inputs.GetPolicyDocumentStatementPrincipalArgs;
 import com.pulumi.aws.iam.Role;
 import com.pulumi.aws.iam.RoleArgs;
 import com.pulumi.aws.cfg.Recorder;
 import com.pulumi.aws.cfg.RecorderArgs;
 import com.pulumi.aws.cfg.RecorderStatus;
 import com.pulumi.aws.cfg.RecorderStatusArgs;
 import com.pulumi.aws.iam.RolePolicyAttachment;
 import com.pulumi.aws.iam.RolePolicyAttachmentArgs;
 import com.pulumi.aws.iam.RolePolicy;
 import com.pulumi.aws.iam.RolePolicyArgs;
 import com.pulumi.resources.CustomResourceOptions;
 import java.util.ArrayList;
 import java.util.Arrays;
 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) {
         var b = new Bucket("b", BucketArgs.builder()
             .bucket("awsconfig-example")
             .build());
 
         var fooDeliveryChannel = new DeliveryChannel("fooDeliveryChannel", DeliveryChannelArgs.builder()
             .name("example")
             .s3BucketName(b.bucket())
             .build());
 
         final var assumeRole = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
             .statements(GetPolicyDocumentStatementArgs.builder()
                 .principals(GetPolicyDocumentStatementPrincipalArgs.builder()
                     .type("Service")
                     .identifiers("config.amazonaws.com")
                     .build())
                 .effect("Allow")
                 .actions("sts:AssumeRole")
                 .build())
             .build());
 
         var r = new Role("r", RoleArgs.builder()
             .name("example-awsconfig")
             .assumeRolePolicy(assumeRole.json())
             .build());
 
         var fooRecorder = new Recorder("fooRecorder", RecorderArgs.builder()
             .name("example")
             .roleArn(r.arn())
             .build());
 
         var foo = new RecorderStatus("foo", RecorderStatusArgs.builder()
             .name(fooRecorder.name())
             .isEnabled(true)
             .build(), CustomResourceOptions.builder()
                 .dependsOn(fooDeliveryChannel)
                 .build());
 
         var a = new RolePolicyAttachment("a", RolePolicyAttachmentArgs.builder()
             .role(r.name())
             .policyArn("arn:aws:iam::aws:policy/service-role/AWS_ConfigRole")
             .build());
 
         final var p = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
             .statements(GetPolicyDocumentStatementArgs.builder()
                 .effect("Allow")
                 .actions("s3:*")
                 .resources(                
                     b.arn(),
                     b.arn().applyValue(_arn -> String.format("%s/*", _arn)))
                 .build())
             .build());
 
         var pRolePolicy = new RolePolicy("pRolePolicy", RolePolicyArgs.builder()
             .name("awsconfig-example")
             .role(r.id())
             .policy(p.applyValue(_p -> _p.json()))
             .build());
 
     }
 }
 
 

## Import ### Identity Schema #### Required * `name` (String) Name of the configuration recorder. #### Optional * `accountId` (String) AWS Account where this resource is managed. * `region` (String) Region where this resource is managed. Using `pulumi import`, import Configuration Recorder Statuses using the `name`. For example: ```sh $ pulumi import aws:cfg/recorderStatus:RecorderStatus example example ```

Nested Class Summary

Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

com.pulumi.resources.CustomResource.CustomResourceInternal

Nested classes/interfaces inherited from class com.pulumi.resources.Resource

com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

Field Summary

Fields inherited from class com.pulumi.resources.Resource

childResources, remote

Constructor Summary

Constructors

Constructor	Description
RecorderStatus(java.lang.String name)
RecorderStatus(java.lang.String name, RecorderStatusArgs args)
RecorderStatus(java.lang.String name, RecorderStatusArgs args, com.pulumi.resources.CustomResourceOptions options)

Method Summary

Modifier and Type	Method	Description
static RecorderStatus	get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, RecorderStatusState state, com.pulumi.resources.CustomResourceOptions options)	Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
com.pulumi.core.Output<java.lang.Boolean>	isEnabled()
com.pulumi.core.Output<java.lang.String>	name()
com.pulumi.core.Output<java.lang.String>	region()

Methods inherited from class com.pulumi.resources.CustomResource

getId, id, idFuture

Methods inherited from class com.pulumi.resources.Resource

getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RecorderStatus

public RecorderStatus(java.lang.String name)

Parameters:

name - The _unique_ name of the resulting resource.

RecorderStatus

public RecorderStatus(java.lang.String name,
                      RecorderStatusArgs args)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

RecorderStatus

public RecorderStatus(java.lang.String name,
                      RecorderStatusArgs args,
                      @Nullable
                      com.pulumi.resources.CustomResourceOptions options)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

options - A bag of options that control this resource's behavior.

Method Detail

isEnabled

public com.pulumi.core.Output<java.lang.Boolean> isEnabled()

Returns:

Whether the configuration recorder should be enabled or disabled.

name

public com.pulumi.core.Output<java.lang.String> name()

Returns:

The name of the configuration recorder.

region

public com.pulumi.core.Output<java.lang.String> region()

Returns:

Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.

get

public static RecorderStatus get(java.lang.String name,
                                 com.pulumi.core.Output<java.lang.String> id,
                                 @Nullable
                                 RecorderStatusState state,
                                 @Nullable
                                 com.pulumi.resources.CustomResourceOptions options)

Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.

Parameters:

name - The _unique_ name of the resulting resource.

id - The _unique_ provider ID of the resource to lookup.

state -

options - Optional settings to control the behavior of the CustomResource.