Server Azure AD Administrators - Create Or Update
创建或更新现有的 Azure Active Directory 管理员。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/administrators/ActiveDirectory?api-version=2023-08-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
administrator
|
path | True |
服务器 Active Directory 管理员的名称。 |
|
|
resource
|
path | True |
string |
包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。 |
|
server
|
path | True |
string |
服务器的名称。 |
|
subscription
|
path | True |
string |
标识 Azure 订阅的订阅 ID。 |
|
api-version
|
query | True |
string |
要用于请求的 API 版本。 |
请求正文
| 名称 | 必需 | 类型 | 说明 |
|---|---|---|---|
| properties.login | True |
string |
服务器管理员的登录名。 |
| properties.sid | True |
string (uuid) |
服务器管理员的 SID (对象 ID)。 |
| properties.administratorType |
服务器管理员的类型。 |
||
| properties.tenantId |
string (uuid) |
管理员的租户 ID。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
已成功更新 Azure Active Directory 管理员。 |
|
| 201 Created |
已成功创建 Azure Active Directory 管理员。 |
|
| 202 Accepted |
接受 标头 Location: string |
|
| Other Status Codes |
错误响应: ***
|
示例
Creates or updates an existing Azure Active Directory administrator.
示例请求
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory?api-version=2023-08-01
{
"properties": {
"administratorType": "ActiveDirectory",
"login": "bob@contoso.com",
"sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
}
}
示例响应
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
"name": "ActiveDirectory",
"type": "Microsoft.Sql/servers/administrators",
"properties": {
"administratorType": "ActiveDirectory",
"login": "bob@contoso.com",
"sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"azureADOnlyAuthentication": true
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
"name": "activeDirectory",
"type": "Microsoft.Sql/servers/administrators",
"properties": {
"administratorType": "ActiveDirectory",
"login": "bob@contoso.com",
"sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"azureADOnlyAuthentication": true
}
}
定义
| 名称 | 说明 |
|---|---|
|
Administrator |
服务器 Active Directory 管理员的名称。 |
|
Administrator |
服务器管理员的类型。 |
|
Error |
资源管理错误附加信息。 |
|
Error |
错误详细信息。 |
|
Error |
错误响应 |
|
Server |
Azure Active Directory 管理员。 |
AdministratorName
服务器 Active Directory 管理员的名称。
| 值 | 说明 |
|---|---|
| ActiveDirectory |
AdministratorType
服务器管理员的类型。
| 值 | 说明 |
|---|---|
| ActiveDirectory |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
错误详细信息。 |
|
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
ServerAzureADAdministrator
Azure Active Directory 管理员。
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string |
资源 ID。 |
| name |
string |
资源名称。 |
| properties.administratorType |
服务器管理员的类型。 |
|
| properties.azureADOnlyAuthentication |
boolean |
仅启用 Azure Active Directory 身份验证。 |
| properties.login |
string |
服务器管理员的登录名。 |
| properties.sid |
string (uuid) |
服务器管理员的 SID (对象 ID)。 |
| properties.tenantId |
string (uuid) |
管理员的租户 ID。 |
| type |
string |
资源类型。 |