Method: enterprises.devices.issueCommand

Gibt einen Befehl an ein Gerät aus. Die zurückgegebene Operation-Ressource enthält in ihrem Feld metadata ein Command. Verwenden Sie die Methode „Vorgang abrufen“, um den Status des Befehls abzurufen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Name des Geräts im Format enterprises/{enterpriseId}/devices/{deviceId}.

Anfragetext

Der Anfragetext enthält eine Instanz von Command.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

Befehl

Ein Befehl.

JSON-Darstellung 
{
  "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.
}
Felder
type

enum (CommandType)

Der Typ des Befehls.
createTime

string (Timestamp format)

Der Zeitstempel, zu dem der Befehl erstellt wurde. Der Zeitstempel wird automatisch vom Server generiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Die Dauer, für die der Befehl gültig ist. Der Befehl läuft ab, wenn er in diesem Zeitraum nicht vom Gerät ausgeführt wird. Wenn nicht angegeben, beträgt die Standarddauer 10 Minuten. Es gibt keine maximale Dauer.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
userName

string

Der Ressourcenname des Nutzers, dem das Gerät gehört, im Format enterprises/{enterpriseId}/users/{userId}. Diese wird vom Server automatisch basierend auf dem Gerät generiert, an das der Befehl gesendet wird.
errorCode

enum (CommandErrorCode)

Wenn der Befehl fehlgeschlagen ist, ein Fehlercode, der den Fehler erklärt. Dieser Wert wird nicht festgelegt, wenn der Befehl vom Aufrufer abgebrochen wird. Für die Begründung von Befehlsfehlern sollten Felder in der folgenden Reihenfolge verwendet werden (bevorzugt zuerst): 1. Befehlsspezifische Felder wie clearAppsDataStatus, startLostModeStatus oder ähnliche, sofern vorhanden. 2. Dieses Feld, falls festgelegt. 3. Das generische Feld error im Operation, das den Befehl umschließt.
newPassword

string

Gibt für Befehle vom Typ RESET_PASSWORD optional das neue Passwort an. Hinweis: Das neue Passwort muss auf Android 14-Geräten mindestens 6 Zeichen lang sein, wenn es nur aus Ziffern besteht. Andernfalls schlägt der Befehl mit INVALID_VALUE fehl.
resetPasswordFlags[]

enum (ResetPasswordFlag)

Gibt optional Flags für Befehle vom Typ RESET_PASSWORD an.

Union-Feld params. Befehlsspezifische Parameter. Einige Befehle verwenden dies nicht, insbesondere LOCK, RESET_PASSWORD, REBOOT und RELINQUISH_OWNERSHIP. In Zukunft wird dies möglicherweise auch für diese Befehle verwendet.

Wenn diese Option festgelegt ist, dürfen die Felder new_password und reset_password_flags nicht festgelegt werden. Für params ist nur einer der folgenden Werte zulässig:
clearAppsDataParams

object (ClearAppsDataParams)

Parameter für den Befehl CLEAR_APP_DATA zum Löschen der Daten bestimmter Apps vom Gerät. ClearAppsDataParams ansehen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf CLEAR_APP_DATA gesetzt. Es ist auch zulässig, type explizit auf CLEAR_APP_DATA zu setzen.
startLostModeParams

object (StartLostModeParams)

Parameter für den Befehl START_LOST_MODE, um das Gerät in den Verloren-Modus zu versetzen. StartLostModeParams ansehen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf START_LOST_MODE gesetzt. Es ist auch zulässig, type explizit auf START_LOST_MODE zu setzen.
stopLostModeParams

object (StopLostModeParams)

Parameter für den Befehl STOP_LOST_MODE, um das Gerät aus dem Verloren-Modus zu entfernen. StopLostModeParams ansehen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf STOP_LOST_MODE gesetzt. Es ist auch zulässig, type explizit auf STOP_LOST_MODE zu setzen.
addEsimParams

object (AddEsimParams)

Optional. Parameter für den Befehl ADD_ESIM zum Hinzufügen eines eSIM-Profils zum Gerät. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf ADD_ESIM gesetzt. Es ist auch zulässig, type explizit auf ADD_ESIM zu setzen.
removeEsimParams

object (RemoveEsimParams)

Optional. Parameter für den Befehl REMOVE_ESIM zum Entfernen eines eSIM-Profils vom Gerät. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf REMOVE_ESIM gesetzt. Es ist auch zulässig, type explizit auf REMOVE_ESIM zu setzen.
requestDeviceInfoParams

object (RequestDeviceInfoParams)

Optional. Parameter für den Befehl REQUEST_DEVICE_INFO zum Abrufen gerätebezogener Informationen. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf REQUEST_DEVICE_INFO gesetzt . Es ist auch zulässig, type explizit auf REQUEST_DEVICE_INFO zu setzen.
wipeParams

object (WipeParams)

Optional. Parameter für den Befehl WIPE zum Löschen der Daten auf dem Gerät. Wenn dieser Parameter festgelegt ist, sollte type nicht festgelegt werden. In diesem Fall wird sie vom Server automatisch auf WIPE gesetzt. Es ist auch zulässig, type explizit auf WIPE zu setzen.
Union-Feld status. Status, der für den Befehl spezifisch ist. Einige Befehle verwenden dies nicht, insbesondere LOCK, RESET_PASSWORD, REBOOT und RELINQUISH_OWNERSHIP. In Zukunft wird dies möglicherweise auch für diese Befehle verwendet. Für status ist nur einer der folgenden Werte zulässig:
clearAppsDataStatus

object (ClearAppsDataStatus)

Nur Ausgabe. Status des CLEAR_APP_DATA-Befehls zum Löschen der Daten der angegebenen Apps vom Gerät. ClearAppsDataStatus ansehen.
startLostModeStatus

object (StartLostModeStatus)

Nur Ausgabe. Status des START_LOST_MODE-Befehls zum Versetzen des Geräts in den Verloren-Modus. StartLostModeStatus ansehen.
stopLostModeStatus

object (StopLostModeStatus)

Nur Ausgabe. Status des STOP_LOST_MODE-Befehls zum Beenden des Verloren-Modus auf dem Gerät. StopLostModeStatus ansehen.
esimStatus

object (EsimCommandStatus)

Nur Ausgabe. Status eines ADD_ESIM- oder REMOVE_ESIM-Befehls.
requestDeviceInfoStatus

object (RequestDeviceInfoStatus)

Nur Ausgabe. Status des Befehls REQUEST_DEVICE_INFO.

CommandType

Arten von Befehlen

Enums
COMMAND_TYPE_UNSPECIFIED Dieser Wert ist nicht zulässig.
LOCK Sperren Sie das Gerät, als wäre das Zeitlimit für die Displaysperre abgelaufen.
RESET_PASSWORD Setzen Sie das Passwort des Nutzers zurück.
REBOOT Starten Sie das Gerät neu. Wird nur auf vollständig verwalteten Geräten mit Android 7.0 (API-Level 24) oder höher unterstützt.
RELINQUISH_OWNERSHIP Entfernt das Arbeitsprofil und alle Richtlinien von einem unternehmenseigenen Gerät mit Android 8.0 oder höher, sodass das Gerät privat genutzt werden kann. Apps und Daten, die mit dem/den privaten Profil(en) verknüpft sind, bleiben erhalten. Das Gerät wird vom Server gelöscht, nachdem es den Befehl bestätigt hat.
CLEAR_APP_DATA Löscht die App-Daten der angegebenen Apps. Diese Funktion wird auf Geräten mit Android 9 und höher unterstützt. Eine Anwendung kann Daten auch außerhalb ihrer Anwendungsdaten speichern, z. B. im externen Speicher oder in einem Nutzerwörterbuch. Siehe auch clearAppsDataParams.
START_LOST_MODE Versetzt das Gerät in den Verloren-Modus. Wird nur auf vollständig verwalteten Geräten oder unternehmenseigenen Geräten mit einem verwalteten Profil unterstützt. Siehe auch startLostModeParams.
STOP_LOST_MODE Das Gerät wird aus dem Verloren-Modus entfernt. Wird nur auf vollständig verwalteten Geräten oder unternehmenseigenen Geräten mit einem verwalteten Profil unterstützt. Siehe auch stopLostModeParams.
ADD_ESIM Fügt dem Gerät ein eSIM-Profil hinzu. Diese Funktion wird auf Geräten mit Android 15 und höher unterstützt. Siehe auch addEsimParams. Verwenden Sie den Befehl REMOVE_ESIM, um ein eSIM-Profil zu entfernen. Wenn Sie festlegen möchten, was mit dem eSIM-Profil passiert, wenn ein Gerät zurückgesetzt wird, legen Sie wipeDataFlags in der Richtlinie fest. Hinweis: Wenn Sie mehrere eSIMs auf einem einzelnen Gerät bereitstellen möchten, empfiehlt es sich, zwischen den aufeinanderfolgenden Ausführungen des Befehls eine Verzögerung von einigen Minuten einzuführen.
REMOVE_ESIM Entfernt ein eSIM-Profil vom Gerät. Diese Funktion wird auf Geräten mit Android 15 und höher unterstützt. Siehe auch removeEsimParams.
REQUEST_DEVICE_INFO Informationen zum Gerät anfordern
WIPE Das Gerät wird durch Zurücksetzen auf die Werkseinstellungen (bei einem unternehmenseigenen Gerät) oder durch Löschen des Arbeitsprofils (bei einem privaten Gerät mit Arbeitsprofil) gelöscht. Das Löschen erfolgt erst, wenn das Gerät den Befehl bestätigt. Der Befehl kann vorher abgebrochen werden.

CommandErrorCode

Ein Befehlsfehlercode. Dieses schreibgeschützte Feld wird vom Server ausgefüllt.

Enums
COMMAND_ERROR_CODE_UNSPECIFIED Es ist kein Fehler aufgetreten.
UNKNOWN Ein unbekannter Fehler ist aufgetreten.
API_LEVEL Das API-Level des Geräts unterstützt diesen Befehl nicht.
MANAGEMENT_MODE Der Verwaltungsmodus (Profilinhaber, Geräteinhaber usw.) unterstützt den Befehl nicht.
INVALID_VALUE Der Befehl hat einen ungültigen Parameterwert.
UNSUPPORTED Das Gerät unterstützt den Befehl nicht. Das Problem kann möglicherweise durch ein Update der Android Device Policy auf die aktuelle Version behoben werden.

ResetPasswordFlag

Flags, die für den Befehlstyp RESET_PASSWORD verwendet werden können.

Enums
RESET_PASSWORD_FLAG_UNSPECIFIED Dieser Wert wird ignoriert.
REQUIRE_ENTRY Lassen Sie nicht zu, dass andere Administratoren das Passwort noch einmal ändern, bevor der Nutzer es eingegeben hat.
DO_NOT_ASK_CREDENTIALS_ON_BOOT Bei Gerätestart keine Nutzeranmeldedaten anfordern
LOCK_NOW Sperren Sie das Gerät nach dem Zurücksetzen des Passworts.

ClearAppsDataParams

Parameter, die mit dem Befehl CLEAR_APP_DATA verknüpft sind, um die Daten der angegebenen Apps vom Gerät zu löschen.

JSON-Darstellung 
{
  "packageNames": [
    string
  ]
}
Felder
packageNames[]

string

Die Paketnamen der Apps, deren Daten beim Ausführen des Befehls gelöscht werden.

StartLostModeParams

Parameter, die dem Befehl START_LOST_MODE zugeordnet sind, um das Gerät in den Verloren-Modus zu versetzen. Damit das Gerät in den Modus „Verloren“ versetzt werden kann, muss mindestens einer der Parameter (mit Ausnahme des Organisationsnamens) angegeben werden.

JSON-Darstellung 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
Felder
lostMessage

object (UserFacingMessage)

Die Nachricht, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet.
lostPhoneNumber

object (UserFacingMessage)

Die Telefonnummer, die angerufen wird, wenn sich das Gerät im Verloren-Modus befindet und auf die Schaltfläche „Anrufer“ getippt wird.
lostEmailAddress

string

Die E‑Mail-Adresse, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verlustmodus befindet.
lostStreetAddress

object (UserFacingMessage)

Die Adresse, die dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet.
lostOrganization

object (UserFacingMessage)

Der Organisationsname, der dem Nutzer angezeigt wird, wenn sich das Gerät im Verloren-Modus befindet.

StopLostModeParams

Dieser Typ hat keine Felder.

Parameter, die mit dem Befehl STOP_LOST_MODE verknüpft sind, um das Gerät aus dem Verloren-Modus zu entfernen.

AddEsimParams

Parameter, die dem Befehl ADD_ESIM zugeordnet sind, um dem Gerät ein eSIM-Profil hinzuzufügen.

JSON-Darstellung 
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
Felder
activationCode

string

Erforderlich. Der Aktivierungscode für das eSIM-Profil.
activationState

enum (ActivationState)

Erforderlich. Der Aktivierungsstatus des eSIM-Profils nach dem Herunterladen.

ActivationState

Der Aktivierungsstatus des eSIM-Profils nach dem Herunterladen.

Enums
ACTIVATION_STATE_UNSPECIFIED Der Aktivierungsstatus der eSIM ist nicht angegeben. Standardmäßig ist das eSIM-Profil auf privaten Geräten NOT_ACTIVATED und auf unternehmenseigenen Geräten ACTIVATED.
ACTIVATED Die eSIM wird nach dem Herunterladen automatisch aktiviert. Wenn Sie dies als Aktivierungsstatus für private Geräte festlegen, wird der Befehl abgelehnt.
NOT_ACTIVATED Das eSIM-Profil wurde heruntergeladen, aber nicht aktiviert. In diesem Fall muss der Nutzer die eSIM manuell auf dem Gerät aktivieren.

RemoveEsimParams

Parameter, die mit dem Befehl REMOVE_ESIM zum Entfernen eines eSIM-Profils vom Gerät verknüpft sind.

JSON-Darstellung 
{
  "iccId": string
}
Felder
iccId

string

Erforderlich. ICCID des zu löschenden eSIM-Profils.

RequestDeviceInfoParams

Parameter, die dem Befehl REQUEST_DEVICE_INFO zugeordnet sind, um gerätebezogene Informationen abzurufen.

JSON-Darstellung 
{
  "deviceInfo": enum (DeviceInfo)
}
Felder
deviceInfo

enum (DeviceInfo)

Erforderlich. Art der anzufordernden Geräteinformationen.

DeviceInfo

Art der anzufordernden Geräteinformationen.

Enums
DEVICE_INFO_UNSPECIFIED Dieser Wert ist nicht zulässig.
EID Fordern Sie die Kennung für die eSIM an. Der Nutzer wird aufgefordert, die Offenlegung der Informationen zu genehmigen, bevor das Ergebnis zurückgegeben werden kann. Wenn der Nutzer die Offenlegung nicht genehmigt, wird USER_DECLINED zurückgegeben. Diese Funktion wird nur für private Geräte mit Arbeitsprofilen und Android-Versionen 13 und höher unterstützt.

WipeParams

Parameter, die dem Befehl WIPE zum Löschen der Daten auf dem Gerät zugeordnet sind.

JSON-Darstellung 
{
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "wipeReason": {
    object (UserFacingMessage)
  }
}
Felder
wipeDataFlags[]

enum (WipeDataFlag)

Optional. Flags, mit denen festgelegt wird, welche Daten gelöscht werden sollen.
wipeReason

object (UserFacingMessage)

Optional. Eine kurze Nachricht, die dem Nutzer angezeigt wird, bevor das Arbeitsprofil auf privaten Geräten gelöscht wird. Das hat keine Auswirkungen auf unternehmenseigene Geräte. Die maximale Länge einer Nachricht beträgt 200 Zeichen.

ClearAppsDataStatus

Status des CLEAR_APP_DATA-Befehls zum Löschen der Daten der angegebenen Apps vom Gerät.

JSON-Darstellung 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
Felder
results

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

Die Ergebnisse pro App, eine Zuordnung von Paketnamen zum jeweiligen Clearing-Ergebnis.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

PerAppResult

Das Ergebnis eines Versuchs, die Daten einer einzelnen App zu löschen.

JSON-Darstellung 
{
  "clearingResult": enum (ClearingResult)
}
Felder
clearingResult

enum (ClearingResult)

Das Ergebnis eines Versuchs, die Daten einer einzelnen App zu löschen.

ClearingResult

Das Ergebnis eines Versuchs, die Daten einer einzelnen App zu löschen.

Enums
CLEARING_RESULT_UNSPECIFIED Nicht angegebenes Ergebnis.
SUCCESS Die Daten dieser App wurden gelöscht.
APP_NOT_FOUND Die Daten dieser App konnten nicht gelöscht werden, da die App nicht gefunden wurde.
APP_PROTECTED Die Daten dieser App konnten nicht gelöscht werden, da die App geschützt ist. Das kann beispielsweise für Apps gelten, die für die Funktion des Geräts unerlässlich sind, z. B. der Google Play Store.
API_LEVEL Die Daten dieser App konnten nicht gelöscht werden, da das API-Level des Geräts diesen Befehl nicht unterstützt.

StartLostModeStatus

Status des START_LOST_MODE-Befehls zum Versetzen des Geräts in den Verloren-Modus.

JSON-Darstellung 
{
  "status": enum (Status)
}
Felder
status

enum (Status)

Der Status. StartLostModeStatus ansehen.

Status

Der Status. StartLostModeStatus ansehen.

Enums
STATUS_UNSPECIFIED Nicht angegeben Dieser Wert wird nicht verwendet.
SUCCESS Das Gerät wurde in den Verloren-Modus versetzt.
RESET_PASSWORD_RECENTLY Das Gerät konnte nicht in den Verloren-Modus versetzt werden, da der Administrator das Gerätepasswort vor Kurzem zurückgesetzt hat.
USER_EXIT_LOST_MODE_RECENTLY Das Gerät konnte nicht in den Verloren-Modus versetzt werden, da der Nutzer den Verloren-Modus vor Kurzem beendet hat.
ALREADY_IN_LOST_MODE Das Gerät befindet sich bereits im Verloren-Modus.

StopLostModeStatus

Status des STOP_LOST_MODE-Befehls zum Beenden des Verloren-Modus auf dem Gerät.

JSON-Darstellung 
{
  "status": enum (Status)
}
Felder
status

enum (Status)

Der Status. StopLostModeStatus ansehen.

Status

Der Status. StopLostModeStatus ansehen.

Enums
STATUS_UNSPECIFIED Nicht angegeben Dieser Wert wird nicht verwendet.
SUCCESS Das Gerät wurde aus dem Verloren-Modus entfernt.
NOT_IN_LOST_MODE Das Gerät befindet sich nicht im Verloren-Modus.

EsimCommandStatus

Status und Fehlerdetails (falls vorhanden) eines ADD_ESIM- oder REMOVE_ESIM-Befehls.

JSON-Darstellung 
{
  "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.
}
Felder
status

enum (Status)

Nur Ausgabe. Status eines ADD_ESIM- oder REMOVE_ESIM-Befehls.
esimInfo

object (EsimInfo)

Nur Ausgabe. Informationen zur hinzugefügten oder entfernten eSIM. Dieses Feld wird nur ausgefüllt, wenn der eSIM-Vorgang status den Wert SUCCESS hat.
Union-Feld status_details. Details zum Status eines ADD_ESIM- oder REMOVE_ESIM-Befehls. Für status_details ist nur einer der folgenden Werte zulässig:
internalErrorDetails

object (InternalErrorDetails)

Nur Ausgabe. Details zum Fehler, wenn status auf INTERNAL_ERROR gesetzt ist.

Status

Status eines ADD_ESIM- oder REMOVE_ESIM-Befehls.

Enums
STATUS_UNSPECIFIED Nicht angegeben Dieser Wert wird nicht verwendet.
SUCCESS Der eSIM-Vorgang wurde auf dem Gerät erfolgreich ausgeführt.
IN_PROGRESS Der eSIM-Vorgang wird ausgeführt.
PENDING_USER_ACTION Der Nutzer muss eine Aktion ausführen, damit der eSIM-Vorgang fortgesetzt werden kann.
ERROR_SETUP_IN_PROGRESS Der eSIM-Vorgang kann nicht ausgeführt werden, während die Einrichtung läuft.
ERROR_USER_DENIED Der Nutzer hat den eSIM-Vorgang abgelehnt.
INTERNAL_ERROR Beim Hinzufügen oder Entfernen der eSIM auf dem Gerät ist ein Fehler aufgetreten. Weitere Informationen finden Sie unter internalErrorDetails.
ERROR_ICC_ID_NOT_FOUND Für den Befehl REMOVE_ESIM wurde die iccId der zu entfernenden eSIM auf dem Gerät nicht gefunden. Das kann bedeuten, dass die eSIM nicht zum Unternehmen gehört oder die eSIM, die iccId entspricht, nicht auf dem Gerät vorhanden ist.
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT Der Befehl ADD_ESIM ist fehlgeschlagen, als versucht wurde, eine neue eSIM mit dem Aktivierungsstatus ACTIVATED hinzuzufügen, da mehrere eSIM-Slots auf dem Gerät aktive eSIM-Profile enthalten und kein kostenloser eSIM-Slot verfügbar ist. Um dieses Problem zu beheben, kann die neue eSIM mit dem Aktivierungsstatus NOT_ACTIVATED für die spätere manuelle Aktivierung hinzugefügt werden. Alternativ muss der Nutzer zuerst eine vorhandene aktive eSIM deaktivieren, damit der Vorgang fortgesetzt werden kann.

InternalErrorDetails

Details zum internen Fehler, falls vorhanden, für den Befehl ADD_ESIM oder REMOVE_ESIM.

JSON-Darstellung 
{
  "operationCode": string,
  "errorCode": string,
  "operationCodeDetail": enum (OperationCodeDetail),
  "errorCodeDetail": enum (ErrorCodeDetail)
}
Felder
operationCode

string (int64 format)

Nur Ausgabe. Ganzzahldarstellung des Operationscodes, wie hier angegeben. Unter operationCodeDetail finden Sie weitere Informationen.
errorCode

string (int64 format)

Nur Ausgabe. Ganzzahldarstellung des Fehlercodes, wie hier angegeben. Siehe auch OPERATION_SMDX_SUBJECT_REASON_CODE. Weitere Informationen finden Sie unter errorCodeDetail.
operationCodeDetail

enum (OperationCodeDetail)

Nur Ausgabe. Die dem operationCode entsprechende Detailinformation zum Vorgangscode.
errorCodeDetail

enum (ErrorCodeDetail)

Nur Ausgabe. Die Fehlercodedetails, die dem errorCode entsprechen.

OperationCodeDetail

Die dem operationCode entsprechende Detailinformation zum Vorgangscode.

Enums
OPERATION_CODE_DETAIL_UNSPECIFIED Die Details zum Vorgangscode sind nicht angegeben. operationCode wird von der Android Management API nicht erkannt. Siehe jedoch operationCode.
OPERATION_SYSTEM Weitere Informationen finden Sie unter EuiccManager.OPERATION_SYSTEM.
OPERATION_SIM_SLOT Weitere Informationen finden Sie unter EuiccManager.OPERATION_SIM_SLOT.
OPERATION_EUICC_CARD Weitere Informationen finden Sie unter EuiccManager.OPERATION_EUICC_CARD.
OPERATION_SMDX Weitere Informationen finden Sie unter EuiccManager.OPERATION_SMDX.
OPERATION_SWITCH Weitere Informationen finden Sie unter EuiccManager.OPERATION_SWITCH.
OPERATION_DOWNLOAD Weitere Informationen finden Sie unter EuiccManager.OPERATION_DOWNLOAD.
OPERATION_METADATA Weitere Informationen finden Sie unter EuiccManager.OPERATION_METADATA.
OPERATION_EUICC_GSMA Weitere Informationen finden Sie unter EuiccManager.OPERATION_EUICC_GSMA.
OPERATION_APDU Weitere Informationen finden Sie unter EuiccManager.OPERATION_APDU.
OPERATION_SMDX_SUBJECT_REASON_CODE Weitere Informationen finden Sie unter EuiccManager.OPERATION_SMDX_SUBJECT_REASON_CODE. In diesem Fall sind die errorCode die drei am wenigsten signifikanten Byte des EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE, die den Betreffcode und den Ursachencode wie hier angegeben enthalten. Das wichtigste Byte der Ganzzahl wird auf null gesetzt. Ein Betreffcode von 8.11.1 und ein Grundcode von 5.1 werden in errorCode binär als 0000 0000 1000 1011 0001 0000 0101 0001 dargestellt, was dezimal 9113681 entspricht.
OPERATION_HTTP Weitere Informationen finden Sie unter EuiccManager.OPERATION_HTTP.

ErrorCodeDetail

Fehlercodedetails, die dem errorCode entsprechen.

Enums
ERROR_CODE_DETAIL_UNSPECIFIED Die Fehlercodedetails sind nicht angegeben. errorCode wird von der Android Management API nicht erkannt. Weitere Informationen finden Sie unter errorCode.
ERROR_TIME_OUT Weitere Informationen finden Sie unter EuiccManager.ERROR_TIME_OUT.
ERROR_EUICC_MISSING Weitere Informationen finden Sie unter EuiccManager.ERROR_EUICC_MISSING.
ERROR_UNSUPPORTED_VERSION Weitere Informationen finden Sie unter EuiccManager.ERROR_UNSUPPORTED_VERSION.
ERROR_ADDRESS_MISSING Weitere Informationen finden Sie unter EuiccManager.ERROR_ADDRESS_MISSING.
ERROR_INVALID_CONFIRMATION_CODE Weitere Informationen finden Sie unter EuiccManager.ERROR_INVALID_CONFIRMATION_CODE.
ERROR_CERTIFICATE_ERROR Weitere Informationen finden Sie unter EuiccManager.ERROR_CERTIFICATE_ERROR.
ERROR_NO_PROFILES_AVAILABLE Weitere Informationen finden Sie unter EuiccManager.ERROR_NO_PROFILES_AVAILABLE.
ERROR_CONNECTION_ERROR Weitere Informationen finden Sie unter EuiccManager.ERROR_CONNECTION_ERROR.
ERROR_INVALID_RESPONSE Weitere Informationen finden Sie unter EuiccManager.ERROR_INVALID_RESPONSE.
ERROR_CARRIER_LOCKED Weitere Informationen finden Sie unter EuiccManager.ERROR_CARRIER_LOCKED.
ERROR_DISALLOWED_BY_PPR Weitere Informationen finden Sie unter EuiccManager.ERROR_DISALLOWED_BY_PPR.
ERROR_INVALID_ACTIVATION_CODE Weitere Informationen finden Sie unter EuiccManager.ERROR_INVALID_ACTIVATION_CODE.
ERROR_INCOMPATIBLE_CARRIER Weitere Informationen finden Sie unter EuiccManager.ERROR_INCOMPATIBLE_CARRIER.
ERROR_OPERATION_BUSY Weitere Informationen finden Sie unter EuiccManager.ERROR_OPERATION_BUSY.
ERROR_INSTALL_PROFILE Weitere Informationen finden Sie unter EuiccManager.ERROR_INSTALL_PROFILE.
ERROR_EUICC_INSUFFICIENT_MEMORY Weitere Informationen finden Sie unter EuiccManager.ERROR_EUICC_INSUFFICIENT_MEMORY.
ERROR_INVALID_PORT Weitere Informationen finden Sie unter EuiccManager.ERROR_INVALID_PORT.
ERROR_SIM_MISSING Weitere Informationen finden Sie unter EuiccManager.ERROR_SIM_MISSING.

EsimInfo

Details zur hinzugefügten oder entfernten eSIM.

JSON-Darstellung 
{
  "iccId": string
}
Felder
iccId

string

Nur Ausgabe. ICCID der eSIM.

RequestDeviceInfoStatus

Status des Befehls REQUEST_DEVICE_INFO.

JSON-Darstellung 
{
  "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.
}
Felder
status

enum (Status)

Nur Ausgabe. Status eines REQUEST_DEVICE_INFO-Befehls.
Union-Feld device_info. Details zu den vom Administrator angeforderten Geräteinformationen. Wird nur ausgefüllt, wenn status SUCCEEDED ist. Für device_info ist nur einer der folgenden Werte zulässig:
eidInfo

object (EidInfo)

Informationen zu den EIDs des Geräts.

Status

Status eines REQUEST_DEVICE_INFO-Befehls.

Enums
STATUS_UNSPECIFIED Nicht angegeben Dieser Wert wird nicht verwendet.
SUCCEEDED Die Geräteinformationen wurden gesendet.
PENDING_USER_ACTION Der Nutzer hat die erforderlichen Aktionen zum Teilen von Geräteinformationen nicht abgeschlossen.
USER_DECLINED Der Nutzer hat die Freigabe von Geräteinformationen abgelehnt.
UNSUPPORTED Die angeforderten Geräteinformationen werden auf diesem Gerät nicht unterstützt, z.B. wird eSIM auf dem Gerät nicht unterstützt.

EidInfo

Informationen zu den EIDs des Geräts.

JSON-Darstellung 
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
Felder
eids[]

object (Eid)

Nur Ausgabe. EID-Informationen für jeden eUICC-Chip.

Eid

EID-Informationen für jeden eUICC-Chip.

JSON-Darstellung 
{
  "eid": string
}
Felder
eid

string

Nur Ausgabe. Die EID