logging

package
v5.26.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 1, 2021 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type BillingAccountBucketConfig

type BillingAccountBucketConfig struct {
	pulumi.CustomResourceState

	// The parent resource that contains the logging bucket.
	BillingAccount pulumi.StringOutput `pulumi:"billingAccount"`
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringOutput `pulumi:"bucketId"`
	// Describes this bucket.
	Description pulumi.StringOutput `pulumi:"description"`
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringOutput `pulumi:"lifecycleState"`
	// The location of the bucket.
	Location pulumi.StringOutput `pulumi:"location"`
	// The resource name of the bucket. For example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringOutput `pulumi:"name"`
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrOutput `pulumi:"retentionDays"`
}

Manages a billing account level logging bucket config. For more information see [the official logging documentation](https://cloud.google.com/logging/docs/) and [Storing Logs](https://cloud.google.com/logging/docs/storage).

> **Note:** Logging buckets are automatically created for a given folder, project, organization, billingAccount and cannot be deleted. Creating a resource of this type will acquire and update the resource that already exists at the desired location. These buckets cannot be removed so deleting this resource will remove the bucket config from your state but will leave the logging bucket unchanged. The buckets that are currently automatically created are "_Default" and "_Required".

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/organizations"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		opt0 := "00AA00-000AAA-00AA0A"
		_default, err := organizations.GetBillingAccount(ctx, &organizations.GetBillingAccountArgs{
			BillingAccount: &opt0,
		}, nil)
		if err != nil {
			return err
		}
		_, err = logging.NewBillingAccountBucketConfig(ctx, "basic", &logging.BillingAccountBucketConfigArgs{
			BillingAccount: pulumi.String(_default.BillingAccount),
			Location:       pulumi.String("global"),
			RetentionDays:  pulumi.Int(30),
			BucketId:       pulumi.String("_Default"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

This resource can be imported using the following format

```sh

$ pulumi import gcp:logging/billingAccountBucketConfig:BillingAccountBucketConfig default billingAccounts/{{billingAccount}}/locations/{{location}}/buckets/{{bucket_id}}

```

func GetBillingAccountBucketConfig

func GetBillingAccountBucketConfig(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *BillingAccountBucketConfigState, opts ...pulumi.ResourceOption) (*BillingAccountBucketConfig, error)

GetBillingAccountBucketConfig gets an existing BillingAccountBucketConfig resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewBillingAccountBucketConfig

func NewBillingAccountBucketConfig(ctx *pulumi.Context,
	name string, args *BillingAccountBucketConfigArgs, opts ...pulumi.ResourceOption) (*BillingAccountBucketConfig, error)

NewBillingAccountBucketConfig registers a new resource with the given unique name, arguments, and options.

func (*BillingAccountBucketConfig) ElementType

func (*BillingAccountBucketConfig) ElementType() reflect.Type

func (*BillingAccountBucketConfig) ToBillingAccountBucketConfigOutput

func (i *BillingAccountBucketConfig) ToBillingAccountBucketConfigOutput() BillingAccountBucketConfigOutput

func (*BillingAccountBucketConfig) ToBillingAccountBucketConfigOutputWithContext

func (i *BillingAccountBucketConfig) ToBillingAccountBucketConfigOutputWithContext(ctx context.Context) BillingAccountBucketConfigOutput

func (*BillingAccountBucketConfig) ToBillingAccountBucketConfigPtrOutput

func (i *BillingAccountBucketConfig) ToBillingAccountBucketConfigPtrOutput() BillingAccountBucketConfigPtrOutput

func (*BillingAccountBucketConfig) ToBillingAccountBucketConfigPtrOutputWithContext

func (i *BillingAccountBucketConfig) ToBillingAccountBucketConfigPtrOutputWithContext(ctx context.Context) BillingAccountBucketConfigPtrOutput

type BillingAccountBucketConfigArgs

type BillingAccountBucketConfigArgs struct {
	// The parent resource that contains the logging bucket.
	BillingAccount pulumi.StringInput
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The location of the bucket.
	Location pulumi.StringInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrInput
}

The set of arguments for constructing a BillingAccountBucketConfig resource.

func (BillingAccountBucketConfigArgs) ElementType

type BillingAccountBucketConfigArray

type BillingAccountBucketConfigArray []BillingAccountBucketConfigInput

func (BillingAccountBucketConfigArray) ElementType

func (BillingAccountBucketConfigArray) ToBillingAccountBucketConfigArrayOutput

func (i BillingAccountBucketConfigArray) ToBillingAccountBucketConfigArrayOutput() BillingAccountBucketConfigArrayOutput

func (BillingAccountBucketConfigArray) ToBillingAccountBucketConfigArrayOutputWithContext

func (i BillingAccountBucketConfigArray) ToBillingAccountBucketConfigArrayOutputWithContext(ctx context.Context) BillingAccountBucketConfigArrayOutput

type BillingAccountBucketConfigArrayInput

type BillingAccountBucketConfigArrayInput interface {
	pulumi.Input

	ToBillingAccountBucketConfigArrayOutput() BillingAccountBucketConfigArrayOutput
	ToBillingAccountBucketConfigArrayOutputWithContext(context.Context) BillingAccountBucketConfigArrayOutput
}

BillingAccountBucketConfigArrayInput is an input type that accepts BillingAccountBucketConfigArray and BillingAccountBucketConfigArrayOutput values. You can construct a concrete instance of `BillingAccountBucketConfigArrayInput` via:

BillingAccountBucketConfigArray{ BillingAccountBucketConfigArgs{...} }

type BillingAccountBucketConfigArrayOutput

type BillingAccountBucketConfigArrayOutput struct{ *pulumi.OutputState }

func (BillingAccountBucketConfigArrayOutput) ElementType

func (BillingAccountBucketConfigArrayOutput) Index

func (BillingAccountBucketConfigArrayOutput) ToBillingAccountBucketConfigArrayOutput

func (o BillingAccountBucketConfigArrayOutput) ToBillingAccountBucketConfigArrayOutput() BillingAccountBucketConfigArrayOutput

func (BillingAccountBucketConfigArrayOutput) ToBillingAccountBucketConfigArrayOutputWithContext

func (o BillingAccountBucketConfigArrayOutput) ToBillingAccountBucketConfigArrayOutputWithContext(ctx context.Context) BillingAccountBucketConfigArrayOutput

type BillingAccountBucketConfigInput

type BillingAccountBucketConfigInput interface {
	pulumi.Input

	ToBillingAccountBucketConfigOutput() BillingAccountBucketConfigOutput
	ToBillingAccountBucketConfigOutputWithContext(ctx context.Context) BillingAccountBucketConfigOutput
}

type BillingAccountBucketConfigMap

type BillingAccountBucketConfigMap map[string]BillingAccountBucketConfigInput

func (BillingAccountBucketConfigMap) ElementType

func (BillingAccountBucketConfigMap) ToBillingAccountBucketConfigMapOutput

func (i BillingAccountBucketConfigMap) ToBillingAccountBucketConfigMapOutput() BillingAccountBucketConfigMapOutput

func (BillingAccountBucketConfigMap) ToBillingAccountBucketConfigMapOutputWithContext

func (i BillingAccountBucketConfigMap) ToBillingAccountBucketConfigMapOutputWithContext(ctx context.Context) BillingAccountBucketConfigMapOutput

type BillingAccountBucketConfigMapInput

type BillingAccountBucketConfigMapInput interface {
	pulumi.Input

	ToBillingAccountBucketConfigMapOutput() BillingAccountBucketConfigMapOutput
	ToBillingAccountBucketConfigMapOutputWithContext(context.Context) BillingAccountBucketConfigMapOutput
}

BillingAccountBucketConfigMapInput is an input type that accepts BillingAccountBucketConfigMap and BillingAccountBucketConfigMapOutput values. You can construct a concrete instance of `BillingAccountBucketConfigMapInput` via:

BillingAccountBucketConfigMap{ "key": BillingAccountBucketConfigArgs{...} }

type BillingAccountBucketConfigMapOutput

type BillingAccountBucketConfigMapOutput struct{ *pulumi.OutputState }

func (BillingAccountBucketConfigMapOutput) ElementType

func (BillingAccountBucketConfigMapOutput) MapIndex

func (BillingAccountBucketConfigMapOutput) ToBillingAccountBucketConfigMapOutput

func (o BillingAccountBucketConfigMapOutput) ToBillingAccountBucketConfigMapOutput() BillingAccountBucketConfigMapOutput

func (BillingAccountBucketConfigMapOutput) ToBillingAccountBucketConfigMapOutputWithContext

func (o BillingAccountBucketConfigMapOutput) ToBillingAccountBucketConfigMapOutputWithContext(ctx context.Context) BillingAccountBucketConfigMapOutput

type BillingAccountBucketConfigOutput

type BillingAccountBucketConfigOutput struct{ *pulumi.OutputState }

func (BillingAccountBucketConfigOutput) ElementType

func (BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigOutput

func (o BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigOutput() BillingAccountBucketConfigOutput

func (BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigOutputWithContext

func (o BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigOutputWithContext(ctx context.Context) BillingAccountBucketConfigOutput

func (BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigPtrOutput

func (o BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigPtrOutput() BillingAccountBucketConfigPtrOutput

func (BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigPtrOutputWithContext

func (o BillingAccountBucketConfigOutput) ToBillingAccountBucketConfigPtrOutputWithContext(ctx context.Context) BillingAccountBucketConfigPtrOutput

type BillingAccountBucketConfigPtrInput

type BillingAccountBucketConfigPtrInput interface {
	pulumi.Input

	ToBillingAccountBucketConfigPtrOutput() BillingAccountBucketConfigPtrOutput
	ToBillingAccountBucketConfigPtrOutputWithContext(ctx context.Context) BillingAccountBucketConfigPtrOutput
}

type BillingAccountBucketConfigPtrOutput

type BillingAccountBucketConfigPtrOutput struct{ *pulumi.OutputState }

func (BillingAccountBucketConfigPtrOutput) Elem added in v5.21.0

func (BillingAccountBucketConfigPtrOutput) ElementType

func (BillingAccountBucketConfigPtrOutput) ToBillingAccountBucketConfigPtrOutput

func (o BillingAccountBucketConfigPtrOutput) ToBillingAccountBucketConfigPtrOutput() BillingAccountBucketConfigPtrOutput

func (BillingAccountBucketConfigPtrOutput) ToBillingAccountBucketConfigPtrOutputWithContext

func (o BillingAccountBucketConfigPtrOutput) ToBillingAccountBucketConfigPtrOutputWithContext(ctx context.Context) BillingAccountBucketConfigPtrOutput

type BillingAccountBucketConfigState

type BillingAccountBucketConfigState struct {
	// The parent resource that contains the logging bucket.
	BillingAccount pulumi.StringPtrInput
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringPtrInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringPtrInput
	// The location of the bucket.
	Location pulumi.StringPtrInput
	// The resource name of the bucket. For example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringPtrInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrInput
}

func (BillingAccountBucketConfigState) ElementType

type BillingAccountExclusion

type BillingAccountExclusion struct {
	pulumi.CustomResourceState

	// The billing account to create the exclusion for.
	BillingAccount pulumi.StringOutput `pulumi:"billingAccount"`
	// A human-readable description.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringOutput `pulumi:"filter"`
	// The name of the logging exclusion.
	Name pulumi.StringOutput `pulumi:"name"`
}

## Import

Billing account logging exclusions can be imported using their URI, e.g.

```sh

$ pulumi import gcp:logging/billingAccountExclusion:BillingAccountExclusion my_exclusion billingAccounts/my-billing_account/exclusions/my-exclusion

```

func GetBillingAccountExclusion

func GetBillingAccountExclusion(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *BillingAccountExclusionState, opts ...pulumi.ResourceOption) (*BillingAccountExclusion, error)

GetBillingAccountExclusion gets an existing BillingAccountExclusion resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewBillingAccountExclusion

func NewBillingAccountExclusion(ctx *pulumi.Context,
	name string, args *BillingAccountExclusionArgs, opts ...pulumi.ResourceOption) (*BillingAccountExclusion, error)

NewBillingAccountExclusion registers a new resource with the given unique name, arguments, and options.

func (*BillingAccountExclusion) ElementType

func (*BillingAccountExclusion) ElementType() reflect.Type

func (*BillingAccountExclusion) ToBillingAccountExclusionOutput

func (i *BillingAccountExclusion) ToBillingAccountExclusionOutput() BillingAccountExclusionOutput

func (*BillingAccountExclusion) ToBillingAccountExclusionOutputWithContext

func (i *BillingAccountExclusion) ToBillingAccountExclusionOutputWithContext(ctx context.Context) BillingAccountExclusionOutput

func (*BillingAccountExclusion) ToBillingAccountExclusionPtrOutput

func (i *BillingAccountExclusion) ToBillingAccountExclusionPtrOutput() BillingAccountExclusionPtrOutput

func (*BillingAccountExclusion) ToBillingAccountExclusionPtrOutputWithContext

func (i *BillingAccountExclusion) ToBillingAccountExclusionPtrOutputWithContext(ctx context.Context) BillingAccountExclusionPtrOutput

type BillingAccountExclusionArgs

type BillingAccountExclusionArgs struct {
	// The billing account to create the exclusion for.
	BillingAccount pulumi.StringInput
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
}

The set of arguments for constructing a BillingAccountExclusion resource.

func (BillingAccountExclusionArgs) ElementType

type BillingAccountExclusionArray

type BillingAccountExclusionArray []BillingAccountExclusionInput

func (BillingAccountExclusionArray) ElementType

func (BillingAccountExclusionArray) ToBillingAccountExclusionArrayOutput

func (i BillingAccountExclusionArray) ToBillingAccountExclusionArrayOutput() BillingAccountExclusionArrayOutput

func (BillingAccountExclusionArray) ToBillingAccountExclusionArrayOutputWithContext

func (i BillingAccountExclusionArray) ToBillingAccountExclusionArrayOutputWithContext(ctx context.Context) BillingAccountExclusionArrayOutput

type BillingAccountExclusionArrayInput

type BillingAccountExclusionArrayInput interface {
	pulumi.Input

	ToBillingAccountExclusionArrayOutput() BillingAccountExclusionArrayOutput
	ToBillingAccountExclusionArrayOutputWithContext(context.Context) BillingAccountExclusionArrayOutput
}

BillingAccountExclusionArrayInput is an input type that accepts BillingAccountExclusionArray and BillingAccountExclusionArrayOutput values. You can construct a concrete instance of `BillingAccountExclusionArrayInput` via:

BillingAccountExclusionArray{ BillingAccountExclusionArgs{...} }

type BillingAccountExclusionArrayOutput

type BillingAccountExclusionArrayOutput struct{ *pulumi.OutputState }

func (BillingAccountExclusionArrayOutput) ElementType

func (BillingAccountExclusionArrayOutput) Index

func (BillingAccountExclusionArrayOutput) ToBillingAccountExclusionArrayOutput

func (o BillingAccountExclusionArrayOutput) ToBillingAccountExclusionArrayOutput() BillingAccountExclusionArrayOutput

func (BillingAccountExclusionArrayOutput) ToBillingAccountExclusionArrayOutputWithContext

func (o BillingAccountExclusionArrayOutput) ToBillingAccountExclusionArrayOutputWithContext(ctx context.Context) BillingAccountExclusionArrayOutput

type BillingAccountExclusionInput

type BillingAccountExclusionInput interface {
	pulumi.Input

	ToBillingAccountExclusionOutput() BillingAccountExclusionOutput
	ToBillingAccountExclusionOutputWithContext(ctx context.Context) BillingAccountExclusionOutput
}

type BillingAccountExclusionMap

type BillingAccountExclusionMap map[string]BillingAccountExclusionInput

func (BillingAccountExclusionMap) ElementType

func (BillingAccountExclusionMap) ElementType() reflect.Type

func (BillingAccountExclusionMap) ToBillingAccountExclusionMapOutput

func (i BillingAccountExclusionMap) ToBillingAccountExclusionMapOutput() BillingAccountExclusionMapOutput

func (BillingAccountExclusionMap) ToBillingAccountExclusionMapOutputWithContext

func (i BillingAccountExclusionMap) ToBillingAccountExclusionMapOutputWithContext(ctx context.Context) BillingAccountExclusionMapOutput

type BillingAccountExclusionMapInput

type BillingAccountExclusionMapInput interface {
	pulumi.Input

	ToBillingAccountExclusionMapOutput() BillingAccountExclusionMapOutput
	ToBillingAccountExclusionMapOutputWithContext(context.Context) BillingAccountExclusionMapOutput
}

BillingAccountExclusionMapInput is an input type that accepts BillingAccountExclusionMap and BillingAccountExclusionMapOutput values. You can construct a concrete instance of `BillingAccountExclusionMapInput` via:

BillingAccountExclusionMap{ "key": BillingAccountExclusionArgs{...} }

type BillingAccountExclusionMapOutput

type BillingAccountExclusionMapOutput struct{ *pulumi.OutputState }

func (BillingAccountExclusionMapOutput) ElementType

func (BillingAccountExclusionMapOutput) MapIndex

func (BillingAccountExclusionMapOutput) ToBillingAccountExclusionMapOutput

func (o BillingAccountExclusionMapOutput) ToBillingAccountExclusionMapOutput() BillingAccountExclusionMapOutput

func (BillingAccountExclusionMapOutput) ToBillingAccountExclusionMapOutputWithContext

func (o BillingAccountExclusionMapOutput) ToBillingAccountExclusionMapOutputWithContext(ctx context.Context) BillingAccountExclusionMapOutput

type BillingAccountExclusionOutput

type BillingAccountExclusionOutput struct{ *pulumi.OutputState }

func (BillingAccountExclusionOutput) ElementType

func (BillingAccountExclusionOutput) ToBillingAccountExclusionOutput

func (o BillingAccountExclusionOutput) ToBillingAccountExclusionOutput() BillingAccountExclusionOutput

func (BillingAccountExclusionOutput) ToBillingAccountExclusionOutputWithContext

func (o BillingAccountExclusionOutput) ToBillingAccountExclusionOutputWithContext(ctx context.Context) BillingAccountExclusionOutput

func (BillingAccountExclusionOutput) ToBillingAccountExclusionPtrOutput

func (o BillingAccountExclusionOutput) ToBillingAccountExclusionPtrOutput() BillingAccountExclusionPtrOutput

func (BillingAccountExclusionOutput) ToBillingAccountExclusionPtrOutputWithContext

func (o BillingAccountExclusionOutput) ToBillingAccountExclusionPtrOutputWithContext(ctx context.Context) BillingAccountExclusionPtrOutput

type BillingAccountExclusionPtrInput

type BillingAccountExclusionPtrInput interface {
	pulumi.Input

	ToBillingAccountExclusionPtrOutput() BillingAccountExclusionPtrOutput
	ToBillingAccountExclusionPtrOutputWithContext(ctx context.Context) BillingAccountExclusionPtrOutput
}

type BillingAccountExclusionPtrOutput

type BillingAccountExclusionPtrOutput struct{ *pulumi.OutputState }

func (BillingAccountExclusionPtrOutput) Elem added in v5.21.0

func (BillingAccountExclusionPtrOutput) ElementType

func (BillingAccountExclusionPtrOutput) ToBillingAccountExclusionPtrOutput

func (o BillingAccountExclusionPtrOutput) ToBillingAccountExclusionPtrOutput() BillingAccountExclusionPtrOutput

func (BillingAccountExclusionPtrOutput) ToBillingAccountExclusionPtrOutputWithContext

func (o BillingAccountExclusionPtrOutput) ToBillingAccountExclusionPtrOutputWithContext(ctx context.Context) BillingAccountExclusionPtrOutput

type BillingAccountExclusionState

type BillingAccountExclusionState struct {
	// The billing account to create the exclusion for.
	BillingAccount pulumi.StringPtrInput
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
}

func (BillingAccountExclusionState) ElementType

type BillingAccountSink

type BillingAccountSink struct {
	pulumi.CustomResourceState

	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions BillingAccountSinkBigqueryOptionsOutput `pulumi:"bigqueryOptions"`
	// The billing account exported to the sink.
	BillingAccount pulumi.StringOutput `pulumi:"billingAccount"`
	// A description of this exclusion.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringOutput `pulumi:"destination"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions BillingAccountSinkExclusionArrayOutput `pulumi:"exclusions"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrOutput `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringOutput `pulumi:"name"`
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringOutput `pulumi:"writerIdentity"`
}

* [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.sinks) * How-to Guides

> **Note** You must have the "Logs Configuration Writer" IAM role (`roles/logging.configWriter`) [granted on the billing account](https://cloud.google.com/billing/reference/rest/v1/billingAccounts/getIamPolicy) to the credentials used with this provider. [IAM roles granted on a billing account](https://cloud.google.com/billing/docs/how-to/billing-access) are separate from the typical IAM roles granted on a project.

## Example Usage

```go package main

import (

"fmt"

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/projects"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/storage"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := storage.NewBucket(ctx, "log_bucket", nil)
		if err != nil {
			return err
		}
		_, err = logging.NewBillingAccountSink(ctx, "my_sink", &logging.BillingAccountSinkArgs{
			Description:    pulumi.String("some explanation on what this is"),
			BillingAccount: pulumi.String("ABCDEF-012345-GHIJKL"),
			Destination: log_bucket.Name.ApplyT(func(name string) (string, error) {
				return fmt.Sprintf("%v%v", "storage.googleapis.com/", name), nil
			}).(pulumi.StringOutput),
		})
		if err != nil {
			return err
		}
		_, err = projects.NewIAMBinding(ctx, "log_writer", &projects.IAMBindingArgs{
			Role: pulumi.String("roles/storage.objectCreator"),
			Members: pulumi.StringArray{
				my_sink.WriterIdentity,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Billing account logging sinks can be imported using this format

```sh

$ pulumi import gcp:logging/billingAccountSink:BillingAccountSink my_sink billingAccounts/{{billing_account_id}}/sinks/{{sink_id}}

```

func GetBillingAccountSink

func GetBillingAccountSink(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *BillingAccountSinkState, opts ...pulumi.ResourceOption) (*BillingAccountSink, error)

GetBillingAccountSink gets an existing BillingAccountSink resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewBillingAccountSink

func NewBillingAccountSink(ctx *pulumi.Context,
	name string, args *BillingAccountSinkArgs, opts ...pulumi.ResourceOption) (*BillingAccountSink, error)

NewBillingAccountSink registers a new resource with the given unique name, arguments, and options.

func (*BillingAccountSink) ElementType

func (*BillingAccountSink) ElementType() reflect.Type

func (*BillingAccountSink) ToBillingAccountSinkOutput

func (i *BillingAccountSink) ToBillingAccountSinkOutput() BillingAccountSinkOutput

func (*BillingAccountSink) ToBillingAccountSinkOutputWithContext

func (i *BillingAccountSink) ToBillingAccountSinkOutputWithContext(ctx context.Context) BillingAccountSinkOutput

func (*BillingAccountSink) ToBillingAccountSinkPtrOutput

func (i *BillingAccountSink) ToBillingAccountSinkPtrOutput() BillingAccountSinkPtrOutput

func (*BillingAccountSink) ToBillingAccountSinkPtrOutputWithContext

func (i *BillingAccountSink) ToBillingAccountSinkPtrOutputWithContext(ctx context.Context) BillingAccountSinkPtrOutput

type BillingAccountSinkArgs

type BillingAccountSinkArgs struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions BillingAccountSinkBigqueryOptionsPtrInput
	// The billing account exported to the sink.
	BillingAccount pulumi.StringInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions BillingAccountSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
}

The set of arguments for constructing a BillingAccountSink resource.

func (BillingAccountSinkArgs) ElementType

func (BillingAccountSinkArgs) ElementType() reflect.Type

type BillingAccountSinkArray

type BillingAccountSinkArray []BillingAccountSinkInput

func (BillingAccountSinkArray) ElementType

func (BillingAccountSinkArray) ElementType() reflect.Type

func (BillingAccountSinkArray) ToBillingAccountSinkArrayOutput

func (i BillingAccountSinkArray) ToBillingAccountSinkArrayOutput() BillingAccountSinkArrayOutput

func (BillingAccountSinkArray) ToBillingAccountSinkArrayOutputWithContext

func (i BillingAccountSinkArray) ToBillingAccountSinkArrayOutputWithContext(ctx context.Context) BillingAccountSinkArrayOutput

type BillingAccountSinkArrayInput

type BillingAccountSinkArrayInput interface {
	pulumi.Input

	ToBillingAccountSinkArrayOutput() BillingAccountSinkArrayOutput
	ToBillingAccountSinkArrayOutputWithContext(context.Context) BillingAccountSinkArrayOutput
}

BillingAccountSinkArrayInput is an input type that accepts BillingAccountSinkArray and BillingAccountSinkArrayOutput values. You can construct a concrete instance of `BillingAccountSinkArrayInput` via:

BillingAccountSinkArray{ BillingAccountSinkArgs{...} }

type BillingAccountSinkArrayOutput

type BillingAccountSinkArrayOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkArrayOutput) ElementType

func (BillingAccountSinkArrayOutput) Index

func (BillingAccountSinkArrayOutput) ToBillingAccountSinkArrayOutput

func (o BillingAccountSinkArrayOutput) ToBillingAccountSinkArrayOutput() BillingAccountSinkArrayOutput

func (BillingAccountSinkArrayOutput) ToBillingAccountSinkArrayOutputWithContext

func (o BillingAccountSinkArrayOutput) ToBillingAccountSinkArrayOutputWithContext(ctx context.Context) BillingAccountSinkArrayOutput

type BillingAccountSinkBigqueryOptions

type BillingAccountSinkBigqueryOptions struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables bool `pulumi:"usePartitionedTables"`
}

type BillingAccountSinkBigqueryOptionsArgs

type BillingAccountSinkBigqueryOptionsArgs struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables pulumi.BoolInput `pulumi:"usePartitionedTables"`
}

func (BillingAccountSinkBigqueryOptionsArgs) ElementType

func (BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsOutput

func (i BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsOutput() BillingAccountSinkBigqueryOptionsOutput

func (BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsOutputWithContext

func (i BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsOutputWithContext(ctx context.Context) BillingAccountSinkBigqueryOptionsOutput

func (BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsPtrOutput

func (i BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsPtrOutput() BillingAccountSinkBigqueryOptionsPtrOutput

func (BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext

func (i BillingAccountSinkBigqueryOptionsArgs) ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) BillingAccountSinkBigqueryOptionsPtrOutput

type BillingAccountSinkBigqueryOptionsInput

type BillingAccountSinkBigqueryOptionsInput interface {
	pulumi.Input

	ToBillingAccountSinkBigqueryOptionsOutput() BillingAccountSinkBigqueryOptionsOutput
	ToBillingAccountSinkBigqueryOptionsOutputWithContext(context.Context) BillingAccountSinkBigqueryOptionsOutput
}

BillingAccountSinkBigqueryOptionsInput is an input type that accepts BillingAccountSinkBigqueryOptionsArgs and BillingAccountSinkBigqueryOptionsOutput values. You can construct a concrete instance of `BillingAccountSinkBigqueryOptionsInput` via:

BillingAccountSinkBigqueryOptionsArgs{...}

type BillingAccountSinkBigqueryOptionsOutput

type BillingAccountSinkBigqueryOptionsOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkBigqueryOptionsOutput) ElementType

func (BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsOutput

func (o BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsOutput() BillingAccountSinkBigqueryOptionsOutput

func (BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsOutputWithContext

func (o BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsOutputWithContext(ctx context.Context) BillingAccountSinkBigqueryOptionsOutput

func (BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsPtrOutput

func (o BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsPtrOutput() BillingAccountSinkBigqueryOptionsPtrOutput

func (BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext

func (o BillingAccountSinkBigqueryOptionsOutput) ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) BillingAccountSinkBigqueryOptionsPtrOutput

func (BillingAccountSinkBigqueryOptionsOutput) UsePartitionedTables

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type BillingAccountSinkBigqueryOptionsPtrInput

type BillingAccountSinkBigqueryOptionsPtrInput interface {
	pulumi.Input

	ToBillingAccountSinkBigqueryOptionsPtrOutput() BillingAccountSinkBigqueryOptionsPtrOutput
	ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext(context.Context) BillingAccountSinkBigqueryOptionsPtrOutput
}

BillingAccountSinkBigqueryOptionsPtrInput is an input type that accepts BillingAccountSinkBigqueryOptionsArgs, BillingAccountSinkBigqueryOptionsPtr and BillingAccountSinkBigqueryOptionsPtrOutput values. You can construct a concrete instance of `BillingAccountSinkBigqueryOptionsPtrInput` via:

        BillingAccountSinkBigqueryOptionsArgs{...}

or:

        nil

type BillingAccountSinkBigqueryOptionsPtrOutput

type BillingAccountSinkBigqueryOptionsPtrOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkBigqueryOptionsPtrOutput) Elem

func (BillingAccountSinkBigqueryOptionsPtrOutput) ElementType

func (BillingAccountSinkBigqueryOptionsPtrOutput) ToBillingAccountSinkBigqueryOptionsPtrOutput

func (o BillingAccountSinkBigqueryOptionsPtrOutput) ToBillingAccountSinkBigqueryOptionsPtrOutput() BillingAccountSinkBigqueryOptionsPtrOutput

func (BillingAccountSinkBigqueryOptionsPtrOutput) ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext

func (o BillingAccountSinkBigqueryOptionsPtrOutput) ToBillingAccountSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) BillingAccountSinkBigqueryOptionsPtrOutput

func (BillingAccountSinkBigqueryOptionsPtrOutput) UsePartitionedTables

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type BillingAccountSinkExclusion

type BillingAccountSinkExclusion struct {
	// A description of this exclusion.
	Description *string `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled *bool `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter string `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name string `pulumi:"name"`
}

type BillingAccountSinkExclusionArgs

type BillingAccountSinkExclusionArgs struct {
	// A description of this exclusion.
	Description pulumi.StringPtrInput `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringInput `pulumi:"name"`
}

func (BillingAccountSinkExclusionArgs) ElementType

func (BillingAccountSinkExclusionArgs) ToBillingAccountSinkExclusionOutput

func (i BillingAccountSinkExclusionArgs) ToBillingAccountSinkExclusionOutput() BillingAccountSinkExclusionOutput

func (BillingAccountSinkExclusionArgs) ToBillingAccountSinkExclusionOutputWithContext

func (i BillingAccountSinkExclusionArgs) ToBillingAccountSinkExclusionOutputWithContext(ctx context.Context) BillingAccountSinkExclusionOutput

type BillingAccountSinkExclusionArray

type BillingAccountSinkExclusionArray []BillingAccountSinkExclusionInput

func (BillingAccountSinkExclusionArray) ElementType

func (BillingAccountSinkExclusionArray) ToBillingAccountSinkExclusionArrayOutput

func (i BillingAccountSinkExclusionArray) ToBillingAccountSinkExclusionArrayOutput() BillingAccountSinkExclusionArrayOutput

func (BillingAccountSinkExclusionArray) ToBillingAccountSinkExclusionArrayOutputWithContext

func (i BillingAccountSinkExclusionArray) ToBillingAccountSinkExclusionArrayOutputWithContext(ctx context.Context) BillingAccountSinkExclusionArrayOutput

type BillingAccountSinkExclusionArrayInput

type BillingAccountSinkExclusionArrayInput interface {
	pulumi.Input

	ToBillingAccountSinkExclusionArrayOutput() BillingAccountSinkExclusionArrayOutput
	ToBillingAccountSinkExclusionArrayOutputWithContext(context.Context) BillingAccountSinkExclusionArrayOutput
}

BillingAccountSinkExclusionArrayInput is an input type that accepts BillingAccountSinkExclusionArray and BillingAccountSinkExclusionArrayOutput values. You can construct a concrete instance of `BillingAccountSinkExclusionArrayInput` via:

BillingAccountSinkExclusionArray{ BillingAccountSinkExclusionArgs{...} }

type BillingAccountSinkExclusionArrayOutput

type BillingAccountSinkExclusionArrayOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkExclusionArrayOutput) ElementType

func (BillingAccountSinkExclusionArrayOutput) Index

func (BillingAccountSinkExclusionArrayOutput) ToBillingAccountSinkExclusionArrayOutput

func (o BillingAccountSinkExclusionArrayOutput) ToBillingAccountSinkExclusionArrayOutput() BillingAccountSinkExclusionArrayOutput

func (BillingAccountSinkExclusionArrayOutput) ToBillingAccountSinkExclusionArrayOutputWithContext

func (o BillingAccountSinkExclusionArrayOutput) ToBillingAccountSinkExclusionArrayOutputWithContext(ctx context.Context) BillingAccountSinkExclusionArrayOutput

type BillingAccountSinkExclusionInput

type BillingAccountSinkExclusionInput interface {
	pulumi.Input

	ToBillingAccountSinkExclusionOutput() BillingAccountSinkExclusionOutput
	ToBillingAccountSinkExclusionOutputWithContext(context.Context) BillingAccountSinkExclusionOutput
}

BillingAccountSinkExclusionInput is an input type that accepts BillingAccountSinkExclusionArgs and BillingAccountSinkExclusionOutput values. You can construct a concrete instance of `BillingAccountSinkExclusionInput` via:

BillingAccountSinkExclusionArgs{...}

type BillingAccountSinkExclusionOutput

type BillingAccountSinkExclusionOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkExclusionOutput) Description

A description of this exclusion.

func (BillingAccountSinkExclusionOutput) Disabled

If set to True, then this exclusion is disabled and it does not exclude any log entries.

func (BillingAccountSinkExclusionOutput) ElementType

func (BillingAccountSinkExclusionOutput) Filter

An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to write a filter.

func (BillingAccountSinkExclusionOutput) Name

A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.

func (BillingAccountSinkExclusionOutput) ToBillingAccountSinkExclusionOutput

func (o BillingAccountSinkExclusionOutput) ToBillingAccountSinkExclusionOutput() BillingAccountSinkExclusionOutput

func (BillingAccountSinkExclusionOutput) ToBillingAccountSinkExclusionOutputWithContext

func (o BillingAccountSinkExclusionOutput) ToBillingAccountSinkExclusionOutputWithContext(ctx context.Context) BillingAccountSinkExclusionOutput

type BillingAccountSinkInput

type BillingAccountSinkInput interface {
	pulumi.Input

	ToBillingAccountSinkOutput() BillingAccountSinkOutput
	ToBillingAccountSinkOutputWithContext(ctx context.Context) BillingAccountSinkOutput
}

type BillingAccountSinkMap

type BillingAccountSinkMap map[string]BillingAccountSinkInput

func (BillingAccountSinkMap) ElementType

func (BillingAccountSinkMap) ElementType() reflect.Type

func (BillingAccountSinkMap) ToBillingAccountSinkMapOutput

func (i BillingAccountSinkMap) ToBillingAccountSinkMapOutput() BillingAccountSinkMapOutput

func (BillingAccountSinkMap) ToBillingAccountSinkMapOutputWithContext

func (i BillingAccountSinkMap) ToBillingAccountSinkMapOutputWithContext(ctx context.Context) BillingAccountSinkMapOutput

type BillingAccountSinkMapInput

type BillingAccountSinkMapInput interface {
	pulumi.Input

	ToBillingAccountSinkMapOutput() BillingAccountSinkMapOutput
	ToBillingAccountSinkMapOutputWithContext(context.Context) BillingAccountSinkMapOutput
}

BillingAccountSinkMapInput is an input type that accepts BillingAccountSinkMap and BillingAccountSinkMapOutput values. You can construct a concrete instance of `BillingAccountSinkMapInput` via:

BillingAccountSinkMap{ "key": BillingAccountSinkArgs{...} }

type BillingAccountSinkMapOutput

type BillingAccountSinkMapOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkMapOutput) ElementType

func (BillingAccountSinkMapOutput) MapIndex

func (BillingAccountSinkMapOutput) ToBillingAccountSinkMapOutput

func (o BillingAccountSinkMapOutput) ToBillingAccountSinkMapOutput() BillingAccountSinkMapOutput

func (BillingAccountSinkMapOutput) ToBillingAccountSinkMapOutputWithContext

func (o BillingAccountSinkMapOutput) ToBillingAccountSinkMapOutputWithContext(ctx context.Context) BillingAccountSinkMapOutput

type BillingAccountSinkOutput

type BillingAccountSinkOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkOutput) ElementType

func (BillingAccountSinkOutput) ElementType() reflect.Type

func (BillingAccountSinkOutput) ToBillingAccountSinkOutput

func (o BillingAccountSinkOutput) ToBillingAccountSinkOutput() BillingAccountSinkOutput

func (BillingAccountSinkOutput) ToBillingAccountSinkOutputWithContext

func (o BillingAccountSinkOutput) ToBillingAccountSinkOutputWithContext(ctx context.Context) BillingAccountSinkOutput

func (BillingAccountSinkOutput) ToBillingAccountSinkPtrOutput

func (o BillingAccountSinkOutput) ToBillingAccountSinkPtrOutput() BillingAccountSinkPtrOutput

func (BillingAccountSinkOutput) ToBillingAccountSinkPtrOutputWithContext

func (o BillingAccountSinkOutput) ToBillingAccountSinkPtrOutputWithContext(ctx context.Context) BillingAccountSinkPtrOutput

type BillingAccountSinkPtrInput

type BillingAccountSinkPtrInput interface {
	pulumi.Input

	ToBillingAccountSinkPtrOutput() BillingAccountSinkPtrOutput
	ToBillingAccountSinkPtrOutputWithContext(ctx context.Context) BillingAccountSinkPtrOutput
}

type BillingAccountSinkPtrOutput

type BillingAccountSinkPtrOutput struct{ *pulumi.OutputState }

func (BillingAccountSinkPtrOutput) Elem added in v5.21.0

func (BillingAccountSinkPtrOutput) ElementType

func (BillingAccountSinkPtrOutput) ToBillingAccountSinkPtrOutput

func (o BillingAccountSinkPtrOutput) ToBillingAccountSinkPtrOutput() BillingAccountSinkPtrOutput

func (BillingAccountSinkPtrOutput) ToBillingAccountSinkPtrOutputWithContext

func (o BillingAccountSinkPtrOutput) ToBillingAccountSinkPtrOutputWithContext(ctx context.Context) BillingAccountSinkPtrOutput

type BillingAccountSinkState

type BillingAccountSinkState struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions BillingAccountSinkBigqueryOptionsPtrInput
	// The billing account exported to the sink.
	BillingAccount pulumi.StringPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringPtrInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions BillingAccountSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringPtrInput
}

func (BillingAccountSinkState) ElementType

func (BillingAccountSinkState) ElementType() reflect.Type

type FolderBucketConfig

type FolderBucketConfig struct {
	pulumi.CustomResourceState

	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringOutput `pulumi:"bucketId"`
	// Describes this bucket.
	Description pulumi.StringOutput `pulumi:"description"`
	// The parent resource that contains the logging bucket.
	Folder pulumi.StringOutput `pulumi:"folder"`
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringOutput `pulumi:"lifecycleState"`
	// The location of the bucket.
	Location pulumi.StringOutput `pulumi:"location"`
	// The resource name of the bucket. For example: "folders/my-folder-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringOutput `pulumi:"name"`
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrOutput `pulumi:"retentionDays"`
}

Manages a folder-level logging bucket config. For more information see [the official logging documentation](https://cloud.google.com/logging/docs/) and [Storing Logs](https://cloud.google.com/logging/docs/storage).

> **Note:** Logging buckets are automatically created for a given folder, project, organization, billingAccount and cannot be deleted. Creating a resource of this type will acquire and update the resource that already exists at the desired location. These buckets cannot be removed so deleting this resource will remove the bucket config from your state but will leave the logging bucket unchanged. The buckets that are currently automatically created are "_Default" and "_Required".

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/organizations"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := organizations.NewFolder(ctx, "_default", &organizations.FolderArgs{
			DisplayName: pulumi.String("some-folder-name"),
			Parent:      pulumi.String("organizations/123456789"),
		})
		if err != nil {
			return err
		}
		_, err = logging.NewFolderBucketConfig(ctx, "basic", &logging.FolderBucketConfigArgs{
			Folder:        _default.Name,
			Location:      pulumi.String("global"),
			RetentionDays: pulumi.Int(30),
			BucketId:      pulumi.String("_Default"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

This resource can be imported using the following format

```sh

$ pulumi import gcp:logging/folderBucketConfig:FolderBucketConfig default folders/{{folder}}/locations/{{location}}/buckets/{{bucket_id}}

```

func GetFolderBucketConfig

func GetFolderBucketConfig(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *FolderBucketConfigState, opts ...pulumi.ResourceOption) (*FolderBucketConfig, error)

GetFolderBucketConfig gets an existing FolderBucketConfig resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewFolderBucketConfig

func NewFolderBucketConfig(ctx *pulumi.Context,
	name string, args *FolderBucketConfigArgs, opts ...pulumi.ResourceOption) (*FolderBucketConfig, error)

NewFolderBucketConfig registers a new resource with the given unique name, arguments, and options.

func (*FolderBucketConfig) ElementType

func (*FolderBucketConfig) ElementType() reflect.Type

func (*FolderBucketConfig) ToFolderBucketConfigOutput

func (i *FolderBucketConfig) ToFolderBucketConfigOutput() FolderBucketConfigOutput

func (*FolderBucketConfig) ToFolderBucketConfigOutputWithContext

func (i *FolderBucketConfig) ToFolderBucketConfigOutputWithContext(ctx context.Context) FolderBucketConfigOutput

func (*FolderBucketConfig) ToFolderBucketConfigPtrOutput

func (i *FolderBucketConfig) ToFolderBucketConfigPtrOutput() FolderBucketConfigPtrOutput

func (*FolderBucketConfig) ToFolderBucketConfigPtrOutputWithContext

func (i *FolderBucketConfig) ToFolderBucketConfigPtrOutputWithContext(ctx context.Context) FolderBucketConfigPtrOutput

type FolderBucketConfigArgs

type FolderBucketConfigArgs struct {
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The parent resource that contains the logging bucket.
	Folder pulumi.StringInput
	// The location of the bucket.
	Location pulumi.StringInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrInput
}

The set of arguments for constructing a FolderBucketConfig resource.

func (FolderBucketConfigArgs) ElementType

func (FolderBucketConfigArgs) ElementType() reflect.Type

type FolderBucketConfigArray

type FolderBucketConfigArray []FolderBucketConfigInput

func (FolderBucketConfigArray) ElementType

func (FolderBucketConfigArray) ElementType() reflect.Type

func (FolderBucketConfigArray) ToFolderBucketConfigArrayOutput

func (i FolderBucketConfigArray) ToFolderBucketConfigArrayOutput() FolderBucketConfigArrayOutput

func (FolderBucketConfigArray) ToFolderBucketConfigArrayOutputWithContext

func (i FolderBucketConfigArray) ToFolderBucketConfigArrayOutputWithContext(ctx context.Context) FolderBucketConfigArrayOutput

type FolderBucketConfigArrayInput

type FolderBucketConfigArrayInput interface {
	pulumi.Input

	ToFolderBucketConfigArrayOutput() FolderBucketConfigArrayOutput
	ToFolderBucketConfigArrayOutputWithContext(context.Context) FolderBucketConfigArrayOutput
}

FolderBucketConfigArrayInput is an input type that accepts FolderBucketConfigArray and FolderBucketConfigArrayOutput values. You can construct a concrete instance of `FolderBucketConfigArrayInput` via:

FolderBucketConfigArray{ FolderBucketConfigArgs{...} }

type FolderBucketConfigArrayOutput

type FolderBucketConfigArrayOutput struct{ *pulumi.OutputState }

func (FolderBucketConfigArrayOutput) ElementType

func (FolderBucketConfigArrayOutput) Index

func (FolderBucketConfigArrayOutput) ToFolderBucketConfigArrayOutput

func (o FolderBucketConfigArrayOutput) ToFolderBucketConfigArrayOutput() FolderBucketConfigArrayOutput

func (FolderBucketConfigArrayOutput) ToFolderBucketConfigArrayOutputWithContext

func (o FolderBucketConfigArrayOutput) ToFolderBucketConfigArrayOutputWithContext(ctx context.Context) FolderBucketConfigArrayOutput

type FolderBucketConfigInput

type FolderBucketConfigInput interface {
	pulumi.Input

	ToFolderBucketConfigOutput() FolderBucketConfigOutput
	ToFolderBucketConfigOutputWithContext(ctx context.Context) FolderBucketConfigOutput
}

type FolderBucketConfigMap

type FolderBucketConfigMap map[string]FolderBucketConfigInput

func (FolderBucketConfigMap) ElementType

func (FolderBucketConfigMap) ElementType() reflect.Type

func (FolderBucketConfigMap) ToFolderBucketConfigMapOutput

func (i FolderBucketConfigMap) ToFolderBucketConfigMapOutput() FolderBucketConfigMapOutput

func (FolderBucketConfigMap) ToFolderBucketConfigMapOutputWithContext

func (i FolderBucketConfigMap) ToFolderBucketConfigMapOutputWithContext(ctx context.Context) FolderBucketConfigMapOutput

type FolderBucketConfigMapInput

type FolderBucketConfigMapInput interface {
	pulumi.Input

	ToFolderBucketConfigMapOutput() FolderBucketConfigMapOutput
	ToFolderBucketConfigMapOutputWithContext(context.Context) FolderBucketConfigMapOutput
}

FolderBucketConfigMapInput is an input type that accepts FolderBucketConfigMap and FolderBucketConfigMapOutput values. You can construct a concrete instance of `FolderBucketConfigMapInput` via:

FolderBucketConfigMap{ "key": FolderBucketConfigArgs{...} }

type FolderBucketConfigMapOutput

type FolderBucketConfigMapOutput struct{ *pulumi.OutputState }

func (FolderBucketConfigMapOutput) ElementType

func (FolderBucketConfigMapOutput) MapIndex

func (FolderBucketConfigMapOutput) ToFolderBucketConfigMapOutput

func (o FolderBucketConfigMapOutput) ToFolderBucketConfigMapOutput() FolderBucketConfigMapOutput

func (FolderBucketConfigMapOutput) ToFolderBucketConfigMapOutputWithContext

func (o FolderBucketConfigMapOutput) ToFolderBucketConfigMapOutputWithContext(ctx context.Context) FolderBucketConfigMapOutput

type FolderBucketConfigOutput

type FolderBucketConfigOutput struct{ *pulumi.OutputState }

func (FolderBucketConfigOutput) ElementType

func (FolderBucketConfigOutput) ElementType() reflect.Type

func (FolderBucketConfigOutput) ToFolderBucketConfigOutput

func (o FolderBucketConfigOutput) ToFolderBucketConfigOutput() FolderBucketConfigOutput

func (FolderBucketConfigOutput) ToFolderBucketConfigOutputWithContext

func (o FolderBucketConfigOutput) ToFolderBucketConfigOutputWithContext(ctx context.Context) FolderBucketConfigOutput

func (FolderBucketConfigOutput) ToFolderBucketConfigPtrOutput

func (o FolderBucketConfigOutput) ToFolderBucketConfigPtrOutput() FolderBucketConfigPtrOutput

func (FolderBucketConfigOutput) ToFolderBucketConfigPtrOutputWithContext

func (o FolderBucketConfigOutput) ToFolderBucketConfigPtrOutputWithContext(ctx context.Context) FolderBucketConfigPtrOutput

type FolderBucketConfigPtrInput

type FolderBucketConfigPtrInput interface {
	pulumi.Input

	ToFolderBucketConfigPtrOutput() FolderBucketConfigPtrOutput
	ToFolderBucketConfigPtrOutputWithContext(ctx context.Context) FolderBucketConfigPtrOutput
}

type FolderBucketConfigPtrOutput

type FolderBucketConfigPtrOutput struct{ *pulumi.OutputState }

func (FolderBucketConfigPtrOutput) Elem added in v5.21.0

func (FolderBucketConfigPtrOutput) ElementType

func (FolderBucketConfigPtrOutput) ToFolderBucketConfigPtrOutput

func (o FolderBucketConfigPtrOutput) ToFolderBucketConfigPtrOutput() FolderBucketConfigPtrOutput

func (FolderBucketConfigPtrOutput) ToFolderBucketConfigPtrOutputWithContext

func (o FolderBucketConfigPtrOutput) ToFolderBucketConfigPtrOutputWithContext(ctx context.Context) FolderBucketConfigPtrOutput

type FolderBucketConfigState

type FolderBucketConfigState struct {
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringPtrInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The parent resource that contains the logging bucket.
	Folder pulumi.StringPtrInput
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringPtrInput
	// The location of the bucket.
	Location pulumi.StringPtrInput
	// The resource name of the bucket. For example: "folders/my-folder-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringPtrInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrInput
}

func (FolderBucketConfigState) ElementType

func (FolderBucketConfigState) ElementType() reflect.Type

type FolderExclusion

type FolderExclusion struct {
	pulumi.CustomResourceState

	// A human-readable description.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringOutput `pulumi:"filter"`
	// The folder to be exported to the sink. Note that either [FOLDER_ID] or "folders/[FOLDER_ID]" is
	// accepted.
	Folder pulumi.StringOutput `pulumi:"folder"`
	// The name of the logging exclusion.
	Name pulumi.StringOutput `pulumi:"name"`
}

Manages a folder-level logging exclusion. For more information see:

* [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/folders.exclusions) * How-to Guides

> You can specify exclusions for log sinks created by the provider by using the exclusions field of `logging.FolderSink`

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/organizations"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := organizations.NewFolder(ctx, "my_folder", &organizations.FolderArgs{
			DisplayName: pulumi.String("My folder"),
			Parent:      pulumi.String("organizations/123456"),
		})
		if err != nil {
			return err
		}
		_, err = logging.NewFolderExclusion(ctx, "my_exclusion", &logging.FolderExclusionArgs{
			Folder:      my_folder.Name,
			Description: pulumi.String("Exclude GCE instance debug logs"),
			Filter:      pulumi.String("resource.type = gce_instance AND severity <= DEBUG"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Folder-level logging exclusions can be imported using their URI, e.g.

```sh

$ pulumi import gcp:logging/folderExclusion:FolderExclusion my_exclusion folders/my-folder/exclusions/my-exclusion

```

func GetFolderExclusion

func GetFolderExclusion(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *FolderExclusionState, opts ...pulumi.ResourceOption) (*FolderExclusion, error)

GetFolderExclusion gets an existing FolderExclusion resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewFolderExclusion

func NewFolderExclusion(ctx *pulumi.Context,
	name string, args *FolderExclusionArgs, opts ...pulumi.ResourceOption) (*FolderExclusion, error)

NewFolderExclusion registers a new resource with the given unique name, arguments, and options.

func (*FolderExclusion) ElementType

func (*FolderExclusion) ElementType() reflect.Type

func (*FolderExclusion) ToFolderExclusionOutput

func (i *FolderExclusion) ToFolderExclusionOutput() FolderExclusionOutput

func (*FolderExclusion) ToFolderExclusionOutputWithContext

func (i *FolderExclusion) ToFolderExclusionOutputWithContext(ctx context.Context) FolderExclusionOutput

func (*FolderExclusion) ToFolderExclusionPtrOutput

func (i *FolderExclusion) ToFolderExclusionPtrOutput() FolderExclusionPtrOutput

func (*FolderExclusion) ToFolderExclusionPtrOutputWithContext

func (i *FolderExclusion) ToFolderExclusionPtrOutputWithContext(ctx context.Context) FolderExclusionPtrOutput

type FolderExclusionArgs

type FolderExclusionArgs struct {
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput
	// The folder to be exported to the sink. Note that either [FOLDER_ID] or "folders/[FOLDER_ID]" is
	// accepted.
	Folder pulumi.StringInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
}

The set of arguments for constructing a FolderExclusion resource.

func (FolderExclusionArgs) ElementType

func (FolderExclusionArgs) ElementType() reflect.Type

type FolderExclusionArray

type FolderExclusionArray []FolderExclusionInput

func (FolderExclusionArray) ElementType

func (FolderExclusionArray) ElementType() reflect.Type

func (FolderExclusionArray) ToFolderExclusionArrayOutput

func (i FolderExclusionArray) ToFolderExclusionArrayOutput() FolderExclusionArrayOutput

func (FolderExclusionArray) ToFolderExclusionArrayOutputWithContext

func (i FolderExclusionArray) ToFolderExclusionArrayOutputWithContext(ctx context.Context) FolderExclusionArrayOutput

type FolderExclusionArrayInput

type FolderExclusionArrayInput interface {
	pulumi.Input

	ToFolderExclusionArrayOutput() FolderExclusionArrayOutput
	ToFolderExclusionArrayOutputWithContext(context.Context) FolderExclusionArrayOutput
}

FolderExclusionArrayInput is an input type that accepts FolderExclusionArray and FolderExclusionArrayOutput values. You can construct a concrete instance of `FolderExclusionArrayInput` via:

FolderExclusionArray{ FolderExclusionArgs{...} }

type FolderExclusionArrayOutput

type FolderExclusionArrayOutput struct{ *pulumi.OutputState }

func (FolderExclusionArrayOutput) ElementType

func (FolderExclusionArrayOutput) ElementType() reflect.Type

func (FolderExclusionArrayOutput) Index

func (FolderExclusionArrayOutput) ToFolderExclusionArrayOutput

func (o FolderExclusionArrayOutput) ToFolderExclusionArrayOutput() FolderExclusionArrayOutput

func (FolderExclusionArrayOutput) ToFolderExclusionArrayOutputWithContext

func (o FolderExclusionArrayOutput) ToFolderExclusionArrayOutputWithContext(ctx context.Context) FolderExclusionArrayOutput

type FolderExclusionInput

type FolderExclusionInput interface {
	pulumi.Input

	ToFolderExclusionOutput() FolderExclusionOutput
	ToFolderExclusionOutputWithContext(ctx context.Context) FolderExclusionOutput
}

type FolderExclusionMap

type FolderExclusionMap map[string]FolderExclusionInput

func (FolderExclusionMap) ElementType

func (FolderExclusionMap) ElementType() reflect.Type

func (FolderExclusionMap) ToFolderExclusionMapOutput

func (i FolderExclusionMap) ToFolderExclusionMapOutput() FolderExclusionMapOutput

func (FolderExclusionMap) ToFolderExclusionMapOutputWithContext

func (i FolderExclusionMap) ToFolderExclusionMapOutputWithContext(ctx context.Context) FolderExclusionMapOutput

type FolderExclusionMapInput

type FolderExclusionMapInput interface {
	pulumi.Input

	ToFolderExclusionMapOutput() FolderExclusionMapOutput
	ToFolderExclusionMapOutputWithContext(context.Context) FolderExclusionMapOutput
}

FolderExclusionMapInput is an input type that accepts FolderExclusionMap and FolderExclusionMapOutput values. You can construct a concrete instance of `FolderExclusionMapInput` via:

FolderExclusionMap{ "key": FolderExclusionArgs{...} }

type FolderExclusionMapOutput

type FolderExclusionMapOutput struct{ *pulumi.OutputState }

func (FolderExclusionMapOutput) ElementType

func (FolderExclusionMapOutput) ElementType() reflect.Type

func (FolderExclusionMapOutput) MapIndex

func (FolderExclusionMapOutput) ToFolderExclusionMapOutput

func (o FolderExclusionMapOutput) ToFolderExclusionMapOutput() FolderExclusionMapOutput

func (FolderExclusionMapOutput) ToFolderExclusionMapOutputWithContext

func (o FolderExclusionMapOutput) ToFolderExclusionMapOutputWithContext(ctx context.Context) FolderExclusionMapOutput

type FolderExclusionOutput

type FolderExclusionOutput struct{ *pulumi.OutputState }

func (FolderExclusionOutput) ElementType

func (FolderExclusionOutput) ElementType() reflect.Type

func (FolderExclusionOutput) ToFolderExclusionOutput

func (o FolderExclusionOutput) ToFolderExclusionOutput() FolderExclusionOutput

func (FolderExclusionOutput) ToFolderExclusionOutputWithContext

func (o FolderExclusionOutput) ToFolderExclusionOutputWithContext(ctx context.Context) FolderExclusionOutput

func (FolderExclusionOutput) ToFolderExclusionPtrOutput

func (o FolderExclusionOutput) ToFolderExclusionPtrOutput() FolderExclusionPtrOutput

func (FolderExclusionOutput) ToFolderExclusionPtrOutputWithContext

func (o FolderExclusionOutput) ToFolderExclusionPtrOutputWithContext(ctx context.Context) FolderExclusionPtrOutput

type FolderExclusionPtrInput

type FolderExclusionPtrInput interface {
	pulumi.Input

	ToFolderExclusionPtrOutput() FolderExclusionPtrOutput
	ToFolderExclusionPtrOutputWithContext(ctx context.Context) FolderExclusionPtrOutput
}

type FolderExclusionPtrOutput

type FolderExclusionPtrOutput struct{ *pulumi.OutputState }

func (FolderExclusionPtrOutput) Elem added in v5.21.0

func (FolderExclusionPtrOutput) ElementType

func (FolderExclusionPtrOutput) ElementType() reflect.Type

func (FolderExclusionPtrOutput) ToFolderExclusionPtrOutput

func (o FolderExclusionPtrOutput) ToFolderExclusionPtrOutput() FolderExclusionPtrOutput

func (FolderExclusionPtrOutput) ToFolderExclusionPtrOutputWithContext

func (o FolderExclusionPtrOutput) ToFolderExclusionPtrOutputWithContext(ctx context.Context) FolderExclusionPtrOutput

type FolderExclusionState

type FolderExclusionState struct {
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// The folder to be exported to the sink. Note that either [FOLDER_ID] or "folders/[FOLDER_ID]" is
	// accepted.
	Folder pulumi.StringPtrInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
}

func (FolderExclusionState) ElementType

func (FolderExclusionState) ElementType() reflect.Type

type FolderSink

type FolderSink struct {
	pulumi.CustomResourceState

	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions FolderSinkBigqueryOptionsOutput `pulumi:"bigqueryOptions"`
	// A description of this exclusion.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringOutput `pulumi:"destination"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions FolderSinkExclusionArrayOutput `pulumi:"exclusions"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrOutput `pulumi:"filter"`
	// The folder to be exported to the sink. Note that either [FOLDER_ID] or "folders/[FOLDER_ID]" is
	// accepted.
	Folder pulumi.StringOutput `pulumi:"folder"`
	// Whether or not to include children folders in the sink export. If true, logs
	// associated with child projects are also exported; otherwise only logs relating to the provided folder are included.
	IncludeChildren pulumi.BoolPtrOutput `pulumi:"includeChildren"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringOutput `pulumi:"name"`
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringOutput `pulumi:"writerIdentity"`
}

Manages a folder-level logging sink. For more information see: * [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/folders.sinks) * How-to Guides

## Example Usage

```go package main

import (

"fmt"

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/organizations"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/projects"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/storage"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := storage.NewBucket(ctx, "log_bucket", nil)
		if err != nil {
			return err
		}
		_, err = organizations.NewFolder(ctx, "my_folder", &organizations.FolderArgs{
			DisplayName: pulumi.String("My folder"),
			Parent:      pulumi.String("organizations/123456"),
		})
		if err != nil {
			return err
		}
		_, err = logging.NewFolderSink(ctx, "my_sink", &logging.FolderSinkArgs{
			Description: pulumi.String("some explanation on what this is"),
			Folder:      my_folder.Name,
			Destination: log_bucket.Name.ApplyT(func(name string) (string, error) {
				return fmt.Sprintf("%v%v", "storage.googleapis.com/", name), nil
			}).(pulumi.StringOutput),
			Filter: pulumi.String("resource.type = gce_instance AND severity >= WARNING"),
		})
		if err != nil {
			return err
		}
		_, err = projects.NewIAMBinding(ctx, "log_writer", &projects.IAMBindingArgs{
			Role: pulumi.String("roles/storage.objectCreator"),
			Members: pulumi.StringArray{
				my_sink.WriterIdentity,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Folder-level logging sinks can be imported using this format

```sh

$ pulumi import gcp:logging/folderSink:FolderSink my_sink folders/{{folder_id}}/sinks/{{name}}

```

func GetFolderSink

func GetFolderSink(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *FolderSinkState, opts ...pulumi.ResourceOption) (*FolderSink, error)

GetFolderSink gets an existing FolderSink resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewFolderSink

func NewFolderSink(ctx *pulumi.Context,
	name string, args *FolderSinkArgs, opts ...pulumi.ResourceOption) (*FolderSink, error)

NewFolderSink registers a new resource with the given unique name, arguments, and options.

func (*FolderSink) ElementType

func (*FolderSink) ElementType() reflect.Type

func (*FolderSink) ToFolderSinkOutput

func (i *FolderSink) ToFolderSinkOutput() FolderSinkOutput

func (*FolderSink) ToFolderSinkOutputWithContext

func (i *FolderSink) ToFolderSinkOutputWithContext(ctx context.Context) FolderSinkOutput

func (*FolderSink) ToFolderSinkPtrOutput

func (i *FolderSink) ToFolderSinkPtrOutput() FolderSinkPtrOutput

func (*FolderSink) ToFolderSinkPtrOutputWithContext

func (i *FolderSink) ToFolderSinkPtrOutputWithContext(ctx context.Context) FolderSinkPtrOutput

type FolderSinkArgs

type FolderSinkArgs struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions FolderSinkBigqueryOptionsPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions FolderSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// The folder to be exported to the sink. Note that either [FOLDER_ID] or "folders/[FOLDER_ID]" is
	// accepted.
	Folder pulumi.StringInput
	// Whether or not to include children folders in the sink export. If true, logs
	// associated with child projects are also exported; otherwise only logs relating to the provided folder are included.
	IncludeChildren pulumi.BoolPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
}

The set of arguments for constructing a FolderSink resource.

func (FolderSinkArgs) ElementType

func (FolderSinkArgs) ElementType() reflect.Type

type FolderSinkArray

type FolderSinkArray []FolderSinkInput

func (FolderSinkArray) ElementType

func (FolderSinkArray) ElementType() reflect.Type

func (FolderSinkArray) ToFolderSinkArrayOutput

func (i FolderSinkArray) ToFolderSinkArrayOutput() FolderSinkArrayOutput

func (FolderSinkArray) ToFolderSinkArrayOutputWithContext

func (i FolderSinkArray) ToFolderSinkArrayOutputWithContext(ctx context.Context) FolderSinkArrayOutput

type FolderSinkArrayInput

type FolderSinkArrayInput interface {
	pulumi.Input

	ToFolderSinkArrayOutput() FolderSinkArrayOutput
	ToFolderSinkArrayOutputWithContext(context.Context) FolderSinkArrayOutput
}

FolderSinkArrayInput is an input type that accepts FolderSinkArray and FolderSinkArrayOutput values. You can construct a concrete instance of `FolderSinkArrayInput` via:

FolderSinkArray{ FolderSinkArgs{...} }

type FolderSinkArrayOutput

type FolderSinkArrayOutput struct{ *pulumi.OutputState }

func (FolderSinkArrayOutput) ElementType

func (FolderSinkArrayOutput) ElementType() reflect.Type

func (FolderSinkArrayOutput) Index

func (FolderSinkArrayOutput) ToFolderSinkArrayOutput

func (o FolderSinkArrayOutput) ToFolderSinkArrayOutput() FolderSinkArrayOutput

func (FolderSinkArrayOutput) ToFolderSinkArrayOutputWithContext

func (o FolderSinkArrayOutput) ToFolderSinkArrayOutputWithContext(ctx context.Context) FolderSinkArrayOutput

type FolderSinkBigqueryOptions

type FolderSinkBigqueryOptions struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables bool `pulumi:"usePartitionedTables"`
}

type FolderSinkBigqueryOptionsArgs

type FolderSinkBigqueryOptionsArgs struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables pulumi.BoolInput `pulumi:"usePartitionedTables"`
}

func (FolderSinkBigqueryOptionsArgs) ElementType

func (FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsOutput

func (i FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsOutput() FolderSinkBigqueryOptionsOutput

func (FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsOutputWithContext

func (i FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsOutputWithContext(ctx context.Context) FolderSinkBigqueryOptionsOutput

func (FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsPtrOutput

func (i FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsPtrOutput() FolderSinkBigqueryOptionsPtrOutput

func (FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsPtrOutputWithContext

func (i FolderSinkBigqueryOptionsArgs) ToFolderSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) FolderSinkBigqueryOptionsPtrOutput

type FolderSinkBigqueryOptionsInput

type FolderSinkBigqueryOptionsInput interface {
	pulumi.Input

	ToFolderSinkBigqueryOptionsOutput() FolderSinkBigqueryOptionsOutput
	ToFolderSinkBigqueryOptionsOutputWithContext(context.Context) FolderSinkBigqueryOptionsOutput
}

FolderSinkBigqueryOptionsInput is an input type that accepts FolderSinkBigqueryOptionsArgs and FolderSinkBigqueryOptionsOutput values. You can construct a concrete instance of `FolderSinkBigqueryOptionsInput` via:

FolderSinkBigqueryOptionsArgs{...}

type FolderSinkBigqueryOptionsOutput

type FolderSinkBigqueryOptionsOutput struct{ *pulumi.OutputState }

func (FolderSinkBigqueryOptionsOutput) ElementType

func (FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsOutput

func (o FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsOutput() FolderSinkBigqueryOptionsOutput

func (FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsOutputWithContext

func (o FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsOutputWithContext(ctx context.Context) FolderSinkBigqueryOptionsOutput

func (FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsPtrOutput

func (o FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsPtrOutput() FolderSinkBigqueryOptionsPtrOutput

func (FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsPtrOutputWithContext

func (o FolderSinkBigqueryOptionsOutput) ToFolderSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) FolderSinkBigqueryOptionsPtrOutput

func (FolderSinkBigqueryOptionsOutput) UsePartitionedTables

func (o FolderSinkBigqueryOptionsOutput) UsePartitionedTables() pulumi.BoolOutput

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type FolderSinkBigqueryOptionsPtrInput

type FolderSinkBigqueryOptionsPtrInput interface {
	pulumi.Input

	ToFolderSinkBigqueryOptionsPtrOutput() FolderSinkBigqueryOptionsPtrOutput
	ToFolderSinkBigqueryOptionsPtrOutputWithContext(context.Context) FolderSinkBigqueryOptionsPtrOutput
}

FolderSinkBigqueryOptionsPtrInput is an input type that accepts FolderSinkBigqueryOptionsArgs, FolderSinkBigqueryOptionsPtr and FolderSinkBigqueryOptionsPtrOutput values. You can construct a concrete instance of `FolderSinkBigqueryOptionsPtrInput` via:

        FolderSinkBigqueryOptionsArgs{...}

or:

        nil

type FolderSinkBigqueryOptionsPtrOutput

type FolderSinkBigqueryOptionsPtrOutput struct{ *pulumi.OutputState }

func (FolderSinkBigqueryOptionsPtrOutput) Elem

func (FolderSinkBigqueryOptionsPtrOutput) ElementType

func (FolderSinkBigqueryOptionsPtrOutput) ToFolderSinkBigqueryOptionsPtrOutput

func (o FolderSinkBigqueryOptionsPtrOutput) ToFolderSinkBigqueryOptionsPtrOutput() FolderSinkBigqueryOptionsPtrOutput

func (FolderSinkBigqueryOptionsPtrOutput) ToFolderSinkBigqueryOptionsPtrOutputWithContext

func (o FolderSinkBigqueryOptionsPtrOutput) ToFolderSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) FolderSinkBigqueryOptionsPtrOutput

func (FolderSinkBigqueryOptionsPtrOutput) UsePartitionedTables

func (o FolderSinkBigqueryOptionsPtrOutput) UsePartitionedTables() pulumi.BoolPtrOutput

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type FolderSinkExclusion

type FolderSinkExclusion struct {
	// A description of this exclusion.
	Description *string `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled *bool `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter string `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name string `pulumi:"name"`
}

type FolderSinkExclusionArgs

type FolderSinkExclusionArgs struct {
	// A description of this exclusion.
	Description pulumi.StringPtrInput `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringInput `pulumi:"name"`
}

func (FolderSinkExclusionArgs) ElementType

func (FolderSinkExclusionArgs) ElementType() reflect.Type

func (FolderSinkExclusionArgs) ToFolderSinkExclusionOutput

func (i FolderSinkExclusionArgs) ToFolderSinkExclusionOutput() FolderSinkExclusionOutput

func (FolderSinkExclusionArgs) ToFolderSinkExclusionOutputWithContext

func (i FolderSinkExclusionArgs) ToFolderSinkExclusionOutputWithContext(ctx context.Context) FolderSinkExclusionOutput

type FolderSinkExclusionArray

type FolderSinkExclusionArray []FolderSinkExclusionInput

func (FolderSinkExclusionArray) ElementType

func (FolderSinkExclusionArray) ElementType() reflect.Type

func (FolderSinkExclusionArray) ToFolderSinkExclusionArrayOutput

func (i FolderSinkExclusionArray) ToFolderSinkExclusionArrayOutput() FolderSinkExclusionArrayOutput

func (FolderSinkExclusionArray) ToFolderSinkExclusionArrayOutputWithContext

func (i FolderSinkExclusionArray) ToFolderSinkExclusionArrayOutputWithContext(ctx context.Context) FolderSinkExclusionArrayOutput

type FolderSinkExclusionArrayInput

type FolderSinkExclusionArrayInput interface {
	pulumi.Input

	ToFolderSinkExclusionArrayOutput() FolderSinkExclusionArrayOutput
	ToFolderSinkExclusionArrayOutputWithContext(context.Context) FolderSinkExclusionArrayOutput
}

FolderSinkExclusionArrayInput is an input type that accepts FolderSinkExclusionArray and FolderSinkExclusionArrayOutput values. You can construct a concrete instance of `FolderSinkExclusionArrayInput` via:

FolderSinkExclusionArray{ FolderSinkExclusionArgs{...} }

type FolderSinkExclusionArrayOutput

type FolderSinkExclusionArrayOutput struct{ *pulumi.OutputState }

func (FolderSinkExclusionArrayOutput) ElementType

func (FolderSinkExclusionArrayOutput) Index

func (FolderSinkExclusionArrayOutput) ToFolderSinkExclusionArrayOutput

func (o FolderSinkExclusionArrayOutput) ToFolderSinkExclusionArrayOutput() FolderSinkExclusionArrayOutput

func (FolderSinkExclusionArrayOutput) ToFolderSinkExclusionArrayOutputWithContext

func (o FolderSinkExclusionArrayOutput) ToFolderSinkExclusionArrayOutputWithContext(ctx context.Context) FolderSinkExclusionArrayOutput

type FolderSinkExclusionInput

type FolderSinkExclusionInput interface {
	pulumi.Input

	ToFolderSinkExclusionOutput() FolderSinkExclusionOutput
	ToFolderSinkExclusionOutputWithContext(context.Context) FolderSinkExclusionOutput
}

FolderSinkExclusionInput is an input type that accepts FolderSinkExclusionArgs and FolderSinkExclusionOutput values. You can construct a concrete instance of `FolderSinkExclusionInput` via:

FolderSinkExclusionArgs{...}

type FolderSinkExclusionOutput

type FolderSinkExclusionOutput struct{ *pulumi.OutputState }

func (FolderSinkExclusionOutput) Description

A description of this exclusion.

func (FolderSinkExclusionOutput) Disabled

If set to True, then this exclusion is disabled and it does not exclude any log entries.

func (FolderSinkExclusionOutput) ElementType

func (FolderSinkExclusionOutput) ElementType() reflect.Type

func (FolderSinkExclusionOutput) Filter

An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to write a filter.

func (FolderSinkExclusionOutput) Name

A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.

func (FolderSinkExclusionOutput) ToFolderSinkExclusionOutput

func (o FolderSinkExclusionOutput) ToFolderSinkExclusionOutput() FolderSinkExclusionOutput

func (FolderSinkExclusionOutput) ToFolderSinkExclusionOutputWithContext

func (o FolderSinkExclusionOutput) ToFolderSinkExclusionOutputWithContext(ctx context.Context) FolderSinkExclusionOutput

type FolderSinkInput

type FolderSinkInput interface {
	pulumi.Input

	ToFolderSinkOutput() FolderSinkOutput
	ToFolderSinkOutputWithContext(ctx context.Context) FolderSinkOutput
}

type FolderSinkMap

type FolderSinkMap map[string]FolderSinkInput

func (FolderSinkMap) ElementType

func (FolderSinkMap) ElementType() reflect.Type

func (FolderSinkMap) ToFolderSinkMapOutput

func (i FolderSinkMap) ToFolderSinkMapOutput() FolderSinkMapOutput

func (FolderSinkMap) ToFolderSinkMapOutputWithContext

func (i FolderSinkMap) ToFolderSinkMapOutputWithContext(ctx context.Context) FolderSinkMapOutput

type FolderSinkMapInput

type FolderSinkMapInput interface {
	pulumi.Input

	ToFolderSinkMapOutput() FolderSinkMapOutput
	ToFolderSinkMapOutputWithContext(context.Context) FolderSinkMapOutput
}

FolderSinkMapInput is an input type that accepts FolderSinkMap and FolderSinkMapOutput values. You can construct a concrete instance of `FolderSinkMapInput` via:

FolderSinkMap{ "key": FolderSinkArgs{...} }

type FolderSinkMapOutput

type FolderSinkMapOutput struct{ *pulumi.OutputState }

func (FolderSinkMapOutput) ElementType

func (FolderSinkMapOutput) ElementType() reflect.Type

func (FolderSinkMapOutput) MapIndex

func (FolderSinkMapOutput) ToFolderSinkMapOutput

func (o FolderSinkMapOutput) ToFolderSinkMapOutput() FolderSinkMapOutput

func (FolderSinkMapOutput) ToFolderSinkMapOutputWithContext

func (o FolderSinkMapOutput) ToFolderSinkMapOutputWithContext(ctx context.Context) FolderSinkMapOutput

type FolderSinkOutput

type FolderSinkOutput struct{ *pulumi.OutputState }

func (FolderSinkOutput) ElementType

func (FolderSinkOutput) ElementType() reflect.Type

func (FolderSinkOutput) ToFolderSinkOutput

func (o FolderSinkOutput) ToFolderSinkOutput() FolderSinkOutput

func (FolderSinkOutput) ToFolderSinkOutputWithContext

func (o FolderSinkOutput) ToFolderSinkOutputWithContext(ctx context.Context) FolderSinkOutput

func (FolderSinkOutput) ToFolderSinkPtrOutput

func (o FolderSinkOutput) ToFolderSinkPtrOutput() FolderSinkPtrOutput

func (FolderSinkOutput) ToFolderSinkPtrOutputWithContext

func (o FolderSinkOutput) ToFolderSinkPtrOutputWithContext(ctx context.Context) FolderSinkPtrOutput

type FolderSinkPtrInput

type FolderSinkPtrInput interface {
	pulumi.Input

	ToFolderSinkPtrOutput() FolderSinkPtrOutput
	ToFolderSinkPtrOutputWithContext(ctx context.Context) FolderSinkPtrOutput
}

type FolderSinkPtrOutput

type FolderSinkPtrOutput struct{ *pulumi.OutputState }

func (FolderSinkPtrOutput) Elem added in v5.21.0

func (FolderSinkPtrOutput) ElementType

func (FolderSinkPtrOutput) ElementType() reflect.Type

func (FolderSinkPtrOutput) ToFolderSinkPtrOutput

func (o FolderSinkPtrOutput) ToFolderSinkPtrOutput() FolderSinkPtrOutput

func (FolderSinkPtrOutput) ToFolderSinkPtrOutputWithContext

func (o FolderSinkPtrOutput) ToFolderSinkPtrOutputWithContext(ctx context.Context) FolderSinkPtrOutput

type FolderSinkState

type FolderSinkState struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions FolderSinkBigqueryOptionsPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringPtrInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions FolderSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// The folder to be exported to the sink. Note that either [FOLDER_ID] or "folders/[FOLDER_ID]" is
	// accepted.
	Folder pulumi.StringPtrInput
	// Whether or not to include children folders in the sink export. If true, logs
	// associated with child projects are also exported; otherwise only logs relating to the provided folder are included.
	IncludeChildren pulumi.BoolPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringPtrInput
}

func (FolderSinkState) ElementType

func (FolderSinkState) ElementType() reflect.Type

type Metric

type Metric struct {
	pulumi.CustomResourceState

	// The bucketOptions are required when the logs-based metric is using a DISTRIBUTION value type and it
	// describes the bucket boundaries used to create a histogram of the extracted values.
	// Structure is documented below.
	BucketOptions MetricBucketOptionsPtrOutput `pulumi:"bucketOptions"`
	// A description of this metric, which is used in documentation. The maximum length of the
	// description is 8000 characters.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-filters) which
	// is used to match log entries.
	Filter pulumi.StringOutput `pulumi:"filter"`
	// A map from a label key string to an extractor expression which is used to extract data from a log
	// entry field and assign as the label value. Each label key specified in the LabelDescriptor must
	// have an associated extractor expression in this map. The syntax of the extractor expression is
	// the same as for the valueExtractor field.
	LabelExtractors pulumi.StringMapOutput `pulumi:"labelExtractors"`
	// The metric descriptor associated with the logs-based metric.
	// Structure is documented below.
	MetricDescriptor MetricMetricDescriptorOutput `pulumi:"metricDescriptor"`
	// The client-assigned metric identifier. Examples - "errorCount", "nginx/requests".
	// Metric identifiers are limited to 100 characters and can include only the following
	// characters A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash
	// character (/) denotes a hierarchy of name pieces, and it cannot be the first character
	// of the name.
	Name pulumi.StringOutput `pulumi:"name"`
	// The ID of the project in which the resource belongs.
	// If it is not provided, the provider project is used.
	Project pulumi.StringOutput `pulumi:"project"`
	// A valueExtractor is required when using a distribution logs-based metric to extract the values to
	// record from a log entry. Two functions are supported for value extraction - EXTRACT(field) or
	// REGEXP_EXTRACT(field, regex). The argument are 1. field - The name of the log entry field from which
	// the value is to be extracted. 2. regex - A regular expression using the Google RE2 syntax
	// (https://github.com/google/re2/wiki/Syntax) with a single capture group to extract data from the specified
	// log entry field. The value of the field is converted to a string before applying the regex. It is an
	// error to specify a regex that does not include exactly one capture group.
	ValueExtractor pulumi.StringPtrOutput `pulumi:"valueExtractor"`
}

Logs-based metric can also be used to extract values from logs and create a a distribution of the values. The distribution records the statistics of the extracted values along with an optional histogram of the values as specified by the bucket options.

To get more information about Metric, see:

* [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/create) * How-to Guides

## Example Usage ### Logging Metric Basic

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := logging.NewMetric(ctx, "loggingMetric", &logging.MetricArgs{
			BucketOptions: &logging.MetricBucketOptionsArgs{
				LinearBuckets: &logging.MetricBucketOptionsLinearBucketsArgs{
					NumFiniteBuckets: pulumi.Int(3),
					Offset:           pulumi.Float64(1),
					Width:            pulumi.Float64(1),
				},
			},
			Filter: pulumi.String("resource.type=gae_app AND severity>=ERROR"),
			LabelExtractors: pulumi.StringMap{
				"mass": pulumi.String("EXTRACT(jsonPayload.request)"),
				"sku":  pulumi.String("EXTRACT(jsonPayload.id)"),
			},
			MetricDescriptor: &logging.MetricMetricDescriptorArgs{
				DisplayName: pulumi.String("My metric"),
				Labels: logging.MetricMetricDescriptorLabelArray{
					&logging.MetricMetricDescriptorLabelArgs{
						Description: pulumi.String("amount of matter"),
						Key:         pulumi.String("mass"),
						ValueType:   pulumi.String("STRING"),
					},
					&logging.MetricMetricDescriptorLabelArgs{
						Description: pulumi.String("Identifying number for item"),
						Key:         pulumi.String("sku"),
						ValueType:   pulumi.String("INT64"),
					},
				},
				MetricKind: pulumi.String("DELTA"),
				Unit:       pulumi.String("1"),
				ValueType:  pulumi.String("DISTRIBUTION"),
			},
			ValueExtractor: pulumi.String("EXTRACT(jsonPayload.request)"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

``` ### Logging Metric Counter Basic

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := logging.NewMetric(ctx, "loggingMetric", &logging.MetricArgs{
			Filter: pulumi.String("resource.type=gae_app AND severity>=ERROR"),
			MetricDescriptor: &logging.MetricMetricDescriptorArgs{
				MetricKind: pulumi.String("DELTA"),
				ValueType:  pulumi.String("INT64"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

``` ### Logging Metric Counter Labels

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := logging.NewMetric(ctx, "loggingMetric", &logging.MetricArgs{
			Filter: pulumi.String("resource.type=gae_app AND severity>=ERROR"),
			LabelExtractors: pulumi.StringMap{
				"mass": pulumi.String("EXTRACT(jsonPayload.request)"),
			},
			MetricDescriptor: &logging.MetricMetricDescriptorArgs{
				Labels: logging.MetricMetricDescriptorLabelArray{
					&logging.MetricMetricDescriptorLabelArgs{
						Description: pulumi.String("amount of matter"),
						Key:         pulumi.String("mass"),
						ValueType:   pulumi.String("STRING"),
					},
				},
				MetricKind: pulumi.String("DELTA"),
				ValueType:  pulumi.String("INT64"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Metric can be imported using any of these accepted formats

```sh

$ pulumi import gcp:logging/metric:Metric default {{project}} {{name}}

```

```sh

$ pulumi import gcp:logging/metric:Metric default {{name}}

```

func GetMetric

func GetMetric(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *MetricState, opts ...pulumi.ResourceOption) (*Metric, error)

GetMetric gets an existing Metric resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewMetric

func NewMetric(ctx *pulumi.Context,
	name string, args *MetricArgs, opts ...pulumi.ResourceOption) (*Metric, error)

NewMetric registers a new resource with the given unique name, arguments, and options.

func (*Metric) ElementType

func (*Metric) ElementType() reflect.Type

func (*Metric) ToMetricOutput

func (i *Metric) ToMetricOutput() MetricOutput

func (*Metric) ToMetricOutputWithContext

func (i *Metric) ToMetricOutputWithContext(ctx context.Context) MetricOutput

func (*Metric) ToMetricPtrOutput

func (i *Metric) ToMetricPtrOutput() MetricPtrOutput

func (*Metric) ToMetricPtrOutputWithContext

func (i *Metric) ToMetricPtrOutputWithContext(ctx context.Context) MetricPtrOutput

type MetricArgs

type MetricArgs struct {
	// The bucketOptions are required when the logs-based metric is using a DISTRIBUTION value type and it
	// describes the bucket boundaries used to create a histogram of the extracted values.
	// Structure is documented below.
	BucketOptions MetricBucketOptionsPtrInput
	// A description of this metric, which is used in documentation. The maximum length of the
	// description is 8000 characters.
	Description pulumi.StringPtrInput
	// An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-filters) which
	// is used to match log entries.
	Filter pulumi.StringInput
	// A map from a label key string to an extractor expression which is used to extract data from a log
	// entry field and assign as the label value. Each label key specified in the LabelDescriptor must
	// have an associated extractor expression in this map. The syntax of the extractor expression is
	// the same as for the valueExtractor field.
	LabelExtractors pulumi.StringMapInput
	// The metric descriptor associated with the logs-based metric.
	// Structure is documented below.
	MetricDescriptor MetricMetricDescriptorInput
	// The client-assigned metric identifier. Examples - "errorCount", "nginx/requests".
	// Metric identifiers are limited to 100 characters and can include only the following
	// characters A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash
	// character (/) denotes a hierarchy of name pieces, and it cannot be the first character
	// of the name.
	Name pulumi.StringPtrInput
	// The ID of the project in which the resource belongs.
	// If it is not provided, the provider project is used.
	Project pulumi.StringPtrInput
	// A valueExtractor is required when using a distribution logs-based metric to extract the values to
	// record from a log entry. Two functions are supported for value extraction - EXTRACT(field) or
	// REGEXP_EXTRACT(field, regex). The argument are 1. field - The name of the log entry field from which
	// the value is to be extracted. 2. regex - A regular expression using the Google RE2 syntax
	// (https://github.com/google/re2/wiki/Syntax) with a single capture group to extract data from the specified
	// log entry field. The value of the field is converted to a string before applying the regex. It is an
	// error to specify a regex that does not include exactly one capture group.
	ValueExtractor pulumi.StringPtrInput
}

The set of arguments for constructing a Metric resource.

func (MetricArgs) ElementType

func (MetricArgs) ElementType() reflect.Type

type MetricArray

type MetricArray []MetricInput

func (MetricArray) ElementType

func (MetricArray) ElementType() reflect.Type

func (MetricArray) ToMetricArrayOutput

func (i MetricArray) ToMetricArrayOutput() MetricArrayOutput

func (MetricArray) ToMetricArrayOutputWithContext

func (i MetricArray) ToMetricArrayOutputWithContext(ctx context.Context) MetricArrayOutput

type MetricArrayInput

type MetricArrayInput interface {
	pulumi.Input

	ToMetricArrayOutput() MetricArrayOutput
	ToMetricArrayOutputWithContext(context.Context) MetricArrayOutput
}

MetricArrayInput is an input type that accepts MetricArray and MetricArrayOutput values. You can construct a concrete instance of `MetricArrayInput` via:

MetricArray{ MetricArgs{...} }

type MetricArrayOutput

type MetricArrayOutput struct{ *pulumi.OutputState }

func (MetricArrayOutput) ElementType

func (MetricArrayOutput) ElementType() reflect.Type

func (MetricArrayOutput) Index

func (MetricArrayOutput) ToMetricArrayOutput

func (o MetricArrayOutput) ToMetricArrayOutput() MetricArrayOutput

func (MetricArrayOutput) ToMetricArrayOutputWithContext

func (o MetricArrayOutput) ToMetricArrayOutputWithContext(ctx context.Context) MetricArrayOutput

type MetricBucketOptions

type MetricBucketOptions struct {
	// Specifies a set of buckets with arbitrary widths.
	// Structure is documented below.
	ExplicitBuckets *MetricBucketOptionsExplicitBuckets `pulumi:"explicitBuckets"`
	// Specifies an exponential sequence of buckets that have a width that is proportional to the value of
	// the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.
	// Structure is documented below.
	ExponentialBuckets *MetricBucketOptionsExponentialBuckets `pulumi:"exponentialBuckets"`
	// Specifies a linear sequence of buckets that all have the same width (except overflow and underflow).
	// Each bucket represents a constant absolute uncertainty on the specific value in the bucket.
	// Structure is documented below.
	LinearBuckets *MetricBucketOptionsLinearBuckets `pulumi:"linearBuckets"`
}

type MetricBucketOptionsArgs

type MetricBucketOptionsArgs struct {
	// Specifies a set of buckets with arbitrary widths.
	// Structure is documented below.
	ExplicitBuckets MetricBucketOptionsExplicitBucketsPtrInput `pulumi:"explicitBuckets"`
	// Specifies an exponential sequence of buckets that have a width that is proportional to the value of
	// the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket.
	// Structure is documented below.
	ExponentialBuckets MetricBucketOptionsExponentialBucketsPtrInput `pulumi:"exponentialBuckets"`
	// Specifies a linear sequence of buckets that all have the same width (except overflow and underflow).
	// Each bucket represents a constant absolute uncertainty on the specific value in the bucket.
	// Structure is documented below.
	LinearBuckets MetricBucketOptionsLinearBucketsPtrInput `pulumi:"linearBuckets"`
}

func (MetricBucketOptionsArgs) ElementType

func (MetricBucketOptionsArgs) ElementType() reflect.Type

func (MetricBucketOptionsArgs) ToMetricBucketOptionsOutput

func (i MetricBucketOptionsArgs) ToMetricBucketOptionsOutput() MetricBucketOptionsOutput

func (MetricBucketOptionsArgs) ToMetricBucketOptionsOutputWithContext

func (i MetricBucketOptionsArgs) ToMetricBucketOptionsOutputWithContext(ctx context.Context) MetricBucketOptionsOutput

func (MetricBucketOptionsArgs) ToMetricBucketOptionsPtrOutput

func (i MetricBucketOptionsArgs) ToMetricBucketOptionsPtrOutput() MetricBucketOptionsPtrOutput

func (MetricBucketOptionsArgs) ToMetricBucketOptionsPtrOutputWithContext

func (i MetricBucketOptionsArgs) ToMetricBucketOptionsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsPtrOutput

type MetricBucketOptionsExplicitBuckets

type MetricBucketOptionsExplicitBuckets struct {
	// The values must be monotonically increasing.
	Bounds []float64 `pulumi:"bounds"`
}

type MetricBucketOptionsExplicitBucketsArgs

type MetricBucketOptionsExplicitBucketsArgs struct {
	// The values must be monotonically increasing.
	Bounds pulumi.Float64ArrayInput `pulumi:"bounds"`
}

func (MetricBucketOptionsExplicitBucketsArgs) ElementType

func (MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsOutput

func (i MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsOutput() MetricBucketOptionsExplicitBucketsOutput

func (MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsOutputWithContext

func (i MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsOutputWithContext(ctx context.Context) MetricBucketOptionsExplicitBucketsOutput

func (MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsPtrOutput

func (i MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsPtrOutput() MetricBucketOptionsExplicitBucketsPtrOutput

func (MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext

func (i MetricBucketOptionsExplicitBucketsArgs) ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsExplicitBucketsPtrOutput

type MetricBucketOptionsExplicitBucketsInput

type MetricBucketOptionsExplicitBucketsInput interface {
	pulumi.Input

	ToMetricBucketOptionsExplicitBucketsOutput() MetricBucketOptionsExplicitBucketsOutput
	ToMetricBucketOptionsExplicitBucketsOutputWithContext(context.Context) MetricBucketOptionsExplicitBucketsOutput
}

MetricBucketOptionsExplicitBucketsInput is an input type that accepts MetricBucketOptionsExplicitBucketsArgs and MetricBucketOptionsExplicitBucketsOutput values. You can construct a concrete instance of `MetricBucketOptionsExplicitBucketsInput` via:

MetricBucketOptionsExplicitBucketsArgs{...}

type MetricBucketOptionsExplicitBucketsOutput

type MetricBucketOptionsExplicitBucketsOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsExplicitBucketsOutput) Bounds

The values must be monotonically increasing.

func (MetricBucketOptionsExplicitBucketsOutput) ElementType

func (MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsOutput

func (o MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsOutput() MetricBucketOptionsExplicitBucketsOutput

func (MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsOutputWithContext

func (o MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsOutputWithContext(ctx context.Context) MetricBucketOptionsExplicitBucketsOutput

func (MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsPtrOutput

func (o MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsPtrOutput() MetricBucketOptionsExplicitBucketsPtrOutput

func (MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext

func (o MetricBucketOptionsExplicitBucketsOutput) ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsExplicitBucketsPtrOutput

type MetricBucketOptionsExplicitBucketsPtrInput

type MetricBucketOptionsExplicitBucketsPtrInput interface {
	pulumi.Input

	ToMetricBucketOptionsExplicitBucketsPtrOutput() MetricBucketOptionsExplicitBucketsPtrOutput
	ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext(context.Context) MetricBucketOptionsExplicitBucketsPtrOutput
}

MetricBucketOptionsExplicitBucketsPtrInput is an input type that accepts MetricBucketOptionsExplicitBucketsArgs, MetricBucketOptionsExplicitBucketsPtr and MetricBucketOptionsExplicitBucketsPtrOutput values. You can construct a concrete instance of `MetricBucketOptionsExplicitBucketsPtrInput` via:

        MetricBucketOptionsExplicitBucketsArgs{...}

or:

        nil

type MetricBucketOptionsExplicitBucketsPtrOutput

type MetricBucketOptionsExplicitBucketsPtrOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsExplicitBucketsPtrOutput) Bounds

The values must be monotonically increasing.

func (MetricBucketOptionsExplicitBucketsPtrOutput) Elem

func (MetricBucketOptionsExplicitBucketsPtrOutput) ElementType

func (MetricBucketOptionsExplicitBucketsPtrOutput) ToMetricBucketOptionsExplicitBucketsPtrOutput

func (o MetricBucketOptionsExplicitBucketsPtrOutput) ToMetricBucketOptionsExplicitBucketsPtrOutput() MetricBucketOptionsExplicitBucketsPtrOutput

func (MetricBucketOptionsExplicitBucketsPtrOutput) ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext

func (o MetricBucketOptionsExplicitBucketsPtrOutput) ToMetricBucketOptionsExplicitBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsExplicitBucketsPtrOutput

type MetricBucketOptionsExponentialBuckets

type MetricBucketOptionsExponentialBuckets struct {
	// Must be greater than 1.
	GrowthFactor *float64 `pulumi:"growthFactor"`
	// Must be greater than 0.
	NumFiniteBuckets *int `pulumi:"numFiniteBuckets"`
	// Must be greater than 0.
	Scale *float64 `pulumi:"scale"`
}

type MetricBucketOptionsExponentialBucketsArgs

type MetricBucketOptionsExponentialBucketsArgs struct {
	// Must be greater than 1.
	GrowthFactor pulumi.Float64PtrInput `pulumi:"growthFactor"`
	// Must be greater than 0.
	NumFiniteBuckets pulumi.IntPtrInput `pulumi:"numFiniteBuckets"`
	// Must be greater than 0.
	Scale pulumi.Float64PtrInput `pulumi:"scale"`
}

func (MetricBucketOptionsExponentialBucketsArgs) ElementType

func (MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsOutput

func (i MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsOutput() MetricBucketOptionsExponentialBucketsOutput

func (MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsOutputWithContext

func (i MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsOutputWithContext(ctx context.Context) MetricBucketOptionsExponentialBucketsOutput

func (MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsPtrOutput

func (i MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsPtrOutput() MetricBucketOptionsExponentialBucketsPtrOutput

func (MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext

func (i MetricBucketOptionsExponentialBucketsArgs) ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsExponentialBucketsPtrOutput

type MetricBucketOptionsExponentialBucketsInput

type MetricBucketOptionsExponentialBucketsInput interface {
	pulumi.Input

	ToMetricBucketOptionsExponentialBucketsOutput() MetricBucketOptionsExponentialBucketsOutput
	ToMetricBucketOptionsExponentialBucketsOutputWithContext(context.Context) MetricBucketOptionsExponentialBucketsOutput
}

MetricBucketOptionsExponentialBucketsInput is an input type that accepts MetricBucketOptionsExponentialBucketsArgs and MetricBucketOptionsExponentialBucketsOutput values. You can construct a concrete instance of `MetricBucketOptionsExponentialBucketsInput` via:

MetricBucketOptionsExponentialBucketsArgs{...}

type MetricBucketOptionsExponentialBucketsOutput

type MetricBucketOptionsExponentialBucketsOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsExponentialBucketsOutput) ElementType

func (MetricBucketOptionsExponentialBucketsOutput) GrowthFactor

Must be greater than 1.

func (MetricBucketOptionsExponentialBucketsOutput) NumFiniteBuckets

Must be greater than 0.

func (MetricBucketOptionsExponentialBucketsOutput) Scale

Must be greater than 0.

func (MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsOutput

func (o MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsOutput() MetricBucketOptionsExponentialBucketsOutput

func (MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsOutputWithContext

func (o MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsOutputWithContext(ctx context.Context) MetricBucketOptionsExponentialBucketsOutput

func (MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsPtrOutput

func (o MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsPtrOutput() MetricBucketOptionsExponentialBucketsPtrOutput

func (MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext

func (o MetricBucketOptionsExponentialBucketsOutput) ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsExponentialBucketsPtrOutput

type MetricBucketOptionsExponentialBucketsPtrInput

type MetricBucketOptionsExponentialBucketsPtrInput interface {
	pulumi.Input

	ToMetricBucketOptionsExponentialBucketsPtrOutput() MetricBucketOptionsExponentialBucketsPtrOutput
	ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext(context.Context) MetricBucketOptionsExponentialBucketsPtrOutput
}

MetricBucketOptionsExponentialBucketsPtrInput is an input type that accepts MetricBucketOptionsExponentialBucketsArgs, MetricBucketOptionsExponentialBucketsPtr and MetricBucketOptionsExponentialBucketsPtrOutput values. You can construct a concrete instance of `MetricBucketOptionsExponentialBucketsPtrInput` via:

        MetricBucketOptionsExponentialBucketsArgs{...}

or:

        nil

type MetricBucketOptionsExponentialBucketsPtrOutput

type MetricBucketOptionsExponentialBucketsPtrOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsExponentialBucketsPtrOutput) Elem

func (MetricBucketOptionsExponentialBucketsPtrOutput) ElementType

func (MetricBucketOptionsExponentialBucketsPtrOutput) GrowthFactor

Must be greater than 1.

func (MetricBucketOptionsExponentialBucketsPtrOutput) NumFiniteBuckets

Must be greater than 0.

func (MetricBucketOptionsExponentialBucketsPtrOutput) Scale

Must be greater than 0.

func (MetricBucketOptionsExponentialBucketsPtrOutput) ToMetricBucketOptionsExponentialBucketsPtrOutput

func (o MetricBucketOptionsExponentialBucketsPtrOutput) ToMetricBucketOptionsExponentialBucketsPtrOutput() MetricBucketOptionsExponentialBucketsPtrOutput

func (MetricBucketOptionsExponentialBucketsPtrOutput) ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext

func (o MetricBucketOptionsExponentialBucketsPtrOutput) ToMetricBucketOptionsExponentialBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsExponentialBucketsPtrOutput

type MetricBucketOptionsInput

type MetricBucketOptionsInput interface {
	pulumi.Input

	ToMetricBucketOptionsOutput() MetricBucketOptionsOutput
	ToMetricBucketOptionsOutputWithContext(context.Context) MetricBucketOptionsOutput
}

MetricBucketOptionsInput is an input type that accepts MetricBucketOptionsArgs and MetricBucketOptionsOutput values. You can construct a concrete instance of `MetricBucketOptionsInput` via:

MetricBucketOptionsArgs{...}

type MetricBucketOptionsLinearBuckets

type MetricBucketOptionsLinearBuckets struct {
	// Must be greater than 0.
	NumFiniteBuckets *int `pulumi:"numFiniteBuckets"`
	// Lower bound of the first bucket.
	Offset *float64 `pulumi:"offset"`
	// Must be greater than 0.
	Width *float64 `pulumi:"width"`
}

type MetricBucketOptionsLinearBucketsArgs

type MetricBucketOptionsLinearBucketsArgs struct {
	// Must be greater than 0.
	NumFiniteBuckets pulumi.IntPtrInput `pulumi:"numFiniteBuckets"`
	// Lower bound of the first bucket.
	Offset pulumi.Float64PtrInput `pulumi:"offset"`
	// Must be greater than 0.
	Width pulumi.Float64PtrInput `pulumi:"width"`
}

func (MetricBucketOptionsLinearBucketsArgs) ElementType

func (MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsOutput

func (i MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsOutput() MetricBucketOptionsLinearBucketsOutput

func (MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsOutputWithContext

func (i MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsOutputWithContext(ctx context.Context) MetricBucketOptionsLinearBucketsOutput

func (MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsPtrOutput

func (i MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsPtrOutput() MetricBucketOptionsLinearBucketsPtrOutput

func (MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsPtrOutputWithContext

func (i MetricBucketOptionsLinearBucketsArgs) ToMetricBucketOptionsLinearBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsLinearBucketsPtrOutput

type MetricBucketOptionsLinearBucketsInput

type MetricBucketOptionsLinearBucketsInput interface {
	pulumi.Input

	ToMetricBucketOptionsLinearBucketsOutput() MetricBucketOptionsLinearBucketsOutput
	ToMetricBucketOptionsLinearBucketsOutputWithContext(context.Context) MetricBucketOptionsLinearBucketsOutput
}

MetricBucketOptionsLinearBucketsInput is an input type that accepts MetricBucketOptionsLinearBucketsArgs and MetricBucketOptionsLinearBucketsOutput values. You can construct a concrete instance of `MetricBucketOptionsLinearBucketsInput` via:

MetricBucketOptionsLinearBucketsArgs{...}

type MetricBucketOptionsLinearBucketsOutput

type MetricBucketOptionsLinearBucketsOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsLinearBucketsOutput) ElementType

func (MetricBucketOptionsLinearBucketsOutput) NumFiniteBuckets

Must be greater than 0.

func (MetricBucketOptionsLinearBucketsOutput) Offset

Lower bound of the first bucket.

func (MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsOutput

func (o MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsOutput() MetricBucketOptionsLinearBucketsOutput

func (MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsOutputWithContext

func (o MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsOutputWithContext(ctx context.Context) MetricBucketOptionsLinearBucketsOutput

func (MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsPtrOutput

func (o MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsPtrOutput() MetricBucketOptionsLinearBucketsPtrOutput

func (MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsPtrOutputWithContext

func (o MetricBucketOptionsLinearBucketsOutput) ToMetricBucketOptionsLinearBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsLinearBucketsPtrOutput

func (MetricBucketOptionsLinearBucketsOutput) Width

Must be greater than 0.

type MetricBucketOptionsLinearBucketsPtrInput

type MetricBucketOptionsLinearBucketsPtrInput interface {
	pulumi.Input

	ToMetricBucketOptionsLinearBucketsPtrOutput() MetricBucketOptionsLinearBucketsPtrOutput
	ToMetricBucketOptionsLinearBucketsPtrOutputWithContext(context.Context) MetricBucketOptionsLinearBucketsPtrOutput
}

MetricBucketOptionsLinearBucketsPtrInput is an input type that accepts MetricBucketOptionsLinearBucketsArgs, MetricBucketOptionsLinearBucketsPtr and MetricBucketOptionsLinearBucketsPtrOutput values. You can construct a concrete instance of `MetricBucketOptionsLinearBucketsPtrInput` via:

        MetricBucketOptionsLinearBucketsArgs{...}

or:

        nil

type MetricBucketOptionsLinearBucketsPtrOutput

type MetricBucketOptionsLinearBucketsPtrOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsLinearBucketsPtrOutput) Elem

func (MetricBucketOptionsLinearBucketsPtrOutput) ElementType

func (MetricBucketOptionsLinearBucketsPtrOutput) NumFiniteBuckets

Must be greater than 0.

func (MetricBucketOptionsLinearBucketsPtrOutput) Offset

Lower bound of the first bucket.

func (MetricBucketOptionsLinearBucketsPtrOutput) ToMetricBucketOptionsLinearBucketsPtrOutput

func (o MetricBucketOptionsLinearBucketsPtrOutput) ToMetricBucketOptionsLinearBucketsPtrOutput() MetricBucketOptionsLinearBucketsPtrOutput

func (MetricBucketOptionsLinearBucketsPtrOutput) ToMetricBucketOptionsLinearBucketsPtrOutputWithContext

func (o MetricBucketOptionsLinearBucketsPtrOutput) ToMetricBucketOptionsLinearBucketsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsLinearBucketsPtrOutput

func (MetricBucketOptionsLinearBucketsPtrOutput) Width

Must be greater than 0.

type MetricBucketOptionsOutput

type MetricBucketOptionsOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsOutput) ElementType

func (MetricBucketOptionsOutput) ElementType() reflect.Type

func (MetricBucketOptionsOutput) ExplicitBuckets

Specifies a set of buckets with arbitrary widths. Structure is documented below.

func (MetricBucketOptionsOutput) ExponentialBuckets

Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. Structure is documented below.

func (MetricBucketOptionsOutput) LinearBuckets

Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. Structure is documented below.

func (MetricBucketOptionsOutput) ToMetricBucketOptionsOutput

func (o MetricBucketOptionsOutput) ToMetricBucketOptionsOutput() MetricBucketOptionsOutput

func (MetricBucketOptionsOutput) ToMetricBucketOptionsOutputWithContext

func (o MetricBucketOptionsOutput) ToMetricBucketOptionsOutputWithContext(ctx context.Context) MetricBucketOptionsOutput

func (MetricBucketOptionsOutput) ToMetricBucketOptionsPtrOutput

func (o MetricBucketOptionsOutput) ToMetricBucketOptionsPtrOutput() MetricBucketOptionsPtrOutput

func (MetricBucketOptionsOutput) ToMetricBucketOptionsPtrOutputWithContext

func (o MetricBucketOptionsOutput) ToMetricBucketOptionsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsPtrOutput

type MetricBucketOptionsPtrInput

type MetricBucketOptionsPtrInput interface {
	pulumi.Input

	ToMetricBucketOptionsPtrOutput() MetricBucketOptionsPtrOutput
	ToMetricBucketOptionsPtrOutputWithContext(context.Context) MetricBucketOptionsPtrOutput
}

MetricBucketOptionsPtrInput is an input type that accepts MetricBucketOptionsArgs, MetricBucketOptionsPtr and MetricBucketOptionsPtrOutput values. You can construct a concrete instance of `MetricBucketOptionsPtrInput` via:

        MetricBucketOptionsArgs{...}

or:

        nil

type MetricBucketOptionsPtrOutput

type MetricBucketOptionsPtrOutput struct{ *pulumi.OutputState }

func (MetricBucketOptionsPtrOutput) Elem

func (MetricBucketOptionsPtrOutput) ElementType

func (MetricBucketOptionsPtrOutput) ExplicitBuckets

Specifies a set of buckets with arbitrary widths. Structure is documented below.

func (MetricBucketOptionsPtrOutput) ExponentialBuckets

Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. Structure is documented below.

func (MetricBucketOptionsPtrOutput) LinearBuckets

Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. Structure is documented below.

func (MetricBucketOptionsPtrOutput) ToMetricBucketOptionsPtrOutput

func (o MetricBucketOptionsPtrOutput) ToMetricBucketOptionsPtrOutput() MetricBucketOptionsPtrOutput

func (MetricBucketOptionsPtrOutput) ToMetricBucketOptionsPtrOutputWithContext

func (o MetricBucketOptionsPtrOutput) ToMetricBucketOptionsPtrOutputWithContext(ctx context.Context) MetricBucketOptionsPtrOutput

type MetricInput

type MetricInput interface {
	pulumi.Input

	ToMetricOutput() MetricOutput
	ToMetricOutputWithContext(ctx context.Context) MetricOutput
}

type MetricMap

type MetricMap map[string]MetricInput

func (MetricMap) ElementType

func (MetricMap) ElementType() reflect.Type

func (MetricMap) ToMetricMapOutput

func (i MetricMap) ToMetricMapOutput() MetricMapOutput

func (MetricMap) ToMetricMapOutputWithContext

func (i MetricMap) ToMetricMapOutputWithContext(ctx context.Context) MetricMapOutput

type MetricMapInput

type MetricMapInput interface {
	pulumi.Input

	ToMetricMapOutput() MetricMapOutput
	ToMetricMapOutputWithContext(context.Context) MetricMapOutput
}

MetricMapInput is an input type that accepts MetricMap and MetricMapOutput values. You can construct a concrete instance of `MetricMapInput` via:

MetricMap{ "key": MetricArgs{...} }

type MetricMapOutput

type MetricMapOutput struct{ *pulumi.OutputState }

func (MetricMapOutput) ElementType

func (MetricMapOutput) ElementType() reflect.Type

func (MetricMapOutput) MapIndex

func (MetricMapOutput) ToMetricMapOutput

func (o MetricMapOutput) ToMetricMapOutput() MetricMapOutput

func (MetricMapOutput) ToMetricMapOutputWithContext

func (o MetricMapOutput) ToMetricMapOutputWithContext(ctx context.Context) MetricMapOutput

type MetricMetricDescriptor

type MetricMetricDescriptor struct {
	// A concise name for the metric, which can be displayed in user interfaces. Use sentence case
	// without an ending period, for example "Request count". This field is optional but it is
	// recommended to be set for any metrics associated with user-visible concepts, such as Quota.
	DisplayName *string `pulumi:"displayName"`
	// The set of labels that can be used to describe a specific instance of this metric type. For
	// example, the appengine.googleapis.com/http/server/response_latencies metric type has a label
	// for the HTTP response code, response_code, so you can look at latencies for successful responses
	// or just for responses that failed.
	// Structure is documented below.
	Labels []MetricMetricDescriptorLabel `pulumi:"labels"`
	// Whether the metric records instantaneous values, changes to a value, etc.
	// Some combinations of metricKind and valueType might not be supported.
	// For counter metrics, set this to DELTA.
	// Possible values are `DELTA`, `GAUGE`, and `CUMULATIVE`.
	MetricKind string `pulumi:"metricKind"`
	// The unit in which the metric value is reported. It is only applicable if the valueType is
	// `INT64`, `DOUBLE`, or `DISTRIBUTION`. The supported units are a subset of
	// [The Unified Code for Units of Measure](http://unitsofmeasure.org/ucum.html) standard
	Unit *string `pulumi:"unit"`
	// The type of data that can be assigned to the label.
	// Default value is `STRING`.
	// Possible values are `BOOL`, `INT64`, and `STRING`.
	ValueType string `pulumi:"valueType"`
}

type MetricMetricDescriptorArgs

type MetricMetricDescriptorArgs struct {
	// A concise name for the metric, which can be displayed in user interfaces. Use sentence case
	// without an ending period, for example "Request count". This field is optional but it is
	// recommended to be set for any metrics associated with user-visible concepts, such as Quota.
	DisplayName pulumi.StringPtrInput `pulumi:"displayName"`
	// The set of labels that can be used to describe a specific instance of this metric type. For
	// example, the appengine.googleapis.com/http/server/response_latencies metric type has a label
	// for the HTTP response code, response_code, so you can look at latencies for successful responses
	// or just for responses that failed.
	// Structure is documented below.
	Labels MetricMetricDescriptorLabelArrayInput `pulumi:"labels"`
	// Whether the metric records instantaneous values, changes to a value, etc.
	// Some combinations of metricKind and valueType might not be supported.
	// For counter metrics, set this to DELTA.
	// Possible values are `DELTA`, `GAUGE`, and `CUMULATIVE`.
	MetricKind pulumi.StringInput `pulumi:"metricKind"`
	// The unit in which the metric value is reported. It is only applicable if the valueType is
	// `INT64`, `DOUBLE`, or `DISTRIBUTION`. The supported units are a subset of
	// [The Unified Code for Units of Measure](http://unitsofmeasure.org/ucum.html) standard
	Unit pulumi.StringPtrInput `pulumi:"unit"`
	// The type of data that can be assigned to the label.
	// Default value is `STRING`.
	// Possible values are `BOOL`, `INT64`, and `STRING`.
	ValueType pulumi.StringInput `pulumi:"valueType"`
}

func (MetricMetricDescriptorArgs) ElementType

func (MetricMetricDescriptorArgs) ElementType() reflect.Type

func (MetricMetricDescriptorArgs) ToMetricMetricDescriptorOutput

func (i MetricMetricDescriptorArgs) ToMetricMetricDescriptorOutput() MetricMetricDescriptorOutput

func (MetricMetricDescriptorArgs) ToMetricMetricDescriptorOutputWithContext

func (i MetricMetricDescriptorArgs) ToMetricMetricDescriptorOutputWithContext(ctx context.Context) MetricMetricDescriptorOutput

func (MetricMetricDescriptorArgs) ToMetricMetricDescriptorPtrOutput

func (i MetricMetricDescriptorArgs) ToMetricMetricDescriptorPtrOutput() MetricMetricDescriptorPtrOutput

func (MetricMetricDescriptorArgs) ToMetricMetricDescriptorPtrOutputWithContext

func (i MetricMetricDescriptorArgs) ToMetricMetricDescriptorPtrOutputWithContext(ctx context.Context) MetricMetricDescriptorPtrOutput

type MetricMetricDescriptorInput

type MetricMetricDescriptorInput interface {
	pulumi.Input

	ToMetricMetricDescriptorOutput() MetricMetricDescriptorOutput
	ToMetricMetricDescriptorOutputWithContext(context.Context) MetricMetricDescriptorOutput
}

MetricMetricDescriptorInput is an input type that accepts MetricMetricDescriptorArgs and MetricMetricDescriptorOutput values. You can construct a concrete instance of `MetricMetricDescriptorInput` via:

MetricMetricDescriptorArgs{...}

type MetricMetricDescriptorLabel

type MetricMetricDescriptorLabel struct {
	// A description of this metric, which is used in documentation. The maximum length of the
	// description is 8000 characters.
	Description *string `pulumi:"description"`
	// The label key.
	Key string `pulumi:"key"`
	// The type of data that can be assigned to the label.
	// Default value is `STRING`.
	// Possible values are `BOOL`, `INT64`, and `STRING`.
	ValueType *string `pulumi:"valueType"`
}

type MetricMetricDescriptorLabelArgs

type MetricMetricDescriptorLabelArgs struct {
	// A description of this metric, which is used in documentation. The maximum length of the
	// description is 8000 characters.
	Description pulumi.StringPtrInput `pulumi:"description"`
	// The label key.
	Key pulumi.StringInput `pulumi:"key"`
	// The type of data that can be assigned to the label.
	// Default value is `STRING`.
	// Possible values are `BOOL`, `INT64`, and `STRING`.
	ValueType pulumi.StringPtrInput `pulumi:"valueType"`
}

func (MetricMetricDescriptorLabelArgs) ElementType

func (MetricMetricDescriptorLabelArgs) ToMetricMetricDescriptorLabelOutput

func (i MetricMetricDescriptorLabelArgs) ToMetricMetricDescriptorLabelOutput() MetricMetricDescriptorLabelOutput

func (MetricMetricDescriptorLabelArgs) ToMetricMetricDescriptorLabelOutputWithContext

func (i MetricMetricDescriptorLabelArgs) ToMetricMetricDescriptorLabelOutputWithContext(ctx context.Context) MetricMetricDescriptorLabelOutput

type MetricMetricDescriptorLabelArray

type MetricMetricDescriptorLabelArray []MetricMetricDescriptorLabelInput

func (MetricMetricDescriptorLabelArray) ElementType

func (MetricMetricDescriptorLabelArray) ToMetricMetricDescriptorLabelArrayOutput

func (i MetricMetricDescriptorLabelArray) ToMetricMetricDescriptorLabelArrayOutput() MetricMetricDescriptorLabelArrayOutput

func (MetricMetricDescriptorLabelArray) ToMetricMetricDescriptorLabelArrayOutputWithContext

func (i MetricMetricDescriptorLabelArray) ToMetricMetricDescriptorLabelArrayOutputWithContext(ctx context.Context) MetricMetricDescriptorLabelArrayOutput

type MetricMetricDescriptorLabelArrayInput

type MetricMetricDescriptorLabelArrayInput interface {
	pulumi.Input

	ToMetricMetricDescriptorLabelArrayOutput() MetricMetricDescriptorLabelArrayOutput
	ToMetricMetricDescriptorLabelArrayOutputWithContext(context.Context) MetricMetricDescriptorLabelArrayOutput
}

MetricMetricDescriptorLabelArrayInput is an input type that accepts MetricMetricDescriptorLabelArray and MetricMetricDescriptorLabelArrayOutput values. You can construct a concrete instance of `MetricMetricDescriptorLabelArrayInput` via:

MetricMetricDescriptorLabelArray{ MetricMetricDescriptorLabelArgs{...} }

type MetricMetricDescriptorLabelArrayOutput

type MetricMetricDescriptorLabelArrayOutput struct{ *pulumi.OutputState }

func (MetricMetricDescriptorLabelArrayOutput) ElementType

func (MetricMetricDescriptorLabelArrayOutput) Index

func (MetricMetricDescriptorLabelArrayOutput) ToMetricMetricDescriptorLabelArrayOutput

func (o MetricMetricDescriptorLabelArrayOutput) ToMetricMetricDescriptorLabelArrayOutput() MetricMetricDescriptorLabelArrayOutput

func (MetricMetricDescriptorLabelArrayOutput) ToMetricMetricDescriptorLabelArrayOutputWithContext

func (o MetricMetricDescriptorLabelArrayOutput) ToMetricMetricDescriptorLabelArrayOutputWithContext(ctx context.Context) MetricMetricDescriptorLabelArrayOutput

type MetricMetricDescriptorLabelInput

type MetricMetricDescriptorLabelInput interface {
	pulumi.Input

	ToMetricMetricDescriptorLabelOutput() MetricMetricDescriptorLabelOutput
	ToMetricMetricDescriptorLabelOutputWithContext(context.Context) MetricMetricDescriptorLabelOutput
}

MetricMetricDescriptorLabelInput is an input type that accepts MetricMetricDescriptorLabelArgs and MetricMetricDescriptorLabelOutput values. You can construct a concrete instance of `MetricMetricDescriptorLabelInput` via:

MetricMetricDescriptorLabelArgs{...}

type MetricMetricDescriptorLabelOutput

type MetricMetricDescriptorLabelOutput struct{ *pulumi.OutputState }

func (MetricMetricDescriptorLabelOutput) Description

A description of this metric, which is used in documentation. The maximum length of the description is 8000 characters.

func (MetricMetricDescriptorLabelOutput) ElementType

func (MetricMetricDescriptorLabelOutput) Key

The label key.

func (MetricMetricDescriptorLabelOutput) ToMetricMetricDescriptorLabelOutput

func (o MetricMetricDescriptorLabelOutput) ToMetricMetricDescriptorLabelOutput() MetricMetricDescriptorLabelOutput

func (MetricMetricDescriptorLabelOutput) ToMetricMetricDescriptorLabelOutputWithContext

func (o MetricMetricDescriptorLabelOutput) ToMetricMetricDescriptorLabelOutputWithContext(ctx context.Context) MetricMetricDescriptorLabelOutput

func (MetricMetricDescriptorLabelOutput) ValueType

The type of data that can be assigned to the label. Default value is `STRING`. Possible values are `BOOL`, `INT64`, and `STRING`.

type MetricMetricDescriptorOutput

type MetricMetricDescriptorOutput struct{ *pulumi.OutputState }

func (MetricMetricDescriptorOutput) DisplayName

A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count". This field is optional but it is recommended to be set for any metrics associated with user-visible concepts, such as Quota.

func (MetricMetricDescriptorOutput) ElementType

func (MetricMetricDescriptorOutput) Labels

The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed. Structure is documented below.

func (MetricMetricDescriptorOutput) MetricKind

Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metricKind and valueType might not be supported. For counter metrics, set this to DELTA. Possible values are `DELTA`, `GAUGE`, and `CUMULATIVE`.

func (MetricMetricDescriptorOutput) ToMetricMetricDescriptorOutput

func (o MetricMetricDescriptorOutput) ToMetricMetricDescriptorOutput() MetricMetricDescriptorOutput

func (MetricMetricDescriptorOutput) ToMetricMetricDescriptorOutputWithContext

func (o MetricMetricDescriptorOutput) ToMetricMetricDescriptorOutputWithContext(ctx context.Context) MetricMetricDescriptorOutput

func (MetricMetricDescriptorOutput) ToMetricMetricDescriptorPtrOutput

func (o MetricMetricDescriptorOutput) ToMetricMetricDescriptorPtrOutput() MetricMetricDescriptorPtrOutput

func (MetricMetricDescriptorOutput) ToMetricMetricDescriptorPtrOutputWithContext

func (o MetricMetricDescriptorOutput) ToMetricMetricDescriptorPtrOutputWithContext(ctx context.Context) MetricMetricDescriptorPtrOutput

func (MetricMetricDescriptorOutput) Unit

The unit in which the metric value is reported. It is only applicable if the valueType is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The supported units are a subset of [The Unified Code for Units of Measure](http://unitsofmeasure.org/ucum.html) standard

func (MetricMetricDescriptorOutput) ValueType

The type of data that can be assigned to the label. Default value is `STRING`. Possible values are `BOOL`, `INT64`, and `STRING`.

type MetricMetricDescriptorPtrInput

type MetricMetricDescriptorPtrInput interface {
	pulumi.Input

	ToMetricMetricDescriptorPtrOutput() MetricMetricDescriptorPtrOutput
	ToMetricMetricDescriptorPtrOutputWithContext(context.Context) MetricMetricDescriptorPtrOutput
}

MetricMetricDescriptorPtrInput is an input type that accepts MetricMetricDescriptorArgs, MetricMetricDescriptorPtr and MetricMetricDescriptorPtrOutput values. You can construct a concrete instance of `MetricMetricDescriptorPtrInput` via:

        MetricMetricDescriptorArgs{...}

or:

        nil

type MetricMetricDescriptorPtrOutput

type MetricMetricDescriptorPtrOutput struct{ *pulumi.OutputState }

func (MetricMetricDescriptorPtrOutput) DisplayName

A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count". This field is optional but it is recommended to be set for any metrics associated with user-visible concepts, such as Quota.

func (MetricMetricDescriptorPtrOutput) Elem

func (MetricMetricDescriptorPtrOutput) ElementType

func (MetricMetricDescriptorPtrOutput) Labels

The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed. Structure is documented below.

func (MetricMetricDescriptorPtrOutput) MetricKind

Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metricKind and valueType might not be supported. For counter metrics, set this to DELTA. Possible values are `DELTA`, `GAUGE`, and `CUMULATIVE`.

func (MetricMetricDescriptorPtrOutput) ToMetricMetricDescriptorPtrOutput

func (o MetricMetricDescriptorPtrOutput) ToMetricMetricDescriptorPtrOutput() MetricMetricDescriptorPtrOutput

func (MetricMetricDescriptorPtrOutput) ToMetricMetricDescriptorPtrOutputWithContext

func (o MetricMetricDescriptorPtrOutput) ToMetricMetricDescriptorPtrOutputWithContext(ctx context.Context) MetricMetricDescriptorPtrOutput

func (MetricMetricDescriptorPtrOutput) Unit

The unit in which the metric value is reported. It is only applicable if the valueType is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The supported units are a subset of [The Unified Code for Units of Measure](http://unitsofmeasure.org/ucum.html) standard

func (MetricMetricDescriptorPtrOutput) ValueType

The type of data that can be assigned to the label. Default value is `STRING`. Possible values are `BOOL`, `INT64`, and `STRING`.

type MetricOutput

type MetricOutput struct{ *pulumi.OutputState }

func (MetricOutput) ElementType

func (MetricOutput) ElementType() reflect.Type

func (MetricOutput) ToMetricOutput

func (o MetricOutput) ToMetricOutput() MetricOutput

func (MetricOutput) ToMetricOutputWithContext

func (o MetricOutput) ToMetricOutputWithContext(ctx context.Context) MetricOutput

func (MetricOutput) ToMetricPtrOutput

func (o MetricOutput) ToMetricPtrOutput() MetricPtrOutput

func (MetricOutput) ToMetricPtrOutputWithContext

func (o MetricOutput) ToMetricPtrOutputWithContext(ctx context.Context) MetricPtrOutput

type MetricPtrInput

type MetricPtrInput interface {
	pulumi.Input

	ToMetricPtrOutput() MetricPtrOutput
	ToMetricPtrOutputWithContext(ctx context.Context) MetricPtrOutput
}

type MetricPtrOutput

type MetricPtrOutput struct{ *pulumi.OutputState }

func (MetricPtrOutput) Elem added in v5.21.0

func (o MetricPtrOutput) Elem() MetricOutput

func (MetricPtrOutput) ElementType

func (MetricPtrOutput) ElementType() reflect.Type

func (MetricPtrOutput) ToMetricPtrOutput

func (o MetricPtrOutput) ToMetricPtrOutput() MetricPtrOutput

func (MetricPtrOutput) ToMetricPtrOutputWithContext

func (o MetricPtrOutput) ToMetricPtrOutputWithContext(ctx context.Context) MetricPtrOutput

type MetricState

type MetricState struct {
	// The bucketOptions are required when the logs-based metric is using a DISTRIBUTION value type and it
	// describes the bucket boundaries used to create a histogram of the extracted values.
	// Structure is documented below.
	BucketOptions MetricBucketOptionsPtrInput
	// A description of this metric, which is used in documentation. The maximum length of the
	// description is 8000 characters.
	Description pulumi.StringPtrInput
	// An advanced logs filter (https://cloud.google.com/logging/docs/view/advanced-filters) which
	// is used to match log entries.
	Filter pulumi.StringPtrInput
	// A map from a label key string to an extractor expression which is used to extract data from a log
	// entry field and assign as the label value. Each label key specified in the LabelDescriptor must
	// have an associated extractor expression in this map. The syntax of the extractor expression is
	// the same as for the valueExtractor field.
	LabelExtractors pulumi.StringMapInput
	// The metric descriptor associated with the logs-based metric.
	// Structure is documented below.
	MetricDescriptor MetricMetricDescriptorPtrInput
	// The client-assigned metric identifier. Examples - "errorCount", "nginx/requests".
	// Metric identifiers are limited to 100 characters and can include only the following
	// characters A-Z, a-z, 0-9, and the special characters _-.,+!*',()%/. The forward-slash
	// character (/) denotes a hierarchy of name pieces, and it cannot be the first character
	// of the name.
	Name pulumi.StringPtrInput
	// The ID of the project in which the resource belongs.
	// If it is not provided, the provider project is used.
	Project pulumi.StringPtrInput
	// A valueExtractor is required when using a distribution logs-based metric to extract the values to
	// record from a log entry. Two functions are supported for value extraction - EXTRACT(field) or
	// REGEXP_EXTRACT(field, regex). The argument are 1. field - The name of the log entry field from which
	// the value is to be extracted. 2. regex - A regular expression using the Google RE2 syntax
	// (https://github.com/google/re2/wiki/Syntax) with a single capture group to extract data from the specified
	// log entry field. The value of the field is converted to a string before applying the regex. It is an
	// error to specify a regex that does not include exactly one capture group.
	ValueExtractor pulumi.StringPtrInput
}

func (MetricState) ElementType

func (MetricState) ElementType() reflect.Type

type OrganizationBucketConfig

type OrganizationBucketConfig struct {
	pulumi.CustomResourceState

	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringOutput `pulumi:"bucketId"`
	// Describes this bucket.
	Description pulumi.StringOutput `pulumi:"description"`
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringOutput `pulumi:"lifecycleState"`
	// The location of the bucket. The supported locations are: "global" "us-central1"
	Location pulumi.StringOutput `pulumi:"location"`
	// The resource name of the bucket. For example: "organizations/my-organization-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringOutput `pulumi:"name"`
	// The parent resource that contains the logging bucket.
	Organization pulumi.StringOutput `pulumi:"organization"`
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrOutput `pulumi:"retentionDays"`
}

Manages a organization-level logging bucket config. For more information see [the official logging documentation](https://cloud.google.com/logging/docs/) and [Storing Logs](https://cloud.google.com/logging/docs/storage).

> **Note:** Logging buckets are automatically created for a given folder, project, organization, billingAccount and cannot be deleted. Creating a resource of this type will acquire and update the resource that already exists at the desired location. These buckets cannot be removed so deleting this resource will remove the bucket config from your state but will leave the logging bucket unchanged. The buckets that are currently automatically created are "_Default" and "_Required".

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/organizations"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		opt0 := "123456789"
		_default, err := organizations.GetOrganization(ctx, &organizations.GetOrganizationArgs{
			Organization: &opt0,
		}, nil)
		if err != nil {
			return err
		}
		_, err = logging.NewOrganizationBucketConfig(ctx, "basic", &logging.OrganizationBucketConfigArgs{
			Organization:  pulumi.String(_default.Organization),
			Location:      pulumi.String("global"),
			RetentionDays: pulumi.Int(30),
			BucketId:      pulumi.String("_Default"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

This resource can be imported using the following format

```sh

$ pulumi import gcp:logging/organizationBucketConfig:OrganizationBucketConfig default organizations/{{organization}}/locations/{{location}}/buckets/{{bucket_id}}

```

func GetOrganizationBucketConfig

func GetOrganizationBucketConfig(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *OrganizationBucketConfigState, opts ...pulumi.ResourceOption) (*OrganizationBucketConfig, error)

GetOrganizationBucketConfig gets an existing OrganizationBucketConfig resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewOrganizationBucketConfig

func NewOrganizationBucketConfig(ctx *pulumi.Context,
	name string, args *OrganizationBucketConfigArgs, opts ...pulumi.ResourceOption) (*OrganizationBucketConfig, error)

NewOrganizationBucketConfig registers a new resource with the given unique name, arguments, and options.

func (*OrganizationBucketConfig) ElementType

func (*OrganizationBucketConfig) ElementType() reflect.Type

func (*OrganizationBucketConfig) ToOrganizationBucketConfigOutput

func (i *OrganizationBucketConfig) ToOrganizationBucketConfigOutput() OrganizationBucketConfigOutput

func (*OrganizationBucketConfig) ToOrganizationBucketConfigOutputWithContext

func (i *OrganizationBucketConfig) ToOrganizationBucketConfigOutputWithContext(ctx context.Context) OrganizationBucketConfigOutput

func (*OrganizationBucketConfig) ToOrganizationBucketConfigPtrOutput

func (i *OrganizationBucketConfig) ToOrganizationBucketConfigPtrOutput() OrganizationBucketConfigPtrOutput

func (*OrganizationBucketConfig) ToOrganizationBucketConfigPtrOutputWithContext

func (i *OrganizationBucketConfig) ToOrganizationBucketConfigPtrOutputWithContext(ctx context.Context) OrganizationBucketConfigPtrOutput

type OrganizationBucketConfigArgs

type OrganizationBucketConfigArgs struct {
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The location of the bucket. The supported locations are: "global" "us-central1"
	Location pulumi.StringInput
	// The parent resource that contains the logging bucket.
	Organization pulumi.StringInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrInput
}

The set of arguments for constructing a OrganizationBucketConfig resource.

func (OrganizationBucketConfigArgs) ElementType

type OrganizationBucketConfigArray

type OrganizationBucketConfigArray []OrganizationBucketConfigInput

func (OrganizationBucketConfigArray) ElementType

func (OrganizationBucketConfigArray) ToOrganizationBucketConfigArrayOutput

func (i OrganizationBucketConfigArray) ToOrganizationBucketConfigArrayOutput() OrganizationBucketConfigArrayOutput

func (OrganizationBucketConfigArray) ToOrganizationBucketConfigArrayOutputWithContext

func (i OrganizationBucketConfigArray) ToOrganizationBucketConfigArrayOutputWithContext(ctx context.Context) OrganizationBucketConfigArrayOutput

type OrganizationBucketConfigArrayInput

type OrganizationBucketConfigArrayInput interface {
	pulumi.Input

	ToOrganizationBucketConfigArrayOutput() OrganizationBucketConfigArrayOutput
	ToOrganizationBucketConfigArrayOutputWithContext(context.Context) OrganizationBucketConfigArrayOutput
}

OrganizationBucketConfigArrayInput is an input type that accepts OrganizationBucketConfigArray and OrganizationBucketConfigArrayOutput values. You can construct a concrete instance of `OrganizationBucketConfigArrayInput` via:

OrganizationBucketConfigArray{ OrganizationBucketConfigArgs{...} }

type OrganizationBucketConfigArrayOutput

type OrganizationBucketConfigArrayOutput struct{ *pulumi.OutputState }

func (OrganizationBucketConfigArrayOutput) ElementType

func (OrganizationBucketConfigArrayOutput) Index

func (OrganizationBucketConfigArrayOutput) ToOrganizationBucketConfigArrayOutput

func (o OrganizationBucketConfigArrayOutput) ToOrganizationBucketConfigArrayOutput() OrganizationBucketConfigArrayOutput

func (OrganizationBucketConfigArrayOutput) ToOrganizationBucketConfigArrayOutputWithContext

func (o OrganizationBucketConfigArrayOutput) ToOrganizationBucketConfigArrayOutputWithContext(ctx context.Context) OrganizationBucketConfigArrayOutput

type OrganizationBucketConfigInput

type OrganizationBucketConfigInput interface {
	pulumi.Input

	ToOrganizationBucketConfigOutput() OrganizationBucketConfigOutput
	ToOrganizationBucketConfigOutputWithContext(ctx context.Context) OrganizationBucketConfigOutput
}

type OrganizationBucketConfigMap

type OrganizationBucketConfigMap map[string]OrganizationBucketConfigInput

func (OrganizationBucketConfigMap) ElementType

func (OrganizationBucketConfigMap) ToOrganizationBucketConfigMapOutput

func (i OrganizationBucketConfigMap) ToOrganizationBucketConfigMapOutput() OrganizationBucketConfigMapOutput

func (OrganizationBucketConfigMap) ToOrganizationBucketConfigMapOutputWithContext

func (i OrganizationBucketConfigMap) ToOrganizationBucketConfigMapOutputWithContext(ctx context.Context) OrganizationBucketConfigMapOutput

type OrganizationBucketConfigMapInput

type OrganizationBucketConfigMapInput interface {
	pulumi.Input

	ToOrganizationBucketConfigMapOutput() OrganizationBucketConfigMapOutput
	ToOrganizationBucketConfigMapOutputWithContext(context.Context) OrganizationBucketConfigMapOutput
}

OrganizationBucketConfigMapInput is an input type that accepts OrganizationBucketConfigMap and OrganizationBucketConfigMapOutput values. You can construct a concrete instance of `OrganizationBucketConfigMapInput` via:

OrganizationBucketConfigMap{ "key": OrganizationBucketConfigArgs{...} }

type OrganizationBucketConfigMapOutput

type OrganizationBucketConfigMapOutput struct{ *pulumi.OutputState }

func (OrganizationBucketConfigMapOutput) ElementType

func (OrganizationBucketConfigMapOutput) MapIndex

func (OrganizationBucketConfigMapOutput) ToOrganizationBucketConfigMapOutput

func (o OrganizationBucketConfigMapOutput) ToOrganizationBucketConfigMapOutput() OrganizationBucketConfigMapOutput

func (OrganizationBucketConfigMapOutput) ToOrganizationBucketConfigMapOutputWithContext

func (o OrganizationBucketConfigMapOutput) ToOrganizationBucketConfigMapOutputWithContext(ctx context.Context) OrganizationBucketConfigMapOutput

type OrganizationBucketConfigOutput

type OrganizationBucketConfigOutput struct{ *pulumi.OutputState }

func (OrganizationBucketConfigOutput) ElementType

func (OrganizationBucketConfigOutput) ToOrganizationBucketConfigOutput

func (o OrganizationBucketConfigOutput) ToOrganizationBucketConfigOutput() OrganizationBucketConfigOutput

func (OrganizationBucketConfigOutput) ToOrganizationBucketConfigOutputWithContext

func (o OrganizationBucketConfigOutput) ToOrganizationBucketConfigOutputWithContext(ctx context.Context) OrganizationBucketConfigOutput

func (OrganizationBucketConfigOutput) ToOrganizationBucketConfigPtrOutput

func (o OrganizationBucketConfigOutput) ToOrganizationBucketConfigPtrOutput() OrganizationBucketConfigPtrOutput

func (OrganizationBucketConfigOutput) ToOrganizationBucketConfigPtrOutputWithContext

func (o OrganizationBucketConfigOutput) ToOrganizationBucketConfigPtrOutputWithContext(ctx context.Context) OrganizationBucketConfigPtrOutput

type OrganizationBucketConfigPtrInput

type OrganizationBucketConfigPtrInput interface {
	pulumi.Input

	ToOrganizationBucketConfigPtrOutput() OrganizationBucketConfigPtrOutput
	ToOrganizationBucketConfigPtrOutputWithContext(ctx context.Context) OrganizationBucketConfigPtrOutput
}

type OrganizationBucketConfigPtrOutput

type OrganizationBucketConfigPtrOutput struct{ *pulumi.OutputState }

func (OrganizationBucketConfigPtrOutput) Elem added in v5.21.0

func (OrganizationBucketConfigPtrOutput) ElementType

func (OrganizationBucketConfigPtrOutput) ToOrganizationBucketConfigPtrOutput

func (o OrganizationBucketConfigPtrOutput) ToOrganizationBucketConfigPtrOutput() OrganizationBucketConfigPtrOutput

func (OrganizationBucketConfigPtrOutput) ToOrganizationBucketConfigPtrOutputWithContext

func (o OrganizationBucketConfigPtrOutput) ToOrganizationBucketConfigPtrOutputWithContext(ctx context.Context) OrganizationBucketConfigPtrOutput

type OrganizationBucketConfigState

type OrganizationBucketConfigState struct {
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringPtrInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringPtrInput
	// The location of the bucket. The supported locations are: "global" "us-central1"
	Location pulumi.StringPtrInput
	// The resource name of the bucket. For example: "organizations/my-organization-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringPtrInput
	// The parent resource that contains the logging bucket.
	Organization pulumi.StringPtrInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used. Bucket retention can not be increased on buckets outside of projects.
	RetentionDays pulumi.IntPtrInput
}

func (OrganizationBucketConfigState) ElementType

type OrganizationExclusion

type OrganizationExclusion struct {
	pulumi.CustomResourceState

	// A human-readable description.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringOutput `pulumi:"filter"`
	// The name of the logging exclusion.
	Name pulumi.StringOutput `pulumi:"name"`
	// The organization to create the exclusion in.
	OrgId pulumi.StringOutput `pulumi:"orgId"`
}

Manages an organization-level logging exclusion. For more information see:

* [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/organizations.exclusions) * How-to Guides

> You can specify exclusions for log sinks created by the provider by using the exclusions field of `logging.OrganizationSink`

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := logging.NewOrganizationExclusion(ctx, "my_exclusion", &logging.OrganizationExclusionArgs{
			Description: pulumi.String("Exclude GCE instance debug logs"),
			Filter:      pulumi.String("resource.type = gce_instance AND severity <= DEBUG"),
			OrgId:       pulumi.String("123456789"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Organization-level logging exclusions can be imported using their URI, e.g.

```sh

$ pulumi import gcp:logging/organizationExclusion:OrganizationExclusion my_exclusion organizations/{{organization}}/exclusions/{{name}}

```

func GetOrganizationExclusion

func GetOrganizationExclusion(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *OrganizationExclusionState, opts ...pulumi.ResourceOption) (*OrganizationExclusion, error)

GetOrganizationExclusion gets an existing OrganizationExclusion resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewOrganizationExclusion

func NewOrganizationExclusion(ctx *pulumi.Context,
	name string, args *OrganizationExclusionArgs, opts ...pulumi.ResourceOption) (*OrganizationExclusion, error)

NewOrganizationExclusion registers a new resource with the given unique name, arguments, and options.

func (*OrganizationExclusion) ElementType

func (*OrganizationExclusion) ElementType() reflect.Type

func (*OrganizationExclusion) ToOrganizationExclusionOutput

func (i *OrganizationExclusion) ToOrganizationExclusionOutput() OrganizationExclusionOutput

func (*OrganizationExclusion) ToOrganizationExclusionOutputWithContext

func (i *OrganizationExclusion) ToOrganizationExclusionOutputWithContext(ctx context.Context) OrganizationExclusionOutput

func (*OrganizationExclusion) ToOrganizationExclusionPtrOutput

func (i *OrganizationExclusion) ToOrganizationExclusionPtrOutput() OrganizationExclusionPtrOutput

func (*OrganizationExclusion) ToOrganizationExclusionPtrOutputWithContext

func (i *OrganizationExclusion) ToOrganizationExclusionPtrOutputWithContext(ctx context.Context) OrganizationExclusionPtrOutput

type OrganizationExclusionArgs

type OrganizationExclusionArgs struct {
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
	// The organization to create the exclusion in.
	OrgId pulumi.StringInput
}

The set of arguments for constructing a OrganizationExclusion resource.

func (OrganizationExclusionArgs) ElementType

func (OrganizationExclusionArgs) ElementType() reflect.Type

type OrganizationExclusionArray

type OrganizationExclusionArray []OrganizationExclusionInput

func (OrganizationExclusionArray) ElementType

func (OrganizationExclusionArray) ElementType() reflect.Type

func (OrganizationExclusionArray) ToOrganizationExclusionArrayOutput

func (i OrganizationExclusionArray) ToOrganizationExclusionArrayOutput() OrganizationExclusionArrayOutput

func (OrganizationExclusionArray) ToOrganizationExclusionArrayOutputWithContext

func (i OrganizationExclusionArray) ToOrganizationExclusionArrayOutputWithContext(ctx context.Context) OrganizationExclusionArrayOutput

type OrganizationExclusionArrayInput

type OrganizationExclusionArrayInput interface {
	pulumi.Input

	ToOrganizationExclusionArrayOutput() OrganizationExclusionArrayOutput
	ToOrganizationExclusionArrayOutputWithContext(context.Context) OrganizationExclusionArrayOutput
}

OrganizationExclusionArrayInput is an input type that accepts OrganizationExclusionArray and OrganizationExclusionArrayOutput values. You can construct a concrete instance of `OrganizationExclusionArrayInput` via:

OrganizationExclusionArray{ OrganizationExclusionArgs{...} }

type OrganizationExclusionArrayOutput

type OrganizationExclusionArrayOutput struct{ *pulumi.OutputState }

func (OrganizationExclusionArrayOutput) ElementType

func (OrganizationExclusionArrayOutput) Index

func (OrganizationExclusionArrayOutput) ToOrganizationExclusionArrayOutput

func (o OrganizationExclusionArrayOutput) ToOrganizationExclusionArrayOutput() OrganizationExclusionArrayOutput

func (OrganizationExclusionArrayOutput) ToOrganizationExclusionArrayOutputWithContext

func (o OrganizationExclusionArrayOutput) ToOrganizationExclusionArrayOutputWithContext(ctx context.Context) OrganizationExclusionArrayOutput

type OrganizationExclusionInput

type OrganizationExclusionInput interface {
	pulumi.Input

	ToOrganizationExclusionOutput() OrganizationExclusionOutput
	ToOrganizationExclusionOutputWithContext(ctx context.Context) OrganizationExclusionOutput
}

type OrganizationExclusionMap

type OrganizationExclusionMap map[string]OrganizationExclusionInput

func (OrganizationExclusionMap) ElementType

func (OrganizationExclusionMap) ElementType() reflect.Type

func (OrganizationExclusionMap) ToOrganizationExclusionMapOutput

func (i OrganizationExclusionMap) ToOrganizationExclusionMapOutput() OrganizationExclusionMapOutput

func (OrganizationExclusionMap) ToOrganizationExclusionMapOutputWithContext

func (i OrganizationExclusionMap) ToOrganizationExclusionMapOutputWithContext(ctx context.Context) OrganizationExclusionMapOutput

type OrganizationExclusionMapInput

type OrganizationExclusionMapInput interface {
	pulumi.Input

	ToOrganizationExclusionMapOutput() OrganizationExclusionMapOutput
	ToOrganizationExclusionMapOutputWithContext(context.Context) OrganizationExclusionMapOutput
}

OrganizationExclusionMapInput is an input type that accepts OrganizationExclusionMap and OrganizationExclusionMapOutput values. You can construct a concrete instance of `OrganizationExclusionMapInput` via:

OrganizationExclusionMap{ "key": OrganizationExclusionArgs{...} }

type OrganizationExclusionMapOutput

type OrganizationExclusionMapOutput struct{ *pulumi.OutputState }

func (OrganizationExclusionMapOutput) ElementType

func (OrganizationExclusionMapOutput) MapIndex

func (OrganizationExclusionMapOutput) ToOrganizationExclusionMapOutput

func (o OrganizationExclusionMapOutput) ToOrganizationExclusionMapOutput() OrganizationExclusionMapOutput

func (OrganizationExclusionMapOutput) ToOrganizationExclusionMapOutputWithContext

func (o OrganizationExclusionMapOutput) ToOrganizationExclusionMapOutputWithContext(ctx context.Context) OrganizationExclusionMapOutput

type OrganizationExclusionOutput

type OrganizationExclusionOutput struct{ *pulumi.OutputState }

func (OrganizationExclusionOutput) ElementType

func (OrganizationExclusionOutput) ToOrganizationExclusionOutput

func (o OrganizationExclusionOutput) ToOrganizationExclusionOutput() OrganizationExclusionOutput

func (OrganizationExclusionOutput) ToOrganizationExclusionOutputWithContext

func (o OrganizationExclusionOutput) ToOrganizationExclusionOutputWithContext(ctx context.Context) OrganizationExclusionOutput

func (OrganizationExclusionOutput) ToOrganizationExclusionPtrOutput

func (o OrganizationExclusionOutput) ToOrganizationExclusionPtrOutput() OrganizationExclusionPtrOutput

func (OrganizationExclusionOutput) ToOrganizationExclusionPtrOutputWithContext

func (o OrganizationExclusionOutput) ToOrganizationExclusionPtrOutputWithContext(ctx context.Context) OrganizationExclusionPtrOutput

type OrganizationExclusionPtrInput

type OrganizationExclusionPtrInput interface {
	pulumi.Input

	ToOrganizationExclusionPtrOutput() OrganizationExclusionPtrOutput
	ToOrganizationExclusionPtrOutputWithContext(ctx context.Context) OrganizationExclusionPtrOutput
}

type OrganizationExclusionPtrOutput

type OrganizationExclusionPtrOutput struct{ *pulumi.OutputState }

func (OrganizationExclusionPtrOutput) Elem added in v5.21.0

func (OrganizationExclusionPtrOutput) ElementType

func (OrganizationExclusionPtrOutput) ToOrganizationExclusionPtrOutput

func (o OrganizationExclusionPtrOutput) ToOrganizationExclusionPtrOutput() OrganizationExclusionPtrOutput

func (OrganizationExclusionPtrOutput) ToOrganizationExclusionPtrOutputWithContext

func (o OrganizationExclusionPtrOutput) ToOrganizationExclusionPtrOutputWithContext(ctx context.Context) OrganizationExclusionPtrOutput

type OrganizationExclusionState

type OrganizationExclusionState struct {
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
	// The organization to create the exclusion in.
	OrgId pulumi.StringPtrInput
}

func (OrganizationExclusionState) ElementType

func (OrganizationExclusionState) ElementType() reflect.Type

type OrganizationSink

type OrganizationSink struct {
	pulumi.CustomResourceState

	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions OrganizationSinkBigqueryOptionsOutput `pulumi:"bigqueryOptions"`
	// A description of this exclusion.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringOutput `pulumi:"destination"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions OrganizationSinkExclusionArrayOutput `pulumi:"exclusions"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrOutput `pulumi:"filter"`
	// Whether or not to include children organizations in the sink export. If true, logs
	// associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
	IncludeChildren pulumi.BoolPtrOutput `pulumi:"includeChildren"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringOutput `pulumi:"name"`
	// The numeric ID of the organization to be exported to the sink.
	OrgId pulumi.StringOutput `pulumi:"orgId"`
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringOutput `pulumi:"writerIdentity"`
}

Manages a organization-level logging sink. For more information see: * [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/organizations.sinks) * How-to Guides

## Example Usage

```go package main

import (

"fmt"

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/projects"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/storage"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := storage.NewBucket(ctx, "log_bucket", nil)
		if err != nil {
			return err
		}
		_, err = logging.NewOrganizationSink(ctx, "my_sink", &logging.OrganizationSinkArgs{
			Description: pulumi.String("some explanation on what this is"),
			OrgId:       pulumi.String("123456789"),
			Destination: log_bucket.Name.ApplyT(func(name string) (string, error) {
				return fmt.Sprintf("%v%v", "storage.googleapis.com/", name), nil
			}).(pulumi.StringOutput),
			Filter: pulumi.String("resource.type = gce_instance AND severity >= WARNING"),
		})
		if err != nil {
			return err
		}
		_, err = projects.NewIAMMember(ctx, "log_writer", &projects.IAMMemberArgs{
			Role:   pulumi.String("roles/storage.objectCreator"),
			Member: my_sink.WriterIdentity,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Organization-level logging sinks can be imported using this format

```sh

$ pulumi import gcp:logging/organizationSink:OrganizationSink my_sink organizations/{{organization_id}}/sinks/{{sink_id}}

```

func GetOrganizationSink

func GetOrganizationSink(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *OrganizationSinkState, opts ...pulumi.ResourceOption) (*OrganizationSink, error)

GetOrganizationSink gets an existing OrganizationSink resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewOrganizationSink

func NewOrganizationSink(ctx *pulumi.Context,
	name string, args *OrganizationSinkArgs, opts ...pulumi.ResourceOption) (*OrganizationSink, error)

NewOrganizationSink registers a new resource with the given unique name, arguments, and options.

func (*OrganizationSink) ElementType

func (*OrganizationSink) ElementType() reflect.Type

func (*OrganizationSink) ToOrganizationSinkOutput

func (i *OrganizationSink) ToOrganizationSinkOutput() OrganizationSinkOutput

func (*OrganizationSink) ToOrganizationSinkOutputWithContext

func (i *OrganizationSink) ToOrganizationSinkOutputWithContext(ctx context.Context) OrganizationSinkOutput

func (*OrganizationSink) ToOrganizationSinkPtrOutput

func (i *OrganizationSink) ToOrganizationSinkPtrOutput() OrganizationSinkPtrOutput

func (*OrganizationSink) ToOrganizationSinkPtrOutputWithContext

func (i *OrganizationSink) ToOrganizationSinkPtrOutputWithContext(ctx context.Context) OrganizationSinkPtrOutput

type OrganizationSinkArgs

type OrganizationSinkArgs struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions OrganizationSinkBigqueryOptionsPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions OrganizationSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// Whether or not to include children organizations in the sink export. If true, logs
	// associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
	IncludeChildren pulumi.BoolPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
	// The numeric ID of the organization to be exported to the sink.
	OrgId pulumi.StringInput
}

The set of arguments for constructing a OrganizationSink resource.

func (OrganizationSinkArgs) ElementType

func (OrganizationSinkArgs) ElementType() reflect.Type

type OrganizationSinkArray

type OrganizationSinkArray []OrganizationSinkInput

func (OrganizationSinkArray) ElementType

func (OrganizationSinkArray) ElementType() reflect.Type

func (OrganizationSinkArray) ToOrganizationSinkArrayOutput

func (i OrganizationSinkArray) ToOrganizationSinkArrayOutput() OrganizationSinkArrayOutput

func (OrganizationSinkArray) ToOrganizationSinkArrayOutputWithContext

func (i OrganizationSinkArray) ToOrganizationSinkArrayOutputWithContext(ctx context.Context) OrganizationSinkArrayOutput

type OrganizationSinkArrayInput

type OrganizationSinkArrayInput interface {
	pulumi.Input

	ToOrganizationSinkArrayOutput() OrganizationSinkArrayOutput
	ToOrganizationSinkArrayOutputWithContext(context.Context) OrganizationSinkArrayOutput
}

OrganizationSinkArrayInput is an input type that accepts OrganizationSinkArray and OrganizationSinkArrayOutput values. You can construct a concrete instance of `OrganizationSinkArrayInput` via:

OrganizationSinkArray{ OrganizationSinkArgs{...} }

type OrganizationSinkArrayOutput

type OrganizationSinkArrayOutput struct{ *pulumi.OutputState }

func (OrganizationSinkArrayOutput) ElementType

func (OrganizationSinkArrayOutput) Index

func (OrganizationSinkArrayOutput) ToOrganizationSinkArrayOutput

func (o OrganizationSinkArrayOutput) ToOrganizationSinkArrayOutput() OrganizationSinkArrayOutput

func (OrganizationSinkArrayOutput) ToOrganizationSinkArrayOutputWithContext

func (o OrganizationSinkArrayOutput) ToOrganizationSinkArrayOutputWithContext(ctx context.Context) OrganizationSinkArrayOutput

type OrganizationSinkBigqueryOptions

type OrganizationSinkBigqueryOptions struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables bool `pulumi:"usePartitionedTables"`
}

type OrganizationSinkBigqueryOptionsArgs

type OrganizationSinkBigqueryOptionsArgs struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables pulumi.BoolInput `pulumi:"usePartitionedTables"`
}

func (OrganizationSinkBigqueryOptionsArgs) ElementType

func (OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsOutput

func (i OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsOutput() OrganizationSinkBigqueryOptionsOutput

func (OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsOutputWithContext

func (i OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsOutputWithContext(ctx context.Context) OrganizationSinkBigqueryOptionsOutput

func (OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsPtrOutput

func (i OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsPtrOutput() OrganizationSinkBigqueryOptionsPtrOutput

func (OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsPtrOutputWithContext

func (i OrganizationSinkBigqueryOptionsArgs) ToOrganizationSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) OrganizationSinkBigqueryOptionsPtrOutput

type OrganizationSinkBigqueryOptionsInput

type OrganizationSinkBigqueryOptionsInput interface {
	pulumi.Input

	ToOrganizationSinkBigqueryOptionsOutput() OrganizationSinkBigqueryOptionsOutput
	ToOrganizationSinkBigqueryOptionsOutputWithContext(context.Context) OrganizationSinkBigqueryOptionsOutput
}

OrganizationSinkBigqueryOptionsInput is an input type that accepts OrganizationSinkBigqueryOptionsArgs and OrganizationSinkBigqueryOptionsOutput values. You can construct a concrete instance of `OrganizationSinkBigqueryOptionsInput` via:

OrganizationSinkBigqueryOptionsArgs{...}

type OrganizationSinkBigqueryOptionsOutput

type OrganizationSinkBigqueryOptionsOutput struct{ *pulumi.OutputState }

func (OrganizationSinkBigqueryOptionsOutput) ElementType

func (OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsOutput

func (o OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsOutput() OrganizationSinkBigqueryOptionsOutput

func (OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsOutputWithContext

func (o OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsOutputWithContext(ctx context.Context) OrganizationSinkBigqueryOptionsOutput

func (OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsPtrOutput

func (o OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsPtrOutput() OrganizationSinkBigqueryOptionsPtrOutput

func (OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsPtrOutputWithContext

func (o OrganizationSinkBigqueryOptionsOutput) ToOrganizationSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) OrganizationSinkBigqueryOptionsPtrOutput

func (OrganizationSinkBigqueryOptionsOutput) UsePartitionedTables

func (o OrganizationSinkBigqueryOptionsOutput) UsePartitionedTables() pulumi.BoolOutput

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type OrganizationSinkBigqueryOptionsPtrInput

type OrganizationSinkBigqueryOptionsPtrInput interface {
	pulumi.Input

	ToOrganizationSinkBigqueryOptionsPtrOutput() OrganizationSinkBigqueryOptionsPtrOutput
	ToOrganizationSinkBigqueryOptionsPtrOutputWithContext(context.Context) OrganizationSinkBigqueryOptionsPtrOutput
}

OrganizationSinkBigqueryOptionsPtrInput is an input type that accepts OrganizationSinkBigqueryOptionsArgs, OrganizationSinkBigqueryOptionsPtr and OrganizationSinkBigqueryOptionsPtrOutput values. You can construct a concrete instance of `OrganizationSinkBigqueryOptionsPtrInput` via:

        OrganizationSinkBigqueryOptionsArgs{...}

or:

        nil

type OrganizationSinkBigqueryOptionsPtrOutput

type OrganizationSinkBigqueryOptionsPtrOutput struct{ *pulumi.OutputState }

func (OrganizationSinkBigqueryOptionsPtrOutput) Elem

func (OrganizationSinkBigqueryOptionsPtrOutput) ElementType

func (OrganizationSinkBigqueryOptionsPtrOutput) ToOrganizationSinkBigqueryOptionsPtrOutput

func (o OrganizationSinkBigqueryOptionsPtrOutput) ToOrganizationSinkBigqueryOptionsPtrOutput() OrganizationSinkBigqueryOptionsPtrOutput

func (OrganizationSinkBigqueryOptionsPtrOutput) ToOrganizationSinkBigqueryOptionsPtrOutputWithContext

func (o OrganizationSinkBigqueryOptionsPtrOutput) ToOrganizationSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) OrganizationSinkBigqueryOptionsPtrOutput

func (OrganizationSinkBigqueryOptionsPtrOutput) UsePartitionedTables

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type OrganizationSinkExclusion

type OrganizationSinkExclusion struct {
	// A description of this exclusion.
	Description *string `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled *bool `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter string `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name string `pulumi:"name"`
}

type OrganizationSinkExclusionArgs

type OrganizationSinkExclusionArgs struct {
	// A description of this exclusion.
	Description pulumi.StringPtrInput `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringInput `pulumi:"name"`
}

func (OrganizationSinkExclusionArgs) ElementType

func (OrganizationSinkExclusionArgs) ToOrganizationSinkExclusionOutput

func (i OrganizationSinkExclusionArgs) ToOrganizationSinkExclusionOutput() OrganizationSinkExclusionOutput

func (OrganizationSinkExclusionArgs) ToOrganizationSinkExclusionOutputWithContext

func (i OrganizationSinkExclusionArgs) ToOrganizationSinkExclusionOutputWithContext(ctx context.Context) OrganizationSinkExclusionOutput

type OrganizationSinkExclusionArray

type OrganizationSinkExclusionArray []OrganizationSinkExclusionInput

func (OrganizationSinkExclusionArray) ElementType

func (OrganizationSinkExclusionArray) ToOrganizationSinkExclusionArrayOutput

func (i OrganizationSinkExclusionArray) ToOrganizationSinkExclusionArrayOutput() OrganizationSinkExclusionArrayOutput

func (OrganizationSinkExclusionArray) ToOrganizationSinkExclusionArrayOutputWithContext

func (i OrganizationSinkExclusionArray) ToOrganizationSinkExclusionArrayOutputWithContext(ctx context.Context) OrganizationSinkExclusionArrayOutput

type OrganizationSinkExclusionArrayInput

type OrganizationSinkExclusionArrayInput interface {
	pulumi.Input

	ToOrganizationSinkExclusionArrayOutput() OrganizationSinkExclusionArrayOutput
	ToOrganizationSinkExclusionArrayOutputWithContext(context.Context) OrganizationSinkExclusionArrayOutput
}

OrganizationSinkExclusionArrayInput is an input type that accepts OrganizationSinkExclusionArray and OrganizationSinkExclusionArrayOutput values. You can construct a concrete instance of `OrganizationSinkExclusionArrayInput` via:

OrganizationSinkExclusionArray{ OrganizationSinkExclusionArgs{...} }

type OrganizationSinkExclusionArrayOutput

type OrganizationSinkExclusionArrayOutput struct{ *pulumi.OutputState }

func (OrganizationSinkExclusionArrayOutput) ElementType

func (OrganizationSinkExclusionArrayOutput) Index

func (OrganizationSinkExclusionArrayOutput) ToOrganizationSinkExclusionArrayOutput

func (o OrganizationSinkExclusionArrayOutput) ToOrganizationSinkExclusionArrayOutput() OrganizationSinkExclusionArrayOutput

func (OrganizationSinkExclusionArrayOutput) ToOrganizationSinkExclusionArrayOutputWithContext

func (o OrganizationSinkExclusionArrayOutput) ToOrganizationSinkExclusionArrayOutputWithContext(ctx context.Context) OrganizationSinkExclusionArrayOutput

type OrganizationSinkExclusionInput

type OrganizationSinkExclusionInput interface {
	pulumi.Input

	ToOrganizationSinkExclusionOutput() OrganizationSinkExclusionOutput
	ToOrganizationSinkExclusionOutputWithContext(context.Context) OrganizationSinkExclusionOutput
}

OrganizationSinkExclusionInput is an input type that accepts OrganizationSinkExclusionArgs and OrganizationSinkExclusionOutput values. You can construct a concrete instance of `OrganizationSinkExclusionInput` via:

OrganizationSinkExclusionArgs{...}

type OrganizationSinkExclusionOutput

type OrganizationSinkExclusionOutput struct{ *pulumi.OutputState }

func (OrganizationSinkExclusionOutput) Description

A description of this exclusion.

func (OrganizationSinkExclusionOutput) Disabled

If set to True, then this exclusion is disabled and it does not exclude any log entries.

func (OrganizationSinkExclusionOutput) ElementType

func (OrganizationSinkExclusionOutput) Filter

An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to write a filter.

func (OrganizationSinkExclusionOutput) Name

A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.

func (OrganizationSinkExclusionOutput) ToOrganizationSinkExclusionOutput

func (o OrganizationSinkExclusionOutput) ToOrganizationSinkExclusionOutput() OrganizationSinkExclusionOutput

func (OrganizationSinkExclusionOutput) ToOrganizationSinkExclusionOutputWithContext

func (o OrganizationSinkExclusionOutput) ToOrganizationSinkExclusionOutputWithContext(ctx context.Context) OrganizationSinkExclusionOutput

type OrganizationSinkInput

type OrganizationSinkInput interface {
	pulumi.Input

	ToOrganizationSinkOutput() OrganizationSinkOutput
	ToOrganizationSinkOutputWithContext(ctx context.Context) OrganizationSinkOutput
}

type OrganizationSinkMap

type OrganizationSinkMap map[string]OrganizationSinkInput

func (OrganizationSinkMap) ElementType

func (OrganizationSinkMap) ElementType() reflect.Type

func (OrganizationSinkMap) ToOrganizationSinkMapOutput

func (i OrganizationSinkMap) ToOrganizationSinkMapOutput() OrganizationSinkMapOutput

func (OrganizationSinkMap) ToOrganizationSinkMapOutputWithContext

func (i OrganizationSinkMap) ToOrganizationSinkMapOutputWithContext(ctx context.Context) OrganizationSinkMapOutput

type OrganizationSinkMapInput

type OrganizationSinkMapInput interface {
	pulumi.Input

	ToOrganizationSinkMapOutput() OrganizationSinkMapOutput
	ToOrganizationSinkMapOutputWithContext(context.Context) OrganizationSinkMapOutput
}

OrganizationSinkMapInput is an input type that accepts OrganizationSinkMap and OrganizationSinkMapOutput values. You can construct a concrete instance of `OrganizationSinkMapInput` via:

OrganizationSinkMap{ "key": OrganizationSinkArgs{...} }

type OrganizationSinkMapOutput

type OrganizationSinkMapOutput struct{ *pulumi.OutputState }

func (OrganizationSinkMapOutput) ElementType

func (OrganizationSinkMapOutput) ElementType() reflect.Type

func (OrganizationSinkMapOutput) MapIndex

func (OrganizationSinkMapOutput) ToOrganizationSinkMapOutput

func (o OrganizationSinkMapOutput) ToOrganizationSinkMapOutput() OrganizationSinkMapOutput

func (OrganizationSinkMapOutput) ToOrganizationSinkMapOutputWithContext

func (o OrganizationSinkMapOutput) ToOrganizationSinkMapOutputWithContext(ctx context.Context) OrganizationSinkMapOutput

type OrganizationSinkOutput

type OrganizationSinkOutput struct{ *pulumi.OutputState }

func (OrganizationSinkOutput) ElementType

func (OrganizationSinkOutput) ElementType() reflect.Type

func (OrganizationSinkOutput) ToOrganizationSinkOutput

func (o OrganizationSinkOutput) ToOrganizationSinkOutput() OrganizationSinkOutput

func (OrganizationSinkOutput) ToOrganizationSinkOutputWithContext

func (o OrganizationSinkOutput) ToOrganizationSinkOutputWithContext(ctx context.Context) OrganizationSinkOutput

func (OrganizationSinkOutput) ToOrganizationSinkPtrOutput

func (o OrganizationSinkOutput) ToOrganizationSinkPtrOutput() OrganizationSinkPtrOutput

func (OrganizationSinkOutput) ToOrganizationSinkPtrOutputWithContext

func (o OrganizationSinkOutput) ToOrganizationSinkPtrOutputWithContext(ctx context.Context) OrganizationSinkPtrOutput

type OrganizationSinkPtrInput

type OrganizationSinkPtrInput interface {
	pulumi.Input

	ToOrganizationSinkPtrOutput() OrganizationSinkPtrOutput
	ToOrganizationSinkPtrOutputWithContext(ctx context.Context) OrganizationSinkPtrOutput
}

type OrganizationSinkPtrOutput

type OrganizationSinkPtrOutput struct{ *pulumi.OutputState }

func (OrganizationSinkPtrOutput) Elem added in v5.21.0

func (OrganizationSinkPtrOutput) ElementType

func (OrganizationSinkPtrOutput) ElementType() reflect.Type

func (OrganizationSinkPtrOutput) ToOrganizationSinkPtrOutput

func (o OrganizationSinkPtrOutput) ToOrganizationSinkPtrOutput() OrganizationSinkPtrOutput

func (OrganizationSinkPtrOutput) ToOrganizationSinkPtrOutputWithContext

func (o OrganizationSinkPtrOutput) ToOrganizationSinkPtrOutputWithContext(ctx context.Context) OrganizationSinkPtrOutput

type OrganizationSinkState

type OrganizationSinkState struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions OrganizationSinkBigqueryOptionsPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket. Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringPtrInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions OrganizationSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// Whether or not to include children organizations in the sink export. If true, logs
	// associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
	IncludeChildren pulumi.BoolPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
	// The numeric ID of the organization to be exported to the sink.
	OrgId pulumi.StringPtrInput
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringPtrInput
}

func (OrganizationSinkState) ElementType

func (OrganizationSinkState) ElementType() reflect.Type

type ProjectBucketConfig

type ProjectBucketConfig struct {
	pulumi.CustomResourceState

	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringOutput `pulumi:"bucketId"`
	// Describes this bucket.
	Description pulumi.StringOutput `pulumi:"description"`
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringOutput `pulumi:"lifecycleState"`
	// The location of the bucket.
	Location pulumi.StringOutput `pulumi:"location"`
	// The resource name of the bucket. For example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringOutput `pulumi:"name"`
	// The parent resource that contains the logging bucket.
	Project pulumi.StringOutput `pulumi:"project"`
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used.
	RetentionDays pulumi.IntPtrOutput `pulumi:"retentionDays"`
}

Manages a project-level logging bucket config. For more information see [the official logging documentation](https://cloud.google.com/logging/docs/) and [Storing Logs](https://cloud.google.com/logging/docs/storage).

> **Note:** Logging buckets are automatically created for a given folder, project, organization, billingAccount and cannot be deleted. Creating a resource of this type will acquire and update the resource that already exists at the desired location. These buckets cannot be removed so deleting this resource will remove the bucket config from your state but will leave the logging bucket unchanged. The buckets that are currently automatically created are "_Default" and "_Required".

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/organizations"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := organizations.NewProject(ctx, "_default", &organizations.ProjectArgs{
			ProjectId: pulumi.String("your-project-id"),
			OrgId:     pulumi.String("123456789"),
		})
		if err != nil {
			return err
		}
		_, err = logging.NewProjectBucketConfig(ctx, "basic", &logging.ProjectBucketConfigArgs{
			Project:       _default.Name,
			Location:      pulumi.String("global"),
			RetentionDays: pulumi.Int(30),
			BucketId:      pulumi.String("_Default"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

Create logging bucket with customId

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := logging.NewProjectBucketConfig(ctx, "basic", &logging.ProjectBucketConfigArgs{
			BucketId:      pulumi.String("custom-bucket"),
			Location:      pulumi.String("global"),
			Project:       pulumi.String("project_id"),
			RetentionDays: pulumi.Int(30),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

This resource can be imported using the following format

```sh

$ pulumi import gcp:logging/projectBucketConfig:ProjectBucketConfig default projects/{{project}}/locations/{{location}}/buckets/{{bucket_id}}

```

func GetProjectBucketConfig

func GetProjectBucketConfig(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProjectBucketConfigState, opts ...pulumi.ResourceOption) (*ProjectBucketConfig, error)

GetProjectBucketConfig gets an existing ProjectBucketConfig resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProjectBucketConfig

func NewProjectBucketConfig(ctx *pulumi.Context,
	name string, args *ProjectBucketConfigArgs, opts ...pulumi.ResourceOption) (*ProjectBucketConfig, error)

NewProjectBucketConfig registers a new resource with the given unique name, arguments, and options.

func (*ProjectBucketConfig) ElementType

func (*ProjectBucketConfig) ElementType() reflect.Type

func (*ProjectBucketConfig) ToProjectBucketConfigOutput

func (i *ProjectBucketConfig) ToProjectBucketConfigOutput() ProjectBucketConfigOutput

func (*ProjectBucketConfig) ToProjectBucketConfigOutputWithContext

func (i *ProjectBucketConfig) ToProjectBucketConfigOutputWithContext(ctx context.Context) ProjectBucketConfigOutput

func (*ProjectBucketConfig) ToProjectBucketConfigPtrOutput

func (i *ProjectBucketConfig) ToProjectBucketConfigPtrOutput() ProjectBucketConfigPtrOutput

func (*ProjectBucketConfig) ToProjectBucketConfigPtrOutputWithContext

func (i *ProjectBucketConfig) ToProjectBucketConfigPtrOutputWithContext(ctx context.Context) ProjectBucketConfigPtrOutput

type ProjectBucketConfigArgs

type ProjectBucketConfigArgs struct {
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The location of the bucket.
	Location pulumi.StringInput
	// The parent resource that contains the logging bucket.
	Project pulumi.StringInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used.
	RetentionDays pulumi.IntPtrInput
}

The set of arguments for constructing a ProjectBucketConfig resource.

func (ProjectBucketConfigArgs) ElementType

func (ProjectBucketConfigArgs) ElementType() reflect.Type

type ProjectBucketConfigArray

type ProjectBucketConfigArray []ProjectBucketConfigInput

func (ProjectBucketConfigArray) ElementType

func (ProjectBucketConfigArray) ElementType() reflect.Type

func (ProjectBucketConfigArray) ToProjectBucketConfigArrayOutput

func (i ProjectBucketConfigArray) ToProjectBucketConfigArrayOutput() ProjectBucketConfigArrayOutput

func (ProjectBucketConfigArray) ToProjectBucketConfigArrayOutputWithContext

func (i ProjectBucketConfigArray) ToProjectBucketConfigArrayOutputWithContext(ctx context.Context) ProjectBucketConfigArrayOutput

type ProjectBucketConfigArrayInput

type ProjectBucketConfigArrayInput interface {
	pulumi.Input

	ToProjectBucketConfigArrayOutput() ProjectBucketConfigArrayOutput
	ToProjectBucketConfigArrayOutputWithContext(context.Context) ProjectBucketConfigArrayOutput
}

ProjectBucketConfigArrayInput is an input type that accepts ProjectBucketConfigArray and ProjectBucketConfigArrayOutput values. You can construct a concrete instance of `ProjectBucketConfigArrayInput` via:

ProjectBucketConfigArray{ ProjectBucketConfigArgs{...} }

type ProjectBucketConfigArrayOutput

type ProjectBucketConfigArrayOutput struct{ *pulumi.OutputState }

func (ProjectBucketConfigArrayOutput) ElementType

func (ProjectBucketConfigArrayOutput) Index

func (ProjectBucketConfigArrayOutput) ToProjectBucketConfigArrayOutput

func (o ProjectBucketConfigArrayOutput) ToProjectBucketConfigArrayOutput() ProjectBucketConfigArrayOutput

func (ProjectBucketConfigArrayOutput) ToProjectBucketConfigArrayOutputWithContext

func (o ProjectBucketConfigArrayOutput) ToProjectBucketConfigArrayOutputWithContext(ctx context.Context) ProjectBucketConfigArrayOutput

type ProjectBucketConfigInput

type ProjectBucketConfigInput interface {
	pulumi.Input

	ToProjectBucketConfigOutput() ProjectBucketConfigOutput
	ToProjectBucketConfigOutputWithContext(ctx context.Context) ProjectBucketConfigOutput
}

type ProjectBucketConfigMap

type ProjectBucketConfigMap map[string]ProjectBucketConfigInput

func (ProjectBucketConfigMap) ElementType

func (ProjectBucketConfigMap) ElementType() reflect.Type

func (ProjectBucketConfigMap) ToProjectBucketConfigMapOutput

func (i ProjectBucketConfigMap) ToProjectBucketConfigMapOutput() ProjectBucketConfigMapOutput

func (ProjectBucketConfigMap) ToProjectBucketConfigMapOutputWithContext

func (i ProjectBucketConfigMap) ToProjectBucketConfigMapOutputWithContext(ctx context.Context) ProjectBucketConfigMapOutput

type ProjectBucketConfigMapInput

type ProjectBucketConfigMapInput interface {
	pulumi.Input

	ToProjectBucketConfigMapOutput() ProjectBucketConfigMapOutput
	ToProjectBucketConfigMapOutputWithContext(context.Context) ProjectBucketConfigMapOutput
}

ProjectBucketConfigMapInput is an input type that accepts ProjectBucketConfigMap and ProjectBucketConfigMapOutput values. You can construct a concrete instance of `ProjectBucketConfigMapInput` via:

ProjectBucketConfigMap{ "key": ProjectBucketConfigArgs{...} }

type ProjectBucketConfigMapOutput

type ProjectBucketConfigMapOutput struct{ *pulumi.OutputState }

func (ProjectBucketConfigMapOutput) ElementType

func (ProjectBucketConfigMapOutput) MapIndex

func (ProjectBucketConfigMapOutput) ToProjectBucketConfigMapOutput

func (o ProjectBucketConfigMapOutput) ToProjectBucketConfigMapOutput() ProjectBucketConfigMapOutput

func (ProjectBucketConfigMapOutput) ToProjectBucketConfigMapOutputWithContext

func (o ProjectBucketConfigMapOutput) ToProjectBucketConfigMapOutputWithContext(ctx context.Context) ProjectBucketConfigMapOutput

type ProjectBucketConfigOutput

type ProjectBucketConfigOutput struct{ *pulumi.OutputState }

func (ProjectBucketConfigOutput) ElementType

func (ProjectBucketConfigOutput) ElementType() reflect.Type

func (ProjectBucketConfigOutput) ToProjectBucketConfigOutput

func (o ProjectBucketConfigOutput) ToProjectBucketConfigOutput() ProjectBucketConfigOutput

func (ProjectBucketConfigOutput) ToProjectBucketConfigOutputWithContext

func (o ProjectBucketConfigOutput) ToProjectBucketConfigOutputWithContext(ctx context.Context) ProjectBucketConfigOutput

func (ProjectBucketConfigOutput) ToProjectBucketConfigPtrOutput

func (o ProjectBucketConfigOutput) ToProjectBucketConfigPtrOutput() ProjectBucketConfigPtrOutput

func (ProjectBucketConfigOutput) ToProjectBucketConfigPtrOutputWithContext

func (o ProjectBucketConfigOutput) ToProjectBucketConfigPtrOutputWithContext(ctx context.Context) ProjectBucketConfigPtrOutput

type ProjectBucketConfigPtrInput

type ProjectBucketConfigPtrInput interface {
	pulumi.Input

	ToProjectBucketConfigPtrOutput() ProjectBucketConfigPtrOutput
	ToProjectBucketConfigPtrOutputWithContext(ctx context.Context) ProjectBucketConfigPtrOutput
}

type ProjectBucketConfigPtrOutput

type ProjectBucketConfigPtrOutput struct{ *pulumi.OutputState }

func (ProjectBucketConfigPtrOutput) Elem added in v5.21.0

func (ProjectBucketConfigPtrOutput) ElementType

func (ProjectBucketConfigPtrOutput) ToProjectBucketConfigPtrOutput

func (o ProjectBucketConfigPtrOutput) ToProjectBucketConfigPtrOutput() ProjectBucketConfigPtrOutput

func (ProjectBucketConfigPtrOutput) ToProjectBucketConfigPtrOutputWithContext

func (o ProjectBucketConfigPtrOutput) ToProjectBucketConfigPtrOutputWithContext(ctx context.Context) ProjectBucketConfigPtrOutput

type ProjectBucketConfigState

type ProjectBucketConfigState struct {
	// The name of the logging bucket. Logging automatically creates two log buckets: `_Required` and `_Default`.
	BucketId pulumi.StringPtrInput
	// Describes this bucket.
	Description pulumi.StringPtrInput
	// The bucket's lifecycle such as active or deleted. See [LifecycleState](https://cloud.google.com/logging/docs/reference/v2/rest/v2/billingAccounts.buckets#LogBucket.LifecycleState).
	LifecycleState pulumi.StringPtrInput
	// The location of the bucket.
	Location pulumi.StringPtrInput
	// The resource name of the bucket. For example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id"
	Name pulumi.StringPtrInput
	// The parent resource that contains the logging bucket.
	Project pulumi.StringPtrInput
	// Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used.
	RetentionDays pulumi.IntPtrInput
}

func (ProjectBucketConfigState) ElementType

func (ProjectBucketConfigState) ElementType() reflect.Type

type ProjectExclusion

type ProjectExclusion struct {
	pulumi.CustomResourceState

	// A human-readable description.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringOutput `pulumi:"filter"`
	// The name of the logging exclusion.
	Name pulumi.StringOutput `pulumi:"name"`
	// The project to create the exclusion in. If omitted, the project associated with the provider is
	// used.
	Project pulumi.StringOutput `pulumi:"project"`
}

Manages a project-level logging exclusion. For more information see:

* [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.exclusions) * How-to Guides

> You can specify exclusions for log sinks created by the provider by using the exclusions field of `logging.ProjectSink`

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/logging"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := logging.NewProjectExclusion(ctx, "my_exclusion", &logging.ProjectExclusionArgs{
			Description: pulumi.String("Exclude GCE instance debug logs"),
			Filter:      pulumi.String("resource.type = gce_instance AND severity <= DEBUG"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Project-level logging exclusions can be imported using their URI, e.g.

```sh

$ pulumi import gcp:logging/projectExclusion:ProjectExclusion my_exclusion projects/my-project/exclusions/my-exclusion

```

func GetProjectExclusion

func GetProjectExclusion(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProjectExclusionState, opts ...pulumi.ResourceOption) (*ProjectExclusion, error)

GetProjectExclusion gets an existing ProjectExclusion resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProjectExclusion

func NewProjectExclusion(ctx *pulumi.Context,
	name string, args *ProjectExclusionArgs, opts ...pulumi.ResourceOption) (*ProjectExclusion, error)

NewProjectExclusion registers a new resource with the given unique name, arguments, and options.

func (*ProjectExclusion) ElementType

func (*ProjectExclusion) ElementType() reflect.Type

func (*ProjectExclusion) ToProjectExclusionOutput

func (i *ProjectExclusion) ToProjectExclusionOutput() ProjectExclusionOutput

func (*ProjectExclusion) ToProjectExclusionOutputWithContext

func (i *ProjectExclusion) ToProjectExclusionOutputWithContext(ctx context.Context) ProjectExclusionOutput

func (*ProjectExclusion) ToProjectExclusionPtrOutput

func (i *ProjectExclusion) ToProjectExclusionPtrOutput() ProjectExclusionPtrOutput

func (*ProjectExclusion) ToProjectExclusionPtrOutputWithContext

func (i *ProjectExclusion) ToProjectExclusionPtrOutputWithContext(ctx context.Context) ProjectExclusionPtrOutput

type ProjectExclusionArgs

type ProjectExclusionArgs struct {
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
	// The project to create the exclusion in. If omitted, the project associated with the provider is
	// used.
	Project pulumi.StringPtrInput
}

The set of arguments for constructing a ProjectExclusion resource.

func (ProjectExclusionArgs) ElementType

func (ProjectExclusionArgs) ElementType() reflect.Type

type ProjectExclusionArray

type ProjectExclusionArray []ProjectExclusionInput

func (ProjectExclusionArray) ElementType

func (ProjectExclusionArray) ElementType() reflect.Type

func (ProjectExclusionArray) ToProjectExclusionArrayOutput

func (i ProjectExclusionArray) ToProjectExclusionArrayOutput() ProjectExclusionArrayOutput

func (ProjectExclusionArray) ToProjectExclusionArrayOutputWithContext

func (i ProjectExclusionArray) ToProjectExclusionArrayOutputWithContext(ctx context.Context) ProjectExclusionArrayOutput

type ProjectExclusionArrayInput

type ProjectExclusionArrayInput interface {
	pulumi.Input

	ToProjectExclusionArrayOutput() ProjectExclusionArrayOutput
	ToProjectExclusionArrayOutputWithContext(context.Context) ProjectExclusionArrayOutput
}

ProjectExclusionArrayInput is an input type that accepts ProjectExclusionArray and ProjectExclusionArrayOutput values. You can construct a concrete instance of `ProjectExclusionArrayInput` via:

ProjectExclusionArray{ ProjectExclusionArgs{...} }

type ProjectExclusionArrayOutput

type ProjectExclusionArrayOutput struct{ *pulumi.OutputState }

func (ProjectExclusionArrayOutput) ElementType

func (ProjectExclusionArrayOutput) Index

func (ProjectExclusionArrayOutput) ToProjectExclusionArrayOutput

func (o ProjectExclusionArrayOutput) ToProjectExclusionArrayOutput() ProjectExclusionArrayOutput

func (ProjectExclusionArrayOutput) ToProjectExclusionArrayOutputWithContext

func (o ProjectExclusionArrayOutput) ToProjectExclusionArrayOutputWithContext(ctx context.Context) ProjectExclusionArrayOutput

type ProjectExclusionInput

type ProjectExclusionInput interface {
	pulumi.Input

	ToProjectExclusionOutput() ProjectExclusionOutput
	ToProjectExclusionOutputWithContext(ctx context.Context) ProjectExclusionOutput
}

type ProjectExclusionMap

type ProjectExclusionMap map[string]ProjectExclusionInput

func (ProjectExclusionMap) ElementType

func (ProjectExclusionMap) ElementType() reflect.Type

func (ProjectExclusionMap) ToProjectExclusionMapOutput

func (i ProjectExclusionMap) ToProjectExclusionMapOutput() ProjectExclusionMapOutput

func (ProjectExclusionMap) ToProjectExclusionMapOutputWithContext

func (i ProjectExclusionMap) ToProjectExclusionMapOutputWithContext(ctx context.Context) ProjectExclusionMapOutput

type ProjectExclusionMapInput

type ProjectExclusionMapInput interface {
	pulumi.Input

	ToProjectExclusionMapOutput() ProjectExclusionMapOutput
	ToProjectExclusionMapOutputWithContext(context.Context) ProjectExclusionMapOutput
}

ProjectExclusionMapInput is an input type that accepts ProjectExclusionMap and ProjectExclusionMapOutput values. You can construct a concrete instance of `ProjectExclusionMapInput` via:

ProjectExclusionMap{ "key": ProjectExclusionArgs{...} }

type ProjectExclusionMapOutput

type ProjectExclusionMapOutput struct{ *pulumi.OutputState }

func (ProjectExclusionMapOutput) ElementType

func (ProjectExclusionMapOutput) ElementType() reflect.Type

func (ProjectExclusionMapOutput) MapIndex

func (ProjectExclusionMapOutput) ToProjectExclusionMapOutput

func (o ProjectExclusionMapOutput) ToProjectExclusionMapOutput() ProjectExclusionMapOutput

func (ProjectExclusionMapOutput) ToProjectExclusionMapOutputWithContext

func (o ProjectExclusionMapOutput) ToProjectExclusionMapOutputWithContext(ctx context.Context) ProjectExclusionMapOutput

type ProjectExclusionOutput

type ProjectExclusionOutput struct{ *pulumi.OutputState }

func (ProjectExclusionOutput) ElementType

func (ProjectExclusionOutput) ElementType() reflect.Type

func (ProjectExclusionOutput) ToProjectExclusionOutput

func (o ProjectExclusionOutput) ToProjectExclusionOutput() ProjectExclusionOutput

func (ProjectExclusionOutput) ToProjectExclusionOutputWithContext

func (o ProjectExclusionOutput) ToProjectExclusionOutputWithContext(ctx context.Context) ProjectExclusionOutput

func (ProjectExclusionOutput) ToProjectExclusionPtrOutput

func (o ProjectExclusionOutput) ToProjectExclusionPtrOutput() ProjectExclusionPtrOutput

func (ProjectExclusionOutput) ToProjectExclusionPtrOutputWithContext

func (o ProjectExclusionOutput) ToProjectExclusionPtrOutputWithContext(ctx context.Context) ProjectExclusionPtrOutput

type ProjectExclusionPtrInput

type ProjectExclusionPtrInput interface {
	pulumi.Input

	ToProjectExclusionPtrOutput() ProjectExclusionPtrOutput
	ToProjectExclusionPtrOutputWithContext(ctx context.Context) ProjectExclusionPtrOutput
}

type ProjectExclusionPtrOutput

type ProjectExclusionPtrOutput struct{ *pulumi.OutputState }

func (ProjectExclusionPtrOutput) Elem added in v5.21.0

func (ProjectExclusionPtrOutput) ElementType

func (ProjectExclusionPtrOutput) ElementType() reflect.Type

func (ProjectExclusionPtrOutput) ToProjectExclusionPtrOutput

func (o ProjectExclusionPtrOutput) ToProjectExclusionPtrOutput() ProjectExclusionPtrOutput

func (ProjectExclusionPtrOutput) ToProjectExclusionPtrOutputWithContext

func (o ProjectExclusionPtrOutput) ToProjectExclusionPtrOutputWithContext(ctx context.Context) ProjectExclusionPtrOutput

type ProjectExclusionState

type ProjectExclusionState struct {
	// A human-readable description.
	Description pulumi.StringPtrInput
	// Whether this exclusion rule should be disabled or not. This defaults to
	// false.
	Disabled pulumi.BoolPtrInput
	// The filter to apply when excluding logs. Only log entries that match the filter are excluded.
	// See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// The name of the logging exclusion.
	Name pulumi.StringPtrInput
	// The project to create the exclusion in. If omitted, the project associated with the provider is
	// used.
	Project pulumi.StringPtrInput
}

func (ProjectExclusionState) ElementType

func (ProjectExclusionState) ElementType() reflect.Type

type ProjectSink

type ProjectSink struct {
	pulumi.CustomResourceState

	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions ProjectSinkBigqueryOptionsOutput `pulumi:"bigqueryOptions"`
	// A description of this exclusion.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket . Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringOutput `pulumi:"destination"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrOutput `pulumi:"disabled"`
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions ProjectSinkExclusionArrayOutput `pulumi:"exclusions"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrOutput `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringOutput `pulumi:"name"`
	// The ID of the project to create the sink in. If omitted, the project associated with the provider is
	// used.
	Project pulumi.StringOutput `pulumi:"project"`
	// Whether or not to create a unique identity associated with this sink. If `false`
	// (the default), then the `writerIdentity` used is `serviceAccount:cloud-logs@system.gserviceaccount.com`. If `true`,
	// then a unique service account is created and used for this sink. If you wish to publish logs across projects or utilize
	// `bigqueryOptions`, you must set `uniqueWriterIdentity` to true.
	UniqueWriterIdentity pulumi.BoolPtrOutput `pulumi:"uniqueWriterIdentity"`
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringOutput `pulumi:"writerIdentity"`
}

## Import

Project-level logging sinks can be imported using their URI, e.g.

```sh

$ pulumi import gcp:logging/projectSink:ProjectSink my_sink projects/my-project/sinks/my-sink

```

func GetProjectSink

func GetProjectSink(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProjectSinkState, opts ...pulumi.ResourceOption) (*ProjectSink, error)

GetProjectSink gets an existing ProjectSink resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProjectSink

func NewProjectSink(ctx *pulumi.Context,
	name string, args *ProjectSinkArgs, opts ...pulumi.ResourceOption) (*ProjectSink, error)

NewProjectSink registers a new resource with the given unique name, arguments, and options.

func (*ProjectSink) ElementType

func (*ProjectSink) ElementType() reflect.Type

func (*ProjectSink) ToProjectSinkOutput

func (i *ProjectSink) ToProjectSinkOutput() ProjectSinkOutput

func (*ProjectSink) ToProjectSinkOutputWithContext

func (i *ProjectSink) ToProjectSinkOutputWithContext(ctx context.Context) ProjectSinkOutput

func (*ProjectSink) ToProjectSinkPtrOutput

func (i *ProjectSink) ToProjectSinkPtrOutput() ProjectSinkPtrOutput

func (*ProjectSink) ToProjectSinkPtrOutputWithContext

func (i *ProjectSink) ToProjectSinkPtrOutputWithContext(ctx context.Context) ProjectSinkPtrOutput

type ProjectSinkArgs

type ProjectSinkArgs struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions ProjectSinkBigqueryOptionsPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket . Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions ProjectSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
	// The ID of the project to create the sink in. If omitted, the project associated with the provider is
	// used.
	Project pulumi.StringPtrInput
	// Whether or not to create a unique identity associated with this sink. If `false`
	// (the default), then the `writerIdentity` used is `serviceAccount:cloud-logs@system.gserviceaccount.com`. If `true`,
	// then a unique service account is created and used for this sink. If you wish to publish logs across projects or utilize
	// `bigqueryOptions`, you must set `uniqueWriterIdentity` to true.
	UniqueWriterIdentity pulumi.BoolPtrInput
}

The set of arguments for constructing a ProjectSink resource.

func (ProjectSinkArgs) ElementType

func (ProjectSinkArgs) ElementType() reflect.Type

type ProjectSinkArray

type ProjectSinkArray []ProjectSinkInput

func (ProjectSinkArray) ElementType

func (ProjectSinkArray) ElementType() reflect.Type

func (ProjectSinkArray) ToProjectSinkArrayOutput

func (i ProjectSinkArray) ToProjectSinkArrayOutput() ProjectSinkArrayOutput

func (ProjectSinkArray) ToProjectSinkArrayOutputWithContext

func (i ProjectSinkArray) ToProjectSinkArrayOutputWithContext(ctx context.Context) ProjectSinkArrayOutput

type ProjectSinkArrayInput

type ProjectSinkArrayInput interface {
	pulumi.Input

	ToProjectSinkArrayOutput() ProjectSinkArrayOutput
	ToProjectSinkArrayOutputWithContext(context.Context) ProjectSinkArrayOutput
}

ProjectSinkArrayInput is an input type that accepts ProjectSinkArray and ProjectSinkArrayOutput values. You can construct a concrete instance of `ProjectSinkArrayInput` via:

ProjectSinkArray{ ProjectSinkArgs{...} }

type ProjectSinkArrayOutput

type ProjectSinkArrayOutput struct{ *pulumi.OutputState }

func (ProjectSinkArrayOutput) ElementType

func (ProjectSinkArrayOutput) ElementType() reflect.Type

func (ProjectSinkArrayOutput) Index

func (ProjectSinkArrayOutput) ToProjectSinkArrayOutput

func (o ProjectSinkArrayOutput) ToProjectSinkArrayOutput() ProjectSinkArrayOutput

func (ProjectSinkArrayOutput) ToProjectSinkArrayOutputWithContext

func (o ProjectSinkArrayOutput) ToProjectSinkArrayOutputWithContext(ctx context.Context) ProjectSinkArrayOutput

type ProjectSinkBigqueryOptions

type ProjectSinkBigqueryOptions struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables bool `pulumi:"usePartitionedTables"`
}

type ProjectSinkBigqueryOptionsArgs

type ProjectSinkBigqueryOptionsArgs struct {
	// Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
	// By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
	// tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables)
	// has to be used instead. In both cases, tables are sharded based on UTC timezone.
	UsePartitionedTables pulumi.BoolInput `pulumi:"usePartitionedTables"`
}

func (ProjectSinkBigqueryOptionsArgs) ElementType

func (ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsOutput

func (i ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsOutput() ProjectSinkBigqueryOptionsOutput

func (ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsOutputWithContext

func (i ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsOutputWithContext(ctx context.Context) ProjectSinkBigqueryOptionsOutput

func (ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsPtrOutput

func (i ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsPtrOutput() ProjectSinkBigqueryOptionsPtrOutput

func (ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsPtrOutputWithContext

func (i ProjectSinkBigqueryOptionsArgs) ToProjectSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) ProjectSinkBigqueryOptionsPtrOutput

type ProjectSinkBigqueryOptionsInput

type ProjectSinkBigqueryOptionsInput interface {
	pulumi.Input

	ToProjectSinkBigqueryOptionsOutput() ProjectSinkBigqueryOptionsOutput
	ToProjectSinkBigqueryOptionsOutputWithContext(context.Context) ProjectSinkBigqueryOptionsOutput
}

ProjectSinkBigqueryOptionsInput is an input type that accepts ProjectSinkBigqueryOptionsArgs and ProjectSinkBigqueryOptionsOutput values. You can construct a concrete instance of `ProjectSinkBigqueryOptionsInput` via:

ProjectSinkBigqueryOptionsArgs{...}

type ProjectSinkBigqueryOptionsOutput

type ProjectSinkBigqueryOptionsOutput struct{ *pulumi.OutputState }

func (ProjectSinkBigqueryOptionsOutput) ElementType

func (ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsOutput

func (o ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsOutput() ProjectSinkBigqueryOptionsOutput

func (ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsOutputWithContext

func (o ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsOutputWithContext(ctx context.Context) ProjectSinkBigqueryOptionsOutput

func (ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsPtrOutput

func (o ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsPtrOutput() ProjectSinkBigqueryOptionsPtrOutput

func (ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsPtrOutputWithContext

func (o ProjectSinkBigqueryOptionsOutput) ToProjectSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) ProjectSinkBigqueryOptionsPtrOutput

func (ProjectSinkBigqueryOptionsOutput) UsePartitionedTables

func (o ProjectSinkBigqueryOptionsOutput) UsePartitionedTables() pulumi.BoolOutput

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type ProjectSinkBigqueryOptionsPtrInput

type ProjectSinkBigqueryOptionsPtrInput interface {
	pulumi.Input

	ToProjectSinkBigqueryOptionsPtrOutput() ProjectSinkBigqueryOptionsPtrOutput
	ToProjectSinkBigqueryOptionsPtrOutputWithContext(context.Context) ProjectSinkBigqueryOptionsPtrOutput
}

ProjectSinkBigqueryOptionsPtrInput is an input type that accepts ProjectSinkBigqueryOptionsArgs, ProjectSinkBigqueryOptionsPtr and ProjectSinkBigqueryOptionsPtrOutput values. You can construct a concrete instance of `ProjectSinkBigqueryOptionsPtrInput` via:

        ProjectSinkBigqueryOptionsArgs{...}

or:

        nil

type ProjectSinkBigqueryOptionsPtrOutput

type ProjectSinkBigqueryOptionsPtrOutput struct{ *pulumi.OutputState }

func (ProjectSinkBigqueryOptionsPtrOutput) Elem

func (ProjectSinkBigqueryOptionsPtrOutput) ElementType

func (ProjectSinkBigqueryOptionsPtrOutput) ToProjectSinkBigqueryOptionsPtrOutput

func (o ProjectSinkBigqueryOptionsPtrOutput) ToProjectSinkBigqueryOptionsPtrOutput() ProjectSinkBigqueryOptionsPtrOutput

func (ProjectSinkBigqueryOptionsPtrOutput) ToProjectSinkBigqueryOptionsPtrOutputWithContext

func (o ProjectSinkBigqueryOptionsPtrOutput) ToProjectSinkBigqueryOptionsPtrOutputWithContext(ctx context.Context) ProjectSinkBigqueryOptionsPtrOutput

func (ProjectSinkBigqueryOptionsPtrOutput) UsePartitionedTables

func (o ProjectSinkBigqueryOptionsPtrOutput) UsePartitionedTables() pulumi.BoolPtrOutput

Whether to use [BigQuery's partition tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging creates dated tables based on the log entries' timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and [special query syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead. In both cases, tables are sharded based on UTC timezone.

type ProjectSinkExclusion

type ProjectSinkExclusion struct {
	// A description of this exclusion.
	Description *string `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled *bool `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter string `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name string `pulumi:"name"`
}

type ProjectSinkExclusionArgs

type ProjectSinkExclusionArgs struct {
	// A description of this exclusion.
	Description pulumi.StringPtrInput `pulumi:"description"`
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput `pulumi:"disabled"`
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringInput `pulumi:"filter"`
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringInput `pulumi:"name"`
}

func (ProjectSinkExclusionArgs) ElementType

func (ProjectSinkExclusionArgs) ElementType() reflect.Type

func (ProjectSinkExclusionArgs) ToProjectSinkExclusionOutput

func (i ProjectSinkExclusionArgs) ToProjectSinkExclusionOutput() ProjectSinkExclusionOutput

func (ProjectSinkExclusionArgs) ToProjectSinkExclusionOutputWithContext

func (i ProjectSinkExclusionArgs) ToProjectSinkExclusionOutputWithContext(ctx context.Context) ProjectSinkExclusionOutput

type ProjectSinkExclusionArray

type ProjectSinkExclusionArray []ProjectSinkExclusionInput

func (ProjectSinkExclusionArray) ElementType

func (ProjectSinkExclusionArray) ElementType() reflect.Type

func (ProjectSinkExclusionArray) ToProjectSinkExclusionArrayOutput

func (i ProjectSinkExclusionArray) ToProjectSinkExclusionArrayOutput() ProjectSinkExclusionArrayOutput

func (ProjectSinkExclusionArray) ToProjectSinkExclusionArrayOutputWithContext

func (i ProjectSinkExclusionArray) ToProjectSinkExclusionArrayOutputWithContext(ctx context.Context) ProjectSinkExclusionArrayOutput

type ProjectSinkExclusionArrayInput

type ProjectSinkExclusionArrayInput interface {
	pulumi.Input

	ToProjectSinkExclusionArrayOutput() ProjectSinkExclusionArrayOutput
	ToProjectSinkExclusionArrayOutputWithContext(context.Context) ProjectSinkExclusionArrayOutput
}

ProjectSinkExclusionArrayInput is an input type that accepts ProjectSinkExclusionArray and ProjectSinkExclusionArrayOutput values. You can construct a concrete instance of `ProjectSinkExclusionArrayInput` via:

ProjectSinkExclusionArray{ ProjectSinkExclusionArgs{...} }

type ProjectSinkExclusionArrayOutput

type ProjectSinkExclusionArrayOutput struct{ *pulumi.OutputState }

func (ProjectSinkExclusionArrayOutput) ElementType

func (ProjectSinkExclusionArrayOutput) Index

func (ProjectSinkExclusionArrayOutput) ToProjectSinkExclusionArrayOutput

func (o ProjectSinkExclusionArrayOutput) ToProjectSinkExclusionArrayOutput() ProjectSinkExclusionArrayOutput

func (ProjectSinkExclusionArrayOutput) ToProjectSinkExclusionArrayOutputWithContext

func (o ProjectSinkExclusionArrayOutput) ToProjectSinkExclusionArrayOutputWithContext(ctx context.Context) ProjectSinkExclusionArrayOutput

type ProjectSinkExclusionInput

type ProjectSinkExclusionInput interface {
	pulumi.Input

	ToProjectSinkExclusionOutput() ProjectSinkExclusionOutput
	ToProjectSinkExclusionOutputWithContext(context.Context) ProjectSinkExclusionOutput
}

ProjectSinkExclusionInput is an input type that accepts ProjectSinkExclusionArgs and ProjectSinkExclusionOutput values. You can construct a concrete instance of `ProjectSinkExclusionInput` via:

ProjectSinkExclusionArgs{...}

type ProjectSinkExclusionOutput

type ProjectSinkExclusionOutput struct{ *pulumi.OutputState }

func (ProjectSinkExclusionOutput) Description

A description of this exclusion.

func (ProjectSinkExclusionOutput) Disabled

If set to True, then this exclusion is disabled and it does not exclude any log entries.

func (ProjectSinkExclusionOutput) ElementType

func (ProjectSinkExclusionOutput) ElementType() reflect.Type

func (ProjectSinkExclusionOutput) Filter

An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to write a filter.

func (ProjectSinkExclusionOutput) Name

A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.

func (ProjectSinkExclusionOutput) ToProjectSinkExclusionOutput

func (o ProjectSinkExclusionOutput) ToProjectSinkExclusionOutput() ProjectSinkExclusionOutput

func (ProjectSinkExclusionOutput) ToProjectSinkExclusionOutputWithContext

func (o ProjectSinkExclusionOutput) ToProjectSinkExclusionOutputWithContext(ctx context.Context) ProjectSinkExclusionOutput

type ProjectSinkInput

type ProjectSinkInput interface {
	pulumi.Input

	ToProjectSinkOutput() ProjectSinkOutput
	ToProjectSinkOutputWithContext(ctx context.Context) ProjectSinkOutput
}

type ProjectSinkMap

type ProjectSinkMap map[string]ProjectSinkInput

func (ProjectSinkMap) ElementType

func (ProjectSinkMap) ElementType() reflect.Type

func (ProjectSinkMap) ToProjectSinkMapOutput

func (i ProjectSinkMap) ToProjectSinkMapOutput() ProjectSinkMapOutput

func (ProjectSinkMap) ToProjectSinkMapOutputWithContext

func (i ProjectSinkMap) ToProjectSinkMapOutputWithContext(ctx context.Context) ProjectSinkMapOutput

type ProjectSinkMapInput

type ProjectSinkMapInput interface {
	pulumi.Input

	ToProjectSinkMapOutput() ProjectSinkMapOutput
	ToProjectSinkMapOutputWithContext(context.Context) ProjectSinkMapOutput
}

ProjectSinkMapInput is an input type that accepts ProjectSinkMap and ProjectSinkMapOutput values. You can construct a concrete instance of `ProjectSinkMapInput` via:

ProjectSinkMap{ "key": ProjectSinkArgs{...} }

type ProjectSinkMapOutput

type ProjectSinkMapOutput struct{ *pulumi.OutputState }

func (ProjectSinkMapOutput) ElementType

func (ProjectSinkMapOutput) ElementType() reflect.Type

func (ProjectSinkMapOutput) MapIndex

func (ProjectSinkMapOutput) ToProjectSinkMapOutput

func (o ProjectSinkMapOutput) ToProjectSinkMapOutput() ProjectSinkMapOutput

func (ProjectSinkMapOutput) ToProjectSinkMapOutputWithContext

func (o ProjectSinkMapOutput) ToProjectSinkMapOutputWithContext(ctx context.Context) ProjectSinkMapOutput

type ProjectSinkOutput

type ProjectSinkOutput struct{ *pulumi.OutputState }

func (ProjectSinkOutput) ElementType

func (ProjectSinkOutput) ElementType() reflect.Type

func (ProjectSinkOutput) ToProjectSinkOutput

func (o ProjectSinkOutput) ToProjectSinkOutput() ProjectSinkOutput

func (ProjectSinkOutput) ToProjectSinkOutputWithContext

func (o ProjectSinkOutput) ToProjectSinkOutputWithContext(ctx context.Context) ProjectSinkOutput

func (ProjectSinkOutput) ToProjectSinkPtrOutput

func (o ProjectSinkOutput) ToProjectSinkPtrOutput() ProjectSinkPtrOutput

func (ProjectSinkOutput) ToProjectSinkPtrOutputWithContext

func (o ProjectSinkOutput) ToProjectSinkPtrOutputWithContext(ctx context.Context) ProjectSinkPtrOutput

type ProjectSinkPtrInput

type ProjectSinkPtrInput interface {
	pulumi.Input

	ToProjectSinkPtrOutput() ProjectSinkPtrOutput
	ToProjectSinkPtrOutputWithContext(ctx context.Context) ProjectSinkPtrOutput
}

type ProjectSinkPtrOutput

type ProjectSinkPtrOutput struct{ *pulumi.OutputState }

func (ProjectSinkPtrOutput) Elem added in v5.21.0

func (ProjectSinkPtrOutput) ElementType

func (ProjectSinkPtrOutput) ElementType() reflect.Type

func (ProjectSinkPtrOutput) ToProjectSinkPtrOutput

func (o ProjectSinkPtrOutput) ToProjectSinkPtrOutput() ProjectSinkPtrOutput

func (ProjectSinkPtrOutput) ToProjectSinkPtrOutputWithContext

func (o ProjectSinkPtrOutput) ToProjectSinkPtrOutputWithContext(ctx context.Context) ProjectSinkPtrOutput

type ProjectSinkState

type ProjectSinkState struct {
	// Options that affect sinks exporting data to BigQuery. Structure documented below.
	BigqueryOptions ProjectSinkBigqueryOptionsPtrInput
	// A description of this exclusion.
	Description pulumi.StringPtrInput
	// The destination of the sink (or, in other words, where logs are written to). Can be a
	// Cloud Storage bucket, a PubSub topic, a BigQuery dataset or a Cloud Logging bucket . Examples:
	// “`go
	// package main
	//
	// import (
	// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	// )
	//
	// func main() {
	// 	pulumi.Run(func(ctx *pulumi.Context) error {
	// 		return nil
	// 	})
	// }
	// “`
	// The writer associated with the sink must have access to write to the above resource.
	Destination pulumi.StringPtrInput
	// If set to True, then this exclusion is disabled and it does not exclude any log entries.
	Disabled pulumi.BoolPtrInput
	// Log entries that match any of the exclusion filters will not be exported. If a log entry is matched by both filter and one of exclusionFilters it will not be exported.  Can be repeated multiple times for multiple exclusions. Structure is documented below.
	Exclusions ProjectSinkExclusionArrayInput
	// An advanced logs filter that matches the log entries to be excluded. By using the sample function, you can exclude less than 100% of the matching log entries. See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced_filters) for information on how to
	// write a filter.
	Filter pulumi.StringPtrInput
	// A client-assigned identifier, such as `load-balancer-exclusion`. Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
	Name pulumi.StringPtrInput
	// The ID of the project to create the sink in. If omitted, the project associated with the provider is
	// used.
	Project pulumi.StringPtrInput
	// Whether or not to create a unique identity associated with this sink. If `false`
	// (the default), then the `writerIdentity` used is `serviceAccount:cloud-logs@system.gserviceaccount.com`. If `true`,
	// then a unique service account is created and used for this sink. If you wish to publish logs across projects or utilize
	// `bigqueryOptions`, you must set `uniqueWriterIdentity` to true.
	UniqueWriterIdentity pulumi.BoolPtrInput
	// The identity associated with this sink. This identity must be granted write access to the
	// configured `destination`.
	WriterIdentity pulumi.StringPtrInput
}

func (ProjectSinkState) ElementType

func (ProjectSinkState) ElementType() reflect.Type

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL