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

Managed Instance Administrators - Create Or Update

创建或更新托管实例管理员。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/administrators/ActiveDirectory?api-version=2021-05-01-preview

URI 参数

Name In Required Type Description
administratorName
path True
managedInstanceName
path True
  • string

托管实例的名称。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 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
  • string

托管实例管理员的租户 ID。

响应

Name Type Description
200 OK

已成功更新托管实例管理员。

201 Created

已成功创建托管实例管理员。

202 Accepted

已接受

Other Status Codes

错误响应: ***

  • 400 InvalidManagedServerAdministratorType - 属性中指定的管理员类型无效。

  • 400 InvalidResourceRequestBody - 请求正文中的资源或资源属性为空或无效。

  • 400 InvalidManagedServerAzureADAdminDeleteOperation - 用户尝试在设置 AzureADOnlyAuthentication 时删除托管服务器 Azure Active Azure 管理员,请先使用 azureADOnlyAuthentications API。

  • 400 InvalidManagedServerAADOnlyAuthTypePropertyName - 仅托管服务器Azure Active Directory身份验证类型应为默认值

  • 400 InvalidParameterValue - 为参数提供无效值。

  • 400 InvalidLoginName - 提供的登录名无效。

  • 400 PrincipalNotFoundInTenant - AzureAD Lookup 未返回此名称的结果。

  • 400 ServerPrincipalHasDuplicateDisplayNameInAad - AzureAD Lookup 返回了此名称的多个结果。

  • 400 ManagedInstanceIsBusy - 托管实例正忙于另一个请求。

  • 400 InvalidPrincipalType - Windows Azure SQL 数据库不支持此主体类型。

  • 400 ServicePrincipalLookupInAadFailed - AzureAD 查找因服务基础结构错误而失败。

  • 400 TenantNotFoundInActiveDirectory - 租户在 Active Directory 中不可用。

  • 400 InvalidUsername - 提供的用户名包含无效字符。

  • 400 ManagedInstanceHasNoPermissionsToAccessAad - 尝试执行操作,这涉及到执行主体没有权限的非现有登录名或登录名。

  • 403 ServicePrincipalLookupInAadFailedIdentityForbidden - AzureAD 查找失败,因为 MSI 未授予对 AAD 的读取权限。

  • 404 ServerNotInSubscription - 指定的服务器在指定的订阅上不存在。

  • 404 ManagedInstanceNotInSubscriptionResourceGroup - 指定的托管实例在指定的资源组和订阅中不存在。

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 OperationIdNotFound - ID 操作不存在。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 409 ServerPrincipalAlreadyExists - 尝试创建具有非唯一名称的服务器主体。

  • 409 ServerPrincipalCurrentlyLoggedIn - 自我解释。

  • 409 ServerPrincipalOwnsJobs - 尝试删除具有活动作业的登录名。

  • 409 ServerPrincipalIsGrantorOfPermissions - 尝试删除服务器主体,这是权限的授权者。

  • 409 ServerPrincipalOwnsDatabase - 在删除登录之前更改数据库 () 的所有者。

  • 409 ServerPrincipalUsedInTriggerOrEventNotification - 尝试删除登录,该登录名用作触发器或事件通知的执行上下文。

  • 409 ServerPrincipalOwnsObjects - 尝试删除拥有对象的登录名。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 500 ActiveDirectoryLookupTimedOut - 目前无法完成该操作。 请稍后重试。

  • 503 TooManyRequests - 请求超出可用资源可处理的最大请求数。

  • 504 RequestTimeout - 服务请求超出了允许的超时。

示例

Create administrator of managed instance
Update administrator of managed instance

Create administrator of managed instance

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-05-01-preview

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Update administrator of managed instance

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-05-01-preview

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

定义

AdministratorName
ManagedInstanceAdministrator

托管实例管理员Azure SQL。

ManagedInstanceAdministratorType

托管实例管理员的类型。

AdministratorName

Name Type Description
ActiveDirectory
  • string

ManagedInstanceAdministrator

托管实例管理员Azure SQL。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.administratorType

托管实例管理员的类型。

properties.login
  • string

托管实例管理员的登录名。

properties.sid
  • string

托管实例管理员的 SID (对象 ID) 。

properties.tenantId
  • string

托管实例管理员的租户 ID。

type
  • string

资源类型。

ManagedInstanceAdministratorType

托管实例管理员的类型。

Name Type Description
ActiveDirectory
  • string