Atualizar ou criar trustFrameworkPolicy
Namespace: microsoft.graph
Importante: as APIs na versão /beta no Microsoft Graph estão em visualização e sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.
Atualize um trustFrameworkPolicy existente ou crie um se não existir.
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) | Policy.ReadWrite.TrustFramework | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | Policy.ReadWrite.TrustFramework | Indisponível. |
Importante
Em cenários delegados com contas escolares ou profissionais, tem de ser atribuída ao administrador uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. O Administrador de Política do IEF B2C é a função com menos privilégios suportada para esta operação.
Solicitação HTTP
PUT /trustFramework/policies/{id}/$value
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/xml. Obrigatório. |
Corpo da solicitação
No corpo do pedido, forneça uma representação XML do objeto trustFrameworkPolicy .
Nota: o tipo de conteúdo tem de ser
application/xml
.
Resposta
A resposta será uma das seguintes:
- Se existir um trustFrameworkPolicy , um pedido com êxito devolve um
200 OK
código de resposta. - Se não existir um trustFrameworkPolicy , um pedido com êxito devolve um
201 Created
código de resposta. - Caso não consiga, um
4xx
erro será retornado com detalhes específicos.
Exemplo
O exemplo seguinte atualiza um trustFrameworkPolicy.
Solicitação
PUT https://graph.microsoft.com/beta/trustFramework/policies/B2C_1A_SocialAndLocalAccounts_Base/$value
Content-Type: application/xml
<TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_SocialAndLocalAccounts_Base">
<!---PolicyContent-->
</TrustFrameworkPolicy>
Resposta
HTTP/1.1 200 OK
Content-Type: application/xml
<TrustFrameworkPolicy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/online/cpim/schemas/2013/06" PolicySchemaVersion="0.3.0.0" TenantId="contoso.com" PolicyId="B2C_1A_Test" PublicPolicyUri="http://contoso.com/B2C_1A_Test">
.....
....
<!---PolicyContent-->
....
....
</TrustFrameworkPolicy>