Pipeline Permissions - Update Pipeline Permisions For Resource

Service:

Approvals And Checks

API Version:

7.1-preview.1

Autoryzuje/nieautoryzuje listę definicji dla danego zasobu.

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/pipelinepermissions/{resourceType}/{resourceId}?api-version=7.1-preview.1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
resourceId	path	True	string
resourceType	path	True	string
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
allPipelines	Permission
pipelines	PipelinePermission[]
resource	Resource

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ResourcePipelinePermissions	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.pipelineresources_manage	Umożliwia zarządzanie chronionym zasobem lub żądaniem potoku do korzystania z chronionego zasobu: pula agentów, środowisko, kolejka, repozytorium, bezpieczne pliki, połączenie z usługą i grupa zmiennych

Przykłady

Sample Request

HTTP

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/pipelinepermissions/{resourceType}/{resourceId}?api-version=7.1-preview.1

{
  "pipelines": [
    {
      "id": 16,
      "authorized": true
    }
  ]
}

Sample Response

Status code:

200

request-Context: appId=cid-v1:a892bfef-0287-4640-9f5e-cffc90fbcf94
access-Control-Expose-Headers: Request-Context

Response Body

{
  "resource": {
    "type": "queue",
    "id": "1"
  },
  "pipelines": [
    {
      "id": 6,
      "authorized": true,
      "authorizedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "authorizedOn": "2020-01-02T08:59:48.77Z"
    },
    {
      "id": 15,
      "authorized": true,
      "authorizedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "authorizedOn": "2020-11-19T08:14:49.26Z"
    },
    {
      "id": 16,
      "authorized": true,
      "authorizedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "authorizedOn": "2020-11-20T15:10:54.187Z"
    }
  ]
}

Definicje

Nazwa	Opis
IdentityRef
Permission
PipelinePermission
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
Resource
ResourcePipelinePermissions

IdentityRef

Nazwa	Typ	Opis
_links	ReferenceLinks	To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor	string	Deskryptor jest podstawowym sposobem odwoływanie się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias	string	Przestarzałe — można je pobrać, wykonując zapytanie względem użytkownika programu Graph, do których odwołuje się wpis "self" słownika IdentityRef "_links"
displayName	string	Jest to nieu unikatowa nazwa wyświetlana podmiotu grafu. Aby zmienić to pole, należy zmienić jego wartość u dostawcy źródłowego.
id	string
imageUrl	string	Przestarzałe — dostępne we wpisie "avatar" słownika IdentityRef "_links"
inactive	boolean	Przestarzałe — można pobrać, wykonując zapytanie dotyczące stanu członkostwa programu Graph, do których odwołuje się wpis "membershipState" słownika GraphUser "_links"
isAadIdentity	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Przestarzałe — nie jest używane w większości istniejących implementacji elementu ToIdentityRef
uniqueName	string	Przestarzałe — zamiast tego użyj nazwy Domain+PrincipalName
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

Permission

Nazwa	Typ	Opis
authorized	boolean
authorizedBy	IdentityRef
authorizedOn	string

PipelinePermission

Nazwa	Typ	Opis
authorized	boolean
authorizedBy	IdentityRef
authorizedOn	string
id	integer

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

Resource

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
type	string	Typ zasobu.

ResourcePipelinePermissions

Nazwa	Typ	Opis
allPipelines	Permission
pipelines	PipelinePermission[]
resource	Resource