你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Managed Clusters - Reset AAD Profile

Service:

AKS

API Version:

2024-02-01

重置托管群集的 AAD 配置文件。
警告：此 API 将被弃用。 请参阅 AKS 托管的 Azure Active Directory 集成 ，以使用 AKS 托管的 Azure AD 更新群集。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/resetAADProfile?api-version=2024-02-01

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	资源组的名称。 此名称不区分大小写。
resourceName	path	True	string	托管群集资源的名称。 Regex pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId	path	True	string uuid	目标订阅的 ID。 该值必须是 UUID。
api-version	query	True	string	要用于此操作的 API 版本。

请求正文

名称	类型	说明
adminGroupObjectIDs	string[]	将具有群集管理员角色的 AAD 组对象 ID 的列表。
clientAppID	string	(已弃用) 客户端 AAD 应用程序 ID。 更多信息请访问 https://aka.ms/aks/aad-legacy。
enableAzureRBAC	boolean	是否为 Kubernetes 授权启用 Azure RBAC。
managed	boolean	是否启用托管 AAD。
serverAppID	string	(已弃用) 服务器 AAD 应用程序 ID。 更多信息请访问 https://aka.ms/aks/aad-legacy。
serverAppSecret	string	(已弃用) 服务器 AAD 应用程序机密。 更多信息请访问 https://aka.ms/aks/aad-legacy。
tenantID	string	用于身份验证的 AAD 租户 ID。 如果未指定，将使用部署订阅的租户。

响应

名称	类型	说明
200 OK		确定
202 Accepted		已接受 Headers Location: string
Other Status Codes	CloudError	描述操作失败原因的错误响应。 如果群集不存在，则返回 404 (找不到) 。

安全性

azure_auth

Azure Active Directory OAuth2 流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Reset AAD Profile

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/resetAADProfile?api-version=2024-02-01

{
  "clientAppID": "clientappid",
  "serverAppID": "serverappid",
  "serverAppSecret": "serverappsecret",
  "tenantID": "tenantid"
}

Sample Response

Status code:

200

Status code:

202

location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/eastus/operationresults/00000000-0000-0000-0000-000000000000?api-version=2017-08-31

定义

名称	说明
CloudError	来自容器服务的错误响应。
CloudErrorBody	来自容器服务的错误响应。
ManagedClusterAADProfile	AADProfile 指定 Azure Active Directory 集成的属性。

CloudError

来自容器服务的错误响应。

名称	类型	说明
error	CloudErrorBody	有关错误的详细信息。

CloudErrorBody

来自容器服务的错误响应。

名称	类型	说明
code	string	错误的标识符。 代码是固定的，旨在以编程方式使用。
details	CloudErrorBody[]	有关错误的其他详细信息的列表。
message	string	描述错误的消息，该消息适用于在用户界面中显示。
target	string	特定错误的目标。 例如，属性的名称出错。

ManagedClusterAADProfile

AADProfile 指定 Azure Active Directory 集成的属性。

名称	类型	说明
adminGroupObjectIDs	string[]	将具有群集管理员角色的 AAD 组对象 ID 的列表。
clientAppID	string	(已弃用) 客户端 AAD 应用程序 ID。 更多信息请访问 https://aka.ms/aks/aad-legacy。
enableAzureRBAC	boolean	是否为 Kubernetes 授权启用 Azure RBAC。
managed	boolean	是否启用托管 AAD。
serverAppID	string	(已弃用) 服务器 AAD 应用程序 ID。 更多信息请访问 https://aka.ms/aks/aad-legacy。
serverAppSecret	string	(已弃用) 服务器 AAD 应用程序机密。 更多信息请访问 https://aka.ms/aks/aad-legacy。
tenantID	string	用于身份验证的 AAD 租户 ID。 如果未指定，将使用部署订阅的租户。