Criar mobileAppContentFile

  • Artigo

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Criar um novo objeto mobileAppContentFile.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto mobileAppContentFile.

A tabela a seguir mostra as propriedades que são necessárias ao criar mobileAppContentFile.

Propriedade Tipo Descrição
azureStorageUri Cadeia de caracteres Indica o URI do Armazenamento do Azure para o qual o ficheiro é carregado. Criado pelo serviço ao receber um mobileAppContentFile válido. Somente leitura. Essa propriedade é somente leitura.
isCommitted Booliano Um valor que indica se o arquivo tem está confirmado. Um ficheiro de conteúdo de aplicação consolidado foi totalmente carregado e validado pelo serviço do Intune. TRUE significa que o ficheiro de conteúdo da aplicação é consolidado, FALSO significa que o ficheiro de conteúdo da aplicação não foi consolidado. A predefinição é FALSO. Somente leitura. Essa propriedade é somente leitura.
id Cadeia de caracteres O identificador exclusivo para este mobileAppContentFile. Este ID é atribuído durante a criação do mobileAppContentFile. Somente leitura. Essa propriedade é somente leitura.
createdDateTime DateTimeOffset Indica a data e hora criadas associadas ao ficheiro de conteúdo da aplicação, no formato ISO 8601. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Somente leitura. Essa propriedade é somente leitura.
nome Cadeia de caracteres Indica o nome do ficheiro.
size Int64 O tamanho do arquivo antes da criptografia. Para ser preterido, utilize antes a propriedade sizeInBytes.
sizeEncrypted Int64 O tamanho do arquivo após a criptografia. Para ser preterido, utilize a propriedade sizeEncryptedInBytes.
sizeInBytes Int64 Indica o tamanho original do ficheiro, em bytes. Valores válidos de 0 a 9,22337203685478E+18
sizeEncryptedInBytes Int64 Indica o tamanho do ficheiro após a encriptação, em bytes. Valores válidos de 0 a 9,22337203685478E+18
azureStorageUriExpirationDateTime DateTimeOffset Indica a data e hora em que o URI de armazenamento do Azure expira, no formato ISO 8601. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Somente leitura. Essa propriedade é somente leitura.
manifest Binária Indica as informações do manifesto, que contêm metadados de ficheiro.
uploadState mobileAppContentFileUploadState Indica o estado do pedido de carregamento atual. Os valores possíveis são: success, transientError, error, unknown, azureStorageUriRequestSuccess, azureStorageUriRequestPending, azureStorageUriRequestFailed, azureStorageUriRequestTimedOut, azureStorageUriRenewalSuccess, azureStorageUriRenewalPending, azureStorageUriRenewalFailed, azureStorageUriRenewalTimedOut, commitFileSuccess, commitFilePending, commitFileFailed, commitFileTimedOut. O valor predefinido é êxito. Essa propriedade é somente leitura. Os valores possíveis são: success, transientError, error, unknown, azureStorageUriRequestSuccess, azureStorageUriRequestPending, azureStorageUriRequestFailed, azureStorageUriRequestTimedOut, azureStorageUriRenewalSuccess, azureStorageUriRenewalPending, azureStorageUriRenewalFailed, azureStorageUriRenewalTimedOut, commitFileSuccess, commitFilePending, commitFileFailed, commitFileTimedOut.
isDependency Booliano Indica se este ficheiro de conteúdo é uma dependência para o ficheiro de conteúdo principal. TRUE significa que o ficheiro de conteúdo é uma dependência, FALSO significa que o ficheiro de conteúdo não é uma dependência e é o ficheiro de conteúdo principal. A predefinição é FALSO.

Resposta

Se tiver êxito, este método retornará um código de resposta 201 Created e um objeto mobileAppContentFile no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files
Content-type: application/json
Content-length: 419

{
  "@odata.type": "#microsoft.graph.mobileAppContentFile",
  "azureStorageUri": "Azure Storage Uri value",
  "isCommitted": true,
  "name": "Name value",
  "size": 4,
  "sizeEncrypted": 13,
  "sizeInBytes": 11,
  "sizeEncryptedInBytes": 4,
  "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00",
  "manifest": "bWFuaWZlc3Q=",
  "uploadState": "transientError",
  "isDependency": true
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 527

{
  "@odata.type": "#microsoft.graph.mobileAppContentFile",
  "azureStorageUri": "Azure Storage Uri value",
  "isCommitted": true,
  "id": "eab2e29b-e29b-eab2-9be2-b2ea9be2b2ea",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "name": "Name value",
  "size": 4,
  "sizeEncrypted": 13,
  "sizeInBytes": 11,
  "sizeEncryptedInBytes": 4,
  "azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00",
  "manifest": "bWFuaWZlc3Q=",
  "uploadState": "transientError",
  "isDependency": true
}