REST Resource: customers.configurations

리소스: 구성

구성은 Android 기기의 프로비저닝 옵션을 수집합니다. 모든 구성에는 아래 항목이 포함되어 있습니다.

  • 기기에 설치된 EMM 기기 정책 컨트롤러 (DPC)
  • 기기에 적용된 EMM 정책
  • 설정 중에 사용자를 돕기 위해 기기에 표시되는 메타데이터입니다.

고객은 필요한 만큼 구성을 추가할 수 있습니다. 하지만 고객이 조직에서 구매하는 새 기기에 적용되는 기본 구성을 설정하면 제로터치 등록이 가장 잘 작동합니다.

JSON 표현 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
필드
name

string

출력 전용. customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] 형식의 API 리소스 이름입니다. 서버에서 할당됩니다.
configurationId

string (int64 format)

출력 전용. 구성의 ID입니다. 서버에서 할당됩니다.
configurationName

string

필수 항목입니다. 구성의 목적을 설명하는 짧은 이름입니다. 예: 영업팀 또는 임시직원 제로터치 등록 포털에서 이 이름이 IT 관리자에게 표시됩니다.
dpcResourcePath

string

필수 항목입니다. 선택한 DPC (기기 정책 컨트롤러)의 리소스 이름으로 customers/[CUSTOMER_ID]/dpcs/* 형식입니다. 지원되는 DPC를 나열하려면 customers.dpcs.list를 호출합니다.
dpcExtras

string

DPC에 전달되는 JSON 형식의 EMM 프로비저닝 추가 항목입니다.
companyName

string

필수 항목입니다. 조직의 이름입니다. 제로터치 등록은 기기 프로비저닝 중에 기기 사용자에게 이 조직 이름을 표시합니다.
contactEmail

string

필수 항목입니다. 기기 사용자가 도움을 받기 위해 연락할 수 있는 이메일 주소입니다. 제로터치 등록에서 기기 프로비저닝을 시작하기 전에 기기 사용자에게 이 이메일 주소를 표시합니다. 입력 시 값이 검증됩니다.
contactPhone

string

필수 항목입니다. 기기 사용자가 다른 기기를 사용하여 도움을 요청할 수 있는 전화번호입니다. 제로터치 등록은 기기 프로비저닝 전에 기기 사용자에게 이 숫자를 표시합니다. 숫자, 공백, 더하기 기호, 하이픈, 괄호를 사용할 수 있습니다.
customMessage

string

기기 사용자에게 도움을 받거나 기기 상황에 관한 세부정보를 제공하는 데 도움이 되는 한두 개의 문장이 포함된 메시지 제로터치 등록에서 기기 프로비저닝을 시작하기 전에 이 메시지를 표시합니다.
isDefault

boolean

필수 항목입니다. 향후 조직에서 구매하는 모든 새 기기에 제로터치 등록이 적용되는 기본 구성인지 여부 하나의 고객 구성만 기본값으로 설정할 수 있습니다. 이 값을 true로 설정하면 이전 기본 구성의 isDefault 값이 false로 변경됩니다.
forcedResetTime

string (Duration format)

선택사항입니다. 일반적으로 설정 마법사를 실행하는 동안 네트워크 연결 부족으로 인해 기기가 설정 마법사에서 프로비저닝을 통과하지 못하면 기기를 강제로 초기화합니다. 범위는 0~6시간이며 설정되지 않은 경우 기본값은 2시간입니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다. 예: "3.5s"

방법

create

 새 구성을 만듭니다.

delete

 사용하지 않는 구성을 삭제합니다.

get

 구성의 세부정보를 가져옵니다.

list

 고객의 구성을 나열합니다.

patch

 구성의 필드 값을 업데이트합니다.