고객의 삭제된 사용자 보기

아티클
03/06/2024

고객 ID별로 고객에 대해 삭제된 CustomerUser 리소스 목록을 가져옵니다. 필요에 따라 페이지 크기를 설정할 수 있습니다. 필터를 제공해야 합니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱 + 사용자 자격 증명을 사용한 인증만 지원합니다.
고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 선택하여파트너 센터에서 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

사용자 계정을 삭제하면 어떻게 되나요?

사용자 계정을 삭제하면 사용자 상태가 "비활성"으로 설정됩니다. 다시 기본 30일 동안 사용자 계정과 관련 데이터가 제거되고 복구할 수 없게 됩니다. 30일 기간 내에 삭제된 사용자 계정을 복원하려면 고객에 대해 삭제된 사용자 복원을 참조하세요. 삭제되고 "비활성"으로 표시되면 사용자 계정은 더 이상 사용자 컬렉션의 구성원으로 반환되지 않습니다(예: 고객에 대한 모든 사용자 계정 목록 가져오기 사용). 아직 제거되지 않은 삭제된 사용자 목록을 얻으려면 비활성으로 설정된 사용자 계정을 쿼리해야 합니다.

C#

삭제된 사용자 목록을 검색하려면 상태 비활성으로 설정된 고객 사용자를 필터링하는 쿼리를 생성합니다. 먼저 다음 코드 조각과 같이 매개 변수를 사용하여 SimpleFieldFilter 개체를 인스턴스화하여 필터를 만듭니다. 그런 다음 BuildIndexedQuery 메서드를 사용하여 쿼리를 만듭니다. 페이지 단위의 결과가 필요하지 않으면 그 대신 BuildSimpleQuery 메서드를 사용할 수 있습니다. 다음으로, 고객 ID와 함께 IAggregatePartner.Customers.ById 메서드를 사용하여 고객을 식별합니다. 마지막으로 쿼리 메서드를 호출하여 요청을 보냅니다.

// IAggregatePartner partnerOperations;
// int customerUserPageSize;

// Create a filter for users whose status is inactive (i.e. deleted).
var filter = new SimpleFieldFilter("UserState", FieldFilterOperation.Equals, "Inactive");

// Build a paged query.
var simpleQueryWithFilter = QueryFactory.Instance.BuildIndexedQuery(customerUserPageSize, 0, filter);

// Send the request.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.Query(simpleQueryWithFilter);

샘플: 콘솔 테스트 앱. 프로젝트: 파트너 센터 SDK 샘플 클래스: GetCustomerInactiveUsers.cs

REST 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/customers/{customer-id}/users?size={size}&filter={filter} HTTP/1.1

URI 매개 변수

요청을 만들 때 다음 경로 및 쿼리 매개 변수를 사용합니다.

이름	Type	필수	설명
customer-id	guid	예	값은 고객을 식별하는 GUID 형식의 고객 ID입니다.
size	int	아니요	한 번에 표시할 결과 수입니다. 이 매개 변수는 선택 사항입니다.
filter	filter	예	사용자 검색을 필터링하는 쿼리입니다. 삭제된 사용자를 검색하려면 다음 문자열을 포함하고 인코딩해야 합니다. {"Field":"UserState","Value":"Inactive","Operator":"equals"}.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

없음.

요청 예제

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users?size=500&filter=%7B%22Field%22%3A%22UserState%22%2C%22Value%22%3A%22Inactive%22%2C%22Operator%22%3A%22equals%22%7D HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c11feb95-55d2-45b6-9d1b-74b55d2221fb
MS-CorrelationId: 2b4ab588-f48c-4874-b479-a61895e107b2
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 응답

성공하면 이 메서드는 응답 본문에 CustomerUser 리소스 컬렉션을 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

응답 예제

HTTP/1.1 200 OK
Content-Length: 802
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 690b34ca-07c8-4f8a-ab13-f22a50594a43
MS-RequestId: 1187f9ad-02b4-4d96-b668-7cf3d289467b
MS-CV: 3TLmR9gz6EaCVCjR.0
MS-ServerId: 101112616
Date: Fri, 20 Jan 2017 19:13:14 GMT

{
    "totalCount": 1,
    "items": [{
            "usageLocation": "US",
            "id": "a45f1416-3300-4f65-9e8d-f123b397a4ea",
            "userPrincipalName": "e83763f7f2204ac384cfcd49f79f2749@dtdemocspcustomer005.onmicrosoft.com",
            "firstName": "Ferdinand",
            "lastName": "Filibuster",
            "displayName": "Ferdinand",
            "userDomainType": "none",
            "state": "inactive",
            "softDeletionTime": "2017-01-20T00:33:34Z",
            "links": {
                "self": {
                    "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "CustomerUser"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users?size=500&filter=%7B%22Field%22%3A%22UserStatus%22%2C%22Value%22%3A%22Inactive%22%2C%22Operator%22%3A%22equals%22%7D",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

다음을 통해 공유