You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/artifacts/how-to/delete-and-recover-packages.md
+73-71
Original file line number
Diff line number
Diff line change
@@ -28,38 +28,67 @@ In this article, you'll learn how to:
28
28
29
29
## Delete packages
30
30
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.
32
39
33
40
::: moniker range=">= azure-devops-2019"
34
41
35
42
1. Select **Artifacts**, and then select your feed.
36
43
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.":::
38
47
39
48
::: moniker-end
40
49
41
50
::: moniker range="tfs-2018"
42
51
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**.
46
53
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.
48
55
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**.
50
57
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.":::
52
59
53
60
::: moniker-end
54
61
55
-
#### [npm](#tab/npm/)
62
+
###Unlist a NuGet package by using NuGet.exe
56
63
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**.
58
65
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"
61
67
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.
> 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).
63
92
64
93
> [!NOTE]
65
94
> 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
105
134
> [!NOTE]
106
135
> 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.
107
136
108
-
#### [NuGet](#tab/nuget/)
109
-
110
-
Two options are available to delete a NuGet package from your feed:
137
+
#### [Python](#tab/python/)
111
138
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 thenselectyour feed.
114
140
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 thenselect**Delete latest**.
116
142
117
143
> [!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/)
119
149
120
150
::: moniker range=">= azure-devops-2019"
121
151
122
152
1. Select **Artifacts**, and thenselectyour feed.
123
153
124
-
1. Select the package that you want to delete or deprecate, and thenselect**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 thenselect**Delete latest**. Select **Delete** to confirm.
127
155
128
156
::: moniker-end
129
157
130
158
::: moniker range="tfs-2018"
131
159
132
-
1. Select **Build and Release**.
160
+
1. Select **Build and Release**, and thenselect**Packages**.
133
161
134
-
1. Select **Packages**, and thenselectthe package that you want to delete.
162
+
1. Select your feed, and thenselectthe package that you want to delete.
135
163
136
-
1. Select **Unlist**or **Delete latest**.
164
+
1. Select **Delete latest**to delete the latest version of your package.
137
165
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.":::
139
167
140
168
::: moniker-end
141
169
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.
> 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 thenselectyour feed.
172
-
173
-
1. Select the package that you want to delete, and thenselect**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
-
180
170
#### [Universal Package](#tab/universal/)
181
171
182
172
1. Select **Artifacts**, and thenselectyour feed.
@@ -251,12 +241,6 @@ To configure retention policies:
251
241
> - The number of published versions reaches the **Maximum number of versions per package** limit.
252
242
> - A version of that package has not been downloaded for the period defined in **Days to keep recently downloaded packages**.
253
243
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
-
260
244
## Recover deleted packages
261
245
262
246
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
295
279
296
280
::: moniker-end
297
281
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.
Copy file name to clipboardExpand all lines: docs/artifacts/quickstarts/universal-packages.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ ms.date: 02/15/2022
8
8
monikerRange: 'azure-devops'
9
9
---
10
10
11
-
# Publish and download universal packages with Azure CLI
11
+
# Publish and download universal packages with Azure Artifacts
12
12
13
13
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.
0 commit comments