aws-sdk-go: github.com/aws/aws-sdk-go/service/forecastqueryservice Index | Files | Directories

package forecastqueryservice

import "github.com/aws/aws-sdk-go/service/forecastqueryservice"

Package forecastqueryservice provides the client and types for making API requests to Amazon Forecast Query Service.

Provides APIs for creating and managing Amazon Forecast resources.

See https://docs.aws.amazon.com/goto/WebAPI/forecastquery-2018-06-26 for more information on this service.

See forecastqueryservice package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/forecastqueryservice/

Using the Client

To contact Amazon Forecast Query Service with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Amazon Forecast Query Service client ForecastQueryService for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/forecastqueryservice/#New

Index

Package Files

api.go doc.go errors.go service.go

Constants

const (

    // ErrCodeInvalidInputException for service response error code
    // "InvalidInputException".
    //
    // The value that you provided was invalid or too long.
    ErrCodeInvalidInputException = "InvalidInputException"

    // ErrCodeInvalidNextTokenException for service response error code
    // "InvalidNextTokenException".
    //
    // The token is not valid. Tokens expire after 24 hours.
    ErrCodeInvalidNextTokenException = "InvalidNextTokenException"

    // ErrCodeLimitExceededException for service response error code
    // "LimitExceededException".
    //
    // The limit on the number of requests per second has been exceeded.
    ErrCodeLimitExceededException = "LimitExceededException"

    // ErrCodeResourceInUseException for service response error code
    // "ResourceInUseException".
    //
    // The specified resource is in use.
    ErrCodeResourceInUseException = "ResourceInUseException"

    // ErrCodeResourceNotFoundException for service response error code
    // "ResourceNotFoundException".
    //
    // We can't find that resource. Check the information that you've provided and
    // try again.
    ErrCodeResourceNotFoundException = "ResourceNotFoundException"
)
const (
    ServiceName = "forecastquery" // Name of service.
    EndpointsID = ServiceName     // ID to lookup a service endpoint with.
    ServiceID   = "forecastquery" // ServiceID is a unique identifer of a specific service.
)

Service information constants

type DataPoint Uses

type DataPoint struct {

    // The timestamp of the specific forecast.
    Timestamp *string `type:"string"`

    // The forecast value.
    Value *float64 `type:"double"`
    // contains filtered or unexported fields
}

The forecast value for a specific date. Part of the Forecast object.

func (DataPoint) GoString Uses

func (s DataPoint) GoString() string

GoString returns the string representation

func (*DataPoint) SetTimestamp Uses

func (s *DataPoint) SetTimestamp(v string) *DataPoint

SetTimestamp sets the Timestamp field's value.

func (*DataPoint) SetValue Uses

func (s *DataPoint) SetValue(v float64) *DataPoint

SetValue sets the Value field's value.

func (DataPoint) String Uses

func (s DataPoint) String() string

String returns the string representation

type Forecast Uses

type Forecast struct {

    // The forecast.
    //
    // The string of the string to array map is one of the following values:
    //
    //    * mean
    //
    //    * p10
    //
    //    * p50
    //
    //    * p90
    Predictions map[string][]*DataPoint `type:"map"`
    // contains filtered or unexported fields
}

Provides information about a forecast. Returned as part of the QueryForecast response.

func (Forecast) GoString Uses

func (s Forecast) GoString() string

GoString returns the string representation

func (*Forecast) SetPredictions Uses

func (s *Forecast) SetPredictions(v map[string][]*DataPoint) *Forecast

SetPredictions sets the Predictions field's value.

func (Forecast) String Uses

func (s Forecast) String() string

String returns the string representation

type ForecastQueryService Uses

type ForecastQueryService struct {
    *client.Client
}

ForecastQueryService provides the API operation methods for making requests to Amazon Forecast Query Service. See this package's package overview docs for details on the service.

ForecastQueryService methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New Uses

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

New creates a new instance of the ForecastQueryService 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 ForecastQueryService client from just a session.
svc := forecastqueryservice.New(mySession)

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

func (*ForecastQueryService) QueryForecast Uses

func (c *ForecastQueryService) QueryForecast(input *QueryForecastInput) (*QueryForecastOutput, error)

QueryForecast API operation for Amazon Forecast Query Service.

Retrieves a forecast filtered by the supplied criteria.

The criteria is a key-value pair. The key is either item_id (or the equivalent non-timestamp, non-target field) from the TARGET_TIME_SERIES dataset, or one of the forecast dimensions specified as part of the FeaturizationConfig object.

By default, the complete date range of the filtered forecast is returned. Optionally, you can request a specific date range within the forecast.

The forecasts generated by Amazon Forecast are in the same timezone as the dataset that was used to create the predictor.

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 Forecast Query Service's API operation QueryForecast for usage and error information.

Returned Error Codes:

* ErrCodeResourceNotFoundException "ResourceNotFoundException"
We can't find that resource. Check the information that you've provided and
try again.

* ErrCodeResourceInUseException "ResourceInUseException"
The specified resource is in use.

* ErrCodeInvalidInputException "InvalidInputException"
The value that you provided was invalid or too long.

* ErrCodeLimitExceededException "LimitExceededException"
The limit on the number of requests per second has been exceeded.

* ErrCodeInvalidNextTokenException "InvalidNextTokenException"
The token is not valid. Tokens expire after 24 hours.

See also, https://docs.aws.amazon.com/goto/WebAPI/forecastquery-2018-06-26/QueryForecast

func (*ForecastQueryService) QueryForecastRequest Uses

func (c *ForecastQueryService) QueryForecastRequest(input *QueryForecastInput) (req *request.Request, output *QueryForecastOutput)

QueryForecastRequest generates a "aws/request.Request" representing the client's request for the QueryForecast 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 QueryForecast for more information on using the QueryForecast 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 QueryForecastRequest method.
req, resp := client.QueryForecastRequest(params)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/forecastquery-2018-06-26/QueryForecast

func (*ForecastQueryService) QueryForecastWithContext Uses

func (c *ForecastQueryService) QueryForecastWithContext(ctx aws.Context, input *QueryForecastInput, opts ...request.Option) (*QueryForecastOutput, error)

QueryForecastWithContext is the same as QueryForecast with the addition of the ability to pass a context and additional request options.

See QueryForecast 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 QueryForecastInput Uses

type QueryForecastInput struct {

    // The end date for the forecast. Specify the date using this format: yyyy-MM-dd'T'HH:mm:ss'Z'
    // (ISO 8601 format). For example, "1970-01-01T00:00:00Z."
    EndDate *string `type:"string"`

    // The filtering criteria to apply when retrieving the forecast. For example:
    //
    //    * To get a forecast for a specific item specify the following: {"item_id"
    //    : "client_1"}
    //
    //    * To get a forecast for a specific item sold in a specific location, specify
    //    the following: {"item_id" : "client_1", "location" : "ny"}
    //
    //    * To get a forecast for all blue items sold in a specific location, specify
    //    the following: { "location" : "ny", "color":"blue"}
    //
    // To get the full forecast, use the operation.
    //
    // Filters is a required field
    Filters map[string]*string `min:"1" type:"map" required:"true"`

    // The Amazon Resource Name (ARN) of the forecast to query.
    //
    // ForecastArn is a required field
    ForecastArn *string `type:"string" required:"true"`

    // If the result of the previous request was truncated, the response includes
    // a NextToken. To retrieve the next set of results, use the token in the next
    // request. Tokens expire after 24 hours.
    NextToken *string `min:"1" type:"string"`

    // The start date for the forecast. Specify the date using this format: yyyy-MM-dd'T'HH:mm:ss'Z'
    // (ISO 8601 format) For example, "1970-01-01T00:00:00Z."
    StartDate *string `type:"string"`
    // contains filtered or unexported fields
}

func (QueryForecastInput) GoString Uses

func (s QueryForecastInput) GoString() string

GoString returns the string representation

func (*QueryForecastInput) SetEndDate Uses

func (s *QueryForecastInput) SetEndDate(v string) *QueryForecastInput

SetEndDate sets the EndDate field's value.

func (*QueryForecastInput) SetFilters Uses

func (s *QueryForecastInput) SetFilters(v map[string]*string) *QueryForecastInput

SetFilters sets the Filters field's value.

func (*QueryForecastInput) SetForecastArn Uses

func (s *QueryForecastInput) SetForecastArn(v string) *QueryForecastInput

SetForecastArn sets the ForecastArn field's value.

func (*QueryForecastInput) SetNextToken Uses

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

SetNextToken sets the NextToken field's value.

func (*QueryForecastInput) SetStartDate Uses

func (s *QueryForecastInput) SetStartDate(v string) *QueryForecastInput

SetStartDate sets the StartDate field's value.

func (QueryForecastInput) String Uses

func (s QueryForecastInput) String() string

String returns the string representation

func (*QueryForecastInput) Validate Uses

func (s *QueryForecastInput) Validate() error

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

type QueryForecastOutput Uses

type QueryForecastOutput struct {

    // The forecast.
    Forecast *Forecast `type:"structure"`
    // contains filtered or unexported fields
}

func (QueryForecastOutput) GoString Uses

func (s QueryForecastOutput) GoString() string

GoString returns the string representation

func (*QueryForecastOutput) SetForecast Uses

func (s *QueryForecastOutput) SetForecast(v *Forecast) *QueryForecastOutput

SetForecast sets the Forecast field's value.

func (QueryForecastOutput) String Uses

func (s QueryForecastOutput) String() string

String returns the string representation

Directories

PathSynopsis
forecastqueryserviceifacePackage forecastqueryserviceiface provides an interface to enable mocking the Amazon Forecast Query Service service client for testing your code.

Package forecastqueryservice imports 7 packages (graph) and is imported by 4 packages. Updated 2019-08-21. Refresh now. Tools for package owners.