Atualize a organização

Namespace: microsoft.graph

Atualize as propriedades da organização autenticada no momento. Neste caso, organization é definido como uma coleção de exatamente um registo, pelo que o respetivo ID tem de ser especificado no pedido. O ID também é conhecido como o tenantId da organização.

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) Organization.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Organization.ReadWrite.All Indisponível.

As aplicações concedidas à permissão User.Read só conseguem ler as propriedades id, displayName e verifiedDomains da organização. Todas as outras propriedades são devolvidas com null valores. Para ler todas as propriedades, utilize, pelo menos, Organization.Read.All.

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função suportada do Microsoft Entra ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.

  • Administrador de Licenças do AdHoc
  • Administrador de Aplicativos
  • Administrador de Autenticação
  • Administrador do Azure Information Protection
  • Administrador do Azure Information Protection
  • Administrador de Cobrança
  • Administrador de Aplicativos de Nuvem
  • Administrador de Dados de Conformidade
  • Aprovador de Acesso do Sistema de Proteção de Dados do Cliente
  • Aprovador de Acesso do Sistema de Proteção de Dados do Cliente
  • Administrador de Análise de Computadores
  • Leitores de Diretórios
  • Revisor de Diretórios
  • Contas de Sincronização de Diretórios – para os serviços Microsoft Entra Connect e Microsoft Entra Cloud Sync
  • Escritores de diretório
  • Administrador do Dynamics 365
  • Administrador do Dynamics 365
  • Leitor Global
  • Utilizador Convidado
  • Administrador da Assistência Técnica
  • Administrador de Identidade Híbrida
  • Insights do Administrador
  • Administrador do Kaizala
  • Administrador de Licenças
  • Administrador de caixa de correio
  • Administrador de Ambiente de Trabalho Gerido da Microsoft
  • Utilizador da Microsoft Store para Empresas
  • Administrador de Comércio Moderno
  • Administrador do Power BI
  • Administrador do Power BI
  • Administrador de Autenticação Privilegiada
  • Administrador de Função Privilegiada
  • Utilizador Convidado Restrito
  • Administrador de Segurança
  • Operador de Segurança
  • Leitor de Segurança
  • Administrador do Suporte de Serviços
  • Administrador do Teams
  • Administrador de Comunicações do Teams
  • Engenheiro de Suporte de Comunicações de Equipes
  • Especialista em suporte à comunicação de equipes
  • Usuário
  • Administrador do usuário
  • Utilizador do Centro de Empresas de Licenciamento em Volume
  • Utilizador do Centro de Serviços de Licenciamento em Volume

Solicitação HTTP

PATCH /organization/{id}

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

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.

Propriedade Tipo Descrição
marketingNotificationEmails Coleção de cadeia de caracteres Anotações: não anulável.
privacyProfile privacyProfile O perfil de privacidade de uma organização (definir statementUrl e contactEmail).
securityComplianceNotificationMails Coleção de cadeias de caracteres
securityComplianceNotificationPhones Coleção de cadeia de caracteres
technicalNotificationMails Coleção de cadeia de caracteres Anotações: não anulável.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplo

Solicitação

PATCH https://graph.microsoft.com/v1.0/organization/84841066-274d-4ec0-a5c1-276be684bdd3
Content-type: application/json

{
  "marketingNotificationEmails" : ["marketing@contoso.com"],
  "privacyProfile" :
    {
      "contactEmail":"alice@contoso.com",
      "statementUrl":"https://contoso.com/privacyStatement"
    },
  "securityComplianceNotificationMails" : ["security@contoso.com"],
  "securityComplianceNotificationPhones" : ["(123) 456-7890"],
  "technicalNotificationMails" : ["tech@contoso.com"]
}

Resposta

HTTP/1.1 204 No Content