EmbeddedSIMDeviceState の更新

名前空間: microsoft.graph

重要: Microsoft Graph /beta バージョンの API は変更される場合があります。実稼働での使用はサポートされていません。

注: Intune 用 Microsoft Graph API には、テナントの 有効な Intune ライセンスが必要です。

埋め込み SIMDeviceState オブジェクトのプロパティを更新 します。

前提条件

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校アカウント)	DeviceManagementConfiguration.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementConfiguration.ReadWrite.All

HTTP 要求

PATCH /deviceManagement/embeddedSIMActivationCodePools/{embeddedSIMActivationCodePoolId}/deviceStates/{embeddedSIMDeviceStateId}

要求ヘッダー

ヘッダー	値
Authorization	ベアラー <トークン> が必要です。
承諾	application/json

要求本文

要求本文で 、embeddedSIMDeviceState オブジェクトの JSON 表記を指定します。

次の表に、embeddedSIMDeviceState を作成するときに必要な プロパティを示します。

プロパティ	型	説明
id	文字列	埋め込み SIM デバイスの状態の一意の識別子。 作成時に割り当てられたシステム生成値。
createdDateTime	DateTimeOffset	埋め込み SIM デバイスの状態が作成された時刻。 生成されたサービス側。
modifiedDateTime	DateTimeOffset	埋め込み SIM デバイスの状態が最後に変更された時刻。 サービス側を更新しました。
lastSyncDateTime	DateTimeOffset	埋め込み SIM デバイスが最後にチェックインした時刻。 サービス側を更新しました。
universalIntegratedCircuitCardIdentifier	文字列	プロファイルを展開するハードウェアを識別するユニバーサル集積回路カード識別子 (UICCID)。
deviceName	String	サブスクリプションがプロビジョニングされたデバイス名 (DESKTOP-JOE など)
userName	String	サブスクリプションがプロビジョニングされたユーザー名 (例: joe@contoso.com
state	embeddedSIMDeviceStateValue	デバイスに適用されるプロファイル操作の状態。 可能な値は、notEvaluated、failed、installing、installed、deleting、error、deleted、removedByUser です。
stateDetails	String	プロビジョニング状態の文字列の説明。

応答

成功した場合、このメソッドは応答コードと、応答本文に更新 200 OK された embeddedSIMDeviceState オブジェクトを返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/embeddedSIMActivationCodePools/{embeddedSIMActivationCodePoolId}/deviceStates/{embeddedSIMDeviceStateId}
Content-type: application/json
Content-length: 361

{
  "@odata.type": "#microsoft.graph.embeddedSIMDeviceState",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "universalIntegratedCircuitCardIdentifier": "Universal Integrated Circuit Card Identifier value",
  "deviceName": "Device Name value",
  "userName": "User Name value",
  "state": "failed",
  "stateDetails": "State Details value"
}

応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 529

{
  "@odata.type": "#microsoft.graph.embeddedSIMDeviceState",
  "id": "908884a3-84a3-9088-a384-8890a3848890",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "modifiedDateTime": "2017-01-01T00:00:22.8983556-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "universalIntegratedCircuitCardIdentifier": "Universal Integrated Circuit Card Identifier value",
  "deviceName": "Device Name value",
  "userName": "User Name value",
  "state": "failed",
  "stateDetails": "State Details value"
}