Partilhar via


grupo: validateProperties

Namespace: microsoft.graph

Valide se o nome a apresentar ou a alcunha de correio de um grupo do Microsoft 365 está em conformidade com as políticas de nomenclatura. Os clientes podem utilizar a API para determinar se um nome a apresentar ou alcunha de correio é válido antes de tentar atualizar um grupo do Microsoft 365. Para validar propriedades antes de criar um grupo, utilize a função validateProperties para objetos de diretório.

As seguintes validações são efetuadas para as propriedades de nome a apresentar e alcunha de correio:

  1. Validar a política de nomenclatura de prefixo e sufixo
  2. Validar a política de palavras banidas personalizadas

Esta API devolve com a primeira falha encontrada. Se uma ou mais propriedades falharem em várias validações, só é devolvida a propriedade com a primeira falha de validação. No entanto, pode validar a alcunha de correio e o nome a apresentar e receber uma coleção de erros de validação se estiver apenas a validar a política de nomenclatura de prefixo e sufixo.

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

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Group.Read.All Group.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Group.Read.All Group.ReadWrite.All

Solicitação HTTP

POST /groups/{id}/validateProperties

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
displayName Cadeia de caracteres O nome a apresentar do grupo a validar. A propriedade não é necessária individualmente. No entanto, é necessária, pelo menos, uma propriedade (displayName ou mailNickname).
mailNickname String A alcunha de correio do grupo a validar. A propriedade não é necessária individualmente. No entanto, é necessária, pelo menos, uma propriedade (displayName ou mailNickname).
onBehalfOfUserId Guid O ID de objeto do utilizador a representar ao chamar a API. Os resultados da validação destinam-se aos atributos e funções de onBehalfOfUserId.

Resposta

Se for bem-sucedido e não existirem erros de validação, o método devolve 204 No Content o código de resposta. Não devolve nada no corpo da resposta.

Se o pedido for inválido, o método devolve 400 Bad Request o código de resposta. É devolvida uma mensagem de erro com detalhes sobre o pedido inválido no corpo da resposta.

Se existir um erro de validação. O método devolve 422 Unprocessable Entity o código de resposta. É devolvida uma mensagem de erro e uma coleção de detalhes de erro no corpo da resposta.

Exemplos

Este é um exemplo de um pedido de validação bem-sucedido.

Solicitação

POST https://graph.microsoft.com/beta/groups/{id}/validateProperties
Content-type: application/json

{
  "displayName": "Myprefix_test_mysuffix",
  "mailNickname": "Myprefix_test_mysuffix",
  "onBehalfOfUserId": "onBehalfOfUserId-value"
}

Resposta

HTTP/1.1 204 No Content

Este é um exemplo de um pedido com erros de validação.

Solicitação

POST https://graph.microsoft.com/beta/groups/{id}/validateProperties
Content-type: application/json

{
  "displayName": "MyPrefix_test_mysuffix",
  "mailNickname": "MyPrefix_test_mysuffix"
}

Resposta

HTTP/1.1 422
Content-type: application/json

{
  "error": {
    "code": "Request_UnprocessableEntity",
    "message": "The values provided contain one or more validation errors.",
    "innerError": {
      "request-id": "id-value",
      "date": "date-value"
    },
    "details": [
      {
        "target": "mailNickname",
        "code": "PropertyConflict",
        "message": "Another object with the same value for property mailNickname already exists."
      }
    ]
  }
}