String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want to associate a custom domain name with.
String domainName
A custom domain endpoint to associate. Specify a root domain (for example, example.com), a subdomain
(for example, login.example.com or admin.login.example.com), or a wildcard (for
example, *.example.com).
Boolean enableWWWSubdomain
Set to true to associate the subdomain www.DomainName with the App Runner
service in addition to the base domain.
Default: true
String dNSTarget
The App Runner subdomain of the App Runner service. The custom domain name is mapped to this target name.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service with which a custom domain name is associated.
CustomDomain customDomain
A description of the domain name that's being associated.
List<E> vpcDNSTargets
DNS Target records for the custom domains of this Amazon VPC.
String connectionArn
The Amazon Resource Name (ARN) of the App Runner connection that enables the App Runner service to connect to a source repository. It's required for GitHub code repositories.
String accessRoleArn
The Amazon Resource Name (ARN) of the IAM role that grants the App Runner service access to a source repository. It's required for ECR image repositories (but not for ECR Public repositories).
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of this auto scaling configuration.
String autoScalingConfigurationName
The customer-provided auto scaling configuration name. It can be used in multiple revisions of a configuration.
Integer autoScalingConfigurationRevision
The revision of this auto scaling configuration. It's unique among all the active configurations (
"Status": "ACTIVE") that share the same AutoScalingConfigurationName.
Boolean latest
It's set to true for the configuration with the highest Revision among all
configurations that share the same AutoScalingConfigurationName. It's set to false
otherwise.
String status
The current state of the auto scaling configuration. If the status of a configuration revision is
INACTIVE, it was deleted and can't be used. Inactive configuration revisions are permanently removed
some time after they are deleted.
Integer maxConcurrency
The maximum number of concurrent requests that an instance processes. If the number of concurrent requests exceeds this limit, App Runner scales the service up.
Integer minSize
The minimum number of instances that App Runner provisions for a service. The service always has at least
MinSize provisioned instances. Some of them actively serve traffic. The rest of them (provisioned
and inactive instances) are a cost-effective compute capacity reserve and are ready to be quickly activated. You
pay for memory usage of all the provisioned instances. You pay for CPU usage of only the active subset.
App Runner temporarily doubles the number of provisioned instances during deployments, to maintain the same capacity for both old and new code.
Integer maxSize
The maximum number of instances that a service scales up to. At most MaxSize instances actively
serve traffic for your service.
Date createdAt
The time when the auto scaling configuration was created. It's in Unix time stamp format.
Date deletedAt
The time when the auto scaling configuration was deleted. It's in Unix time stamp format.
Boolean hasAssociatedService
Indicates if this auto scaling configuration has an App Runner service associated with it. A value of
true indicates one or more services are associated. A value of false indicates no
services are associated.
Boolean isDefault
Indicates if this auto scaling configuration should be used as the default for a new App Runner service that does
not have an auto scaling configuration ARN specified during creation. Each account can have only one default
AutoScalingConfiguration per region. The default AutoScalingConfiguration can be any
revision under the same AutoScalingConfigurationName.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of this auto scaling configuration.
String autoScalingConfigurationName
The customer-provided auto scaling configuration name. It can be used in multiple revisions of a configuration.
Integer autoScalingConfigurationRevision
The revision of this auto scaling configuration. It's unique among all the active configurations (
"Status": "ACTIVE") with the same AutoScalingConfigurationName.
String status
The current state of the auto scaling configuration. If the status of a configuration revision is
INACTIVE, it was deleted and can't be used. Inactive configuration revisions are permanently removed
some time after they are deleted.
Date createdAt
The time when the auto scaling configuration was created. It's in Unix time stamp format.
Boolean hasAssociatedService
Indicates if this auto scaling configuration has an App Runner service associated with it. A value of
true indicates one or more services are associated. A value of false indicates no
services are associated.
Boolean isDefault
Indicates if this auto scaling configuration should be used as the default for a new App Runner service that does
not have an auto scaling configuration ARN specified during creation. Each account can have only one default
AutoScalingConfiguration per region. The default AutoScalingConfiguration can be any
revision under the same AutoScalingConfigurationName.
String name
The certificate CNAME record name.
String type
The record type, always CNAME.
String value
The certificate CNAME record value.
String status
The current state of the certificate CNAME record validation. It should change to SUCCESS after App
Runner completes validation with your DNS.
String configurationSource
The source of the App Runner configuration. Values are interpreted as follows:
REPOSITORY – App Runner reads configuration values from the apprunner.yaml file in the
source code repository and ignores CodeConfigurationValues.
API – App Runner uses configuration values provided in CodeConfigurationValues and
ignores the apprunner.yaml file in the source code repository.
CodeConfigurationValues codeConfigurationValues
The basic configuration for building and running the App Runner service. Use it to quickly launch an App Runner
service without providing a apprunner.yaml file in the source code repository (or ignoring the file
if it exists).
String runtime
A runtime environment type for building and running an App Runner service. It represents a programming language runtime.
String buildCommand
The command App Runner runs to build your application.
String startCommand
The command App Runner runs to start your application.
String port
The port that your application listens to in the container.
Default: 8080
Map<K,V> runtimeEnvironmentVariables
The environment variables that are available to your running App Runner service. An array of key-value pairs.
Map<K,V> runtimeEnvironmentSecrets
An array of key-value pairs representing the secrets and parameters that get referenced to your service as an environment variable. The supported values are either the full Amazon Resource Name (ARN) of the Secrets Manager secret or the full ARN of the parameter in the Amazon Web Services Systems Manager Parameter Store.
If the Amazon Web Services Systems Manager Parameter Store parameter exists in the same Amazon Web Services Region as the service that you're launching, you can use either the full ARN or name of the secret. If the parameter exists in a different Region, then the full ARN must be specified.
Currently, cross account referencing of Amazon Web Services Systems Manager Parameter Store parameter is not supported.
String repositoryUrl
The location of the repository that contains the source code.
SourceCodeVersion sourceCodeVersion
The version that should be used within the source code repository.
CodeConfiguration codeConfiguration
Configuration for building and running the service from a source code repository.
CodeConfiguration is required only for CreateService request.
String sourceDirectory
The path of the directory that stores source code and configuration files. The build and start commands also execute from here. The path is absolute from root and, if not specified, defaults to the repository root.
String connectionName
The customer-provided connection name.
String connectionArn
The Amazon Resource Name (ARN) of this connection.
String providerType
The source repository provider.
String status
The current state of the App Runner connection. When the state is AVAILABLE, you can use the
connection to create an App Runner service.
Date createdAt
The App Runner connection creation time, expressed as a Unix time stamp.
String connectionName
The customer-provided connection name.
String connectionArn
The Amazon Resource Name (ARN) of this connection.
String providerType
The source repository provider.
String status
The current state of the App Runner connection. When the state is AVAILABLE, you can use the
connection to create an App Runner service.
Date createdAt
The App Runner connection creation time, expressed as a Unix time stamp.
String autoScalingConfigurationName
A name for the auto scaling configuration. When you use it for the first time in an Amazon Web Services Region,
App Runner creates revision number 1 of this name. When you use the same name in subsequent calls,
App Runner creates incremental revisions of the configuration.
Prior to the release of Auto scale
configuration enhancements, the name DefaultConfiguration was reserved.
This restriction is no longer in place. You can now manage DefaultConfiguration the same way you
manage your custom auto scaling configurations. This means you can do the following with the
DefaultConfiguration that App Runner provides:
Create new revisions of the DefaultConfiguration.
Delete the revisions of the DefaultConfiguration.
Delete the auto scaling configuration for which the App Runner DefaultConfiguration was created.
If you delete the auto scaling configuration you can create another custom auto scaling configuration with the
same DefaultConfiguration name. The original DefaultConfiguration resource provided by
App Runner remains in your account unless you make changes to it.
Integer maxConcurrency
The maximum number of concurrent requests that you want an instance to process. If the number of concurrent requests exceeds this limit, App Runner scales up your service.
Default: 100
Integer minSize
The minimum number of instances that App Runner provisions for your service. The service always has at least
MinSize provisioned instances. Some of them actively serve traffic. The rest of them (provisioned
and inactive instances) are a cost-effective compute capacity reserve and are ready to be quickly activated. You
pay for memory usage of all the provisioned instances. You pay for CPU usage of only the active subset.
App Runner temporarily doubles the number of provisioned instances during deployments, to maintain the same capacity for both old and new code.
Default: 1
Integer maxSize
The maximum number of instances that your service scales up to. At most MaxSize instances actively
serve traffic for your service.
Default: 25
List<E> tags
A list of metadata items that you can associate with your auto scaling configuration resource. A tag is a key-value pair.
AutoScalingConfiguration autoScalingConfiguration
A description of the App Runner auto scaling configuration that's created by this request.
String connectionName
A name for the new connection. It must be unique across all App Runner connections for the Amazon Web Services account in the Amazon Web Services Region.
String providerType
The source repository provider.
List<E> tags
A list of metadata items that you can associate with your connection resource. A tag is a key-value pair.
Connection connection
A description of the App Runner connection that's created by this request.
String observabilityConfigurationName
A name for the observability configuration. When you use it for the first time in an Amazon Web Services Region,
App Runner creates revision number 1 of this name. When you use the same name in subsequent calls,
App Runner creates incremental revisions of the configuration.
The name DefaultConfiguration is reserved. You can't use it to create a new observability
configuration, and you can't create a revision of it.
When you want to use your own observability configuration for your App Runner service, create a configuration with a different name, and then provide it when you create or update your service.
TraceConfiguration traceConfiguration
The configuration of the tracing feature within this observability configuration. If you don't specify it, App Runner doesn't enable tracing.
List<E> tags
A list of metadata items that you can associate with your observability configuration resource. A tag is a key-value pair.
ObservabilityConfiguration observabilityConfiguration
A description of the App Runner observability configuration that's created by this request.
String serviceName
A name for the App Runner service. It must be unique across all the running App Runner services in your Amazon Web Services account in the Amazon Web Services Region.
SourceConfiguration sourceConfiguration
The source to deploy to the App Runner service. It can be a code or an image repository.
InstanceConfiguration instanceConfiguration
The runtime configuration of instances (scaling units) of your service.
List<E> tags
An optional list of metadata items that you can associate with the App Runner service resource. A tag is a key-value pair.
EncryptionConfiguration encryptionConfiguration
An optional custom encryption key that App Runner uses to encrypt the copy of your source repository that it maintains and your service logs. By default, App Runner uses an Amazon Web Services managed key.
HealthCheckConfiguration healthCheckConfiguration
The settings for the health check that App Runner performs to monitor the health of the App Runner service.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of an App Runner automatic scaling configuration resource that you want to associate with your service. If not provided, App Runner associates the latest revision of a default auto scaling configuration.
Specify an ARN with a name and a revision number to associate that revision. For example:
arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/3
Specify just the name to associate the latest revision. For example:
arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability
NetworkConfiguration networkConfiguration
Configuration settings related to network traffic of the web application that the App Runner service runs.
ServiceObservabilityConfiguration observabilityConfiguration
The observability configuration of your service.
Service service
A description of the App Runner service that's created by this request.
String operationId
The unique ID of the asynchronous operation that this request started. You can use it combined with the ListOperations call to track the operation's progress.
String vpcConnectorName
A name for the VPC connector.
List<E> subnets
A list of IDs of subnets that App Runner should use when it associates your service with a custom Amazon VPC. Specify IDs of subnets of a single Amazon VPC. App Runner determines the Amazon VPC from the subnets you specify.
App Runner currently only provides support for IPv4.
List<E> securityGroups
A list of IDs of security groups that App Runner should use for access to Amazon Web Services resources under the specified subnets. If not specified, App Runner uses the default security group of the Amazon VPC. The default security group allows all outbound traffic.
List<E> tags
A list of metadata items that you can associate with your VPC connector resource. A tag is a key-value pair.
VpcConnector vpcConnector
A description of the App Runner VPC connector that's created by this request.
String serviceArn
The Amazon Resource Name (ARN) for this App Runner service that is used to create the VPC Ingress Connection resource.
String vpcIngressConnectionName
A name for the VPC Ingress Connection resource. It must be unique across all the active VPC Ingress Connections in your Amazon Web Services account in the Amazon Web Services Region.
IngressVpcConfiguration ingressVpcConfiguration
Specifications for the customer’s Amazon VPC and the related Amazon Web Services PrivateLink VPC endpoint that are used to create the VPC Ingress Connection resource.
List<E> tags
An optional list of metadata items that you can associate with the VPC Ingress Connection resource. A tag is a key-value pair.
VpcIngressConnection vpcIngressConnection
A description of the App Runner VPC Ingress Connection resource that's created by this request.
String domainName
An associated custom domain endpoint. It can be a root domain (for example, example.com), a
subdomain (for example, login.example.com or admin.login.example.com), or a wildcard
(for example, *.example.com).
Boolean enableWWWSubdomain
When true, the subdomain www.DomainName is associated with the App Runner
service in addition to the base domain.
List<E> certificateValidationRecords
A list of certificate CNAME records that's used for this domain name.
String status
The current state of the domain name association.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of the App Runner auto scaling configuration that you want to delete.
The ARN can be a full auto scaling configuration ARN, or a partial ARN ending with either
.../name or .../name/revision . If a revision isn't specified,
the latest active revision is deleted.
Boolean deleteAllRevisions
Set to true to delete all of the revisions associated with the
AutoScalingConfigurationArn parameter value.
When DeleteAllRevisions is set to true, the only valid value for the Amazon Resource
Name (ARN) is a partial ARN ending with: .../name.
AutoScalingConfiguration autoScalingConfiguration
A description of the App Runner auto scaling configuration that this request just deleted.
String connectionArn
The Amazon Resource Name (ARN) of the App Runner connection that you want to delete.
Connection connection
A description of the App Runner connection that this request just deleted.
String observabilityConfigurationArn
The Amazon Resource Name (ARN) of the App Runner observability configuration that you want to delete.
The ARN can be a full observability configuration ARN, or a partial ARN ending with either
.../name or .../name/revision . If a revision isn't specified,
the latest active revision is deleted.
ObservabilityConfiguration observabilityConfiguration
A description of the App Runner observability configuration that this request just deleted.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want to delete.
Service service
A description of the App Runner service that this request just deleted.
String operationId
The unique ID of the asynchronous operation that this request started. You can use it combined with the ListOperations call to track the operation's progress.
String vpcConnectorArn
The Amazon Resource Name (ARN) of the App Runner VPC connector that you want to delete.
The ARN must be a full VPC connector ARN.
VpcConnector vpcConnector
A description of the App Runner VPC connector that this request just deleted.
String vpcIngressConnectionArn
The Amazon Resource Name (ARN) of the App Runner VPC Ingress Connection that you want to delete.
VpcIngressConnection vpcIngressConnection
A description of the App Runner VPC Ingress Connection that this request just deleted.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of the App Runner auto scaling configuration that you want a description for.
The ARN can be a full auto scaling configuration ARN, or a partial ARN ending with either
.../name or .../name/revision . If a revision isn't specified,
the latest active revision is described.
AutoScalingConfiguration autoScalingConfiguration
A full description of the App Runner auto scaling configuration that you specified in this request.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want associated custom domain names to be described for.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones that are specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
Integer maxResults
The maximum number of results that each response (result page) can include. It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String dNSTarget
The App Runner subdomain of the App Runner service. The associated custom domain names are mapped to this target name.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service whose associated custom domain names you want to describe.
List<E> customDomains
A list of descriptions of custom domain names that are associated with the service. In a paginated request, the
request returns up to MaxResults records per call.
List<E> vpcDNSTargets
DNS Target records for the custom domains of this Amazon VPC.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
String observabilityConfigurationArn
The Amazon Resource Name (ARN) of the App Runner observability configuration that you want a description for.
The ARN can be a full observability configuration ARN, or a partial ARN ending with either
.../name or .../name/revision . If a revision isn't specified,
the latest active revision is described.
ObservabilityConfiguration observabilityConfiguration
A full description of the App Runner observability configuration that you specified in this request.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want a description for.
Service service
A full description of the App Runner service that you specified in this request.
String vpcConnectorArn
The Amazon Resource Name (ARN) of the App Runner VPC connector that you want a description for.
The ARN must be a full VPC connector ARN.
VpcConnector vpcConnector
A description of the App Runner VPC connector that you specified in this request.
String vpcIngressConnectionArn
The Amazon Resource Name (ARN) of the App Runner VPC Ingress Connection that you want a description for.
VpcIngressConnection vpcIngressConnection
A description of the App Runner VPC Ingress Connection that you specified in this request.
String dNSTarget
The App Runner subdomain of the App Runner service. The disassociated custom domain name was mapped to this target name.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that a custom domain name is disassociated from.
CustomDomain customDomain
A description of the domain name that's being disassociated.
List<E> vpcDNSTargets
DNS Target records for the custom domains of this Amazon VPC.
String egressType
The type of egress configuration.
Set to DEFAULT for access to resources hosted on public networks.
Set to VPC to associate your service to a custom VPC specified by VpcConnectorArn.
String vpcConnectorArn
The Amazon Resource Name (ARN) of the App Runner VPC connector that you want to associate with your App Runner
service. Only valid when EgressType = VPC.
String kmsKey
The ARN of the KMS key that's used for encryption.
String protocol
The IP protocol that App Runner uses to perform health checks for your service.
If you set Protocol to HTTP, App Runner sends health check requests to the HTTP path
specified by Path.
Default: TCP
String path
The URL that health check requests are sent to.
Path is only applicable when you set Protocol to HTTP.
Default: "/"
Integer interval
The time interval, in seconds, between health checks.
Default: 5
Integer timeout
The time, in seconds, to wait for a health check response before deciding it failed.
Default: 2
Integer healthyThreshold
The number of consecutive checks that must succeed before App Runner decides that the service is healthy.
Default: 1
Integer unhealthyThreshold
The number of consecutive checks that must fail before App Runner decides that the service is unhealthy.
Default: 5
Map<K,V> runtimeEnvironmentVariables
Environment variables that are available to your running App Runner service. An array of key-value pairs.
String startCommand
An optional command that App Runner runs to start the application in the source image. If specified, this command overrides the Docker image’s default start command.
String port
The port that your application listens to in the container.
Default: 8080
Map<K,V> runtimeEnvironmentSecrets
An array of key-value pairs representing the secrets and parameters that get referenced to your service as an environment variable. The supported values are either the full Amazon Resource Name (ARN) of the Secrets Manager secret or the full ARN of the parameter in the Amazon Web Services Systems Manager Parameter Store.
If the Amazon Web Services Systems Manager Parameter Store parameter exists in the same Amazon Web Services Region as the service that you're launching, you can use either the full ARN or name of the secret. If the parameter exists in a different Region, then the full ARN must be specified.
Currently, cross account referencing of Amazon Web Services Systems Manager Parameter Store parameter is not supported.
String imageIdentifier
The identifier of an image.
For an image in Amazon Elastic Container Registry (Amazon ECR), this is an image name. For the image name format, see Pulling an image in the Amazon ECR User Guide.
ImageConfiguration imageConfiguration
Configuration for running the identified image.
String imageRepositoryType
The type of the image repository. This reflects the repository provider and whether the repository is private or public.
Boolean isPubliclyAccessible
Specifies whether your App Runner service is publicly accessible. To make the service publicly accessible set it
to True. To make the service privately accessible, from only within an Amazon VPC set it to
False.
String cpu
The number of CPU units reserved for each instance of your App Runner service.
Default: 1 vCPU
String memory
The amount of memory, in MB or GB, reserved for each instance of your App Runner service.
Default: 2 GB
String instanceRoleArn
The Amazon Resource Name (ARN) of an IAM role that provides permissions to your App Runner service. These are permissions that your code needs when it calls any Amazon Web Services APIs.
String autoScalingConfigurationName
The name of the App Runner auto scaling configuration that you want to list. If specified, App Runner lists revisions that share this name. If not specified, App Runner returns revisions of all active configurations.
Boolean latestOnly
Set to true to list only the latest revision for each requested configuration name.
Set to false to list all revisions for each requested configuration name.
Default: true
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones that are specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
List<E> autoScalingConfigurationSummaryList
A list of summary information records for auto scaling configurations. In a paginated request, the request
returns up to MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
String connectionName
If specified, only this connection is returned. If not specified, the result isn't filtered by name.
Integer maxResults
The maximum number of results to include in each response (result page). Used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String nextToken
A token from a previous result page. Used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
List<E> connectionSummaryList
A list of summary information records for connections. In a paginated request, the request returns up to
MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. Returned in a paginated request.
String observabilityConfigurationName
The name of the App Runner observability configuration that you want to list. If specified, App Runner lists revisions that share this name. If not specified, App Runner returns revisions of all active configurations.
Boolean latestOnly
Set to true to list only the latest revision for each requested configuration name.
Set to false to list all revisions for each requested configuration name.
Default: true
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones that are specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
List<E> observabilityConfigurationSummaryList
A list of summary information records for observability configurations. In a paginated request, the request
returns up to MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want a list of operations for.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
List<E> operationSummaryList
A list of operation summary information records. In a paginated request, the request returns up to
MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of the App Runner auto scaling configuration that you want to list the services for.
The ARN can be a full auto scaling configuration ARN, or a partial ARN ending with either
.../name or .../name/revision . If a revision isn't specified,
the latest active revision is used.
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
String nextToken
A token from a previous result page. Used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
List<E> serviceSummaryList
A list of service summary information records. In a paginated request, the request returns up to
MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
String resourceArn
The Amazon Resource Name (ARN) of the resource that a tag list is requested for.
It must be the ARN of an App Runner resource.
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones that are specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
List<E> vpcConnectors
A list of information records for VPC connectors. In a paginated request, the request returns up to
MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
ListVpcIngressConnectionsFilter filter
The VPC Ingress Connections to be listed based on either the Service Arn or Vpc Endpoint Id, or both.
Integer maxResults
The maximum number of results to include in each response (result page). It's used for a paginated request.
If you don't specify MaxResults, the request retrieves all available results in a single response.
String nextToken
A token from a previous result page. It's used for a paginated request. The request retrieves the next result page. All other parameter values must be identical to the ones that are specified in the initial request.
If you don't specify NextToken, the request retrieves the first result page.
List<E> vpcIngressConnectionSummaryList
A list of summary information records for VPC Ingress Connections. In a paginated request, the request returns up
to MaxResults records for each call.
String nextToken
The token that you can pass in a subsequent request to get the next result page. It's returned in a paginated request.
EgressConfiguration egressConfiguration
Network configuration settings for outbound message traffic.
IngressConfiguration ingressConfiguration
Network configuration settings for inbound message traffic.
String ipAddressType
App Runner provides you with the option to choose between Internet Protocol version 4 (IPv4) and dual
stack (IPv4 and IPv6) for your incoming public network configuration. This is an optional parameter. If you
do not specify an IpAddressType, it defaults to select IPv4.
Currently, App Runner supports dual stack for only Public endpoint. Only IPv4 is supported for Private endpoint. If you update a service that's using dual-stack Public endpoint to a Private endpoint, your App Runner service will default to support only IPv4 for Private endpoint and fail to receive traffic originating from IPv6 endpoint.
String observabilityConfigurationArn
The Amazon Resource Name (ARN) of this observability configuration.
String observabilityConfigurationName
The customer-provided observability configuration name. It can be used in multiple revisions of a configuration.
TraceConfiguration traceConfiguration
The configuration of the tracing feature within this observability configuration. If not specified, tracing isn't enabled.
Integer observabilityConfigurationRevision
The revision of this observability configuration. It's unique among all the active configurations (
"Status": "ACTIVE") that share the same ObservabilityConfigurationName.
Boolean latest
It's set to true for the configuration with the highest Revision among all
configurations that share the same ObservabilityConfigurationName. It's set to false
otherwise.
String status
The current state of the observability configuration. If the status of a configuration revision is
INACTIVE, it was deleted and can't be used. Inactive configuration revisions are permanently removed
some time after they are deleted.
Date createdAt
The time when the observability configuration was created. It's in Unix time stamp format.
Date deletedAt
The time when the observability configuration was deleted. It's in Unix time stamp format.
String observabilityConfigurationArn
The Amazon Resource Name (ARN) of this observability configuration.
String observabilityConfigurationName
The customer-provided observability configuration name. It can be used in multiple revisions of a configuration.
Integer observabilityConfigurationRevision
The revision of this observability configuration. It's unique among all the active configurations (
"Status": "ACTIVE") that share the same ObservabilityConfigurationName.
String id
A unique ID of this operation. It's unique in the scope of the App Runner service.
String type
The type of operation. It indicates a specific action that occured.
String status
The current state of the operation.
String targetArn
The Amazon Resource Name (ARN) of the resource that the operation acted on (for example, an App Runner service).
Date startedAt
The time when the operation started. It's in the Unix time stamp format.
Date endedAt
The time when the operation ended. It's in the Unix time stamp format.
Date updatedAt
The time when the operation was last updated. It's in the Unix time stamp format.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want to pause.
Service service
A description of the App Runner service that this request just paused.
String operationId
The unique ID of the asynchronous operation that this request started. You can use it combined with the ListOperations call to track the operation's progress.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want to resume.
Service service
A description of the App Runner service that this request just resumed.
String operationId
The unique ID of the asynchronous operation that this request started. You can use it combined with the ListOperations call to track the operation's progress.
String serviceName
The customer-provided service name.
String serviceId
An ID that App Runner generated for this service. It's unique within the Amazon Web Services Region.
String serviceArn
The Amazon Resource Name (ARN) of this service.
String serviceUrl
A subdomain URL that App Runner generated for this service. You can use this URL to access your service web application.
Date createdAt
The time when the App Runner service was created. It's in the Unix time stamp format.
Date updatedAt
The time when the App Runner service was last updated at. It's in the Unix time stamp format.
Date deletedAt
The time when the App Runner service was deleted. It's in the Unix time stamp format.
String status
The current state of the App Runner service. These particular values mean the following.
CREATE_FAILED – The service failed to create. The failed service isn't usable, and still counts
towards your service quota. To troubleshoot this failure, read the failure events and logs, change any parameters
that need to be fixed, and rebuild your service using UpdateService.
DELETE_FAILED – The service failed to delete and can't be successfully recovered. Retry the service
deletion call to ensure that all related resources are removed.
SourceConfiguration sourceConfiguration
The source deployed to the App Runner service. It can be a code or an image repository.
InstanceConfiguration instanceConfiguration
The runtime configuration of instances (scaling units) of this service.
EncryptionConfiguration encryptionConfiguration
The encryption key that App Runner uses to encrypt the service logs and the copy of the source repository that App Runner maintains for the service. It can be either a customer-provided encryption key or an Amazon Web Services managed key.
HealthCheckConfiguration healthCheckConfiguration
The settings for the health check that App Runner performs to monitor the health of this service.
AutoScalingConfigurationSummary autoScalingConfigurationSummary
Summary information for the App Runner automatic scaling configuration resource that's associated with this service.
NetworkConfiguration networkConfiguration
Configuration settings related to network traffic of the web application that this service runs.
ServiceObservabilityConfiguration observabilityConfiguration
The observability configuration of this service.
Boolean observabilityEnabled
When true, an observability configuration resource is associated with the service, and an
ObservabilityConfigurationArn is specified.
String observabilityConfigurationArn
The Amazon Resource Name (ARN) of the observability configuration that is associated with the service. Specified
only when ObservabilityEnabled is true.
Specify an ARN with a name and a revision number to associate that revision. For example:
arn:aws:apprunner:us-east-1:123456789012:observabilityconfiguration/xray-tracing/3
Specify just the name to associate the latest revision. For example:
arn:aws:apprunner:us-east-1:123456789012:observabilityconfiguration/xray-tracing
String serviceName
The customer-provided service name.
String serviceId
An ID that App Runner generated for this service. It's unique within the Amazon Web Services Region.
String serviceArn
The Amazon Resource Name (ARN) of this service.
String serviceUrl
A subdomain URL that App Runner generated for this service. You can use this URL to access your service web application.
Date createdAt
The time when the App Runner service was created. It's in the Unix time stamp format.
Date updatedAt
The time when the App Runner service was last updated. It's in theUnix time stamp format.
String status
The current state of the App Runner service. These particular values mean the following.
CREATE_FAILED – The service failed to create. The failed service isn't usable, and still counts
towards your service quota. To troubleshoot this failure, read the failure events and logs, change any parameters
that need to be fixed, and rebuild your service using UpdateService.
DELETE_FAILED – The service failed to delete and can't be successfully recovered. Retry the service
deletion call to ensure that all related resources are removed.
CodeRepository codeRepository
The description of a source code repository.
You must provide either this member or ImageRepository (but not both).
ImageRepository imageRepository
The description of a source image repository.
You must provide either this member or CodeRepository (but not both).
Boolean autoDeploymentsEnabled
If true, continuous integration from the source repository is enabled for the App Runner service.
Each repository change (including any source code commit or new image version) starts a deployment.
Default: App Runner sets to false for a source image that uses an ECR Public repository or an ECR
repository that's in an Amazon Web Services account other than the one that the service is in. App Runner sets to
true in all other cases (which currently include a source code repository or a source image using a
same-account ECR repository).
AuthenticationConfiguration authenticationConfiguration
Describes the resources that are needed to authenticate access to some source repositories.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want to manually deploy to.
String operationId
The unique ID of the asynchronous operation that this request started. You can use it combined with the ListOperations call to track the operation's progress.
String resourceArn
The Amazon Resource Name (ARN) of the resource that you want to update tags for.
It must be the ARN of an App Runner resource.
List<E> tags
A list of tag key-value pairs to add or update. If a key is new to the resource, the tag is added with the provided value. If a key is already associated with the resource, the value of the tag is updated.
String vendor
The implementation provider chosen for tracing App Runner services.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of the App Runner auto scaling configuration that you want to set as the default.
The ARN can be a full auto scaling configuration ARN, or a partial ARN ending with either
.../name or .../name/revision . If a revision isn't specified,
the latest active revision is set as the default.
AutoScalingConfiguration autoScalingConfiguration
A description of the App Runner auto scaling configuration that was set as default.
String serviceArn
The Amazon Resource Name (ARN) of the App Runner service that you want to update.
SourceConfiguration sourceConfiguration
The source configuration to apply to the App Runner service.
You can change the configuration of the code or image repository that the service uses. However, you can't switch
from code to image or the other way around. This means that you must provide the same structure member of
SourceConfiguration that you originally included when you created the service. Specifically, you can
include either CodeRepository or ImageRepository. To update the source configuration,
set the values to members of the structure that you include.
InstanceConfiguration instanceConfiguration
The runtime configuration to apply to instances (scaling units) of your service.
String autoScalingConfigurationArn
The Amazon Resource Name (ARN) of an App Runner automatic scaling configuration resource that you want to associate with the App Runner service.
HealthCheckConfiguration healthCheckConfiguration
The settings for the health check that App Runner performs to monitor the health of the App Runner service.
NetworkConfiguration networkConfiguration
Configuration settings related to network traffic of the web application that the App Runner service runs.
ServiceObservabilityConfiguration observabilityConfiguration
The observability configuration of your service.
Service service
A description of the App Runner service updated by this request. All configuration values in the returned
Service structure reflect configuration changes that are being applied by this request.
String operationId
The unique ID of the asynchronous operation that this request started. You can use it combined with the ListOperations call to track the operation's progress.
String vpcIngressConnectionArn
The Amazon Resource Name (Arn) for the App Runner VPC Ingress Connection resource that you want to update.
IngressVpcConfiguration ingressVpcConfiguration
Specifications for the customer’s Amazon VPC and the related Amazon Web Services PrivateLink VPC endpoint that are used to update the VPC Ingress Connection resource.
VpcIngressConnection vpcIngressConnection
A description of the App Runner VPC Ingress Connection resource that's updated by this request.
String vpcConnectorName
The customer-provided VPC connector name.
String vpcConnectorArn
The Amazon Resource Name (ARN) of this VPC connector.
Integer vpcConnectorRevision
The revision of this VPC connector. It's unique among all the active connectors ("Status": "ACTIVE")
that share the same Name.
At this time, App Runner supports only one revision per name.
List<E> subnets
A list of IDs of subnets that App Runner uses for your service. All IDs are of subnets of a single Amazon VPC.
List<E> securityGroups
A list of IDs of security groups that App Runner uses for access to Amazon Web Services resources under the specified subnets. If not specified, App Runner uses the default security group of the Amazon VPC. The default security group allows all outbound traffic.
String status
The current state of the VPC connector. If the status of a connector revision is INACTIVE, it was
deleted and can't be used. Inactive connector revisions are permanently removed some time after they are deleted.
Date createdAt
The time when the VPC connector was created. It's in Unix time stamp format.
Date deletedAt
The time when the VPC connector was deleted. It's in Unix time stamp format.
String vpcIngressConnectionArn
The Amazon Resource Name (ARN) of the VPC Ingress Connection that is associated with your service.
String vpcId
The ID of the Amazon VPC that is associated with the custom domain name of the target DNS.
String domainName
The domain name of your target DNS that is associated with the Amazon VPC.
String vpcIngressConnectionArn
The Amazon Resource Name (ARN) of the VPC Ingress Connection.
String vpcIngressConnectionName
The customer-provided VPC Ingress Connection name.
String serviceArn
The Amazon Resource Name (ARN) of the service associated with the VPC Ingress Connection.
String status
The current status of the VPC Ingress Connection. The VPC Ingress Connection displays one of the following
statuses: AVAILABLE, PENDING_CREATION, PENDING_UPDATE,
PENDING_DELETION,FAILED_CREATION, FAILED_UPDATE,
FAILED_DELETION, and DELETED..
String accountId
The Account Id you use to create the VPC Ingress Connection resource.
String domainName
The domain name associated with the VPC Ingress Connection resource.
IngressVpcConfiguration ingressVpcConfiguration
Specifications for the customer’s VPC and related PrivateLink VPC endpoint that are used to associate with the VPC Ingress Connection resource.
Date createdAt
The time when the VPC Ingress Connection was created. It's in the Unix time stamp format.
Type: Timestamp
Required: Yes
Date deletedAt
The time when the App Runner service was deleted. It's in the Unix time stamp format.
Type: Timestamp
Required: No
Copyright © 2024. All rights reserved.