CfnMethod

java.lang.Object
- software.constructs.Construct
- - software.amazon.awscdk.core.Construct
  - - software.amazon.awscdk.core.CfnElement
    - - software.amazon.awscdk.core.CfnRefElement
      - software.amazon.awscdk.core.CfnResource
        
        software.amazon.awscdk.services.apigateway.CfnMethod

All Implemented Interfaces:: IConstruct, IDependable, IInspectable

@Generated(value="jsii-pacmak/1.71.0 (build f1f58ae)",
           date="2022-11-29T04:32:25.203Z")
public class CfnMethod
extends CfnResource
implements IInspectable

A CloudFormation `AWS::ApiGateway::Method`.

The AWS::ApiGateway::Method resource creates API Gateway methods that define the parameters and body that clients must send in their requests.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.apigateway.*;
 CfnMethod cfnMethod = CfnMethod.Builder.create(this, "MyCfnMethod")
         .httpMethod("httpMethod")
         .resourceId("resourceId")
         .restApiId("restApiId")
         // the properties below are optional
         .apiKeyRequired(false)
         .authorizationScopes(List.of("authorizationScopes"))
         .authorizationType("authorizationType")
         .authorizerId("authorizerId")
         .integration(IntegrationProperty.builder()
                 .cacheKeyParameters(List.of("cacheKeyParameters"))
                 .cacheNamespace("cacheNamespace")
                 .connectionId("connectionId")
                 .connectionType("connectionType")
                 .contentHandling("contentHandling")
                 .credentials("credentials")
                 .integrationHttpMethod("integrationHttpMethod")
                 .integrationResponses(List.of(IntegrationResponseProperty.builder()
                         .statusCode("statusCode")
                         // the properties below are optional
                         .contentHandling("contentHandling")
                         .responseParameters(Map.of(
                                 "responseParametersKey", "responseParameters"))
                         .responseTemplates(Map.of(
                                 "responseTemplatesKey", "responseTemplates"))
                         .selectionPattern("selectionPattern")
                         .build()))
                 .passthroughBehavior("passthroughBehavior")
                 .requestParameters(Map.of(
                         "requestParametersKey", "requestParameters"))
                 .requestTemplates(Map.of(
                         "requestTemplatesKey", "requestTemplates"))
                 .timeoutInMillis(123)
                 .type("type")
                 .uri("uri")
                 .build())
         .methodResponses(List.of(MethodResponseProperty.builder()
                 .statusCode("statusCode")
                 // the properties below are optional
                 .responseModels(Map.of(
                         "responseModelsKey", "responseModels"))
                 .responseParameters(Map.of(
                         "responseParametersKey", false))
                 .build()))
         .operationName("operationName")
         .requestModels(Map.of(
                 "requestModelsKey", "requestModels"))
         .requestParameters(Map.of(
                 "requestParametersKey", false))
         .requestValidatorId("requestValidatorId")
         .build();

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`CfnMethod.Builder` A fluent builder for `CfnMethod`.
`static interface`	`CfnMethod.IntegrationProperty` `Integration` is a property of the [AWS::ApiGateway::Method](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-method.html) resource that specifies information about the target backend that a method calls.
`static interface`	`CfnMethod.IntegrationResponseProperty` `IntegrationResponse` is a property of the [Amazon API Gateway Method Integration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apitgateway-method-integration.html) property type that specifies the response that API Gateway sends after a method's backend finishes processing a request.
`static interface`	`CfnMethod.MethodResponseProperty` `MethodResponse` is a property of the [AWS::ApiGateway::Method](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-method.html) resource that defines the responses that can be sent to the client that calls a method.

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IInspectable
IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct
IConstruct.Jsii$Default

Field Summary

Fields
Modifier and Type Field and Description

static java.lang.String CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`CFN_RESOURCE_TYPE_NAME` The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors
Modifier	Constructor and Description
	`CfnMethod(Construct scope, java.lang.String id, CfnMethodProps props)` Create a new `AWS::ApiGateway::Method`.
`protected`	`CfnMethod(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)`
`protected`	`CfnMethod(software.amazon.jsii.JsiiObjectRef objRef)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.Object`	`getApiKeyRequired()` Indicates whether the method requires clients to submit a valid API key.
`java.util.List<java.lang.String>`	`getAuthorizationScopes()` A list of authorization scopes configured on the method.
`java.lang.String`	`getAuthorizationType()` The method's authorization type.
`java.lang.String`	`getAuthorizerId()` The identifier of the [authorizer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-authorizer.html) to use on this method.
`protected java.util.Map<java.lang.String,java.lang.Object>`	`getCfnProperties()`
`java.lang.String`	`getHttpMethod()` The HTTP method that clients use to call this method.
`java.lang.Object`	`getIntegration()` The backend system that the method calls when it receives a request.
`java.lang.Object`	`getMethodResponses()` The responses that can be sent to the client who calls the method.
`java.lang.String`	`getOperationName()` A friendly operation name for the method.
`java.lang.Object`	`getRequestModels()` The resources that are used for the request's content type.
`java.lang.Object`	`getRequestParameters()` The request parameters that API Gateway accepts.
`java.lang.String`	`getRequestValidatorId()` The ID of the associated request validator.
`java.lang.String`	`getResourceId()` The ID of an API Gateway [resource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-resource.html) .
`java.lang.String`	`getRestApiId()` The ID of the [RestApi](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) resource in which API Gateway creates the method.
`void`	`inspect(TreeInspector inspector)` Examines the CloudFormation resource and discloses attributes.
`protected java.util.Map<java.lang.String,java.lang.Object>`	`renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)`
`void`	`setApiKeyRequired(java.lang.Boolean value)` Indicates whether the method requires clients to submit a valid API key.
`void`	`setApiKeyRequired(IResolvable value)` Indicates whether the method requires clients to submit a valid API key.
`void`	`setAuthorizationScopes(java.util.List<java.lang.String> value)` A list of authorization scopes configured on the method.
`void`	`setAuthorizationType(java.lang.String value)` The method's authorization type.
`void`	`setAuthorizerId(java.lang.String value)` The identifier of the [authorizer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-authorizer.html) to use on this method.
`void`	`setHttpMethod(java.lang.String value)` The HTTP method that clients use to call this method.
`void`	`setIntegration(CfnMethod.IntegrationProperty value)` The backend system that the method calls when it receives a request.
`void`	`setIntegration(IResolvable value)` The backend system that the method calls when it receives a request.
`void`	`setMethodResponses(IResolvable value)` The responses that can be sent to the client who calls the method.
`void`	`setMethodResponses(java.util.List<java.lang.Object> value)` The responses that can be sent to the client who calls the method.
`void`	`setOperationName(java.lang.String value)` A friendly operation name for the method.
`void`	`setRequestModels(IResolvable value)` The resources that are used for the request's content type.
`void`	`setRequestModels(java.util.Map<java.lang.String,java.lang.String> value)` The resources that are used for the request's content type.
`void`	`setRequestParameters(IResolvable value)` The request parameters that API Gateway accepts.
`void`	`setRequestParameters(java.util.Map<java.lang.String,java.lang.Object> value)` The request parameters that API Gateway accepts.
`void`	`setRequestValidatorId(java.lang.String value)` The ID of the associated request validator.
`void`	`setResourceId(java.lang.String value)` The ID of an API Gateway [resource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-resource.html) .
`void`	`setRestApiId(java.lang.String value)` The ID of the [RestApi](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) resource in which API Gateway creates the method.

Methods inherited from class software.amazon.awscdk.core.CfnResource
addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.core.CfnRefElement
getRef

Methods inherited from class software.amazon.awscdk.core.CfnElement
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.amazon.awscdk.core.Construct
getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - CFN_RESOURCE_TYPE_NAME
```
public static final java.lang.String CFN_RESOURCE_TYPE_NAME
```
    The CloudFormation resource type name for this resource class.
- Constructor Detail
  - CfnMethod
```
protected CfnMethod(software.amazon.jsii.JsiiObjectRef objRef)
```
  - CfnMethod
```
protected CfnMethod(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
```
  - CfnMethod
```
public CfnMethod(Construct scope,
                 java.lang.String id,
                 CfnMethodProps props)
```
    Create a new `AWS::ApiGateway::Method`.
    
    Parameters:
    
    scope - - scope in which this resource is defined. This parameter is required.
    
    id - - scoped id of the resource. This parameter is required.
    
    props - - resource properties. This parameter is required.
- Method Detail
  - inspect
```
public void inspect(TreeInspector inspector)
```
    Examines the CloudFormation resource and discloses attributes.
    
    Specified by:
    
    inspect in interface IInspectable
    
    Parameters:
    
    inspector - - tree inspector to collect and process attributes. This parameter is required.
  - renderProperties
```
protected java.util.Map<java.lang.String,java.lang.Object> renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)
```
    Overrides:
    
    renderProperties in class CfnResource
    
    Parameters:
    
    props - This parameter is required.
  - getCfnProperties
```
protected java.util.Map<java.lang.String,java.lang.Object> getCfnProperties()
```
    Overrides:
    
    getCfnProperties in class CfnResource
  - getHttpMethod
```
public java.lang.String getHttpMethod()
```
    The HTTP method that clients use to call this method.
  - setHttpMethod
```
public void setHttpMethod(java.lang.String value)
```
    The HTTP method that clients use to call this method.
  - getResourceId
```
public java.lang.String getResourceId()
```
    The ID of an API Gateway [resource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-resource.html) . For root resource methods, specify the `RestApi` root resource ID, such as `{ "Fn::GetAtt": ["MyRestApi", "RootResourceId"] }` .
  - setResourceId
```
public void setResourceId(java.lang.String value)
```
    The ID of an API Gateway [resource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-resource.html) . For root resource methods, specify the `RestApi` root resource ID, such as `{ "Fn::GetAtt": ["MyRestApi", "RootResourceId"] }` .
  - getRestApiId
```
public java.lang.String getRestApiId()
```
    The ID of the [RestApi](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) resource in which API Gateway creates the method.
  - setRestApiId
```
public void setRestApiId(java.lang.String value)
```
    The ID of the [RestApi](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) resource in which API Gateway creates the method.
  - getApiKeyRequired
```
public java.lang.Object getApiKeyRequired()
```
    Indicates whether the method requires clients to submit a valid API key.
  - setApiKeyRequired
```
public void setApiKeyRequired(java.lang.Boolean value)
```
    Indicates whether the method requires clients to submit a valid API key.
  - setApiKeyRequired
```
public void setApiKeyRequired(IResolvable value)
```
    Indicates whether the method requires clients to submit a valid API key.
  - getAuthorizationScopes
```
public java.util.List<java.lang.String> getAuthorizationScopes()
```
    A list of authorization scopes configured on the method.
    The scopes are used with a COGNITO_USER_POOLS authorizer to authorize the method invocation. The authorization works by matching the method scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any method scopes match a claimed scope in the access token. Otherwise, the invocation is not authorized. When the method scope is configured, the client must provide an access token instead of an identity token for authorization purposes.
  - setAuthorizationScopes
```
public void setAuthorizationScopes(java.util.List<java.lang.String> value)
```
    A list of authorization scopes configured on the method.
    The scopes are used with a COGNITO_USER_POOLS authorizer to authorize the method invocation. The authorization works by matching the method scopes against the scopes parsed from the access token in the incoming request. The method invocation is authorized if any method scopes match a claimed scope in the access token. Otherwise, the invocation is not authorized. When the method scope is configured, the client must provide an access token instead of an identity token for authorization purposes.
  - getAuthorizationType
```
public java.lang.String getAuthorizationType()
```
    The method's authorization type.
    This parameter is required. For valid values, see Method in the API Gateway API Reference .
    
    If you specify the AuthorizerId property, specify CUSTOM or COGNITO_USER_POOLS for this property.
  - setAuthorizationType
```
public void setAuthorizationType(java.lang.String value)
```
    The method's authorization type.
    This parameter is required. For valid values, see Method in the API Gateway API Reference .
    
    If you specify the AuthorizerId property, specify CUSTOM or COGNITO_USER_POOLS for this property.
  - getAuthorizerId
```
public java.lang.String getAuthorizerId()
```
    The identifier of the [authorizer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-authorizer.html) to use on this method. If you specify this property, specify `CUSTOM` or `COGNITO_USER_POOLS` for the `AuthorizationType` property.
  - setAuthorizerId
```
public void setAuthorizerId(java.lang.String value)
```
    The identifier of the [authorizer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-authorizer.html) to use on this method. If you specify this property, specify `CUSTOM` or `COGNITO_USER_POOLS` for the `AuthorizationType` property.
  - getIntegration
```
public java.lang.Object getIntegration()
```
    The backend system that the method calls when it receives a request.
  - setIntegration
```
public void setIntegration(IResolvable value)
```
    The backend system that the method calls when it receives a request.
  - setIntegration
```
public void setIntegration(CfnMethod.IntegrationProperty value)
```
    The backend system that the method calls when it receives a request.
  - getMethodResponses
```
public java.lang.Object getMethodResponses()
```
    The responses that can be sent to the client who calls the method.
  - setMethodResponses
```
public void setMethodResponses(IResolvable value)
```
    The responses that can be sent to the client who calls the method.
  - setMethodResponses
```
public void setMethodResponses(java.util.List<java.lang.Object> value)
```
    The responses that can be sent to the client who calls the method.
  - getOperationName
```
public java.lang.String getOperationName()
```
    A friendly operation name for the method.
    For example, you can assign the OperationName of ListPets for the GET /pets method.
  - setOperationName
```
public void setOperationName(java.lang.String value)
```
    A friendly operation name for the method.
    For example, you can assign the OperationName of ListPets for the GET /pets method.
  - getRequestModels
```
public java.lang.Object getRequestModels()
```
    The resources that are used for the request's content type.
    Specify request models as key-value pairs (string-to-string mapping), with a content type as the key and a Model resource name as the value. To use the same model regardless of the content type, specify $default as the key.
  - setRequestModels
```
public void setRequestModels(IResolvable value)
```
    The resources that are used for the request's content type.
    Specify request models as key-value pairs (string-to-string mapping), with a content type as the key and a Model resource name as the value. To use the same model regardless of the content type, specify $default as the key.
  - setRequestModels
```
public void setRequestModels(java.util.Map<java.lang.String,java.lang.String> value)
```
    The resources that are used for the request's content type.
    Specify request models as key-value pairs (string-to-string mapping), with a content type as the key and a Model resource name as the value. To use the same model regardless of the content type, specify $default as the key.
  - getRequestParameters
```
public java.lang.Object getRequestParameters()
```
    The request parameters that API Gateway accepts.
    Specify request parameters as key-value pairs (string-to-Boolean mapping), with a source as the key and a Boolean as the value. The Boolean specifies whether a parameter is required. A source must match the format method.request. *location* . *name* , where the location is querystring, path, or header, and name is a valid, unique parameter name.
  - setRequestParameters
```
public void setRequestParameters(IResolvable value)
```
    The request parameters that API Gateway accepts.
    Specify request parameters as key-value pairs (string-to-Boolean mapping), with a source as the key and a Boolean as the value. The Boolean specifies whether a parameter is required. A source must match the format method.request. *location* . *name* , where the location is querystring, path, or header, and name is a valid, unique parameter name.
  - setRequestParameters
```
public void setRequestParameters(java.util.Map<java.lang.String,java.lang.Object> value)
```
    The request parameters that API Gateway accepts.
    Specify request parameters as key-value pairs (string-to-Boolean mapping), with a source as the key and a Boolean as the value. The Boolean specifies whether a parameter is required. A source must match the format method.request. *location* . *name* , where the location is querystring, path, or header, and name is a valid, unique parameter name.
  - getRequestValidatorId
```
public java.lang.String getRequestValidatorId()
```
    The ID of the associated request validator.
  - setRequestValidatorId
```
public void setRequestValidatorId(java.lang.String value)
```
    The ID of the associated request validator.

Class CfnMethod

Nested Class Summary

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IInspectable

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct

Field Summary

Constructor Summary

Method Summary

Methods inherited from class software.amazon.awscdk.core.CfnResource

Methods inherited from class software.amazon.awscdk.core.CfnRefElement

Methods inherited from class software.amazon.awscdk.core.CfnElement

Methods inherited from class software.amazon.awscdk.core.Construct

Methods inherited from class java.lang.Object

Field Detail

CFN_RESOURCE_TYPE_NAME

Constructor Detail

CfnMethod

CfnMethod

CfnMethod

Method Detail

inspect

renderProperties

getCfnProperties

getHttpMethod

setHttpMethod

getResourceId

setResourceId

getRestApiId

setRestApiId

getApiKeyRequired

setApiKeyRequired

setApiKeyRequired

getAuthorizationScopes

setAuthorizationScopes

getAuthorizationType

setAuthorizationType

getAuthorizerId

setAuthorizerId

getIntegration

setIntegration

setIntegration

getMethodResponses

setMethodResponses

setMethodResponses

getOperationName

setOperationName

getRequestModels

setRequestModels

setRequestModels

getRequestParameters

setRequestParameters

setRequestParameters

getRequestValidatorId

setRequestValidatorId