Criar conjunto de políticas
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Criar um novo objeto policySet .
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) | DeviceManagementConfiguration.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceAppManagement/policySets
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 do pedido, forneça uma representação JSON para o objeto policySet.
A tabela seguinte mostra as propriedades necessárias quando cria o policySet.
Propriedade | Tipo | Descrição |
---|---|---|
id | Cadeia de caracteres | Chave do PolicySet. |
createdDateTime | DateTimeOffset | Hora de criação do PolicySet. |
lastModifiedDateTime | DateTimeOffset | Hora da última modificação do PolicySet. |
displayName | Cadeia de caracteres | DisplayName do PolicySet. |
description | Cadeia de caracteres | Descrição do PolicySet. |
status | policySetStatus | Validação/atribuição status do PolicySet. Os possíveis valores são: unknown , validating , partialSuccess , success , error , notAssigned . |
errorCode | errorCode | Código de erro se tiver ocorrido algum. Os valores possíveis são: noError , unauthorized , notFound , deleted . |
guidedDeploymentTags | String collection | Etiquetas da implementação orientada |
roleScopeTags | Coleção String | RoleScopeTags do PolicySet |
Resposta
Se for bem-sucedido, este método devolve um 201 Created
código de resposta e um objeto policySet no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/beta/deviceAppManagement/policySets
Content-type: application/json
Content-length: 317
{
"@odata.type": "#microsoft.graph.policySet",
"displayName": "Display Name value",
"description": "Description value",
"status": "validating",
"errorCode": "unauthorized",
"guidedDeploymentTags": [
"Guided Deployment Tags value"
],
"roleScopeTags": [
"Role Scope Tags 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 201 Created
Content-Type: application/json
Content-Length: 489
{
"@odata.type": "#microsoft.graph.policySet",
"id": "653cb373-b373-653c-73b3-3c6573b33c65",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"displayName": "Display Name value",
"description": "Description value",
"status": "validating",
"errorCode": "unauthorized",
"guidedDeploymentTags": [
"Guided Deployment Tags value"
],
"roleScopeTags": [
"Role Scope Tags value"
]
}