제어판 공급업체로 고객 동의 가져오기
CPV(제어판 공급업체)에서는 REST API를 사용하여 CSP 고객의 동의를 획득하고 제거하여 테넌트에 대한 권한을 가져올 수 있습니다.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
메모
속도 제한은 각 applicationId(CPV 파트너의 애플리케이션 ID)에 대한 초당 50개 요청(RPS)입니다.
동의 획득
URI 매개 변수
| 이름 | 안으로 | 필수 | 유형 | 묘사 |
|---|---|---|---|---|
| 고객 ID | 길 | 사실 | 문자열 | 파트너 센터에서 생성된 고객의 ID |
요청 헤더
미디어 유형: application/json
| 이름 | 필수 | 유형 | 묘사 |
|---|---|---|---|
| 권한 부여 | 사실 | 문자열 | 대상 그룹 https://api.partnercenter.microsoft.com 대한 액세스 토큰 |
| 받아들이다 | 사실 | 문자열 | 허용 가능한 콘텐츠 형식; 널리 허용되는 형식 애플리케이션/json |
| ms-correlationid | 문자열 | 내부적으로 요청을 추적하는 데 사용됩니다. ms-correlationid가 제공되지 않으면 서버는 각 요청에 대해 새 것을 생성합니다. | |
| ms-requestid | 문자열 | 요청의 멱등성을 확보하는 데 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다. |
요청 본문
미디어 유형: application/json
| 이름 | 유형 | 묘사 |
|---|---|---|
| applicationId | 문자열 | CPV 파트너의 애플리케이션 ID |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | 테넌트 내에서 고객의 액세스 권한을 얻기 위한 애플리케이션 액세스 권한 목록 |
응답
| 이름 | 유형 | 묘사 |
|---|---|---|
| 200 OK | 요청이 성공했습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 201 생성됨 | 애플리케이션 동의가 생성됩니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 400 잘못된 요청 | 입력이 없거나 잘못되었습니다. 응답 본문에는 오류 세부 정보가 포함됩니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 401 권한 없음 | 요청이 인증되지 않았습니다. 클라이언트는 유효한 대상 그룹에 유효한 액세스 토큰을 전달해야 합니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 403 금지됨 | 요청이 인증되었지만 호출자가 호출할 권한이 없기 때문에 거부되었습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 404 찾을 수 없음 | 리소스를 찾을 수 없거나 지정된 입력 매개 변수와 함께 사용할 수 없습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 500 내부 서버 오류 | 파트너 API 서비스 또는 해당 종속성 중 하나가 요청을 충족하지 못했습니다. 호출자는 요청을 다시 시도할 수 있습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
정의
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| 이름 | 유형 | 묘사 |
|---|---|---|
| 엔터프라이즈 애플리케이션 ID | 문자열 | 액세스 권한을 얻는 리소스의 GUID 표현 |
| 범위 | 문자열 | 액세스 권한을 얻기 위한 범위의 쉼표로 구분된 값 |
동의 제거
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
메모
속도 제한은 각 applicationId(CPV 파트너의 애플리케이션 ID)에 대한 초당 50개 요청(RPS)입니다.
URI 매개 변수
| 이름 | 안으로 | 필수 | 유형 | 묘사 |
|---|---|---|---|---|
| 고객 ID | 길 | 사실 | 문자열 | 파트너 센터에서 생성된 고객의 ID |
| 애플리케이션_아이디 | 길 | 사실 | 문자열 | CPV 애플리케이션의 ID |
요청 헤더
미디어 유형: application/json
| 이름 | 필수 | 유형 | 묘사 |
|---|---|---|---|
| 권한 부여 | 사실 | 문자열 | 대상 그룹 https://api.partnercenter.microsoft.com에 대한 액세스 토큰 |
| 받아들이다 | 사실 | 문자열 | 허용되는 콘텐츠 형식( 일반적으로 application/json 형식) |
| ms-correlationid | 문자열 | 내부적으로 요청을 추적하는 데 사용됩니다.
ms-correlationid 제공되지 않으면 서버는 각 요청에 대해 새 ms-correlationid 생성합니다. |
|
| ms-requestid | 문자열 | 요청의 멱등성(idempotency)에 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다. |
응답
| 이름 | 유형 | 묘사 |
|---|---|---|
| 200 OK | 요청이 성공했습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 201 생성됨 | 애플리케이션 동의가 삭제됩니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 400 잘못된 요청 | 입력이 없거나 잘못되었습니다. 응답 본문에는 오류 세부 정보가 포함됩니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 401 권한 없음 | 요청이 인증되지 않았습니다. 클라이언트는 유효한 대상 그룹에 유효한 액세스 토큰을 전달해야 합니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 403 금지됨 | 요청이 인증되었지만 호출자가 호출할 권한이 없기 때문에 거부되었습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 404 찾을 수 없음 | 리소스를 찾을 수 없거나 지정된 입력 매개 변수와 함께 사용할 수 없습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
|
| 500 내부 서버 오류 | 파트너 API 서비스 또는 해당 종속성 중 하나가 요청을 충족하지 못했습니다. 호출자는 요청을 다시 시도할 수 있습니다. 미디어 형식: application/json, application/xml, text/xml, text/json |
관련 콘텐츠
- 고객 계약 대한 고객 동의 확인