appmesh

package
Version: v1.44.71 Latest Latest
Warning

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

Go to latest
Published: Aug 8, 2022 License: Apache-2.0 Imports: 10 Imported by: 45

Documentation

Overview

Package appmesh provides the client and types for making API requests to AWS App Mesh.

App Mesh is a service mesh based on the Envoy proxy that makes it easy to monitor and control microservices. App Mesh standardizes how your microservices communicate, giving you end-to-end visibility and helping to ensure high availability for your applications.

App Mesh gives you consistent visibility and network traffic controls for every microservice in an application. You can use App Mesh with Amazon Web Services Fargate, Amazon ECS, Amazon EKS, Kubernetes on Amazon Web Services, and Amazon EC2.

App Mesh supports microservice applications that use service discovery naming for their components. For more information about service discovery on Amazon ECS, see Service Discovery (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html) in the Amazon Elastic Container Service Developer Guide. Kubernetes kube-dns and coredns are supported. For more information, see DNS for Services and Pods (https://kubernetes.io/docs/concepts/services-networking/dns-pod-service/) in the Kubernetes documentation.

See https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25 for more information on this service.

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

Using the Client

To contact AWS App Mesh 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 App Mesh client AppMesh for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/appmesh/#New

Index

Constants

View Source
const (
	// DefaultGatewayRouteRewriteEnabled is a DefaultGatewayRouteRewrite enum value
	DefaultGatewayRouteRewriteEnabled = "ENABLED"

	// DefaultGatewayRouteRewriteDisabled is a DefaultGatewayRouteRewrite enum value
	DefaultGatewayRouteRewriteDisabled = "DISABLED"
)
View Source
const (
	// DnsResponseTypeLoadbalancer is a DnsResponseType enum value
	DnsResponseTypeLoadbalancer = "LOADBALANCER"

	// DnsResponseTypeEndpoints is a DnsResponseType enum value
	DnsResponseTypeEndpoints = "ENDPOINTS"
)
View Source
const (
	// DurationUnitS is a DurationUnit enum value
	DurationUnitS = "s"

	// DurationUnitMs is a DurationUnit enum value
	DurationUnitMs = "ms"
)
View Source
const (
	// EgressFilterTypeAllowAll is a EgressFilterType enum value
	EgressFilterTypeAllowAll = "ALLOW_ALL"

	// EgressFilterTypeDropAll is a EgressFilterType enum value
	EgressFilterTypeDropAll = "DROP_ALL"
)
View Source
const (
	// GatewayRouteStatusCodeActive is a GatewayRouteStatusCode enum value
	GatewayRouteStatusCodeActive = "ACTIVE"

	// GatewayRouteStatusCodeInactive is a GatewayRouteStatusCode enum value
	GatewayRouteStatusCodeInactive = "INACTIVE"

	// GatewayRouteStatusCodeDeleted is a GatewayRouteStatusCode enum value
	GatewayRouteStatusCodeDeleted = "DELETED"
)
View Source
const (
	// GrpcRetryPolicyEventCancelled is a GrpcRetryPolicyEvent enum value
	GrpcRetryPolicyEventCancelled = "cancelled"

	// GrpcRetryPolicyEventDeadlineExceeded is a GrpcRetryPolicyEvent enum value
	GrpcRetryPolicyEventDeadlineExceeded = "deadline-exceeded"

	// GrpcRetryPolicyEventInternal is a GrpcRetryPolicyEvent enum value
	GrpcRetryPolicyEventInternal = "internal"

	// GrpcRetryPolicyEventResourceExhausted is a GrpcRetryPolicyEvent enum value
	GrpcRetryPolicyEventResourceExhausted = "resource-exhausted"

	// GrpcRetryPolicyEventUnavailable is a GrpcRetryPolicyEvent enum value
	GrpcRetryPolicyEventUnavailable = "unavailable"
)
View Source
const (
	// HttpMethodGet is a HttpMethod enum value
	HttpMethodGet = "GET"

	// HttpMethodHead is a HttpMethod enum value
	HttpMethodHead = "HEAD"

	// HttpMethodPost is a HttpMethod enum value
	HttpMethodPost = "POST"

	// HttpMethodPut is a HttpMethod enum value
	HttpMethodPut = "PUT"

	// HttpMethodDelete is a HttpMethod enum value
	HttpMethodDelete = "DELETE"

	// HttpMethodConnect is a HttpMethod enum value
	HttpMethodConnect = "CONNECT"

	// HttpMethodOptions is a HttpMethod enum value
	HttpMethodOptions = "OPTIONS"

	// HttpMethodTrace is a HttpMethod enum value
	HttpMethodTrace = "TRACE"

	// HttpMethodPatch is a HttpMethod enum value
	HttpMethodPatch = "PATCH"
)
View Source
const (
	// HttpSchemeHttp is a HttpScheme enum value
	HttpSchemeHttp = "http"

	// HttpSchemeHttps is a HttpScheme enum value
	HttpSchemeHttps = "https"
)
View Source
const (
	// IpPreferenceIpv6Preferred is a IpPreference enum value
	IpPreferenceIpv6Preferred = "IPv6_PREFERRED"

	// IpPreferenceIpv4Preferred is a IpPreference enum value
	IpPreferenceIpv4Preferred = "IPv4_PREFERRED"

	// IpPreferenceIpv4Only is a IpPreference enum value
	IpPreferenceIpv4Only = "IPv4_ONLY"

	// IpPreferenceIpv6Only is a IpPreference enum value
	IpPreferenceIpv6Only = "IPv6_ONLY"
)
View Source
const (
	// ListenerTlsModeStrict is a ListenerTlsMode enum value
	ListenerTlsModeStrict = "STRICT"

	// ListenerTlsModePermissive is a ListenerTlsMode enum value
	ListenerTlsModePermissive = "PERMISSIVE"

	// ListenerTlsModeDisabled is a ListenerTlsMode enum value
	ListenerTlsModeDisabled = "DISABLED"
)
View Source
const (
	// MeshStatusCodeActive is a MeshStatusCode enum value
	MeshStatusCodeActive = "ACTIVE"

	// MeshStatusCodeInactive is a MeshStatusCode enum value
	MeshStatusCodeInactive = "INACTIVE"

	// MeshStatusCodeDeleted is a MeshStatusCode enum value
	MeshStatusCodeDeleted = "DELETED"
)
View Source
const (
	// PortProtocolHttp is a PortProtocol enum value
	PortProtocolHttp = "http"

	// PortProtocolTcp is a PortProtocol enum value
	PortProtocolTcp = "tcp"

	// PortProtocolHttp2 is a PortProtocol enum value
	PortProtocolHttp2 = "http2"

	// PortProtocolGrpc is a PortProtocol enum value
	PortProtocolGrpc = "grpc"
)
View Source
const (
	// RouteStatusCodeActive is a RouteStatusCode enum value
	RouteStatusCodeActive = "ACTIVE"

	// RouteStatusCodeInactive is a RouteStatusCode enum value
	RouteStatusCodeInactive = "INACTIVE"

	// RouteStatusCodeDeleted is a RouteStatusCode enum value
	RouteStatusCodeDeleted = "DELETED"
)
View Source
const (
	// VirtualGatewayListenerTlsModeStrict is a VirtualGatewayListenerTlsMode enum value
	VirtualGatewayListenerTlsModeStrict = "STRICT"

	// VirtualGatewayListenerTlsModePermissive is a VirtualGatewayListenerTlsMode enum value
	VirtualGatewayListenerTlsModePermissive = "PERMISSIVE"

	// VirtualGatewayListenerTlsModeDisabled is a VirtualGatewayListenerTlsMode enum value
	VirtualGatewayListenerTlsModeDisabled = "DISABLED"
)
View Source
const (
	// VirtualGatewayPortProtocolHttp is a VirtualGatewayPortProtocol enum value
	VirtualGatewayPortProtocolHttp = "http"

	// VirtualGatewayPortProtocolHttp2 is a VirtualGatewayPortProtocol enum value
	VirtualGatewayPortProtocolHttp2 = "http2"

	// VirtualGatewayPortProtocolGrpc is a VirtualGatewayPortProtocol enum value
	VirtualGatewayPortProtocolGrpc = "grpc"
)
View Source
const (
	// VirtualGatewayStatusCodeActive is a VirtualGatewayStatusCode enum value
	VirtualGatewayStatusCodeActive = "ACTIVE"

	// VirtualGatewayStatusCodeInactive is a VirtualGatewayStatusCode enum value
	VirtualGatewayStatusCodeInactive = "INACTIVE"

	// VirtualGatewayStatusCodeDeleted is a VirtualGatewayStatusCode enum value
	VirtualGatewayStatusCodeDeleted = "DELETED"
)
View Source
const (
	// VirtualNodeStatusCodeActive is a VirtualNodeStatusCode enum value
	VirtualNodeStatusCodeActive = "ACTIVE"

	// VirtualNodeStatusCodeInactive is a VirtualNodeStatusCode enum value
	VirtualNodeStatusCodeInactive = "INACTIVE"

	// VirtualNodeStatusCodeDeleted is a VirtualNodeStatusCode enum value
	VirtualNodeStatusCodeDeleted = "DELETED"
)
View Source
const (
	// VirtualRouterStatusCodeActive is a VirtualRouterStatusCode enum value
	VirtualRouterStatusCodeActive = "ACTIVE"

	// VirtualRouterStatusCodeInactive is a VirtualRouterStatusCode enum value
	VirtualRouterStatusCodeInactive = "INACTIVE"

	// VirtualRouterStatusCodeDeleted is a VirtualRouterStatusCode enum value
	VirtualRouterStatusCodeDeleted = "DELETED"
)
View Source
const (
	// VirtualServiceStatusCodeActive is a VirtualServiceStatusCode enum value
	VirtualServiceStatusCodeActive = "ACTIVE"

	// VirtualServiceStatusCodeInactive is a VirtualServiceStatusCode enum value
	VirtualServiceStatusCodeInactive = "INACTIVE"

	// VirtualServiceStatusCodeDeleted is a VirtualServiceStatusCode enum value
	VirtualServiceStatusCodeDeleted = "DELETED"
)
View Source
const (

	// ErrCodeBadRequestException for service response error code
	// "BadRequestException".
	//
	// The request syntax was malformed. Check your request syntax and try again.
	ErrCodeBadRequestException = "BadRequestException"

	// ErrCodeConflictException for service response error code
	// "ConflictException".
	//
	// The request contains a client token that was used for a previous update resource
	// call with different specifications. Try the request again with a new client
	// token.
	ErrCodeConflictException = "ConflictException"

	// ErrCodeForbiddenException for service response error code
	// "ForbiddenException".
	//
	// You don't have permissions to perform this action.
	ErrCodeForbiddenException = "ForbiddenException"

	// ErrCodeInternalServerErrorException for service response error code
	// "InternalServerErrorException".
	//
	// The request processing has failed because of an unknown error, exception,
	// or failure.
	ErrCodeInternalServerErrorException = "InternalServerErrorException"

	// ErrCodeLimitExceededException for service response error code
	// "LimitExceededException".
	//
	// You have exceeded a service limit for your account. For more information,
	// see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html)
	// in the App Mesh User Guide.
	ErrCodeLimitExceededException = "LimitExceededException"

	// ErrCodeNotFoundException for service response error code
	// "NotFoundException".
	//
	// The specified resource doesn't exist. Check your request syntax and try again.
	ErrCodeNotFoundException = "NotFoundException"

	// ErrCodeResourceInUseException for service response error code
	// "ResourceInUseException".
	//
	// You can't delete the specified resource because it's in use or required by
	// another resource.
	ErrCodeResourceInUseException = "ResourceInUseException"

	// ErrCodeServiceUnavailableException for service response error code
	// "ServiceUnavailableException".
	//
	// The request has failed due to a temporary failure of the service.
	ErrCodeServiceUnavailableException = "ServiceUnavailableException"

	// ErrCodeTooManyRequestsException for service response error code
	// "TooManyRequestsException".
	//
	// The maximum request rate permitted by the App Mesh APIs has been exceeded
	// for your account. For best results, use an increasing or variable sleep interval
	// between requests.
	ErrCodeTooManyRequestsException = "TooManyRequestsException"

	// ErrCodeTooManyTagsException for service response error code
	// "TooManyTagsException".
	//
	// The request exceeds the maximum allowed number of tags allowed per resource.
	// The current limit is 50 user tags per resource. You must reduce the number
	// of tags in the request. None of the tags in this request were applied.
	ErrCodeTooManyTagsException = "TooManyTagsException"
)
View Source
const (
	ServiceName = "App Mesh" // Name of service.
	EndpointsID = "appmesh"  // ID to lookup a service endpoint with.
	ServiceID   = "App Mesh" // ServiceID is a unique identifier of a specific service.
)

Service information constants

View Source
const (
	// TcpRetryPolicyEventConnectionError is a TcpRetryPolicyEvent enum value
	TcpRetryPolicyEventConnectionError = "connection-error"
)

Variables

This section is empty.

Functions

func DefaultGatewayRouteRewrite_Values added in v1.38.59

func DefaultGatewayRouteRewrite_Values() []string

DefaultGatewayRouteRewrite_Values returns all elements of the DefaultGatewayRouteRewrite enum

func DnsResponseType_Values added in v1.38.59

func DnsResponseType_Values() []string

DnsResponseType_Values returns all elements of the DnsResponseType enum

func DurationUnit_Values added in v1.34.3

func DurationUnit_Values() []string

DurationUnit_Values returns all elements of the DurationUnit enum

func EgressFilterType_Values added in v1.34.3

func EgressFilterType_Values() []string

EgressFilterType_Values returns all elements of the EgressFilterType enum

func GatewayRouteStatusCode_Values added in v1.34.3

func GatewayRouteStatusCode_Values() []string

GatewayRouteStatusCode_Values returns all elements of the GatewayRouteStatusCode enum

func GrpcRetryPolicyEvent_Values added in v1.34.3

func GrpcRetryPolicyEvent_Values() []string

GrpcRetryPolicyEvent_Values returns all elements of the GrpcRetryPolicyEvent enum

func HttpMethod_Values added in v1.34.3

func HttpMethod_Values() []string

HttpMethod_Values returns all elements of the HttpMethod enum

func HttpScheme_Values added in v1.34.3

func HttpScheme_Values() []string

HttpScheme_Values returns all elements of the HttpScheme enum

func IpPreference_Values added in v1.44.17

func IpPreference_Values() []string

IpPreference_Values returns all elements of the IpPreference enum

func ListenerTlsMode_Values added in v1.34.3

func ListenerTlsMode_Values() []string

ListenerTlsMode_Values returns all elements of the ListenerTlsMode enum

func MeshStatusCode_Values added in v1.34.3

func MeshStatusCode_Values() []string

MeshStatusCode_Values returns all elements of the MeshStatusCode enum

func PortProtocol_Values added in v1.34.3

func PortProtocol_Values() []string

PortProtocol_Values returns all elements of the PortProtocol enum

func RouteStatusCode_Values added in v1.34.3

func RouteStatusCode_Values() []string

RouteStatusCode_Values returns all elements of the RouteStatusCode enum

func TcpRetryPolicyEvent_Values added in v1.34.3

func TcpRetryPolicyEvent_Values() []string

TcpRetryPolicyEvent_Values returns all elements of the TcpRetryPolicyEvent enum

func VirtualGatewayListenerTlsMode_Values added in v1.34.3

func VirtualGatewayListenerTlsMode_Values() []string

VirtualGatewayListenerTlsMode_Values returns all elements of the VirtualGatewayListenerTlsMode enum

func VirtualGatewayPortProtocol_Values added in v1.34.3

func VirtualGatewayPortProtocol_Values() []string

VirtualGatewayPortProtocol_Values returns all elements of the VirtualGatewayPortProtocol enum

func VirtualGatewayStatusCode_Values added in v1.34.3

func VirtualGatewayStatusCode_Values() []string

VirtualGatewayStatusCode_Values returns all elements of the VirtualGatewayStatusCode enum

func VirtualNodeStatusCode_Values added in v1.34.3

func VirtualNodeStatusCode_Values() []string

VirtualNodeStatusCode_Values returns all elements of the VirtualNodeStatusCode enum

func VirtualRouterStatusCode_Values added in v1.34.3

func VirtualRouterStatusCode_Values() []string

VirtualRouterStatusCode_Values returns all elements of the VirtualRouterStatusCode enum

func VirtualServiceStatusCode_Values added in v1.34.3

func VirtualServiceStatusCode_Values() []string

VirtualServiceStatusCode_Values returns all elements of the VirtualServiceStatusCode enum

Types

type AccessLog added in v1.19.3

type AccessLog struct {

	// The file object to send virtual node access logs to.
	File *FileAccessLog `locationName:"file" type:"structure"`
	// contains filtered or unexported fields
}

An object that represents the access logging information for a virtual node.

func (AccessLog) GoString added in v1.19.3

func (s AccessLog) 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 (*AccessLog) SetFile added in v1.19.3

func (s *AccessLog) SetFile(v *FileAccessLog) *AccessLog

SetFile sets the File field's value.

func (AccessLog) String added in v1.19.3

func (s AccessLog) 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 (*AccessLog) Validate added in v1.19.3

func (s *AccessLog) Validate() error

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

type AppMesh

type AppMesh struct {
	*client.Client
}

AppMesh provides the API operation methods for making requests to AWS App Mesh. See this package's package overview docs for details on the service.

AppMesh 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) *AppMesh

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

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

func (*AppMesh) CreateGatewayRoute added in v1.33.5

func (c *AppMesh) CreateGatewayRoute(input *CreateGatewayRouteInput) (*CreateGatewayRouteOutput, error)

CreateGatewayRoute API operation for AWS App Mesh.

Creates a gateway route.

A gateway route is attached to a virtual gateway and routes traffic to an existing virtual service. If a route matches a request, it can distribute traffic to a target virtual service.

For more information about gateway routes, see Gateway routes (https://docs.aws.amazon.com/app-mesh/latest/userguide/gateway-routes.html).

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 App Mesh's API operation CreateGatewayRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateGatewayRoute

func (*AppMesh) CreateGatewayRouteRequest added in v1.33.5

func (c *AppMesh) CreateGatewayRouteRequest(input *CreateGatewayRouteInput) (req *request.Request, output *CreateGatewayRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateGatewayRoute

func (*AppMesh) CreateGatewayRouteWithContext added in v1.33.5

func (c *AppMesh) CreateGatewayRouteWithContext(ctx aws.Context, input *CreateGatewayRouteInput, opts ...request.Option) (*CreateGatewayRouteOutput, error)

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

See CreateGatewayRoute 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 (*AppMesh) CreateMesh

func (c *AppMesh) CreateMesh(input *CreateMeshInput) (*CreateMeshOutput, error)

CreateMesh API operation for AWS App Mesh.

Creates a service mesh.

A service mesh is a logical boundary for network traffic between services that are represented by resources within the mesh. After you create your service mesh, you can create virtual services, virtual nodes, virtual routers, and routes to distribute traffic between the applications in your mesh.

For more information about service meshes, see Service meshes (https://docs.aws.amazon.com/app-mesh/latest/userguide/meshes.html).

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 App Mesh's API operation CreateMesh for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateMesh

func (*AppMesh) CreateMeshRequest

func (c *AppMesh) CreateMeshRequest(input *CreateMeshInput) (req *request.Request, output *CreateMeshOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateMesh

func (*AppMesh) CreateMeshWithContext

func (c *AppMesh) CreateMeshWithContext(ctx aws.Context, input *CreateMeshInput, opts ...request.Option) (*CreateMeshOutput, error)

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

See CreateMesh 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 (*AppMesh) CreateRoute

func (c *AppMesh) CreateRoute(input *CreateRouteInput) (*CreateRouteOutput, error)

CreateRoute API operation for AWS App Mesh.

Creates a route that is associated with a virtual router.

You can route several different protocols and define a retry policy for a route. Traffic can be routed to one or more virtual nodes.

For more information about routes, see Routes (https://docs.aws.amazon.com/app-mesh/latest/userguide/routes.html).

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 App Mesh's API operation CreateRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateRoute

func (*AppMesh) CreateRouteRequest

func (c *AppMesh) CreateRouteRequest(input *CreateRouteInput) (req *request.Request, output *CreateRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateRoute

func (*AppMesh) CreateRouteWithContext

func (c *AppMesh) CreateRouteWithContext(ctx aws.Context, input *CreateRouteInput, opts ...request.Option) (*CreateRouteOutput, error)

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

See CreateRoute 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 (*AppMesh) CreateVirtualGateway added in v1.33.5

func (c *AppMesh) CreateVirtualGateway(input *CreateVirtualGatewayInput) (*CreateVirtualGatewayOutput, error)

CreateVirtualGateway API operation for AWS App Mesh.

Creates a virtual gateway.

A virtual gateway allows resources outside your mesh to communicate to resources that are inside your mesh. The virtual gateway represents an Envoy proxy running in an Amazon ECS task, in a Kubernetes service, or on an Amazon EC2 instance. Unlike a virtual node, which represents an Envoy running with an application, a virtual gateway represents Envoy deployed by itself.

For more information about virtual gateways, see Virtual gateways (https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_gateways.html).

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 App Mesh's API operation CreateVirtualGateway for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualGateway

func (*AppMesh) CreateVirtualGatewayRequest added in v1.33.5

func (c *AppMesh) CreateVirtualGatewayRequest(input *CreateVirtualGatewayInput) (req *request.Request, output *CreateVirtualGatewayOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualGateway

func (*AppMesh) CreateVirtualGatewayWithContext added in v1.33.5

func (c *AppMesh) CreateVirtualGatewayWithContext(ctx aws.Context, input *CreateVirtualGatewayInput, opts ...request.Option) (*CreateVirtualGatewayOutput, error)

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

See CreateVirtualGateway 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 (*AppMesh) CreateVirtualNode

func (c *AppMesh) CreateVirtualNode(input *CreateVirtualNodeInput) (*CreateVirtualNodeOutput, error)

CreateVirtualNode API operation for AWS App Mesh.

Creates a virtual node within a service mesh.

A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you can specify the service discovery information for your task group, and whether the proxy running in a task group will communicate with other proxies using Transport Layer Security (TLS).

You define a listener for any inbound traffic that your virtual node expects. Any virtual service that your virtual node expects to communicate to is specified as a backend.

The response metadata for your new virtual node contains the arn that is associated with the virtual node. Set this value to the full ARN; for example, arn:aws:appmesh:us-west-2:123456789012:myMesh/default/virtualNode/myApp) as the APPMESH_RESOURCE_ARN environment variable for your task group's Envoy proxy container in your task definition or pod spec. This is then mapped to the node.id and node.cluster Envoy parameters.

By default, App Mesh uses the name of the resource you specified in APPMESH_RESOURCE_ARN when Envoy is referring to itself in metrics and traces. You can override this behavior by setting the APPMESH_RESOURCE_CLUSTER environment variable with your own name.

For more information about virtual nodes, see Virtual nodes (https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html). You must be using 1.15.0 or later of the Envoy image when setting these variables. For more information aboutApp Mesh Envoy variables, see Envoy image (https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html) in the App Mesh User Guide.

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 App Mesh's API operation CreateVirtualNode for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualNode

func (*AppMesh) CreateVirtualNodeRequest

func (c *AppMesh) CreateVirtualNodeRequest(input *CreateVirtualNodeInput) (req *request.Request, output *CreateVirtualNodeOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualNode

func (*AppMesh) CreateVirtualNodeWithContext

func (c *AppMesh) CreateVirtualNodeWithContext(ctx aws.Context, input *CreateVirtualNodeInput, opts ...request.Option) (*CreateVirtualNodeOutput, error)

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

See CreateVirtualNode 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 (*AppMesh) CreateVirtualRouter

func (c *AppMesh) CreateVirtualRouter(input *CreateVirtualRouterInput) (*CreateVirtualRouterOutput, error)

CreateVirtualRouter API operation for AWS App Mesh.

Creates a virtual router within a service mesh.

Specify a listener for any inbound traffic that your virtual router receives. Create a virtual router for each protocol and port that you need to route. Virtual routers handle traffic for one or more virtual services within your mesh. After you create your virtual router, create and associate routes for your virtual router that direct incoming requests to different virtual nodes.

For more information about virtual routers, see Virtual routers (https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_routers.html).

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 App Mesh's API operation CreateVirtualRouter for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualRouter

func (*AppMesh) CreateVirtualRouterRequest

func (c *AppMesh) CreateVirtualRouterRequest(input *CreateVirtualRouterInput) (req *request.Request, output *CreateVirtualRouterOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualRouter

func (*AppMesh) CreateVirtualRouterWithContext

func (c *AppMesh) CreateVirtualRouterWithContext(ctx aws.Context, input *CreateVirtualRouterInput, opts ...request.Option) (*CreateVirtualRouterOutput, error)

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

See CreateVirtualRouter 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 (*AppMesh) CreateVirtualService added in v1.17.13

func (c *AppMesh) CreateVirtualService(input *CreateVirtualServiceInput) (*CreateVirtualServiceOutput, error)

CreateVirtualService API operation for AWS App Mesh.

Creates a virtual service within a service mesh.

A virtual service is an abstraction of a real service that is provided by a virtual node directly or indirectly by means of a virtual router. Dependent services call your virtual service by its virtualServiceName, and those requests are routed to the virtual node or virtual router that is specified as the provider for the virtual service.

For more information about virtual services, see Virtual services (https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_services.html).

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 App Mesh's API operation CreateVirtualService for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualService

func (*AppMesh) CreateVirtualServiceRequest added in v1.17.13

func (c *AppMesh) CreateVirtualServiceRequest(input *CreateVirtualServiceInput) (req *request.Request, output *CreateVirtualServiceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateVirtualService

func (*AppMesh) CreateVirtualServiceWithContext added in v1.17.13

func (c *AppMesh) CreateVirtualServiceWithContext(ctx aws.Context, input *CreateVirtualServiceInput, opts ...request.Option) (*CreateVirtualServiceOutput, error)

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

See CreateVirtualService 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 (*AppMesh) DeleteGatewayRoute added in v1.33.5

func (c *AppMesh) DeleteGatewayRoute(input *DeleteGatewayRouteInput) (*DeleteGatewayRouteOutput, error)

DeleteGatewayRoute API operation for AWS App Mesh.

Deletes an existing gateway route.

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 App Mesh's API operation DeleteGatewayRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteGatewayRoute

func (*AppMesh) DeleteGatewayRouteRequest added in v1.33.5

func (c *AppMesh) DeleteGatewayRouteRequest(input *DeleteGatewayRouteInput) (req *request.Request, output *DeleteGatewayRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteGatewayRoute

func (*AppMesh) DeleteGatewayRouteWithContext added in v1.33.5

func (c *AppMesh) DeleteGatewayRouteWithContext(ctx aws.Context, input *DeleteGatewayRouteInput, opts ...request.Option) (*DeleteGatewayRouteOutput, error)

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

See DeleteGatewayRoute 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 (*AppMesh) DeleteMesh

func (c *AppMesh) DeleteMesh(input *DeleteMeshInput) (*DeleteMeshOutput, error)

DeleteMesh API operation for AWS App Mesh.

Deletes an existing service mesh.

You must delete all resources (virtual services, routes, virtual routers, and virtual nodes) in the service mesh before you can delete the mesh itself.

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 App Mesh's API operation DeleteMesh for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteMesh

func (*AppMesh) DeleteMeshRequest

func (c *AppMesh) DeleteMeshRequest(input *DeleteMeshInput) (req *request.Request, output *DeleteMeshOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteMesh

func (*AppMesh) DeleteMeshWithContext

func (c *AppMesh) DeleteMeshWithContext(ctx aws.Context, input *DeleteMeshInput, opts ...request.Option) (*DeleteMeshOutput, error)

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

See DeleteMesh 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 (*AppMesh) DeleteRoute

func (c *AppMesh) DeleteRoute(input *DeleteRouteInput) (*DeleteRouteOutput, error)

DeleteRoute API operation for AWS App Mesh.

Deletes an existing route.

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 App Mesh's API operation DeleteRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteRoute

func (*AppMesh) DeleteRouteRequest

func (c *AppMesh) DeleteRouteRequest(input *DeleteRouteInput) (req *request.Request, output *DeleteRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteRoute

func (*AppMesh) DeleteRouteWithContext

func (c *AppMesh) DeleteRouteWithContext(ctx aws.Context, input *DeleteRouteInput, opts ...request.Option) (*DeleteRouteOutput, error)

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

See DeleteRoute 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 (*AppMesh) DeleteVirtualGateway added in v1.33.5

func (c *AppMesh) DeleteVirtualGateway(input *DeleteVirtualGatewayInput) (*DeleteVirtualGatewayOutput, error)

DeleteVirtualGateway API operation for AWS App Mesh.

Deletes an existing virtual gateway. You cannot delete a virtual gateway if any gateway routes are associated to it.

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 App Mesh's API operation DeleteVirtualGateway for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualGateway

func (*AppMesh) DeleteVirtualGatewayRequest added in v1.33.5

func (c *AppMesh) DeleteVirtualGatewayRequest(input *DeleteVirtualGatewayInput) (req *request.Request, output *DeleteVirtualGatewayOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualGateway

func (*AppMesh) DeleteVirtualGatewayWithContext added in v1.33.5

func (c *AppMesh) DeleteVirtualGatewayWithContext(ctx aws.Context, input *DeleteVirtualGatewayInput, opts ...request.Option) (*DeleteVirtualGatewayOutput, error)

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

See DeleteVirtualGateway 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 (*AppMesh) DeleteVirtualNode

func (c *AppMesh) DeleteVirtualNode(input *DeleteVirtualNodeInput) (*DeleteVirtualNodeOutput, error)

DeleteVirtualNode API operation for AWS App Mesh.

Deletes an existing virtual node.

You must delete any virtual services that list a virtual node as a service provider before you can delete the virtual node itself.

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 App Mesh's API operation DeleteVirtualNode for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualNode

func (*AppMesh) DeleteVirtualNodeRequest

func (c *AppMesh) DeleteVirtualNodeRequest(input *DeleteVirtualNodeInput) (req *request.Request, output *DeleteVirtualNodeOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualNode

func (*AppMesh) DeleteVirtualNodeWithContext

func (c *AppMesh) DeleteVirtualNodeWithContext(ctx aws.Context, input *DeleteVirtualNodeInput, opts ...request.Option) (*DeleteVirtualNodeOutput, error)

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

See DeleteVirtualNode 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 (*AppMesh) DeleteVirtualRouter

func (c *AppMesh) DeleteVirtualRouter(input *DeleteVirtualRouterInput) (*DeleteVirtualRouterOutput, error)

DeleteVirtualRouter API operation for AWS App Mesh.

Deletes an existing virtual router.

You must delete any routes associated with the virtual router before you can delete the router itself.

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 App Mesh's API operation DeleteVirtualRouter for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualRouter

func (*AppMesh) DeleteVirtualRouterRequest

func (c *AppMesh) DeleteVirtualRouterRequest(input *DeleteVirtualRouterInput) (req *request.Request, output *DeleteVirtualRouterOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualRouter

func (*AppMesh) DeleteVirtualRouterWithContext

func (c *AppMesh) DeleteVirtualRouterWithContext(ctx aws.Context, input *DeleteVirtualRouterInput, opts ...request.Option) (*DeleteVirtualRouterOutput, error)

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

See DeleteVirtualRouter 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 (*AppMesh) DeleteVirtualService added in v1.17.13

func (c *AppMesh) DeleteVirtualService(input *DeleteVirtualServiceInput) (*DeleteVirtualServiceOutput, error)

DeleteVirtualService API operation for AWS App Mesh.

Deletes an existing virtual service.

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 App Mesh's API operation DeleteVirtualService for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualService

func (*AppMesh) DeleteVirtualServiceRequest added in v1.17.13

func (c *AppMesh) DeleteVirtualServiceRequest(input *DeleteVirtualServiceInput) (req *request.Request, output *DeleteVirtualServiceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteVirtualService

func (*AppMesh) DeleteVirtualServiceWithContext added in v1.17.13

func (c *AppMesh) DeleteVirtualServiceWithContext(ctx aws.Context, input *DeleteVirtualServiceInput, opts ...request.Option) (*DeleteVirtualServiceOutput, error)

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

See DeleteVirtualService 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 (*AppMesh) DescribeGatewayRoute added in v1.33.5

func (c *AppMesh) DescribeGatewayRoute(input *DescribeGatewayRouteInput) (*DescribeGatewayRouteOutput, error)

DescribeGatewayRoute API operation for AWS App Mesh.

Describes an existing gateway route.

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 App Mesh's API operation DescribeGatewayRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeGatewayRoute

func (*AppMesh) DescribeGatewayRouteRequest added in v1.33.5

func (c *AppMesh) DescribeGatewayRouteRequest(input *DescribeGatewayRouteInput) (req *request.Request, output *DescribeGatewayRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeGatewayRoute

func (*AppMesh) DescribeGatewayRouteWithContext added in v1.33.5

func (c *AppMesh) DescribeGatewayRouteWithContext(ctx aws.Context, input *DescribeGatewayRouteInput, opts ...request.Option) (*DescribeGatewayRouteOutput, error)

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

See DescribeGatewayRoute 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 (*AppMesh) DescribeMesh

func (c *AppMesh) DescribeMesh(input *DescribeMeshInput) (*DescribeMeshOutput, error)

DescribeMesh API operation for AWS App Mesh.

Describes an existing service mesh.

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 App Mesh's API operation DescribeMesh for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeMesh

func (*AppMesh) DescribeMeshRequest

func (c *AppMesh) DescribeMeshRequest(input *DescribeMeshInput) (req *request.Request, output *DescribeMeshOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeMesh

func (*AppMesh) DescribeMeshWithContext

func (c *AppMesh) DescribeMeshWithContext(ctx aws.Context, input *DescribeMeshInput, opts ...request.Option) (*DescribeMeshOutput, error)

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

See DescribeMesh 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 (*AppMesh) DescribeRoute

func (c *AppMesh) DescribeRoute(input *DescribeRouteInput) (*DescribeRouteOutput, error)

DescribeRoute API operation for AWS App Mesh.

Describes an existing route.

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 App Mesh's API operation DescribeRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeRoute

func (*AppMesh) DescribeRouteRequest

func (c *AppMesh) DescribeRouteRequest(input *DescribeRouteInput) (req *request.Request, output *DescribeRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeRoute

func (*AppMesh) DescribeRouteWithContext

func (c *AppMesh) DescribeRouteWithContext(ctx aws.Context, input *DescribeRouteInput, opts ...request.Option) (*DescribeRouteOutput, error)

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

See DescribeRoute 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 (*AppMesh) DescribeVirtualGateway added in v1.33.5

func (c *AppMesh) DescribeVirtualGateway(input *DescribeVirtualGatewayInput) (*DescribeVirtualGatewayOutput, error)

DescribeVirtualGateway API operation for AWS App Mesh.

Describes an existing virtual gateway.

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 App Mesh's API operation DescribeVirtualGateway for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualGateway

func (*AppMesh) DescribeVirtualGatewayRequest added in v1.33.5

func (c *AppMesh) DescribeVirtualGatewayRequest(input *DescribeVirtualGatewayInput) (req *request.Request, output *DescribeVirtualGatewayOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualGateway

func (*AppMesh) DescribeVirtualGatewayWithContext added in v1.33.5

func (c *AppMesh) DescribeVirtualGatewayWithContext(ctx aws.Context, input *DescribeVirtualGatewayInput, opts ...request.Option) (*DescribeVirtualGatewayOutput, error)

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

See DescribeVirtualGateway 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 (*AppMesh) DescribeVirtualNode

func (c *AppMesh) DescribeVirtualNode(input *DescribeVirtualNodeInput) (*DescribeVirtualNodeOutput, error)

DescribeVirtualNode API operation for AWS App Mesh.

Describes an existing virtual node.

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 App Mesh's API operation DescribeVirtualNode for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualNode

func (*AppMesh) DescribeVirtualNodeRequest

func (c *AppMesh) DescribeVirtualNodeRequest(input *DescribeVirtualNodeInput) (req *request.Request, output *DescribeVirtualNodeOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualNode

func (*AppMesh) DescribeVirtualNodeWithContext

func (c *AppMesh) DescribeVirtualNodeWithContext(ctx aws.Context, input *DescribeVirtualNodeInput, opts ...request.Option) (*DescribeVirtualNodeOutput, error)

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

See DescribeVirtualNode 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 (*AppMesh) DescribeVirtualRouter

func (c *AppMesh) DescribeVirtualRouter(input *DescribeVirtualRouterInput) (*DescribeVirtualRouterOutput, error)

DescribeVirtualRouter API operation for AWS App Mesh.

Describes an existing virtual router.

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 App Mesh's API operation DescribeVirtualRouter for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualRouter

func (*AppMesh) DescribeVirtualRouterRequest

func (c *AppMesh) DescribeVirtualRouterRequest(input *DescribeVirtualRouterInput) (req *request.Request, output *DescribeVirtualRouterOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualRouter

func (*AppMesh) DescribeVirtualRouterWithContext

func (c *AppMesh) DescribeVirtualRouterWithContext(ctx aws.Context, input *DescribeVirtualRouterInput, opts ...request.Option) (*DescribeVirtualRouterOutput, error)

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

See DescribeVirtualRouter 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 (*AppMesh) DescribeVirtualService added in v1.17.13

func (c *AppMesh) DescribeVirtualService(input *DescribeVirtualServiceInput) (*DescribeVirtualServiceOutput, error)

DescribeVirtualService API operation for AWS App Mesh.

Describes an existing virtual service.

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 App Mesh's API operation DescribeVirtualService for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualService

func (*AppMesh) DescribeVirtualServiceRequest added in v1.17.13

func (c *AppMesh) DescribeVirtualServiceRequest(input *DescribeVirtualServiceInput) (req *request.Request, output *DescribeVirtualServiceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeVirtualService

func (*AppMesh) DescribeVirtualServiceWithContext added in v1.17.13

func (c *AppMesh) DescribeVirtualServiceWithContext(ctx aws.Context, input *DescribeVirtualServiceInput, opts ...request.Option) (*DescribeVirtualServiceOutput, error)

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

See DescribeVirtualService 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 (*AppMesh) ListGatewayRoutes added in v1.33.5

func (c *AppMesh) ListGatewayRoutes(input *ListGatewayRoutesInput) (*ListGatewayRoutesOutput, error)

ListGatewayRoutes API operation for AWS App Mesh.

Returns a list of existing gateway routes that are associated to a virtual gateway.

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 App Mesh's API operation ListGatewayRoutes for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListGatewayRoutes

func (*AppMesh) ListGatewayRoutesPages added in v1.33.5

func (c *AppMesh) ListGatewayRoutesPages(input *ListGatewayRoutesInput, fn func(*ListGatewayRoutesOutput, bool) bool) error

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

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

func (*AppMesh) ListGatewayRoutesPagesWithContext added in v1.33.5

func (c *AppMesh) ListGatewayRoutesPagesWithContext(ctx aws.Context, input *ListGatewayRoutesInput, fn func(*ListGatewayRoutesOutput, bool) bool, opts ...request.Option) error

ListGatewayRoutesPagesWithContext same as ListGatewayRoutesPages 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 (*AppMesh) ListGatewayRoutesRequest added in v1.33.5

func (c *AppMesh) ListGatewayRoutesRequest(input *ListGatewayRoutesInput) (req *request.Request, output *ListGatewayRoutesOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListGatewayRoutes

func (*AppMesh) ListGatewayRoutesWithContext added in v1.33.5

func (c *AppMesh) ListGatewayRoutesWithContext(ctx aws.Context, input *ListGatewayRoutesInput, opts ...request.Option) (*ListGatewayRoutesOutput, error)

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

See ListGatewayRoutes 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 (*AppMesh) ListMeshes

func (c *AppMesh) ListMeshes(input *ListMeshesInput) (*ListMeshesOutput, error)

ListMeshes API operation for AWS App Mesh.

Returns a list of existing service meshes.

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 App Mesh's API operation ListMeshes for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListMeshes

func (*AppMesh) ListMeshesPages

func (c *AppMesh) ListMeshesPages(input *ListMeshesInput, fn func(*ListMeshesOutput, bool) bool) error

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

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

func (*AppMesh) ListMeshesPagesWithContext

func (c *AppMesh) ListMeshesPagesWithContext(ctx aws.Context, input *ListMeshesInput, fn func(*ListMeshesOutput, bool) bool, opts ...request.Option) error

ListMeshesPagesWithContext same as ListMeshesPages 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 (*AppMesh) ListMeshesRequest

func (c *AppMesh) ListMeshesRequest(input *ListMeshesInput) (req *request.Request, output *ListMeshesOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListMeshes

func (*AppMesh) ListMeshesWithContext

func (c *AppMesh) ListMeshesWithContext(ctx aws.Context, input *ListMeshesInput, opts ...request.Option) (*ListMeshesOutput, error)

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

See ListMeshes 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 (*AppMesh) ListRoutes

func (c *AppMesh) ListRoutes(input *ListRoutesInput) (*ListRoutesOutput, error)

ListRoutes API operation for AWS App Mesh.

Returns a list of existing routes in a service mesh.

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 App Mesh's API operation ListRoutes for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListRoutes

func (*AppMesh) ListRoutesPages

func (c *AppMesh) ListRoutesPages(input *ListRoutesInput, fn func(*ListRoutesOutput, bool) bool) error

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

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

func (*AppMesh) ListRoutesPagesWithContext

func (c *AppMesh) ListRoutesPagesWithContext(ctx aws.Context, input *ListRoutesInput, fn func(*ListRoutesOutput, bool) bool, opts ...request.Option) error

ListRoutesPagesWithContext same as ListRoutesPages 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 (*AppMesh) ListRoutesRequest

func (c *AppMesh) ListRoutesRequest(input *ListRoutesInput) (req *request.Request, output *ListRoutesOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListRoutes

func (*AppMesh) ListRoutesWithContext

func (c *AppMesh) ListRoutesWithContext(ctx aws.Context, input *ListRoutesInput, opts ...request.Option) (*ListRoutesOutput, error)

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

See ListRoutes 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 (*AppMesh) ListTagsForResource added in v1.19.3

func (c *AppMesh) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)

ListTagsForResource API operation for AWS App Mesh.

List the tags for an App Mesh resource.

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 App Mesh's API operation ListTagsForResource for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListTagsForResource

func (*AppMesh) ListTagsForResourcePages added in v1.19.3

func (c *AppMesh) ListTagsForResourcePages(input *ListTagsForResourceInput, fn func(*ListTagsForResourceOutput, bool) bool) error

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

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

func (*AppMesh) ListTagsForResourcePagesWithContext added in v1.19.3

func (c *AppMesh) ListTagsForResourcePagesWithContext(ctx aws.Context, input *ListTagsForResourceInput, fn func(*ListTagsForResourceOutput, bool) bool, opts ...request.Option) error

ListTagsForResourcePagesWithContext same as ListTagsForResourcePages 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 (*AppMesh) ListTagsForResourceRequest added in v1.19.3

func (c *AppMesh) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListTagsForResource

func (*AppMesh) ListTagsForResourceWithContext added in v1.19.3

func (c *AppMesh) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error)

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

See ListTagsForResource 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 (*AppMesh) ListVirtualGateways added in v1.33.5

func (c *AppMesh) ListVirtualGateways(input *ListVirtualGatewaysInput) (*ListVirtualGatewaysOutput, error)

ListVirtualGateways API operation for AWS App Mesh.

Returns a list of existing virtual gateways in a service mesh.

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 App Mesh's API operation ListVirtualGateways for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualGateways

func (*AppMesh) ListVirtualGatewaysPages added in v1.33.5

func (c *AppMesh) ListVirtualGatewaysPages(input *ListVirtualGatewaysInput, fn func(*ListVirtualGatewaysOutput, bool) bool) error

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

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

func (*AppMesh) ListVirtualGatewaysPagesWithContext added in v1.33.5

func (c *AppMesh) ListVirtualGatewaysPagesWithContext(ctx aws.Context, input *ListVirtualGatewaysInput, fn func(*ListVirtualGatewaysOutput, bool) bool, opts ...request.Option) error

ListVirtualGatewaysPagesWithContext same as ListVirtualGatewaysPages 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 (*AppMesh) ListVirtualGatewaysRequest added in v1.33.5

func (c *AppMesh) ListVirtualGatewaysRequest(input *ListVirtualGatewaysInput) (req *request.Request, output *ListVirtualGatewaysOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualGateways

func (*AppMesh) ListVirtualGatewaysWithContext added in v1.33.5

func (c *AppMesh) ListVirtualGatewaysWithContext(ctx aws.Context, input *ListVirtualGatewaysInput, opts ...request.Option) (*ListVirtualGatewaysOutput, error)

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

See ListVirtualGateways 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 (*AppMesh) ListVirtualNodes

func (c *AppMesh) ListVirtualNodes(input *ListVirtualNodesInput) (*ListVirtualNodesOutput, error)

ListVirtualNodes API operation for AWS App Mesh.

Returns a list of existing virtual nodes.

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 App Mesh's API operation ListVirtualNodes for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualNodes

func (*AppMesh) ListVirtualNodesPages

func (c *AppMesh) ListVirtualNodesPages(input *ListVirtualNodesInput, fn func(*ListVirtualNodesOutput, bool) bool) error

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

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

func (*AppMesh) ListVirtualNodesPagesWithContext

func (c *AppMesh) ListVirtualNodesPagesWithContext(ctx aws.Context, input *ListVirtualNodesInput, fn func(*ListVirtualNodesOutput, bool) bool, opts ...request.Option) error

ListVirtualNodesPagesWithContext same as ListVirtualNodesPages 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 (*AppMesh) ListVirtualNodesRequest

func (c *AppMesh) ListVirtualNodesRequest(input *ListVirtualNodesInput) (req *request.Request, output *ListVirtualNodesOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualNodes

func (*AppMesh) ListVirtualNodesWithContext

func (c *AppMesh) ListVirtualNodesWithContext(ctx aws.Context, input *ListVirtualNodesInput, opts ...request.Option) (*ListVirtualNodesOutput, error)

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

See ListVirtualNodes 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 (*AppMesh) ListVirtualRouters

func (c *AppMesh) ListVirtualRouters(input *ListVirtualRoutersInput) (*ListVirtualRoutersOutput, error)

ListVirtualRouters API operation for AWS App Mesh.

Returns a list of existing virtual routers in a service mesh.

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 App Mesh's API operation ListVirtualRouters for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualRouters

func (*AppMesh) ListVirtualRoutersPages

func (c *AppMesh) ListVirtualRoutersPages(input *ListVirtualRoutersInput, fn func(*ListVirtualRoutersOutput, bool) bool) error

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

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

func (*AppMesh) ListVirtualRoutersPagesWithContext

func (c *AppMesh) ListVirtualRoutersPagesWithContext(ctx aws.Context, input *ListVirtualRoutersInput, fn func(*ListVirtualRoutersOutput, bool) bool, opts ...request.Option) error

ListVirtualRoutersPagesWithContext same as ListVirtualRoutersPages 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 (*AppMesh) ListVirtualRoutersRequest

func (c *AppMesh) ListVirtualRoutersRequest(input *ListVirtualRoutersInput) (req *request.Request, output *ListVirtualRoutersOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualRouters

func (*AppMesh) ListVirtualRoutersWithContext

func (c *AppMesh) ListVirtualRoutersWithContext(ctx aws.Context, input *ListVirtualRoutersInput, opts ...request.Option) (*ListVirtualRoutersOutput, error)

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

See ListVirtualRouters 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 (*AppMesh) ListVirtualServices added in v1.17.13

func (c *AppMesh) ListVirtualServices(input *ListVirtualServicesInput) (*ListVirtualServicesOutput, error)

ListVirtualServices API operation for AWS App Mesh.

Returns a list of existing virtual services in a service mesh.

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 App Mesh's API operation ListVirtualServices for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualServices

func (*AppMesh) ListVirtualServicesPages added in v1.17.13

func (c *AppMesh) ListVirtualServicesPages(input *ListVirtualServicesInput, fn func(*ListVirtualServicesOutput, bool) bool) error

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

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

func (*AppMesh) ListVirtualServicesPagesWithContext added in v1.17.13

func (c *AppMesh) ListVirtualServicesPagesWithContext(ctx aws.Context, input *ListVirtualServicesInput, fn func(*ListVirtualServicesOutput, bool) bool, opts ...request.Option) error

ListVirtualServicesPagesWithContext same as ListVirtualServicesPages 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 (*AppMesh) ListVirtualServicesRequest added in v1.17.13

func (c *AppMesh) ListVirtualServicesRequest(input *ListVirtualServicesInput) (req *request.Request, output *ListVirtualServicesOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListVirtualServices

func (*AppMesh) ListVirtualServicesWithContext added in v1.17.13

func (c *AppMesh) ListVirtualServicesWithContext(ctx aws.Context, input *ListVirtualServicesInput, opts ...request.Option) (*ListVirtualServicesOutput, error)

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

See ListVirtualServices 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 (*AppMesh) TagResource added in v1.19.3

func (c *AppMesh) TagResource(input *TagResourceInput) (*TagResourceOutput, error)

TagResource API operation for AWS App Mesh.

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted.

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 App Mesh's API operation TagResource for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyTagsException The request exceeds the maximum allowed number of tags allowed per resource. The current limit is 50 user tags per resource. You must reduce the number of tags in the request. None of the tags in this request were applied.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/TagResource

func (*AppMesh) TagResourceRequest added in v1.19.3

func (c *AppMesh) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/TagResource

func (*AppMesh) TagResourceWithContext added in v1.19.3

func (c *AppMesh) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error)

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

See TagResource 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 (*AppMesh) UntagResource added in v1.19.3

func (c *AppMesh) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error)

UntagResource API operation for AWS App Mesh.

Deletes specified tags from a resource.

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 App Mesh's API operation UntagResource for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UntagResource

func (*AppMesh) UntagResourceRequest added in v1.19.3

func (c *AppMesh) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UntagResource

func (*AppMesh) UntagResourceWithContext added in v1.19.3

func (c *AppMesh) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error)

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

See UntagResource 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 (*AppMesh) UpdateGatewayRoute added in v1.33.5

func (c *AppMesh) UpdateGatewayRoute(input *UpdateGatewayRouteInput) (*UpdateGatewayRouteOutput, error)

UpdateGatewayRoute API operation for AWS App Mesh.

Updates an existing gateway route that is associated to a specified virtual gateway in a service mesh.

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 App Mesh's API operation UpdateGatewayRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateGatewayRoute

func (*AppMesh) UpdateGatewayRouteRequest added in v1.33.5

func (c *AppMesh) UpdateGatewayRouteRequest(input *UpdateGatewayRouteInput) (req *request.Request, output *UpdateGatewayRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateGatewayRoute

func (*AppMesh) UpdateGatewayRouteWithContext added in v1.33.5

func (c *AppMesh) UpdateGatewayRouteWithContext(ctx aws.Context, input *UpdateGatewayRouteInput, opts ...request.Option) (*UpdateGatewayRouteOutput, error)

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

See UpdateGatewayRoute 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 (*AppMesh) UpdateMesh added in v1.19.3

func (c *AppMesh) UpdateMesh(input *UpdateMeshInput) (*UpdateMeshOutput, error)

UpdateMesh API operation for AWS App Mesh.

Updates an existing service mesh.

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 App Mesh's API operation UpdateMesh for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateMesh

func (*AppMesh) UpdateMeshRequest added in v1.19.3

func (c *AppMesh) UpdateMeshRequest(input *UpdateMeshInput) (req *request.Request, output *UpdateMeshOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateMesh

func (*AppMesh) UpdateMeshWithContext added in v1.19.3

func (c *AppMesh) UpdateMeshWithContext(ctx aws.Context, input *UpdateMeshInput, opts ...request.Option) (*UpdateMeshOutput, error)

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

See UpdateMesh 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 (*AppMesh) UpdateRoute

func (c *AppMesh) UpdateRoute(input *UpdateRouteInput) (*UpdateRouteOutput, error)

UpdateRoute API operation for AWS App Mesh.

Updates an existing route for a specified service mesh and virtual router.

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 App Mesh's API operation UpdateRoute for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateRoute

func (*AppMesh) UpdateRouteRequest

func (c *AppMesh) UpdateRouteRequest(input *UpdateRouteInput) (req *request.Request, output *UpdateRouteOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateRoute

func (*AppMesh) UpdateRouteWithContext

func (c *AppMesh) UpdateRouteWithContext(ctx aws.Context, input *UpdateRouteInput, opts ...request.Option) (*UpdateRouteOutput, error)

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

See UpdateRoute 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 (*AppMesh) UpdateVirtualGateway added in v1.33.5

func (c *AppMesh) UpdateVirtualGateway(input *UpdateVirtualGatewayInput) (*UpdateVirtualGatewayOutput, error)

UpdateVirtualGateway API operation for AWS App Mesh.

Updates an existing virtual gateway in a specified service mesh.

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 App Mesh's API operation UpdateVirtualGateway for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualGateway

func (*AppMesh) UpdateVirtualGatewayRequest added in v1.33.5

func (c *AppMesh) UpdateVirtualGatewayRequest(input *UpdateVirtualGatewayInput) (req *request.Request, output *UpdateVirtualGatewayOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualGateway

func (*AppMesh) UpdateVirtualGatewayWithContext added in v1.33.5

func (c *AppMesh) UpdateVirtualGatewayWithContext(ctx aws.Context, input *UpdateVirtualGatewayInput, opts ...request.Option) (*UpdateVirtualGatewayOutput, error)

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

See UpdateVirtualGateway 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 (*AppMesh) UpdateVirtualNode

func (c *AppMesh) UpdateVirtualNode(input *UpdateVirtualNodeInput) (*UpdateVirtualNodeOutput, error)

UpdateVirtualNode API operation for AWS App Mesh.

Updates an existing virtual node in a specified service mesh.

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 App Mesh's API operation UpdateVirtualNode for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualNode

func (*AppMesh) UpdateVirtualNodeRequest

func (c *AppMesh) UpdateVirtualNodeRequest(input *UpdateVirtualNodeInput) (req *request.Request, output *UpdateVirtualNodeOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualNode

func (*AppMesh) UpdateVirtualNodeWithContext

func (c *AppMesh) UpdateVirtualNodeWithContext(ctx aws.Context, input *UpdateVirtualNodeInput, opts ...request.Option) (*UpdateVirtualNodeOutput, error)

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

See UpdateVirtualNode 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 (*AppMesh) UpdateVirtualRouter

func (c *AppMesh) UpdateVirtualRouter(input *UpdateVirtualRouterInput) (*UpdateVirtualRouterOutput, error)

UpdateVirtualRouter API operation for AWS App Mesh.

Updates an existing virtual router in a specified service mesh.

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 App Mesh's API operation UpdateVirtualRouter for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualRouter

func (*AppMesh) UpdateVirtualRouterRequest

func (c *AppMesh) UpdateVirtualRouterRequest(input *UpdateVirtualRouterInput) (req *request.Request, output *UpdateVirtualRouterOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualRouter

func (*AppMesh) UpdateVirtualRouterWithContext

func (c *AppMesh) UpdateVirtualRouterWithContext(ctx aws.Context, input *UpdateVirtualRouterInput, opts ...request.Option) (*UpdateVirtualRouterOutput, error)

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

See UpdateVirtualRouter 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 (*AppMesh) UpdateVirtualService added in v1.17.13

func (c *AppMesh) UpdateVirtualService(input *UpdateVirtualServiceInput) (*UpdateVirtualServiceOutput, error)

UpdateVirtualService API operation for AWS App Mesh.

Updates an existing virtual service in a specified service mesh.

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 App Mesh's API operation UpdateVirtualService for usage and error information.

Returned Error Types:

  • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.

  • BadRequestException The request syntax was malformed. Check your request syntax and try again.

  • ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.

  • TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

  • ForbiddenException You don't have permissions to perform this action.

  • ServiceUnavailableException The request has failed due to a temporary failure of the service.

  • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.

  • LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits (https://docs.aws.amazon.com/app-mesh/latest/userguide/service-quotas.html) in the App Mesh User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualService

func (*AppMesh) UpdateVirtualServiceRequest added in v1.17.13

func (c *AppMesh) UpdateVirtualServiceRequest(input *UpdateVirtualServiceInput) (req *request.Request, output *UpdateVirtualServiceOutput)

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

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

See also, https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateVirtualService

func (*AppMesh) UpdateVirtualServiceWithContext added in v1.17.13

func (c *AppMesh) UpdateVirtualServiceWithContext(ctx aws.Context, input *UpdateVirtualServiceInput, opts ...request.Option) (*UpdateVirtualServiceOutput, error)

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

See UpdateVirtualService 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 AwsCloudMapInstanceAttribute added in v1.20.0

type AwsCloudMapInstanceAttribute struct {

	// The name of an Cloud Map service instance attribute key. Any Cloud Map service
	// instance that contains the specified key and value is returned.
	//
	// Key is a required field
	Key *string `locationName:"key" min:"1" type:"string" required:"true"`

	// The value of an Cloud Map service instance attribute key. Any Cloud Map service
	// instance that contains the specified key and value is returned.
	//
	// Value is a required field
	Value *string `locationName:"value" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

An object that represents the Cloud Map attribute information for your virtual node.

Cloud Map is not available in the eu-south-1 Region.

func (AwsCloudMapInstanceAttribute) GoString added in v1.20.0

func (s AwsCloudMapInstanceAttribute) 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 (*AwsCloudMapInstanceAttribute) SetKey added in v1.20.0

SetKey sets the Key field's value.

func (*AwsCloudMapInstanceAttribute) SetValue added in v1.20.0

SetValue sets the Value field's value.

func (AwsCloudMapInstanceAttribute) String added in v1.20.0

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 (*AwsCloudMapInstanceAttribute) Validate added in v1.20.0

func (s *AwsCloudMapInstanceAttribute) Validate() error

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

type AwsCloudMapServiceDiscovery added in v1.20.0

type AwsCloudMapServiceDiscovery struct {

	// A string map that contains attributes with values that you can use to filter
	// instances by any custom attribute that you specified when you registered
	// the instance. Only instances that match all of the specified key/value pairs
	// will be returned.
	Attributes []*AwsCloudMapInstanceAttribute `locationName:"attributes" type:"list"`

	// The IP version to use to control traffic within the mesh.
	IpPreference *string `locationName:"ipPreference" type:"string" enum:"IpPreference"`

	// The name of the Cloud Map namespace to use.
	//
	// NamespaceName is a required field
	NamespaceName *string `locationName:"namespaceName" min:"1" type:"string" required:"true"`

	// The name of the Cloud Map service to use.
	//
	// ServiceName is a required field
	ServiceName *string `locationName:"serviceName" min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

An object that represents the Cloud Map service discovery information for your virtual node.

Cloud Map is not available in the eu-south-1 Region.

func (AwsCloudMapServiceDiscovery) GoString added in v1.20.0

func (s AwsCloudMapServiceDiscovery) 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 (*AwsCloudMapServiceDiscovery) SetAttributes added in v1.20.0

SetAttributes sets the Attributes field's value.

func (*AwsCloudMapServiceDiscovery) SetIpPreference added in v1.44.17

SetIpPreference sets the IpPreference field's value.

func (*AwsCloudMapServiceDiscovery) SetNamespaceName added in v1.20.0

SetNamespaceName sets the NamespaceName field's value.

func (*AwsCloudMapServiceDiscovery) SetServiceName added in v1.20.0

SetServiceName sets the ServiceName field's value.

func (AwsCloudMapServiceDiscovery) String added in v1.20.0

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 (*AwsCloudMapServiceDiscovery) Validate added in v1.20.0

func (s *AwsCloudMapServiceDiscovery) Validate() error

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

type Backend added in v1.17.13

type Backend struct {

	// Specifies a virtual service to use as a backend.
	VirtualService *VirtualServiceBackend `locationName:"virtualService" type:"structure"`
	// contains filtered or unexported fields
}

An object that represents the backends that a virtual node is expected to send outbound traffic to.

func (Backend) GoString added in v1.17.13

func (s Backend) 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 (*Backend) SetVirtualService added in v1.17.13

func (s *Backend) SetVirtualService(v *VirtualServiceBackend) *Backend

SetVirtualService sets the VirtualService field's value.