Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante: Microsoft admite Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Cree un nuevo objeto EMBEDDEDSIMDeviceState .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
POST /deviceManagement/embeddedSIMActivationCodePools/{embeddedSIMActivationCodePoolId}/deviceStates
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto embeddedSIMDeviceState.
En la tabla siguiente se muestran las propiedades necesarias al crear embeddedSIMDeviceState.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único del estado del dispositivo SIM incrustado. Valor generado por el sistema asignado cuando se crea. |
| createdDateTime | DateTimeOffset | La hora en que se creó el estado del dispositivo SIM incrustado. Lado del servicio generado. |
| modifiedDateTime | DateTimeOffset | La hora en que se modificó por última vez el estado del dispositivo SIM incrustado. Se ha actualizado el lado del servicio. |
| lastSyncDateTime | DateTimeOffset | La hora en que el dispositivo SIM incrustado se registró por última vez. Se ha actualizado el lado del servicio. |
| universalIntegratedCircuitCardIdentifier | Cadena | Identificador de tarjeta de circuito integrado universal (UICCID) que identifica el hardware en el que se va a implementar un perfil. |
| deviceName | Cadena | Nombre del dispositivo al que se aprovisionó la suscripción, por ejemplo, DESKTOP-JOE |
| userName | Cadena | Nombre de usuario al que se aprovisionó la suscripción, por ejemplo, joe@contoso.com |
| state | embeddedSIMDeviceStateValue | Estado de la operación de perfil aplicada al dispositivo. Los valores posibles son: notEvaluated, failed, , installedinstalling, deleting, error, , deleted. removedByUser |
| stateDetails | Cadena | Descripción de cadena del estado de aprovisionamiento. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto embeddedSIMDeviceState en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
POST https://graph.microsoft.com/beta/deviceManagement/embeddedSIMActivationCodePools/{embeddedSIMActivationCodePoolId}/deviceStates
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"
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
HTTP/1.1 201 Created
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"
}