Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
com.pulumi.aws.route53.kotlin.QueryLog.kt Maven / Gradle / Ivy
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.aws.route53.kotlin
import com.pulumi.core.Output
import com.pulumi.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
/**
* Builder for [QueryLog].
*/
@PulumiTagMarker
public class QueryLogResourceBuilder internal constructor() {
public var name: String? = null
public var args: QueryLogArgs = QueryLogArgs()
public var opts: CustomResourceOptions = CustomResourceOptions()
/**
* @param name The _unique_ name of the resulting resource.
*/
public fun name(`value`: String) {
this.name = value
}
/**
* @param block The arguments to use to populate this resource's properties.
*/
public suspend fun args(block: suspend QueryLogArgsBuilder.() -> Unit) {
val builder = QueryLogArgsBuilder()
block(builder)
this.args = builder.build()
}
/**
* @param block A bag of options that control this resource's behavior.
*/
public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
}
internal fun build(): QueryLog {
val builtJavaResource = com.pulumi.aws.route53.QueryLog(
this.name,
this.args.toJava(),
this.opts.toJava(),
)
return QueryLog(builtJavaResource)
}
}
/**
* Provides a Route53 query logging configuration resource.
* > **NOTE:** There are restrictions on the configuration of query logging. Notably,
* the CloudWatch log group must be in the `us-east-1` region,
* a permissive CloudWatch log resource policy must be in place, and
* the Route53 hosted zone must be public.
* See [Configuring Logging for DNS Queries](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html?console_help=true#query-logs-configuring) for additional details.
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as aws from "@pulumi/aws";
* // Example Route53 zone with query logging
* const exampleCom = new aws.route53.Zone("example_com", {name: "example.com"});
* const awsRoute53ExampleCom = new aws.cloudwatch.LogGroup("aws_route53_example_com", {
* name: pulumi.interpolate`/aws/route53/${exampleCom.name}`,
* retentionInDays: 30,
* });
* // Example CloudWatch log resource policy to allow Route53 to write logs
* // to any log group under /aws/route53/*
* const route53-query-logging-policy = aws.iam.getPolicyDocument({
* statements: [{
* actions: [
* "logs:CreateLogStream",
* "logs:PutLogEvents",
* ],
* resources: ["arn:aws:logs:*:*:log-group:/aws/route53/*"],
* principals: [{
* identifiers: ["route53.amazonaws.com"],
* type: "Service",
* }],
* }],
* });
* const route53_query_logging_policyLogResourcePolicy = new aws.cloudwatch.LogResourcePolicy("route53-query-logging-policy", {
* policyDocument: route53_query_logging_policy.then(route53_query_logging_policy => route53_query_logging_policy.json),
* policyName: "route53-query-logging-policy",
* });
* const exampleComQueryLog = new aws.route53.QueryLog("example_com", {
* cloudwatchLogGroupArn: awsRoute53ExampleCom.arn,
* zoneId: exampleCom.zoneId,
* }, {
* dependsOn: [route53_query_logging_policyLogResourcePolicy],
* });
* ```
* ```python
* import pulumi
* import pulumi_aws as aws
* # Example Route53 zone with query logging
* example_com = aws.route53.Zone("example_com", name="example.com")
* aws_route53_example_com = aws.cloudwatch.LogGroup("aws_route53_example_com",
* name=example_com.name.apply(lambda name: f"/aws/route53/{name}"),
* retention_in_days=30)
* # Example CloudWatch log resource policy to allow Route53 to write logs
* # to any log group under /aws/route53/*
* route53_query_logging_policy = aws.iam.get_policy_document(statements=[{
* "actions": [
* "logs:CreateLogStream",
* "logs:PutLogEvents",
* ],
* "resources": ["arn:aws:logs:*:*:log-group:/aws/route53/*"],
* "principals": [{
* "identifiers": ["route53.amazonaws.com"],
* "type": "Service",
* }],
* }])
* route53_query_logging_policy_log_resource_policy = aws.cloudwatch.LogResourcePolicy("route53-query-logging-policy",
* policy_document=route53_query_logging_policy.json,
* policy_name="route53-query-logging-policy")
* example_com_query_log = aws.route53.QueryLog("example_com",
* cloudwatch_log_group_arn=aws_route53_example_com.arn,
* zone_id=example_com.zone_id,
* opts = pulumi.ResourceOptions(depends_on=[route53_query_logging_policy_log_resource_policy]))
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using Aws = Pulumi.Aws;
* return await Deployment.RunAsync(() =>
* {
* // Example Route53 zone with query logging
* var exampleCom = new Aws.Route53.Zone("example_com", new()
* {
* Name = "example.com",
* });
* var awsRoute53ExampleCom = new Aws.CloudWatch.LogGroup("aws_route53_example_com", new()
* {
* Name = exampleCom.Name.Apply(name => $"/aws/route53/{name}"),
* RetentionInDays = 30,
* });
* // Example CloudWatch log resource policy to allow Route53 to write logs
* // to any log group under /aws/route53/*
* var route53_query_logging_policy = Aws.Iam.GetPolicyDocument.Invoke(new()
* {
* Statements = new[]
* {
* new Aws.Iam.Inputs.GetPolicyDocumentStatementInputArgs
* {
* Actions = new[]
* {
* "logs:CreateLogStream",
* "logs:PutLogEvents",
* },
* Resources = new[]
* {
* "arn:aws:logs:*:*:log-group:/aws/route53/*",
* },
* Principals = new[]
* {
* new Aws.Iam.Inputs.GetPolicyDocumentStatementPrincipalInputArgs
* {
* Identifiers = new[]
* {
* "route53.amazonaws.com",
* },
* Type = "Service",
* },
* },
* },
* },
* });
* var route53_query_logging_policyLogResourcePolicy = new Aws.CloudWatch.LogResourcePolicy("route53-query-logging-policy", new()
* {
* PolicyDocument = route53_query_logging_policy.Apply(route53_query_logging_policy => route53_query_logging_policy.Apply(getPolicyDocumentResult => getPolicyDocumentResult.Json)),
* PolicyName = "route53-query-logging-policy",
* });
* var exampleComQueryLog = new Aws.Route53.QueryLog("example_com", new()
* {
* CloudwatchLogGroupArn = awsRoute53ExampleCom.Arn,
* ZoneId = exampleCom.ZoneId,
* }, new CustomResourceOptions
* {
* DependsOn =
* {
* route53_query_logging_policyLogResourcePolicy,
* },
* });
* });
* ```
* ```go
* package main
* import (
* "fmt"
* "github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudwatch"
* "github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
* "github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* // Example Route53 zone with query logging
* exampleCom, err := route53.NewZone(ctx, "example_com", &route53.ZoneArgs{
* Name: pulumi.String("example.com"),
* })
* if err != nil {
* return err
* }
* awsRoute53ExampleCom, err := cloudwatch.NewLogGroup(ctx, "aws_route53_example_com", &cloudwatch.LogGroupArgs{
* Name: exampleCom.Name.ApplyT(func(name string) (string, error) {
* return fmt.Sprintf("/aws/route53/%v", name), nil
* }).(pulumi.StringOutput),
* RetentionInDays: pulumi.Int(30),
* })
* if err != nil {
* return err
* }
* // Example CloudWatch log resource policy to allow Route53 to write logs
* // to any log group under /aws/route53/*
* route53_query_logging_policy, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{
* Statements: []iam.GetPolicyDocumentStatement{
* {
* Actions: []string{
* "logs:CreateLogStream",
* "logs:PutLogEvents",
* },
* Resources: []string{
* "arn:aws:logs:*:*:log-group:/aws/route53/*",
* },
* Principals: []iam.GetPolicyDocumentStatementPrincipal{
* {
* Identifiers: []string{
* "route53.amazonaws.com",
* },
* Type: "Service",
* },
* },
* },
* },
* }, nil)
* if err != nil {
* return err
* }
* _, err = cloudwatch.NewLogResourcePolicy(ctx, "route53-query-logging-policy", &cloudwatch.LogResourcePolicyArgs{
* PolicyDocument: pulumi.String(route53_query_logging_policy.Json),
* PolicyName: pulumi.String("route53-query-logging-policy"),
* })
* if err != nil {
* return err
* }
* _, err = route53.NewQueryLog(ctx, "example_com", &route53.QueryLogArgs{
* CloudwatchLogGroupArn: awsRoute53ExampleCom.Arn,
* ZoneId: exampleCom.ZoneId,
* }, pulumi.DependsOn([]pulumi.Resource{
* route53_query_logging_policyLogResourcePolicy,
* }))
* 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.route53.Zone;
* import com.pulumi.aws.route53.ZoneArgs;
* 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.route53.QueryLog;
* import com.pulumi.aws.route53.QueryLogArgs;
* import com.pulumi.resources.CustomResourceOptions;
* 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) {
* // Example Route53 zone with query logging
* var exampleCom = new Zone("exampleCom", ZoneArgs.builder()
* .name("example.com")
* .build());
* var awsRoute53ExampleCom = new LogGroup("awsRoute53ExampleCom", LogGroupArgs.builder()
* .name(exampleCom.name().applyValue(name -> String.format("/aws/route53/%s", name)))
* .retentionInDays(30)
* .build());
* // Example CloudWatch log resource policy to allow Route53 to write logs
* // to any log group under /aws/route53/*
* final var route53-query-logging-policy = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
* .statements(GetPolicyDocumentStatementArgs.builder()
* .actions(
* "logs:CreateLogStream",
* "logs:PutLogEvents")
* .resources("arn:aws:logs:*:*:log-group:/aws/route53/*")
* .principals(GetPolicyDocumentStatementPrincipalArgs.builder()
* .identifiers("route53.amazonaws.com")
* .type("Service")
* .build())
* .build())
* .build());
* var route53_query_logging_policyLogResourcePolicy = new LogResourcePolicy("route53-query-logging-policyLogResourcePolicy", LogResourcePolicyArgs.builder()
* .policyDocument(route53_query_logging_policy.json())
* .policyName("route53-query-logging-policy")
* .build());
* var exampleComQueryLog = new QueryLog("exampleComQueryLog", QueryLogArgs.builder()
* .cloudwatchLogGroupArn(awsRoute53ExampleCom.arn())
* .zoneId(exampleCom.zoneId())
* .build(), CustomResourceOptions.builder()
* .dependsOn(route53_query_logging_policyLogResourcePolicy)
* .build());
* }
* }
* ```
* ```yaml
* resources:
* awsRoute53ExampleCom:
* type: aws:cloudwatch:LogGroup
* name: aws_route53_example_com
* properties:
* name: /aws/route53/${exampleCom.name}
* retentionInDays: 30
* route53-query-logging-policyLogResourcePolicy:
* type: aws:cloudwatch:LogResourcePolicy
* name: route53-query-logging-policy
* properties:
* policyDocument: ${["route53-query-logging-policy"].json}
* policyName: route53-query-logging-policy
* # Example Route53 zone with query logging
* exampleCom:
* type: aws:route53:Zone
* name: example_com
* properties:
* name: example.com
* exampleComQueryLog:
* type: aws:route53:QueryLog
* name: example_com
* properties:
* cloudwatchLogGroupArn: ${awsRoute53ExampleCom.arn}
* zoneId: ${exampleCom.zoneId}
* options:
* dependson:
* - ${["route53-query-logging-policyLogResourcePolicy"]}
* variables:
* # Example CloudWatch log resource policy to allow Route53 to write logs
* # to any log group under /aws/route53/*
* route53-query-logging-policy:
* fn::invoke:
* Function: aws:iam:getPolicyDocument
* Arguments:
* statements:
* - actions:
* - logs:CreateLogStream
* - logs:PutLogEvents
* resources:
* - arn:aws:logs:*:*:log-group:/aws/route53/*
* principals:
* - identifiers:
* - route53.amazonaws.com
* type: Service
* ```
*
* ## Import
* Using `pulumi import`, import Route53 query logging configurations using their ID. For example:
* ```sh
* $ pulumi import aws:route53/queryLog:QueryLog example_com xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
* ```
* */*/*/*/*/*/*/*/*/*/*/*/
*/
public class QueryLog internal constructor(
override val javaResource: com.pulumi.aws.route53.QueryLog,
) : KotlinCustomResource(javaResource, QueryLogMapper) {
/**
* The Amazon Resource Name (ARN) of the Query Logging Config.
*/
public val arn: Output
get() = javaResource.arn().applyValue({ args0 -> args0 })
/**
* CloudWatch log group ARN to send query logs.
*/
public val cloudwatchLogGroupArn: Output
get() = javaResource.cloudwatchLogGroupArn().applyValue({ args0 -> args0 })
/**
* Route53 hosted zone ID to enable query logs.
*/
public val zoneId: Output
get() = javaResource.zoneId().applyValue({ args0 -> args0 })
}
public object QueryLogMapper : ResourceMapper {
override fun supportsMappingOfType(javaResource: Resource): Boolean =
com.pulumi.aws.route53.QueryLog::class == javaResource::class
override fun map(javaResource: Resource): QueryLog = QueryLog(
javaResource as
com.pulumi.aws.route53.QueryLog,
)
}
/**
* @see [QueryLog].
* @param name The _unique_ name of the resulting resource.
* @param block Builder for [QueryLog].
*/
public suspend fun queryLog(name: String, block: suspend QueryLogResourceBuilder.() -> Unit): QueryLog {
val builder = QueryLogResourceBuilder()
builder.name(name)
block(builder)
return builder.build()
}
/**
* @see [QueryLog].
* @param name The _unique_ name of the resulting resource.
*/
public fun queryLog(name: String): QueryLog {
val builder = QueryLogResourceBuilder()
builder.name(name)
return builder.build()
}
