Artifact Details - Get Package Version
获取有关特定包版本的详细信息。
如果在项目中创建了源，则必须提供项目参数。 如果源未与任何项目关联，请从请求中省略项目参数。
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/Packages/{packageId}/versions/{packageVersionId}?api-version=7.1GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/Packages/{packageId}/versions/{packageVersionId}?includeUrls={includeUrls}&isListed={isListed}&isDeleted={isDeleted}&api-version=7.1URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
feed
|
path | True |
string |
源的名称或 ID。 |
|
organization
|
path | True |
string |
Azure DevOps 组织的名称。 |
|
package
|
path | True |
string |
包的 ID（GUID ID，而不是名称）。 |
|
package
|
path | True |
string |
包版本的 ID（GUID ID，而不是名称）。 |
|
project
|
path |
string |
项目 ID 或项目名称 |
|
|
api-version
|
query | True |
string |
要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。 |
|
include
|
query |
boolean |
如果包含每个版本的 URL，则为 True。 默认值为 true。 |
|
|
is
|
query |
boolean |
对于返回的其他版本，这对请求的包版本没有任何影响，指定是在响应中仅返回已删除或未删除的包版本。 默认值为未设置（返回所有版本）。 |
|
|
is
|
query |
boolean |
仅适用于 NuGet 包。 如果为 false，将返回已取消列出的包版本。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 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 | 授予读取源和包的能力。 此外，还授予搜索包的功能。 |
定义
| 名称 | 说明 |
|---|---|
|
Feed |
源顶部的视图。 |
|
Feed |
视图的类型。 |
|
Feed |
视图的可见性状态。 |
|
Minimal |
有关任何包的核心数据，包括其 ID 和版本信息和基本状态。 |
|
Package |
另一个包版本的依赖项。 |
|
Package |
特定包版本的包文件，仅与每个版本包含多个文件的包类型相关。 |
|
Package |
包的特定版本。 |
|
Protocol |
特定包类型的扩展元数据。 |
|
Reference |
表示 REST 引用链接集合的类。 |
|
Upstream |
上游源定义，包括其标识、包类型和其他相关信息。 |
|
Upstream |
源类型，例如“公共”或“内部”。 |
|
Upstream |
指定上游的状态。 |
|
Upstream |
FeedView
源顶部的视图。
| 名称 | 类型 | 说明 |
|---|---|---|
| _links |
相关的 REST 链接。 |
|
| id |
string (uuid) |
视图的 ID。 |
| name |
string |
视图的名称。 |
| type |
视图的类型。 |
|
| url |
string |
视图的 URL。 |
| visibility |
视图的可见性状态。 |
FeedViewType
视图的类型。
| 值 | 说明 |
|---|---|
| implicit |
系统自动创建和管理的内部视图类型。 |
| none |
默认的未指定视图类型。 |
| release |
用作促销目标的视图，用于对已发布的项目进行分类。 |
FeedVisibility
视图的可见性状态。
| 值 | 说明 |
|---|---|
| aadTenant |
源可供 Azure Active Directory 租户中的所有有效用户访问。 |
| collection |
源可供源所在组织中的所有有效用户访问（例如，跨组织“myorg”位于“dev.azure.com/myorg”） |
| organization |
源可供源所在的企业中的所有有效用户访问。 请注意，旧命名和后退兼容性使此值的名称与新含义不同步。 |
| private |
只有源管理员显式设置的权限才能访问。 |
MinimalPackageVersion
有关任何包的核心数据，包括其 ID 和版本信息和基本状态。
| 名称 | 类型 | 说明 |
|---|---|---|
| directUpstreamSourceId |
string (uuid) |
从中引入此包的上游源。 |
| id |
string (uuid) |
包的 ID。 |
| isCachedVersion |
boolean |
[已过时]用于旧方案，并可能在将来的版本中删除。 |
| isDeleted |
boolean |
如此 如果此包已被删除。 |
| isLatest |
boolean |
如此 如果这是包的最新版本按包类型排序顺序。 |
| isListed |
boolean |
（仅限 NuGet 和 Cargo）如此 如果列出此包。 |
| normalizedVersion |
string |
使用特定于包类型的规范化规则规范化版本。 |
| packageDescription |
string |
包说明。 |
| publishDate |
string (date-time) |
包发布到服务的 UTC 日期。 |
| storageId |
string |
内部存储 ID。 |
| version |
string |
显示版本。 |
| views |
Feed |
包含此包版本的视图列表。 |
PackageDependency
另一个包版本的依赖项。
| 名称 | 类型 | 说明 |
|---|---|---|
| group |
string |
依赖项包组（某些包类型中的可选分类）。 |
| packageName |
string |
依赖项包名称。 |
| versionRange |
string |
依赖项包版本范围。 |
PackageFile
特定包版本的包文件，仅与每个版本包含多个文件的包类型相关。
| 名称 | 类型 | 说明 |
|---|---|---|
| children |
文件的分层表示形式。 |
|
| name |
string |
文件名。 |
| protocolMetadata |
特定于特定包类型的扩展数据。 |
PackageVersion
包的特定版本。
| 名称 | 类型 | 说明 |
|---|---|---|
| _links |
相关链接 |
|
| author |
string |
包版本作者。 |
| deletedDate |
string (date-time) |
删除此包版本的 UTC 日期。 |
| dependencies |
此包版本的依赖项列表。 |
|
| description |
string |
包版本说明。 |
| directUpstreamSourceId |
string (uuid) |
从中引入此包的上游源。 |
| files |
与此包版本关联的文件，仅与多文件包类型相关。 |
|
| id |
string (uuid) |
包的 ID。 |
| isCachedVersion |
boolean |
[已过时]用于旧方案，并可能在将来的版本中删除。 |
| isDeleted |
boolean |
如此 如果此包已被删除。 |
| isLatest |
boolean |
如此 如果这是包的最新版本按包类型排序顺序。 |
| isListed |
boolean |
（仅限 NuGet 和 Cargo）如此 如果列出此包。 |
| normalizedVersion |
string |
使用特定于包类型的规范化规则规范化版本。 |
| otherVersions |
此包的其他版本。 |
|
| packageDescription |
string |
包说明。 |
| protocolMetadata |
特定于包类型的扩展数据。 |
|
| publishDate |
string (date-time) |
包发布到服务的 UTC 日期。 |
| sourceChain |
包版本移动到此源中的上游源列表。 |
|
| storageId |
string |
内部存储 ID。 |
| summary |
string |
包版本摘要。 |
| tags |
string[] |
包版本标记。 |
| url |
string |
包版本 URL。 |
| version |
string |
显示版本。 |
| views |
Feed |
包含此包版本的视图列表。 |
ProtocolMetadata
特定包类型的扩展元数据。
| 名称 | 类型 | 说明 |
|---|---|---|
| data |
object |
特定包类型的扩展元数据，格式设置为关联的架构版本定义。 |
| schemaVersion |
integer (int32) |
架构版本。 |
ReferenceLinks
表示 REST 引用链接集合的类。
| 名称 | 类型 | 说明 |
|---|---|---|
| links |
object |
链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读链接。 |
UpstreamSource
上游源定义，包括其标识、包类型和其他相关信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| deletedDate |
string (date-time) |
删除此上游的 UTC 日期。 |
| displayLocation |
string |
用于以用户友好格式连接到上游源的定位符，这可能会随时间而变化 |
| id |
string (uuid) |
上游源的标识。 |
| internalUpstreamCollectionId |
string (uuid) |
对于内部上游类型，跟踪包含它的 Azure DevOps 组织。 |
| internalUpstreamFeedId |
string (uuid) |
对于内部上游类型，跟踪所引用的源 ID。 |
| internalUpstreamProjectId |
string (uuid) |
对于内部上游类型，跟踪所引用的源的项目。 |
| internalUpstreamViewId |
string (uuid) |
对于内部上游类型，跟踪所引用的源的视图。 |
| location |
string |
用于连接到上游源的一致定位符。 |
| name |
string |
显示名称。 |
| protocol |
string |
与上游源关联的包类型。 |
| serviceEndpointId |
string (uuid) |
用于保存访问上游时要使用的凭据的服务终结点的标识。 |
| serviceEndpointProjectId |
string (uuid) |
指定服务终结点的 projectId。 |
| status |
指定上游的状态。 |
|
| statusDetails |
提供上游状态的可读原因。 |
|
| upstreamSourceType |
源类型，例如“公共”或“内部”。 |
UpstreamSourceType
源类型，例如“公共”或“内部”。
| 值 | 说明 |
|---|---|
| internal |
Azure DevOps 上游源。 |
| public |
公开可用的源。 |
UpstreamStatus
指定上游的状态。
| 值 | 说明 |
|---|---|
| disabled |
上游源已禁用。 |
| ok |
上游源正常。 |
UpstreamStatusDetail
| 名称 | 类型 | 说明 |
|---|---|---|
| reason |
string |
提供上游状态的可读原因。 |