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

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