AWS ToolkitThe AWS Toolkit extension for Visual Studio Code enables you to interact with Amazon Web Services (AWS). See the user guide for complete documentation. Try the AWS Code Sample Catalog to start coding with the AWS SDK. See Setup for prerequisites. If you run into a problem, try support. Features
AWS ExplorerThe AWS Explorer provides access to the AWS services that you can work with when using the Toolkit. To see the AWS Explorer, choose the AWS icon in the Activity bar. { Return to Top } Developer ToolsThe Developer Tools panel is a section for developer-focused tooling curated for working in an IDE. The Developer Tools panel can be found underneath the AWS Explorer when the AWS icon is selected in the Activity bar. { Return to Top }CDK ExplorerThe AWS CDK Explorer enables you to work with AWS Cloud Development Kit (CDK) applications. It shows a top-level view of your CDK applications that have been sythesized in your workspace. With the CDK explorer, you can navigate the CDK application's infrastructure stacks, resources, and policies. For full details see the AWS CDK Explorer in the user guide. { Return to Top } Amazon CodeWhispererAmazon CodeWhisperer provides inline code suggestions using machine learning and natural language processing on the contents of your current file. Supported languages include: Java, Python and Javascript. Once enabled, CodeWhisperer will provide code suggestions automatically and can also be requested manually using option+c (mac) / alt+c (PC). CodeWhisperer may provide multiple suggestions; use the left- and right-arrow to navigate between suggestions. To accept a suggestion and add it to your file, press Tab. To dismiss a suggestion, press escape or keep typing. In addition to providing code suggestions within your current file, CodeWhisperer can scan your entire package to identify security issues. To initiate a security scan, go to the CodeWhisperer section in the Developer Tools panel and select “Run security scan”. Results will be listed in the Problems panel. For more information, see Amazon CodeWhisperer in our user guide. { Return to Top } AWS Serverless ApplicationsThe AWS Toolkit enables you to develop AWS serverless applications locally. It also provides CodeLenses in VS Code to do the following:
To start debugging with a SAM template, click the The CodeLens indicator in the SAM template allows you to add a debug configuration for the serverless application.Alternatively, you can run and debug just the AWS Lambda function and exclude other resources defined by the SAM template. Again, use a CodeLens indicator for an AWS Lambda-function handler. (A handler is a function that Lambda calls to start execution of a Lambda function.) The CodeLens indicator in the application file lets you add a debug configuration for a selected AWS Lambda function.When you run a debug session, the status and results are shown in the OUTPUT panel when the AWS Toolkit output channel is selected. After a local run is complete, the output appears in the OUTPUT tab.When you're satisfied with performance, you can deploy your serverless application. The SAM template is converted to a CloudFormation template, which is then used to deploy all the application's assets to the AWS Cloud. Launch config auto-completion ("IntelliSense")The When editing ![]() Supported runtimesThe Toolkit local SAM debugging feature supports these Lambda runtimes:
For more information see Working with AWS Serverless Applications in the user guide. To get setup for local debugging, see Configuring your toolchain. { Return to Top } Amazon CloudWatch LogsThe AWS Toolkit provides support for Amazon CloudWatch Logs. Using the AWS Explorer of the Toolkit, you can perform the following operations on Log Groups:
Viewing a Log Stream will immediately load the most recent 10,000 lines or 1 MB of data (whichever is smaller), and their timestamps. From this view, users can access the following actions:
Example: For full details, see Working with CloudWatch Logs in the Toolkit's user guide. { Return to Top } Amazon EventBridge SchemasThe AWS Toolkit provides support for Amazon EventBridge schemas. Using the AWS Explorer of the Toolkit, you can perform the following operations on these schemas:
Example: For full details, see Working with Amazon EventBridge Schemas in the Toolkit's user guide. { Return to Top } Amazon ECS task definition filesThe AWS Toolkit provides support for Amazon Elastic Container Service (Amazon ECS). With the Toolkit installed in VS Code, IntelliSense functionality is provided for Amazon ECS task-definition files that you are updating in the editor. Example: For full details, see Working with Amazon Elastic Container Service in the Toolkit's user guide. { Return to Top } AWS Systems Manager DocumentsThe AWS Toolkit provides support for AWS Systems Manager Documents. With the Toolkit installed in VS Code, you have access to the following features when working on Automation Documents:
Example: For full details, see Working with AWS Systems Manager Documents in the Toolkit's user guide. { Return to Top } AWS Step FunctionsThe AWS Toolkit provides support for AWS Step Functions. With the Toolkit installed in VS Code, working with state machines is a more streamlined process.
Example: For full details, see Working with AWS Step Functions in the Toolkit's user guide. { Return to Top }
|
AWS Command | Description |
---|---|
AWS: About Toolkit |
Displays information about the AWS Toolkit. |
AWS: Add SAM Debug Configuration |
Creates an aws-sam Debug Configuration from a function in the current source file |
AWS: Connect to AWS |
Connects the Toolkit to an AWS account. For more information, see Connecting to AWS in the user guide. |
AWS: Copy Log Stream Name |
Copies the name of the active CloudWatch Log Stream |
AWS: Create a new Step Functions state machine |
Generates a new Amazon States Language definition to use as the definition for a new Step Functions state machine. For more information, see State Machine Templates in the user guide. |
AWS: Create a new Issue on Github |
Opens the AWS Toolkit's New Issue page on Github. |
AWS: Create a new Systems Manager Document locally |
Creates a new Systems Manager Document from a template in either YAML or JSON |
AWS: Create Credentials Profile |
Creates an AWS credentials profile. For more information, see Setting Up Your AWS Credentials in the user guide. |
AWS: Create Lambda SAM Application |
Generates code files for a new AWS serverless Lambda application. For more information, see Creating a Serverless Application in the user guide. |
AWS: Create new CloudFormation Template |
Creates a new starter Cloudformation Template |
AWS: Create new SAM Template |
Creates a new starter SAM Template |
AWS: Deploy SAM Application |
Deploys a local serverless application to an AWS account. For more information, see Deploying a Serverless Application in the user guide. |
AWS: Detect SAM CLI |
Checks whether the Toolkit can communicate correctly with the AWS SAM CLI that is installed. |
AWS: Edit SAM Debug Configuration |
Shows a tool that helps you create, edit, run, and debug a SAM launch config (type:aws-sam ). |
AWS: Focus on Explorer View |
Opens the AWS panel and focuses the Explorer. |
AWS: Publish state machine to Step Functions |
Creates or updates a remote state machine using the local Amazon States Language definition file. For more information, see Work With State Machines in VS Code in the user guide. |
AWS: Publish a Systems Manager Document |
Creates a new document or updates an existing document in your account using the currently open document. |
AWS: Render state machine graph |
Renders the state machine definition into a graph visualization. For more information, see State Machine Graph Visualization in the user guide. |
AWS: Report an Issue |
In the GitHub repository for the Toolkit, opens the page to create a new issue. |
AWS: Save Current Log Content To File |
Saves currently-loaded CloudWatch Log Stream data to a local .log file. |
AWS: Show or Hide Regions |
Adds or removes AWS Regions in the AWS Explorer. |
AWS: Sign out |
Disconnects the Toolkit from the currently-connected AWS account. |
AWS: Submit Quick Feedback... |
Submit a private, one-way message and sentiment to the AWS Toolkit dev team. For larger issues that warrant conversations or bugfixes, please submit an issue in Github with the AWS: Create a New Issue on Github command. |
AWS: Toggle SAM hints in source files |
Toggles AWS SAM-related Codelenses in source files |
AWS: View Toolkit Logs |
Displays log files that contain general Toolkit diagnostic information. |
AWS: View Quick Start |
Open this quick-start guide. |
AWS: View CDK Documentation |
Opens the user guide for the CDK portion of the Toolkit. |
AWS: View Toolkit Documentation |
Opens the user guide for the Toolkit. |
AWS: View Source on GitHub |
Opens the GitHub repository for the Toolkit. |
AWS: Focus on CDK (Preview) View |
Opens the AWS panel and focuses the CDK view. |
{ Return to Top }
Experimental Features
Sometimes we'll introduce experimental features that we're trying out. These may have bugs, usability problems or may not be fully functional, and because these aren't ready for prime-time we'll hide them behind an experimental feature flag.
Experimental features can be enabled in the extension preferences
(Preferences -> Settings -> Extensions -> AWS Configuration -> Experiments
).
Please note that experimental features may be disabled or removed at any time.
{ Return to Top }
Setup
To access most features of the AWS Toolkit, complete the Setting Up steps from the user guide.
- Create an AWS account (see also Prerequisites).
- Create and configure your AWS credentials.
- Connect the Toolkit to AWS with those credentials.
To develop serverless applications with the Toolkit, you must set up your toolchain and do the following on the local machine where the Toolkit is installed:
{ Return to Top }
Get help
For additional details on how to use the AWS Toolkit, see the user guide.
To report issues with the Toolkit or to propose Toolkit code changes, see the aws/aws-toolkit-vscode repository on GitHub.
You can also contact AWS directly.
{ Return to Top }