Service Principal Entitlements - Update Service Principal Entitlement

リファレンス

Service:: Member Entitlement Management

API Version:: 7.1-preview.1

サービスプリンシパルのエンタイトルメント (ライセンス、拡張機能、プロジェクト、Teams など) を編集します。

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
servicePrincipalId	path	True	string uuid	サービスプリンシパルの ID。
api-version	query	True	string	使用する API のバージョン。このバージョンの API を使用するには、これを '7.1-preview.1' に設定する必要があります。

要求本文

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

名前	型	説明
from	string	移動/コピー操作のコピー元のパス。
op	Operation	パッチ操作
path	string	操作のパス。配列の場合、0 から始まるインデックスを使用して、配列内の位置を指定できます (例: /menus/0/name)。配列の末尾に挿入するインデックスの代わりに "-" 文字を使用できます (例: /biscuits/-)。
value	object	操作の値。これはプリミティブまたは JToken です。

応答

名前	型	説明
200 OK	ServicePrincipalEntitlementsPatchResponse	成功した操作

セキュリティ

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

名前	説明
vso.memberentitlementmanagement_write	ユーザー、ライセンス、およびアクセスできるプロジェクトと拡張機能を管理する機能を付与します

例

Sample Request

HTTP

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

Status code:: 200

{
  "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": []
  }
}

定義

名前	説明
AccessLevel	ユーザーに割り当てられたライセンス
AccountLicenseType	アカウントライセンスの種類 (Express、利害関係者など)。 AccountLicenseType を使用するには、LicensingSource を要求本文で 'account' として定義する必要があります。
AccountUserStatus	アカウントのユーザーの状態
AssignmentSource	ライセンスの割り当て元 (グループ、不明など)
GraphGroup	グラフグループエンティティ
GraphServicePrincipal
GraphUser
Group	プロジェクトグループ (共同作成者、閲覧者など)
GroupEntitlement	ライセンス、拡張機能、プロジェクトメンバーシップなど、追加のプロパティを持つグループエンティティ
GroupLicensingRuleStatus	グループルールの状態。
GroupType	グループの種類
JsonPatchDocument	JSON パッチ操作の JSON モデル
LicensingSource	ライセンスソース (アカウントなど)。MSDN など)
MsdnLicenseType	MSDN ライセンスの種類 (Visual Studio Professional、Visual Studio Enterpriseなど)。 MsdnLicenseType を使用するには、LicensingSource を要求本文で 'msdn' として定義する必要があります。
Operation	パッチ操作
ProjectEntitlement	プロジェクトと、そのプロジェクトでのユーザーの有効なアクセス許可の関係。
ProjectPermissionInherited	ユーザーが Azure DevOps または AAD グループメンバーシップを使用してプロジェクトに対するアクセス許可を継承しているかどうか。
ProjectRef	プロジェクトへの参照
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ServicePrincipalEntitlement
ServicePrincipalEntitlementOperationResult
ServicePrincipalEntitlementsPatchResponse
TeamRef	チームへの参照
UserEntitlement	ライセンス、拡張機能、プロジェクトメンバーシップなど、追加のプロパティを持つユーザーエンティティ

AccessLevel

ユーザーに割り当てられたライセンス

名前	型	説明
accountLicenseType	AccountLicenseType	アカウントライセンスの種類 (Express、利害関係者など)。 AccountLicenseType を使用するには、LicensingSource を要求本文で 'account' として定義する必要があります。
assignmentSource	AssignmentSource	ライセンスの割り当て元 (グループ、不明など)
licenseDisplayName	string	ライセンスの表示名
licensingSource	LicensingSource	ライセンスソース (アカウントなど)。MSDN など)
msdnLicenseType	MsdnLicenseType	MSDN ライセンスの種類 (Visual Studio Professional、Visual Studio Enterpriseなど)。 MsdnLicenseType を使用するには、LicensingSource を要求本文で 'msdn' として定義する必要があります。
status	AccountUserStatus	アカウントのユーザーの状態
statusMessage	string	ステータスメッセージ。

AccountLicenseType

アカウントライセンスの種類 (Express、利害関係者など)。 AccountLicenseType を使用するには、LicensingSource を要求本文で 'account' として定義する必要があります。

名前	型	説明
advanced	string
earlyAdopter	string
express	string
none	string
professional	string
stakeholder	string

AccountUserStatus

アカウントのユーザーの状態

名前	型	説明
active	string	ユーザーが VSTS アカウントに少なくとも 1 回サインインしている
deleted	string	VSTS アカウント管理者によって VSTS アカウントからユーザーが削除される
disabled	string	ユーザーはサインインできません。主に、不在またはライセンスの再割り当てのためにユーザーを一時的に削除するために管理者によって使用されます
expired	string	ユーザーはサインインできます。ライセンスが期限切れ状態にあり、猶予期間が設けられたときに主に使用されます
none	string
pending	string	ユーザーは VSTS アカウント管理者によって VSTS アカウントに参加するように招待されていますが、まだサインアップまたはサインインしていません
pendingDisabled	string	ユーザーが無効になっています。再び実行可能な場合、それらは引き続き保留中の状態になります

AssignmentSource

ライセンスの割り当て元 (グループ、不明など)

名前	型	説明
groupRule	string
none	string
unknown	string

GraphGroup

グラフグループエンティティ

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップまたは詳細情報を取得できます。
description	string	人間の読者が同じような名前のグループをあいまいにするのを助ける短いフレーズ
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
displayName	string	これは、グラフの件名の一意でない表示名です。このフィールドを変更するには、ソースプロバイダーでその値を変更する必要があります。
domain	string	これは、グラフメンバーの元のコンテナーの名前を表します。 (MSA の場合、これは "Windows Live ID" です。AD の場合はドメインの名前、AAD の場合はディレクトリの tenantID、VSTS グループの場合は ScopeId など)
legacyDescriptor	string	[内部使用のみ]ID 記述子を使用して古いバージョンの IMS にアクセスする必要がある場合は、レガシ記述子がここにあります。
mailAddress	string	特定のグラフメンバーのレコードのメールアドレス。これはプリンシパル名とは異なる場合があります。
origin	string	配信元識別子のソースプロバイダーの種類 (例: AD、AAD、MSA)
originId	string	配信元のシステムからの一意の識別子。通常は、sid、オブジェクト ID、または Guid です。リンク操作とリンク解除操作では、ユーザーが別のプロバイダーによってサポートされておらず、新しいプロバイダーで異なる一意の ID を持っているため、ユーザーに対してこの値が変更される可能性があります。
principalName	string	これは、ソースプロバイダーのこのグラフメンバーの PrincipalName です。ソースプロバイダーは、時間の経過と同時にこのフィールドを変更する可能性があり、VSTS によってグラフメンバーの有効期間が不変であるとは限りません。
subjectKind	string	このフィールドは、グラフの件名の種類 (グループ、スコープ、ユーザーなど) を識別します。
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

GraphServicePrincipal

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの主題に関する追加のリレーションシップや詳細情報を取得できます。
applicationId	string
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	バッキングディレクトリ内のユーザーの短い一般的な一意の名前。 AAD ユーザーの場合、これはメールのニックネームに対応します。これは、多くの場合、@記号の前のユーザーのメールアドレスの部分とよく似ていますが、必ずしも似ているとは限りません。 GitHub ユーザーの場合、これは GitHub ユーザーハンドルに対応します。
displayName	string	これは、グラフの件名の一意でない表示名です。このフィールドを変更するには、ソースプロバイダーでその値を変更する必要があります。
domain	string	これは、グラフメンバーの元のコンテナーの名前を表します。 (MSA の場合、これは "Windows Live ID" です。AD の場合はドメインの名前、AAD の場合はディレクトリの tenantID、VSTS グループの場合は ScopeId など)
isDeletedInOrigin	boolean	true の場合、ID プロバイダーでグループが削除されました
legacyDescriptor	string	[内部使用のみ]ID 記述子を使用して古いバージョンの IMS にアクセスする必要がある場合は、レガシ記述子がここにあります。
mailAddress	string	特定のグラフメンバーのレコードのメールアドレス。これはプリンシパル名とは異なる場合があります。
metaType	string	"member"、"guest" など、配信元のユーザーのメタ型。使用可能な値のセットについては、「UserMetaType」を参照してください。
origin	string	配信元識別子のソースプロバイダーの種類 (例: AD、AAD、MSA)
originId	string	配信元のシステムからの一意の識別子。通常は、sid、オブジェクト ID、または Guid です。リンク操作とリンク解除操作では、ユーザーが別のプロバイダーによってサポートされておらず、新しいプロバイダーで異なる一意の ID を持っているため、ユーザーに対してこの値が変更される可能性があります。
principalName	string	これは、ソースプロバイダーのこのグラフメンバーの PrincipalName です。ソースプロバイダーは、時間の経過と同時にこのフィールドを変更する可能性があり、VSTS によってグラフメンバーの有効期間が不変であるとは限りません。
subjectKind	string	このフィールドは、グラフの件名の種類 (グループ、スコープ、ユーザーなど) を識別します。
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

GraphUser

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップまたは詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	バッキングディレクトリ内のユーザーの一般的な一意の短い名前。 AAD ユーザーの場合、これはメールのニックネームに対応します。これは、多くの場合、@記号の前のユーザーのメールアドレスの部分と必ずしも似ていますが、必ずしも似ています。 GitHub ユーザーの場合、これは GitHub ユーザーハンドルに対応します。
displayName	string	これは、グラフの件名の一意でない表示名です。このフィールドを変更するには、ソースプロバイダーでその値を変更する必要があります。
domain	string	これは、グラフメンバーの元のコンテナーの名前を表します。 (MSA の場合、AD の場合はドメインの名前、AAD の場合はディレクトリの tenantID、VSTS グループの場合は ScopeId など)
isDeletedInOrigin	boolean	true の場合、ID プロバイダーでグループが削除されました
legacyDescriptor	string	[内部使用のみ]ID 記述子を使用して古いバージョンの IMS にアクセスする必要がある場合は、レガシ記述子がここに表示されます。
mailAddress	string	特定のグラフメンバーのレコードの電子メールアドレス。これはプリンシパル名とは異なる場合があります。
metaType	string	配信元のユーザーのメタ型 ("member"、"guest"など)。使用可能な値のセットについては、「UserMetaType」を参照してください。
origin	string	配信元識別子 (例: AD、AAD、MSA) のソースプロバイダーの種類
originId	string	配信元のシステムからの一意の識別子。通常は、sid、オブジェクト ID、または Guid です。リンク操作とリンク解除操作では、ユーザーが別のプロバイダーによってサポートされておらず、新しいプロバイダーで異なる一意の ID を持っているため、ユーザーに対してこの値が変更される可能性があります。
principalName	string	これは、ソースプロバイダーのこのグラフメンバーの PrincipalName です。ソースプロバイダーは時間の経過と同時にこのフィールドを変更する可能性があり、VSTS によるグラフメンバーの有効期間中は不変であるとは限りません。
subjectKind	string	このフィールドは、グラフの件名の種類 (グループ、スコープ、ユーザーなど) を識別します。
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

Group

プロジェクトグループ (共同作成者、閲覧者など)

名前	型	説明
displayName	string	グループの表示名
groupType	GroupType	グループの種類

GroupEntitlement

ライセンス、拡張機能、プロジェクトメンバーシップなど、追加のプロパティを持つグループエンティティ

名前	型	説明
group	GraphGroup	メンバー参照。
id	string	GraphMember の ID と一致する一意識別子。
lastExecuted	string	[読み取りのみ]グループライセンス規則が最後に実行された時刻 (変更が行われたかどうかに関係なく)。
licenseRule	AccessLevel	ライセンス規則。
members	UserEntitlement[]	グループメンバー。新しいグループを作成する場合にのみ使用されます。
projectEntitlements	ProjectEntitlement[]	プロジェクトと、そのプロジェクトでのメンバーの有効なアクセス許可の関係。
status	GroupLicensingRuleStatus	グループルールの状態。

GroupLicensingRuleStatus

グループルールの状態。

名前	型	説明
applied	string	ルールが適用されます
applyPending	string	ルールは作成または更新されますが、適用は保留中です
incompatible	string	グループルールに互換性がありません
unableToApply	string	ルールが予期せず適用できなかったので、再試行する必要がある

GroupType

グループの種類

名前	型	説明
custom	string
projectAdministrator	string
projectContributor	string
projectReader	string
projectStakeholder	string

JsonPatchDocument

JSON パッチ操作の JSON モデル

名前	型	説明
from	string	移動/コピー操作のコピー元のパス。
op	Operation	パッチ操作
path	string	操作のパス。配列の場合、0 から始まるインデックスを使用して、配列内の位置を指定できます (例: /biscuits/0/name)。配列の末尾に挿入するインデックスの代わりに "-" 文字を使用できます (例: /biscuits/-)。
value	object	操作の値。これはプリミティブまたは JToken です。

LicensingSource

ライセンスソース (アカウントなど)。MSDN など)

名前	型	説明
account	string
auto	string
msdn	string
none	string
profile	string
trial	string

MsdnLicenseType

MSDN ライセンスの種類 (Visual Studio Professional、Visual Studio Enterpriseなど)。 MsdnLicenseType を使用するには、LicensingSource を要求本文で 'msdn' として定義する必要があります。

名前	型	説明
eligible	string
enterprise	string
none	string
platforms	string
premium	string
professional	string
testProfessional	string
ultimate	string

Operation

パッチ操作

名前	型	説明
add	string
copy	string
move	string
remove	string
replace	string
test	string

ProjectEntitlement

プロジェクトと、そのプロジェクトでのユーザーの有効なアクセス許可の関係。

名前	型	説明
assignmentSource	AssignmentSource	割り当てソース (グループや不明など)。
group	Group	プロジェクトグループ (共同作成者、閲覧者など)
projectPermissionInherited	ProjectPermissionInherited	ユーザーが Azure DevOps または AAD グループメンバーシップを使用してプロジェクトに対するアクセス許可を継承しているかどうか。
projectRef	ProjectRef	Project Ref
teamRefs	TeamRef[]	Team Ref.

ProjectPermissionInherited

ユーザーが Azure DevOps または AAD グループメンバーシップを使用してプロジェクトに対するアクセス許可を継承しているかどうか。

名前	型	説明
inherited	string
notInherited	string
notSet	string

ProjectRef

プロジェクトへの参照

名前	型	説明
id	string	プロジェクト ID。
name	string	プロジェクト名。

ReferenceLinks

REST 参照リンクのコレクションを表すクラス。

名前	型	説明
links	object	リンクの読み取り時ビュー。参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。