com.amazonaws.services.apigatewayv2.model

Class GetAuthorizerResult

java.lang.Object

com.amazonaws.AmazonWebServiceResult<ResponseMetadata>

com.amazonaws.services.apigatewayv2.model.GetAuthorizerResult

All Implemented Interfaces:

Serializable, Cloneable

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class GetAuthorizerResult
extends AmazonWebServiceResult<ResponseMetadata>
implements Serializable, Cloneable

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GetAuthorizerResult()

Method Summary

Modifier and Type	Method and Description
GetAuthorizerResult	clone()
boolean	equals(Object obj)
String	getAuthorizerCredentialsArn() Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer.
String	getAuthorizerId() The authorizer identifier.
Integer	getAuthorizerResultTtlInSeconds() The time to live (TTL), in seconds, of cached authorizer results.
String	getAuthorizerType() The authorizer type.
String	getAuthorizerUri() The authorizer's Uniform Resource Identifier (URI).
List<String>	getIdentitySource() The identity source for which authorization is requested.
String	getIdentityValidationExpression() The validation expression does not apply to the REQUEST authorizer.
String	getName() The name of the authorizer.
List<String>	getProviderArns() For REQUEST authorizer, this is not defined.
int	hashCode()
void	setAuthorizerCredentialsArn(String authorizerCredentialsArn) Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer.
void	setAuthorizerId(String authorizerId) The authorizer identifier.
void	setAuthorizerResultTtlInSeconds(Integer authorizerResultTtlInSeconds) The time to live (TTL), in seconds, of cached authorizer results.
void	setAuthorizerType(String authorizerType) The authorizer type.
void	setAuthorizerUri(String authorizerUri) The authorizer's Uniform Resource Identifier (URI).
void	setIdentitySource(Collection<String> identitySource) The identity source for which authorization is requested.
void	setIdentityValidationExpression(String identityValidationExpression) The validation expression does not apply to the REQUEST authorizer.
void	setName(String name) The name of the authorizer.
void	setProviderArns(Collection<String> providerArns) For REQUEST authorizer, this is not defined.
String	toString() Returns a string representation of this object.
GetAuthorizerResult	withAuthorizerCredentialsArn(String authorizerCredentialsArn) Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer.
GetAuthorizerResult	withAuthorizerId(String authorizerId) The authorizer identifier.
GetAuthorizerResult	withAuthorizerResultTtlInSeconds(Integer authorizerResultTtlInSeconds) The time to live (TTL), in seconds, of cached authorizer results.
GetAuthorizerResult	withAuthorizerType(AuthorizerType authorizerType) The authorizer type.
GetAuthorizerResult	withAuthorizerType(String authorizerType) The authorizer type.
GetAuthorizerResult	withAuthorizerUri(String authorizerUri) The authorizer's Uniform Resource Identifier (URI).
GetAuthorizerResult	withIdentitySource(Collection<String> identitySource) The identity source for which authorization is requested.
GetAuthorizerResult	withIdentitySource(String... identitySource) The identity source for which authorization is requested.
GetAuthorizerResult	withIdentityValidationExpression(String identityValidationExpression) The validation expression does not apply to the REQUEST authorizer.
GetAuthorizerResult	withName(String name) The name of the authorizer.
GetAuthorizerResult	withProviderArns(Collection<String> providerArns) For REQUEST authorizer, this is not defined.
GetAuthorizerResult	withProviderArns(String... providerArns) For REQUEST authorizer, this is not defined.

Methods inherited from class com.amazonaws.AmazonWebServiceResult

getSdkHttpMetadata, getSdkResponseMetadata, setSdkHttpMetadata, setSdkResponseMetadata

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GetAuthorizerResult

public GetAuthorizerResult()

Method Detail

setAuthorizerCredentialsArn

public void setAuthorizerCredentialsArn(String authorizerCredentialsArn)

Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

Parameters:

authorizerCredentialsArn - Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

getAuthorizerCredentialsArn

public String getAuthorizerCredentialsArn()

Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

Returns:

Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

withAuthorizerCredentialsArn

public GetAuthorizerResult withAuthorizerCredentialsArn(String authorizerCredentialsArn)

Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

Parameters:

authorizerCredentialsArn - Specifies the required credentials as an IAM role for API Gateway to invoke the authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon Resource Name (ARN). To use resource-based permissions on the Lambda function, specify null.

Returns:

Returns a reference to this object so that method calls can be chained together.

setAuthorizerId

public void setAuthorizerId(String authorizerId)

The authorizer identifier.

Parameters:

authorizerId - The authorizer identifier.

getAuthorizerId

public String getAuthorizerId()

The authorizer identifier.

Returns:

The authorizer identifier.

withAuthorizerId

public GetAuthorizerResult withAuthorizerId(String authorizerId)

The authorizer identifier.

Parameters:

authorizerId - The authorizer identifier.

Returns:

Returns a reference to this object so that method calls can be chained together.

setAuthorizerResultTtlInSeconds

public void setAuthorizerResultTtlInSeconds(Integer authorizerResultTtlInSeconds)

The time to live (TTL), in seconds, of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

Parameters:

authorizerResultTtlInSeconds - The time to live (TTL), in seconds, of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

getAuthorizerResultTtlInSeconds

public Integer getAuthorizerResultTtlInSeconds()

The time to live (TTL), in seconds, of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

Returns:

The time to live (TTL), in seconds, of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

withAuthorizerResultTtlInSeconds

public GetAuthorizerResult withAuthorizerResultTtlInSeconds(Integer authorizerResultTtlInSeconds)

The time to live (TTL), in seconds, of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

Parameters:

authorizerResultTtlInSeconds - The time to live (TTL), in seconds, of cached authorizer results. If it equals 0, authorization caching is disabled. If it is greater than 0, API Gateway will cache authorizer responses. If this field is not set, the default value is 300. The maximum value is 3600, or 1 hour.

Returns:

Returns a reference to this object so that method calls can be chained together.

setAuthorizerType

public void setAuthorizerType(String authorizerType)

The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

Parameters:

authorizerType - The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

See Also:

AuthorizerType

getAuthorizerType

public String getAuthorizerType()

The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

Returns:

The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

See Also:

AuthorizerType

withAuthorizerType

public GetAuthorizerResult withAuthorizerType(String authorizerType)

The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

Parameters:

authorizerType - The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

AuthorizerType

withAuthorizerType

public GetAuthorizerResult withAuthorizerType(AuthorizerType authorizerType)

The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

Parameters:

authorizerType - The authorizer type. Currently the only valid value is REQUEST, for a Lambda function using incoming request parameters.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

AuthorizerType

setAuthorizerUri

public void setAuthorizerUri(String authorizerUri)

The authorizer's Uniform Resource Identifier (URI). ForREQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2: {account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form: arn:aws:apigateway:{region}:lambda:path/{service_api} , where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

Parameters:

authorizerUri - The authorizer's Uniform Resource Identifier (URI). ForREQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda :us-west-2:{account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form: arn:aws:apigateway:{region}:lambda:path/{service_api} , where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

getAuthorizerUri

public String getAuthorizerUri()

The authorizer's Uniform Resource Identifier (URI). ForREQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2: {account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form: arn:aws:apigateway:{region}:lambda:path/{service_api} , where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

Returns:

The authorizer's Uniform Resource Identifier (URI). ForREQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda :us-west-2:{account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form: arn:aws:apigateway:{region}:lambda:path/{service_api} , where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

withAuthorizerUri

public GetAuthorizerResult withAuthorizerUri(String authorizerUri)

The authorizer's Uniform Resource Identifier (URI). ForREQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2: {account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form: arn:aws:apigateway:{region}:lambda:path/{service_api} , where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

Parameters:

authorizerUri - The authorizer's Uniform Resource Identifier (URI). ForREQUEST authorizers, this must be a well-formed Lambda function URI, for example, arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda :us-west-2:{account_id}:function:{lambda_function_name}/invocations. In general, the URI has this form: arn:aws:apigateway:{region}:lambda:path/{service_api} , where {region} is the same as the region hosting the Lambda function, path indicates that the remaining substring in the URI should be treated as the path to the resource, including the initial /. For Lambda functions, this is usually of the form /2015-03-31/functions/[FunctionARN]/invocations.

Returns:

Returns a reference to this object so that method calls can be chained together.

getIdentitySource

public List<String> getIdentitySource()

The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

Returns:

The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

setIdentitySource

public void setIdentitySource(Collection<String> identitySource)

The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

Parameters:

identitySource - The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

withIdentitySource

public GetAuthorizerResult withIdentitySource(String... identitySource)

The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

NOTE: This method appends the values to the existing list (if any). Use setIdentitySource(java.util.Collection) or withIdentitySource(java.util.Collection) if you want to override the existing values.

Parameters:

identitySource - The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

Returns:

Returns a reference to this object so that method calls can be chained together.

withIdentitySource

public GetAuthorizerResult withIdentitySource(Collection<String> identitySource)

The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

Parameters:

identitySource - The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization caching is enabled. The value is a comma-separated string of one or more mapping expressions of the specified request parameters. For example, if an Auth header and a Name query string parameters are defined as identity sources, this value is method.request.header.Auth, method.request.querystring.Name. These parameters will be used to derive the authorization caching key and to perform runtime validation of the REQUEST authorizer by verifying all of the identity-related request parameters are present, not null, and non-empty. Only when this is true does the authorizer invoke the authorizer Lambda function, otherwise, it returns a 401 Unauthorized response without calling the Lambda function. The valid value is a string of comma-separated mapping expressions of the specified request parameters. When the authorization caching is not enabled, this property is optional.

Returns:

Returns a reference to this object so that method calls can be chained together.

setIdentityValidationExpression

public void setIdentityValidationExpression(String identityValidationExpression)

The validation expression does not apply to the REQUEST authorizer.

Parameters:

identityValidationExpression - The validation expression does not apply to the REQUEST authorizer.

getIdentityValidationExpression

public String getIdentityValidationExpression()

The validation expression does not apply to the REQUEST authorizer.

Returns:

The validation expression does not apply to the REQUEST authorizer.

withIdentityValidationExpression

public GetAuthorizerResult withIdentityValidationExpression(String identityValidationExpression)

The validation expression does not apply to the REQUEST authorizer.

Parameters:

identityValidationExpression - The validation expression does not apply to the REQUEST authorizer.

Returns:

Returns a reference to this object so that method calls can be chained together.

setName

public void setName(String name)

The name of the authorizer.

Parameters:

name - The name of the authorizer.

getName

public String getName()

The name of the authorizer.

Returns:

The name of the authorizer.

withName

public GetAuthorizerResult withName(String name)

The name of the authorizer.

Parameters:

name - The name of the authorizer.

Returns:

Returns a reference to this object so that method calls can be chained together.

getProviderArns

public List<String> getProviderArns()

For REQUEST authorizer, this is not defined.

Returns:

For REQUEST authorizer, this is not defined.

setProviderArns

public void setProviderArns(Collection<String> providerArns)

For REQUEST authorizer, this is not defined.

Parameters:

providerArns - For REQUEST authorizer, this is not defined.

withProviderArns

public GetAuthorizerResult withProviderArns(String... providerArns)

For REQUEST authorizer, this is not defined.

NOTE: This method appends the values to the existing list (if any). Use setProviderArns(java.util.Collection) or withProviderArns(java.util.Collection) if you want to override the existing values.

Parameters:

providerArns - For REQUEST authorizer, this is not defined.

Returns:

Returns a reference to this object so that method calls can be chained together.

withProviderArns

public GetAuthorizerResult withProviderArns(Collection<String> providerArns)

For REQUEST authorizer, this is not defined.

Parameters:

providerArns - For REQUEST authorizer, this is not defined.

Returns:

Returns a reference to this object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public GetAuthorizerResult clone()

Overrides:

clone in class Object