Method: enterprises.devices.issueCommand

向设备发出命令。返回的 Operation 资源在其 metadata 字段中包含 Command。使用 get operation 方法获取命令的状态。

HTTP 请求

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

网址采用 gRPC 转码语法。

路径参数

参数
name

string

设备的名称,格式为 enterprises/{enterpriseId}/devices/{deviceId}

请求正文

请求正文包含一个 Command 实例。

响应正文

如果成功,则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/androidmanagement

如需了解详情,请参阅 OAuth 2.0 Overview

命令

命令。

JSON 表示法
{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  },
  "addEsimParams": {
    object (AddEsimParams)
  },
  "removeEsimParams": {
    object (RemoveEsimParams)
  },
  "requestDeviceInfoParams": {
    object (RequestDeviceInfoParams)
  },
  "wipeParams": {
    object (WipeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  },
  "esimStatus": {
    object (EsimCommandStatus)
  },
  "requestDeviceInfoStatus": {
    object (RequestDeviceInfoStatus)
  }
  // End of list of possible types for union field status.
}
字段
type

enum (CommandType)

命令的类型。

createTime

string (Timestamp format)

相应命令的创建时间戳。时间戳由服务器自动生成。

采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

duration

string (Duration format)

命令的有效时长。如果设备在此期间未执行该命令,该命令将过期。如果未指定,则默认时长为 10 分钟。没有时长上限。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

userName

string

拥有相应设备的用户的资源名称,格式为 enterprises/{enterpriseId}/users/{userId}。这是由服务器根据命令发送到的设备自动生成的。

errorCode

enum (CommandErrorCode)

如果命令失败,则会显示说明失败原因的错误代码。如果命令被调用方取消,则不会设置此值。对于有关命令错误的推理,请按以下顺序优先选择字段(最优先选择的字段排在最前面):1. 特定于命令的字段,例如 clearAppsDataStatusstartLostModeStatus 或类似字段(如果存在)。2. 此字段(如果已设置)。3. 封装命令的 Operation 中的通用 error 字段。

newPassword

string

对于 RESET_PASSWORD 类型的命令,可选择指定新密码。注意:如果新密码是数字密码,在 Android 14 设备上,其长度必须至少为 6 个字符。否则,该命令将失败并显示 INVALID_VALUE

resetPasswordFlags[]

enum (ResetPasswordFlag)

对于 RESET_PASSWORD 类型的命令,可以选择性地指定标志。

联合字段 params。特定于命令的参数。请注意,某些命令不使用此参数,尤其是 LOCKRESET_PASSWORDREBOOTRELINQUISH_OWNERSHIP。未来,这些命令也可能会使用此功能。

如果设置了此字段,则不得设置 new_passwordreset_password_flags 字段。params 只能是下列其中一项:

clearAppsDataParams

object (ClearAppsDataParams)

用于清除设备中指定应用的数据的 CLEAR_APP_DATA 命令的参数。请参阅 ClearAppsDataParams。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 CLEAR_APP_DATA。也可以明确将 type 设置为 CLEAR_APP_DATA

startLostModeParams

object (StartLostModeParams)

用于将设备置于丢失模式的 START_LOST_MODE 命令的参数。请参阅 StartLostModeParams。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 START_LOST_MODE。也可以明确将 type 设置为 START_LOST_MODE

stopLostModeParams

object (StopLostModeParams)

用于使设备退出丢失模式的 STOP_LOST_MODE 命令的参数。请参阅 StopLostModeParams。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 STOP_LOST_MODE。也可以明确将 type 设置为 STOP_LOST_MODE

addEsimParams

object (AddEsimParams)

可选。用于向设备添加 eSIM 卡配置文件的 ADD_ESIM 命令的参数。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 ADD_ESIM。也可以明确将 type 设置为 ADD_ESIM

removeEsimParams

object (RemoveEsimParams)

可选。用于从设备中移除 eSIM 卡配置文件的 REMOVE_ESIM 命令的参数。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 REMOVE_ESIM。也可以明确将 type 设置为 REMOVE_ESIM

requestDeviceInfoParams

object (RequestDeviceInfoParams)

可选。用于获取设备相关信息的 REQUEST_DEVICE_INFO 命令的参数。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 REQUEST_DEVICE_INFO。也可以明确将 type 设置为 REQUEST_DEVICE_INFO

wipeParams

object (WipeParams)

可选。用于擦除设备的 WIPE 命令的参数。如果设置了此参数,建议不要设置 type。在这种情况下,服务器会自动将其设置为 WIPE。也可以明确将 type 设置为 WIPE

联合字段 status。特定于命令的状态。请注意,某些命令不使用此参数,尤其是 LOCKRESET_PASSWORDREBOOTRELINQUISH_OWNERSHIP。未来,这些命令也可能会使用此功能。status 只能是下列其中一项:
clearAppsDataStatus

object (ClearAppsDataStatus)

仅限输出。用于清除设备中指定应用数据的 CLEAR_APP_DATA 命令的状态。请参阅ClearAppsDataStatus

startLostModeStatus

object (StartLostModeStatus)

仅限输出。将设备置于丢失模式的 START_LOST_MODE 命令的状态。请参阅StartLostModeStatus

stopLostModeStatus

object (StopLostModeStatus)

仅限输出。STOP_LOST_MODE 命令的状态,用于使设备退出丢失模式。请参阅StopLostModeStatus

esimStatus

object (EsimCommandStatus)

仅限输出。ADD_ESIMREMOVE_ESIM 命令的状态。

requestDeviceInfoStatus

object (RequestDeviceInfoStatus)

仅限输出。REQUEST_DEVICE_INFO 命令的状态。

CommandType

命令类型。

枚举
COMMAND_TYPE_UNSPECIFIED 此值不允许。
LOCK 锁定设备,就像锁屏超时时间已过一样。
RESET_PASSWORD 重置用户的密码。
REBOOT 重新启动设备。仅在搭载 Android 7.0(API 级别 24)或更高版本的完全受管设备上受支持。
RELINQUISH_OWNERSHIP 从公司自有的 Android 8.0 及更高版本的设备中移除工作资料和所有政策,从而将设备用于个人用途。与个人资料关联的应用和数据会保留。设备在确认命令后,将从服务器中删除。
CLEAR_APP_DATA 清除指定应用的应用数据。Android 9 及更高版本支持此功能。请注意,应用可以将数据存储在其应用数据之外,例如存储在外部存储空间或用户字典中。另请参阅 clearAppsDataParams
START_LOST_MODE 将设备置于丢失模式。仅在全托管式设备或具有受管理资料的组织自有设备上受支持。另请参阅 startLostModeParams
STOP_LOST_MODE 使设备退出丢失模式。仅在全托管式设备或具有受管理资料的组织自有设备上受支持。另请参阅 stopLostModeParams
ADD_ESIM 向设备添加 eSIM 卡配置文件。Android 15 及更高版本支持此功能。另请参阅 addEsimParams。如需移除 eSIM 卡配置文件,请使用 REMOVE_ESIM 命令。如需确定在擦除设备时 eSIM 卡配置文件会发生什么情况,请在政策中设置 wipeDataFlags。注意:如需在单个设备上配置多个 eSIM 卡,建议在连续执行命令之间引入几分钟的延迟。
REMOVE_ESIM 从设备中移除 eSIM 卡配置文件。Android 15 及更高版本支持此功能。另请参阅 removeEsimParams
REQUEST_DEVICE_INFO 请求与设备相关的信息。
WIPE 通过将公司自有设备恢复出厂设置或删除装有工作资料的个人设备的工作资料来擦除设备。只有在设备确认该命令后,才会执行清空操作。在此之前,您可以取消该命令。

CommandErrorCode

命令错误代码。此字段是只读字段,由服务器填充。

枚举
COMMAND_ERROR_CODE_UNSPECIFIED 不存在错误。
UNKNOWN 发生未知错误。
API_LEVEL 设备的 API 级别不支持此命令。
MANAGEMENT_MODE 管理模式(资料所有者、设备所有者等)不支持该命令。
INVALID_VALUE 相应命令的参数值无效。
UNSUPPORTED 设备不支持该命令。将 Android 设备政策更新到最新版本或许能解决此问题。

ResetPasswordFlag

可用于 RESET_PASSWORD 命令类型的标志。

枚举
RESET_PASSWORD_FLAG_UNSPECIFIED 此值会被忽略。
REQUIRE_ENTRY 在用户输入密码之前,不允许其他管理员再次更改密码。
DO_NOT_ASK_CREDENTIALS_ON_BOOT 不在设备启动时要求用户提供凭据。
LOCK_NOW 重置密码后锁定设备。

ClearAppsDataParams

CLEAR_APP_DATA 命令关联的参数,用于从设备中清除指定应用的数据。

JSON 表示法
{
  "packageNames": [
    string
  ]
}
字段
packageNames[]

string

执行命令时将清除其数据的应用的软件包名称。

StartLostModeParams

START_LOST_MODE 命令关联的参数,用于将设备置于丢失模式。必须提供至少一个参数(组织名称除外),才能将设备置于丢失模式。

JSON 表示法
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
字段
lostMessage

object (UserFacingMessage)

设备处于丢失模式时向用户显示的消息。

lostPhoneNumber

object (UserFacingMessage)

当设备处于丢失模式且用户点按“呼叫所有者”按钮时,系统将拨打的电话号码。

lostEmailAddress

string

当设备处于丢失模式时向用户显示的电子邮件地址。

lostStreetAddress

object (UserFacingMessage)

当设备处于丢失模式时向用户显示的街道地址。

lostOrganization

object (UserFacingMessage)

当设备处于丢失模式时向用户显示的组织名称。

StopLostModeParams

此类型没有字段。

STOP_LOST_MODE 命令关联的参数,用于将设备从丢失模式中恢复。

AddEsimParams

ADD_ESIM 命令关联的参数,用于向设备添加 eSIM 卡配置文件。

JSON 表示法
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
字段
activationCode

string

必需。eSIM 卡配置文件的激活码。

activationState

enum (ActivationState)

必需。下载 eSIM 卡配置文件后的激活状态。

ActivationState

下载 eSIM 卡配置文件后的激活状态。

枚举
ACTIVATION_STATE_UNSPECIFIED 未指定 eSIM 卡激活状态。默认情况下,在个人自有设备上,eSIM 卡配置文件为 NOT_ACTIVATED;在公司自有设备上,eSIM 卡配置文件为 ACTIVATED
ACTIVATED 下载后,系统会自动激活 eSIM 卡。如果将此状态设置为个人自有设备的激活状态,系统将拒绝该命令。
NOT_ACTIVATED eSIM 卡配置文件已下载,但尚未激活。在这种情况下,用户需要在设备上手动激活 eSIM 卡。

RemoveEsimParams

与用于从设备中移除 eSIM 卡配置文件的 REMOVE_ESIM 命令关联的参数。

JSON 表示法
{
  "iccId": string
}
字段
iccId

string

必需。要删除的 eSIM 卡配置文件的 ICC ID。

RequestDeviceInfoParams

REQUEST_DEVICE_INFO 命令关联的参数,用于获取设备相关信息。

JSON 表示法
{
  "deviceInfo": enum (DeviceInfo)
}
字段
deviceInfo

enum (DeviceInfo)

必需。要请求的设备信息类型。

DeviceInfo

要请求的设备信息类型。

枚举
DEVICE_INFO_UNSPECIFIED 此值不允许。
EID 请求获取 eSIM 卡的标识符。系统会要求用户批准披露相应信息,然后才能返回结果。如果用户未批准披露声明,则返回 USER_DECLINED。此功能仅适用于搭载 Android 13 及更高版本且带有工作资料的个人自有设备。

WipeParams

与用于擦除设备的 WIPE 命令关联的参数。

JSON 表示法
{
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "wipeReason": {
    object (UserFacingMessage)
  }
}
字段
wipeDataFlags[]

enum (WipeDataFlag)

可选。用于确定要清除哪些数据的标志。

wipeReason

object (UserFacingMessage)

可选。在擦除个人设备上的工作资料之前向用户显示的简短消息。这不会影响公司自有设备。消息长度上限为 200 个字符。

ClearAppsDataStatus

用于清除设备中指定应用数据的 CLEAR_APP_DATA 命令的状态。

JSON 表示法
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
字段
results

map (key: string, value: object (PerAppResult))

每个应用的结果,即从软件包名称到相应清除结果的映射。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

PerAppResult

尝试清除单个应用的数据的结果。

JSON 表示法
{
  "clearingResult": enum (ClearingResult)
}
字段
clearingResult

enum (ClearingResult)

尝试清除单个应用的数据的结果。

ClearingResult

尝试清除单个应用的数据的结果。

枚举
CLEARING_RESULT_UNSPECIFIED 未指定结果。
SUCCESS 此应用的数据已成功清除。
APP_NOT_FOUND 找不到相应应用,因此无法清除该应用的数据。
APP_PROTECTED 此应用受保护,因此无法清除其数据。例如,这可能适用于对设备运行至关重要的应用,例如 Google Play 商店。
API_LEVEL 由于设备 API 级别不支持此命令,因此无法清除相应应用的数据。

StartLostModeStatus

将设备置于丢失模式的 START_LOST_MODE 命令的状态。

JSON 表示法
{
  "status": enum (Status)
}
字段
status

enum (Status)

状态。请参阅 StartLostModeStatus

状态

状态。请参阅 StartLostModeStatus

枚举
STATUS_UNSPECIFIED 未指定。未使用此值。
SUCCESS 设备已进入丢失模式。
RESET_PASSWORD_RECENTLY 由于管理员最近重置了设备的密码,因此无法将设备置于丢失模式。
USER_EXIT_LOST_MODE_RECENTLY 由于用户最近退出了丢失模式,因此无法将设备设为丢失模式。
ALREADY_IN_LOST_MODE 设备已处于丢失模式。

StopLostModeStatus

STOP_LOST_MODE 命令的状态,用于使设备退出丢失模式。

JSON 表示法
{
  "status": enum (Status)
}
字段
status

enum (Status)

状态。请参阅 StopLostModeStatus

状态

状态。请参阅 StopLostModeStatus

枚举
STATUS_UNSPECIFIED 未指定。未使用此值。
SUCCESS 设备已退出丢失模式。
NOT_IN_LOST_MODE 设备未处于丢失模式。

EsimCommandStatus

ADD_ESIMREMOVE_ESIM 命令的状态和错误详细信息(如有)。

JSON 表示法
{
  "status": enum (Status),
  "esimInfo": {
    object (EsimInfo)
  },

  // Union field status_details can be only one of the following:
  "internalErrorDetails": {
    object (InternalErrorDetails)
  }
  // End of list of possible types for union field status_details.
}
字段
status

enum (Status)

仅限输出。ADD_ESIMREMOVE_ESIM 命令的状态。

esimInfo

object (EsimInfo)

仅限输出。有关已添加或移除的 eSIM 卡的信息。仅当 eSIM 卡操作 statusSUCCESS 时,系统才会填充此字段。

联合字段 status_detailsADD_ESIMREMOVE_ESIM 命令的状态详细信息。status_details 只能是下列其中一项:
internalErrorDetails

object (InternalErrorDetails)

仅限输出。如果 status 设置为 INTERNAL_ERROR,则为错误的详细信息。

状态

ADD_ESIMREMOVE_ESIM 命令的状态。

枚举
STATUS_UNSPECIFIED 未指定。未使用此值。
SUCCESS 已在设备上成功执行 eSIM 卡操作。
IN_PROGRESS eSIM 卡操作正在进行中。
PENDING_USER_ACTION 用户需要采取行动才能继续执行 eSIM 卡操作。
ERROR_SETUP_IN_PROGRESS 设置正在进行时,无法执行 eSIM 卡操作。
ERROR_USER_DENIED 用户已拒绝 eSIM 卡操作。
INTERNAL_ERROR 尝试在设备上添加或移除 eSIM 卡时出错,请参阅 internalErrorDetails
ERROR_ICC_ID_NOT_FOUND 对于 REMOVE_ESIM 命令,在设备上找不到要移除的 eSIM 卡的 iccId。这可能意味着 eSIM 卡不属于企业,或者设备上没有与 iccId 对应的 eSIM 卡。
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT 尝试添加新 eSIM 卡时,由于设备上的多个 eSIM 卡卡槽包含有效的 eSIM 卡配置文件,并且没有可用的空闲 eSIM 卡卡槽,因此 ADD_ESIM 命令失败,且新 eSIM 卡的激活状态设置为 ACTIVATED。为解决此问题,可以添加新 eSIM 卡,并将其激活状态设置为 NOT_ACTIVATED 以供日后手动激活;或者用户必须先停用现有的有效 eSIM 卡,然后才能继续操作。

InternalErrorDetails

如果 ADD_ESIMREMOVE_ESIM 命令存在内部错误,则提供内部错误详细信息。

JSON 表示法
{
  "operationCode": string,
  "errorCode": string,
  "operationCodeDetail": enum (OperationCodeDetail),
  "errorCodeDetail": enum (ErrorCodeDetail)
}
字段
operationCode

string (int64 format)

仅限输出。操作代码的整数表示形式,如此处所述。如需了解详情,请参阅 operationCodeDetail

errorCode

string (int64 format)

仅限输出。错误代码的整数表示形式,如此处所示。另请参阅 OPERATION_SMDX_SUBJECT_REASON_CODE。如需了解详情,请参阅 errorCodeDetail

operationCodeDetail

enum (OperationCodeDetail)

仅限输出。与 operationCode 对应的操作代码详细信息。

errorCodeDetail

enum (ErrorCodeDetail)

仅限输出。与 errorCode 对应的错误代码详细信息。

OperationCodeDetail

operationCode 对应的操作代码详细信息。

枚举
OPERATION_CODE_DETAIL_UNSPECIFIED 未指定操作代码详情。Android Management API 无法识别 operationCode。不过,请参阅 operationCode
OPERATION_SYSTEM 如需了解详情,请参阅 EuiccManager.OPERATION_SYSTEM
OPERATION_SIM_SLOT 如需了解详情,请参阅 EuiccManager.OPERATION_SIM_SLOT
OPERATION_EUICC_CARD 如需了解详情,请参阅 EuiccManager.OPERATION_EUICC_CARD
OPERATION_SMDX 如需了解详情,请参阅 EuiccManager.OPERATION_SMDX
OPERATION_SWITCH 如需了解详情,请参阅 EuiccManager.OPERATION_SWITCH
OPERATION_DOWNLOAD 如需了解详情,请参阅 EuiccManager.OPERATION_DOWNLOAD
OPERATION_METADATA 如需了解详情,请参阅 EuiccManager.OPERATION_METADATA
OPERATION_EUICC_GSMA 如需了解详情,请参阅 EuiccManager.OPERATION_EUICC_GSMA
OPERATION_APDU 如需了解详情,请参阅 EuiccManager.OPERATION_APDU
OPERATION_SMDX_SUBJECT_REASON_CODE 如需了解详情,请参阅 EuiccManager.OPERATION_SMDX_SUBJECT_REASON_CODE。请注意,在这种情况下,errorCodeEXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE 的最低有效 3 个字节,用于指定主题代码和原因代码,如此处所示。整数的最高有效字节被清零。例如,主题代码为 8.11.1,原因代码为 5.1,在 errorCode 中以二进制表示为 0000 0000 1000 1011 0001 0000 0101 0001,以十进制表示为 9113681。
OPERATION_HTTP 如需了解详情,请参阅 EuiccManager.OPERATION_HTTP

ErrorCodeDetail

errorCode 对应的错误代码详细信息。

枚举
ERROR_CODE_DETAIL_UNSPECIFIED 未指定错误代码详情。Android Management API 无法识别 errorCode。不过,请参阅 errorCode
ERROR_TIME_OUT 如需了解详情,请参阅 EuiccManager.ERROR_TIME_OUT
ERROR_EUICC_MISSING 如需了解详情,请参阅 EuiccManager.ERROR_EUICC_MISSING
ERROR_UNSUPPORTED_VERSION 如需了解详情,请参阅 EuiccManager.ERROR_UNSUPPORTED_VERSION
ERROR_ADDRESS_MISSING 如需了解详情,请参阅 EuiccManager.ERROR_ADDRESS_MISSING
ERROR_INVALID_CONFIRMATION_CODE 如需了解详情,请参阅 EuiccManager.ERROR_INVALID_CONFIRMATION_CODE
ERROR_CERTIFICATE_ERROR 如需了解详情,请参阅 EuiccManager.ERROR_CERTIFICATE_ERROR
ERROR_NO_PROFILES_AVAILABLE 如需了解详情,请参阅 EuiccManager.ERROR_NO_PROFILES_AVAILABLE
ERROR_CONNECTION_ERROR 如需了解详情,请参阅 EuiccManager.ERROR_CONNECTION_ERROR
ERROR_INVALID_RESPONSE 如需了解详情,请参阅 EuiccManager.ERROR_INVALID_RESPONSE
ERROR_CARRIER_LOCKED 如需了解详情,请参阅 EuiccManager.ERROR_CARRIER_LOCKED
ERROR_DISALLOWED_BY_PPR 如需了解详情,请参阅 EuiccManager.ERROR_DISALLOWED_BY_PPR
ERROR_INVALID_ACTIVATION_CODE 如需了解详情,请参阅 EuiccManager.ERROR_INVALID_ACTIVATION_CODE
ERROR_INCOMPATIBLE_CARRIER 如需了解详情,请参阅 EuiccManager.ERROR_INCOMPATIBLE_CARRIER
ERROR_OPERATION_BUSY 如需了解详情,请参阅 EuiccManager.ERROR_OPERATION_BUSY
ERROR_INSTALL_PROFILE 如需了解详情,请参阅 EuiccManager.ERROR_INSTALL_PROFILE
ERROR_EUICC_INSUFFICIENT_MEMORY 如需了解详情,请参阅 EuiccManager.ERROR_EUICC_INSUFFICIENT_MEMORY
ERROR_INVALID_PORT 如需了解详情,请参阅 EuiccManager.ERROR_INVALID_PORT
ERROR_SIM_MISSING 如需了解详情,请参阅 EuiccManager.ERROR_SIM_MISSING

EsimInfo

已添加或移除的 eSIM 卡的详细信息。

JSON 表示法
{
  "iccId": string
}
字段
iccId

string

仅限输出。eSIM 卡的 ICC ID。

RequestDeviceInfoStatus

REQUEST_DEVICE_INFO 命令的状态。

JSON 表示法
{
  "status": enum (Status),

  // Union field device_info can be only one of the following:
  "eidInfo": {
    object (EidInfo)
  }
  // End of list of possible types for union field device_info.
}
字段
status

enum (Status)

仅限输出。REQUEST_DEVICE_INFO 命令的状态。

联合字段 device_info。管理员请求的设备信息的详细信息。仅当 statusSUCCEEDED 时,系统才会填充此字段。device_info 只能是下列其中一项:
eidInfo

object (EidInfo)

与设备的 EID 相关的信息。

状态

REQUEST_DEVICE_INFO 命令的状态。

枚举
STATUS_UNSPECIFIED 未指定。未使用此值。
SUCCEEDED 设备信息已成功提交。
PENDING_USER_ACTION 用户尚未完成共享设备信息所需的操作。
USER_DECLINED 用户拒绝分享设备信息。
UNSUPPORTED 相应设备不支持所请求的设备信息,例如设备不支持 eSIM 卡。

EidInfo

与设备的 EID 相关的信息。

JSON 表示法
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
字段
eids[]

object (Eid)

仅限输出。每个 eUICC 芯片的 EID 信息。

埃德

每个 eUICC 芯片的 EID 信息。

JSON 表示法
{
  "eid": string
}
字段
eid

string

仅限输出。EID