Skip to content

Commit 567b99b

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-devops-docs-pr into 2032544
2 parents 83aae9c + 247324c commit 567b99b

File tree

5 files changed

+91
-86
lines changed

5 files changed

+91
-86
lines changed

docs/artifacts/how-to/delete-and-recover-packages.md

+73-71
Original file line numberDiff line numberDiff line change
@@ -28,38 +28,67 @@ In this article, you'll learn how to:
2828
2929
## Delete packages
3030

31-
#### [Maven](#tab/maven/)
31+
In Azure Artifacts, packages are immutable. When you publish a package to your feed, its version number will be reserved permanently. You can't upload a new package with that same version number, even if you delete it from your feed.
32+
33+
#### [NuGet](#tab/nuget/)
34+
35+
Two options are available to delete a NuGet package from your feed, [Unlist](#qa) and [Delete](#qa).
36+
37+
> [!NOTE]
38+
> You must be a **Contributor** to unlist a package and an **Owner** to delete it.
3239
3340
::: moniker range=">= azure-devops-2019"
3441

3542
1. Select **Artifacts**, and then select your feed.
3643

37-
1. Select the package that you want to delete, and then select **Delete latest**. Select **Delete** to confirm.
44+
1. Select the package that you want to delete or deprecate, and then select **Unlist** or **Delete latest**.
45+
46+
:::image type="content" source="../media/delete/unlist-delete-nuget-package-newnav.png" alt-text="Screenshot that shows buttons for unlisting and deleting NuGet packages.":::
3847

3948
::: moniker-end
4049

4150
::: moniker range="tfs-2018"
4251

43-
1. Select **Build and Release**, and then select **Packages**.
44-
45-
1. Select your feed, and then select the package that you want to delete.
52+
1. Select **Build and Release**.
4653

47-
1. Select **Delete latest** to delete the latest version of your package.
54+
1. Select **Packages**, and then select the package that you want to delete.
4855

49-
:::image type="content" source="../media/delete/delete-maven-package.png" alt-text="Screenshot that shows the button to delete packages from feeds.":::
56+
1. Select **Unlist** or **Delete latest**.
5057

51-
In Azure Artifacts, packages are immutable. When you publish a package to your feed, its version number will be reserved permanently. You can't upload a new package with that same version number, even if you delete it from your feed.
58+
:::image type="content" source="../media/delete/unlist-delete-nuget-package.png" alt-text="Screenshot that shows the buttons for unlisting and deleting NuGet packages in Team Foundation Server.":::
5259

5360
::: moniker-end
5461

55-
#### [npm](#tab/npm/)
62+
### Unlist a NuGet package by using NuGet.exe
5663

57-
There are two options to delete an npm package from your feed:
64+
1. Select **Artifacts**, and then go to your feed. Select **Connect to feed**.
5865

59-
- **Deprecate**: When you deprecate a package version, a warning message is added to the package's metadata. Azure Artifacts and most npm clients will display the warning message whenever the package is viewed or installed.
60-
- **Unpublish**: Unpublishing a package version makes it unavailable to install. Unpublished packages can be restored from the Recycle Bin within 30 days of deletion. After that, the packages will be permanently deleted.
66+
::: moniker range=">= azure-devops-2019"
6167

62-
In Azure Artifacts, packages are immutable. When you publish a package to your feed, its version number will be reserved permanently. You can't upload a new package with that same version number, even if you delete it from your feed.
68+
:::image type="content" source="../media/connect-to-feed-azure-devops-newnav.png" alt-text="Screenshot that shows the button for connecting to a feed.":::
69+
70+
::: moniker-end
71+
72+
::: moniker range="tfs-2018"
73+
74+
:::image type="content" source="../media/connect-to-feed.png" alt-text="Screenshot that shows the button for connecting to a feed in Team Foundation Server.":::
75+
76+
::: moniker-end
77+
78+
2. Select **NuGet.exe**, and then find and copy your **Package Source** URL.
79+
80+
3. Run the following command:
81+
82+
```Command
83+
nuget.exe delete <PACKAGE_NAME> <PACKAGE_VERSION> -Source <PACKAGE_SOURCE_URL> -ApiKey <KEY>
84+
```
85+
86+
> [!NOTE]
87+
> Azure DevOps and Visual Studio Team Foundation Server interpret the `nuget.exe delete` command as an unlist operation. To delete a package, you must use the REST API or the web interface.
88+
89+
#### [npm](#tab/npm/)
90+
91+
There are two options to delete an npm package from your feed, [Deprecate](#qa) and [Unpublish](#qa).
6392

6493
> [!NOTE]
6594
> You must be a **Contributor** to deprecate a package and an **Owner** to unpublish it.
@@ -105,78 +134,39 @@ In Azure Artifacts, packages are immutable. When you publish a package to your f
105134
> [!NOTE]
106135
> The `npm unpublish` command won't unpublish all versions of the package. For more information, see the [deprecate](https://docs.npmjs.com/cli/deprecate) or [unpublish](https://docs.npmjs.com/cli/unpublish) documentation.
107136

108-
#### [NuGet](#tab/nuget/)
109-
110-
Two options are available to delete a NuGet package from your feed:
137+
#### [Python](#tab/python/)
111138

112-
- **Unlist**: Unlisting a package version hides it from the search results in Azure Artifacts feeds and on NuGet.org.
113-
- **Delete**: Deleting a package version makes it unavailable to install. Deleted packages can be restored from the Recycle Bin within 30 days of deletion. After that, the packages will be permanently deleted.
139+
1. Select **Artifacts**, and then select your feed.
114140

115-
In Azure Artifacts, packages are immutable. When you publish a package to your feed, its version number will be reserved permanently. You can't upload a new package with that same version number, even if you delete it from your feed.
141+
1. Select the package that you want to delete, and then select **Delete latest**.
116142

117143
> [!NOTE]
118-
> You must be a **Contributor** to unlist a package and an **Owner** to delete it.
144+
> You must be a feed **Owner** to delete a Python package.
145+
146+
:::image type="content" source="../media/delete/delete-python-package.png" alt-text="Screenshot that shows the button for deleting a package in Python.":::
147+
148+
#### [Maven](#tab/maven/)
119149

120150
::: moniker range=">= azure-devops-2019"
121151

122152
1. Select **Artifacts**, and then select your feed.
123153

124-
1. Select the package that you want to delete or deprecate, and then select **Unlist** or **Delete latest**.
125-
126-
:::image type="content" source="../media/delete/unlist-delete-nuget-package-newnav.png" alt-text="Screenshot that shows buttons for unlisting and deleting NuGet packages.":::
154+
1. Select the package that you want to delete, and then select **Delete latest**. Select **Delete** to confirm.
127155

128156
::: moniker-end
129157

130158
::: moniker range="tfs-2018"
131159

132-
1. Select **Build and Release**.
160+
1. Select **Build and Release**, and then select **Packages**.
133161

134-
1. Select **Packages**, and then select the package that you want to delete.
162+
1. Select your feed, and then select the package that you want to delete.
135163

136-
1. Select **Unlist** or **Delete latest**.
164+
1. Select **Delete latest** to delete the latest version of your package.
137165

138-
:::image type="content" source="../media/delete/unlist-delete-nuget-package.png" alt-text="Screenshot that shows the buttons for unlisting and deleting NuGet packages in Team Foundation Server.":::
166+
:::image type="content" source="../media/delete/delete-maven-package.png" alt-text="Screenshot that shows the button to delete packages from feeds.":::
139167

140168
::: moniker-end
141169

142-
### Unlist a NuGet package by using NuGet.exe
143-
144-
1. Select **Artifacts**, and then go to your feed. Select **Connect to feed**.
145-
146-
::: moniker range=">= azure-devops-2019"
147-
148-
:::image type="content" source="../media/connect-to-feed-azure-devops-newnav.png" alt-text="Screenshot that shows the button for connecting to a feed.":::
149-
150-
::: moniker-end
151-
152-
::: moniker range="tfs-2018"
153-
154-
:::image type="content" source="../media/connect-to-feed.png" alt-text="Screenshot that shows the button for connecting to a feed in Team Foundation Server.":::
155-
156-
::: moniker-end
157-
158-
2. Select **NuGet.exe**, and then find and copy your **Package Source** URL.
159-
160-
3. Run the following command:
161-
162-
```Command
163-
nuget.exe delete <PACKAGE_NAME> <PACKAGE_VERSION> -Source <PACKAGE_SOURCE_URL> -ApiKey <KEY>
164-
```
165-
166-
> [!NOTE]
167-
> Azure DevOps and Visual Studio Team Foundation Server interpret the `nuget.exe delete` command as an unlist operation. To delete a package, you must use the REST API or the web interface.
168-
169-
#### [Python](#tab/python/)
170-
171-
1. Select **Artifacts**, and then select your feed.
172-
173-
1. Select the package that you want to delete, and then select **Delete latest**.
174-
175-
> [!NOTE]
176-
> You must be a feed **Owner** to delete a Python package.
177-
178-
:::image type="content" source="../media/delete/delete-python-package.png" alt-text="Screenshot that shows the button for deleting a package in Python.":::
179-
180170
#### [Universal Package](#tab/universal/)
181171

182172
1. Select **Artifacts**, and then select your feed.
@@ -251,12 +241,6 @@ To configure retention policies:
251241
> - The number of published versions reaches the **Maximum number of versions per package** limit.
252242
> - A version of that package has not been downloaded for the period defined in **Days to keep recently downloaded packages**.
253243
254-
### What happens with old or existing packages when we enable retention policies?
255-
256-
Old or existing packages will be soft-deleted and moved to the Recycle Bin. The deletion job runs once a day, but there might be an initial delay after the policy is turned on for the first time because of an influx of packages.
257-
258-
Packages remain in the Recycle Bin for 30 days before they're permanently deleted. To remove the packages from your billable storage, you can choose to delete them manually by using the UI or the REST API before the 30 days are up.
259-
260244
## Recover deleted packages
261245
262246
Deleted packages will remain in the Recycle Bin for 30 days. After that, they'll be permanently deleted. You must be a feed **Owner** to recover deleted packages.
@@ -295,6 +279,24 @@ Deleted packages will remain in the Recycle Bin for 30 days. After that, they'll
295279
296280
::: moniker-end
297281
282+
## Q&A
283+
284+
### Q: What is the difference between *Deprecate*, *Unpublish*, *Unlist*, and *Delete* a package version?
285+
286+
A: *Unpublish* and *Deprecate* applies to npm packages, while *Unlist* and *Delete* applies to NuGet packages. You can also *Delete* package versions for the rest of the package types (Maven, Python, and Universal Packages):
287+
288+
- **Deprecate** (npm): When you deprecate a package version, a warning message is added to the package's metadata. Azure Artifacts and most npm clients will display the warning message whenever the package is viewed or installed.
289+
- **Unpublish** (npm): Unpublishing a package version makes it unavailable to install. Unpublished packages can be restored from the Recycle Bin within 30 days of deletion. After that, the packages will be permanently deleted.
290+
291+
- **Unlist** (NuGet): Unlisting a package version hides it from the search results in Azure Artifacts feeds and on NuGet.org.
292+
- **Delete**: Deleting a package version makes it unavailable to install. Deleted packages can be restored from the Recycle Bin within 30 days of deletion. After that, the packages will be permanently deleted.
293+
294+
### Q: What happens with old or existing packages when we enable retention policies?
295+
296+
A: Old or existing packages will be soft-deleted and moved to the Recycle Bin. The deletion job runs once a day, but there might be an initial delay after the policy is turned on for the first time because of an influx of packages.
297+
298+
Packages remain in the Recycle Bin for 30 days before they're permanently deleted. To remove the packages from your billable storage, you can choose to delete them manually by using the UI or the REST API before the 30 days are up.
299+
298300
## Related articles
299301
300302
- [Understand upstream sources](../concepts/upstream-sources.md)

docs/artifacts/quickstarts/universal-packages.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.date: 02/15/2022
88
monikerRange: 'azure-devops'
99
---
1010

11-
# Publish and download universal packages with Azure CLI
11+
# Publish and download universal packages with Azure Artifacts
1212

1313
With universal packages, you can store different types of packages other than the widely used ones such as NuGet, npm, Maven, or Python packages. Using Azure CLI, you can publish and download universal packages from the command line. Uploaded packages can vary in size (up to 4 TB), but should always have a name and a version number. This article will walk you through the steps to publish and download your universal packages to Azure Artifacts feeds.
1414

docs/boards/backlogs/office/track-work.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -223,16 +223,16 @@ This connection method requires that you have installed [Azure DevOps Open in Ex
223223
>
224224
>
225225
>
226-
> ![Open Boards Queries, vertical nav](/docs/boards/queries/media/view-run-queries/open-queries-vert.png)
226+
> ![Open Boards Queries, vertical nav](../../queries/media/view-run-queries/open-queries-vert.png)
227227
228228
1. Choose the query you want to open in Excel.
229229

230-
1. From the **Results** tab, choose the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon
230+
1. From the **Results** tab, choose the :::image type="icon" source="../../../media/icons/actions-icon.png" border="false"::: actions icon.
231231
> [!div class="mx-imgBorder"]
232232
>
233233
>
234234
>
235-
> ![QUery Results, context menu, Open in Excel Open Boards Queries, vertical nav](media/connect/open-in-excel-from-portal.png)
235+
> ![Query Results, context menu, Open in Excel Open Boards Queries, vertical nav](media/connect/open-in-excel-from-portal.png)
236236
237237
### [Connect from client to Azure Boards](#tab/open-excel-cloud)
238238

0 commit comments

Comments
 (0)