marketplaceentitlementservice

package
v1.54.3 Latest Latest
Warning

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

 Go to latest Published: Jun 17, 2024 License: Apache-2.0 Imports: 10 Imported by: 29

Documentation

Overview

Package marketplaceentitlementservice provides the client and types for making API requests to AWS Marketplace Entitlement Service.

This reference provides descriptions of the AWS Marketplace Entitlement Service API.

AWS Marketplace Entitlement Service is used to determine the entitlement of a customer to a given product. An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.

Getting Entitlement Records

  • GetEntitlements- Gets the entitlements for a Marketplace product.

See https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11 for more information on this service.

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

Using the Client

To contact AWS Marketplace Entitlement 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 AWS Marketplace Entitlement Service client MarketplaceEntitlementService for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/marketplaceentitlementservice/#New

Index

Constants

View Source 
const (
	// GetEntitlementFilterNameCustomerIdentifier is a GetEntitlementFilterName enum value
	GetEntitlementFilterNameCustomerIdentifier = "CUSTOMER_IDENTIFIER"

	// GetEntitlementFilterNameDimension is a GetEntitlementFilterName enum value
	GetEntitlementFilterNameDimension = "DIMENSION"
)
View Source 
const (

	// ErrCodeInternalServiceErrorException for service response error code
	// "InternalServiceErrorException".
	//
	// An internal error has occurred. Retry your request. If the problem persists,
	// post a message with details on the AWS forums.
	ErrCodeInternalServiceErrorException = "InternalServiceErrorException"

	// ErrCodeInvalidParameterException for service response error code
	// "InvalidParameterException".
	//
	// One or more parameters in your request was invalid.
	ErrCodeInvalidParameterException = "InvalidParameterException"

	// ErrCodeThrottlingException for service response error code
	// "ThrottlingException".
	//
	// The calls to the GetEntitlements API are throttled.
	ErrCodeThrottlingException = "ThrottlingException"
)
View Source 
const (
	ServiceName = "entitlement.marketplace"         // Name of service.
	EndpointsID = ServiceName                       // ID to lookup a service endpoint with.
	ServiceID   = "Marketplace Entitlement Service" // ServiceID is a unique identifier of a specific service.
)

Service information constants

Variables

This section is empty.

Functions

func GetEntitlementFilterName_Values added in v1.34.3 

func GetEntitlementFilterName_Values() []string

GetEntitlementFilterName_Values returns all elements of the GetEntitlementFilterName enum

Types

type Entitlement 

type Entitlement struct {

	// The customer identifier is a handle to each unique customer in an application.
	// Customer identifiers are obtained through the ResolveCustomer operation in
	// AWS Marketplace Metering Service.
	CustomerIdentifier *string `type:"string"`

	// The dimension for which the given entitlement applies. Dimensions represent
	// categories of capacity in a product and are specified when the product is
	// listed in AWS Marketplace.
	Dimension *string `type:"string"`

	// The expiration date represents the minimum date through which this entitlement
	// is expected to remain valid. For contractual products listed on AWS Marketplace,
	// the expiration date is the date at which the customer will renew or cancel
	// their contract. Customers who are opting to renew their contract will still
	// have entitlements with an expiration date.
	ExpirationDate *time.Time `type:"timestamp"`

	// The product code for which the given entitlement applies. Product codes are
	// provided by AWS Marketplace when the product listing is created.
	ProductCode *string `min:"1" type:"string"`

	// The EntitlementValue represents the amount of capacity that the customer
	// is entitled to for the product.
	Value *EntitlementValue `type:"structure"`
	// contains filtered or unexported fields
}

An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.

func (Entitlement) GoString 

func (s Entitlement) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*Entitlement) SetCustomerIdentifier 

func (s *Entitlement) SetCustomerIdentifier(v string) *Entitlement

SetCustomerIdentifier sets the CustomerIdentifier field's value.

func (*Entitlement) SetDimension 

func (s *Entitlement) SetDimension(v string) *Entitlement

SetDimension sets the Dimension field's value.

func (*Entitlement) SetExpirationDate 

func (s *Entitlement) SetExpirationDate(v time.Time) *Entitlement

SetExpirationDate sets the ExpirationDate field's value.

func (*Entitlement) SetProductCode 

func (s *Entitlement) SetProductCode(v string) *Entitlement

SetProductCode sets the ProductCode field's value.

func (*Entitlement) SetValue 

func (s *Entitlement) SetValue(v *EntitlementValue) *Entitlement

SetValue sets the Value field's value.

func (Entitlement) String 

func (s Entitlement) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type EntitlementValue 

type EntitlementValue struct {

	// The BooleanValue field will be populated with a boolean value when the entitlement
	// is a boolean type. Otherwise, the field will not be set.
	BooleanValue *bool `type:"boolean"`

	// The DoubleValue field will be populated with a double value when the entitlement
	// is a double type. Otherwise, the field will not be set.
	DoubleValue *float64 `type:"double"`

	// The IntegerValue field will be populated with an integer value when the entitlement
	// is an integer type. Otherwise, the field will not be set.
	IntegerValue *int64 `type:"integer"`

	// The StringValue field will be populated with a string value when the entitlement
	// is a string type. Otherwise, the field will not be set.
	StringValue *string `type:"string"`
	// contains filtered or unexported fields
}

The EntitlementValue represents the amount of capacity that the customer is entitled to for the product.

func (EntitlementValue) GoString 

func (s EntitlementValue) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*EntitlementValue) SetBooleanValue 

func (s *EntitlementValue) SetBooleanValue(v bool) *EntitlementValue

SetBooleanValue sets the BooleanValue field's value.

func (*EntitlementValue) SetDoubleValue 

func (s *EntitlementValue) SetDoubleValue(v float64) *EntitlementValue

SetDoubleValue sets the DoubleValue field's value.

func (*EntitlementValue) SetIntegerValue 

func (s *EntitlementValue) SetIntegerValue(v int64) *EntitlementValue

SetIntegerValue sets the IntegerValue field's value.

func (*EntitlementValue) SetStringValue 

func (s *EntitlementValue) SetStringValue(v string) *EntitlementValue

SetStringValue sets the StringValue field's value.

func (EntitlementValue) String 

func (s EntitlementValue) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type GetEntitlementsInput 

type GetEntitlementsInput struct {

	// Filter is used to return entitlements for a specific customer or for a specific
	// dimension. Filters are described as keys mapped to a lists of values. Filtered
	// requests are unioned for each value in the value list, and then intersected
	// for each filter key.
	Filter map[string][]*string `type:"map"`

	// The maximum number of items to retrieve from the GetEntitlements operation.
	// For pagination, use the NextToken field in subsequent calls to GetEntitlements.
	MaxResults *int64 `min:"1" type:"integer"`

	// For paginated calls to GetEntitlements, pass the NextToken from the previous
	// GetEntitlementsResult.
	NextToken *string `type:"string"`

	// Product code is used to uniquely identify a product in AWS Marketplace. The
	// product code will be provided by AWS Marketplace when the product listing
	// is created.
	//
	// ProductCode is a required field
	ProductCode *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

The GetEntitlementsRequest contains parameters for the GetEntitlements operation.

func (GetEntitlementsInput) GoString 

func (s GetEntitlementsInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*GetEntitlementsInput) SetFilter 

func (s *GetEntitlementsInput) SetFilter(v map[string][]*string) *GetEntitlementsInput

SetFilter sets the Filter field's value.

func (*GetEntitlementsInput) SetMaxResults 

func (s *GetEntitlementsInput) SetMaxResults(v int64) *GetEntitlementsInput

SetMaxResults sets the MaxResults field's value.

func (*GetEntitlementsInput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (*GetEntitlementsInput) SetProductCode 

func (s *GetEntitlementsInput) SetProductCode(v string) *GetEntitlementsInput

SetProductCode sets the ProductCode field's value.

func (GetEntitlementsInput) String 

func (s GetEntitlementsInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*GetEntitlementsInput) Validate 

func (s *GetEntitlementsInput) Validate() error

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

type GetEntitlementsOutput 

type GetEntitlementsOutput struct {

	// The set of entitlements found through the GetEntitlements operation. If the
	// result contains an empty set of entitlements, NextToken might still be present
	// and should be used.
	Entitlements []*Entitlement `type:"list"`

	// For paginated results, use NextToken in subsequent calls to GetEntitlements.
	// If the result contains an empty set of entitlements, NextToken might still
	// be present and should be used.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

The GetEntitlementsRequest contains results from the GetEntitlements operation.

func (GetEntitlementsOutput) GoString 

func (s GetEntitlementsOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*GetEntitlementsOutput) SetEntitlements 

func (s *GetEntitlementsOutput) SetEntitlements(v []*Entitlement) *GetEntitlementsOutput

SetEntitlements sets the Entitlements field's value.

func (*GetEntitlementsOutput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (GetEntitlementsOutput) String 

func (s GetEntitlementsOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type InternalServiceErrorException added in v1.28.0 

type InternalServiceErrorException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`
	// contains filtered or unexported fields
}

An internal error has occurred. Retry your request. If the problem persists, post a message with details on the AWS forums.

func (*InternalServiceErrorException) Code added in v1.28.0 

func (s *InternalServiceErrorException) Code() string

Code returns the exception type name.

func (*InternalServiceErrorException) Error added in v1.28.0 

func (s *InternalServiceErrorException) Error() string

func (InternalServiceErrorException) GoString added in v1.28.0 

func (s InternalServiceErrorException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*InternalServiceErrorException) Message added in v1.28.0 

func (s *InternalServiceErrorException) Message() string

Message returns the exception's message.

func (*InternalServiceErrorException) OrigErr added in v1.28.0 

func (s *InternalServiceErrorException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*InternalServiceErrorException) RequestID added in v1.28.0 

func (s *InternalServiceErrorException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*InternalServiceErrorException) StatusCode added in v1.28.0 

func (s *InternalServiceErrorException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (InternalServiceErrorException) String added in v1.28.0 

func (s InternalServiceErrorException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type InvalidParameterException added in v1.28.0 

type InvalidParameterException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`
	// contains filtered or unexported fields
}

One or more parameters in your request was invalid.

func (*InvalidParameterException) Code added in v1.28.0 

func (s *InvalidParameterException) Code() string

Code returns the exception type name.

func (*InvalidParameterException) Error added in v1.28.0 

func (s *InvalidParameterException) Error() string

func (InvalidParameterException) GoString added in v1.28.0 

func (s InvalidParameterException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*InvalidParameterException) Message added in v1.28.0 

func (s *InvalidParameterException) Message() string

Message returns the exception's message.

func (*InvalidParameterException) OrigErr added in v1.28.0 

func (s *InvalidParameterException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*InvalidParameterException) RequestID added in v1.28.0 

func (s *InvalidParameterException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*InvalidParameterException) StatusCode added in v1.28.0 

func (s *InvalidParameterException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (InvalidParameterException) String added in v1.28.0 

func (s InvalidParameterException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type MarketplaceEntitlementService 

type MarketplaceEntitlementService struct {
	*client.Client
}

MarketplaceEntitlementService provides the API operation methods for making requests to AWS Marketplace Entitlement Service. See this package's package overview docs for details on the service.

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

func New 

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

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

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

func (*MarketplaceEntitlementService) GetEntitlements 

func (c *MarketplaceEntitlementService) GetEntitlements(input *GetEntitlementsInput) (*GetEntitlementsOutput, error)

GetEntitlements API operation for AWS Marketplace Entitlement Service.

GetEntitlements retrieves entitlement values for a given product. The results can be filtered based on customer identifier or product dimensions.

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 Marketplace Entitlement Service's API operation GetEntitlements for usage and error information.

Returned Error Types:

  • InvalidParameterException One or more parameters in your request was invalid.

  • ThrottlingException The calls to the GetEntitlements API are throttled.

  • InternalServiceErrorException An internal error has occurred. Retry your request. If the problem persists, post a message with details on the AWS forums.

See also, https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/GetEntitlements

func (*MarketplaceEntitlementService) GetEntitlementsPages added in v1.47.9 

func (c *MarketplaceEntitlementService) GetEntitlementsPages(input *GetEntitlementsInput, fn func(*GetEntitlementsOutput, bool) bool) error

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

See GetEntitlements 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 GetEntitlements operation.
pageNum := 0
err := client.GetEntitlementsPages(params,
    func(page *marketplaceentitlementservice.GetEntitlementsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*MarketplaceEntitlementService) GetEntitlementsPagesWithContext added in v1.47.9 

func (c *MarketplaceEntitlementService) GetEntitlementsPagesWithContext(ctx aws.Context, input *GetEntitlementsInput, fn func(*GetEntitlementsOutput, bool) bool, opts ...request.Option) error

GetEntitlementsPagesWithContext same as GetEntitlementsPages 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 (*MarketplaceEntitlementService) GetEntitlementsRequest 

func (c *MarketplaceEntitlementService) GetEntitlementsRequest(input *GetEntitlementsInput) (req *request.Request, output *GetEntitlementsOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/GetEntitlements

func (*MarketplaceEntitlementService) GetEntitlementsWithContext 

func (c *MarketplaceEntitlementService) GetEntitlementsWithContext(ctx aws.Context, input *GetEntitlementsInput, opts ...request.Option) (*GetEntitlementsOutput, error)

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

See GetEntitlements 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 ThrottlingException added in v1.28.0 

type ThrottlingException struct {
	RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"`

	Message_ *string `locationName:"message" type:"string"`
	// contains filtered or unexported fields
}

The calls to the GetEntitlements API are throttled.

func (*ThrottlingException) Code added in v1.28.0 

func (s *ThrottlingException) Code() string

Code returns the exception type name.

func (*ThrottlingException) Error added in v1.28.0 

func (s *ThrottlingException) Error() string

func (ThrottlingException) GoString added in v1.28.0 

func (s ThrottlingException) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*ThrottlingException) Message added in v1.28.0 

func (s *ThrottlingException) Message() string

Message returns the exception's message.

func (*ThrottlingException) OrigErr added in v1.28.0 

func (s *ThrottlingException) OrigErr() error

OrigErr always returns nil, satisfies awserr.Error interface.

func (*ThrottlingException) RequestID added in v1.28.0 

func (s *ThrottlingException) RequestID() string

RequestID returns the service's response RequestID for request.

func (*ThrottlingException) StatusCode added in v1.28.0 

func (s *ThrottlingException) StatusCode() int

Status code returns the HTTP status code for the request's response error.

func (ThrottlingException) String added in v1.28.0 

func (s ThrottlingException) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

Source Files

View all Source files

Directories

Path Synopsis
Package marketplaceentitlementserviceiface provides an interface to enable mocking the AWS Marketplace Entitlement Service service client for testing your code.
 Package marketplaceentitlementserviceiface provides an interface to enable mocking the AWS Marketplace Entitlement Service service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.