Remove apiEndpoint and other comments

Author: Sumeet Badyal

packages/@aws-cdk/aws-stepfunctions-tasks/README.md

@@ -229,7 +229,6 @@ const restApi = new apigateway.RestApi(stack, 'MyRestApi');
 
 const invokeJob = new tasks.ApiGatewayInvoke(stack, 'Invoke APIGW', {
   api: restApi,
-  apiEndpoint: restApi.restApiId,
   stageName: 'prod',
   method: ApiGatewayMethodType.GET,
 });

packages/@aws-cdk/aws-stepfunctions-tasks/lib/apigateway/invoke.ts

@@ -13,12 +13,6 @@ export interface ApiGatewayInvokeProps extends sfn.TaskStateBaseProps {
   /** API to call */
   readonly api: apigateway.IRestApi;
 
-  /**
-   * hostname of an API Gateway URL
-   * @example {ApiId}.execute-api.{region}.amazonaws.com
-   */
-  readonly apiEndpoint: string;
-
   /** Http method for the API */
   readonly method: HttpMethod;
 
@@ -37,7 +31,7 @@ export interface ApiGatewayInvokeProps extends sfn.TaskStateBaseProps {
 
   /**
    * Name of the stage where the API is deployed to in API Gateway
-   * @default - Required for REST and $default for HTTP
+   * @default - Required for REST and $default for HTTP which acts as a catch-all for requests that don’t match any other routes
    */
   readonly stageName?: string;
 
@@ -69,7 +63,7 @@ export interface ApiGatewayInvokeProps extends sfn.TaskStateBaseProps {
 
   /**
    * Authentication methods
-   * @default - NO_AUTH
+   * @default AuthType.NO_AUTH
    */
   readonly authType?: AuthType;
 
@@ -104,8 +98,6 @@ export class ApiGatewayInvoke extends sfn.TaskStateBase {
 
   /**
    * Provides the API Gateway Invoke service integration task configuration
-   */
-  /**
    * @internal
    */
   protected _renderTask(): any {
@@ -125,13 +117,13 @@ export class ApiGatewayInvoke extends sfn.TaskStateBase {
   }
 
   /**
-   * Gets the "execute-api" ARN
-   * @returns The "execute-api" ARN.
-   * @default "*" returns the execute API ARN for all methods/resources in
-   * this API.
+   * Gets the resource to attatched to the ExecuteAPI:Invoke
+   * @returns resource.
+   * @default "*" returns the execute API ARN for all methods/resources in this API.
    * @param method The method (default `*`)
    * @param path The resource path. Must start with '/' (default `*`)
    * @param stage The stage (default `*`)
+   * @example {ApiId}/{stage}/{method}/{path}
    */
   get arnForExecuteApi() {
     return this.props.api.arnForExecuteApi(this.props.method, this.props.path, this.props.stageName);
@@ -204,7 +196,6 @@ export enum HttpMethod {
 
 /**
  * The authentication method used to call the endpoint
- * @default NO_AUTH
  */
 export enum AuthType {
   /** Call the API direclty with no authorization method */

packages/@aws-cdk/aws-stepfunctions-tasks/test/apigateway/integ.invoke.ts

@@ -8,29 +8,29 @@ import { ApiGatewayInvoke, AuthType, HttpMethod } from '../../lib';
  * Stack verification steps:
  * * aws stepfunctions start-execution --state-machine-arn <deployed state machine arn> : should return execution arn
  * * aws stepfunctions describe-execution --execution-arn <exection-arn generated before> : should return status as SUCCEEDED and a query-execution-id
- * * aws apigateway test-invoke-method --rest-api-id <value> --resource-id <value> --http-method <value>: should return the same response as the state machine
+ * * aws apigateway test-invoke-method --rest-api-id <value> --resource-id <value> --http-method <value>: should return the same response body and status as in the task succeeded/failed execution
  */
 const app = new cdk.App();
 const stack = new cdk.Stack(app, 'aws-stepfunctions-tasks-apigateway-invoke-integ');
 const restApi = new apigateway.RestApi(stack, 'MyRestApi');
 
-const hello = new apigateway.LambdaIntegration(new lambda.Function(stack, 'Hello', {
-  runtime: lambda.Runtime.NODEJS_10_X,
-  handler: 'index.handler',
-  code: lambda.Code.inline(`exports.handler = ${helloCode}`),
-}));
-
 function helloCode(_event: any, _context: any, callback: any) {
   return callback(undefined, {
     statusCode: 200,
     body: 'hello, world!',
   });
 }
+
+const hello = new apigateway.LambdaIntegration(new lambda.Function(stack, 'Hello', {
+  runtime: lambda.Runtime.NODEJS_10_X,
+  handler: 'index.handler',
+  code: lambda.Code.inline(`exports.handler = ${helloCode}`),
+}));
+
 restApi.root.addMethod('ANY', hello);
 
 const invokeJob = new ApiGatewayInvoke(stack, 'Invoke APIGW', {
   api: restApi,
-  apiEndpoint: restApi.restApiId,
   stageName: 'prod',
   method: HttpMethod.GET,
   authType: AuthType.IAM_ROLE,

packages/@aws-cdk/aws-stepfunctions-tasks/test/apigateway/invoke.test.ts

@@ -13,7 +13,6 @@ describe('Invoke API', () => {
     // WHEN
     const task = new ApiGatewayInvoke(stack, 'Invoke', {
       api: restApi,
-      apiEndpoint: restApi.restApiId,
       method: HttpMethod.GET,
       stageName: '$default',
       path: 'path',
@@ -74,7 +73,6 @@ describe('Invoke API', () => {
     const task = new ApiGatewayInvoke(stack, 'Invoke', {
       integrationPattern: sfn.IntegrationPattern.WAIT_FOR_TASK_TOKEN,
       api: restApi,
-      apiEndpoint: restApi.restApiId,
       method: HttpMethod.GET,
       headers: taskToken,
       stageName: '$default',
@@ -134,7 +132,6 @@ describe('Invoke API', () => {
       new ApiGatewayInvoke(stack, 'Invoke', {
         integrationPattern: sfn.IntegrationPattern.WAIT_FOR_TASK_TOKEN,
         api: restApi,
-        apiEndpoint: restApi.restApiId,
         method: HttpMethod.GET,
         authType: AuthType.RESOURCE_POLICY,
       });