Udostępnij za pośrednictwem


Service Principal Entitlements - Update Service Principal Entitlement

Edytuj uprawnienia (licencja, rozszerzenia, projekty, zespoły itp.) dla jednostki usługi.

PATCH https://vsaex.dev.azure.com/{organization}/_apis/serviceprincipalentitlements/{servicePrincipalId}?api-version=7.1-preview.1

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
path True

string

Nazwa organizacji usługi Azure DevOps.

servicePrincipalId
path True

string

uuid

Identyfikator jednostki usługi.

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

Media Types: "application/json-patch+json"

Nazwa Typ Opis
from

string

Ścieżka do skopiowania dla operacji Przenoszenia/kopiowania.

op

Operation

Operacja stosowania poprawek

path

string

Ścieżka operacji. W przypadku tablicy można użyć indeksu opartego na zera, aby określić pozycję w tablicy (np. /biscuits/0/name). Znak "-" można użyć zamiast indeksu do wstawienia na końcu tablicy (np. /biscuits/-).

value

object

Wartość operacji. Jest to element pierwotny lub token JToken.

Odpowiedzi

Nazwa Typ Opis
200 OK

ServicePrincipalEntitlementsPatchResponse

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.memberentitlementmanagement_write Daje możliwość zarządzania użytkownikami, ich licencjami, a także projektami i rozszerzeniami, do których mogą uzyskiwać dostęp

Przykłady

Sample Request

PATCH https://vsaex.dev.azure.com/{organization}/_apis/serviceprincipalentitlements/593F6716-627C-6CCB-833E-77A7F9CA422F?api-version=7.1-preview.1

[
  {
    "from": "",
    "op": "replace",
    "path": "/accessLevel",
    "value": {
      "accountLicenseType": "express",
      "licensingSource": "account"
    }
  },
  {
    "from": "",
    "op": "add",
    "path": "/projectEntitlements/6fa35aad-6755-4dd7-8c69-e13f702af0f9",
    "value": {
      "group": {
        "groupType": "projectAdministrator"
      },
      "projectRef": {
        "id": "6fa35aad-6755-4dd7-8c69-e13f702af0f9"
      }
    }
  },
  {
    "from": "",
    "op": "remove",
    "path": "/projectEntitlements/fca61097-56a1-464f-85ba-1b126cf02cd1",
    "value": ""
  }
]

Sample Response

{
  "operationResults": [
    {
      "servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
      "isSuccess": true,
      "errors": [],
      "result": {
        "servicePrincipal": {
          "subjectKind": "servicePrincipal",
          "applicationId": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
          "metaType": "application",
          "directoryAlias": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
          "domain": "faab4a73-0db3-4a5e-8e8a-02188f1d3f4b",
          "principalName": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
          "mailAddress": null,
          "origin": "aad",
          "originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
          "displayName": "Service principal",
          "_links": {
            "self": {
              "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
            },
            "memberships": {
              "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/Memberships/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
            },
            "membershipState": {
              "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/MembershipStates/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
            },
            "storageKey": {
              "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/StorageKeys/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
            },
            "avatar": {
              "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
            }
          },
          "url": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz",
          "descriptor": "aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
        },
        "id": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
        "accessLevel": {
          "licensingSource": "account",
          "accountLicenseType": "earlyAdopter",
          "msdnLicenseType": "none",
          "licenseDisplayName": "Early Adopter",
          "status": "pending",
          "statusMessage": "",
          "assignmentSource": "unknown"
        },
        "lastAccessedDate": "0001-01-01T00:00:00",
        "dateCreated": "0001-01-01T00:00:00",
        "projectEntitlements": null,
        "groupAssignments": null
      }
    },
    {
      "servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
      "isSuccess": true,
      "errors": [],
      "result": null
    },
    {
      "servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
      "isSuccess": true,
      "errors": [],
      "result": null
    }
  ],
  "isSuccess": true,
  "servicePrincipalEntitlement": {
    "servicePrincipal": {
      "subjectKind": "servicePrincipal",
      "applicationId": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
      "metaType": "application",
      "directoryAlias": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
      "domain": "faab4a73-0db3-4a5e-8e8a-02188f1d3f4b",
      "principalName": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
      "mailAddress": null,
      "origin": "aad",
      "originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
      "displayName": "Service principal",
      "_links": {
        "self": {
          "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
        },
        "memberships": {
          "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/Memberships/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
        },
        "membershipState": {
          "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/MembershipStates/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
        },
        "storageKey": {
          "href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/StorageKeys/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
        },
        "avatar": {
          "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
        }
      },
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz",
      "descriptor": "aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
    },
    "id": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
    "accessLevel": {
      "licensingSource": "account",
      "accountLicenseType": "earlyAdopter",
      "msdnLicenseType": "none",
      "licenseDisplayName": "Early Adopter",
      "status": "pending",
      "statusMessage": "",
      "assignmentSource": "unknown"
    },
    "lastAccessedDate": "0001-01-01T00:00:00Z",
    "dateCreated": "2023-02-08T11:20:12.3155446Z",
    "projectEntitlements": [
      {
        "projectRef": {
          "id": "6fa35aad-6755-4dd7-8c69-e13f702af0f9",
          "name": "TestProject2"
        },
        "group": {
          "groupType": "projectAdministrator",
          "displayName": "Project Administrators"
        },
        "projectPermissionInherited": "notInherited",
        "teamRefs": [],
        "assignmentSource": "unknown"
      }
    ],
    "groupAssignments": []
  }
}

Definicje

Nazwa Opis
AccessLevel

Licencja przypisana użytkownikowi

AccountLicenseType

Typ licencji konta (np. Express, Uczestnik projektu itp.). Aby użyć parametru AccountLicenseType, element LicensingSource powinien być zdefiniowany jako "konto" w treści żądania.

AccountUserStatus

Stan użytkownika na koncie

AssignmentSource

Źródło przypisania licencji (np. grupa, nieznany itp.

GraphGroup

Jednostka grupy programu Graph

GraphServicePrincipal
GraphUser
Group

Grupa projektów (np. współautor, czytelnik itp.)

GroupEntitlement

Jednostka grupy z dodatkowymi właściwościami, w tym jej licencja, rozszerzenia i członkostwo w projekcie

GroupLicensingRuleStatus

Stan reguły grupy.

GroupType

Typ grupy

JsonPatchDocument

Model JSON dla operacji poprawek JSON

LicensingSource

Źródło licencjonowania (np. konto. MSDN itp.)

MsdnLicenseType

Typ licencji MSDN (np. Visual Studio Professional, Visual Studio Enterprise itp.). Aby użyć właściwości MsdnLicenseType, element LicensingSource powinien być zdefiniowany jako "msdn" w treści żądania.

Operation

Operacja stosowania poprawek

ProjectEntitlement

Relacja między projektem a skutecznymi uprawnieniami użytkownika w tym projekcie.

ProjectPermissionInherited

Określa, czy użytkownik dziedziczy uprawnienia do projektu za pośrednictwem członkostwa w grupie usługi Azure DevOps, czy usługi AAD.

ProjectRef

Odwołanie do projektu

ReferenceLinks

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

ServicePrincipalEntitlement
ServicePrincipalEntitlementOperationResult
ServicePrincipalEntitlementsPatchResponse
TeamRef

Odwołanie do zespołu

UserEntitlement

Jednostka użytkownika z dodatkowymi właściwościami, w tym licencją, rozszerzeniami i członkostwem w projekcie

AccessLevel

Licencja przypisana użytkownikowi

Nazwa Typ Opis
accountLicenseType

AccountLicenseType

Typ licencji konta (np. Express, Uczestnik projektu itp.). Aby użyć parametru AccountLicenseType, element LicensingSource powinien być zdefiniowany jako "konto" w treści żądania.

assignmentSource

AssignmentSource

Źródło przypisania licencji (np. grupa, nieznany itp.

licenseDisplayName

string

Nazwa wyświetlana licencji

licensingSource

LicensingSource

Źródło licencjonowania (np. konto. MSDN itp.)

msdnLicenseType

MsdnLicenseType

Typ licencji MSDN (np. Visual Studio Professional, Visual Studio Enterprise itp.). Aby użyć właściwości MsdnLicenseType, element LicensingSource powinien być zdefiniowany jako "msdn" w treści żądania.

status

AccountUserStatus

Stan użytkownika na koncie

statusMessage

string

Komunikat o stanie.

AccountLicenseType

Typ licencji konta (np. Express, Uczestnik projektu itp.). Aby użyć parametru AccountLicenseType, element LicensingSource powinien być zdefiniowany jako "konto" w treści żądania.

Nazwa Typ Opis
advanced

string

earlyAdopter

string

express

string

none

string

professional

string

stakeholder

string

AccountUserStatus

Stan użytkownika na koncie

Nazwa Typ Opis
active

string

Użytkownik zalogował się co najmniej raz na konto usługi VSTS

deleted

string

Użytkownik jest usuwany z konta usługi VSTS przez administratora konta usługi VSTS

disabled

string

Użytkownik nie może się zalogować; głównie używany przez administratora do tymczasowego usunięcia użytkownika z powodu braku lub reallocation licencji

expired

string

Użytkownik może się zalogować; używane głównie wtedy, gdy licencja jest w stanie wygaśnięcia i otrzymujemy okres prolongaty

none

string

pending

string

Użytkownik jest zapraszany do dołączenia do konta usługi VSTS przez administratora konta usługi VSTS, ale jeszcze nie zarejestrował się/zalogował się

pendingDisabled

string

Użytkownik jest wyłączony; w przypadku ponownego włączenia, nadal będą one w stanie Oczekiwanie

AssignmentSource

Źródło przypisania licencji (np. grupa, nieznany itp.

Nazwa Typ Opis
groupRule

string

none

string

unknown

string

GraphGroup

Jednostka grupy programu Graph

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.

description

string

Krótka fraza pomagająca czytelnikom uściślać grupy o podobnych nazwach

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.

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.

domain

string

Reprezentuje to nazwę kontenera pochodzenia dla elementu członkowskiego grafu. (W przypadku msA jest to "Windows Live ID", w przypadku usługi AD nazwa domeny, dla usługi AAD identyfikator dzierżawy katalogu, dla grup usługi VSTS identyfikator ScopeId itp.)

legacyDescriptor

string

[Tylko użycie wewnętrzne] Starszy deskryptor jest tutaj, jeśli musisz uzyskać dostęp do starej wersji IMS przy użyciu deskryptora tożsamości.

mailAddress

string

Adres e-mail rekordu dla danego elementu członkowskiego grafu. Może to być inne niż główna nazwa.

origin

string

Typ dostawcy źródłowego identyfikatora źródła (np. AD, AAD, MSA)

originId

string

Unikatowy identyfikator z systemu pochodzenia. Zazwyczaj identyfikator sid, identyfikator obiektu lub identyfikator GUID. Operacje łączenia i odłączania mogą spowodować zmianę tej wartości dla użytkownika, ponieważ użytkownik nie jest wspierany przez innego dostawcę i ma inny unikatowy identyfikator w nowym dostawcy.

principalName

string

Jest to nazwa główna tego elementu członkowskiego grafu od dostawcy źródłowego. Dostawca źródłowy może zmienić to pole w czasie i nie ma gwarancji, że będzie on niezmienny dla okresu życia elementu członkowskiego grafu przez usługę VSTS.

subjectKind

string

To pole identyfikuje typ tematu grafu (np. Grupa, Zakres, Użytkownik).

url

string

Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

GraphServicePrincipal

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.

applicationId

string

descriptor

string

Deskryptor jest podstawowym sposobem odwołowania 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

Krótka, ogólnie unikatowa nazwa użytkownika w katalogu zaplecza. W przypadku użytkowników usługi AAD odpowiada to pseudonimowi poczty, który jest często, ale niekoniecznie podobny do części adresu e-mail użytkownika przed znakiem @. W przypadku użytkowników usługi GitHub odpowiada to obsłudze użytkownika usługi GitHub.

displayName

string

Jest to unikatowa nazwa wyświetlana tematu grafu. Aby zmienić to pole, musisz zmienić jego wartość u dostawcy źródłowego.

domain

string

Reprezentuje to nazwę kontenera pochodzenia dla elementu członkowskiego grafu. (W przypadku msA jest to "Windows Live ID", w przypadku usługi AD nazwa domeny, dla usługi AAD identyfikator dzierżawy katalogu, dla grup usługi VSTS identyfikator ScopeId itp.)

isDeletedInOrigin

boolean

W przypadku wartości true grupa została usunięta w dostawcy tożsamości

legacyDescriptor

string

[Tylko użycie wewnętrzne] Starszy deskryptor jest tutaj, jeśli musisz uzyskać dostęp do starej wersji IMS przy użyciu deskryptora tożsamości.

mailAddress

string

Adres e-mail rekordu dla danego elementu członkowskiego grafu. Może to być inne niż główna nazwa.

metaType

string

Meta typ użytkownika w miejscu pochodzenia, taki jak "członek", "gość" itp. Zobacz UserMetaType, aby uzyskać zestaw możliwych wartości.

origin

string

Typ dostawcy źródłowego identyfikatora źródła (np. AD, AAD, MSA)

originId

string

Unikatowy identyfikator z systemu pochodzenia. Zazwyczaj identyfikator sid, identyfikator obiektu lub identyfikator GUID. Operacje łączenia i odłączania mogą spowodować zmianę tej wartości dla użytkownika, ponieważ użytkownik nie jest wspierany przez innego dostawcę i ma inny unikatowy identyfikator w nowym dostawcy.

principalName

string

Jest to nazwa główna tego elementu członkowskiego grafu od dostawcy źródłowego. Dostawca źródłowy może zmienić to pole w czasie i nie ma gwarancji, że będzie on niezmienny dla okresu życia elementu członkowskiego grafu przez usługę VSTS.

subjectKind

string

To pole identyfikuje typ tematu grafu (np. Grupa, Zakres, Użytkownik).

url

string

Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

GraphUser

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

Krótka, zazwyczaj unikatowa nazwa użytkownika w katalogu zapasowym. W przypadku użytkowników usługi AAD odpowiada to pseudonimowi poczty, który jest często, ale niekoniecznie podobny do części adresu e-mail użytkownika przed znakiem @. W przypadku użytkowników usługi GitHub odpowiada to dojściu użytkownika usługi GitHub.

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.

domain

string

Reprezentuje to nazwę kontenera pochodzenia dla elementu członkowskiego grafu. (W przypadku konta MSA jest to "Windows Live ID", dla usługi AD nazwa domeny, dla usługi AAD identyfikator dzierżawy katalogu, dla grup usługi VSTS identyfikator ScopeId itp.)

isDeletedInOrigin

boolean

W przypadku wartości true grupa została usunięta u dostawcy tożsamości

legacyDescriptor

string

[Tylko użycie wewnętrzne] Starszy deskryptor znajduje się tutaj, jeśli musisz uzyskać dostęp do starej wersji usługi IMS przy użyciu deskryptora tożsamości.

mailAddress

string

Adres e-mail rekordu dla danego elementu członkowskiego grafu. Może to być inne niż główna nazwa.

metaType

string

Meta typ użytkownika w miejscu pochodzenia, taki jak "członek", "gość" itp. Aby uzyskać zestaw możliwych wartości, zobacz UserMetaType.

origin

string

Typ dostawcy źródła dla identyfikatora źródła (np.: AD, AAD, MSA)

originId

string

Unikatowy identyfikator z systemu pochodzenia. Zazwyczaj identyfikator sid, identyfikator obiektu lub identyfikator GUID. Operacje łączenia i odłączania mogą spowodować zmianę tej wartości dla użytkownika, ponieważ użytkownik nie jest wspierany przez innego dostawcę i ma inny unikatowy identyfikator w nowym dostawcy.

principalName

string

Jest to principalName tego elementu członkowskiego grafu od dostawcy źródłowego. Dostawca źródłowy może zmienić to pole w czasie i nie ma gwarancji, że będzie niezmienny przez okres życia elementu członkowskiego grafu przez usługę VSTS.

subjectKind

string

To pole identyfikuje typ tematu grafu (np. Grupa, Zakres, Użytkownik).

url

string

Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

Group

Grupa projektów (np. współautor, czytelnik itp.)

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana grupy

groupType

GroupType

Typ grupy

GroupEntitlement

Jednostka grupy z dodatkowymi właściwościami, w tym jej licencja, rozszerzenia i członkostwo w projekcie

Nazwa Typ Opis
group

GraphGroup

Odwołanie do elementu członkowskiego.

id

string

Unikatowy identyfikator zgodny z identyfikatorem elementu GraphMember.

lastExecuted

string

[Readonly] Ostatni raz reguła licencjonowania grupy została wykonana (niezależnie od tego, czy wprowadzono jakiekolwiek zmiany).

licenseRule

AccessLevel

Reguła licencji.

members

UserEntitlement[]

Członkowie grupy. Używane tylko podczas tworzenia nowej grupy.

projectEntitlements

ProjectEntitlement[]

Relacja między projektem a skutecznymi uprawnieniami członka w tym projekcie.

status

GroupLicensingRuleStatus

Stan reguły grupy.

GroupLicensingRuleStatus

Stan reguły grupy.

Nazwa Typ Opis
applied

string

Reguła jest stosowana

applyPending

string

Reguła jest tworzona lub aktualizowana, ale zastosowanie jest oczekujące

incompatible

string

Reguła grupy była niezgodna

unableToApply

string

Nie można zastosować nieoczekiwanie reguły i powinna zostać ponowiona

GroupType

Typ grupy

Nazwa Typ Opis
custom

string

projectAdministrator

string

projectContributor

string

projectReader

string

projectStakeholder

string

JsonPatchDocument

Model JSON dla operacji poprawek JSON

Nazwa Typ Opis
from

string

Ścieżka do skopiowania dla operacji Przenoszenia/kopiowania.

op

Operation

Operacja stosowania poprawek

path

string

Ścieżka operacji. W przypadku tablicy można użyć indeksu opartego na zera, aby określić pozycję w tablicy (np. /herbatniki/0/nazwa). Znak "-" można użyć zamiast indeksu do wstawienia na końcu tablicy (np. /herbatniki/-).

value

object

Wartość operacji. Jest to element pierwotny lub JToken.

LicensingSource

Źródło licencjonowania (np. konto. MSDN itp.)

Nazwa Typ Opis
account

string

auto

string

msdn

string

none

string

profile

string

trial

string

MsdnLicenseType

Typ licencji MSDN (np. Visual Studio Professional, Visual Studio Enterprise itp.). Aby użyć właściwości MsdnLicenseType, element LicensingSource powinien być zdefiniowany jako "msdn" w treści żądania.

Nazwa Typ Opis
eligible

string

enterprise

string

none

string

platforms

string

premium

string

professional

string

testProfessional

string

ultimate

string

Operation

Operacja stosowania poprawek

Nazwa Typ Opis
add

string

copy

string

move

string

remove

string

replace

string

test

string

ProjectEntitlement

Relacja między projektem a skutecznymi uprawnieniami użytkownika w tym projekcie.

Nazwa Typ Opis
assignmentSource

AssignmentSource

Źródło przypisania (np. grupa lub nieznany).

group

Group

Grupa projektów (np. współautor, czytelnik itp.)

projectPermissionInherited

ProjectPermissionInherited

Niezależnie od tego, czy użytkownik dziedziczy uprawnienia do projektu za pośrednictwem członkostwa w grupie usługi Azure DevOps czy AAD.

projectRef

ProjectRef

Ref projektu

teamRefs

TeamRef[]

Team Ref.

ProjectPermissionInherited

Określa, czy użytkownik dziedziczy uprawnienia do projektu za pośrednictwem członkostwa w grupie usługi Azure DevOps, czy usługi AAD.

Nazwa Typ Opis
inherited

string

notInherited

string

notSet

string

ProjectRef

Odwołanie do projektu

Nazwa Typ Opis
id

string

Identyfikator projektu.

name

string

Nazwa projektu.

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

Nazwa Typ Opis
links

object

Czytelny widok linków. Ponieważ linki referencyjne są czytelne, chcemy uwidocznić je tylko jako tylko do odczytu.

ServicePrincipalEntitlement

Nazwa Typ Opis
accessLevel

AccessLevel

Poziom dostępu członka oznaczony przez licencję.

dateCreated

string

[Readonly] Data dodania elementu członkowskiego do kolekcji.

groupAssignments

GroupEntitlement[]

[Readonly] GroupEntitlements, do których należy ten element członkowski.

id

string

Unikatowy identyfikator zgodny z identyfikatorem tożsamości skojarzonej z elementem GraphMember.

lastAccessedDate

string

[Readonly] Data ostatniego dostępu do kolekcji przez członka.

projectEntitlements

ProjectEntitlement[]

Relacja między projektem a skutecznymi uprawnieniami członka w tym projekcie.

servicePrincipal

GraphServicePrincipal

Dokumentacja usługi ServicePrincipal.

ServicePrincipalEntitlementOperationResult

Nazwa Typ Opis
errors

object[]

Lista kodów błędów sparowanych z odpowiednimi komunikatami o błędach.

isSuccess

boolean

Stan powodzenia operacji.

result

string

Wynikowa właściwość upoważnienia. Aby zapoznać się z konkretnymi implementacjami, zobacz również:

servicePrincipalId

string

Identyfikator obiektu ServicePrincipal, na który działa.

ServicePrincipalEntitlementsPatchResponse

Nazwa Typ Opis
isSuccess

boolean

operationResults

ServicePrincipalEntitlementOperationResult[]

servicePrincipalEntitlement

ServicePrincipalEntitlement

TeamRef

Odwołanie do zespołu

Nazwa Typ Opis
id

string

Identyfikator zespołu

name

string

Nazwa zespołu

UserEntitlement

Jednostka użytkownika z dodatkowymi właściwościami, w tym licencją, rozszerzeniami i członkostwem w projekcie

Nazwa Typ Opis
accessLevel

AccessLevel

Poziom dostępu członka oznaczany przez licencję.

dateCreated

string

[Readonly] Data dodania elementu członkowskiego do kolekcji.

groupAssignments

GroupEntitlement[]

[Readonly] GroupEntitlements, do którego należy ten element członkowski.

id

string

Unikatowy identyfikator zgodny z identyfikatorem tożsamości skojarzonej z elementem GraphMember.

lastAccessedDate

string

[Readonly] Data ostatniego dostępu do kolekcji przez członka.

projectEntitlements

ProjectEntitlement[]

Relacja między projektem a obowiązującymi uprawnieniami członka w tym projekcie.

user

GraphUser

Odwołanie użytkownika.