feat(apigateway): adding the ability to set the endpoint configuration for the OpenAPI 3.0

[IsmaelMartinez]

feat(apigateway): adding the ability to set the endpoint configuration for the OpenAPI 3.0

With this change, it will be possible to modify this by providing the endpointConfiguration as shown here:

const api = new apigateway.SpecRestApi(this, 'ExampleRestApi', {
  apiDefinition: apigateway.ApiDefinition.fromInline(replacedSwagger),
  endpointConfiguration: {
    types: [apigateway.EndpointType.PRIVATE],
  },
});

Note: For private endpoints you will still need to provide the x-amazon-apigateway-policy in your openApi file.

Checklist for this PR:
🧪 Testing: adding integration testing for private API gateway.
📄 Docs: Add example in the README documentation about how to create a private API gateway with swagger
Fixes #9060

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[mergify]

Title does not follow the guidelines of Conventional Commits. Please adjust title before merge.

[aws-cdk-automation]

AWS CodeBuild CI Report

• CodeBuild project: AutoBuildProject6AEA49D1-qxepHUsryhcu
• Commit ID: 4470e89
• Result: SUCCEEDED
• Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

[IsmaelMartinez]

somehow that git pull bot has removed the commits so opened another PR

#9068

Automation sometimes have funny side effects. 🤣