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

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
project	path		string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 5.1-preview.1.

Текст запроса

Имя	Тип	Описание
_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. Будет иметь значение NULL, если upstreamEnabled не изменялся после создания веб-канала.
upstreamSources	UpstreamSource[]	Список источников, из которые этот веб-канал будет получить пакеты. Пустой список указывает, что этот веб-канал не будет искать пакеты в дополнительных источниках.
url	string	URL-адрес базового веб-канала в форме GUID.
view	FeedView	Определение представления.
viewId	string	Идентификатор представления.
viewName	string	Имя представления.

Ответы

Имя	Тип	Описание
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

Имя	Описание
vso.packaging_write	Предоставляет возможность создавать и читать веб-каналы и пакеты.

Определения

Имя	Описание
Feed	Контейнер для артефактов.
FeedCapabilities	Поддерживаемые возможности веб-канала.
FeedPermission	Разрешения для веб-канала.
FeedRole	Роль для этого удостоверения в веб-канале.
FeedView	Представление поверх веб-канала.
FeedViewType	Тип представления.
FeedVisibility	Состояние видимости представления.
IdentityDescriptor	Дескриптор удостоверения — это оболочка для типа удостоверения (ИД Безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.
ProjectReference
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
UpstreamSource	Вышестоящее определение источника, включая его идентификатор, тип пакета и другие связанные сведения.
UpstreamSourceType	Тип источника, например Public или Internal.

Feed

Контейнер для артефактов.

Имя	Тип	Описание
_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. Будет иметь значение NULL, если upstreamEnabled не изменялся после создания веб-канала.
upstreamSources	UpstreamSource[]	Список источников, из которые этот веб-канал будет получить пакеты. Пустой список указывает, что этот веб-канал не будет искать пакеты в дополнительных источниках.
url	string	URL-адрес базового веб-канала в форме GUID.
view	FeedView	Определение представления.
viewId	string	Идентификатор представления.
viewName	string	Имя представления.

FeedCapabilities

Поддерживаемые возможности веб-канала.

Имя	Тип	Описание
defaultCapabilities	string	Возможности, предоставленные только что созданному веб-каналу
none	string	Флаги для этого веб-канала не существуют
underMaintenance	string	Этот веб-канал в настоящее время находится на обслуживании и может иметь ограниченные функциональные возможности
upstreamV2	string	Этот веб-канал может обслуживать пакеты из вышестоящий источников Вышестоящие пакеты должны быть вручную повышены до представлений

FeedPermission

Разрешения для веб-канала.

Имя	Тип	Описание
displayName	string	Отображаемое имя удостоверения.
identityDescriptor	IdentityDescriptor	Удостоверение, связанное с этой ролью.
identityId	string	Идентификатор удостоверения, связанного с этой ролью.
role	FeedRole	Роль для этого удостоверения в веб-канале.

FeedRole

Роль для этого удостоверения в веб-канале.

Имя	Тип	Описание
administrator	string	Администраторы полностью контролируют веб-канал.
collaborator	string	Участники совместной работы имеют те же разрешения, что и читатели, но также могут принимать пакеты из настроенных вышестоящий источников.
contributor	string	Участники могут выполнять любые действия с пакетами в веб-канале, включая добавление новых пакетов, но не могут изменять параметры веб-канала.
custom	string	Не поддерживается.
none	string	Не поддерживается.
reader	string	Читатели могут только считывать пакеты и просматривать параметры.

FeedView

Представление поверх веб-канала.

Имя	Тип	Описание
_links	ReferenceLinks	Связанные ссылки REST.
id	string	Идентификатор представления.
name	string	Имя представления.
type	FeedViewType	Тип представления.
url	string	URL-адрес представления.
visibility	FeedVisibility	Состояние видимости представления.

FeedViewType

Тип представления.

Имя	Тип	Описание
implicit	string	Тип внутреннего представления, автоматически создаваемый и управляемый системой.
none	string	Тип представления по умолчанию не указан.
release	string	Представление, используемое в качестве назначения повышения для классификации выпущенных артефактов.

FeedVisibility

Состояние видимости представления.

Имя	Тип	Описание
collection	string	Веб-канал доступен для всех допустимых пользователей, присутствующих в организации, в которой находится веб-канал (например, в организации myorg на dev.azure.com/myorg).
organization	string	Веб-канал доступен всем допустимым пользователям, присутствующим на предприятии, где находится веб-канал. Обратите внимание, что устаревшее именование и обратная копия не синхронизирует имя этого значения с новым значением.
private	string	Доступны только разрешения, явно заданные администратором веб-канала.

IdentityDescriptor

Дескриптор удостоверения — это оболочка для типа удостоверения (ИД Безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.

Имя	Тип	Описание
identifier	string	Уникальный идентификатор для этого удостоверения, не превышающий 256 символов, который будет сохранен.
identityType	string	Тип дескриптора (например, Windows, Passport и т. д.).

ProjectReference

Имя	Тип	Описание
id	string	Возвращает или задает идентификатор проекта.
name	string	Возвращает или задает имя проекта.
visibility	string	Возвращает или задает видимость проекта.

ReferenceLinks

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

UpstreamSource

Вышестоящее определение источника, включая его идентификатор, тип пакета и другие связанные сведения.

Имя	Тип	Описание
deletedDate	string	Дата удаления вышестоящий в формате UTC.
displayLocation	string	Указатель для подключения к источнику вышестоящий в понятном для пользователя формате, который может со временем измениться
id	string	Удостоверение источника вышестоящий.
internalUpstreamCollectionId	string	Для внутреннего типа вышестоящий отслеживайте организацию Azure DevOps, которая его содержит.
internalUpstreamFeedId	string	Для внутреннего типа вышестоящий отслеживайте идентификатор веб-канала, на который ссылается ссылка.
internalUpstreamViewId	string	Для внутреннего типа вышестоящий отслеживайте представление веб-канала, на который ссылается ссылка.
location	string	Согласованный указатель для подключения к источнику вышестоящий.
name	string	Отображаемое имя.
protocol	string	Тип пакета, связанный с источником вышестоящий.
upstreamSourceType	UpstreamSourceType	Тип источника, например Public или Internal.

UpstreamSourceType

Тип источника, например Public или Internal.

Имя	Тип	Описание
internal	string	Источник вышестоящий Azure DevOps.
public	string	Общедоступный источник.

Share via