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