Artifact Details - Get Packages

服務:
Artifacts
API 版本:
7.1

取得摘要中所有套件的詳細數據。 使用各種篩選來包含或排除結果集中的資訊。

如果在專案中建立摘要，則必須提供項目參數。 如果摘要未與任何專案相關聯，請省略要求中的項目參數。

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?api-version=7.1
含選擇性參數: 
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?protocolType={protocolType}&packageNameQuery={packageNameQuery}&normalizedPackageName={normalizedPackageName}&includeUrls={includeUrls}&includeAllVersions={includeAllVersions}&isListed={isListed}&getTopPackageVersions={getTopPackageVersions}&isRelease={isRelease}&includeDescription={includeDescription}&$top={$top}&$skip={$skip}&includeDeleted={includeDeleted}&isCached={isCached}&directUpstreamId={directUpstreamId}&api-version=7.1

URI 參數

名稱 位於 必要 類型 Description
feedId
 path True

string

摘要的名稱或識別碼。
organization
 path True

string

Azure DevOps 組織的名稱。
project
 path

string

項目識別碼或項目名稱
api-version
 query True

string

要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。
$skip
 query

integer (int32)

略過前 N 個套件（或 getTopPackageVersions=true 的套件版本）
$top
 query

integer (int32)

取得前 N 個套件（或 getTopPackageVersions=true 的套件版本）
directUpstreamId
 query

string (uuid)

篩選結果以從特定上游傳回套件。
getTopPackageVersions
 query

boolean

變更$top和$skip的行為，以傳回每個套件的所有版本，最多$top。 必須與 includeAllVersions=true 搭配使用
includeAllVersions
 query

boolean

True 是表示 傳回回應中封裝的所有版本。 默認值為 false（僅限最新版本）。
includeDeleted
 query

boolean

在回應中傳回已刪除或未發佈的套件版本。 預設值為 False。
includeDescription
 query

boolean

傳回回應中每個套件每個版本的描述。 預設值為 False。
includeUrls
 query

boolean

True 是表示 傳回回應的 REST URL。 預設值為 True。
isCached
 query

boolean

[已過時]用於舊版案例，未來版本可能會移除。
isListed
 query

boolean

僅適用於 NuGet 套件，將它設定為其他套件類型會導致 404。 如果為 false，則會傳回已取消列出的套件版本。 當 includeAllVersions 設定為 true 時，請使用此選項來篩選回應。 預設值為 unset （請勿傳回已取消列出的套件）。
isRelease
 query

boolean

僅適用於 Nuget 套件。 當 includeAllVersions 設定為 true 時，請使用此選項來篩選回應。 默認值為 True（僅傳回沒有發行前版本版本的套件）。
normalizedPackageName
 query

string

[已過時]用於舊版案例，未來版本可能會移除。
packageNameQuery
 query

string

篩選為包含所提供字串的套件。 字串中的字元必須符合套件名稱條件約束。
protocolType
 query

string

其中一個支援的成品套件類型。

回應

名稱 類型 Description
200 OK

Package[]

成功作業

安全性

oauth2

類型: oauth2
Flow: 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

範圍

名稱 Description
vso.packaging 授與讀取摘要和套件的能力。 同時授與搜尋套件的能力。

定義

名稱 Description
FeedView

摘要頂端的檢視。
FeedViewType

檢視的類型。
FeedVisibility

檢視的可見性狀態。
MinimalPackageVersion

任何套件的核心數據，包括其標識碼和版本資訊和基本狀態。
Package

封裝，這是一或多個套件版本的容器。
ReferenceLinks

表示 REST 參考連結集合的類別。

FeedView

Object

摘要頂端的檢視。

名稱 類型 Description
_links

ReferenceLinks

相關的 REST 連結。
id

string (uuid)

檢視的標識碼。
name

string

檢視的名稱。
type

FeedViewType

檢視的類型。
url

string

檢視的 URL。
visibility

FeedVisibility

檢視的可見性狀態。

FeedViewType

列舉型別

檢視的類型。

值 Description
none

預設、未指定的檢視類型。
release

用來分類已發行成品的升階目的地檢視。
implicit

系統自動建立和管理的內部檢視類型。

FeedVisibility

列舉型別

檢視的可見性狀態。

值 Description
private

只有摘要管理員明確設定的許可權才能存取。
collection

摘要可供存在於摘要所在組織中的所有有效使用者存取（例如，跨組織 'myorg' 在 'dev.azure.com/myorg' ）
organization

摘要可供存在於摘要所在企業中的所有有效使用者存取。 請注意，舊版命名和備份相容性會讓此值的名稱與其新意義不同步。
aadTenant

摘要可供存在於 Azure Active Directory 租使用者中的所有有效使用者存取。

MinimalPackageVersion

Object

任何套件的核心數據，包括其標識碼和版本資訊和基本狀態。

名稱 類型 Description
directUpstreamSourceId

string (uuid)

此套件是從上游來源擷取的。
id

string (uuid)

封裝的標識碼。
isCachedVersion

boolean

[已過時]用於舊版案例，未來版本可能會移除。
isDeleted

boolean

True 是表示 如果此套件已刪除。
isLatest

boolean

如果這是套件類型排序順序的最新版本套件，則為 True。
isListed

boolean

（僅限 NuGet 和貨物）如果列出此套件，則為 True。
normalizedVersion

string

使用封裝類型特定的正規化規則正規化版本。
packageDescription

string

套件描述。
publishDate

string (date-time)

UTC 套件發佈至服務日期。
storageId

string

內部記憶體標識碼。
version

string

顯示版本。
views

FeedView[]

包含此套件版本的檢視清單。

Package

Object

封裝，這是一或多個套件版本的容器。

名稱 類型 Description
_links

ReferenceLinks

相關的 REST 連結。
id

string (uuid)

封裝的標識碼。
isCached

boolean

用於舊版案例，未來版本可能會移除。
name

string

封裝的顯示名稱。
normalizedName

string

標準化名稱，表示此套件在其套件類型內的身分識別。
protocolType

string

封裝的類型。
starCount

integer (int32)

[已過時] - 此字段未使用，未來版本將會移除。
url

string

此套件的 URL。
versions

MinimalPackageVersion[]

此套件在其摘要內的所有版本。
Object

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的只讀檢視。 因為參考連結是只讀的，所以我們只想要將其公開為只讀。