vscode-azure-account/README.md

93 строки
5.9 KiB
Markdown
Исходник Постоянная ссылка Ответственный История

Этот файл содержит неоднозначные символы Юникода!

Этот файл содержит неоднозначные символы Юникода, которые могут быть перепутаны с другими в текущей локали. Если это намеренно, можете спокойно проигнорировать это предупреждение. Используйте кнопку Экранировать, чтобы подсветить эти символы.

# Azure Account and Sign In
<!-- region exclude-from-marketplace -->
[![Version](https://img.shields.io/visual-studio-marketplace/v/ms-vscode.azure-account.svg)](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-account) [![Installs](https://img.shields.io/visual-studio-marketplace/i/ms-vscode.azure-account.svg)](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-account) [![Build Status](https://dev.azure.com/ms-azuretools/AzCode/_apis/build/status/vscode-azure-account?branchName=main)](https://dev.azure.com/ms-azuretools/AzCode/_build/latest?definitionId=37&branchName=main)
<!-- endregion exclude-from-marketplace -->
⚠️ Attention extension authors! The Azure Account extension is being deprecated in January 2025. If you own an Azure extension that relies on Azure Account, or are creating a new extension that needs authentication to Azure, please see the [deprecation announcement](https://github.com/microsoft/vscode-azure-account/issues/964) for guidance.
The Azure Account extension provides a single Azure sign in and subscription filtering experience for all other Azure extensions. It makes Azure's Cloud Shell service available in VS Code's integrated terminal.
## Signing In/Out
There are multiple commands accessible via the [command palette](https://aka.ms/AAephuz) that may be used to sign into Azure.
![Sign in commands in the command palette](resources/readme/signInCommands.png)
Sign out of Azure using the `Azure: Sign Out` command.
![The sign out command in the command palette](resources/readme/signOutCommand.png)
## Azure Cloud Shell
> Note: The Azure Cloud Shell feature has moved to the [Azure Resources extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureresourcegroups). Apart from moving codebases, the feature is the same from a users perspective. Authentication for the Cloud Shell feature is now handled by the VS Code built-in Microsoft authentication provider, which means you may have to login upon first use of the migrated feature.
Azure Cloud Shell instances can be started via the terminal view in VS Code. To begin, click the
dropdown arrow in the terminal view and select from either `Azure Cloud Shell (Bash)` or
`Azure Cloud Shell (PowerShell)`.
![VS Code terminal view with context menu](resources/readme/terminalViewWithMenu.png)
If this is your first time using the Cloud Shell, the following notification will appear prompting
you to set it up.
!["Must setup cloud shell" notification](resources/readme/mustSetupCloudShell.png)
The Cloud Shell will load in the terminal view once you've finished configuring it.
![The Azure Cloud Shell in the terminal window](resources/readme/cloudShell.png)
You may also upload to the Cloud Shell using the `Azure: Upload to Cloud Shell` command.
## Commands
| Command | |
| --- | --- |
| `Azure: Sign In` | Sign in to your Azure subscription.
| `Azure: Sign In with Device Code` | Sign in to your Azure subscription with a device code. Use this in setups where the Sign In command does not work.
| `Azure: Sign In to Azure Cloud` | Sign in to your Azure subscription in one of the sovereign clouds.
| `Azure: Sign Out` | Sign out of your Azure subscription.
| `Azure: Select Subscriptions` | Pick the set of subscriptions you want to work with. Extensions should respect this list and only show resources within the filtered subscriptions.
| `Azure: Create an Account` | If you don't have an Azure Account, you can [sign up](https://azure.microsoft.com/en-us/free/?utm_source=campaign&utm_campaign=vscode-azure-account&mktingSource=vscode-azure-account) for one today and receive $200 in free credits.
| `Azure: Upload to Cloud Shell`<sup>1</sup> | Upload a file to your Cloud Shell storage account
<sup>1</sup> On Windows: Requires Node.js 6 or later to be installed (https://nodejs.org).
## Settings
| Name | Description | Default |
| --- | --- | --- |
| `azure.resourceFilter` | The resource filter, each element is a tenant id and a subscription id separated by a slash. |
| `azure.showSignedInEmail` | Whether to show the email address (e.g., in the status bar) of the signed in account. | true
| `azure.tenant` | A specific tenant to sign in to. The default is to sign in to the common tenant and use all known tenants. |
| `azure.cloud` | The current Azure Cloud to connect to. | Azure
| `azure.ppe` | Development setting: The PPE environment for testing. |
<!-- region exclude-from-marketplace -->
## Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
<!-- endregion exclude-from-marketplace -->
## Telemetry
VS Code collects usage data and sends it to Microsoft to help improve our products and services. Read our [privacy statement](https://go.microsoft.com/fwlink/?LinkID=528096&clcid=0x409) to learn more. If you dont wish to send usage data to Microsoft, you can set the `telemetry.enableTelemetry` setting to `false`. Learn more in our [FAQ](https://go.microsoft.com/fwlink/?linkid=870136).
## License
[MIT](LICENSE.md)
The Visual Studio Code logo is under the [license](https://code.visualstudio.com/license) of the Visual Studio Code product.