apprunner

package
v1.7.0 Latest Latest
Warning

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

 Go to latest Published: Oct 6, 2026 License: MIT Imports: 21 Imported by: 0

README

App Runner

Parity grade: A · SDK aws-sdk-go-v2/service/apprunner@v1.42.4 · last audited 2026-09-20 (22b4f068c)

Coverage

Metric Value
PARITY entries audited 37 (36 ok, 1 partial)
Feature families 1 (1 ok)
Known gaps 2
Deferred items 0
Resource leaks clean
Known gaps
  • CreateVpcIngressConnection doesn't validate that ServiceArn refers to an existing service, allowing a dangling reference. Left as-is because CreateVpcIngressConnection's documented error set has no ResourceNotFoundException -- adding validation would need a new InvalidRequestException-mapped check, not a NotFound one, to stay wire-correct; low traffic op, deferred. Re-verified 2026-07-23: still the correct call, not a bug.
  • CustomDomain omits CertificateValidationRecords (deserializers.go:4899, 5381): no certificate validation flow is modeled, so there is no internal state to surface.

More

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	// ErrNotFound is returned when a resource does not exist.
	ErrNotFound = awserr.New(resourceNotFoundType, awserr.ErrNotFound)
	// ErrAlreadyExists is returned when a service/connection/vpc-ingress-connection
	// name (or custom domain) is already in use. App Runner has no dedicated
	// "already exists" exception; unlike ResourceNotFoundException,
	// ServiceQuotaExceededException is only in the documented error set for
	// some Create* operations and not others (e.g. AssociateCustomDomain
	// doesn't accept it), so InvalidRequestException -- valid on every App
	// Runner operation -- is used to describe the conflict instead.
	ErrAlreadyExists = awserr.New(invalidRequestType, awserr.ErrAlreadyExists)
	// ErrInvalidParameter is returned for invalid input.
	ErrInvalidParameter = awserr.New(invalidRequestType, awserr.ErrInvalidParameter)
	// ErrInvalidState is returned when a service is in an invalid state for the operation.
	ErrInvalidState = awserr.New(invalidStateType, awserr.ErrConflict)
)
View Source 
var ErrNilAppContext = errors.New("AppContext is required")

ErrNilAppContext is returned when Provider.Init is called with a nil AppContext.

Functions

This section is empty.

Types

type AutoScalingConfiguration 

type AutoScalingConfiguration struct {
	CreatedAt                        time.Time
	DeletedAt                        time.Time
	AutoScalingConfigurationArn      string
	AutoScalingConfigurationName     string
	Status                           string
	AutoScalingConfigurationRevision int32
	MaxConcurrency                   int32
	MaxSize                          int32
	MinSize                          int32
	IsDefault                        bool
	HasAssociatedService             bool
	Latest                           bool
}

AutoScalingConfiguration represents an App Runner auto scaling configuration. CreatedAt is first to reduce GC pointer bytes.

type AutoScalingConfigurationSummary 

type AutoScalingConfigurationSummary struct {
	CreatedAt                        time.Time
	AutoScalingConfigurationArn      string
	AutoScalingConfigurationName     string
	Status                           string
	AutoScalingConfigurationRevision int32
	IsDefault                        bool
	HasAssociatedService             bool
}

AutoScalingConfigurationSummary is a summary entry for list responses.

type CertificateValidationRecord 

type CertificateValidationRecord struct {
	Name   string
	Type   string
	Value  string
	Status string
}

CertificateValidationRecord is a DNS CNAME record App Runner asks the caller to publish to validate a custom domain's ACM certificate.

type CodeSource added in v1.2.0 

type CodeSource struct {
	RuntimeEnvironmentVariables map[string]string `json:"runtimeEnvironmentVariables,omitempty"`
	RuntimeEnvironmentSecrets   map[string]string `json:"runtimeEnvironmentSecrets,omitempty"`
	RepositoryURL               string            `json:"repositoryUrl"`
	SourceCodeVersionType       string            `json:"sourceCodeVersionType"`
	SourceCodeVersionValue      string            `json:"sourceCodeVersionValue"`
	SourceDirectory             string            `json:"sourceDirectory"`
	ConfigurationSource         string            `json:"configurationSource"`
	Runtime                     string            `json:"runtime"`
	BuildCommand                string            `json:"buildCommand"`
	StartCommand                string            `json:"startCommand"`
	Port                        string            `json:"port"`
}

CodeSource mirrors types.CodeRepository (+ its nested CodeConfiguration/ CodeConfigurationValues/SourceCodeVersion, flattened).

type Connection 

type Connection struct {
	CreatedAt      time.Time
	ConnectionArn  string
	ConnectionName string
	ProviderType   string
	Status         string
}

Connection represents an App Runner connection resource. CreatedAt is first to reduce GC pointer bytes.

type ConnectionSummary 

type ConnectionSummary struct {
	CreatedAt      time.Time
	ConnectionArn  string
	ConnectionName string
	ProviderType   string
	Status         string
}

ConnectionSummary is a summary entry for list responses.

type CreateServiceParams added in v1.2.0 

type CreateServiceParams struct {
	Source                      SourceConfig
	Network                     *NetworkConfig
	HealthCheck                 *HealthCheckConfig
	Observability               *ServiceObservability
	Tags                        map[string]string
	Instance                    InstanceConfig
	Name                        string
	AutoScalingConfigurationArn string
	EncryptionKmsKey            string
}

CreateServiceParams groups CreateService's backend inputs. A nil Network/ HealthCheck/Observability means "apply App Runner's default", matching the real API's behavior when those optional request members are omitted.

type CustomDomain 

type CustomDomain struct {
	DomainName                   string
	Status                       string
	CertificateValidationRecords []CertificateValidationRecord
	EnableWWWSubdomain           bool
}

CustomDomain represents a custom domain associated with an App Runner service.

type Handler 

type Handler struct {
	Backend StorageBackend
	// contains filtered or unexported fields
}

Handler handles App Runner HTTP requests.

func NewHandler 

func NewHandler(b StorageBackend) *Handler

NewHandler constructs a new Handler.

func (*Handler) BackendFor 

func (h *Handler) BackendFor(region string) StorageBackend

BackendFor returns the backend serving region: the home backend, or the sibling built on first use.

func (*Handler) EnableRegions 

func (h *Handler) EnableRegions()

EnableRegions makes h serve every other region through lazily built per-region siblings.

func (*Handler) ExtractOperation 

func (h *Handler) ExtractOperation(c *echo.Context) string

ExtractOperation extracts the operation name from the X-Amz-Target header.

func (*Handler) ExtractResource 

func (h *Handler) ExtractResource(_ *echo.Context) string

ExtractResource extracts the resource identifier from the request body.

func (*Handler) GetSupportedOperations 

func (h *Handler) GetSupportedOperations() []string

GetSupportedOperations returns the list of supported operations.

func (*Handler) Handler 

func (h *Handler) Handler() echo.HandlerFunc

Handler returns the Echo handler function for App Runner requests.

func (*Handler) MatchPriority 

func (h *Handler) MatchPriority() int

MatchPriority returns the routing priority.

func (*Handler) Name 

func (h *Handler) Name() string

Name returns the service name.

func (*Handler) RegionBackends 

func (h *Handler) RegionBackends() []StorageBackend

RegionBackends returns the home backend followed by every sibling built so far.

func (*Handler) RegionHandler 

func (h *Handler) RegionHandler(region string) *Handler

RegionHandler returns the handler serving region: h itself for the home region, else its sibling.

func (*Handler) Reset 

func (h *Handler) Reset()

Reset resets the backend and rebuilds the dispatch table.

func (*Handler) Restore 

func (h *Handler) Restore(ctx context.Context, data []byte) error

Restore implements persistence.Persistable.

func (*Handler) RouteMatcher 

func (h *Handler) RouteMatcher() service.Matcher

RouteMatcher returns a function that matches App Runner API requests.

func (*Handler) Snapshot 

func (h *Handler) Snapshot(ctx context.Context) []byte

Snapshot implements persistence.Persistable; other regions ride in an additive "regions" key.

type HealthCheckConfig added in v1.2.0 

type HealthCheckConfig struct {
	Protocol           string `json:"protocol"`
	Path               string `json:"path"`
	Interval           int32  `json:"interval"`
	Timeout            int32  `json:"timeout"`
	HealthyThreshold   int32  `json:"healthyThreshold"`
	UnhealthyThreshold int32  `json:"unhealthyThreshold"`
}

HealthCheckConfig mirrors types.HealthCheckConfiguration.

type ImageSource added in v1.2.0 

type ImageSource struct {
	RuntimeEnvironmentVariables map[string]string `json:"runtimeEnvironmentVariables,omitempty"`
	RuntimeEnvironmentSecrets   map[string]string `json:"runtimeEnvironmentSecrets,omitempty"`
	ImageIdentifier             string            `json:"imageIdentifier"`
	ImageRepositoryType         string            `json:"imageRepositoryType"`
	Port                        string            `json:"port"`
	StartCommand                string            `json:"startCommand"`
}

ImageSource mirrors types.ImageRepository (+ its nested ImageConfiguration, flattened for simplicity since App Runner allows only one of ImageRepository/CodeRepository per service).

type InMemoryBackend 

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

InMemoryBackend implements StorageBackend using in-memory maps.

Every map[string]*T resource field is a *store.Table[T] registered on registry (see store_setup.go for the registration and the rationale for which fields became Table/Index-backed vs. stayed raw maps). asgByName and obsByName are left as raw, order-sensitive slice-maps: they track ASG / observability-config revisions in ascending-revision order (the last element is "latest"), and store.Index does not preserve insertion order across removals (it swap-removes), so converting them to an Index would silently break the "latest == last element" invariant ListAutoScaling/ ListObservabilityConfigurations relies on. customDomains is left raw for the same reason (order-preserving append/splice, no sort). tags is left raw because its values are map[string]string, not *T.

func NewInMemoryBackend 

func NewInMemoryBackend(accountID, region string) *InMemoryBackend

NewInMemoryBackend constructs a new InMemoryBackend.

func (*InMemoryBackend) AccountID 

func (b *InMemoryBackend) AccountID() string

AccountID returns the account ID.

func (*InMemoryBackend) AssociateCustomDomain 

func (b *InMemoryBackend) AssociateCustomDomain(
	serviceArn, domainName string,
	enableWWW bool,
) (*CustomDomain, error)

AssociateCustomDomain associates a custom domain with a service.

func (*InMemoryBackend) CreateAutoScalingConfiguration 

func (b *InMemoryBackend) CreateAutoScalingConfiguration(
	name string,
	maxConcurrency, maxSize, minSize int32,
	tags map[string]string,
) (*AutoScalingConfiguration, error)

CreateAutoScalingConfiguration creates a new ASG config revision.

func (*InMemoryBackend) CreateConnection 

func (b *InMemoryBackend) CreateConnection(name, providerType string, tags map[string]string) (*Connection, error)

CreateConnection creates a new App Runner connection.

func (*InMemoryBackend) CreateObservabilityConfiguration 

func (b *InMemoryBackend) CreateObservabilityConfiguration(
	name, tracingVendor string,
	tags map[string]string,
) (*ObservabilityConfiguration, error)

CreateObservabilityConfiguration creates a new observability config revision.

func (*InMemoryBackend) CreateService 

func (b *InMemoryBackend) CreateService(params CreateServiceParams) (*Service, error)

CreateService creates a new App Runner service.

func (*InMemoryBackend) CreateVpcConnector 

func (b *InMemoryBackend) CreateVpcConnector(
	name string,
	subnets, securityGroups []string,
	tags map[string]string,
) (*VpcConnector, error)

CreateVpcConnector creates a new VPC connector.

func (*InMemoryBackend) CreateVpcIngressConnection 

func (b *InMemoryBackend) CreateVpcIngressConnection(
	name, serviceArn, vpcID, vpcEndpointID string,
	tags map[string]string,
) (*VpcIngressConnection, error)

CreateVpcIngressConnection creates a new VPC ingress connection.

func (*InMemoryBackend) DeleteAutoScalingConfiguration 

func (b *InMemoryBackend) DeleteAutoScalingConfiguration(asgArn string) (*AutoScalingConfiguration, error)

DeleteAutoScalingConfiguration deletes an ASG config.

func (*InMemoryBackend) DeleteConnection 

func (b *InMemoryBackend) DeleteConnection(connArn string) (*Connection, error)

DeleteConnection deletes a connection.

func (*InMemoryBackend) DeleteObservabilityConfiguration 

func (b *InMemoryBackend) DeleteObservabilityConfiguration(obsArn string) (*ObservabilityConfiguration, error)

DeleteObservabilityConfiguration deletes an observability config.

func (*InMemoryBackend) DeleteService 

func (b *InMemoryBackend) DeleteService(serviceArn string) (*Service, error)

DeleteService marks a service as deleted and removes it from active lookup.

func (*InMemoryBackend) DeleteVpcConnector 

func (b *InMemoryBackend) DeleteVpcConnector(vcArn string) (*VpcConnector, error)

DeleteVpcConnector deletes a VPC connector.

func (*InMemoryBackend) DeleteVpcIngressConnection 

func (b *InMemoryBackend) DeleteVpcIngressConnection(vicArn string) (*VpcIngressConnection, error)

DeleteVpcIngressConnection deletes a VPC ingress connection.

func (*InMemoryBackend) DescribeAutoScalingConfiguration 

func (b *InMemoryBackend) DescribeAutoScalingConfiguration(asgArn string) (*AutoScalingConfiguration, error)

DescribeAutoScalingConfiguration returns an ASG config by ARN.

func (*InMemoryBackend) DescribeCustomDomains 

func (b *InMemoryBackend) DescribeCustomDomains(
	serviceArn string,
	maxResults int32,
	nextToken string,
) ([]*CustomDomain, string, string, error)

DescribeCustomDomains returns custom domains for a service with pagination.

func (*InMemoryBackend) DescribeObservabilityConfiguration 

func (b *InMemoryBackend) DescribeObservabilityConfiguration(obsArn string) (*ObservabilityConfiguration, error)

DescribeObservabilityConfiguration returns an observability config by ARN.

func (*InMemoryBackend) DescribeService 

func (b *InMemoryBackend) DescribeService(serviceArn string) (*Service, error)

DescribeService returns full service details.

func (*InMemoryBackend) DescribeVpcConnector 

func (b *InMemoryBackend) DescribeVpcConnector(vcArn string) (*VpcConnector, error)

DescribeVpcConnector returns a VPC connector by ARN.

func (*InMemoryBackend) DescribeVpcIngressConnection 

func (b *InMemoryBackend) DescribeVpcIngressConnection(vicArn string) (*VpcIngressConnection, error)

DescribeVpcIngressConnection returns a VPC ingress connection by ARN.

func (*InMemoryBackend) DisassociateCustomDomain 

func (b *InMemoryBackend) DisassociateCustomDomain(serviceArn, domainName string) (*CustomDomain, error)

DisassociateCustomDomain removes a custom domain from a service.

func (*InMemoryBackend) ListAutoScalingConfigurations 

func (b *InMemoryBackend) ListAutoScalingConfigurations(
	nameFilter string,
	latestOnly bool,
	maxResults int32,
	nextToken string,
) ([]*AutoScalingConfigurationSummary, string, error)

ListAutoScalingConfigurations returns ASG configs with optional name filter.

func (*InMemoryBackend) ListConnections 

func (b *InMemoryBackend) ListConnections(
	nameFilter string,
	maxResults int32,
	nextToken string,
) ([]*ConnectionSummary, string, error)

ListConnections returns connections with optional name filter.

func (*InMemoryBackend) ListObservabilityConfigurations 

func (b *InMemoryBackend) ListObservabilityConfigurations(
	nameFilter string,
	latestOnly bool,
	maxResults int32,
	nextToken string,
) ([]*ObservabilityConfigurationSummary, string, error)

ListObservabilityConfigurations returns observability configs with optional name filter.

func (*InMemoryBackend) ListOperations 

func (b *InMemoryBackend) ListOperations(
	serviceArn string,
	maxResults int32,
	nextToken string,
) ([]*OperationSummary, string, error)

ListOperations returns operations for a service with pagination.

func (*InMemoryBackend) ListServices 

func (b *InMemoryBackend) ListServices(maxResults int32, nextToken string) ([]*ServiceSummary, string, error)

ListServices returns services sorted by ARN with pagination.

func (*InMemoryBackend) ListServicesForAutoScalingConfiguration 

func (b *InMemoryBackend) ListServicesForAutoScalingConfiguration(
	asgArn string,
	maxResults int32,
	nextToken string,
) ([]string, string, error)

ListServicesForAutoScalingConfiguration returns the ARNs of every live service currently associated with asgArn (which may be a full ARN, name-only ARN, or bare name -- see resolveASG).

func (*InMemoryBackend) ListTagsForResource 

func (b *InMemoryBackend) ListTagsForResource(resourceArn string) (map[string]string, error)

ListTagsForResource returns all tags for a resource.

func (*InMemoryBackend) ListVpcConnectors 

func (b *InMemoryBackend) ListVpcConnectors(maxResults int32, nextToken string) ([]*VpcConnector, string, error)

ListVpcConnectors returns VPC connectors with pagination.

func (*InMemoryBackend) ListVpcIngressConnections 

func (b *InMemoryBackend) ListVpcIngressConnections(
	serviceArnFilter, vpcEndpointIDFilter string,
	maxResults int32,
	nextToken string,
) ([]*VpcIngressConnectionSummary, string, error)

ListVpcIngressConnections returns VPC ingress connections with optional filters.

func (*InMemoryBackend) PauseService 

func (b *InMemoryBackend) PauseService(serviceArn string) (*Service, error)

PauseService pauses a running service.

func (*InMemoryBackend) Region 

func (b *InMemoryBackend) Region() string

Region returns the region.

func (*InMemoryBackend) Reset 

func (b *InMemoryBackend) Reset()

Reset clears all state.

func (*InMemoryBackend) Restore 

func (b *InMemoryBackend) Restore(ctx context.Context, data []byte) error

Restore deserializes state from JSON.

func (*InMemoryBackend) ResumeService 

func (b *InMemoryBackend) ResumeService(serviceArn string) (*Service, error)

ResumeService resumes a paused service.

func (*InMemoryBackend) Snapshot 

func (b *InMemoryBackend) Snapshot(ctx context.Context) []byte

Snapshot serializes current state to JSON.

func (*InMemoryBackend) StartDeployment 

func (b *InMemoryBackend) StartDeployment(serviceArn string) (string, error)

StartDeployment triggers a deployment for a service.

func (*InMemoryBackend) TagResource 

func (b *InMemoryBackend) TagResource(resourceArn string, tags map[string]string) error

TagResource adds or updates tags on a resource.

func (*InMemoryBackend) TaggedResources added in v1.3.1 

func (b *InMemoryBackend) TaggedResources() []TaggedEntry

TaggedResources returns every App Runner resource ARN that currently has at least one tag applied via TagResource.

func (*InMemoryBackend) UntagResource 

func (b *InMemoryBackend) UntagResource(resourceArn string, keys []string) error

UntagResource removes tags from a resource.

func (*InMemoryBackend) UpdateDefaultAutoScalingConfiguration 

func (b *InMemoryBackend) UpdateDefaultAutoScalingConfiguration(asgArn string) (*AutoScalingConfiguration, error)

UpdateDefaultAutoScalingConfiguration sets the default ASG config.

func (*InMemoryBackend) UpdateService 

func (b *InMemoryBackend) UpdateService(params UpdateServiceParams) (*Service, error)

UpdateService updates a service's configuration.

func (*InMemoryBackend) UpdateVpcIngressConnection 

func (b *InMemoryBackend) UpdateVpcIngressConnection(
	vicArn, vpcID, vpcEndpointID string,
) (*VpcIngressConnection, error)

UpdateVpcIngressConnection updates a VPC ingress connection's VPC config.

type InstanceConfig added in v1.2.0 

type InstanceConfig struct {
	CPU             string `json:"cpu"`
	Memory          string `json:"memory"`
	InstanceRoleArn string `json:"instanceRoleArn"`
}

InstanceConfig mirrors types.InstanceConfiguration: the runtime configuration of instances (scaling units) of a service. It's shared between CreateServiceParams/UpdateServiceParams (as input) and Service (as output) since the shape is identical either direction.

type NetworkConfig added in v1.2.0 

type NetworkConfig struct {
	EgressType            string `json:"egressType"`
	EgressVpcConnectorArn string `json:"egressVpcConnectorArn,omitempty"`
	IsPubliclyAccessible  *bool  `json:"isPubliclyAccessible,omitempty"`
	IPAddressType         string `json:"ipAddressType"`
}

NetworkConfig mirrors types.NetworkConfiguration. IsPubliclyAccessible is a pointer so CreateService/UpdateService can distinguish "not specified" (apply App Runner's default) from an explicit false; once a Service is constructed the backend guarantees the pointer is non-nil.

type ObservabilityConfiguration 

type ObservabilityConfiguration struct {
	CreatedAt                          time.Time
	DeletedAt                          time.Time
	ObservabilityConfigurationArn      string
	ObservabilityConfigurationName     string
	Status                             string
	TracingVendor                      string
	ObservabilityConfigurationRevision int32
	Latest                             bool
}

ObservabilityConfiguration represents an App Runner observability configuration. CreatedAt is first to reduce GC pointer bytes.

type ObservabilityConfigurationSummary 

type ObservabilityConfigurationSummary struct {
	CreatedAt                          time.Time
	ObservabilityConfigurationArn      string
	ObservabilityConfigurationName     string
	Status                             string
	ObservabilityConfigurationRevision int32
	Latest                             bool
}

ObservabilityConfigurationSummary is a summary entry for list responses.

type OperationSummary 

type OperationSummary struct {
	StartedAt time.Time
	EndedAt   time.Time
	UpdatedAt time.Time
	ID        string
	Type      string
	Status    string
	TargetArn string
}

OperationSummary is an operation entry in a list response. StartedAt is first so its non-pointer prefix (wall, ext) reduces GC pointer bytes.

type Provider 

type Provider struct{}

Provider implements service.Provider for the App Runner service.

func (*Provider) Init 

func (p *Provider) Init(ctx *service.AppContext) (service.Registerable, error)

Init initializes the App Runner backend and handler.

func (*Provider) Name 

func (p *Provider) Name() string

Name returns the logical name of the provider.

type Service 

type Service struct {
	Source                      SourceConfig
	CreatedAt                   time.Time
	UpdatedAt                   time.Time
	DeletedAt                   time.Time
	Network                     NetworkConfig
	Instance                    InstanceConfig
	Observability               ServiceObservability
	Status                      string
	ServiceURL                  string
	ServiceName                 string
	AutoScalingConfigurationArn string
	ServiceID                   string
	EncryptionKmsKey            string
	ServiceArn                  string
	HealthCheck                 HealthCheckConfig
}

Service represents an App Runner service with full details. CreatedAt is first so its non-pointer prefix (wall, ext) reduces GC pointer bytes.

type ServiceObservability added in v1.2.0 

type ServiceObservability struct {
	ConfigurationArn string `json:"configurationArn,omitempty"`
	Enabled          bool   `json:"enabled"`
}

ServiceObservability mirrors types.ServiceObservabilityConfiguration.

type ServiceSummary 

type ServiceSummary struct {
	CreatedAt   time.Time
	UpdatedAt   time.Time
	ServiceArn  string
	ServiceID   string
	ServiceName string
	ServiceURL  string
	Status      string
}

ServiceSummary is a service entry in a list response. CreatedAt is first so its non-pointer prefix (wall, ext) reduces GC pointer bytes.

type SourceConfig added in v1.2.0 

type SourceConfig struct {
	ImageRepository        *ImageSource `json:"imageRepository,omitempty"`
	CodeRepository         *CodeSource  `json:"codeRepository,omitempty"`
	AutoDeploymentsEnabled *bool        `json:"autoDeploymentsEnabled,omitempty"`
	AccessRoleArn          string       `json:"accessRoleArn,omitempty"`
	ConnectionArn          string       `json:"connectionArn,omitempty"`
}

SourceConfig mirrors types.SourceConfiguration: the source deployed to a service (exactly one of ImageRepository/CodeRepository) plus the sibling AuthenticationConfiguration/AutoDeploymentsEnabled fields.

type StorageBackend 

type StorageBackend interface {
	CreateService(params CreateServiceParams) (*Service, error)
	DescribeService(serviceArn string) (*Service, error)
	UpdateService(params UpdateServiceParams) (*Service, error)
	DeleteService(serviceArn string) (*Service, error)
	ListServices(maxResults int32, nextToken string) ([]*ServiceSummary, string, error)
	PauseService(serviceArn string) (*Service, error)
	ResumeService(serviceArn string) (*Service, error)
	ListOperations(serviceArn string, maxResults int32, nextToken string) ([]*OperationSummary, string, error)
	StartDeployment(serviceArn string) (string, error)

	CreateAutoScalingConfiguration(
		name string,
		maxConcurrency, maxSize, minSize int32,
		tags map[string]string,
	) (*AutoScalingConfiguration, error)
	DescribeAutoScalingConfiguration(arn string) (*AutoScalingConfiguration, error)
	DeleteAutoScalingConfiguration(arn string) (*AutoScalingConfiguration, error)
	ListAutoScalingConfigurations(
		nameFilter string,
		latestOnly bool,
		maxResults int32,
		nextToken string,
	) ([]*AutoScalingConfigurationSummary, string, error)
	UpdateDefaultAutoScalingConfiguration(arn string) (*AutoScalingConfiguration, error)
	ListServicesForAutoScalingConfiguration(arn string, maxResults int32, nextToken string) ([]string, string, error)

	CreateConnection(name, providerType string, tags map[string]string) (*Connection, error)
	DeleteConnection(arn string) (*Connection, error)
	ListConnections(nameFilter string, maxResults int32, nextToken string) ([]*ConnectionSummary, string, error)

	CreateObservabilityConfiguration(
		name, tracingVendor string,
		tags map[string]string,
	) (*ObservabilityConfiguration, error)
	DescribeObservabilityConfiguration(arn string) (*ObservabilityConfiguration, error)
	DeleteObservabilityConfiguration(arn string) (*ObservabilityConfiguration, error)
	ListObservabilityConfigurations(
		nameFilter string,
		latestOnly bool,
		maxResults int32,
		nextToken string,
	) ([]*ObservabilityConfigurationSummary, string, error)

	CreateVpcConnector(name string, subnets, securityGroups []string, tags map[string]string) (*VpcConnector, error)
	DescribeVpcConnector(arn string) (*VpcConnector, error)
	DeleteVpcConnector(arn string) (*VpcConnector, error)
	ListVpcConnectors(maxResults int32, nextToken string) ([]*VpcConnector, string, error)

	CreateVpcIngressConnection(
		name, serviceArn, vpcID, vpcEndpointID string,
		tags map[string]string,
	) (*VpcIngressConnection, error)
	DescribeVpcIngressConnection(arn string) (*VpcIngressConnection, error)
	DeleteVpcIngressConnection(arn string) (*VpcIngressConnection, error)
	ListVpcIngressConnections(
		serviceArnFilter, vpcEndpointIDFilter string,
		maxResults int32,
		nextToken string,
	) ([]*VpcIngressConnectionSummary, string, error)
	UpdateVpcIngressConnection(arn, vpcID, vpcEndpointID string) (*VpcIngressConnection, error)

	AssociateCustomDomain(serviceArn, domainName string, enableWWW bool) (*CustomDomain, error)
	DisassociateCustomDomain(serviceArn, domainName string) (*CustomDomain, error)
	DescribeCustomDomains(
		serviceArn string,
		maxResults int32,
		nextToken string,
	) ([]*CustomDomain, string, string, error)

	TagResource(resourceArn string, tags map[string]string) error
	UntagResource(resourceArn string, keys []string) error
	ListTagsForResource(resourceArn string) (map[string]string, error)

	AccountID() string
	Region() string
	Reset()
	Snapshot(ctx context.Context) []byte
	Restore(ctx context.Context, data []byte) error
}

StorageBackend is the interface for App Runner storage operations.

type TaggedEntry added in v1.3.1 

type TaggedEntry struct {
	Tags map[string]string
	ARN  string
}

TaggedEntry pairs a resource ARN with its tags.

type UpdateServiceParams added in v1.2.0 

type UpdateServiceParams struct {
	Instance                    *InstanceConfig
	Source                      *SourceConfig
	Network                     *NetworkConfig
	HealthCheck                 *HealthCheckConfig
	Observability               *ServiceObservability
	ServiceArn                  string
	AutoScalingConfigurationArn string
}

UpdateServiceParams groups UpdateService's backend inputs. A nil field (or a nil Source.ImageRepository/CodeRepository) means "leave unchanged", matching UpdateServiceInput's optional members.

type VpcConnector 

type VpcConnector struct {
	CreatedAt            time.Time
	DeletedAt            time.Time
	VpcConnectorArn      string
	VpcConnectorName     string
	Status               string
	SecurityGroups       []string
	Subnets              []string
	VpcConnectorRevision int32
}

VpcConnector represents an App Runner VPC connector resource. CreatedAt is first to reduce GC pointer bytes.

type VpcIngressConnection 

type VpcIngressConnection struct {
	CreatedAt                time.Time
	DeletedAt                time.Time
	VpcIngressConnectionArn  string
	VpcIngressConnectionName string
	ServiceArn               string
	AccountID                string
	DomainName               string
	VpcID                    string
	VpcEndpointID            string
	Status                   string
}

VpcIngressConnection represents an App Runner VPC ingress connection resource. CreatedAt is first to reduce GC pointer bytes.

type VpcIngressConnectionSummary 

type VpcIngressConnectionSummary struct {
	VpcIngressConnectionArn string
	ServiceArn              string
}

VpcIngressConnectionSummary is a summary entry for list responses.

Source Files

View all Source files

Jump to

Keyboard shortcuts

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