Atualizar userPFXCertificate

Namespace: microsoft.graph

Importante: As APIs Graph Microsoft na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

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

Atualize as propriedades de um objeto userPFXCertificate.

Pré-requisitos

Uma das seguintes permissões é obrigató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)	DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/userPfxCertificates/{userPFXCertificateId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto userPFXCertificate.

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

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Identificador exclusivo do certificado PFX.
thumbprint	Cadeia de Caracteres	Impressão digital SHA-1 do certificado PFX.
intendedPurpose	userPfxIntendedPurpose	Finalidade pretendido do certificado do ponto de vista da implantação. Os valores possíveis são: unassigned, smimeEncryption, smimeSigning, vpn, wifi.
userPrincipalName	Cadeia de caracteres	Nome principal do usuário do certificado PFX.
startDateTime	DateTimeOffset	Data/hora de início da validade do certificado.
expirationDateTime	DateTimeOffset	Data/hora de validade do certificado.
providerName	Cadeia de Caracteres	Provedor de criptografia usado para criptografar esse blob.
keyName	Cadeia de Caracteres	Nome da chave (dentro do provedor) usada para criptografar o blob.
paddingScheme	userPfxPaddingScheme	Esquema de preenchimento usado pelo provedor durante a criptografia/descriptografia. Os possíveis valores são: none, pkcs1, oaepSha1, oaepSha256, oaepSha384, oaepSha512.
encryptedPfxBlob	Binário	Blob PFX criptografado.
encryptedPfxPassword	Cadeia de Caracteres	Senha PFX criptografada.
createdDateTime	DateTimeOffset	Data/hora em que esse certificado PFX foi importado.
lastModifiedDateTime	DateTimeOffset	Data/hora em que esse certificado PFX foi modificado pela última vez.

Resposta

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto userPFXCertificate atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/userPfxCertificates/{userPFXCertificateId}
Content-type: application/json
Content-length: 523

{
  "@odata.type": "#microsoft.graph.userPFXCertificate",
  "thumbprint": "Thumbprint value",
  "intendedPurpose": "smimeEncryption",
  "userPrincipalName": "User Principal Name value",
  "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
  "providerName": "Provider Name value",
  "keyName": "Key Name value",
  "paddingScheme": "pkcs1",
  "encryptedPfxBlob": "ZW5jcnlwdGVkUGZ4QmxvYg==",
  "encryptedPfxPassword": "Encrypted Pfx Password value"
}

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 200 OK
Content-Type: application/json
Content-Length: 695

{
  "@odata.type": "#microsoft.graph.userPFXCertificate",
  "id": "045c159b-159b-045c-9b15-5c049b155c04",
  "thumbprint": "Thumbprint value",
  "intendedPurpose": "smimeEncryption",
  "userPrincipalName": "User Principal Name value",
  "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
  "providerName": "Provider Name value",
  "keyName": "Key Name value",
  "paddingScheme": "pkcs1",
  "encryptedPfxBlob": "ZW5jcnlwdGVkUGZ4QmxvYg==",
  "encryptedPfxPassword": "Encrypted Pfx Password value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00"
}