func AWSRegion_Values() []string
AWSRegion_Values returns all elements of the AWSRegion enum
func AdditionalArtifact_Values() []string
AdditionalArtifact_Values returns all elements of the AdditionalArtifact enum
func CompressionFormat_Values() []string
CompressionFormat_Values returns all elements of the CompressionFormat enum
func ReportFormat_Values() []string
ReportFormat_Values returns all elements of the ReportFormat enum
func ReportVersioning_Values() []string
ReportVersioning_Values returns all elements of the ReportVersioning enum
func SchemaElement_Values() []string
SchemaElement_Values returns all elements of the SchemaElement enum
func TimeUnit_Values() []string
TimeUnit_Values returns all elements of the TimeUnit enum
type CostandUsageReportService struct { *client.Client }
CostandUsageReportService provides the API operation methods for making requests to AWS Cost and Usage Report Service. See this package's package overview docs for details on the service.
CostandUsageReportService methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.
func New(p client.ConfigProvider, cfgs ...*aws.Config) *CostandUsageReportService
New creates a new instance of the CostandUsageReportService 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:
mySession := session.Must(session.NewSession()) // Create a CostandUsageReportService client from just a session. svc := costandusagereportservice.New(mySession) // Create a CostandUsageReportService client with additional configuration svc := costandusagereportservice.New(mySession, aws.NewConfig().WithRegion("us-west-2"))
func (c *CostandUsageReportService) DeleteReportDefinition(input *DeleteReportDefinitionInput) (*DeleteReportDefinitionOutput, error)
DeleteReportDefinition API operation for AWS Cost and Usage Report Service.
Deletes the specified report.
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 AWS Cost and Usage Report Service's API operation DeleteReportDefinition for usage and error information.
Returned Error Types:
* InternalErrorException An error on the server occurred during the processing of your request. Try again later. * ValidationException The input fails to satisfy the constraints specified by an AWS service.
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DeleteReportDefinition
func (c *CostandUsageReportService) DeleteReportDefinitionRequest(input *DeleteReportDefinitionInput) (req *request.Request, output *DeleteReportDefinitionOutput)
DeleteReportDefinitionRequest generates a "aws/request.Request" representing the client's request for the DeleteReportDefinition operation. The "output" return value will be populated with the request's response once the request completes successfully.
Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.
See DeleteReportDefinition for more information on using the DeleteReportDefinition API call, and error handling.
This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.
// Example sending a request using the DeleteReportDefinitionRequest method. req, resp := client.DeleteReportDefinitionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DeleteReportDefinition
func (c *CostandUsageReportService) DeleteReportDefinitionWithContext(ctx aws.Context, input *DeleteReportDefinitionInput, opts ...request.Option) (*DeleteReportDefinitionOutput, error)
DeleteReportDefinitionWithContext is the same as DeleteReportDefinition with the addition of the ability to pass a context and additional request options.
See DeleteReportDefinition for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (c *CostandUsageReportService) DescribeReportDefinitions(input *DescribeReportDefinitionsInput) (*DescribeReportDefinitionsOutput, error)
DescribeReportDefinitions API operation for AWS Cost and Usage Report Service.
Lists the AWS Cost and Usage reports available to this account.
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 AWS Cost and Usage Report Service's API operation DescribeReportDefinitions for usage and error information.
Returned Error Types:
* InternalErrorException An error on the server occurred during the processing of your request. Try again later.
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DescribeReportDefinitions
func (c *CostandUsageReportService) DescribeReportDefinitionsPages(input *DescribeReportDefinitionsInput, fn func(*DescribeReportDefinitionsOutput, bool) bool) error
DescribeReportDefinitionsPages iterates over the pages of a DescribeReportDefinitions operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.
See DescribeReportDefinitions 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 DescribeReportDefinitions operation. pageNum := 0 err := client.DescribeReportDefinitionsPages(params, func(page *costandusagereportservice.DescribeReportDefinitionsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })
func (c *CostandUsageReportService) DescribeReportDefinitionsPagesWithContext(ctx aws.Context, input *DescribeReportDefinitionsInput, fn func(*DescribeReportDefinitionsOutput, bool) bool, opts ...request.Option) error
DescribeReportDefinitionsPagesWithContext same as DescribeReportDefinitionsPages except it takes a Context and allows setting request options on the pages.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (c *CostandUsageReportService) DescribeReportDefinitionsRequest(input *DescribeReportDefinitionsInput) (req *request.Request, output *DescribeReportDefinitionsOutput)
DescribeReportDefinitionsRequest generates a "aws/request.Request" representing the client's request for the DescribeReportDefinitions operation. The "output" return value will be populated with the request's response once the request completes successfully.
Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.
See DescribeReportDefinitions for more information on using the DescribeReportDefinitions API call, and error handling.
This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.
// Example sending a request using the DescribeReportDefinitionsRequest method. req, resp := client.DescribeReportDefinitionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/DescribeReportDefinitions
func (c *CostandUsageReportService) DescribeReportDefinitionsWithContext(ctx aws.Context, input *DescribeReportDefinitionsInput, opts ...request.Option) (*DescribeReportDefinitionsOutput, error)
DescribeReportDefinitionsWithContext is the same as DescribeReportDefinitions with the addition of the ability to pass a context and additional request options.
See DescribeReportDefinitions for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (c *CostandUsageReportService) ModifyReportDefinition(input *ModifyReportDefinitionInput) (*ModifyReportDefinitionOutput, error)
ModifyReportDefinition API operation for AWS Cost and Usage Report Service.
Allows you to programatically update your report preferences.
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 AWS Cost and Usage Report Service's API operation ModifyReportDefinition for usage and error information.
Returned Error Types:
* InternalErrorException An error on the server occurred during the processing of your request. Try again later. * ValidationException The input fails to satisfy the constraints specified by an AWS service.
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/ModifyReportDefinition
func (c *CostandUsageReportService) ModifyReportDefinitionRequest(input *ModifyReportDefinitionInput) (req *request.Request, output *ModifyReportDefinitionOutput)
ModifyReportDefinitionRequest generates a "aws/request.Request" representing the client's request for the ModifyReportDefinition operation. The "output" return value will be populated with the request's response once the request completes successfully.
Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.
See ModifyReportDefinition for more information on using the ModifyReportDefinition API call, and error handling.
This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.
// Example sending a request using the ModifyReportDefinitionRequest method. req, resp := client.ModifyReportDefinitionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/ModifyReportDefinition
func (c *CostandUsageReportService) ModifyReportDefinitionWithContext(ctx aws.Context, input *ModifyReportDefinitionInput, opts ...request.Option) (*ModifyReportDefinitionOutput, error)
ModifyReportDefinitionWithContext is the same as ModifyReportDefinition with the addition of the ability to pass a context and additional request options.
See ModifyReportDefinition for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (c *CostandUsageReportService) PutReportDefinition(input *PutReportDefinitionInput) (*PutReportDefinitionOutput, error)
PutReportDefinition API operation for AWS Cost and Usage Report Service.
Creates a new report using the description that you provide.
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 AWS Cost and Usage Report Service's API operation PutReportDefinition for usage and error information.
Returned Error Types:
* DuplicateReportNameException A report with the specified name already exists in the account. Specify a different report name. * ReportLimitReachedException This account already has five reports defined. To define a new report, you must delete an existing report. * InternalErrorException An error on the server occurred during the processing of your request. Try again later. * ValidationException The input fails to satisfy the constraints specified by an AWS service.
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/PutReportDefinition
func (c *CostandUsageReportService) PutReportDefinitionRequest(input *PutReportDefinitionInput) (req *request.Request, output *PutReportDefinitionOutput)
PutReportDefinitionRequest generates a "aws/request.Request" representing the client's request for the PutReportDefinition operation. The "output" return value will be populated with the request's response once the request completes successfully.
Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.
See PutReportDefinition for more information on using the PutReportDefinition API call, and error handling.
This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.
// Example sending a request using the PutReportDefinitionRequest method. req, resp := client.PutReportDefinitionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
See also, https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06/PutReportDefinition
func (c *CostandUsageReportService) PutReportDefinitionWithContext(ctx aws.Context, input *PutReportDefinitionInput, opts ...request.Option) (*PutReportDefinitionOutput, error)
PutReportDefinitionWithContext is the same as PutReportDefinition with the addition of the ability to pass a context and additional request options.
See PutReportDefinition for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
type DeleteReportDefinitionInput struct { // The name of the report that you want to delete. The name must be unique, // is case sensitive, and can't include spaces. ReportName *string `type:"string"` // contains filtered or unexported fields }
Deletes the specified report.
func (s DeleteReportDefinitionInput) GoString() string
GoString returns the string representation
func (s *DeleteReportDefinitionInput) SetReportName(v string) *DeleteReportDefinitionInput
SetReportName sets the ReportName field's value.
func (s DeleteReportDefinitionInput) String() string
String returns the string representation
type DeleteReportDefinitionOutput struct { // Whether the deletion was successful or not. ResponseMessage *string `type:"string"` // contains filtered or unexported fields }
If the action is successful, the service sends back an HTTP 200 response.
func (s DeleteReportDefinitionOutput) GoString() string
GoString returns the string representation
func (s *DeleteReportDefinitionOutput) SetResponseMessage(v string) *DeleteReportDefinitionOutput
SetResponseMessage sets the ResponseMessage field's value.
func (s DeleteReportDefinitionOutput) String() string
String returns the string representation
type DescribeReportDefinitionsInput struct { // The maximum number of results that AWS returns for the operation. MaxResults *int64 `min:"5" type:"integer"` // A generic string. NextToken *string `type:"string"` // contains filtered or unexported fields }
Requests a list of AWS Cost and Usage reports owned by the account.
func (s DescribeReportDefinitionsInput) GoString() string
GoString returns the string representation
func (s *DescribeReportDefinitionsInput) SetMaxResults(v int64) *DescribeReportDefinitionsInput
SetMaxResults sets the MaxResults field's value.
func (s *DescribeReportDefinitionsInput) SetNextToken(v string) *DescribeReportDefinitionsInput
SetNextToken sets the NextToken field's value.
func (s DescribeReportDefinitionsInput) String() string
String returns the string representation
func (s *DescribeReportDefinitionsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DescribeReportDefinitionsOutput struct { // A generic string. NextToken *string `type:"string"` // A list of AWS Cost and Usage reports owned by the account. ReportDefinitions []*ReportDefinition `type:"list"` // contains filtered or unexported fields }
If the action is successful, the service sends back an HTTP 200 response.
func (s DescribeReportDefinitionsOutput) GoString() string
GoString returns the string representation
func (s *DescribeReportDefinitionsOutput) SetNextToken(v string) *DescribeReportDefinitionsOutput
SetNextToken sets the NextToken field's value.
func (s *DescribeReportDefinitionsOutput) SetReportDefinitions(v []*ReportDefinition) *DescribeReportDefinitionsOutput
SetReportDefinitions sets the ReportDefinitions field's value.
func (s DescribeReportDefinitionsOutput) String() string
String returns the string representation
type DuplicateReportNameException struct { RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` // A message to show the detail of the exception. Message_ *string `locationName:"Message" type:"string"` // contains filtered or unexported fields }
A report with the specified name already exists in the account. Specify a different report name.
func (s *DuplicateReportNameException) Code() string
Code returns the exception type name.
func (s *DuplicateReportNameException) Error() string
func (s DuplicateReportNameException) GoString() string
GoString returns the string representation
func (s *DuplicateReportNameException) Message() string
Message returns the exception's message.
func (s *DuplicateReportNameException) OrigErr() error
OrigErr always returns nil, satisfies awserr.Error interface.
func (s *DuplicateReportNameException) RequestID() string
RequestID returns the service's response RequestID for request.
func (s *DuplicateReportNameException) StatusCode() int
Status code returns the HTTP status code for the request's response error.
func (s DuplicateReportNameException) String() string
String returns the string representation
type InternalErrorException struct { RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` // A message to show the detail of the exception. Message_ *string `locationName:"Message" type:"string"` // contains filtered or unexported fields }
An error on the server occurred during the processing of your request. Try again later.
func (s *InternalErrorException) Code() string
Code returns the exception type name.
func (s *InternalErrorException) Error() string
func (s InternalErrorException) GoString() string
GoString returns the string representation
func (s *InternalErrorException) Message() string
Message returns the exception's message.
func (s *InternalErrorException) OrigErr() error
OrigErr always returns nil, satisfies awserr.Error interface.
func (s *InternalErrorException) RequestID() string
RequestID returns the service's response RequestID for request.
func (s *InternalErrorException) StatusCode() int
Status code returns the HTTP status code for the request's response error.
func (s InternalErrorException) String() string
String returns the string representation
type ModifyReportDefinitionInput struct { // The definition of AWS Cost and Usage Report. You can specify the report name, // time unit, report format, compression format, S3 bucket, additional artifacts, // and schema elements in the definition. // // ReportDefinition is a required field ReportDefinition *ReportDefinition `type:"structure" required:"true"` // The name of the report that you want to create. The name must be unique, // is case sensitive, and can't include spaces. // // ReportName is a required field ReportName *string `type:"string" required:"true"` // contains filtered or unexported fields }
func (s ModifyReportDefinitionInput) GoString() string
GoString returns the string representation
func (s *ModifyReportDefinitionInput) SetReportDefinition(v *ReportDefinition) *ModifyReportDefinitionInput
SetReportDefinition sets the ReportDefinition field's value.
func (s *ModifyReportDefinitionInput) SetReportName(v string) *ModifyReportDefinitionInput
SetReportName sets the ReportName field's value.
func (s ModifyReportDefinitionInput) String() string
String returns the string representation
func (s *ModifyReportDefinitionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ModifyReportDefinitionOutput struct {
// contains filtered or unexported fields
}
func (s ModifyReportDefinitionOutput) GoString() string
GoString returns the string representation
func (s ModifyReportDefinitionOutput) String() string
String returns the string representation
type PutReportDefinitionInput struct { // Represents the output of the PutReportDefinition operation. The content consists // of the detailed metadata and data file information. // // ReportDefinition is a required field ReportDefinition *ReportDefinition `type:"structure" required:"true"` // contains filtered or unexported fields }
Creates a Cost and Usage Report.
func (s PutReportDefinitionInput) GoString() string
GoString returns the string representation
func (s *PutReportDefinitionInput) SetReportDefinition(v *ReportDefinition) *PutReportDefinitionInput
SetReportDefinition sets the ReportDefinition field's value.
func (s PutReportDefinitionInput) String() string
String returns the string representation
func (s *PutReportDefinitionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutReportDefinitionOutput struct {
// contains filtered or unexported fields
}
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
func (s PutReportDefinitionOutput) GoString() string
GoString returns the string representation
func (s PutReportDefinitionOutput) String() string
String returns the string representation
type ReportDefinition struct { // A list of manifests that you want Amazon Web Services to create for this // report. AdditionalArtifacts []*string `type:"list"` // A list of strings that indicate additional content that Amazon Web Services // includes in the report, such as individual resource IDs. // // AdditionalSchemaElements is a required field AdditionalSchemaElements []*string `type:"list" required:"true"` // The compression format that AWS uses for the report. // // Compression is a required field Compression *string `type:"string" required:"true" enum:"CompressionFormat"` // The format that AWS saves the report in. // // Format is a required field Format *string `type:"string" required:"true" enum:"ReportFormat"` // Whether you want Amazon Web Services to update your reports after they have // been finalized if Amazon Web Services detects charges related to previous // months. These charges can include refunds, credits, or support fees. RefreshClosedReports *bool `type:"boolean"` // The name of the report that you want to create. The name must be unique, // is case sensitive, and can't include spaces. // // ReportName is a required field ReportName *string `type:"string" required:"true"` // Whether you want Amazon Web Services to overwrite the previous version of // each report or to deliver the report in addition to the previous versions. ReportVersioning *string `type:"string" enum:"ReportVersioning"` // The S3 bucket where AWS delivers the report. // // S3Bucket is a required field S3Bucket *string `type:"string" required:"true"` // The prefix that AWS adds to the report name when AWS delivers the report. // Your prefix can't include spaces. // // S3Prefix is a required field S3Prefix *string `type:"string" required:"true"` // The region of the S3 bucket that AWS delivers the report into. // // S3Region is a required field S3Region *string `type:"string" required:"true" enum:"AWSRegion"` // The length of time covered by the report. // // TimeUnit is a required field TimeUnit *string `type:"string" required:"true" enum:"TimeUnit"` // contains filtered or unexported fields }
The definition of AWS Cost and Usage Report. You can specify the report name, time unit, report format, compression format, S3 bucket, additional artifacts, and schema elements in the definition.
func (s ReportDefinition) GoString() string
GoString returns the string representation
func (s *ReportDefinition) SetAdditionalArtifacts(v []*string) *ReportDefinition
SetAdditionalArtifacts sets the AdditionalArtifacts field's value.
func (s *ReportDefinition) SetAdditionalSchemaElements(v []*string) *ReportDefinition
SetAdditionalSchemaElements sets the AdditionalSchemaElements field's value.
func (s *ReportDefinition) SetCompression(v string) *ReportDefinition
SetCompression sets the Compression field's value.
func (s *ReportDefinition) SetFormat(v string) *ReportDefinition
SetFormat sets the Format field's value.
func (s *ReportDefinition) SetRefreshClosedReports(v bool) *ReportDefinition
SetRefreshClosedReports sets the RefreshClosedReports field's value.
func (s *ReportDefinition) SetReportName(v string) *ReportDefinition
SetReportName sets the ReportName field's value.
func (s *ReportDefinition) SetReportVersioning(v string) *ReportDefinition
SetReportVersioning sets the ReportVersioning field's value.
func (s *ReportDefinition) SetS3Bucket(v string) *ReportDefinition
SetS3Bucket sets the S3Bucket field's value.
func (s *ReportDefinition) SetS3Prefix(v string) *ReportDefinition
SetS3Prefix sets the S3Prefix field's value.
func (s *ReportDefinition) SetS3Region(v string) *ReportDefinition
SetS3Region sets the S3Region field's value.
func (s *ReportDefinition) SetTimeUnit(v string) *ReportDefinition
SetTimeUnit sets the TimeUnit field's value.
func (s ReportDefinition) String() string
String returns the string representation
func (s *ReportDefinition) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ReportLimitReachedException struct { RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` // A message to show the detail of the exception. Message_ *string `locationName:"Message" type:"string"` // contains filtered or unexported fields }
This account already has five reports defined. To define a new report, you must delete an existing report.
func (s *ReportLimitReachedException) Code() string
Code returns the exception type name.
func (s *ReportLimitReachedException) Error() string
func (s ReportLimitReachedException) GoString() string
GoString returns the string representation
func (s *ReportLimitReachedException) Message() string
Message returns the exception's message.
func (s *ReportLimitReachedException) OrigErr() error
OrigErr always returns nil, satisfies awserr.Error interface.
func (s *ReportLimitReachedException) RequestID() string
RequestID returns the service's response RequestID for request.
func (s *ReportLimitReachedException) StatusCode() int
Status code returns the HTTP status code for the request's response error.
func (s ReportLimitReachedException) String() string
String returns the string representation
type ValidationException struct { RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` // A message to show the detail of the exception. Message_ *string `locationName:"Message" type:"string"` // contains filtered or unexported fields }
The input fails to satisfy the constraints specified by an AWS service.
func (s *ValidationException) Code() string
Code returns the exception type name.
func (s *ValidationException) Error() string
func (s ValidationException) GoString() string
GoString returns the string representation
func (s *ValidationException) Message() string
Message returns the exception's message.
func (s *ValidationException) OrigErr() error
OrigErr always returns nil, satisfies awserr.Error interface.
func (s *ValidationException) RequestID() string
RequestID returns the service's response RequestID for request.
func (s *ValidationException) StatusCode() int
Status code returns the HTTP status code for the request's response error.
func (s ValidationException) String() string
String returns the string representation