Partilhar via

Feed Management - Get Feed

Serviço:
Artifacts
Versão da API:
7.1

Obtenha as configurações de um feed específico.

O parâmetro do projeto deve ser fornecido se o feed foi criado em um projeto. Se o feed não estiver associado a nenhum projeto, omita o parâmetro do projeto da solicitação.

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?api-version=7.1
Com parâmetros opcionais: 
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1

Parâmetros de URI

Nome Em Obrigatório Tipo Description
feedId
 path True

string

Nome ou ID do feed.
organization
 path True

string

O nome da organização do Azure DevOps.
project
 path

string

ID do projeto ou nome do projeto
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.
includeDeletedUpstreams
 query

boolean

Inclua upstreams que foram excluídos na resposta.

Respostas

Nome Tipo Description
200 OK

Feed

operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

Nome Description
vso.packaging Concede a capacidade de ler feeds e pacotes. Também concede a capacidade de pesquisar pacotes.

Definições

Nome Description
Feed

Um contêiner para artefatos.
FeedCapabilities

Funcionalidades com suporte de um feed.
FeedPermission

Permissões para um feed.
FeedRole

A função dessa identidade em um feed.
FeedView

Uma exibição na parte superior de um feed.
FeedViewType

Tipo de exibição.
FeedVisibility

Status de visibilidade do modo de exibição.
IdentityDescriptor

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.
ProjectReference
ReferenceLinks

A classe para representar uma coleção de links de referência REST.
UpstreamSource

Definição de origem upstream, incluindo identidade, tipo de pacote e outras informações associadas.
UpstreamSourceType

Tipo de origem, como Público ou Interno.
UpstreamStatus

Especifica o status do upstream.
UpstreamStatusDetail

Feed

Objeto

Um contêiner para artefatos.

Nome Tipo Description
_links

ReferenceLinks

Links REST relacionados.
badgesEnabled

boolean

Se definido, esse feed dá suporte à geração de selos de pacote.
capabilities

FeedCapabilities

Funcionalidades com suporte de um feed.
defaultViewId

string (uuid)

A exibição que o administrador do feed indicou é a experiência padrão para os leitores.
deletedDate

string (date-time)

A data em que esse feed foi excluído.
description

string

Uma descrição para o feed. As descrições não devem exceder 255 caracteres.
fullyQualifiedId

string

Esse será o GUID do feed ou o GUID do feed e exibirá o GUID dependendo de como o feed foi acessado.
fullyQualifiedName

string

Nome completo do modo de exibição, no formato feed@view.
hideDeletedPackageVersions

boolean

Se definido, o feed ocultará todas as versões excluídas/não publicadas
id

string (uuid)

Um GUID que identifica exclusivamente esse feed.
isReadOnly

boolean

Se definido, todos os pacotes no feed serão imutáveis. É importante observar que as exibições de feed são imutáveis; portanto, esse sinalizador sempre será definido para exibições.
name

string

Um nome para o feed. Os nomes de feed devem seguir estas regras: <list type="bullet"><item><description> Must not exceed 64 characters </description></item><item><description> Must not contain whitespaces </description></item><item><description Must not start with an underline or a period </description></item><item><description> Must not end with a period </description></item><item><description>> Não deve conter nenhum dos seguintes caracteres ilegais: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]></description></item></list>
permanentDeletedDate

string (date-time)

A data em que esse feed foi excluído permanentemente.
permissions

FeedPermission[]

Permissões explícitas para o feed.
project

ProjectReference

O projeto ao qual esse feed está associado.
scheduledPermanentDeleteDate

string (date-time)

A data em que este feed está agendado para ser excluído permanentemente.
upstreamEnabled

boolean

Isso sempre deve ser verdade. A configuração como false substituirá todas as fontes em UpstreamSources.
upstreamEnabledChangedDate

string (date-time)

Se definido, o tempo em que a propriedade UpstreamEnabled foi alterada. Será nulo se UpstreamEnabled nunca tiver sido alterado após a criação do Feed.
upstreamSources

UpstreamSource[]

Uma lista de fontes das quais esse feed buscará pacotes. Uma lista vazia indica que esse feed não pesquisará nenhuma fonte adicional em busca de pacotes.
url

string

A URL do feed base no formulário GUID.
view

FeedView

Definição da exibição.
viewId

string (uuid)

ID de exibição.
viewName

string

Nome da exibição.

FeedCapabilities

Enumeração

Funcionalidades com suporte de um feed.

Valor Description
none

Não existem sinalizadores para este feed
upstreamV2

Esse feed pode servir pacotes de fontes upstream que os pacotes upstream devem ser promovidos manualmente para exibições
underMaintenance

Esse feed está atualmente em manutenção e pode ter funcionalidade reduzida
defaultCapabilities

Os recursos dados a um feed recém-criado

FeedPermission

Objeto

Permissões para um feed.

Nome Tipo Description
displayName

string

Nome de exibição para a identidade.
identityDescriptor

IdentityDescriptor

Identidade associada a essa função.
identityId

string (uuid)

ID da identidade associada a essa função.
isInheritedRole

boolean

Booliano que indica se a função é herdada ou definida diretamente.
role

FeedRole

A função dessa identidade em um feed.

FeedRole

Enumeração

A função dessa identidade em um feed.

Valor Description
custom

Unsupported.
none

Unsupported.
reader

Os leitores só podem ler pacotes e exibir as configurações.
contributor

Os colaboradores podem fazer qualquer coisa com pacotes no feed, incluindo a adição de novos pacotes, mas eles podem não modificar as configurações do feed.
administrator

Os administradores têm controle total sobre o feed.
collaborator

Os colaboradores têm as mesmas permissões que os leitores, mas também podem ingerir pacotes de fontes upstream configuradas.

FeedView

Objeto

Uma exibição na parte superior de um feed.

Nome Tipo Description
_links

ReferenceLinks

Links REST relacionados.
id

string (uuid)

ID da exibição.
name

string

Nome da exibição.
type

FeedViewType

Tipo de exibição.
url

string

Url do modo de exibição.
visibility

FeedVisibility

Status de visibilidade do modo de exibição.

FeedViewType

Enumeração

Tipo de exibição.

Valor Description
none

Tipo de exibição padrão não especificado.
release

Exibição usada como destino de promoção para classificar artefatos liberados.
implicit

Tipo de exibição interna que é criado e gerenciado automaticamente pelo sistema.

FeedVisibility

Enumeração

Status de visibilidade do modo de exibição.

Valor Description
private

Acessível somente pelas permissões definidas explicitamente pelo administrador do feed.
collection

O feed é acessível por todos os usuários válidos presentes na organização em que o feed reside (por exemplo, na organização 'myorg' em 'dev.azure.com/myorg')
organization

O feed é acessível por todos os usuários válidos presentes na empresa em que o feed reside. Observe que a nomenclatura herdada e o compatibilidade de voltar deixam o nome desse valor fora de sincronia com seu novo significado.
aadTenant

O feed é acessível por todos os usuários válidos presentes no locatário do Azure Active Directory.

IdentityDescriptor

Objeto

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

Nome Tipo Description
identifier

string

O identificador exclusivo para essa identidade, não excedendo 256 caracteres, que serão persistidos.
identityType

string

Tipo de descritor (por exemplo, Windows, Passport etc.).

ProjectReference

Objeto
Nome Tipo Description
id

string (uuid)

Obtém ou define a ID do projeto.
name

string

Obtém ou define o nome do projeto.
visibility

string

Obtém ou define a visibilidade do projeto.
Objeto

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

UpstreamSource

Objeto

Definição de origem upstream, incluindo identidade, tipo de pacote e outras informações associadas.

Nome Tipo Description
deletedDate

string (date-time)

Data UTC em que esse upstream foi excluído.
displayLocation

string

Localizador para se conectar à origem upstream em um formato amigável, que pode potencialmente mudar ao longo do tempo
id

string (uuid)

Identidade da origem upstream.
internalUpstreamCollectionId

string (uuid)

Para um tipo upstream interno, acompanhe a organização do Azure DevOps que o contém.
internalUpstreamFeedId

string (uuid)

Para um tipo upstream interno, acompanhe a ID do feed que está sendo referenciada.
internalUpstreamProjectId

string (uuid)

Para um tipo upstream interno, acompanhe o projeto do feed que está sendo referenciado.
internalUpstreamViewId

string (uuid)

Para um tipo upstream interno, acompanhe a exibição do feed que está sendo referenciado.
location

string

Localizador consistente para se conectar à origem upstream.
name

string

Nome de exibição.
protocol

string

Tipo de pacote associado à origem upstream.
serviceEndpointId

string (uuid)

A identidade do ponto de extremidade de serviço que contém credenciais a serem usadas ao acessar o upstream.
serviceEndpointProjectId

string (uuid)

Especifica a projectId do Ponto de Extremidade de Serviço.
status

UpstreamStatus

Especifica o status do upstream.
statusDetails

UpstreamStatusDetail[]

Fornece um motivo legível para o status do upstream.
upstreamSourceType

UpstreamSourceType

Tipo de origem, como Público ou Interno.

UpstreamSourceType

Enumeração

Tipo de origem, como Público ou Interno.

Valor Description
public

Origem disponível publicamente.
internal

Origem upstream do Azure DevOps.

UpstreamStatus

Enumeração

Especifica o status do upstream.

Valor Description
ok

A origem upstream está ok.
disabled

A origem upstream está desabilitada.

UpstreamStatusDetail

Objeto
Nome Tipo Description
reason

string

Fornece um motivo legível para o status do upstream.