Service Principals - List
지정된 범위의 모든 서비스 주체 목록을 가져옵니다.
서비스 주체 목록이 클 수 있으므로 결과는 서비스 주체의 페이지에 반환됩니다. 단일 페이지에서 반환할 수 있는 것보다 많은 결과가 있는 경우 결과 집합에는 다음 결과 집합을 검색하기 위한 연속 토큰이 포함됩니다. 더 이상 서비스 주체가 남아 있지 않은지 알 수 있는 유일한 방법은 연속 토큰이 없다는 것입니다.
GET https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals?api-version=7.1-preview.1
GET https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals?continuationToken={continuationToken}&scopeDescriptor={scopeDescriptor}&api-version=7.1-preview.1
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 조직의 이름입니다. |
api-version
|
query | True |
string |
사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1-preview.1'로 설정해야 합니다. |
continuation
|
query |
string |
이전 페이지가 종료된 직후에 다음 데이터 페이지를 다시 시작할 수 있는 불투명 데이터 Blob입니다. 더 많은 데이터가 남아 있는지 알 수 있는 유일한 신뢰할 수 있는 방법은 연속 토큰의 존재입니다. |
|
scope
|
query |
string |
기본이 아닌 범위(컬렉션, 프로젝트)를 지정하여 서비스 주체를 검색합니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
성공적인 작업 Headers X-MS-ContinuationToken: string |
보안
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
Name | Description |
---|---|
vso.graph | 사용자, 그룹, 범위 및 그룹 멤버 자격 정보를 읽을 수 있는 권한을 부여합니다. |
예제
Sample Request
GET https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals?api-version=7.1-preview.1
Sample Response
{
"count": 2,
"value": [
{
"subjectKind": "servicePrincipal",
"applicationId": "57227acc-068c-4bd0-b122-76af4ca8156d",
"directoryAlias": "db2b37a2-4d17-4de2-b935-59d43396a001",
"domain": "62e2ee3f-dbd4-48d8-9b85-4a3776783e13",
"principalName": "db2b37a2-4d17-4de2-b935-59d43396a001",
"mailAddress": null,
"origin": "aad",
"originId": "db2b37a2-4d17-4de2-b935-59d43396a001",
"displayName": "ServicePrincipalDisplayName",
"_links": {
"self": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/ServicePrincipals/aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx"
},
"memberships": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/Memberships/aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx"
},
"membershipState": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/MembershipStates/aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx"
},
"storageKey": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/StorageKeys/aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx"
},
"avatar": {
"href": "https://dev.azure.com/Fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx"
}
},
"url": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/ServicePrincipals/aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx",
"descriptor": "aadsp.OGY2Njg2ODQtOTAzMi03NWE2LWFiZDctMGJhMDUzYjhiNTIx"
},
{
"subjectKind": "servicePrincipal",
"applicationId": "4461fafd-3c00-43b1-9e9a-5c554405a9d3",
"directoryAlias": "eb8f407c-9b55-4e8a-acab-7416774c5479",
"domain": "62e2ee3f-dbd4-48d8-9b85-4a3776783e13",
"principalName": "eb8f407c-9b55-4e8a-acab-7416774c5479",
"mailAddress": null,
"origin": "aad",
"originId": "eb8f407c-9b55-4e8a-acab-7416774c5479",
"displayName": "ServicePrincipalDispalyName2",
"_links": {
"self": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/ServicePrincipals/aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5"
},
"memberships": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/Memberships/aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5"
},
"membershipState": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/MembershipStates/aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5"
},
"storageKey": {
"href": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/StorageKeys/aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5"
},
"avatar": {
"href": "https://dev.azure.com/Fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5"
}
},
"url": "https://vssps.dev.azure.com/Fabrikam/_apis/Graph/ServicePrincipals/aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5",
"descriptor": "aadsp.MjBlZDFjMDktMDRhNC03NjYwLThjNjEtZWQ4ZjZhY2ZhNDE5"
}
]
}
정의
Name | Description |
---|---|
Graph |
|
Reference |
REST 참조 링크의 컬렉션을 나타내는 클래스입니다. |
GraphServicePrincipal
Name | 형식 | Description |
---|---|---|
_links |
이 필드에는 그래프 제목에 대한 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은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다. |
ReferenceLinks
REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
Name | 형식 | Description |
---|---|---|
links |
object |
링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다. |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기