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

Users - Create Or Update

创建或更新实验室用户的操作。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/users/{userName}?api-version=2022-08-01

URI 参数

Name In Required Type Description
labName
path True
  • string

在包含实验室计划中唯一标识它的实验室的名称。 在资源 URI 中使用。

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

目标订阅的 ID。

userName
path True
  • string

唯一标识在包含实验室内的用户的名称。 在资源 URI 中使用。

Regex pattern: ^[-\w\\._\\(\\)]+$

api-version
query True
  • string

要用于此操作的 API 版本。

请求正文

Name Required Type Description
properties.email True
  • string

用户的电子邮件地址。

properties.additionalUsageQuota
  • string

除了实验室使用配额外,用户获得的使用量配额。

响应

Name Type Description
200 OK

用户已成功更新;响应包含实验室用户。

201 Created

已成功创建用户;响应包含实验室用户。

202 Accepted

用户已成功更新,并且运行时间较长;响应包含实验室用户。

Other Status Codes

默认错误响应。

示例

putUser

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/users/testuser?api-version=2022-08-01

{
  "properties": {
    "additionalUsageQuota": "PT10H",
    "email": "testuser@contoso.com"
  }
}

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/users/testuser",
  "name": "default",
  "type": "Microsoft.LabServices/User",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "displayName": "Test User",
    "email": "testuser@contoso.com",
    "registrationState": "Registered",
    "invitationState": "Sent",
    "totalUsage": "PT10H",
    "additionalUsageQuota": "PT10H"
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/users/testuser",
  "name": "default",
  "type": "Microsoft.LabServices/User",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "displayName": "Test User",
    "email": "testuser@contoso.com",
    "registrationState": "Registered",
    "invitationState": "Sent",
    "totalUsage": "PT10H",
    "additionalUsageQuota": "PT10H"
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/users/testuser",
  "name": "default",
  "type": "Microsoft.LabServices/User",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Updating",
    "displayName": "Test User",
    "email": "testuser@contoso.com",
    "registrationState": "Registered",
    "invitationState": "Sent",
    "totalUsage": "PT10H",
    "additionalUsageQuota": "PT10H"
  }
}

定义

createdByType

创建资源的标识的类型。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

InvitationState

实验室用户邀请状态。

ProvisioningState

用户资源的当前预配状态。

RegistrationState

用户实验室注册状态。

systemData

与创建和上次修改资源相关的元数据。

User

可在实验室中注册和使用虚拟机的实验室的用户。

createdByType

创建资源的标识的类型。

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

ErrorDetail

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ErrorResponse

错误响应

Name Type Description
error

错误对象。

InvitationState

实验室用户邀请状态。

Name Type Description
Failed
  • string

发送邀请时出错。

NotSent
  • string

尚未发送邀请。

Sending
  • string

当前发送邀请。

Sent
  • string

已成功发送邀请。

ProvisioningState

用户资源的当前预配状态。

Name Type Description
Creating
  • string

正在创建资源。

Deleting
  • string

正在删除资源。

Failed
  • string

资源上一次操作失败,导致资源处于不正常状态。

Locked
  • string

资源已锁定,当前已阻止更改。 这可能是由于维护或计划的操作造成的。 锁定操作完成后,状态将恢复为成功。

Succeeded
  • string

创建或更新操作后,资源处于正常状态。

Updating
  • string

正在向资源应用新的属性值。

RegistrationState

用户实验室注册状态。

Name Type Description
NotRegistered
  • string

用户已注册到实验室。

Registered
  • string

用户尚未注册到实验室。

systemData

与创建和上次修改资源相关的元数据。

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC) 。

createdBy
  • string

创建资源的标识。

createdByType

创建资源的标识的类型。

lastModifiedAt
  • string

资源上次修改的时间戳 (UTC)

lastModifiedBy
  • string

上次修改资源的标识。

lastModifiedByType

上次修改资源的标识的类型。

User

可在实验室中注册和使用虚拟机的实验室的用户。

Name Type Description
id
  • string

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

name
  • string

资源的名称

properties.additionalUsageQuota
  • string

除了实验室使用配额外,用户获得的使用量配额。

properties.displayName
  • string

用户的显示名称,例如用户的全名。

properties.email
  • string

用户的电子邮件地址。

properties.invitationSent
  • string

发送给用户的邀请消息的日期和时间。

properties.invitationState

用户的邀请消息的状态。

properties.provisioningState

用户资源的当前预配状态。

properties.registrationState

实验室中用户注册的状态。

properties.totalUsage
  • string

用户在此实验室中使用其虚拟机的时间。

systemData

与创建和上次修改用户资源相关的元数据。

type
  • string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”