更新 temporaryAccessPassAuthenticationMethodConfiguration
本文内容
命名空间:microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
更新由 temporaryAccessPassAuthenticationMethodConfiguration 对象表示的 Azure AD 租户的临时访问传递策略。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限 。
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
Policy.ReadWrite.AuthenticationMethod
委派(个人 Microsoft 帐户)
不支持。
应用程序
Policy.ReadWrite.AuthenticationMethod
对于委派方案,管理员需要以下 Azure AD 角色 之一:
HTTP 请求
PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/TemporaryAccessPass
名称
说明
Authorization
Bearer {token}。必需。
Content-Type
application/json. Required.
请求正文
在请求正文中,使用应更新的字段值提供 temporaryAccessPassAuthenticationMethodConfiguration 对象的 JSON 表示形式。 请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。 为了获得最佳性能,请勿加入尚未更改的现有值。
可以更新对象的所有属性和关系。 有关属性和关系的列表,请参阅 temporaryAccessPassAuthenticationMethodConfiguration 。
备注
具有值#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration**的 @odata.type** 属性必须包含在请求正文中。
响应
如果成功,此方法返回 204 No Content 响应代码。它不在响应正文中返回任何内容。
示例
请求
PATCH https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass
Content-Type: application/json
{
"@odata.type":"#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
"isUsableOnce": true
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var authenticationMethodConfiguration = new TemporaryAccessPassAuthenticationMethodConfiguration
{
IsUsableOnce = true
};
await graphClient.Policies.AuthenticationMethodsPolicy.AuthenticationMethodConfigurations["{authenticationMethodConfiguration-id}"]
.Request()
.UpdateAsync(authenticationMethodConfiguration);
const options = {
authProvider,
};
const client = Client.init(options);
const authenticationMethodConfiguration = {
'@odata.type':'#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration',
isUsableOnce: true
};
await client.api('/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/temporaryAccessPass')
.version('beta')
.update(authenticationMethodConfiguration);
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
TemporaryAccessPassAuthenticationMethodConfiguration authenticationMethodConfiguration = new TemporaryAccessPassAuthenticationMethodConfiguration();
authenticationMethodConfiguration.isUsableOnce = true;
graphClient.policies().authenticationMethodsPolicy().authenticationMethodConfigurations("temporaryAccessPass")
.buildRequest()
.patch(authenticationMethodConfiguration);
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewAuthenticationMethodConfiguration()
requestBody.SetAdditionalData(map[string]interface{}{
"@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration",
"isUsableOnce": true,
}
authenticationMethodConfigurationId := "authenticationMethodConfiguration-id"
graphClient.Policies().AuthenticationMethodsPolicy().AuthenticationMethodConfigurationsById(&authenticationMethodConfigurationId).Patch(requestBody)
Import-Module Microsoft.Graph.Identity.SignIns
$params = @{
"@odata.type" = "#microsoft.graph.temporaryAccessPassAuthenticationMethodConfiguration"
IsUsableOnce = $true
}
Update-MgPolicyAuthenticationMethodPolicyAuthenticationMethodConfiguration -AuthenticationMethodConfigurationId $authenticationMethodConfigurationId -BodyParameter $params
响应
HTTP/1.1 204 No Content