共用方式為

Feed Management - Create Feed

  • 參考
Service:
Artifacts
API Version:
5.1-preview.1

建立摘要，這是各種封裝類型的容器。

如果專案參數包含在要求 URL 中，則可以在專案中建立摘要。 如果省略專案參數，摘要將不會與專案相關聯，而且會在組織層級建立。 建立專案範圍的摘要位於發行前版本，且可能尚未在您的組織中提供。

POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=5.1-preview.1

URI 參數

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

string

Azure DevOps 組織的名稱。
project
 path

string

專案識別碼或專案名稱
api-version
 query True

string

要使用的 API 版本。 這應該設定為 '5.1-preview.1' 以使用此版本的 API。

要求本文

名稱 類型 Description
_links

ReferenceLinks

相關的 REST 連結。
badgesEnabled

boolean

如果設定，此摘要支援產生套件徽章。
capabilities

FeedCapabilities

摘要支援的功能。
defaultViewId

string

摘要管理員指出的檢視是讀取器的預設體驗。
deletedDate

string

刪除此摘要的日期。
description

string

摘要的描述。 描述不能超過 255 個字元。
fullyQualifiedId

string

這會是摘要 GUID 或摘要 GUID，並根據摘要的存取方式來檢視 GUID。
fullyQualifiedName

string

檢視的完整名稱，格式為 feed@view。
hideDeletedPackageVersions

boolean

如果設定，摘要將會隱藏所有已刪除/未發佈的版本
id

string

可唯一識別此摘要的 GUID。
isReadOnly

boolean

如果設定，摘要中的所有套件都是不可變的。 請務必注意摘要檢視是不可變的;因此，這個旗標一律會針對檢視設定。
name

string

摘要的名稱。 摘要名稱必須遵循這些規則：不得超過 64 個字元 不得包含空格 符不得以底線開頭，或句點不得以句 號 結尾不得包含下列任何不合法的字元： 、|、/、\\、？、：、&、$、*、\「、#、[、] ]]>
permissions

FeedPermission[]

摘要的明確許可權。
project

ProjectReference

與此摘要相關聯的專案。
upstreamEnabled

boolean

過時：這應該一律成立。 將 設定為 false 將會覆寫 UpstreamSources 中的所有來源。
upstreamEnabledChangedDate

string

如果設定，則變更 UpstreamEnabled 屬性的時間。 如果在建立摘要之後從未變更 UpstreamEnabled，將會是 Null。
upstreamSources

UpstreamSource[]

此摘要會從中擷取套件的來源清單。 空白清單表示此摘要不會搜尋套件的任何其他來源。
url

string

GUID 表單中基底摘要的 URL。
view

FeedView

檢視的定義。
viewId

string

檢視識別碼。
viewName

string

檢視名稱。

回應

名稱 類型 Description
200 OK

Feed

成功的作業

安全性

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

名稱 Description
vso.packaging_write 授與建立和讀取摘要和套件的能力。

定義

名稱 Description
Feed

成品的容器。
FeedCapabilities

摘要支援的功能。
FeedPermission

摘要的許可權。
FeedRole

摘要上此身分識別的角色。
FeedView

摘要頂端的檢視。
FeedViewType

檢視的類型。
FeedVisibility

檢視的可見度狀態。
IdentityDescriptor

身分識別描述元是 Windows SID、Passport) 身分識別 (類型的包裝函式，以及 SID 或 PUID 等唯一識別碼。
ProjectReference
ReferenceLinks

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

上游來源定義，包括其身分識別、套件類型和其他相關聯資訊。
UpstreamSourceType

來源類型，例如公用或內部。

Feed

成品的容器。

名稱 類型 Description
_links

ReferenceLinks

相關的 REST 連結。
badgesEnabled

boolean

如果設定，此摘要支援產生套件徽章。
capabilities

FeedCapabilities

摘要支援的功能。
defaultViewId

string

摘要管理員指出的檢視是讀取器的預設體驗。
deletedDate

string

刪除此摘要的日期。
description

string

摘要的描述。 描述不能超過 255 個字元。
fullyQualifiedId

string

這會是摘要 GUID 或摘要 GUID，並根據摘要的存取方式來檢視 GUID。
fullyQualifiedName

string

檢視的完整名稱，格式為 feed@view。
hideDeletedPackageVersions

boolean

如果設定，摘要將會隱藏所有已刪除/未發佈的版本
id

string

可唯一識別此摘要的 GUID。
isReadOnly

boolean

如果設定，摘要中的所有封裝都是固定的。 請務必注意，摘要檢視是不可變的;因此，一律會針對檢視設定此旗標。
name

string

摘要的名稱。 摘要名稱必須遵循下列規則：不得超過 64 個字元 不得包含空格 符不得以底線開頭，或句點不得以句 點結尾不得包含下列任何不合法的字元： 、|、/、\\、？、：、&、$、*、\「、#、[、] ]]>
permissions

FeedPermission[]

摘要的明確許可權。
project

ProjectReference

與此摘要相關聯的專案。
upstreamEnabled

boolean

過時：這應該一律為 true。 將 設定為 false 將會覆寫 UpstreamSources 中的所有來源。
upstreamEnabledChangedDate

string

如果設定，則變更 UpstreamEnabled 屬性的時間。 如果在建立摘要之後從未變更 UpstreamEnabled，將會是 Null。
upstreamSources

UpstreamSource[]

此摘要將擷取套件的來源清單。 空白清單表示此摘要不會搜尋套件的任何其他來源。
url

string

GUID 表單中基底摘要的 URL。
view

FeedView

檢視的定義。
viewId

string

檢視識別碼。
viewName

string

檢視名稱。

FeedCapabilities

摘要支援的功能。

名稱 類型 Description
defaultCapabilities

string

提供給新建立摘要的功能
none

string

此摘要沒有任何旗標存在
underMaintenance

string

此摘要目前正在維護中，且功能可能降低
upstreamV2

string

此摘要可為上游來源的套件提供服務，上游套件必須手動升級為檢視

FeedPermission

摘要的許可權。

名稱 類型 Description
displayName

string

身分識別的顯示名稱。
identityDescriptor

IdentityDescriptor

與此角色相關聯的身分識別。
identityId

string

與此角色相關聯的身分識別識別碼。
role

FeedRole

摘要上此身分識別的角色。

FeedRole

摘要上此身分識別的角色。

名稱 類型 Description
administrator

string

系統管理員可完全控制摘要。
collaborator

string

共同作業者具有與讀取者相同的許可權，但也可以從已設定的上游來源內嵌套件。
contributor

string

參與者可以對摘要中的套件執行任何動作，包括新增套件，但可能不會修改摘要設定。
custom

string

不支援。
none

string

不支援。
reader

string

讀取器只能讀取套件和檢視設定。

FeedView

摘要頂端的檢視。

名稱 類型 Description
_links

ReferenceLinks

相關的 REST 連結。
id

string

檢視的識別碼。
name

string

檢視表名稱。
type

FeedViewType

檢視的類型。
url

string

檢視的 URL。
visibility

FeedVisibility

檢視的可見度狀態。

FeedViewType

檢視的類型。

名稱 類型 Description
implicit

string

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

string

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

string

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

FeedVisibility

檢視的可見度狀態。

名稱 類型 Description
collection

string

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

organization

string

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

string

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

IdentityDescriptor

身分識別描述元是 Windows SID、Passport) 身分識別 (類型的包裝函式，以及 SID 或 PUID 等唯一識別碼。

名稱 類型 Description
identifier

string

此身分識別的唯一識別碼，不超過 256 個字元，將會保存。
identityType

string

描述項的類型 (例如 Windows、Passport 等) 。

ProjectReference

名稱 類型 Description
id

string

取得或設定專案的識別碼。
name

string

取得或設定專案的名稱。
visibility

string

取得或設定專案的可見度。

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

名稱 類型 Description
links

object

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

UpstreamSource

上游來源定義，包括其身分識別、套件類型和其他相關聯資訊。

名稱 類型 Description
deletedDate

string

刪除此上游的 UTC 日期。
displayLocation

string

以使用者易記格式連線到上游來源的定位器，可能會隨著時間而變更
id

string

上游來源的身分識別。
internalUpstreamCollectionId

string

針對內部上游類型，追蹤包含它的 Azure DevOps 組織。
internalUpstreamFeedId

string

針對內部上游類型，追蹤所參考的摘要識別碼。
internalUpstreamViewId

string

針對內部上游類型，追蹤所參考摘要的檢視。
location

string

連線至上游來源的一致定位器。
name

string

顯示名稱。
protocol

string

與上游來源相關聯的封裝類型。
upstreamSourceType

UpstreamSourceType

來源類型，例如公用或內部。

UpstreamSourceType

來源類型，例如公用或內部。

名稱 類型 Description
internal

string

Azure DevOps 上游來源。
public

string

公開可用的來源。