Npm - Update Recycle Bin Packages

从回收站中删除或还原多个包版本。

如果源是在项目中创建的,则必须提供项目参数。 如果源未与任何项目关联,请从请求中省略项目参数。

POST https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/npm/RecycleBin/PackagesBatch?api-version=7.1-preview.1

URI 参数

名称 必需 类型 说明
feedId
path True

string

源的名称或 ID。

organization
path True

string

Azure DevOps 组织的名称。

project
path

string

项目 ID 或项目名称

api-version
query True

string

要使用的 API 版本。 这应设置为“7.1-preview.1”才能使用此版本的 API。

请求正文

名称 类型 说明
data

BatchOperationData

执行操作所需的数据。 根据操作类型,这是可选的。 如果执行升级操作,请使用 BatchPromoteData。

operation

NpmBatchOperationType

需要对包执行的操作的类型。

packages

MinimalPackageDetails[]

将对其执行操作的包。

响应

名称 类型 说明
200 OK

成功的操作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称 说明
vso.packaging_write 授予创建和读取源和包的能力。

定义

名称 说明
BatchOperationData

请勿尝试使用此类型创建新的 BatchOperationData。 此类型不包含足够的字段来创建新的批处理操作数据。

MinimalPackageDetails

标识协议中的包所需的最小包详细信息。

NpmBatchOperationType

需要对包执行的操作的类型。

NpmPackagesBatchRequest

要应用于包版本的一批操作。

BatchOperationData

请勿尝试使用此类型创建新的 BatchOperationData。 此类型不包含足够的字段来创建新的批处理操作数据。

MinimalPackageDetails

标识协议中的包所需的最小包详细信息。

名称 类型 说明
id

string

包名称。

version

string

包版本。

NpmBatchOperationType

需要对包执行的操作的类型。

说明
delete

删除包版本 (等效于取消发布) 。 在回收站中不受支持。

deprecate

弃用或取消弃用包版本。 在回收站中不受支持。

permanentDelete

永久删除包版本。 仅在回收站中受支持。

promote

将包版本提升到发布视图。 如果使用此类型构造 NpmPackagesBatchRequest 对象,请使用 BatchPromoteData 作为其 Data 属性。 在回收站中不受支持。

restoreToFeed

将未发布的包版本还原到源。 仅在回收站中受支持。

unpublish

取消发布包版本。 删除操作的 Npm 特定别名。 在回收站中不受支持。

NpmPackagesBatchRequest

要应用于包版本的一批操作。

名称 类型 说明
data

BatchOperationData

执行操作所需的数据。 根据操作类型,这是可选的。 如果执行升级操作,请使用 BatchPromoteData。

operation

NpmBatchOperationType

需要对包执行的操作的类型。

packages

MinimalPackageDetails[]

将对其执行操作的包。