REST Resource: enterprises.enrollmentTokens

ทรัพยากร: EnrollmentToken

โทเค็นการลงทะเบียน

การแสดง JSON
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
ช่อง
name

string

ชื่อของโทเค็นการลงทะเบียนซึ่งเซิร์ฟเวอร์สร้างขึ้นระหว่างการสร้างในรูปแบบ enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}

value

string

ค่าโทเค็นที่ส่งไปยังอุปกรณ์และให้สิทธิ์อุปกรณ์ลงทะเบียน นี่คือฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น

duration

string (Duration format)

ระยะเวลาของโทเค็นการลงทะเบียนที่ใช้ได้ตั้งแต่ 1 นาทีถึง Durations.MAX_VALUE หรือประมาณ 10,000 ปี หากไม่ได้ระบุไว้ ระยะเวลาเริ่มต้นคือ 1 ชั่วโมง โปรดทราบว่าหากระยะเวลาที่ขอทำให้ expirationTimestamp ผลลัพธ์มีค่าเกิน Timestamps.MAX_VALUE ระบบจะเปลี่ยน expirationTimestamp เป็น Timestamps.MAX_VALUE

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

expirationTimestamp

string (Timestamp format)

เวลาหมดอายุของโทเค็น นี่คือฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

policyName

string

ชื่อของนโยบายที่นำไปใช้กับอุปกรณ์ที่ลงทะเบียนในตอนแรกในรูปแบบ enterprises/{enterpriseId}/policies/{policyId} หากไม่ได้ระบุไว้ ระบบจะใช้ policyName สำหรับผู้ใช้อุปกรณ์ หากไม่ได้ระบุ userName ด้วย ระบบจะใช้ enterprises/{enterpriseId}/policies/default โดยค่าเริ่มต้น เมื่ออัปเดตช่องนี้ คุณจะระบุเฉพาะ policyId ได้ตราบใดที่ policyId ไม่มีเครื่องหมายทับ ชื่อนโยบายส่วนที่เหลือจะได้รับการอนุมาน

additionalData

string

ข้อมูลที่กําหนดเองที่ไม่บังคับซึ่งเชื่อมโยงกับโทเค็นการลงทะเบียน ข้อมูลนี้อาจมี เช่น รหัสของหน่วยขององค์กรที่มอบหมายอุปกรณ์ให้หลังการลงทะเบียน หลังจากที่อุปกรณ์ลงทะเบียนด้วยโทเค็น ข้อมูลนี้จะแสดงในช่อง enrollmentTokenData ของทรัพยากร Device ข้อมูลต้องมีอักขระไม่เกิน 1,024 ตัว มิฉะนั้น คำขอสร้างจะดำเนินการไม่สำเร็จ

qrCode

string

สตริง JSON ที่มีการแสดงแบบ UTF-8 เพื่อสร้างคิวอาร์โค้ดเพื่อลงทะเบียนอุปกรณ์ด้วยโทเค็นการลงทะเบียนนี้ได้ หากต้องการลงทะเบียนอุปกรณ์โดยใช้ NFC ระเบียน NFC จะต้องมีการแทนค่าพร็อพเพอร์ตี้ java.util.Properties แบบอนุกรมใน JSON

oneTimeOnly

boolean

โทเค็นการลงทะเบียนใช้เพียงครั้งเดียวหรือไม่ หากตั้งค่าสถานะเป็น "จริง" จะใช้ได้เพียง 1 อุปกรณ์เท่านั้นที่สามารถใช้สำหรับการลงทะเบียน

user
(deprecated)

object (User)

ช่องนี้เลิกใช้งานแล้วและจะไม่มีการสนใจค่าดังกล่าว

allowPersonalUsage

enum (AllowPersonalUsage)

ควบคุมว่าจะอนุญาตให้ใช้การใช้งานส่วนตัวในอุปกรณ์ที่จัดสรรด้วยโทเค็นการลงทะเบียนนี้หรือไม่

สำหรับอุปกรณ์ของบริษัท

  • การเปิดใช้การใช้งานส่วนตัวจะทำให้ผู้ใช้ตั้งค่าโปรไฟล์งานในอุปกรณ์ได้
  • ผู้ใช้ต้องจัดสรรอุปกรณ์ให้เป็นอุปกรณ์ที่มีการจัดการครบวงจรเพื่อปิดใช้งานการใช้งานส่วนตัว

สำหรับอุปกรณ์ส่วนตัว

  • การเปิดใช้การใช้งานส่วนตัวจะทำให้ผู้ใช้ตั้งค่าโปรไฟล์งานในอุปกรณ์ได้
  • การปิดใช้การใช้งานส่วนตัวจะทำให้อุปกรณ์ไม่สามารถจัดสรรได้ ปิดใช้งานการใช้งานส่วนตัวในอุปกรณ์ส่วนตัวไม่ได้

เมธอด

create

สร้างโทเค็นการลงทะเบียนสำหรับองค์กรที่ระบุ

delete

ลบโทเค็นการลงทะเบียน

get

รับโทเค็นการลงทะเบียนที่ใช้งานอยู่และยังไม่หมดอายุ

list

แสดงรายการโทเค็นการลงทะเบียนที่ใช้งานอยู่และยังไม่หมดอายุขององค์กรหนึ่งๆ