AWS Native is in preview. AWS Classic is fully supported.
aws-native.vpclattice.getListener
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
Creates a listener for a service. Before you start using your Amazon VPC Lattice service, you must add one or more listeners. A listener is a process that checks for connection requests to your services.
Using getListener
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getListener(args: GetListenerArgs, opts?: InvokeOptions): Promise<GetListenerResult>
function getListenerOutput(args: GetListenerOutputArgs, opts?: InvokeOptions): Output<GetListenerResult>
def get_listener(arn: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetListenerResult
def get_listener_output(arn: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetListenerResult]
func LookupListener(ctx *Context, args *LookupListenerArgs, opts ...InvokeOption) (*LookupListenerResult, error)
func LookupListenerOutput(ctx *Context, args *LookupListenerOutputArgs, opts ...InvokeOption) LookupListenerResultOutput
> Note: This function is named LookupListener
in the Go SDK.
public static class GetListener
{
public static Task<GetListenerResult> InvokeAsync(GetListenerArgs args, InvokeOptions? opts = null)
public static Output<GetListenerResult> Invoke(GetListenerInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetListenerResult> getListener(GetListenerArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:vpclattice:getListener
arguments:
# arguments dictionary
The following arguments are supported:
- Arn string
- The Amazon Resource Name (ARN) of the listener.
- Arn string
- The Amazon Resource Name (ARN) of the listener.
- arn String
- The Amazon Resource Name (ARN) of the listener.
- arn string
- The Amazon Resource Name (ARN) of the listener.
- arn str
- The Amazon Resource Name (ARN) of the listener.
- arn String
- The Amazon Resource Name (ARN) of the listener.
getListener Result
The following output properties are available:
- Arn string
- The Amazon Resource Name (ARN) of the listener.
- Default
Action Pulumi.Aws Native. Vpc Lattice. Outputs. Listener Default Action - The action for the default rule. Each listener has a default rule. The default rule is used if no other rules match.
- Id string
- The ID of the listener.
- Service
Arn string - The Amazon Resource Name (ARN) of the service.
- Service
Id string - The ID of the service.
- List<Pulumi.
Aws Native. Outputs. Tag> - The tags for the listener.
- Arn string
- The Amazon Resource Name (ARN) of the listener.
- Default
Action ListenerDefault Action - The action for the default rule. Each listener has a default rule. The default rule is used if no other rules match.
- Id string
- The ID of the listener.
- Service
Arn string - The Amazon Resource Name (ARN) of the service.
- Service
Id string - The ID of the service.
- Tag
- The tags for the listener.
- arn String
- The Amazon Resource Name (ARN) of the listener.
- default
Action ListenerDefault Action - The action for the default rule. Each listener has a default rule. The default rule is used if no other rules match.
- id String
- The ID of the listener.
- service
Arn String - The Amazon Resource Name (ARN) of the service.
- service
Id String - The ID of the service.
- List<Tag>
- The tags for the listener.
- arn string
- The Amazon Resource Name (ARN) of the listener.
- default
Action ListenerDefault Action - The action for the default rule. Each listener has a default rule. The default rule is used if no other rules match.
- id string
- The ID of the listener.
- service
Arn string - The Amazon Resource Name (ARN) of the service.
- service
Id string - The ID of the service.
- Tag[]
- The tags for the listener.
- arn str
- The Amazon Resource Name (ARN) of the listener.
- default_
action ListenerDefault Action - The action for the default rule. Each listener has a default rule. The default rule is used if no other rules match.
- id str
- The ID of the listener.
- service_
arn str - The Amazon Resource Name (ARN) of the service.
- service_
id str - The ID of the service.
- Sequence[root_Tag]
- The tags for the listener.
- arn String
- The Amazon Resource Name (ARN) of the listener.
- default
Action Property Map - The action for the default rule. Each listener has a default rule. The default rule is used if no other rules match.
- id String
- The ID of the listener.
- service
Arn String - The Amazon Resource Name (ARN) of the service.
- service
Id String - The ID of the service.
- List<Property Map>
- The tags for the listener.
Supporting Types
ListenerDefaultAction
- Fixed
Response Pulumi.Aws Native. Vpc Lattice. Inputs. Listener Fixed Response - Describes an action that returns a custom HTTP response.
- Forward
Pulumi.
Aws Native. Vpc Lattice. Inputs. Listener Forward - Describes a forward action. You can use forward actions to route requests to one or more target groups.
- Fixed
Response ListenerFixed Response - Describes an action that returns a custom HTTP response.
- Forward
Listener
Forward - Describes a forward action. You can use forward actions to route requests to one or more target groups.
- fixed
Response ListenerFixed Response - Describes an action that returns a custom HTTP response.
- forward
Listener
Forward - Describes a forward action. You can use forward actions to route requests to one or more target groups.
- fixed
Response ListenerFixed Response - Describes an action that returns a custom HTTP response.
- forward
Listener
Forward - Describes a forward action. You can use forward actions to route requests to one or more target groups.
- fixed_
response ListenerFixed Response - Describes an action that returns a custom HTTP response.
- forward
Listener
Forward - Describes a forward action. You can use forward actions to route requests to one or more target groups.
- fixed
Response Property Map - Describes an action that returns a custom HTTP response.
- forward Property Map
- Describes a forward action. You can use forward actions to route requests to one or more target groups.
ListenerFixedResponse
- Status
Code int - The HTTP response code.
- Status
Code int - The HTTP response code.
- status
Code Integer - The HTTP response code.
- status
Code number - The HTTP response code.
- status_
code int - The HTTP response code.
- status
Code Number - The HTTP response code.
ListenerForward
- Target
Groups List<Pulumi.Aws Native. Vpc Lattice. Inputs. Listener Weighted Target Group> The target groups. Traffic matching the rule is forwarded to the specified target groups. With forward actions, you can assign a weight that controls the prioritization and selection of each target group. This means that requests are distributed to individual target groups based on their weights. For example, if two target groups have the same weight, each target group receives half of the traffic.
The default value is 1. This means that if only one target group is provided, there is no need to set the weight; 100% of the traffic goes to that target group.
- Target
Groups []ListenerWeighted Target Group The target groups. Traffic matching the rule is forwarded to the specified target groups. With forward actions, you can assign a weight that controls the prioritization and selection of each target group. This means that requests are distributed to individual target groups based on their weights. For example, if two target groups have the same weight, each target group receives half of the traffic.
The default value is 1. This means that if only one target group is provided, there is no need to set the weight; 100% of the traffic goes to that target group.
- target
Groups List<ListenerWeighted Target Group> The target groups. Traffic matching the rule is forwarded to the specified target groups. With forward actions, you can assign a weight that controls the prioritization and selection of each target group. This means that requests are distributed to individual target groups based on their weights. For example, if two target groups have the same weight, each target group receives half of the traffic.
The default value is 1. This means that if only one target group is provided, there is no need to set the weight; 100% of the traffic goes to that target group.
- target
Groups ListenerWeighted Target Group[] The target groups. Traffic matching the rule is forwarded to the specified target groups. With forward actions, you can assign a weight that controls the prioritization and selection of each target group. This means that requests are distributed to individual target groups based on their weights. For example, if two target groups have the same weight, each target group receives half of the traffic.
The default value is 1. This means that if only one target group is provided, there is no need to set the weight; 100% of the traffic goes to that target group.
- target_
groups Sequence[ListenerWeighted Target Group] The target groups. Traffic matching the rule is forwarded to the specified target groups. With forward actions, you can assign a weight that controls the prioritization and selection of each target group. This means that requests are distributed to individual target groups based on their weights. For example, if two target groups have the same weight, each target group receives half of the traffic.
The default value is 1. This means that if only one target group is provided, there is no need to set the weight; 100% of the traffic goes to that target group.
- target
Groups List<Property Map> The target groups. Traffic matching the rule is forwarded to the specified target groups. With forward actions, you can assign a weight that controls the prioritization and selection of each target group. This means that requests are distributed to individual target groups based on their weights. For example, if two target groups have the same weight, each target group receives half of the traffic.
The default value is 1. This means that if only one target group is provided, there is no need to set the weight; 100% of the traffic goes to that target group.
ListenerWeightedTargetGroup
- Target
Group stringIdentifier - The ID of the target group.
- Weight int
- Only required if you specify multiple target groups for a forward action. The weight determines how requests are distributed to the target group. For example, if you specify two target groups, each with a weight of 10, each target group receives half the requests. If you specify two target groups, one with a weight of 10 and the other with a weight of 20, the target group with a weight of 20 receives twice as many requests as the other target group. If there's only one target group specified, then the default value is 100.
- Target
Group stringIdentifier - The ID of the target group.
- Weight int
- Only required if you specify multiple target groups for a forward action. The weight determines how requests are distributed to the target group. For example, if you specify two target groups, each with a weight of 10, each target group receives half the requests. If you specify two target groups, one with a weight of 10 and the other with a weight of 20, the target group with a weight of 20 receives twice as many requests as the other target group. If there's only one target group specified, then the default value is 100.
- target
Group StringIdentifier - The ID of the target group.
- weight Integer
- Only required if you specify multiple target groups for a forward action. The weight determines how requests are distributed to the target group. For example, if you specify two target groups, each with a weight of 10, each target group receives half the requests. If you specify two target groups, one with a weight of 10 and the other with a weight of 20, the target group with a weight of 20 receives twice as many requests as the other target group. If there's only one target group specified, then the default value is 100.
- target
Group stringIdentifier - The ID of the target group.
- weight number
- Only required if you specify multiple target groups for a forward action. The weight determines how requests are distributed to the target group. For example, if you specify two target groups, each with a weight of 10, each target group receives half the requests. If you specify two target groups, one with a weight of 10 and the other with a weight of 20, the target group with a weight of 20 receives twice as many requests as the other target group. If there's only one target group specified, then the default value is 100.
- target_
group_ stridentifier - The ID of the target group.
- weight int
- Only required if you specify multiple target groups for a forward action. The weight determines how requests are distributed to the target group. For example, if you specify two target groups, each with a weight of 10, each target group receives half the requests. If you specify two target groups, one with a weight of 10 and the other with a weight of 20, the target group with a weight of 20 receives twice as many requests as the other target group. If there's only one target group specified, then the default value is 100.
- target
Group StringIdentifier - The ID of the target group.
- weight Number
- Only required if you specify multiple target groups for a forward action. The weight determines how requests are distributed to the target group. For example, if you specify two target groups, each with a weight of 10, each target group receives half the requests. If you specify two target groups, one with a weight of 10 and the other with a weight of 20, the target group with a weight of 20 receives twice as many requests as the other target group. If there's only one target group specified, then the default value is 100.
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.