您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Server Administrators - Create Or Update

在现有服务器上创建或更新 active directory 管理员。 更新操作将覆盖现有管理员。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{serverName}/administrators/activeDirectory?api-version=2017-12-01

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

资源组的名称。 此名称不区分大小写。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

目标订阅的 ID。

api-version
query True
  • string

要用于此操作的 API 版本。

请求正文

Name Required Type Description
properties.administratorType True

管理员的类型。

properties.login True
  • string

服务器管理员登录帐户名称。

properties.sid True
  • string

服务器管理员 Sid (安全 ID) 。

properties.tenantId True
  • string

服务器 Active Directory 管理员租户 id。

响应

Name Type Description
200 OK

已成功更新 active directory 管理员

202 Accepted

操作正在进行

Other Status Codes

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active DirectoryOAuth2 Flow

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

ServerAdministratorCreate

Sample Request

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4/administrators/activeDirectory?api-version=2017-12-01
{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}

Sample Response

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4/administrators/activeDirectory",
  "name": "activeDirectory",
  "type": "Microsoft.DBforPostgreSQL/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}
{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4/administrators/activeDirectory",
  "name": "activeDirectory",
  "type": "Microsoft.DBforPostgreSQL/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}

定义

AdministratorType

管理员的类型。

CloudError

批处理服务的错误响应。

ErrorAdditionalInfo

资源管理错误的其他信息。

ErrorResponse

错误响应

ServerAdministratorResource

表示要创建的和外部管理员。

AdministratorType

管理员的类型。

Name Type Description
ActiveDirectory
  • string

CloudError

批处理服务的错误响应。

Name Type Description
error

错误响应
所有 Azure 资源管理器 Api 的常见错误响应返回失败操作的错误详细信息。 (这也遵循 OData 错误响应格式。 )

ErrorAdditionalInfo

资源管理错误的其他信息。

Name Type Description
info
  • object

附加信息。

type
  • string

其他信息类型。

ErrorResponse

错误响应

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ServerAdministratorResource

表示要创建的和外部管理员。

Name Type Description
id
  • string

资源的完全限定的资源 ID。 Ex-/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

资源的名称

properties.administratorType

管理员的类型。

properties.login
  • string

服务器管理员登录帐户名称。

properties.sid
  • string

服务器管理员 Sid (安全 ID) 。

properties.tenantId
  • string

服务器 Active Directory 管理员租户 id。

type
  • string

资源类型。 例如 "VirtualMachines" 或 "Microsoft"。存储/StorageAccounts "