cloudwatchlogs

package
v1.5.7-0...-12ce9fe Latest Latest
Warning

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

Go to latest
Published: Nov 16, 2016 License: Apache-2.0 Imports: 8 Imported by: 0

Documentation

Overview

Package cloudwatchlogs provides a client for Amazon CloudWatch Logs.

Index

Examples

Constants

View Source
const (
	// ExportTaskStatusCodeCancelled is a ExportTaskStatusCode enum value
	ExportTaskStatusCodeCancelled = "CANCELLED"

	// ExportTaskStatusCodeCompleted is a ExportTaskStatusCode enum value
	ExportTaskStatusCodeCompleted = "COMPLETED"

	// ExportTaskStatusCodeFailed is a ExportTaskStatusCode enum value
	ExportTaskStatusCodeFailed = "FAILED"

	// ExportTaskStatusCodePending is a ExportTaskStatusCode enum value
	ExportTaskStatusCodePending = "PENDING"

	// ExportTaskStatusCodePendingCancel is a ExportTaskStatusCode enum value
	ExportTaskStatusCodePendingCancel = "PENDING_CANCEL"

	// ExportTaskStatusCodeRunning is a ExportTaskStatusCode enum value
	ExportTaskStatusCodeRunning = "RUNNING"
)
View Source
const (
	// OrderByLogStreamName is a OrderBy enum value
	OrderByLogStreamName = "LogStreamName"

	// OrderByLastEventTime is a OrderBy enum value
	OrderByLastEventTime = "LastEventTime"
)
View Source
const ServiceName = "logs"

A ServiceName is the name of the service the client will make API calls to.

Variables

This section is empty.

Functions

This section is empty.

Types

type CancelExportTaskInput

type CancelExportTaskInput struct {

	// The ID of the export task.
	//
	// TaskId is a required field
	TaskId *string `locationName:"taskId" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CancelExportTaskInput) GoString

func (s CancelExportTaskInput) GoString() string

GoString returns the string representation

func (*CancelExportTaskInput) SetTaskId

SetTaskId sets the TaskId field's value.

func (CancelExportTaskInput) String

func (s CancelExportTaskInput) String() string

String returns the string representation

func (*CancelExportTaskInput) Validate

func (s *CancelExportTaskInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CancelExportTaskOutput

type CancelExportTaskOutput struct {
	// contains filtered or unexported fields
}

func (CancelExportTaskOutput) GoString

func (s CancelExportTaskOutput) GoString() string

GoString returns the string representation

func (CancelExportTaskOutput) String

func (s CancelExportTaskOutput) String() string

String returns the string representation

type CloudWatchLogs

type CloudWatchLogs struct {
	*client.Client
}

You can use Amazon CloudWatch Logs to monitor, store, and access your log files from EC2 instances, Amazon CloudTrail, or other sources. You can then retrieve the associated log data from CloudWatch Logs using the Amazon CloudWatch console, the CloudWatch Logs commands in the AWS CLI, the CloudWatch Logs API, or the CloudWatch Logs SDK.

You can use CloudWatch Logs to:

  • Monitor Logs from Amazon EC2 Instances in Real-time: You can use CloudWatch Logs to monitor applications and systems using log data. For example, CloudWatch Logs can track the number of errors that occur in your application logs and send you a notification whenever the rate of errors exceeds a threshold you specify. CloudWatch Logs uses your log data for monitoring; so, no code changes are required. For example, you can monitor application logs for specific literal terms (such as "NullReferenceException") or count the number of occurrences of a literal term at a particular position in log data (such as "404" status codes in an Apache access log). When the term you are searching for is found, CloudWatch Logs reports the data to a Amazon CloudWatch metric that you specify.

  • Monitor Amazon CloudTrail Logged Events: You can create alarms in Amazon CloudWatch and receive notifications of particular API activity as captured by CloudTrail and use the notification to perform troubleshooting.

  • Archive Log Data: You can use CloudWatch Logs to store your log data in highly durable storage. You can change the log retention setting so that any log events older than this setting are automatically deleted. The CloudWatch Logs agent makes it easy to quickly send both rotated and non-rotated log data off of a host and into the log service. You can then access the raw log data when you need it.

The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though.

func New

func New(p client.ConfigProvider, cfgs ...*aws.Config) *CloudWatchLogs

New creates a new instance of the CloudWatchLogs client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example:

// Create a CloudWatchLogs client from just a session.
svc := cloudwatchlogs.New(mySession)

// Create a CloudWatchLogs client with additional configuration
svc := cloudwatchlogs.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*CloudWatchLogs) CancelExportTask

func (c *CloudWatchLogs) CancelExportTask(input *CancelExportTaskInput) (*CancelExportTaskOutput, error)

CancelExportTask API operation for Amazon CloudWatch Logs.

Cancels the specified export task.

The task must be in the PENDING or RUNNING state.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation CancelExportTask for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • InvalidOperationException The operation is not valid on the specified resource.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.CancelExportTaskInput{
		TaskId: aws.String("ExportTaskId"), // Required
	}
	resp, err := svc.CancelExportTask(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) CancelExportTaskRequest

func (c *CloudWatchLogs) CancelExportTaskRequest(input *CancelExportTaskInput) (req *request.Request, output *CancelExportTaskOutput)

CancelExportTaskRequest generates a "aws/request.Request" representing the client's request for the CancelExportTask operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CancelExportTask for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CancelExportTask method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the CancelExportTaskRequest method.
req, resp := client.CancelExportTaskRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) CreateExportTask

func (c *CloudWatchLogs) CreateExportTask(input *CreateExportTaskInput) (*CreateExportTaskOutput, error)

CreateExportTask API operation for Amazon CloudWatch Logs.

Creates an export task, which allows you to efficiently export data from a log group to an Amazon S3 bucket.

This is an asynchronous call. If all the required information is provided, this operation initiates an export task and responds with the ID of the task. After the task has started, you can use DescribeExportTasks to get the status of the export task. Each account can only have one active (RUNNING or PENDING) export task at a time. To cancel an export task, use CancelExportTask.

You can export logs from multiple log groups or multiple time ranges to the same S3 bucket. To separate out log data for each export task, you can specify a prefix that will be used as the Amazon S3 key prefix for all exported objects.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation CreateExportTask for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • LimitExceededException You have reached the maximum number of resources that can be created.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

  • ResourceNotFoundException The specified resource does not exist.

  • ResourceAlreadyExistsException The specified resource already exists.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.CreateExportTaskInput{
		Destination:         aws.String("ExportDestinationBucket"), // Required
		From:                aws.Int64(1),                          // Required
		LogGroupName:        aws.String("LogGroupName"),            // Required
		To:                  aws.Int64(1),                          // Required
		DestinationPrefix:   aws.String("ExportDestinationPrefix"),
		LogStreamNamePrefix: aws.String("LogStreamName"),
		TaskName:            aws.String("ExportTaskName"),
	}
	resp, err := svc.CreateExportTask(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) CreateExportTaskRequest

func (c *CloudWatchLogs) CreateExportTaskRequest(input *CreateExportTaskInput) (req *request.Request, output *CreateExportTaskOutput)

CreateExportTaskRequest generates a "aws/request.Request" representing the client's request for the CreateExportTask operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreateExportTask for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateExportTask method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the CreateExportTaskRequest method.
req, resp := client.CreateExportTaskRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) CreateLogGroup

func (c *CloudWatchLogs) CreateLogGroup(input *CreateLogGroupInput) (*CreateLogGroupOutput, error)

CreateLogGroup API operation for Amazon CloudWatch Logs.

Creates a log group with the specified name.

You can create up to 5000 log groups per account.

You must use the following guidelines when naming a log group:

  • Log group names must be unique within a region for an AWS account.

  • Log group names can be between 1 and 512 characters long.

  • Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation CreateLogGroup for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceAlreadyExistsException The specified resource already exists.

  • LimitExceededException You have reached the maximum number of resources that can be created.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.CreateLogGroupInput{
		LogGroupName: aws.String("LogGroupName"), // Required
	}
	resp, err := svc.CreateLogGroup(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) CreateLogGroupRequest

func (c *CloudWatchLogs) CreateLogGroupRequest(input *CreateLogGroupInput) (req *request.Request, output *CreateLogGroupOutput)

CreateLogGroupRequest generates a "aws/request.Request" representing the client's request for the CreateLogGroup operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreateLogGroup for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateLogGroup method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the CreateLogGroupRequest method.
req, resp := client.CreateLogGroupRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) CreateLogStream

func (c *CloudWatchLogs) CreateLogStream(input *CreateLogStreamInput) (*CreateLogStreamOutput, error)

CreateLogStream API operation for Amazon CloudWatch Logs.

Creates a log stream for the specified log group.

There is no limit on the number of log streams that you can create for a log group.

You must use the following guidelines when naming a log stream:

  • Log stream names must be unique within the log group.

  • Log stream names can be between 1 and 512 characters long.

  • The ':' (colon) and '*' (asterisk) characters are not allowed.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation CreateLogStream for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceAlreadyExistsException The specified resource already exists.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.CreateLogStreamInput{
		LogGroupName:  aws.String("LogGroupName"),  // Required
		LogStreamName: aws.String("LogStreamName"), // Required
	}
	resp, err := svc.CreateLogStream(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) CreateLogStreamRequest

func (c *CloudWatchLogs) CreateLogStreamRequest(input *CreateLogStreamInput) (req *request.Request, output *CreateLogStreamOutput)

CreateLogStreamRequest generates a "aws/request.Request" representing the client's request for the CreateLogStream operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreateLogStream for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateLogStream method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the CreateLogStreamRequest method.
req, resp := client.CreateLogStreamRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DeleteDestination

func (c *CloudWatchLogs) DeleteDestination(input *DeleteDestinationInput) (*DeleteDestinationOutput, error)

DeleteDestination API operation for Amazon CloudWatch Logs.

Deletes the specified destination, and eventually disables all the subscription filters that publish to it. This operation does not delete the physical resource encapsulated by the destination.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DeleteDestination for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DeleteDestinationInput{
		DestinationName: aws.String("DestinationName"), // Required
	}
	resp, err := svc.DeleteDestination(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DeleteDestinationRequest

func (c *CloudWatchLogs) DeleteDestinationRequest(input *DeleteDestinationInput) (req *request.Request, output *DeleteDestinationOutput)

DeleteDestinationRequest generates a "aws/request.Request" representing the client's request for the DeleteDestination operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteDestination for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteDestination method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteDestinationRequest method.
req, resp := client.DeleteDestinationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DeleteLogGroup

func (c *CloudWatchLogs) DeleteLogGroup(input *DeleteLogGroupInput) (*DeleteLogGroupOutput, error)

DeleteLogGroup API operation for Amazon CloudWatch Logs.

Deletes the specified log group and permanently deletes all the archived log events associated with the log group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DeleteLogGroup for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DeleteLogGroupInput{
		LogGroupName: aws.String("LogGroupName"), // Required
	}
	resp, err := svc.DeleteLogGroup(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DeleteLogGroupRequest

func (c *CloudWatchLogs) DeleteLogGroupRequest(input *DeleteLogGroupInput) (req *request.Request, output *DeleteLogGroupOutput)

DeleteLogGroupRequest generates a "aws/request.Request" representing the client's request for the DeleteLogGroup operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteLogGroup for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteLogGroup method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteLogGroupRequest method.
req, resp := client.DeleteLogGroupRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DeleteLogStream

func (c *CloudWatchLogs) DeleteLogStream(input *DeleteLogStreamInput) (*DeleteLogStreamOutput, error)

DeleteLogStream API operation for Amazon CloudWatch Logs.

Deletes the specified log stream and permanently deletes all the archived log events associated with the log stream.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DeleteLogStream for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DeleteLogStreamInput{
		LogGroupName:  aws.String("LogGroupName"),  // Required
		LogStreamName: aws.String("LogStreamName"), // Required
	}
	resp, err := svc.DeleteLogStream(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DeleteLogStreamRequest

func (c *CloudWatchLogs) DeleteLogStreamRequest(input *DeleteLogStreamInput) (req *request.Request, output *DeleteLogStreamOutput)

DeleteLogStreamRequest generates a "aws/request.Request" representing the client's request for the DeleteLogStream operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteLogStream for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteLogStream method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteLogStreamRequest method.
req, resp := client.DeleteLogStreamRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DeleteMetricFilter

func (c *CloudWatchLogs) DeleteMetricFilter(input *DeleteMetricFilterInput) (*DeleteMetricFilterOutput, error)

DeleteMetricFilter API operation for Amazon CloudWatch Logs.

Deletes the specified metric filter.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DeleteMetricFilter for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DeleteMetricFilterInput{
		FilterName:   aws.String("FilterName"),   // Required
		LogGroupName: aws.String("LogGroupName"), // Required
	}
	resp, err := svc.DeleteMetricFilter(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DeleteMetricFilterRequest

func (c *CloudWatchLogs) DeleteMetricFilterRequest(input *DeleteMetricFilterInput) (req *request.Request, output *DeleteMetricFilterOutput)

DeleteMetricFilterRequest generates a "aws/request.Request" representing the client's request for the DeleteMetricFilter operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteMetricFilter for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteMetricFilter method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteMetricFilterRequest method.
req, resp := client.DeleteMetricFilterRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DeleteRetentionPolicy

func (c *CloudWatchLogs) DeleteRetentionPolicy(input *DeleteRetentionPolicyInput) (*DeleteRetentionPolicyOutput, error)

DeleteRetentionPolicy API operation for Amazon CloudWatch Logs.

Deletes the specified retention policy.

Log events do not expire if they belong to log groups without a retention policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DeleteRetentionPolicy for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DeleteRetentionPolicyInput{
		LogGroupName: aws.String("LogGroupName"), // Required
	}
	resp, err := svc.DeleteRetentionPolicy(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DeleteRetentionPolicyRequest

func (c *CloudWatchLogs) DeleteRetentionPolicyRequest(input *DeleteRetentionPolicyInput) (req *request.Request, output *DeleteRetentionPolicyOutput)

DeleteRetentionPolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteRetentionPolicy operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteRetentionPolicy for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteRetentionPolicy method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteRetentionPolicyRequest method.
req, resp := client.DeleteRetentionPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DeleteSubscriptionFilter

func (c *CloudWatchLogs) DeleteSubscriptionFilter(input *DeleteSubscriptionFilterInput) (*DeleteSubscriptionFilterOutput, error)

DeleteSubscriptionFilter API operation for Amazon CloudWatch Logs.

Deletes the specified subscription filter.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DeleteSubscriptionFilter for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DeleteSubscriptionFilterInput{
		FilterName:   aws.String("FilterName"),   // Required
		LogGroupName: aws.String("LogGroupName"), // Required
	}
	resp, err := svc.DeleteSubscriptionFilter(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DeleteSubscriptionFilterRequest

func (c *CloudWatchLogs) DeleteSubscriptionFilterRequest(input *DeleteSubscriptionFilterInput) (req *request.Request, output *DeleteSubscriptionFilterOutput)

DeleteSubscriptionFilterRequest generates a "aws/request.Request" representing the client's request for the DeleteSubscriptionFilter operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteSubscriptionFilter for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteSubscriptionFilter method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteSubscriptionFilterRequest method.
req, resp := client.DeleteSubscriptionFilterRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DescribeDestinations

func (c *CloudWatchLogs) DescribeDestinations(input *DescribeDestinationsInput) (*DescribeDestinationsOutput, error)

DescribeDestinations API operation for Amazon CloudWatch Logs.

Lists all your destinations. The results are ASCII-sorted by destination name.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DescribeDestinations for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DescribeDestinationsInput{
		DestinationNamePrefix: aws.String("DestinationName"),
		Limit:                 aws.Int64(1),
		NextToken:             aws.String("NextToken"),
	}
	resp, err := svc.DescribeDestinations(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DescribeDestinationsPages

func (c *CloudWatchLogs) DescribeDestinationsPages(input *DescribeDestinationsInput, fn func(p *DescribeDestinationsOutput, lastPage bool) (shouldContinue bool)) error

DescribeDestinationsPages iterates over the pages of a DescribeDestinations operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeDestinations method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeDestinations operation.
pageNum := 0
err := client.DescribeDestinationsPages(params,
    func(page *DescribeDestinationsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) DescribeDestinationsRequest

func (c *CloudWatchLogs) DescribeDestinationsRequest(input *DescribeDestinationsInput) (req *request.Request, output *DescribeDestinationsOutput)

DescribeDestinationsRequest generates a "aws/request.Request" representing the client's request for the DescribeDestinations operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeDestinations for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeDestinations method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DescribeDestinationsRequest method.
req, resp := client.DescribeDestinationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DescribeExportTasks

func (c *CloudWatchLogs) DescribeExportTasks(input *DescribeExportTasksInput) (*DescribeExportTasksOutput, error)

DescribeExportTasks API operation for Amazon CloudWatch Logs.

Lists the specified export tasks. You can list all your export tasks or filter the results based on task ID or task status.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DescribeExportTasks for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DescribeExportTasksInput{
		Limit:      aws.Int64(1),
		NextToken:  aws.String("NextToken"),
		StatusCode: aws.String("ExportTaskStatusCode"),
		TaskId:     aws.String("ExportTaskId"),
	}
	resp, err := svc.DescribeExportTasks(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DescribeExportTasksRequest

func (c *CloudWatchLogs) DescribeExportTasksRequest(input *DescribeExportTasksInput) (req *request.Request, output *DescribeExportTasksOutput)

DescribeExportTasksRequest generates a "aws/request.Request" representing the client's request for the DescribeExportTasks operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeExportTasks for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeExportTasks method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DescribeExportTasksRequest method.
req, resp := client.DescribeExportTasksRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DescribeLogGroups

func (c *CloudWatchLogs) DescribeLogGroups(input *DescribeLogGroupsInput) (*DescribeLogGroupsOutput, error)

DescribeLogGroups API operation for Amazon CloudWatch Logs.

Lists the specified log groups. You can list all your log groups or filter the results by prefix. The results are ASCII-sorted by log group name.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DescribeLogGroups for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DescribeLogGroupsInput{
		Limit:              aws.Int64(1),
		LogGroupNamePrefix: aws.String("LogGroupName"),
		NextToken:          aws.String("NextToken"),
	}
	resp, err := svc.DescribeLogGroups(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DescribeLogGroupsPages

func (c *CloudWatchLogs) DescribeLogGroupsPages(input *DescribeLogGroupsInput, fn func(p *DescribeLogGroupsOutput, lastPage bool) (shouldContinue bool)) error

DescribeLogGroupsPages iterates over the pages of a DescribeLogGroups operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeLogGroups method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeLogGroups operation.
pageNum := 0
err := client.DescribeLogGroupsPages(params,
    func(page *DescribeLogGroupsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) DescribeLogGroupsRequest

func (c *CloudWatchLogs) DescribeLogGroupsRequest(input *DescribeLogGroupsInput) (req *request.Request, output *DescribeLogGroupsOutput)

DescribeLogGroupsRequest generates a "aws/request.Request" representing the client's request for the DescribeLogGroups operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeLogGroups for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeLogGroups method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DescribeLogGroupsRequest method.
req, resp := client.DescribeLogGroupsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DescribeLogStreams

func (c *CloudWatchLogs) DescribeLogStreams(input *DescribeLogStreamsInput) (*DescribeLogStreamsOutput, error)

DescribeLogStreams API operation for Amazon CloudWatch Logs.

Lists the log streams for the specified log group. You can list all the log streams or filter the results by prefix. You can also control how the results are ordered.

This operation has a limit of five transactions per second, after which transactions are throttled.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DescribeLogStreams for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DescribeLogStreamsInput{
		LogGroupName:        aws.String("LogGroupName"), // Required
		Descending:          aws.Bool(true),
		Limit:               aws.Int64(1),
		LogStreamNamePrefix: aws.String("LogStreamName"),
		NextToken:           aws.String("NextToken"),
		OrderBy:             aws.String("OrderBy"),
	}
	resp, err := svc.DescribeLogStreams(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DescribeLogStreamsPages

func (c *CloudWatchLogs) DescribeLogStreamsPages(input *DescribeLogStreamsInput, fn func(p *DescribeLogStreamsOutput, lastPage bool) (shouldContinue bool)) error

DescribeLogStreamsPages iterates over the pages of a DescribeLogStreams operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeLogStreams method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeLogStreams operation.
pageNum := 0
err := client.DescribeLogStreamsPages(params,
    func(page *DescribeLogStreamsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) DescribeLogStreamsRequest

func (c *CloudWatchLogs) DescribeLogStreamsRequest(input *DescribeLogStreamsInput) (req *request.Request, output *DescribeLogStreamsOutput)

DescribeLogStreamsRequest generates a "aws/request.Request" representing the client's request for the DescribeLogStreams operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeLogStreams for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeLogStreams method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DescribeLogStreamsRequest method.
req, resp := client.DescribeLogStreamsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DescribeMetricFilters

func (c *CloudWatchLogs) DescribeMetricFilters(input *DescribeMetricFiltersInput) (*DescribeMetricFiltersOutput, error)

DescribeMetricFilters API operation for Amazon CloudWatch Logs.

Lists the specified metric filters. You can list all the metric filters or filter the results by log name, prefix, metric name, or metric namespace. The results are ASCII-sorted by filter name.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DescribeMetricFilters for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DescribeMetricFiltersInput{
		FilterNamePrefix: aws.String("FilterName"),
		Limit:            aws.Int64(1),
		LogGroupName:     aws.String("LogGroupName"),
		MetricName:       aws.String("MetricName"),
		MetricNamespace:  aws.String("MetricNamespace"),
		NextToken:        aws.String("NextToken"),
	}
	resp, err := svc.DescribeMetricFilters(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DescribeMetricFiltersPages

func (c *CloudWatchLogs) DescribeMetricFiltersPages(input *DescribeMetricFiltersInput, fn func(p *DescribeMetricFiltersOutput, lastPage bool) (shouldContinue bool)) error

DescribeMetricFiltersPages iterates over the pages of a DescribeMetricFilters operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeMetricFilters method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeMetricFilters operation.
pageNum := 0
err := client.DescribeMetricFiltersPages(params,
    func(page *DescribeMetricFiltersOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) DescribeMetricFiltersRequest

func (c *CloudWatchLogs) DescribeMetricFiltersRequest(input *DescribeMetricFiltersInput) (req *request.Request, output *DescribeMetricFiltersOutput)

DescribeMetricFiltersRequest generates a "aws/request.Request" representing the client's request for the DescribeMetricFilters operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeMetricFilters for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeMetricFilters method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DescribeMetricFiltersRequest method.
req, resp := client.DescribeMetricFiltersRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) DescribeSubscriptionFilters

DescribeSubscriptionFilters API operation for Amazon CloudWatch Logs.

Lists the subscription filters for the specified log group. You can list all the subscription filters or filter the results by prefix. The results are ASCII-sorted by filter name.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation DescribeSubscriptionFilters for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.DescribeSubscriptionFiltersInput{
		LogGroupName:     aws.String("LogGroupName"), // Required
		FilterNamePrefix: aws.String("FilterName"),
		Limit:            aws.Int64(1),
		NextToken:        aws.String("NextToken"),
	}
	resp, err := svc.DescribeSubscriptionFilters(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) DescribeSubscriptionFiltersPages

func (c *CloudWatchLogs) DescribeSubscriptionFiltersPages(input *DescribeSubscriptionFiltersInput, fn func(p *DescribeSubscriptionFiltersOutput, lastPage bool) (shouldContinue bool)) error

DescribeSubscriptionFiltersPages iterates over the pages of a DescribeSubscriptionFilters operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeSubscriptionFilters method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeSubscriptionFilters operation.
pageNum := 0
err := client.DescribeSubscriptionFiltersPages(params,
    func(page *DescribeSubscriptionFiltersOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) DescribeSubscriptionFiltersRequest

func (c *CloudWatchLogs) DescribeSubscriptionFiltersRequest(input *DescribeSubscriptionFiltersInput) (req *request.Request, output *DescribeSubscriptionFiltersOutput)

DescribeSubscriptionFiltersRequest generates a "aws/request.Request" representing the client's request for the DescribeSubscriptionFilters operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeSubscriptionFilters for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeSubscriptionFilters method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DescribeSubscriptionFiltersRequest method.
req, resp := client.DescribeSubscriptionFiltersRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) FilterLogEvents

func (c *CloudWatchLogs) FilterLogEvents(input *FilterLogEventsInput) (*FilterLogEventsOutput, error)

FilterLogEvents API operation for Amazon CloudWatch Logs.

Lists log events from the specified log group. You can list all the log events or filter the results using a filter pattern, a time range, and the name of the log stream.

By default, this operation returns as many log events as can fit in 1MB (up to 10,000 log events), or all the events found within the time range that you specify. If the results include a token, then there are more log events available, and you can get additional results by specifying the token in a subsequent call.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation FilterLogEvents for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.FilterLogEventsInput{
		LogGroupName:  aws.String("LogGroupName"), // Required
		EndTime:       aws.Int64(1),
		FilterPattern: aws.String("FilterPattern"),
		Interleaved:   aws.Bool(true),
		Limit:         aws.Int64(1),
		LogStreamNames: []*string{
			aws.String("LogStreamName"), // Required
			// More values...
		},
		NextToken: aws.String("NextToken"),
		StartTime: aws.Int64(1),
	}
	resp, err := svc.FilterLogEvents(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) FilterLogEventsPages

func (c *CloudWatchLogs) FilterLogEventsPages(input *FilterLogEventsInput, fn func(p *FilterLogEventsOutput, lastPage bool) (shouldContinue bool)) error

FilterLogEventsPages iterates over the pages of a FilterLogEvents operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See FilterLogEvents method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a FilterLogEvents operation.
pageNum := 0
err := client.FilterLogEventsPages(params,
    func(page *FilterLogEventsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) FilterLogEventsRequest

func (c *CloudWatchLogs) FilterLogEventsRequest(input *FilterLogEventsInput) (req *request.Request, output *FilterLogEventsOutput)

FilterLogEventsRequest generates a "aws/request.Request" representing the client's request for the FilterLogEvents operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See FilterLogEvents for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the FilterLogEvents method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the FilterLogEventsRequest method.
req, resp := client.FilterLogEventsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) GetLogEvents

func (c *CloudWatchLogs) GetLogEvents(input *GetLogEventsInput) (*GetLogEventsOutput, error)

GetLogEvents API operation for Amazon CloudWatch Logs.

Lists log events from the specified log stream. You can list all the log events or filter using a time range.

By default, this operation returns as many log events as can fit in a response size of 1MB (up to 10,000 log events). If the results include tokens, there are more log events available. You can get additional log events by specifying one of the tokens in a subsequent call.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation GetLogEvents for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.GetLogEventsInput{
		LogGroupName:  aws.String("LogGroupName"),  // Required
		LogStreamName: aws.String("LogStreamName"), // Required
		EndTime:       aws.Int64(1),
		Limit:         aws.Int64(1),
		NextToken:     aws.String("NextToken"),
		StartFromHead: aws.Bool(true),
		StartTime:     aws.Int64(1),
	}
	resp, err := svc.GetLogEvents(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) GetLogEventsPages

func (c *CloudWatchLogs) GetLogEventsPages(input *GetLogEventsInput, fn func(p *GetLogEventsOutput, lastPage bool) (shouldContinue bool)) error

GetLogEventsPages iterates over the pages of a GetLogEvents operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See GetLogEvents method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a GetLogEvents operation.
pageNum := 0
err := client.GetLogEventsPages(params,
    func(page *GetLogEventsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*CloudWatchLogs) GetLogEventsRequest

func (c *CloudWatchLogs) GetLogEventsRequest(input *GetLogEventsInput) (req *request.Request, output *GetLogEventsOutput)

GetLogEventsRequest generates a "aws/request.Request" representing the client's request for the GetLogEvents operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See GetLogEvents for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetLogEvents method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the GetLogEventsRequest method.
req, resp := client.GetLogEventsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) PutDestination

func (c *CloudWatchLogs) PutDestination(input *PutDestinationInput) (*PutDestinationOutput, error)

PutDestination API operation for Amazon CloudWatch Logs.

Creates or updates a destination. A destination encapsulates a physical resource (such as a Kinesis stream) and enables you to subscribe to a real-time stream of log events of a different account, ingested using PutLogEvents. Currently, the only supported physical resource is a Amazon Kinesis stream belonging to the same account as the destination.

A destination controls what is written to its Amazon Kinesis stream through an access policy. By default, PutDestination does not set any access policy with the destination, which means a cross-account user cannot call PutSubscriptionFilter against this destination. To enable this, the destination owner must call PutDestinationPolicy after PutDestination.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation PutDestination for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.PutDestinationInput{
		DestinationName: aws.String("DestinationName"), // Required
		RoleArn:         aws.String("RoleArn"),         // Required
		TargetArn:       aws.String("TargetArn"),       // Required
	}
	resp, err := svc.PutDestination(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) PutDestinationPolicy

func (c *CloudWatchLogs) PutDestinationPolicy(input *PutDestinationPolicyInput) (*PutDestinationPolicyOutput, error)

PutDestinationPolicy API operation for Amazon CloudWatch Logs.

Creates or updates an access policy associated with an existing destination. An access policy is an IAM policy document (http://docs.aws.amazon.com/IAM/latest/UserGuide/policies_overview.html) that is used to authorize claims to register a subscription filter against a given destination.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation PutDestinationPolicy for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.PutDestinationPolicyInput{
		AccessPolicy:    aws.String("AccessPolicy"),    // Required
		DestinationName: aws.String("DestinationName"), // Required
	}
	resp, err := svc.PutDestinationPolicy(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) PutDestinationPolicyRequest

func (c *CloudWatchLogs) PutDestinationPolicyRequest(input *PutDestinationPolicyInput) (req *request.Request, output *PutDestinationPolicyOutput)

PutDestinationPolicyRequest generates a "aws/request.Request" representing the client's request for the PutDestinationPolicy operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See PutDestinationPolicy for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutDestinationPolicy method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the PutDestinationPolicyRequest method.
req, resp := client.PutDestinationPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) PutDestinationRequest

func (c *CloudWatchLogs) PutDestinationRequest(input *PutDestinationInput) (req *request.Request, output *PutDestinationOutput)

PutDestinationRequest generates a "aws/request.Request" representing the client's request for the PutDestination operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See PutDestination for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutDestination method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the PutDestinationRequest method.
req, resp := client.PutDestinationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) PutLogEvents

func (c *CloudWatchLogs) PutLogEvents(input *PutLogEventsInput) (*PutLogEventsOutput, error)

PutLogEvents API operation for Amazon CloudWatch Logs.

Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams.

The batch of events must satisfy the following constraints:

  • The maximum batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.

  • None of the log events in the batch can be more than 2 hours in the future.

  • None of the log events in the batch can be older than 14 days or the retention period of the log group.

  • The log events in the batch must be in chronological ordered by their timestamp.

  • The maximum number of log events in a batch is 10,000.

  • A batch of log events in a single PutLogEvents request cannot span more than 24 hours. Otherwise, the PutLogEvents operation will fail.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation PutLogEvents for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • InvalidSequenceTokenException The sequence token is not valid.

  • DataAlreadyAcceptedException The event was already logged.

  • ResourceNotFoundException The specified resource does not exist.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.PutLogEventsInput{
		LogEvents: []*cloudwatchlogs.InputLogEvent{ // Required
			{ // Required
				Message:   aws.String("EventMessage"), // Required
				Timestamp: aws.Int64(1),               // Required
			},
			// More values...
		},
		LogGroupName:  aws.String("LogGroupName"),  // Required
		LogStreamName: aws.String("LogStreamName"), // Required
		SequenceToken: aws.String("SequenceToken"),
	}
	resp, err := svc.PutLogEvents(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) PutLogEventsRequest

func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *request.Request, output *PutLogEventsOutput)

PutLogEventsRequest generates a "aws/request.Request" representing the client's request for the PutLogEvents operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See PutLogEvents for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutLogEvents method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the PutLogEventsRequest method.
req, resp := client.PutLogEventsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) PutMetricFilter

func (c *CloudWatchLogs) PutMetricFilter(input *PutMetricFilterInput) (*PutMetricFilterOutput, error)

PutMetricFilter API operation for Amazon CloudWatch Logs.

Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through PutLogEvents.

The maximum number of metric filters that can be associated with a log group is 100.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation PutMetricFilter for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • LimitExceededException You have reached the maximum number of resources that can be created.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.PutMetricFilterInput{
		FilterName:    aws.String("FilterName"),    // Required
		FilterPattern: aws.String("FilterPattern"), // Required
		LogGroupName:  aws.String("LogGroupName"),  // Required
		MetricTransformations: []*cloudwatchlogs.MetricTransformation{ // Required
			{ // Required
				MetricName:      aws.String("MetricName"),      // Required
				MetricNamespace: aws.String("MetricNamespace"), // Required
				MetricValue:     aws.String("MetricValue"),     // Required
				DefaultValue:    aws.Float64(1.0),
			},
			// More values...
		},
	}
	resp, err := svc.PutMetricFilter(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) PutMetricFilterRequest

func (c *CloudWatchLogs) PutMetricFilterRequest(input *PutMetricFilterInput) (req *request.Request, output *PutMetricFilterOutput)

PutMetricFilterRequest generates a "aws/request.Request" representing the client's request for the PutMetricFilter operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See PutMetricFilter for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutMetricFilter method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the PutMetricFilterRequest method.
req, resp := client.PutMetricFilterRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) PutRetentionPolicy

func (c *CloudWatchLogs) PutRetentionPolicy(input *PutRetentionPolicyInput) (*PutRetentionPolicyOutput, error)

PutRetentionPolicy API operation for Amazon CloudWatch Logs.

Sets the retention of the specified log group. A retention policy allows you to configure the number of days you want to retain log events in the specified log group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation PutRetentionPolicy for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.PutRetentionPolicyInput{
		LogGroupName:    aws.String("LogGroupName"), // Required
		RetentionInDays: aws.Int64(1),               // Required
	}
	resp, err := svc.PutRetentionPolicy(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) PutRetentionPolicyRequest

func (c *CloudWatchLogs) PutRetentionPolicyRequest(input *PutRetentionPolicyInput) (req *request.Request, output *PutRetentionPolicyOutput)

PutRetentionPolicyRequest generates a "aws/request.Request" representing the client's request for the PutRetentionPolicy operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See PutRetentionPolicy for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutRetentionPolicy method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the PutRetentionPolicyRequest method.
req, resp := client.PutRetentionPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) PutSubscriptionFilter

func (c *CloudWatchLogs) PutSubscriptionFilter(input *PutSubscriptionFilterInput) (*PutSubscriptionFilterOutput, error)

PutSubscriptionFilter API operation for Amazon CloudWatch Logs.

Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through PutLogEvents and have them delivered to a specific destination. Currently, the supported destinations are:

  • An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.

  • A logical destination that belongs to a different account, for cross-account delivery.

  • An Amazon Kinesis Firehose stream that belongs to the same account as the subscription filter, for same-account delivery.

  • An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.

There can only be one subscription filter associated with a log group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation PutSubscriptionFilter for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ResourceNotFoundException The specified resource does not exist.

  • OperationAbortedException Multiple requests to update the same resource were in conflict.

  • LimitExceededException You have reached the maximum number of resources that can be created.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.PutSubscriptionFilterInput{
		DestinationArn: aws.String("DestinationArn"), // Required
		FilterName:     aws.String("FilterName"),     // Required
		FilterPattern:  aws.String("FilterPattern"),  // Required
		LogGroupName:   aws.String("LogGroupName"),   // Required
		RoleArn:        aws.String("RoleArn"),
	}
	resp, err := svc.PutSubscriptionFilter(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) PutSubscriptionFilterRequest

func (c *CloudWatchLogs) PutSubscriptionFilterRequest(input *PutSubscriptionFilterInput) (req *request.Request, output *PutSubscriptionFilterOutput)

PutSubscriptionFilterRequest generates a "aws/request.Request" representing the client's request for the PutSubscriptionFilter operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See PutSubscriptionFilter for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutSubscriptionFilter method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the PutSubscriptionFilterRequest method.
req, resp := client.PutSubscriptionFilterRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*CloudWatchLogs) TestMetricFilter

func (c *CloudWatchLogs) TestMetricFilter(input *TestMetricFilterInput) (*TestMetricFilterOutput, error)

TestMetricFilter API operation for Amazon CloudWatch Logs.

Tests the filter pattern of a metric filter against a sample of log event messages. You can use this operation to validate the correctness of a metric filter pattern.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon CloudWatch Logs's API operation TestMetricFilter for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter is specified incorrectly.

  • ServiceUnavailableException The service cannot complete the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudwatchlogs"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := cloudwatchlogs.New(sess)

	params := &cloudwatchlogs.TestMetricFilterInput{
		FilterPattern: aws.String("FilterPattern"), // Required
		LogEventMessages: []*string{ // Required
			aws.String("EventMessage"), // Required
			// More values...
		},
	}
	resp, err := svc.TestMetricFilter(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*CloudWatchLogs) TestMetricFilterRequest

func (c *CloudWatchLogs) TestMetricFilterRequest(input *TestMetricFilterInput) (req *request.Request, output *TestMetricFilterOutput)

TestMetricFilterRequest generates a "aws/request.Request" representing the client's request for the TestMetricFilter operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See TestMetricFilter for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the TestMetricFilter method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the TestMetricFilterRequest method.
req, resp := client.TestMetricFilterRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

type CreateExportTaskInput

type CreateExportTaskInput struct {

	// The name of S3 bucket for the exported log data. The bucket must be in the
	// same AWS region.
	//
	// Destination is a required field
	Destination *string `locationName:"destination" min:"1" type:"string" required:"true"`

	// The prefix used as the start of the key for every object exported. If you
	// don't specify a value, the default is exportedlogs.
	DestinationPrefix *string `locationName:"destinationPrefix" type:"string"`

	// The start time of the range for the request, expressed as the number of milliseconds
	// since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this
	// time are not exported.
	//
	// From is a required field
	From *int64 `locationName:"from" type:"long" required:"true"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// Export only log streams that match the provided prefix. If you don't specify
	// a value, no prefix filter is applied.
	LogStreamNamePrefix *string `locationName:"logStreamNamePrefix" min:"1" type:"string"`

	// The name of the export task.
	TaskName *string `locationName:"taskName" min:"1" type:"string"`

	// The end time of the range for the request, expressed as the number of milliseconds
	// since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time
	// are not exported.
	//
	// To is a required field
	To *int64 `locationName:"to" type:"long" required:"true"`
	// contains filtered or unexported fields
}

func (CreateExportTaskInput) GoString

func (s CreateExportTaskInput) GoString() string

GoString returns the string representation

func (*CreateExportTaskInput) SetDestination

func (s *CreateExportTaskInput) SetDestination(v string) *CreateExportTaskInput

SetDestination sets the Destination field's value.

func (*CreateExportTaskInput) SetDestinationPrefix

func (s *CreateExportTaskInput) SetDestinationPrefix(v string) *CreateExportTaskInput

SetDestinationPrefix sets the DestinationPrefix field's value.

func (*CreateExportTaskInput) SetFrom

SetFrom sets the From field's value.

func (*CreateExportTaskInput) SetLogGroupName

func (s *CreateExportTaskInput) SetLogGroupName(v string) *CreateExportTaskInput

SetLogGroupName sets the LogGroupName field's value.

func (*CreateExportTaskInput) SetLogStreamNamePrefix

func (s *CreateExportTaskInput) SetLogStreamNamePrefix(v string) *CreateExportTaskInput

SetLogStreamNamePrefix sets the LogStreamNamePrefix field's value.

func (*CreateExportTaskInput) SetTaskName

SetTaskName sets the TaskName field's value.

func (*CreateExportTaskInput) SetTo

SetTo sets the To field's value.

func (CreateExportTaskInput) String

func (s CreateExportTaskInput) String() string

String returns the string representation

func (*CreateExportTaskInput) Validate

func (s *CreateExportTaskInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateExportTaskOutput

type CreateExportTaskOutput struct {

	// The ID of the export task.
	TaskId *string `locationName:"taskId" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (CreateExportTaskOutput) GoString

func (s CreateExportTaskOutput) GoString() string

GoString returns the string representation

func (*CreateExportTaskOutput) SetTaskId

SetTaskId sets the TaskId field's value.

func (CreateExportTaskOutput) String

func (s CreateExportTaskOutput) String() string

String returns the string representation

type CreateLogGroupInput

type CreateLogGroupInput struct {

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreateLogGroupInput) GoString

func (s CreateLogGroupInput) GoString() string

GoString returns the string representation

func (*CreateLogGroupInput) SetLogGroupName

func (s *CreateLogGroupInput) SetLogGroupName(v string) *CreateLogGroupInput

SetLogGroupName sets the LogGroupName field's value.

func (CreateLogGroupInput) String

func (s CreateLogGroupInput) String() string

String returns the string representation

func (*CreateLogGroupInput) Validate

func (s *CreateLogGroupInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateLogGroupOutput

type CreateLogGroupOutput struct {
	// contains filtered or unexported fields
}

func (CreateLogGroupOutput) GoString

func (s CreateLogGroupOutput) GoString() string

GoString returns the string representation

func (CreateLogGroupOutput) String

func (s CreateLogGroupOutput) String() string

String returns the string representation

type CreateLogStreamInput

type CreateLogStreamInput struct {

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The name of the log stream.
	//
	// LogStreamName is a required field
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreateLogStreamInput) GoString

func (s CreateLogStreamInput) GoString() string

GoString returns the string representation

func (*CreateLogStreamInput) SetLogGroupName

func (s *CreateLogStreamInput) SetLogGroupName(v string) *CreateLogStreamInput

SetLogGroupName sets the LogGroupName field's value.

func (*CreateLogStreamInput) SetLogStreamName

func (s *CreateLogStreamInput) SetLogStreamName(v string) *CreateLogStreamInput

SetLogStreamName sets the LogStreamName field's value.

func (CreateLogStreamInput) String

func (s CreateLogStreamInput) String() string

String returns the string representation

func (*CreateLogStreamInput) Validate

func (s *CreateLogStreamInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateLogStreamOutput

type CreateLogStreamOutput struct {
	// contains filtered or unexported fields
}

func (CreateLogStreamOutput) GoString

func (s CreateLogStreamOutput) GoString() string

GoString returns the string representation

func (CreateLogStreamOutput) String

func (s CreateLogStreamOutput) String() string

String returns the string representation

type DeleteDestinationInput

type DeleteDestinationInput struct {

	// The name of the destination.
	//
	// DestinationName is a required field
	DestinationName *string `locationName:"destinationName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteDestinationInput) GoString

func (s DeleteDestinationInput) GoString() string

GoString returns the string representation

func (*DeleteDestinationInput) SetDestinationName

func (s *DeleteDestinationInput) SetDestinationName(v string) *DeleteDestinationInput

SetDestinationName sets the DestinationName field's value.

func (DeleteDestinationInput) String

func (s DeleteDestinationInput) String() string

String returns the string representation

func (*DeleteDestinationInput) Validate

func (s *DeleteDestinationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteDestinationOutput

type DeleteDestinationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteDestinationOutput) GoString

func (s DeleteDestinationOutput) GoString() string

GoString returns the string representation

func (DeleteDestinationOutput) String

func (s DeleteDestinationOutput) String() string

String returns the string representation

type DeleteLogGroupInput

type DeleteLogGroupInput struct {

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteLogGroupInput) GoString

func (s DeleteLogGroupInput) GoString() string

GoString returns the string representation

func (*DeleteLogGroupInput) SetLogGroupName

func (s *DeleteLogGroupInput) SetLogGroupName(v string) *DeleteLogGroupInput

SetLogGroupName sets the LogGroupName field's value.

func (DeleteLogGroupInput) String

func (s DeleteLogGroupInput) String() string

String returns the string representation

func (*DeleteLogGroupInput) Validate

func (s *DeleteLogGroupInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteLogGroupOutput

type DeleteLogGroupOutput struct {
	// contains filtered or unexported fields
}

func (DeleteLogGroupOutput) GoString

func (s DeleteLogGroupOutput) GoString() string

GoString returns the string representation

func (DeleteLogGroupOutput) String

func (s DeleteLogGroupOutput) String() string

String returns the string representation

type DeleteLogStreamInput

type DeleteLogStreamInput struct {

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The name of the log stream.
	//
	// LogStreamName is a required field
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteLogStreamInput) GoString

func (s DeleteLogStreamInput) GoString() string

GoString returns the string representation

func (*DeleteLogStreamInput) SetLogGroupName

func (s *DeleteLogStreamInput) SetLogGroupName(v string) *DeleteLogStreamInput

SetLogGroupName sets the LogGroupName field's value.

func (*DeleteLogStreamInput) SetLogStreamName

func (s *DeleteLogStreamInput) SetLogStreamName(v string) *DeleteLogStreamInput

SetLogStreamName sets the LogStreamName field's value.

func (DeleteLogStreamInput) String

func (s DeleteLogStreamInput) String() string

String returns the string representation

func (*DeleteLogStreamInput) Validate

func (s *DeleteLogStreamInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteLogStreamOutput

type DeleteLogStreamOutput struct {
	// contains filtered or unexported fields
}

func (DeleteLogStreamOutput) GoString

func (s DeleteLogStreamOutput) GoString() string

GoString returns the string representation

func (DeleteLogStreamOutput) String

func (s DeleteLogStreamOutput) String() string

String returns the string representation

type DeleteMetricFilterInput

type DeleteMetricFilterInput struct {

	// The name of the metric filter.
	//
	// FilterName is a required field
	FilterName *string `locationName:"filterName" min:"1" type:"string" required:"true"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteMetricFilterInput) GoString

func (s DeleteMetricFilterInput) GoString() string

GoString returns the string representation

func (*DeleteMetricFilterInput) SetFilterName

SetFilterName sets the FilterName field's value.

func (*DeleteMetricFilterInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (DeleteMetricFilterInput) String

func (s DeleteMetricFilterInput) String() string

String returns the string representation

func (*DeleteMetricFilterInput) Validate

func (s *DeleteMetricFilterInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteMetricFilterOutput

type DeleteMetricFilterOutput struct {
	// contains filtered or unexported fields
}

func (DeleteMetricFilterOutput) GoString

func (s DeleteMetricFilterOutput) GoString() string

GoString returns the string representation

func (DeleteMetricFilterOutput) String

func (s DeleteMetricFilterOutput) String() string

String returns the string representation

type DeleteRetentionPolicyInput

type DeleteRetentionPolicyInput struct {

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteRetentionPolicyInput) GoString

func (s DeleteRetentionPolicyInput) GoString() string

GoString returns the string representation

func (*DeleteRetentionPolicyInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (DeleteRetentionPolicyInput) String

String returns the string representation

func (*DeleteRetentionPolicyInput) Validate

func (s *DeleteRetentionPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteRetentionPolicyOutput

type DeleteRetentionPolicyOutput struct {
	// contains filtered or unexported fields
}

func (DeleteRetentionPolicyOutput) GoString

func (s DeleteRetentionPolicyOutput) GoString() string

GoString returns the string representation

func (DeleteRetentionPolicyOutput) String

String returns the string representation

type DeleteSubscriptionFilterInput

type DeleteSubscriptionFilterInput struct {

	// The name of the subscription filter.
	//
	// FilterName is a required field
	FilterName *string `locationName:"filterName" min:"1" type:"string" required:"true"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteSubscriptionFilterInput) GoString

GoString returns the string representation

func (*DeleteSubscriptionFilterInput) SetFilterName

SetFilterName sets the FilterName field's value.

func (*DeleteSubscriptionFilterInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (DeleteSubscriptionFilterInput) String

String returns the string representation

func (*DeleteSubscriptionFilterInput) Validate

func (s *DeleteSubscriptionFilterInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteSubscriptionFilterOutput

type DeleteSubscriptionFilterOutput struct {
	// contains filtered or unexported fields
}

func (DeleteSubscriptionFilterOutput) GoString

GoString returns the string representation

func (DeleteSubscriptionFilterOutput) String

String returns the string representation

type DescribeDestinationsInput

type DescribeDestinationsInput struct {

	// The prefix to match. If you don't specify a value, no prefix filter is applied.
	DestinationNamePrefix *string `min:"1" type:"string"`

	// The maximum number of items returned. If you don't specify a value, the default
	// is up to 50 items.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeDestinationsInput) GoString

func (s DescribeDestinationsInput) GoString() string

GoString returns the string representation

func (*DescribeDestinationsInput) SetDestinationNamePrefix

func (s *DescribeDestinationsInput) SetDestinationNamePrefix(v string) *DescribeDestinationsInput

SetDestinationNamePrefix sets the DestinationNamePrefix field's value.

func (*DescribeDestinationsInput) SetLimit

SetLimit sets the Limit field's value.

func (*DescribeDestinationsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeDestinationsInput) String

func (s DescribeDestinationsInput) String() string

String returns the string representation

func (*DescribeDestinationsInput) Validate

func (s *DescribeDestinationsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeDestinationsOutput

type DescribeDestinationsOutput struct {

	// The destinations.
	Destinations []*Destination `locationName:"destinations" type:"list"`

	// The token for the next set of items to return. The token expires after 24
	// hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeDestinationsOutput) GoString

func (s DescribeDestinationsOutput) GoString() string

GoString returns the string representation

func (*DescribeDestinationsOutput) SetDestinations

SetDestinations sets the Destinations field's value.

func (*DescribeDestinationsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeDestinationsOutput) String

String returns the string representation

type DescribeExportTasksInput

type DescribeExportTasksInput struct {

	// The maximum number of items returned. If you don't specify a value, the default
	// is up to 50 items.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`

	// The status code of the export task. Specifying a status code filters the
	// results to zero or more export tasks.
	StatusCode *string `locationName:"statusCode" type:"string" enum:"ExportTaskStatusCode"`

	// The ID of the export task. Specifying a task ID filters the results to zero
	// or one export tasks.
	TaskId *string `locationName:"taskId" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeExportTasksInput) GoString

func (s DescribeExportTasksInput) GoString() string

GoString returns the string representation

func (*DescribeExportTasksInput) SetLimit

SetLimit sets the Limit field's value.

func (*DescribeExportTasksInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribeExportTasksInput) SetStatusCode

SetStatusCode sets the StatusCode field's value.

func (*DescribeExportTasksInput) SetTaskId

SetTaskId sets the TaskId field's value.

func (DescribeExportTasksInput) String

func (s DescribeExportTasksInput) String() string

String returns the string representation

func (*DescribeExportTasksInput) Validate

func (s *DescribeExportTasksInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeExportTasksOutput

type DescribeExportTasksOutput struct {

	// The export tasks.
	ExportTasks []*ExportTask `locationName:"exportTasks" type:"list"`

	// The token for the next set of items to return. The token expires after 24
	// hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeExportTasksOutput) GoString

func (s DescribeExportTasksOutput) GoString() string

GoString returns the string representation

func (*DescribeExportTasksOutput) SetExportTasks

SetExportTasks sets the ExportTasks field's value.

func (*DescribeExportTasksOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeExportTasksOutput) String

func (s DescribeExportTasksOutput) String() string

String returns the string representation

type DescribeLogGroupsInput

type DescribeLogGroupsInput struct {

	// The maximum number of items returned. If you don't specify a value, the default
	// is up to 50 items.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The prefix to match.
	LogGroupNamePrefix *string `locationName:"logGroupNamePrefix" min:"1" type:"string"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLogGroupsInput) GoString

func (s DescribeLogGroupsInput) GoString() string

GoString returns the string representation

func (*DescribeLogGroupsInput) SetLimit

SetLimit sets the Limit field's value.

func (*DescribeLogGroupsInput) SetLogGroupNamePrefix

func (s *DescribeLogGroupsInput) SetLogGroupNamePrefix(v string) *DescribeLogGroupsInput

SetLogGroupNamePrefix sets the LogGroupNamePrefix field's value.

func (*DescribeLogGroupsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLogGroupsInput) String

func (s DescribeLogGroupsInput) String() string

String returns the string representation

func (*DescribeLogGroupsInput) Validate

func (s *DescribeLogGroupsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeLogGroupsOutput

type DescribeLogGroupsOutput struct {

	// The log groups.
	LogGroups []*LogGroup `locationName:"logGroups" type:"list"`

	// The token for the next set of items to return. The token expires after 24
	// hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLogGroupsOutput) GoString

func (s DescribeLogGroupsOutput) GoString() string

GoString returns the string representation

func (*DescribeLogGroupsOutput) SetLogGroups

SetLogGroups sets the LogGroups field's value.

func (*DescribeLogGroupsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLogGroupsOutput) String

func (s DescribeLogGroupsOutput) String() string

String returns the string representation

type DescribeLogStreamsInput

type DescribeLogStreamsInput struct {

	// If the value is true, results are returned in descending order. If the value
	// is to false, results are returned in ascending order. The default value is
	// false.
	Descending *bool `locationName:"descending" type:"boolean"`

	// The maximum number of items returned. If you don't specify a value, the default
	// is up to 50 items.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The prefix to match.
	//
	// You cannot specify this parameter if orderBy is LastEventTime.
	LogStreamNamePrefix *string `locationName:"logStreamNamePrefix" min:"1" type:"string"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`

	// If the value is LogStreamName, the results are ordered by log stream name.
	// If the value is LastEventTime, the results are ordered by the event time.
	// The default value is LogStreamName.
	//
	// If you order the results by event time, you cannot specify the logStreamNamePrefix
	// parameter.
	OrderBy *string `locationName:"orderBy" type:"string" enum:"OrderBy"`
	// contains filtered or unexported fields
}

func (DescribeLogStreamsInput) GoString

func (s DescribeLogStreamsInput) GoString() string

GoString returns the string representation

func (*DescribeLogStreamsInput) SetDescending

SetDescending sets the Descending field's value.

func (*DescribeLogStreamsInput) SetLimit

SetLimit sets the Limit field's value.

func (*DescribeLogStreamsInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (*DescribeLogStreamsInput) SetLogStreamNamePrefix

func (s *DescribeLogStreamsInput) SetLogStreamNamePrefix(v string) *DescribeLogStreamsInput

SetLogStreamNamePrefix sets the LogStreamNamePrefix field's value.

func (*DescribeLogStreamsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribeLogStreamsInput) SetOrderBy

SetOrderBy sets the OrderBy field's value.

func (DescribeLogStreamsInput) String

func (s DescribeLogStreamsInput) String() string

String returns the string representation

func (*DescribeLogStreamsInput) Validate

func (s *DescribeLogStreamsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeLogStreamsOutput

type DescribeLogStreamsOutput struct {

	// The log streams.
	LogStreams []*LogStream `locationName:"logStreams" type:"list"`

	// The token for the next set of items to return. The token expires after 24
	// hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLogStreamsOutput) GoString

func (s DescribeLogStreamsOutput) GoString() string

GoString returns the string representation

func (*DescribeLogStreamsOutput) SetLogStreams

SetLogStreams sets the LogStreams field's value.

func (*DescribeLogStreamsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLogStreamsOutput) String

func (s DescribeLogStreamsOutput) String() string

String returns the string representation

type DescribeMetricFiltersInput

type DescribeMetricFiltersInput struct {

	// The prefix to match.
	FilterNamePrefix *string `locationName:"filterNamePrefix" min:"1" type:"string"`

	// The maximum number of items returned. If you don't specify a value, the default
	// is up to 50 items.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The name of the log group.
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string"`

	// The name of the CloudWatch metric.
	MetricName *string `locationName:"metricName" type:"string"`

	// The namespace of the CloudWatch metric.
	MetricNamespace *string `locationName:"metricNamespace" type:"string"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeMetricFiltersInput) GoString

func (s DescribeMetricFiltersInput) GoString() string

GoString returns the string representation

func (*DescribeMetricFiltersInput) SetFilterNamePrefix

SetFilterNamePrefix sets the FilterNamePrefix field's value.

func (*DescribeMetricFiltersInput) SetLimit

SetLimit sets the Limit field's value.

func (*DescribeMetricFiltersInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (*DescribeMetricFiltersInput) SetMetricName

SetMetricName sets the MetricName field's value.

func (*DescribeMetricFiltersInput) SetMetricNamespace

SetMetricNamespace sets the MetricNamespace field's value.

func (*DescribeMetricFiltersInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeMetricFiltersInput) String

String returns the string representation

func (*DescribeMetricFiltersInput) Validate

func (s *DescribeMetricFiltersInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeMetricFiltersOutput

type DescribeMetricFiltersOutput struct {

	// The metric filters.
	MetricFilters []*MetricFilter `locationName:"metricFilters" type:"list"`

	// The token for the next set of items to return. The token expires after 24
	// hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeMetricFiltersOutput) GoString

func (s DescribeMetricFiltersOutput) GoString() string

GoString returns the string representation

func (*DescribeMetricFiltersOutput) SetMetricFilters

SetMetricFilters sets the MetricFilters field's value.

func (*DescribeMetricFiltersOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeMetricFiltersOutput) String

String returns the string representation

type DescribeSubscriptionFiltersInput

type DescribeSubscriptionFiltersInput struct {

	// The prefix to match. If you don't specify a value, no prefix filter is applied.
	FilterNamePrefix *string `locationName:"filterNamePrefix" min:"1" type:"string"`

	// The maximum number of items returned. If you don't specify a value, the default
	// is up to 50 items.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeSubscriptionFiltersInput) GoString

GoString returns the string representation

func (*DescribeSubscriptionFiltersInput) SetFilterNamePrefix

SetFilterNamePrefix sets the FilterNamePrefix field's value.

func (*DescribeSubscriptionFiltersInput) SetLimit

SetLimit sets the Limit field's value.

func (*DescribeSubscriptionFiltersInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (*DescribeSubscriptionFiltersInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeSubscriptionFiltersInput) String

String returns the string representation

func (*DescribeSubscriptionFiltersInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type DescribeSubscriptionFiltersOutput

type DescribeSubscriptionFiltersOutput struct {

	// The token for the next set of items to return. The token expires after 24
	// hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`

	// The subscription filters.
	SubscriptionFilters []*SubscriptionFilter `locationName:"subscriptionFilters" type:"list"`
	// contains filtered or unexported fields
}

func (DescribeSubscriptionFiltersOutput) GoString

GoString returns the string representation

func (*DescribeSubscriptionFiltersOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribeSubscriptionFiltersOutput) SetSubscriptionFilters

SetSubscriptionFilters sets the SubscriptionFilters field's value.

func (DescribeSubscriptionFiltersOutput) String

String returns the string representation

type Destination

type Destination struct {

	// An IAM policy document that governs which AWS accounts can create subscription
	// filters against this destination.
	AccessPolicy *string `locationName:"accessPolicy" min:"1" type:"string"`

	// The ARN of this destination.
	Arn *string `locationName:"arn" type:"string"`

	// The creation time of the destination.
	CreationTime *int64 `locationName:"creationTime" type:"long"`

	// The name of the destination.
	DestinationName *string `locationName:"destinationName" min:"1" type:"string"`

	// A role for impersonation, used when delivering log events to the target.
	RoleArn *string `locationName:"roleArn" min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the physical target where the log events
	// will be delivered (for example, a Kinesis stream).
	TargetArn *string `locationName:"targetArn" min:"1" type:"string"`
	// contains filtered or unexported fields
}

Represents a cross-account destination that receives subscription log events.

func (Destination) GoString

func (s Destination) GoString() string

GoString returns the string representation

func (*Destination) SetAccessPolicy

func (s *Destination) SetAccessPolicy(v string) *Destination

SetAccessPolicy sets the AccessPolicy field's value.

func (*Destination) SetArn

func (s *Destination) SetArn(v string) *Destination

SetArn sets the Arn field's value.

func (*Destination) SetCreationTime

func (s *Destination) SetCreationTime(v int64) *Destination

SetCreationTime sets the CreationTime field's value.

func (*Destination) SetDestinationName

func (s *Destination) SetDestinationName(v string) *Destination

SetDestinationName sets the DestinationName field's value.

func (*Destination) SetRoleArn

func (s *Destination) SetRoleArn(v string) *Destination

SetRoleArn sets the RoleArn field's value.

func (*Destination) SetTargetArn

func (s *Destination) SetTargetArn(v string) *Destination

SetTargetArn sets the TargetArn field's value.

func (Destination) String

func (s Destination) String() string

String returns the string representation

type ExportTask

type ExportTask struct {

	// The name of Amazon S3 bucket to which the log data was exported.
	Destination *string `locationName:"destination" min:"1" type:"string"`

	// The prefix that was used as the start of Amazon S3 key for every object exported.
	DestinationPrefix *string `locationName:"destinationPrefix" type:"string"`

	// Execution info about the export task.
	ExecutionInfo *ExportTaskExecutionInfo `locationName:"executionInfo" type:"structure"`

	// The start time. Events with a timestamp prior to this time are not exported.
	From *int64 `locationName:"from" type:"long"`

	// The name of the log group from which logs data was exported.
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string"`

	// The status of the export task.
	Status *ExportTaskStatus `locationName:"status" type:"structure"`

	// The ID of the export task.
	TaskId *string `locationName:"taskId" min:"1" type:"string"`

	// The name of the export task.
	TaskName *string `locationName:"taskName" min:"1" type:"string"`

	// The end time. Events with a timestamp later than this time are not exported.
	To *int64 `locationName:"to" type:"long"`
	// contains filtered or unexported fields
}

Represents an export task.

func (ExportTask) GoString

func (s ExportTask) GoString() string

GoString returns the string representation

func (*ExportTask) SetDestination

func (s *ExportTask) SetDestination(v string) *ExportTask

SetDestination sets the Destination field's value.

func (*ExportTask) SetDestinationPrefix

func (s *ExportTask) SetDestinationPrefix(v string) *ExportTask

SetDestinationPrefix sets the DestinationPrefix field's value.

func (*ExportTask) SetExecutionInfo

func (s *ExportTask) SetExecutionInfo(v *ExportTaskExecutionInfo) *ExportTask

SetExecutionInfo sets the ExecutionInfo field's value.

func (*ExportTask) SetFrom

func (s *ExportTask) SetFrom(v int64) *ExportTask

SetFrom sets the From field's value.

func (*ExportTask) SetLogGroupName

func (s *ExportTask) SetLogGroupName(v string) *ExportTask

SetLogGroupName sets the LogGroupName field's value.

func (*ExportTask) SetStatus

func (s *ExportTask) SetStatus(v *ExportTaskStatus) *ExportTask

SetStatus sets the Status field's value.

func (*ExportTask) SetTaskId

func (s *ExportTask) SetTaskId(v string) *ExportTask

SetTaskId sets the TaskId field's value.

func (*ExportTask) SetTaskName

func (s *ExportTask) SetTaskName(v string) *ExportTask

SetTaskName sets the TaskName field's value.

func (*ExportTask) SetTo

func (s *ExportTask) SetTo(v int64) *ExportTask

SetTo sets the To field's value.

func (ExportTask) String

func (s ExportTask) String() string

String returns the string representation

type ExportTaskExecutionInfo

type ExportTaskExecutionInfo struct {

	// The completion time of the export task.
	CompletionTime *int64 `locationName:"completionTime" type:"long"`

	// The creation time of the export task.
	CreationTime *int64 `locationName:"creationTime" type:"long"`
	// contains filtered or unexported fields
}

Represents the status of an export task.

func (ExportTaskExecutionInfo) GoString

func (s ExportTaskExecutionInfo) GoString() string

GoString returns the string representation

func (*ExportTaskExecutionInfo) SetCompletionTime

func (s *ExportTaskExecutionInfo) SetCompletionTime(v int64) *ExportTaskExecutionInfo

SetCompletionTime sets the CompletionTime field's value.

func (*ExportTaskExecutionInfo) SetCreationTime

func (s *ExportTaskExecutionInfo) SetCreationTime(v int64) *ExportTaskExecutionInfo

SetCreationTime sets the CreationTime field's value.

func (ExportTaskExecutionInfo) String

func (s ExportTaskExecutionInfo) String() string

String returns the string representation

type ExportTaskStatus

type ExportTaskStatus struct {

	// The status code of the export task.
	Code *string `locationName:"code" type:"string" enum:"ExportTaskStatusCode"`

	// The status message related to the status code.
	Message *string `locationName:"message" type:"string"`
	// contains filtered or unexported fields
}

Represents the status of an export task.

func (ExportTaskStatus) GoString

func (s ExportTaskStatus) GoString() string

GoString returns the string representation

func (*ExportTaskStatus) SetCode

func (s *ExportTaskStatus) SetCode(v string) *ExportTaskStatus

SetCode sets the Code field's value.

func (*ExportTaskStatus) SetMessage

func (s *ExportTaskStatus) SetMessage(v string) *ExportTaskStatus

SetMessage sets the Message field's value.

func (ExportTaskStatus) String

func (s ExportTaskStatus) String() string

String returns the string representation

type FilterLogEventsInput

type FilterLogEventsInput struct {

	// The end of the time range. Events with a timestamp later than this time are
	// not returned.
	EndTime *int64 `locationName:"endTime" type:"long"`

	// The filter pattern to use. If not provided, all the events are matched.
	FilterPattern *string `locationName:"filterPattern" type:"string"`

	// If the value is true, the operation makes a best effort to provide responses
	// that contain events from multiple log streams within the log group interleaved
	// in a single response. If the value is false all the matched log events in
	// the first log stream are searched first, then those in the next log stream,
	// and so on. The default is false.
	Interleaved *bool `locationName:"interleaved" type:"boolean"`

	// The maximum number of events to return. The default is 10,000 events.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// Optional list of log stream names.
	LogStreamNames []*string `locationName:"logStreamNames" min:"1" type:"list"`

	// The token for the next set of events to return. (You received this token
	// from a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`

	// The start of the time range. Events with a timestamp prior to this time are
	// not returned.
	StartTime *int64 `locationName:"startTime" type:"long"`
	// contains filtered or unexported fields
}

func (FilterLogEventsInput) GoString

func (s FilterLogEventsInput) GoString() string

GoString returns the string representation

func (*FilterLogEventsInput) SetEndTime

SetEndTime sets the EndTime field's value.

func (*FilterLogEventsInput) SetFilterPattern

func (s *FilterLogEventsInput) SetFilterPattern(v string) *FilterLogEventsInput

SetFilterPattern sets the FilterPattern field's value.

func (*FilterLogEventsInput) SetInterleaved

func (s *FilterLogEventsInput) SetInterleaved(v bool) *FilterLogEventsInput

SetInterleaved sets the Interleaved field's value.

func (*FilterLogEventsInput) SetLimit

SetLimit sets the Limit field's value.

func (*FilterLogEventsInput) SetLogGroupName

func (s *FilterLogEventsInput) SetLogGroupName(v string) *FilterLogEventsInput

SetLogGroupName sets the LogGroupName field's value.

func (*FilterLogEventsInput) SetLogStreamNames

func (s *FilterLogEventsInput) SetLogStreamNames(v []*string) *FilterLogEventsInput

SetLogStreamNames sets the LogStreamNames field's value.

func (*FilterLogEventsInput) SetNextToken

func (s *FilterLogEventsInput) SetNextToken(v string) *FilterLogEventsInput

SetNextToken sets the NextToken field's value.

func (*FilterLogEventsInput) SetStartTime

func (s *FilterLogEventsInput) SetStartTime(v int64) *FilterLogEventsInput

SetStartTime sets the StartTime field's value.

func (FilterLogEventsInput) String

func (s FilterLogEventsInput) String() string

String returns the string representation

func (*FilterLogEventsInput) Validate

func (s *FilterLogEventsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type FilterLogEventsOutput

type FilterLogEventsOutput struct {

	// The matched events.
	Events []*FilteredLogEvent `locationName:"events" type:"list"`

	// The token to use when requesting the next set of items. The token expires
	// after 24 hours.
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`

	// Indicates which log streams have been searched and whether each has been
	// searched completely.
	SearchedLogStreams []*SearchedLogStream `locationName:"searchedLogStreams" type:"list"`
	// contains filtered or unexported fields
}

func (FilterLogEventsOutput) GoString

func (s FilterLogEventsOutput) GoString() string

GoString returns the string representation

func (*FilterLogEventsOutput) SetEvents

SetEvents sets the Events field's value.

func (*FilterLogEventsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*FilterLogEventsOutput) SetSearchedLogStreams

func (s *FilterLogEventsOutput) SetSearchedLogStreams(v []*SearchedLogStream) *FilterLogEventsOutput

SetSearchedLogStreams sets the SearchedLogStreams field's value.

func (FilterLogEventsOutput) String

func (s FilterLogEventsOutput) String() string

String returns the string representation

type FilteredLogEvent

type FilteredLogEvent struct {

	// The ID of the event.
	EventId *string `locationName:"eventId" type:"string"`

	// The time the event was ingested.
	IngestionTime *int64 `locationName:"ingestionTime" type:"long"`

	// The name of the log stream this event belongs to.
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string"`

	// The data contained in the log event.
	Message *string `locationName:"message" min:"1" type:"string"`

	// The time the event occurred.
	Timestamp *int64 `locationName:"timestamp" type:"long"`
	// contains filtered or unexported fields
}

Represents a matched event.

func (FilteredLogEvent) GoString

func (s FilteredLogEvent) GoString() string

GoString returns the string representation

func (*FilteredLogEvent) SetEventId

func (s *FilteredLogEvent) SetEventId(v string) *FilteredLogEvent

SetEventId sets the EventId field's value.

func (*FilteredLogEvent) SetIngestionTime

func (s *FilteredLogEvent) SetIngestionTime(v int64) *FilteredLogEvent

SetIngestionTime sets the IngestionTime field's value.

func (*FilteredLogEvent) SetLogStreamName

func (s *FilteredLogEvent) SetLogStreamName(v string) *FilteredLogEvent

SetLogStreamName sets the LogStreamName field's value.

func (*FilteredLogEvent) SetMessage

func (s *FilteredLogEvent) SetMessage(v string) *FilteredLogEvent

SetMessage sets the Message field's value.

func (*FilteredLogEvent) SetTimestamp

func (s *FilteredLogEvent) SetTimestamp(v int64) *FilteredLogEvent

SetTimestamp sets the Timestamp field's value.

func (FilteredLogEvent) String

func (s FilteredLogEvent) String() string

String returns the string representation

type GetLogEventsInput

type GetLogEventsInput struct {

	// The end of the time range. Events with a timestamp later than this time are
	// not included.
	EndTime *int64 `locationName:"endTime" type:"long"`

	// The maximum number of log events returned. If you don't specify a value,
	// the maximum is as many log events as can fit in a response size of 1MB, up
	// to 10,000 log events.
	Limit *int64 `locationName:"limit" min:"1" type:"integer"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The name of the log stream.
	//
	// LogStreamName is a required field
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string" required:"true"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `locationName:"nextToken" min:"1" type:"string"`

	// If the value is true, the earliest log events are returned first. If the
	// value is false, the latest log events are returned first. The default value
	// is false.
	StartFromHead *bool `locationName:"startFromHead" type:"boolean"`

	// The start of the time range. Events with a timestamp earlier than this time
	// are not included.
	StartTime *int64 `locationName:"startTime" type:"long"`
	// contains filtered or unexported fields
}

func (GetLogEventsInput) GoString

func (s GetLogEventsInput) GoString() string

GoString returns the string representation

func (*GetLogEventsInput) SetEndTime

func (s *GetLogEventsInput) SetEndTime(v int64) *GetLogEventsInput

SetEndTime sets the EndTime field's value.

func (*GetLogEventsInput) SetLimit

func (s *GetLogEventsInput) SetLimit(v int64) *GetLogEventsInput

SetLimit sets the Limit field's value.

func (*GetLogEventsInput) SetLogGroupName

func (s *GetLogEventsInput) SetLogGroupName(v string) *GetLogEventsInput

SetLogGroupName sets the LogGroupName field's value.

func (*GetLogEventsInput) SetLogStreamName

func (s *GetLogEventsInput) SetLogStreamName(v string) *GetLogEventsInput

SetLogStreamName sets the LogStreamName field's value.

func (*GetLogEventsInput) SetNextToken

func (s *GetLogEventsInput) SetNextToken(v string) *GetLogEventsInput

SetNextToken sets the NextToken field's value.

func (*GetLogEventsInput) SetStartFromHead

func (s *GetLogEventsInput) SetStartFromHead(v bool) *GetLogEventsInput

SetStartFromHead sets the StartFromHead field's value.

func (*GetLogEventsInput) SetStartTime

func (s *GetLogEventsInput) SetStartTime(v int64) *GetLogEventsInput

SetStartTime sets the StartTime field's value.

func (GetLogEventsInput) String

func (s GetLogEventsInput) String() string

String returns the string representation

func (*GetLogEventsInput) Validate

func (s *GetLogEventsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetLogEventsOutput

type GetLogEventsOutput struct {

	// The events.
	Events []*OutputLogEvent `locationName:"events" type:"list"`

	// The token for the next set of items in the backward direction. The token
	// expires after 24 hours.
	NextBackwardToken *string `locationName:"nextBackwardToken" min:"1" type:"string"`

	// The token for the next set of items in the forward direction. The token expires
	// after 24 hours.
	NextForwardToken *string `locationName:"nextForwardToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (GetLogEventsOutput) GoString

func (s GetLogEventsOutput) GoString() string

GoString returns the string representation

func (*GetLogEventsOutput) SetEvents

SetEvents sets the Events field's value.

func (*GetLogEventsOutput) SetNextBackwardToken

func (s *GetLogEventsOutput) SetNextBackwardToken(v string) *GetLogEventsOutput

SetNextBackwardToken sets the NextBackwardToken field's value.

func (*GetLogEventsOutput) SetNextForwardToken

func (s *GetLogEventsOutput) SetNextForwardToken(v string) *GetLogEventsOutput

SetNextForwardToken sets the NextForwardToken field's value.

func (GetLogEventsOutput) String

func (s GetLogEventsOutput) String() string

String returns the string representation

type InputLogEvent

type InputLogEvent struct {

	// The raw event message.
	//
	// Message is a required field
	Message *string `locationName:"message" min:"1" type:"string" required:"true"`

	// The time the event occurred.
	//
	// Timestamp is a required field
	Timestamp *int64 `locationName:"timestamp" type:"long" required:"true"`
	// contains filtered or unexported fields
}

Represents a log event, which is a record of activity that was recorded by the application or resource being monitored.

func (InputLogEvent) GoString

func (s InputLogEvent) GoString() string

GoString returns the string representation

func (*InputLogEvent) SetMessage

func (s *InputLogEvent) SetMessage(v string) *InputLogEvent

SetMessage sets the Message field's value.

func (*InputLogEvent) SetTimestamp

func (s *InputLogEvent) SetTimestamp(v int64) *InputLogEvent

SetTimestamp sets the Timestamp field's value.

func (InputLogEvent) String

func (s InputLogEvent) String() string

String returns the string representation

func (*InputLogEvent) Validate

func (s *InputLogEvent) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LogGroup

type LogGroup struct {

	// The Amazon Resource Name (ARN) of the log group.
	Arn *string `locationName:"arn" type:"string"`

	// The creation time of the log group.
	CreationTime *int64 `locationName:"creationTime" type:"long"`

	// The name of the log group.
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string"`

	// The number of metric filters.
	MetricFilterCount *int64 `locationName:"metricFilterCount" type:"integer"`

	// The number of days to retain the log events in the specified log group. Possible
	// values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731,
	// 1827, and 3653.
	RetentionInDays *int64 `locationName:"retentionInDays" type:"integer"`

	// The number of bytes stored.
	StoredBytes *int64 `locationName:"storedBytes" type:"long"`
	// contains filtered or unexported fields
}

Represents a log group.

func (LogGroup) GoString

func (s LogGroup) GoString() string

GoString returns the string representation

func (*LogGroup) SetArn

func (s *LogGroup) SetArn(v string) *LogGroup

SetArn sets the Arn field's value.

func (*LogGroup) SetCreationTime

func (s *LogGroup) SetCreationTime(v int64) *LogGroup

SetCreationTime sets the CreationTime field's value.

func (*LogGroup) SetLogGroupName

func (s *LogGroup) SetLogGroupName(v string) *LogGroup

SetLogGroupName sets the LogGroupName field's value.

func (*LogGroup) SetMetricFilterCount

func (s *LogGroup) SetMetricFilterCount(v int64) *LogGroup

SetMetricFilterCount sets the MetricFilterCount field's value.

func (*LogGroup) SetRetentionInDays

func (s *LogGroup) SetRetentionInDays(v int64) *LogGroup

SetRetentionInDays sets the RetentionInDays field's value.

func (*LogGroup) SetStoredBytes

func (s *LogGroup) SetStoredBytes(v int64) *LogGroup

SetStoredBytes sets the StoredBytes field's value.

func (LogGroup) String

func (s LogGroup) String() string

String returns the string representation

type LogStream

type LogStream struct {

	// The Amazon Resource Name (ARN) of the log stream.
	Arn *string `locationName:"arn" type:"string"`

	// The creation time of the stream.
	CreationTime *int64 `locationName:"creationTime" type:"long"`

	// The time of the first event.
	FirstEventTimestamp *int64 `locationName:"firstEventTimestamp" type:"long"`

	// The time of the last event.
	LastEventTimestamp *int64 `locationName:"lastEventTimestamp" type:"long"`

	// The ingestion time.
	LastIngestionTime *int64 `locationName:"lastIngestionTime" type:"long"`

	// The name of the log stream.
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string"`

	// The number of bytes stored.
	StoredBytes *int64 `locationName:"storedBytes" type:"long"`

	// The sequence token.
	UploadSequenceToken *string `locationName:"uploadSequenceToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

Represents a log stream, which is a sequence of log events from a single emitter of logs.

func (LogStream) GoString

func (s LogStream) GoString() string

GoString returns the string representation

func (*LogStream) SetArn

func (s *LogStream) SetArn(v string) *LogStream

SetArn sets the Arn field's value.

func (*LogStream) SetCreationTime

func (s *LogStream) SetCreationTime(v int64) *LogStream

SetCreationTime sets the CreationTime field's value.

func (*LogStream) SetFirstEventTimestamp

func (s *LogStream) SetFirstEventTimestamp(v int64) *LogStream

SetFirstEventTimestamp sets the FirstEventTimestamp field's value.

func (*LogStream) SetLastEventTimestamp

func (s *LogStream) SetLastEventTimestamp(v int64) *LogStream

SetLastEventTimestamp sets the LastEventTimestamp field's value.

func (*LogStream) SetLastIngestionTime

func (s *LogStream) SetLastIngestionTime(v int64) *LogStream

SetLastIngestionTime sets the LastIngestionTime field's value.

func (*LogStream) SetLogStreamName

func (s *LogStream) SetLogStreamName(v string) *LogStream

SetLogStreamName sets the LogStreamName field's value.

func (*LogStream) SetStoredBytes

func (s *LogStream) SetStoredBytes(v int64) *LogStream

SetStoredBytes sets the StoredBytes field's value.

func (*LogStream) SetUploadSequenceToken

func (s *LogStream) SetUploadSequenceToken(v string) *LogStream

SetUploadSequenceToken sets the UploadSequenceToken field's value.

func (LogStream) String

func (s LogStream) String() string

String returns the string representation

type MetricFilter

type MetricFilter struct {

	// The creation time of the metric filter.
	CreationTime *int64 `locationName:"creationTime" type:"long"`

	// The name of the metric filter.
	FilterName *string `locationName:"filterName" min:"1" type:"string"`

	// A symbolic description of how CloudWatch Logs should interpret the data in
	// each log event. For example, a log event may contain timestamps, IP addresses,
	// strings, and so on. You use the filter pattern to specify what to look for
	// in the log event message.
	FilterPattern *string `locationName:"filterPattern" type:"string"`

	// The name of the log group.
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string"`

	// The metric transformations.
	MetricTransformations []*MetricTransformation `locationName:"metricTransformations" min:"1" type:"list"`
	// contains filtered or unexported fields
}

Metric filters express how CloudWatch Logs would extract metric observations from ingested log events and transform them into metric data in a CloudWatch metric.

func (MetricFilter) GoString

func (s MetricFilter) GoString() string

GoString returns the string representation

func (*MetricFilter) SetCreationTime

func (s *MetricFilter) SetCreationTime(v int64) *MetricFilter

SetCreationTime sets the CreationTime field's value.

func (*MetricFilter) SetFilterName

func (s *MetricFilter) SetFilterName(v string) *MetricFilter

SetFilterName sets the FilterName field's value.

func (*MetricFilter) SetFilterPattern

func (s *MetricFilter) SetFilterPattern(v string) *MetricFilter

SetFilterPattern sets the FilterPattern field's value.

func (*MetricFilter) SetLogGroupName

func (s *MetricFilter) SetLogGroupName(v string) *MetricFilter

SetLogGroupName sets the LogGroupName field's value.

func (*MetricFilter) SetMetricTransformations

func (s *MetricFilter) SetMetricTransformations(v []*MetricTransformation) *MetricFilter

SetMetricTransformations sets the MetricTransformations field's value.

func (MetricFilter) String

func (s MetricFilter) String() string

String returns the string representation

type MetricFilterMatchRecord

type MetricFilterMatchRecord struct {

	// The raw event data.
	EventMessage *string `locationName:"eventMessage" min:"1" type:"string"`

	// The event number.
	EventNumber *int64 `locationName:"eventNumber" type:"long"`

	// The values extracted from the event data by the filter.
	ExtractedValues map[string]*string `locationName:"extractedValues" type:"map"`
	// contains filtered or unexported fields
}

Represents a matched event.

func (MetricFilterMatchRecord) GoString

func (s MetricFilterMatchRecord) GoString() string

GoString returns the string representation

func (*MetricFilterMatchRecord) SetEventMessage

SetEventMessage sets the EventMessage field's value.

func (*MetricFilterMatchRecord) SetEventNumber

SetEventNumber sets the EventNumber field's value.

func (*MetricFilterMatchRecord) SetExtractedValues

func (s *MetricFilterMatchRecord) SetExtractedValues(v map[string]*string) *MetricFilterMatchRecord

SetExtractedValues sets the ExtractedValues field's value.

func (MetricFilterMatchRecord) String

func (s MetricFilterMatchRecord) String() string

String returns the string representation

type MetricTransformation

type MetricTransformation struct {

	// (Optional) The value to emit when a filter pattern does not match a log event.
	// This value can be null.
	DefaultValue *float64 `locationName:"defaultValue" type:"double"`

	// The name of the CloudWatch metric.
	//
	// MetricName is a required field
	MetricName *string `locationName:"metricName" type:"string" required:"true"`

	// The namespace of the CloudWatch metric.
	//
	// MetricNamespace is a required field
	MetricNamespace *string `locationName:"metricNamespace" type:"string" required:"true"`

	// The value to publish to the CloudWatch metric when a filter pattern matches
	// a log event.
	//
	// MetricValue is a required field
	MetricValue *string `locationName:"metricValue" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Indicates how to transform ingested log events into metric data in a CloudWatch metric.

func (MetricTransformation) GoString

func (s MetricTransformation) GoString() string

GoString returns the string representation

func (*MetricTransformation) SetDefaultValue

func (s *MetricTransformation) SetDefaultValue(v float64) *MetricTransformation

SetDefaultValue sets the DefaultValue field's value.

func (*MetricTransformation) SetMetricName

func (s *MetricTransformation) SetMetricName(v string) *MetricTransformation

SetMetricName sets the MetricName field's value.

func (*MetricTransformation) SetMetricNamespace

func (s *MetricTransformation) SetMetricNamespace(v string) *MetricTransformation

SetMetricNamespace sets the MetricNamespace field's value.

func (*MetricTransformation) SetMetricValue

func (s *MetricTransformation) SetMetricValue(v string) *MetricTransformation

SetMetricValue sets the MetricValue field's value.

func (MetricTransformation) String

func (s MetricTransformation) String() string

String returns the string representation

func (*MetricTransformation) Validate

func (s *MetricTransformation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type OutputLogEvent

type OutputLogEvent struct {

	// The time the event was ingested.
	IngestionTime *int64 `locationName:"ingestionTime" type:"long"`

	// The data contained in the log event.
	Message *string `locationName:"message" min:"1" type:"string"`

	// The time the event occurred.
	Timestamp *int64 `locationName:"timestamp" type:"long"`
	// contains filtered or unexported fields
}

Represents a log event.

func (OutputLogEvent) GoString

func (s OutputLogEvent) GoString() string

GoString returns the string representation

func (*OutputLogEvent) SetIngestionTime

func (s *OutputLogEvent) SetIngestionTime(v int64) *OutputLogEvent

SetIngestionTime sets the IngestionTime field's value.

func (*OutputLogEvent) SetMessage

func (s *OutputLogEvent) SetMessage(v string) *OutputLogEvent

SetMessage sets the Message field's value.

func (*OutputLogEvent) SetTimestamp

func (s *OutputLogEvent) SetTimestamp(v int64) *OutputLogEvent

SetTimestamp sets the Timestamp field's value.

func (OutputLogEvent) String

func (s OutputLogEvent) String() string

String returns the string representation

type PutDestinationInput

type PutDestinationInput struct {

	// A name for the destination.
	//
	// DestinationName is a required field
	DestinationName *string `locationName:"destinationName" min:"1" type:"string" required:"true"`

	// The ARN of an IAM role that grants CloudWatch Logs permissions to call Amazon
	// Kinesis PutRecord on the destination stream.
	//
	// RoleArn is a required field
	RoleArn *string `locationName:"roleArn" min:"1" type:"string" required:"true"`

	// The ARN of an Amazon Kinesis stream to deliver matching log events to.
	//
	// TargetArn is a required field
	TargetArn *string `locationName:"targetArn" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutDestinationInput) GoString

func (s PutDestinationInput) GoString() string

GoString returns the string representation

func (*PutDestinationInput) SetDestinationName

func (s *PutDestinationInput) SetDestinationName(v string) *PutDestinationInput

SetDestinationName sets the DestinationName field's value.

func (*PutDestinationInput) SetRoleArn

SetRoleArn sets the RoleArn field's value.

func (*PutDestinationInput) SetTargetArn

func (s *PutDestinationInput) SetTargetArn(v string) *PutDestinationInput

SetTargetArn sets the TargetArn field's value.

func (PutDestinationInput) String

func (s PutDestinationInput) String() string

String returns the string representation

func (*PutDestinationInput) Validate

func (s *PutDestinationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutDestinationOutput

type PutDestinationOutput struct {

	// The destination.
	Destination *Destination `locationName:"destination" type:"structure"`
	// contains filtered or unexported fields
}

func (PutDestinationOutput) GoString

func (s PutDestinationOutput) GoString() string

GoString returns the string representation

func (*PutDestinationOutput) SetDestination

func (s *PutDestinationOutput) SetDestination(v *Destination) *PutDestinationOutput

SetDestination sets the Destination field's value.

func (PutDestinationOutput) String

func (s PutDestinationOutput) String() string

String returns the string representation

type PutDestinationPolicyInput

type PutDestinationPolicyInput struct {

	// An IAM policy document that authorizes cross-account users to deliver their
	// log events to the associated destination.
	//
	// AccessPolicy is a required field
	AccessPolicy *string `locationName:"accessPolicy" min:"1" type:"string" required:"true"`

	// A name for an existing destination.
	//
	// DestinationName is a required field
	DestinationName *string `locationName:"destinationName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutDestinationPolicyInput) GoString

func (s PutDestinationPolicyInput) GoString() string

GoString returns the string representation

func (*PutDestinationPolicyInput) SetAccessPolicy

SetAccessPolicy sets the AccessPolicy field's value.

func (*PutDestinationPolicyInput) SetDestinationName

SetDestinationName sets the DestinationName field's value.

func (PutDestinationPolicyInput) String

func (s PutDestinationPolicyInput) String() string

String returns the string representation

func (*PutDestinationPolicyInput) Validate

func (s *PutDestinationPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutDestinationPolicyOutput

type PutDestinationPolicyOutput struct {
	// contains filtered or unexported fields
}

func (PutDestinationPolicyOutput) GoString

func (s PutDestinationPolicyOutput) GoString() string

GoString returns the string representation

func (PutDestinationPolicyOutput) String

String returns the string representation

type PutLogEventsInput

type PutLogEventsInput struct {

	// The log events.
	//
	// LogEvents is a required field
	LogEvents []*InputLogEvent `locationName:"logEvents" min:"1" type:"list" required:"true"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The name of the log stream.
	//
	// LogStreamName is a required field
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string" required:"true"`

	// The sequence token.
	SequenceToken *string `locationName:"sequenceToken" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (PutLogEventsInput) GoString

func (s PutLogEventsInput) GoString() string

GoString returns the string representation

func (*PutLogEventsInput) SetLogEvents

func (s *PutLogEventsInput) SetLogEvents(v []*InputLogEvent) *PutLogEventsInput

SetLogEvents sets the LogEvents field's value.

func (*PutLogEventsInput) SetLogGroupName

func (s *PutLogEventsInput) SetLogGroupName(v string) *PutLogEventsInput

SetLogGroupName sets the LogGroupName field's value.

func (*PutLogEventsInput) SetLogStreamName

func (s *PutLogEventsInput) SetLogStreamName(v string) *PutLogEventsInput

SetLogStreamName sets the LogStreamName field's value.

func (*PutLogEventsInput) SetSequenceToken

func (s *PutLogEventsInput) SetSequenceToken(v string) *PutLogEventsInput

SetSequenceToken sets the SequenceToken field's value.

func (PutLogEventsInput) String

func (s PutLogEventsInput) String() string

String returns the string representation

func (*PutLogEventsInput) Validate

func (s *PutLogEventsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutLogEventsOutput

type PutLogEventsOutput struct {

	// The next sequence token.
	NextSequenceToken *string `locationName:"nextSequenceToken" min:"1" type:"string"`

	// The rejected events.
	RejectedLogEventsInfo *RejectedLogEventsInfo `locationName:"rejectedLogEventsInfo" type:"structure"`
	// contains filtered or unexported fields
}

func (PutLogEventsOutput) GoString

func (s PutLogEventsOutput) GoString() string

GoString returns the string representation

func (*PutLogEventsOutput) SetNextSequenceToken

func (s *PutLogEventsOutput) SetNextSequenceToken(v string) *PutLogEventsOutput

SetNextSequenceToken sets the NextSequenceToken field's value.

func (*PutLogEventsOutput) SetRejectedLogEventsInfo

func (s *PutLogEventsOutput) SetRejectedLogEventsInfo(v *RejectedLogEventsInfo) *PutLogEventsOutput

SetRejectedLogEventsInfo sets the RejectedLogEventsInfo field's value.

func (PutLogEventsOutput) String

func (s PutLogEventsOutput) String() string

String returns the string representation

type PutMetricFilterInput

type PutMetricFilterInput struct {

	// A name for the metric filter.
	//
	// FilterName is a required field
	FilterName *string `locationName:"filterName" min:"1" type:"string" required:"true"`

	// A filter pattern for extracting metric data out of ingested log events.
	//
	// FilterPattern is a required field
	FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// A collection of information needed to define how metric data gets emitted.
	//
	// MetricTransformations is a required field
	MetricTransformations []*MetricTransformation `locationName:"metricTransformations" min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (PutMetricFilterInput) GoString

func (s PutMetricFilterInput) GoString() string

GoString returns the string representation

func (*PutMetricFilterInput) SetFilterName

func (s *PutMetricFilterInput) SetFilterName(v string) *PutMetricFilterInput

SetFilterName sets the FilterName field's value.

func (*PutMetricFilterInput) SetFilterPattern

func (s *PutMetricFilterInput) SetFilterPattern(v string) *PutMetricFilterInput

SetFilterPattern sets the FilterPattern field's value.

func (*PutMetricFilterInput) SetLogGroupName

func (s *PutMetricFilterInput) SetLogGroupName(v string) *PutMetricFilterInput

SetLogGroupName sets the LogGroupName field's value.

func (*PutMetricFilterInput) SetMetricTransformations

func (s *PutMetricFilterInput) SetMetricTransformations(v []*MetricTransformation) *PutMetricFilterInput

SetMetricTransformations sets the MetricTransformations field's value.

func (PutMetricFilterInput) String

func (s PutMetricFilterInput) String() string

String returns the string representation

func (*PutMetricFilterInput) Validate

func (s *PutMetricFilterInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutMetricFilterOutput

type PutMetricFilterOutput struct {
	// contains filtered or unexported fields
}

func (PutMetricFilterOutput) GoString

func (s PutMetricFilterOutput) GoString() string

GoString returns the string representation

func (PutMetricFilterOutput) String

func (s PutMetricFilterOutput) String() string

String returns the string representation

type PutRetentionPolicyInput

type PutRetentionPolicyInput struct {

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The number of days to retain the log events in the specified log group. Possible
	// values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731,
	// 1827, and 3653.
	//
	// RetentionInDays is a required field
	RetentionInDays *int64 `locationName:"retentionInDays" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

func (PutRetentionPolicyInput) GoString

func (s PutRetentionPolicyInput) GoString() string

GoString returns the string representation

func (*PutRetentionPolicyInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (*PutRetentionPolicyInput) SetRetentionInDays

func (s *PutRetentionPolicyInput) SetRetentionInDays(v int64) *PutRetentionPolicyInput

SetRetentionInDays sets the RetentionInDays field's value.

func (PutRetentionPolicyInput) String

func (s PutRetentionPolicyInput) String() string

String returns the string representation

func (*PutRetentionPolicyInput) Validate

func (s *PutRetentionPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutRetentionPolicyOutput

type PutRetentionPolicyOutput struct {
	// contains filtered or unexported fields
}

func (PutRetentionPolicyOutput) GoString

func (s PutRetentionPolicyOutput) GoString() string

GoString returns the string representation

func (PutRetentionPolicyOutput) String

func (s PutRetentionPolicyOutput) String() string

String returns the string representation

type PutSubscriptionFilterInput

type PutSubscriptionFilterInput struct {

	// The ARN of the destination to deliver matching log events to. Currently,
	// the supported destinations are:
	//
	//    * An Amazon Kinesis stream belonging to the same account as the subscription
	//    filter, for same-account delivery.
	//
	//    * A logical destination (specified using an ARN) belonging to a different
	//    account, for cross-account delivery.
	//
	//    * An Amazon Kinesis Firehose stream belonging to the same account as the
	//    subscription filter, for same-account delivery.
	//
	//    * An AWS Lambda function belonging to the same account as the subscription
	//    filter, for same-account delivery.
	//
	// DestinationArn is a required field
	DestinationArn *string `locationName:"destinationArn" min:"1" type:"string" required:"true"`

	// A name for the subscription filter.
	//
	// FilterName is a required field
	FilterName *string `locationName:"filterName" min:"1" type:"string" required:"true"`

	// A filter pattern for subscribing to a filtered stream of log events.
	//
	// FilterPattern is a required field
	FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"`

	// The name of the log group.
	//
	// LogGroupName is a required field
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"`

	// The ARN of an IAM role that grants CloudWatch Logs permissions to deliver
	// ingested log events to the destination stream. You don't need to provide
	// the ARN when you are working with a logical destination for cross-account
	// delivery.
	RoleArn *string `locationName:"roleArn" min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (PutSubscriptionFilterInput) GoString

func (s PutSubscriptionFilterInput) GoString() string

GoString returns the string representation

func (*PutSubscriptionFilterInput) SetDestinationArn

SetDestinationArn sets the DestinationArn field's value.

func (*PutSubscriptionFilterInput) SetFilterName

SetFilterName sets the FilterName field's value.

func (*PutSubscriptionFilterInput) SetFilterPattern

SetFilterPattern sets the FilterPattern field's value.

func (*PutSubscriptionFilterInput) SetLogGroupName

SetLogGroupName sets the LogGroupName field's value.

func (*PutSubscriptionFilterInput) SetRoleArn

SetRoleArn sets the RoleArn field's value.

func (PutSubscriptionFilterInput) String

String returns the string representation

func (*PutSubscriptionFilterInput) Validate

func (s *PutSubscriptionFilterInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutSubscriptionFilterOutput

type PutSubscriptionFilterOutput struct {
	// contains filtered or unexported fields
}

func (PutSubscriptionFilterOutput) GoString

func (s PutSubscriptionFilterOutput) GoString() string

GoString returns the string representation

func (PutSubscriptionFilterOutput) String

String returns the string representation

type RejectedLogEventsInfo

type RejectedLogEventsInfo struct {

	// The expired log events.
	ExpiredLogEventEndIndex *int64 `locationName:"expiredLogEventEndIndex" type:"integer"`

	// The log events that are too new.
	TooNewLogEventStartIndex *int64 `locationName:"tooNewLogEventStartIndex" type:"integer"`

	// The log events that are too old.
	TooOldLogEventEndIndex *int64 `locationName:"tooOldLogEventEndIndex" type:"integer"`
	// contains filtered or unexported fields
}

Represents the rejected events.

func (RejectedLogEventsInfo) GoString

func (s RejectedLogEventsInfo) GoString() string

GoString returns the string representation

func (*RejectedLogEventsInfo) SetExpiredLogEventEndIndex

func (s *RejectedLogEventsInfo) SetExpiredLogEventEndIndex(v int64) *RejectedLogEventsInfo

SetExpiredLogEventEndIndex sets the ExpiredLogEventEndIndex field's value.

func (*RejectedLogEventsInfo) SetTooNewLogEventStartIndex

func (s *RejectedLogEventsInfo) SetTooNewLogEventStartIndex(v int64) *RejectedLogEventsInfo

SetTooNewLogEventStartIndex sets the TooNewLogEventStartIndex field's value.

func (*RejectedLogEventsInfo) SetTooOldLogEventEndIndex

func (s *RejectedLogEventsInfo) SetTooOldLogEventEndIndex(v int64) *RejectedLogEventsInfo

SetTooOldLogEventEndIndex sets the TooOldLogEventEndIndex field's value.

func (RejectedLogEventsInfo) String

func (s RejectedLogEventsInfo) String() string

String returns the string representation

type SearchedLogStream

type SearchedLogStream struct {

	// The name of the log stream.
	LogStreamName *string `locationName:"logStreamName" min:"1" type:"string"`

	// Indicates whether all the events in this log stream were searched.
	SearchedCompletely *bool `locationName:"searchedCompletely" type:"boolean"`
	// contains filtered or unexported fields
}

Represents the search status of a log stream.

func (SearchedLogStream) GoString

func (s SearchedLogStream) GoString() string

GoString returns the string representation

func (*SearchedLogStream) SetLogStreamName

func (s *SearchedLogStream) SetLogStreamName(v string) *SearchedLogStream

SetLogStreamName sets the LogStreamName field's value.

func (*SearchedLogStream) SetSearchedCompletely

func (s *SearchedLogStream) SetSearchedCompletely(v bool) *SearchedLogStream

SetSearchedCompletely sets the SearchedCompletely field's value.

func (SearchedLogStream) String

func (s SearchedLogStream) String() string

String returns the string representation

type SubscriptionFilter

type SubscriptionFilter struct {

	// The creation time of the subscription filter.
	CreationTime *int64 `locationName:"creationTime" type:"long"`

	// The Amazon Resource Name (ARN) of the destination.
	DestinationArn *string `locationName:"destinationArn" min:"1" type:"string"`

	// The name of the subscription filter.
	FilterName *string `locationName:"filterName" min:"1" type:"string"`

	// A symbolic description of how CloudWatch Logs should interpret the data in
	// each log event. For example, a log event may contain timestamps, IP addresses,
	// strings, and so on. You use the filter pattern to specify what to look for
	// in the log event message.
	FilterPattern *string `locationName:"filterPattern" type:"string"`

	// The name of the log group.
	LogGroupName *string `locationName:"logGroupName" min:"1" type:"string"`

	RoleArn *string `locationName:"roleArn" min:"1" type:"string"`
	// contains filtered or unexported fields
}

Represents a subscription filter.

func (SubscriptionFilter) GoString

func (s SubscriptionFilter) GoString() string

GoString returns the string representation

func (*SubscriptionFilter) SetCreationTime

func (s *SubscriptionFilter) SetCreationTime(v int64) *SubscriptionFilter

SetCreationTime sets the CreationTime field's value.

func (*SubscriptionFilter) SetDestinationArn

func (s *SubscriptionFilter) SetDestinationArn(v string) *SubscriptionFilter

SetDestinationArn sets the DestinationArn field's value.

func (*SubscriptionFilter) SetFilterName

func (s *SubscriptionFilter) SetFilterName(v string) *SubscriptionFilter

SetFilterName sets the FilterName field's value.

func (*SubscriptionFilter) SetFilterPattern

func (s *SubscriptionFilter) SetFilterPattern(v string) *SubscriptionFilter

SetFilterPattern sets the FilterPattern field's value.

func (*SubscriptionFilter) SetLogGroupName

func (s *SubscriptionFilter) SetLogGroupName(v string) *SubscriptionFilter

SetLogGroupName sets the LogGroupName field's value.

func (*SubscriptionFilter) SetRoleArn

func (s *SubscriptionFilter) SetRoleArn(v string) *SubscriptionFilter

SetRoleArn sets the RoleArn field's value.

func (SubscriptionFilter) String

func (s SubscriptionFilter) String() string

String returns the string representation

type TestMetricFilterInput

type TestMetricFilterInput struct {

	// A symbolic description of how CloudWatch Logs should interpret the data in
	// each log event. For example, a log event may contain timestamps, IP addresses,
	// strings, and so on. You use the filter pattern to specify what to look for
	// in the log event message.
	//
	// FilterPattern is a required field
	FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"`

	// The log event messages to test.
	//
	// LogEventMessages is a required field
	LogEventMessages []*string `locationName:"logEventMessages" min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (TestMetricFilterInput) GoString

func (s TestMetricFilterInput) GoString() string

GoString returns the string representation

func (*TestMetricFilterInput) SetFilterPattern

func (s *TestMetricFilterInput) SetFilterPattern(v string) *TestMetricFilterInput

SetFilterPattern sets the FilterPattern field's value.

func (*TestMetricFilterInput) SetLogEventMessages

func (s *TestMetricFilterInput) SetLogEventMessages(v []*string) *TestMetricFilterInput

SetLogEventMessages sets the LogEventMessages field's value.

func (TestMetricFilterInput) String

func (s TestMetricFilterInput) String() string

String returns the string representation

func (*TestMetricFilterInput) Validate

func (s *TestMetricFilterInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TestMetricFilterOutput

type TestMetricFilterOutput struct {

	// The matched events.
	Matches []*MetricFilterMatchRecord `locationName:"matches" type:"list"`
	// contains filtered or unexported fields
}

func (TestMetricFilterOutput) GoString

func (s TestMetricFilterOutput) GoString() string

GoString returns the string representation

func (*TestMetricFilterOutput) SetMatches

SetMatches sets the Matches field's value.

func (TestMetricFilterOutput) String

func (s TestMetricFilterOutput) String() string

String returns the string representation

Directories

Path Synopsis
Package cloudwatchlogsiface provides an interface to enable mocking the Amazon CloudWatch Logs service client for testing your code.
Package cloudwatchlogsiface provides an interface to enable mocking the Amazon CloudWatch Logs service client for testing your code.

Jump to

Keyboard shortcuts

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