Feed Management - Create Feed

服务:

Artifacts

API 版本:

7.1

为各种包类型创建源、容器。

如果请求 URL 中包含项目参数，则可以在项目中创建源。 如果省略项目参数，源将不会与项目关联，并且将在组织级别创建。

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

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path		string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。

请求正文

名称	类型	说明
_links	ReferenceLinks	相关的 REST 链接。
badgesEnabled	boolean	如果已设置，则此源支持生成包锁屏提醒。
capabilities	FeedCapabilities	源支持的功能。
defaultViewId	string (uuid)	源管理员指示的视图是读者的默认体验。
deletedDate	string (date-time)	删除此源的日期。
description	string	源的说明。 说明不得超过 255 个字符。
fullyQualifiedId	string	这可以是源 GUID 或源 GUID，并查看 GUID，具体取决于源的访问方式。
fullyQualifiedName	string	视图的全名，feed@view格式。
hideDeletedPackageVersions	boolean	如果已设置，源将隐藏所有已删除/未发布的版本
id	string (uuid)	唯一标识此源的 GUID。
isReadOnly	boolean	如果已设置，则源中的所有包都是不可变的。 请务必注意源视图是不可变的;因此，始终为视图设置此标志。
name	string	源的名称。 源名称必须遵循以下规则：不得超过 64 个字符， 不得包含空格 不得以下划线开头或句点 不得以句点结尾 不得包含以下任何非法字符：、|、/、\、？、：、&、$、*、\“、#、[、 ]]>
permanentDeletedDate	string (date-time)	永久删除此源的日期。
permissions	FeedPermission[]	源的显式权限。
project	ProjectReference	此源与之关联的项目。
scheduledPermanentDeleteDate	string (date-time)	此源计划永久删除的日期。
upstreamEnabled	boolean	这应始终为 true。 设置为 false 将覆盖 UpstreamSources 中的所有源。
upstreamEnabledChangedDate	string (date-time)	如果已设置，则更改 UpstreamEnabled 属性的时间。 如果在创建源后从未更改 UpstreamEnabled，则为 null。
upstreamSources	UpstreamSource[]	此源将从中提取包的源列表。 空列表指示此源不会搜索包的任何其他源。
url	string	GUID 形式的基源的 URL。
view	FeedView	视图的定义。
viewId	string (uuid)	视图 ID。
viewName	string	查看名称。

响应

名称	类型	说明
200 OK	Feed	成功作

安全性

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	授予创建和读取源和包的能力。

定义

名称	说明
Feed	项目的容器。
FeedCapabilities	源支持的功能。
FeedPermission	源的权限。
FeedRole	源上此标识的角色。
FeedView	源顶部的视图。
FeedViewType	视图的类型。
FeedVisibility	视图的可见性状态。
IdentityDescriptor	标识描述符是标识类型的包装器（Windows SID、Passport），以及唯一标识符，例如 SID 或 PUID。
ProjectReference
ReferenceLinks	表示 REST 引用链接集合的类。
UpstreamSource	上游源定义，包括其标识、包类型和其他相关信息。
UpstreamSourceType	源类型，例如“公共”或“内部”。
UpstreamStatus	指定上游的状态。
UpstreamStatusDetail

Feed

Object

项目的容器。

名称	类型	说明
_links	ReferenceLinks	相关的 REST 链接。
badgesEnabled	boolean	如果已设置，则此源支持生成包锁屏提醒。
capabilities	FeedCapabilities	源支持的功能。
defaultViewId	string (uuid)	源管理员指示的视图是读者的默认体验。
deletedDate	string (date-time)	删除此源的日期。
description	string	源的说明。 说明不得超过 255 个字符。
fullyQualifiedId	string	这可以是源 GUID 或源 GUID，并查看 GUID，具体取决于源的访问方式。
fullyQualifiedName	string	视图的全名，feed@view格式。
hideDeletedPackageVersions	boolean	如果已设置，源将隐藏所有已删除/未发布的版本
id	string (uuid)	唯一标识此源的 GUID。
isReadOnly	boolean	如果已设置，则源中的所有包都是不可变的。 请务必注意源视图是不可变的;因此，始终为视图设置此标志。
name	string	源的名称。 源名称必须遵循以下规则：不得超过 64 个字符， 不得包含空格 不得以下划线开头或句点 不得以句点结尾 不得包含以下任何非法字符：、|、/、\、？、：、&、$、*、\“、#、[、 ]]>
permanentDeletedDate	string (date-time)	永久删除此源的日期。
permissions	FeedPermission[]	源的显式权限。
project	ProjectReference	此源与之关联的项目。
scheduledPermanentDeleteDate	string (date-time)	此源计划永久删除的日期。
upstreamEnabled	boolean	这应始终为 true。 设置为 false 将覆盖 UpstreamSources 中的所有源。
upstreamEnabledChangedDate	string (date-time)	如果已设置，则更改 UpstreamEnabled 属性的时间。 如果在创建源后从未更改 UpstreamEnabled，则为 null。
upstreamSources	UpstreamSource[]	此源将从中提取包的源列表。 空列表指示此源不会搜索包的任何其他源。
url	string	GUID 形式的基源的 URL。
view	FeedView	视图的定义。
viewId	string (uuid)	视图 ID。
viewName	string	查看名称。

FeedCapabilities

枚举

源支持的功能。

值	说明
defaultCapabilities	为新创建的源提供的功能
none	此源不存在任何标志
underMaintenance	此源当前处于维护状态，可能会降低功能
upstreamV2	此源可以为上游源中的包提供服务，上游包必须手动提升为视图

FeedPermission

Object

源的权限。

名称	类型	说明
displayName	string	标识的显示名称。
identityDescriptor	IdentityDescriptor	与此角色关联的标识。
identityId	string (uuid)	与此角色关联的标识的 ID。
isInheritedRole	boolean	指示是继承角色还是直接设置角色的布尔值。
role	FeedRole	源上此标识的角色。

FeedRole

枚举

源上此标识的角色。

值	说明
administrator	管理员完全控制源。
collaborator	协作者具有与读取者相同的权限，但也可以从配置的上游源引入包。
contributor	参与者可以对源中的包执行任何作，包括添加新包，但它们可能不修改源设置。
custom	支持。
none	支持。
reader	读取器只能读取包和查看设置。

FeedView

Object

源顶部的视图。

名称	类型	说明
_links	ReferenceLinks	相关的 REST 链接。
id	string (uuid)	视图的 ID。
name	string	视图的名称。
type	FeedViewType	视图的类型。
url	string	视图的 URL。
visibility	FeedVisibility	视图的可见性状态。

FeedViewType

枚举

视图的类型。

值	说明
implicit	系统自动创建和管理的内部视图类型。
none	默认的未指定视图类型。
release	用作促销目标的视图，用于对已发布的项目进行分类。

FeedVisibility

枚举

视图的可见性状态。

值	说明
aadTenant	源可供 Azure Active Directory 租户中的所有有效用户访问。
collection	源可供源所在组织中的所有有效用户访问（例如，跨组织“myorg”位于“dev.azure.com/myorg”）
organization	源可供源所在的企业中的所有有效用户访问。 请注意，旧命名和后退兼容性使此值的名称与新含义不同步。
private	只有源管理员显式设置的权限才能访问。

IdentityDescriptor

Object

标识描述符是标识类型的包装器（Windows SID、Passport），以及唯一标识符，例如 SID 或 PUID。

名称	类型	说明
identifier	string	此标识的唯一标识符，不超过 256 个字符，这将持久保存。
identityType	string	描述符的类型（例如 Windows、Passport 等）。

ProjectReference

Object

名称	类型	说明
id	string (uuid)	获取或设置项目的 ID。
name	string	获取或设置项目的名称。
visibility	string	获取或设置项目的可见性。

ReferenceLinks

Object

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读链接。

UpstreamSource

Object

上游源定义，包括其标识、包类型和其他相关信息。

名称	类型	说明
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	UpstreamStatus	指定上游的状态。
statusDetails	UpstreamStatusDetail[]	提供上游状态的可读原因。
upstreamSourceType	UpstreamSourceType	源类型，例如“公共”或“内部”。

UpstreamSourceType

枚举

源类型，例如“公共”或“内部”。

值	说明
internal	Azure DevOps 上游源。
public	公开可用的源。

UpstreamStatus

枚举

指定上游的状态。

值	说明
disabled	上游源已禁用。
ok	上游源正常。

UpstreamStatusDetail

Object

名称	类型	说明
reason	string	提供上游状态的可读原因。