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: não deve exceder 64 caracteres Não deve conter espaços em branco Não deve começar com um sublinhado ou um período Não deve terminar com um período Não deve conter nenhum dos seguintes caracteres ilegais: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
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
defaultCapabilities	Os recursos dados a um feed recém-criado
none	Não existem sinalizadores para este feed
underMaintenance	Esse feed está atualmente em manutenção e pode ter funcionalidade reduzida
upstreamV2	Esse feed pode servir pacotes de fontes upstream que os pacotes upstream devem ser promovidos manualmente para exibições

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
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.
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.
custom	Unsupported.
none	Unsupported.
reader	Os leitores só podem ler pacotes e exibir as configurações.

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
implicit	Tipo de exibição interna que é criado e gerenciado automaticamente pelo sistema.
none	Tipo de exibição padrão não especificado.
release	Exibição usada como destino de promoção para classificar artefatos liberados.

FeedVisibility

Enumeração

Status de visibilidade do modo de exibição.

Valor	Description
aadTenant	O feed é acessível por todos os usuários válidos presentes no locatário do Azure Active Directory.
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.
private	Acessível somente pelas permissões definidas explicitamente pelo administrador do feed.

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.

ReferenceLinks

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
internal	Origem upstream do Azure DevOps.
public	Origem disponível publicamente.

UpstreamStatus

Enumeração

Especifica o status do upstream.

Valor	Description
disabled	A origem upstream está desabilitada.
ok	A origem upstream está ok.

UpstreamStatusDetail

Objeto

Nome	Tipo	Description
reason	string	Fornece um motivo legível para o status do upstream.