Поделиться через

Feed Management - Get Feed

  • Ссылка
Служба:
Artifacts
Версия API:
7.1

Получите параметры для определенного веб-канала.

Параметр проекта должен быть предоставлен, если веб-канал был создан в проекте. Если веб-канал не связан с любым проектом, опустите параметр проекта из запроса.

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?api-version=7.1
С использованием необязательных параметров: 
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1

Параметры URI

Имя В Обязательно Тип Описание
feedId
 path True

string

Имя или идентификатор веб-канала.
organization
 path True

string

Имя организации Azure DevOps.
project
 path

string

Идентификатор проекта или имя проекта
api-version
 query True

string

Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".
includeDeletedUpstreams
 query

boolean

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

Ответы

Имя Тип Описание
200 OK

Feed

успешная операция

Безопасность

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

Области

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

Определения

Имя Описание
Feed

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

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

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

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

Представление на вершине веб-канала.
FeedViewType

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

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

Дескриптор удостоверений — это оболочка для типа удостоверения (ИДЕНТИФИКАТОР Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.
ProjectReference
ReferenceLinks

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

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

Тип источника, например Public или Internal.
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

Это всегда должно быть верно. Значение false переопределит все источники в UpstreamSources.
upstreamEnabledChangedDate

string (date-time)

Если задано, время изменения свойства UpstreamEnabled. Значение NULL, если upstreamEnabled никогда не изменялся после создания веб-канала.
upstreamSources

UpstreamSource[]

Список источников, из которые этот веб-канал получит пакеты. Пустой список указывает, что этот веб-канал не будет искать дополнительные источники для пакетов.
url

string

URL-адрес базового веб-канала в форме GUID.
view

FeedView

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

string (uuid)

Идентификатор представления.
viewName

string

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

FeedCapabilities

Перечисление

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

Значение Описание
defaultCapabilities

Возможности, предоставленные только что созданному веб-каналу
none

Флаги для этого веб-канала отсутствуют
underMaintenance

Этот веб-канал в настоящее время находится в состоянии обслуживания и может иметь ограниченные функциональные возможности.
upstreamV2

Этот веб-канал может обслуживать пакеты из вышестоящих источников, которые должны быть вручную повышены до представлений.

FeedPermission

Object

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

Имя Тип Описание
displayName

string

Отображаемое имя удостоверения.
identityDescriptor

IdentityDescriptor

Удостоверение, связанное с этой ролью.
identityId

string (uuid)

Идентификатор удостоверения, связанного с этой ролью.
isInheritedRole

boolean

Логическое значение, указывающее, наследуется ли роль или устанавливается напрямую.
role

FeedRole

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

FeedRole

Перечисление

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

Значение Описание
administrator

Администраторы имеют полный контроль над веб-каналом.
collaborator

Сотрудники имеют те же разрешения, что и читатели, но также могут получать пакеты из настроенных вышестоящих источников.
contributor

Участники могут делать все, чтобы пакеты в веб-канале, включая добавление новых пакетов, но они не могут изменять параметры веб-канала.
custom

Неподдерживаемые.
none

Неподдерживаемые.
reader

Читатели могут читать только пакеты и параметры просмотра.

FeedView

Object

Представление на вершине веб-канала.

Имя Тип Описание
_links

ReferenceLinks

Связанные ссылки REST.
id

string (uuid)

Идентификатор представления.
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

Веб-канал доступен всем допустимым пользователям, присутствующих в организации, где находится веб-канал. Обратите внимание, что устаревшие имена именования и обратного compat покидают имя этого значения из-за синхронизации с новым значением.
private

Доступны только разрешениями, явно заданными администратором веб-канала.

IdentityDescriptor

Object

Дескриптор удостоверений — это оболочка для типа удостоверения (ИДЕНТИФИКАТОР Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.

Имя Тип Описание
identifier

string

Уникальный идентификатор для этого удостоверения, не превышающий 256 символов, которые будут сохранены.
identityType

string

Тип дескриптора (например, Windows, Passport и т. д.).

ProjectReference

Object
Имя Тип Описание
id

string (uuid)

Возвращает или задает идентификатор проекта.
name

string

Возвращает или задает имя проекта.
visibility

string

Возвращает или задает видимость проекта.
Object

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

Имя Тип Описание
links

object

Режим чтения ссылок. Так как ссылки ссылки доступны только для чтения, мы хотим предоставлять их только как доступные только для чтения.

UpstreamSource

Object

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

Имя Тип Описание
deletedDate

string (date-time)

Дата UTC, в которую был удален вышестоящий поток.
displayLocation

string

Указатель для подключения к вышестоящему источнику в понятном формате, который может измениться с течением времени.
id

string (uuid)

Удостоверение вышестоящего источника.
internalUpstreamCollectionId

string (uuid)

Для внутреннего вышестоящего типа отслеживайте организацию Azure DevOps, содержащую ее.
internalUpstreamFeedId

string (uuid)

Для внутреннего вышестоящего типа отслеживайте идентификатор канала, на который ссылается ссылка.
internalUpstreamProjectId

string (uuid)

Для внутреннего вышестоящего типа отслеживайте проект канала, на который ссылается ссылка.
internalUpstreamViewId

string (uuid)

Для внутреннего вышестоящего типа отслеживайте представление ссылки на веб-канал.
location

string

Согласованный указатель для подключения к вышестоящему источнику.
name

string

Отображаемое имя.
protocol

string

Тип пакета, связанный с вышестоящим источником.
serviceEndpointId

string (uuid)

Удостоверение конечной точки службы, содержащей учетные данные для доступа к вышестоящему потоку.
serviceEndpointProjectId

string (uuid)

Задает идентификатор проекта конечной точки службы.
status

UpstreamStatus

Указывает состояние вышестоящего потока.
statusDetails

UpstreamStatusDetail[]

Предоставляет читаемую человеком причину состояния вышестоящего потока.
upstreamSourceType

UpstreamSourceType

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

UpstreamSourceType

Перечисление

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

Значение Описание
internal

Вышестоящий источник Azure DevOps.
public

Общедоступный источник.

UpstreamStatus

Перечисление

Указывает состояние вышестоящего потока.

Значение Описание
disabled

Вышестоящий источник отключен.
ok

Вышестоящий источник является ок.

UpstreamStatusDetail

Object
Имя Тип Описание
reason

string

Предоставляет читаемую человеком причину состояния вышестоящего потока.