You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::ElasticLoadBalancingV2::Types::Action

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing Action as input to an Aws::Client method, you can use a vanilla Hash:

{
  type: "forward", # required, accepts forward, authenticate-oidc, authenticate-cognito, redirect, fixed-response
  target_group_arn: "TargetGroupArn",
  authenticate_oidc_config: {
    issuer: "AuthenticateOidcActionIssuer", # required
    authorization_endpoint: "AuthenticateOidcActionAuthorizationEndpoint", # required
    token_endpoint: "AuthenticateOidcActionTokenEndpoint", # required
    user_info_endpoint: "AuthenticateOidcActionUserInfoEndpoint", # required
    client_id: "AuthenticateOidcActionClientId", # required
    client_secret: "AuthenticateOidcActionClientSecret",
    session_cookie_name: "AuthenticateOidcActionSessionCookieName",
    scope: "AuthenticateOidcActionScope",
    session_timeout: 1,
    authentication_request_extra_params: {
      "AuthenticateOidcActionAuthenticationRequestParamName" => "AuthenticateOidcActionAuthenticationRequestParamValue",
    },
    on_unauthenticated_request: "deny", # accepts deny, allow, authenticate
    use_existing_client_secret: false,
  },
  authenticate_cognito_config: {
    user_pool_arn: "AuthenticateCognitoActionUserPoolArn", # required
    user_pool_client_id: "AuthenticateCognitoActionUserPoolClientId", # required
    user_pool_domain: "AuthenticateCognitoActionUserPoolDomain", # required
    session_cookie_name: "AuthenticateCognitoActionSessionCookieName",
    scope: "AuthenticateCognitoActionScope",
    session_timeout: 1,
    authentication_request_extra_params: {
      "AuthenticateCognitoActionAuthenticationRequestParamName" => "AuthenticateCognitoActionAuthenticationRequestParamValue",
    },
    on_unauthenticated_request: "deny", # accepts deny, allow, authenticate
  },
  order: 1,
  redirect_config: {
    protocol: "RedirectActionProtocol",
    port: "RedirectActionPort",
    host: "RedirectActionHost",
    path: "RedirectActionPath",
    query: "RedirectActionQuery",
    status_code: "HTTP_301", # required, accepts HTTP_301, HTTP_302
  },
  fixed_response_config: {
    message_body: "FixedResponseActionMessage",
    status_code: "FixedResponseActionStatusCode", # required
    content_type: "FixedResponseActionContentType",
  },
  forward_config: {
    target_groups: [
      {
        target_group_arn: "TargetGroupArn",
        weight: 1,
      },
    ],
    target_group_stickiness_config: {
      enabled: false,
      duration_seconds: 1,
    },
  },
}

Information about an action.

Each rule must include exactly one of the following types of actions: forward, fixed-response, or redirect, and it must be the last action to be performed.

Instance Attribute Summary collapse

Instance Attribute Details

#authenticate_cognito_configTypes::AuthenticateCognitoActionConfig

[HTTPS listeners] Information for using Amazon Cognito to authenticate users. Specify only when Type is authenticate-cognito.

Returns:

#authenticate_oidc_configTypes::AuthenticateOidcActionConfig

[HTTPS listeners] Information about an identity provider that is compliant with OpenID Connect (OIDC). Specify only when Type is authenticate-oidc.

Returns:

#fixed_response_configTypes::FixedResponseActionConfig

[Application Load Balancer] Information for creating an action that returns a custom HTTP response. Specify only when Type is fixed-response.

Returns:

#forward_configTypes::ForwardActionConfig

Information for creating an action that distributes requests among one or more target groups. For Network Load Balancers, you can specify a single target group. Specify only when Type is forward. If you specify both ForwardConfig and TargetGroupArn, you can specify only one target group using ForwardConfig and it must be the same target group specified in TargetGroupArn.

Returns:

#orderInteger

The order for the action. This value is required for rules with multiple actions. The action with the lowest value for order is performed first.

Returns:

  • (Integer)

    The order for the action.

#redirect_configTypes::RedirectActionConfig

[Application Load Balancer] Information for creating a redirect action. Specify only when Type is redirect.

Returns:

#target_group_arnString

The Amazon Resource Name (ARN) of the target group. Specify only when Type is forward and you want to route to a single target group. To route to one or more target groups, use ForwardConfig instead.

Returns:

  • (String)

    The Amazon Resource Name (ARN) of the target group.

#typeString

The type of action.

Possible values:

  • forward
  • authenticate-oidc
  • authenticate-cognito
  • redirect
  • fixed-response

Returns:

  • (String)

    The type of action.