Service Principal Entitlements - Update Service Principal Entitlement

Referência

Service:: Member Entitlement Management

API Version:: 7.1-preview.1

Edite os direitos (Licença, Extensões, Projetos, Teams etc.) para uma entidade de serviço.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
servicePrincipalId	path	True	string uuid	ID da entidade de serviço.
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da API.

Corpo da solicitação

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

Nome	Tipo	Description
from	string	O caminho do qual copiar para a operação Mover/Copiar.
op	Operation	A operação de patch
path	string	O caminho para a operação. No caso de uma matriz, um índice baseado em zero pode ser usado para especificar a posição na matriz (por exemplo, /biscuits/0/name). O caractere "-" pode ser usado em vez de um índice para inserir no final da matriz (por exemplo, /biscuits/-).
value	object	O valor da operação. Este é um primitivo ou um JToken.

Respostas

Nome	Tipo	Description
200 OK	ServicePrincipalEntitlementsPatchResponse	operação bem-sucedida

Segurança

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

Nome	Description
vso.memberentitlementmanagement_write	Concede a capacidade de gerenciar usuários, suas licenças, bem como projetos e extensões que eles podem acessar

Exemplos

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

Definições

Nome	Description
AccessLevel	Licença atribuída a um usuário
AccountLicenseType	Tipo de licença de conta (por exemplo, Express, Stakeholder etc.). Para usar o AccountLicenseType, LicensingSource deve ser definido como 'account' no corpo da solicitação.
AccountUserStatus	Status de usuário na conta
AssignmentSource	Origem da atribuição da licença (por exemplo, Grupo, Desconhecido etc.
GraphGroup	Entidade de grupo do Graph
GraphServicePrincipal
GraphUser
Group	Grupo de Projetos (por exemplo, Colaborador, Leitor etc.)
GroupEntitlement	Uma entidade de grupo com propriedades adicionais, incluindo sua licença, extensões e associação de projeto
GroupLicensingRuleStatus	O status da regra de grupo.
GroupType	Tipo de Grupo
JsonPatchDocument	O modelo JSON para operações de patch JSON
LicensingSource	Fonte de licenciamento (por exemplo, Conta. MSDN etc.)
MsdnLicenseType	Tipo de licença msdn (por exemplo, Visual Studio Professional, Visual Studio Enterprise etc.). Para usar o MsdnLicenseType, LicensingSource deve ser definido como 'msdn' no corpo da solicitação.
Operation	A operação de patch
ProjectEntitlement	Relação entre um projeto e as permissões efetivas do usuário nesse projeto.
ProjectPermissionInherited	Se o usuário está herdando permissões para um projeto por meio de uma associação de grupo do Azure DevOps ou do AAD.
ProjectRef	Uma referência a um projeto
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ServicePrincipalEntitlement
ServicePrincipalEntitlementOperationResult
ServicePrincipalEntitlementsPatchResponse
TeamRef	Uma referência a uma equipe
UserEntitlement	Uma entidade de usuário com propriedades adicionais, incluindo sua licença, extensões e associação de projeto

AccessLevel

Licença atribuída a um usuário

Nome	Tipo	Description
accountLicenseType	AccountLicenseType	Tipo de licença de conta (por exemplo, Express, Stakeholder etc.). Para usar o AccountLicenseType, LicensingSource deve ser definido como 'account' no corpo da solicitação.
assignmentSource	AssignmentSource	Origem da atribuição da licença (por exemplo, Grupo, Desconhecido etc.
licenseDisplayName	string	Nome de exibição da Licença
licensingSource	LicensingSource	Fonte de licenciamento (por exemplo, Conta. MSDN etc.)
msdnLicenseType	MsdnLicenseType	Tipo de licença msdn (por exemplo, Visual Studio Professional, Visual Studio Enterprise etc.). Para usar o MsdnLicenseType, LicensingSource deve ser definido como 'msdn' no corpo da solicitação.
status	AccountUserStatus	Status de usuário na conta
statusMessage	string	Mensagem de status.

AccountLicenseType

Tipo de licença de conta (por exemplo, Express, Stakeholder etc.). Para usar o AccountLicenseType, LicensingSource deve ser definido como 'account' no corpo da solicitação.

Nome	Tipo	Description
advanced	string
earlyAdopter	string
express	string
none	string
professional	string
stakeholder	string

AccountUserStatus

Status de usuário na conta

Nome	Tipo	Description
active	string	O usuário entrou pelo menos uma vez na conta do VSTS
deleted	string	O usuário é removido da conta do VSTS pelo administrador da conta do VSTS
disabled	string	O usuário não pode entrar; usado principalmente pelo administrador para remover temporariamente um usuário devido à ausência ou realocação de licença
expired	string	O usuário pode entrar; usado principalmente quando a licença está em estado expirado e damos um período de carência
none	string
pending	string	O usuário é convidado a ingressar na conta do VSTS pelo administrador da conta do VSTS, mas ainda não se inscreveu/se inscreveu
pendingDisabled	string	O usuário está desabilitado; se reabilitado, eles ainda estarão no estado Pendente

AssignmentSource

Origem da atribuição da licença (por exemplo, Grupo, Desconhecido etc.

Nome	Tipo	Description
groupRule	string
none	string
unknown	string

GraphGroup

Entidade de grupo do Graph

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
description	string	Uma frase curta para ajudar os leitores humanos a desambiguar grupos com nomes semelhantes
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.
displayName	string	Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
domain	string	Isso representa o nome do contêiner de origem de um membro do grafo. (Para MSA, essa é a "ID do Windows Live", para o AD o nome do domínio, para o AAD a tenantID do diretório, para grupos de VSTS, ScopeId etc.
legacyDescriptor	string	[Somente uso interno] O descritor herdado está aqui caso você precise acessar o IMS da versão antiga usando o descritor de identidade.
mailAddress	string	O endereço de email do registro de um determinado membro do grafo. Isso pode ser diferente do nome da entidade de segurança.
origin	string	O tipo de provedor de origem para o identificador de origem (ex:AD, AAD, MSA)
originId	string	O identificador exclusivo do sistema de origem. Normalmente, um sid, id de objeto ou Guid. As operações de vinculação e desvinculação podem fazer com que esse valor seja alterado para um usuário porque o usuário não tem suporte de um provedor diferente e tem uma ID exclusiva diferente no novo provedor.
principalName	string	Este é o PrincipalName desse membro de grafo do provedor de origem. O provedor de origem pode alterar esse campo ao longo do tempo e não é garantido que ele seja imutável durante a vida útil do membro do grafo pelo VSTS.
subjectKind	string	Esse campo identifica o tipo da entidade do grafo (por exemplo: Grupo, Escopo, Usuário).
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

GraphServicePrincipal

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
applicationId	string
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.
directoryAlias	string	O nome curto e geralmente exclusivo para o usuário no diretório de suporte. Para usuários do AAD, isso corresponde ao apelido de email, que geralmente é, mas não necessariamente semelhante à parte do endereço de email do usuário antes do sinal @ . Para usuários do GitHub, isso corresponde ao identificador de usuário do GitHub.
displayName	string	Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
domain	string	Isso representa o nome do contêiner de origem de um membro do grafo. (Para MSA, essa é a "ID do Windows Live", para o AD o nome do domínio, para o AAD a tenantID do diretório, para grupos de VSTS, ScopeId etc.
isDeletedInOrigin	boolean	Quando true, o grupo foi excluído no provedor de identidade
legacyDescriptor	string	[Somente uso interno] O descritor herdado está aqui caso você precise acessar o IMS da versão antiga usando o descritor de identidade.
mailAddress	string	O endereço de email do registro de um determinado membro do grafo. Isso pode ser diferente do nome da entidade de segurança.
metaType	string	O meta tipo do usuário na origem, como "membro", "convidado", etc. Consulte UserMetaType para obter o conjunto de valores possíveis.
origin	string	O tipo de provedor de origem para o identificador de origem (ex:AD, AAD, MSA)
originId	string	O identificador exclusivo do sistema de origem. Normalmente, um sid, id de objeto ou Guid. As operações de vinculação e desvinculação podem fazer com que esse valor seja alterado para um usuário porque o usuário não tem suporte de um provedor diferente e tem uma ID exclusiva diferente no novo provedor.
principalName	string	Este é o PrincipalName desse membro de grafo do provedor de origem. O provedor de origem pode alterar esse campo ao longo do tempo e não é garantido que ele seja imutável durante a vida útil do membro do grafo pelo VSTS.
subjectKind	string	Esse campo identifica o tipo da entidade do grafo (por exemplo: Grupo, Escopo, Usuário).
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

GraphUser

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.
directoryAlias	string	O nome curto e geralmente exclusivo para o usuário no diretório de suporte. Para usuários do AAD, isso corresponde ao apelido de email, que geralmente é, mas não necessariamente semelhante à parte do endereço de email do usuário antes do sinal @ . Para usuários do GitHub, isso corresponde ao identificador de usuário do GitHub.
displayName	string	Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
domain	string	Isso representa o nome do contêiner de origem de um membro do grafo. (Para MSA, essa é a "ID do Windows Live", para o AD o nome do domínio, para o AAD a tenantID do diretório, para grupos de VSTS, ScopeId etc.
isDeletedInOrigin	boolean	Quando true, o grupo foi excluído no provedor de identidade
legacyDescriptor	string	[Somente uso interno] O descritor herdado está aqui caso você precise acessar o IMS da versão antiga usando o descritor de identidade.
mailAddress	string	O endereço de email do registro de um determinado membro do grafo. Isso pode ser diferente do nome da entidade de segurança.
metaType	string	O meta tipo do usuário na origem, como "membro", "convidado", etc. Consulte UserMetaType para obter o conjunto de valores possíveis.
origin	string	O tipo de provedor de origem para o identificador de origem (ex:AD, AAD, MSA)
originId	string	O identificador exclusivo do sistema de origem. Normalmente, um sid, id de objeto ou Guid. As operações de vinculação e desvinculação podem fazer com que esse valor seja alterado para um usuário porque o usuário não tem suporte de um provedor diferente e tem uma ID exclusiva diferente no novo provedor.
principalName	string	Este é o PrincipalName desse membro de grafo do provedor de origem. O provedor de origem pode alterar esse campo ao longo do tempo e não é garantido que ele seja imutável durante a vida útil do membro do grafo pelo VSTS.
subjectKind	string	Esse campo identifica o tipo da entidade do grafo (por exemplo: Grupo, Escopo, Usuário).
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

Group

Grupo de Projetos (por exemplo, Colaborador, Leitor etc.)

Nome	Tipo	Description
displayName	string	Nome de exibição do grupo
groupType	GroupType	Tipo de Grupo

GroupEntitlement

Uma entidade de grupo com propriedades adicionais, incluindo sua licença, extensões e associação de projeto

Nome	Tipo	Description
group	GraphGroup	Referência de membro.
id	string	O identificador exclusivo que corresponde à ID do GraphMember.
lastExecuted	string	[Somente leitura] A última vez que a regra de licenciamento de grupo foi executada (independentemente de alguma alteração ter sido feita).
licenseRule	AccessLevel	Regra de Licença.
members	UserEntitlement[]	Membros do grupo. Usado somente ao criar um novo grupo.
projectEntitlements	ProjectEntitlement[]	Relação entre um projeto e as permissões efetivas do membro nesse projeto.
status	GroupLicensingRuleStatus	O status da regra de grupo.

GroupLicensingRuleStatus

O status da regra de grupo.

Nome	Tipo	Description
applied	string	A regra é aplicada
applyPending	string	A regra é criada ou atualizada, mas a aplicação está pendente
incompatible	string	A regra de grupo era incompatível
unableToApply	string	Falha ao aplicar a regra inesperadamente e deve ser repetida

GroupType

Tipo de Grupo

Nome	Tipo	Description
custom	string
projectAdministrator	string
projectContributor	string
projectReader	string
projectStakeholder	string

JsonPatchDocument

O modelo JSON para operações de patch JSON

Nome	Tipo	Description
from	string	O caminho do qual copiar para a operação Mover/Copiar.
op	Operation	A operação de patch
path	string	O caminho para a operação. No caso de uma matriz, um índice baseado em zero pode ser usado para especificar a posição na matriz (por exemplo, /biscuits/0/name). O caractere "-" pode ser usado em vez de um índice para inserir no final da matriz (por exemplo, /biscuits/-).
value	object	O valor da operação. Este é um primitivo ou um JToken.

LicensingSource

Fonte de licenciamento (por exemplo, Conta. MSDN etc.)

Nome	Tipo	Description
account	string
auto	string
msdn	string
none	string
profile	string
trial	string

MsdnLicenseType

Tipo de licença msdn (por exemplo, Visual Studio Professional, Visual Studio Enterprise etc.). Para usar o MsdnLicenseType, LicensingSource deve ser definido como 'msdn' no corpo da solicitação.

Nome	Tipo	Description
eligible	string
enterprise	string
none	string
platforms	string
premium	string
professional	string
testProfessional	string
ultimate	string

Operation

A operação de patch

Nome	Tipo	Description
add	string
copy	string
move	string
remove	string
replace	string
test	string

ProjectEntitlement

Relação entre um projeto e as permissões efetivas do usuário nesse projeto.

Nome	Tipo	Description
assignmentSource	AssignmentSource	Origem da atribuição (por exemplo, Grupo ou Desconhecido).
group	Group	Grupo de Projetos (por exemplo, Colaborador, Leitor etc.)
projectPermissionInherited	ProjectPermissionInherited	Se o usuário está herdando permissões para um projeto por meio de uma associação de grupo do Azure DevOps ou do AAD.
projectRef	ProjectRef	Ref do Projeto
teamRefs	TeamRef[]	Team Ref.

ProjectPermissionInherited

Se o usuário está herdando permissões para um projeto por meio de uma associação de grupo do Azure DevOps ou do AAD.

Nome	Tipo	Description
inherited	string
notInherited	string
notSet	string

ProjectRef

Uma referência a um projeto

Nome	Tipo	Description
id	string	ID do Projeto.
name	string	Nome do Projeto.

ReferenceLinks

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.