Maven - Update Package Versions

Service:

Artifacts Package Types

API Version:

7.1-preview.1

在单个请求中更新单个源中的多个包。 对包的更新不会以原子方式发生。

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

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

URI 参数

名称	在	必需	类型	说明
feedId	path	True	string	包含要更新的包的源。
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	MavenBatchOperationType	需要对包执行的操作的类型。
packages	MavenMinimalPackageDetails[]	要对其执行操作的包。

响应

名称	类型	说明
200 OK		成功的操作

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

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

定义

名称	说明
BatchOperationData	请勿尝试使用此类型创建新的 BatchOperationData。 此类型不包含足够的字段来创建新的批处理操作数据。
MavenBatchOperationType	需要对包执行的操作的类型。
MavenMinimalPackageDetails	标识特定的 Maven 包版本
MavenPackagesBatchRequest	要应用于包版本的一批操作。

BatchOperationData

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

MavenBatchOperationType

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

名称	类型	说明
delete	string	删除包版本。 回收站不支持。
permanentDelete	string	永久删除包版本。 仅在回收站中受支持。
promote	string	将包版本提升到发布视图。 如果使用此类型构造 MavenPackagesBatchRequest 对象，请使用 BatchPromoteData 作为其 Data 属性。 回收站不支持。
restoreToFeed	string	将未发布的包版本还原到源。 仅在回收站中受支持。

MavenMinimalPackageDetails

标识特定的 Maven 包版本

名称	类型	说明
artifact	string	包项目 ID
group	string	包组 ID
version	string	包版本

MavenPackagesBatchRequest

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

名称	类型	说明
data	BatchOperationData	执行操作所需的数据。 根据操作类型，这是可选的。 如果执行升级操作，请使用 BatchPromoteData。
operation	MavenBatchOperationType	需要对包执行的操作的类型。
packages	MavenMinimalPackageDetails[]	要对其执行操作的包。