All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.pulumi.aws.directoryservice.kotlin.LogServiceArgs.kt Maven / Gradle / Ivy

Go to download

Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.

There is a newer version: 6.57.0.0
Show newest version
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.aws.directoryservice.kotlin

import com.pulumi.aws.directoryservice.LogServiceArgs.builder
import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import kotlin.String
import kotlin.Suppress
import kotlin.jvm.JvmName

/**
 * Provides a Log subscription for AWS Directory Service that pushes logs to cloudwatch.
 * ## Example Usage
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as aws from "@pulumi/aws";
 * const example = new aws.cloudwatch.LogGroup("example", {
 *     name: `/aws/directoryservice/${exampleAwsDirectoryServiceDirectory.id}`,
 *     retentionInDays: 14,
 * });
 * const ad-log-policy = aws.iam.getPolicyDocumentOutput({
 *     statements: [{
 *         actions: [
 *             "logs:CreateLogStream",
 *             "logs:PutLogEvents",
 *         ],
 *         principals: [{
 *             identifiers: ["ds.amazonaws.com"],
 *             type: "Service",
 *         }],
 *         resources: [pulumi.interpolate`${example.arn}:*`],
 *         effect: "Allow",
 *     }],
 * });
 * const ad_log_policyLogResourcePolicy = new aws.cloudwatch.LogResourcePolicy("ad-log-policy", {
 *     policyDocument: ad_log_policy.apply(ad_log_policy => ad_log_policy.json),
 *     policyName: "ad-log-policy",
 * });
 * const exampleLogService = new aws.directoryservice.LogService("example", {
 *     directoryId: exampleAwsDirectoryServiceDirectory.id,
 *     logGroupName: example.name,
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_aws as aws
 * example = aws.cloudwatch.LogGroup("example",
 *     name=f"/aws/directoryservice/{example_aws_directory_service_directory['id']}",
 *     retention_in_days=14)
 * ad_log_policy = aws.iam.get_policy_document_output(statements=[{
 *     "actions": [
 *         "logs:CreateLogStream",
 *         "logs:PutLogEvents",
 *     ],
 *     "principals": [{
 *         "identifiers": ["ds.amazonaws.com"],
 *         "type": "Service",
 *     }],
 *     "resources": [example.arn.apply(lambda arn: f"{arn}:*")],
 *     "effect": "Allow",
 * }])
 * ad_log_policy_log_resource_policy = aws.cloudwatch.LogResourcePolicy("ad-log-policy",
 *     policy_document=ad_log_policy.json,
 *     policy_name="ad-log-policy")
 * example_log_service = aws.directoryservice.LogService("example",
 *     directory_id=example_aws_directory_service_directory["id"],
 *     log_group_name=example.name)
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Aws = Pulumi.Aws;
 * return await Deployment.RunAsync(() =>
 * {
 *     var example = new Aws.CloudWatch.LogGroup("example", new()
 *     {
 *         Name = $"/aws/directoryservice/{exampleAwsDirectoryServiceDirectory.Id}",
 *         RetentionInDays = 14,
 *     });
 *     var ad_log_policy = Aws.Iam.GetPolicyDocument.Invoke(new()
 *     {
 *         Statements = new[]
 *         {
 *             new Aws.Iam.Inputs.GetPolicyDocumentStatementInputArgs
 *             {
 *                 Actions = new[]
 *                 {
 *                     "logs:CreateLogStream",
 *                     "logs:PutLogEvents",
 *                 },
 *                 Principals = new[]
 *                 {
 *                     new Aws.Iam.Inputs.GetPolicyDocumentStatementPrincipalInputArgs
 *                     {
 *                         Identifiers = new[]
 *                         {
 *                             "ds.amazonaws.com",
 *                         },
 *                         Type = "Service",
 *                     },
 *                 },
 *                 Resources = new[]
 *                 {
 *                     $"{example.Arn}:*",
 *                 },
 *                 Effect = "Allow",
 *             },
 *         },
 *     });
 *     var ad_log_policyLogResourcePolicy = new Aws.CloudWatch.LogResourcePolicy("ad-log-policy", new()
 *     {
 *         PolicyDocument = ad_log_policy.Apply(ad_log_policy => ad_log_policy.Apply(getPolicyDocumentResult => getPolicyDocumentResult.Json)),
 *         PolicyName = "ad-log-policy",
 *     });
 *     var exampleLogService = new Aws.DirectoryService.LogService("example", new()
 *     {
 *         DirectoryId = exampleAwsDirectoryServiceDirectory.Id,
 *         LogGroupName = example.Name,
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"fmt"
 * 	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudwatch"
 * 	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/directoryservice"
 * 	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		example, err := cloudwatch.NewLogGroup(ctx, "example", &cloudwatch.LogGroupArgs{
 * 			Name:            pulumi.Sprintf("/aws/directoryservice/%v", exampleAwsDirectoryServiceDirectory.Id),
 * 			RetentionInDays: pulumi.Int(14),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		ad_log_policy := iam.GetPolicyDocumentOutput(ctx, iam.GetPolicyDocumentOutputArgs{
 * 			Statements: iam.GetPolicyDocumentStatementArray{
 * 				&iam.GetPolicyDocumentStatementArgs{
 * 					Actions: pulumi.StringArray{
 * 						pulumi.String("logs:CreateLogStream"),
 * 						pulumi.String("logs:PutLogEvents"),
 * 					},
 * 					Principals: iam.GetPolicyDocumentStatementPrincipalArray{
 * 						&iam.GetPolicyDocumentStatementPrincipalArgs{
 * 							Identifiers: pulumi.StringArray{
 * 								pulumi.String("ds.amazonaws.com"),
 * 							},
 * 							Type: pulumi.String("Service"),
 * 						},
 * 					},
 * 					Resources: pulumi.StringArray{
 * 						example.Arn.ApplyT(func(arn string) (string, error) {
 * 							return fmt.Sprintf("%v:*", arn), nil
 * 						}).(pulumi.StringOutput),
 * 					},
 * 					Effect: pulumi.String("Allow"),
 * 				},
 * 			},
 * 		}, nil)
 * 		_, err = cloudwatch.NewLogResourcePolicy(ctx, "ad-log-policy", &cloudwatch.LogResourcePolicyArgs{
 * 			PolicyDocument: pulumi.String(ad_log_policy.ApplyT(func(ad_log_policy iam.GetPolicyDocumentResult) (*string, error) {
 * 				return &ad_log_policy.Json, nil
 * 			}).(pulumi.StringPtrOutput)),
 * 			PolicyName: pulumi.String("ad-log-policy"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = directoryservice.NewLogService(ctx, "example", &directoryservice.LogServiceArgs{
 * 			DirectoryId:  pulumi.Any(exampleAwsDirectoryServiceDirectory.Id),
 * 			LogGroupName: example.Name,
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		return nil
 * 	})
 * }
 * ```
 * ```java
 * package generated_program;
 * import com.pulumi.Context;
 * import com.pulumi.Pulumi;
 * import com.pulumi.core.Output;
 * import com.pulumi.aws.cloudwatch.LogGroup;
 * import com.pulumi.aws.cloudwatch.LogGroupArgs;
 * import com.pulumi.aws.iam.IamFunctions;
 * import com.pulumi.aws.iam.inputs.GetPolicyDocumentArgs;
 * import com.pulumi.aws.cloudwatch.LogResourcePolicy;
 * import com.pulumi.aws.cloudwatch.LogResourcePolicyArgs;
 * import com.pulumi.aws.directoryservice.LogService;
 * import com.pulumi.aws.directoryservice.LogServiceArgs;
 * 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) {
 *         var example = new LogGroup("example", LogGroupArgs.builder()
 *             .name(String.format("/aws/directoryservice/%s", exampleAwsDirectoryServiceDirectory.id()))
 *             .retentionInDays(14)
 *             .build());
 *         final var ad-log-policy = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
 *             .statements(GetPolicyDocumentStatementArgs.builder()
 *                 .actions(
 *                     "logs:CreateLogStream",
 *                     "logs:PutLogEvents")
 *                 .principals(GetPolicyDocumentStatementPrincipalArgs.builder()
 *                     .identifiers("ds.amazonaws.com")
 *                     .type("Service")
 *                     .build())
 *                 .resources(example.arn().applyValue(arn -> String.format("%s:*", arn)))
 *                 .effect("Allow")
 *                 .build())
 *             .build());
 *         var ad_log_policyLogResourcePolicy = new LogResourcePolicy("ad-log-policyLogResourcePolicy", LogResourcePolicyArgs.builder()
 *             .policyDocument(ad_log_policy.applyValue(ad_log_policy -> ad_log_policy.json()))
 *             .policyName("ad-log-policy")
 *             .build());
 *         var exampleLogService = new LogService("exampleLogService", LogServiceArgs.builder()
 *             .directoryId(exampleAwsDirectoryServiceDirectory.id())
 *             .logGroupName(example.name())
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   example:
 *     type: aws:cloudwatch:LogGroup
 *     properties:
 *       name: /aws/directoryservice/${exampleAwsDirectoryServiceDirectory.id}
 *       retentionInDays: 14
 *   ad-log-policyLogResourcePolicy:
 *     type: aws:cloudwatch:LogResourcePolicy
 *     name: ad-log-policy
 *     properties:
 *       policyDocument: ${["ad-log-policy"].json}
 *       policyName: ad-log-policy
 *   exampleLogService:
 *     type: aws:directoryservice:LogService
 *     name: example
 *     properties:
 *       directoryId: ${exampleAwsDirectoryServiceDirectory.id}
 *       logGroupName: ${example.name}
 * variables:
 *   ad-log-policy:
 *     fn::invoke:
 *       Function: aws:iam:getPolicyDocument
 *       Arguments:
 *         statements:
 *           - actions:
 *               - logs:CreateLogStream
 *               - logs:PutLogEvents
 *             principals:
 *               - identifiers:
 *                   - ds.amazonaws.com
 *                 type: Service
 *             resources:
 *               - ${example.arn}:*
 *             effect: Allow
 * ```
 * 
 * ## Import
 * Using `pulumi import`, import Directory Service Log Subscriptions using the directory id. For example:
 * ```sh
 * $ pulumi import aws:directoryservice/logService:LogService msad d-1234567890
 * ```
 * @property directoryId ID of directory.
 * @property logGroupName Name of the cloudwatch log group to which the logs should be published. The log group should be already created and the directory service principal should be provided with required permission to create stream and publish logs. Changing this value would delete the current subscription and create a new one. A directory can only have one log subscription at a time.
 */
public data class LogServiceArgs(
    public val directoryId: Output? = null,
    public val logGroupName: Output? = null,
) : ConvertibleToJava {
    override fun toJava(): com.pulumi.aws.directoryservice.LogServiceArgs =
        com.pulumi.aws.directoryservice.LogServiceArgs.builder()
            .directoryId(directoryId?.applyValue({ args0 -> args0 }))
            .logGroupName(logGroupName?.applyValue({ args0 -> args0 })).build()
}

/**
 * Builder for [LogServiceArgs].
 */
@PulumiTagMarker
public class LogServiceArgsBuilder internal constructor() {
    private var directoryId: Output? = null

    private var logGroupName: Output? = null

    /**
     * @param value ID of directory.
     */
    @JvmName("mrxknlbevxdureif")
    public suspend fun directoryId(`value`: Output) {
        this.directoryId = value
    }

    /**
     * @param value Name of the cloudwatch log group to which the logs should be published. The log group should be already created and the directory service principal should be provided with required permission to create stream and publish logs. Changing this value would delete the current subscription and create a new one. A directory can only have one log subscription at a time.
     */
    @JvmName("twbexjkbdenlggcy")
    public suspend fun logGroupName(`value`: Output) {
        this.logGroupName = value
    }

    /**
     * @param value ID of directory.
     */
    @JvmName("jrmqlnecpvvflqru")
    public suspend fun directoryId(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.directoryId = mapped
    }

    /**
     * @param value Name of the cloudwatch log group to which the logs should be published. The log group should be already created and the directory service principal should be provided with required permission to create stream and publish logs. Changing this value would delete the current subscription and create a new one. A directory can only have one log subscription at a time.
     */
    @JvmName("ruaunvlnoaukbley")
    public suspend fun logGroupName(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.logGroupName = mapped
    }

    internal fun build(): LogServiceArgs = LogServiceArgs(
        directoryId = directoryId,
        logGroupName = logGroupName,
    )
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy