Method: enterprises.devices.issueCommand

기기에 명령어를 실행합니다. 반환된 Operation 리소스의 metadata 필드에는 Command이 포함됩니다. 작업 가져오기 메서드를 사용하여 명령어의 상태를 가져옵니다.

HTTP 요청

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

URL은 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)

명령어가 생성된 타임스탬프입니다. 타임스탬프는 서버에서 자동으로 생성됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
duration

string (Duration format)

명령어가 유효한 기간입니다. 이 시간 동안 기기에서 명령어를 실행하지 않으면 명령어가 만료됩니다. 지정하지 않은 경우 기본 기간은 10분입니다. 최대 기간은 없습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
userName

string

기기를 소유한 사용자의 리소스 이름입니다(enterprises/{enterpriseId}/users/{userId} 형식). 명령어가 전송되는 기기를 기반으로 서버에서 자동으로 생성됩니다.
errorCode

enum (CommandErrorCode)

명령어가 실패한 경우 실패를 설명하는 오류 코드입니다. 호출자가 명령어를 취소하면 설정되지 않습니다. 명령어 오류에 관한 추론의 경우 다음 순서로 필드를 사용하는 것이 좋습니다 (가장 선호하는 필드가 먼저 나옴). 1. clearAppsDataStatus, startLostModeStatus 등 명령어별 필드(있는 경우) 2. 설정된 경우 이 필드입니다. 3. 명령어를 래핑하는 Operation의 일반 error 필드
newPassword

string

RESET_PASSWORD 유형의 명령어의 경우 선택적으로 새 비밀번호를 지정합니다. 참고: Android 14 기기의 경우 새 비밀번호가 숫자로만 구성되어 있다면 6자 이상이어야 합니다. 그렇지 않으면 명령어가 INVALID_VALUE 오류와 함께 실패합니다.
resetPasswordFlags[]

enum (ResetPasswordFlag)

RESET_PASSWORD 유형의 명령어의 경우 선택적으로 플래그를 지정합니다.

통합 필드 params. 명령어에 특정한 매개변수입니다. 일부 명령어(특히 LOCK, RESET_PASSWORD, REBOOT, RELINQUISH_OWNERSHIP)는 이를 사용하지 않습니다. 향후 이러한 명령어에서도 이를 사용할 수 있습니다.

이 값이 설정된 경우 new_password 및 reset_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. 명령어에 따른 상태입니다. 일부 명령어(특히 LOCK, RESET_PASSWORD, REBOOT, RELINQUISH_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_ESIM 또는 REMOVE_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

기기에 eSIM 프로필을 추가하는 ADD_ESIM 명령어와 연결된 매개변수입니다.

JSON 표현 
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
필드
activationCode

string

필수 항목입니다. eSIM 프로필의 활성화 코드입니다.
activationState

enum (ActivationState)

필수 항목입니다. 다운로드된 후 eSIM 프로필의 활성화 상태입니다.

ActivationState

다운로드된 후 eSIM 프로필의 활성화 상태입니다.

열거형
ACTIVATION_STATE_UNSPECIFIED eSIM 활성화 상태가 지정되지 않았습니다. 기본적으로 개인 소유 기기에서는 eSIM 프로필이 NOT_ACTIVATED이고 회사 소유 기기에서는 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_ESIM 또는 REMOVE_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_ESIM 또는 REMOVE_ESIM 명령어의 상태입니다.
esimInfo

object (EsimInfo)

출력 전용입니다. 추가되거나 삭제된 eSIM에 관한 정보입니다. eSIM 작업 status이 SUCCESS인 경우에만 채워집니다.
통합 필드 status_details. ADD_ESIM 또는 REMOVE_ESIM 명령어의 상태에 관한 세부정보입니다. status_details은 다음 중 하나여야 합니다.
internalErrorDetails

object (InternalErrorDetails)

출력 전용입니다. status가 INTERNAL_ERROR로 설정된 경우 오류 세부정보

상태

ADD_ESIM 또는 REMOVE_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 슬롯이 없으므로 활성화 상태가 ACTIVATED으로 설정된 새 eSIM을 추가하려고 할 때 ADD_ESIM 명령어가 실패했습니다. 이 문제를 해결하려면 나중에 수동으로 활성화할 수 있도록 활성화 상태가 NOT_ACTIVATED인 새 eSIM을 추가하거나, 사용자가 먼저 기존 활성 eSIM을 비활성화해야 작업이 진행될 수 있습니다.

InternalErrorDetails

ADD_ESIM 또는 REMOVE_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 작업 코드 세부정보가 지정되지 않았습니다. operationCode이 Android Management API에서 인식되지 않습니다. 하지만 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를 참고하세요. 이 경우 errorCode는 EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE의 최하위 3바이트로, 여기에 표시된 대로 주제 코드와 이유 코드를 지정합니다. 정수의 최상위 바이트가 0으로 설정됩니다. 예를 들어 주제 코드 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 오류 코드 세부정보가 지정되지 않았습니다. errorCode이 Android Management API에서 인식되지 않습니다. 하지만 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. 관리자가 요청한 기기 정보의 세부정보입니다. status이 SUCCEEDED인 경우에만 채워집니다. 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