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

Batch Endpoints - Create Or Update

创建批处理推理终结点。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}?api-version=2021-03-01-preview

URI 参数

Name In Required Type Description
endpointName
path True
  • string

Batch 推理终结点的名称。

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

目标订阅的 ID。

workspaceName
path True
  • string

工作区Azure 机器学习的名称。

api-version
query True
  • string

用于此操作的 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源所位于的地理位置

properties True

实体的其他属性。

identity

与资源关联的服务标识。

kind
  • string
tags
  • object

资源标记。

响应

Name Type Description
200 OK

成功

201 Created

创建

Other Status Codes

错误

示例

CreateOrUpdate Batch Endpoint.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/batchEndpoints/testBatchEndpoint?api-version=2021-03-01-preview
{
  "tags": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuseridentity": {
        "principalId": "string",
        "clientId": "string"
      }
    }
  },
  "properties": {
    "authMode": "AMLToken",
    "description": "string",
    "properties": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "traffic": {
      "myDeployment1": 0,
      "myDeployment2": 1
    },
    "keys": {
      "primaryKey": "string",
      "secondaryKey": "string"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/batchEndpoints/testBatchEndpoint",
  "name": "testBatchEndpoint",
  "type": "Microsoft.MachineLearningServices/workspaces/batchEndpoints",
  "tags": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuseridentity": {
        "clientId": "string"
      }
    }
  },
  "properties": {
    "authMode": "AMLToken",
    "description": "string",
    "properties": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "traffic": {
      "myDeployment1": 0,
      "myDeployment2": 1
    },
    "scoringUri": "string",
    "swaggerUri": "string"
  },
  "systemData": {
    "createdAt": "2021-03-25T20:46:47.062Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2021-03-25T20:46:47.062Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/batchEndpoints/testBatchEndpoint",
  "name": "testBatchEndpoint",
  "type": "Microsoft.MachineLearningServices/workspaces/batchEndpoints",
  "tags": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup-1234/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuseridentity": {
        "clientId": "string"
      }
    }
  },
  "properties": {
    "authMode": "AMLToken",
    "description": "string",
    "properties": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "traffic": {
      "myDeployment1": 0,
      "myDeployment2": 1
    },
    "scoringUri": "string",
    "swaggerUri": "string"
  },
  "systemData": {
    "createdAt": "2021-03-25T20:46:47.062Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2021-03-25T20:46:47.062Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

定义

BatchEndpoint

Batch 终结点配置。

BatchEndpointTrackedResource
createdByType

创建资源的标识类型。

EndpointAuthKeys

用于终结点身份验证的密钥。

EndpointAuthMode

用于确定终结点身份验证模式的枚举。

ErrorAdditionalInfo

资源管理错误其他信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ResourceIdentity

与资源关联的服务标识。

ResourceIdentityAssignment

定义 ResourceIdentity 类型的值。

systemData

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

UserAssignedIdentityMeta

与资源关联的用户分配的标识。

BatchEndpoint

Batch 终结点配置。

Name Type Description
authMode

用于确定终结点身份验证模式的枚举。

description
  • string

推理终结点的说明。

keys

最初在终结点上设置的 EndpointAuthKeys。 此属性将始终返回为 null。 必须使用 ListKeys API 检索 AuthKey 值。

properties
  • object

属性字典。 可以添加属性,但不能删除或更改属性。

scoringUri
  • string

终结点 URI。

swaggerUri
  • string

终结点 Swagger URI。

traffic
  • object

有关如何在部署之间路由流量的流量规则。

BatchEndpointTrackedResource

Name Type Description
id
  • string

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

identity

与资源关联的服务标识。

kind
  • string
location
  • string

资源所位于的地理位置

name
  • string

资源的名称

properties

实体的其他属性。

systemData

与资源提供程序关联的系统数据

tags
  • object

资源标记。

type
  • string

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

createdByType

创建资源的标识类型。

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

EndpointAuthKeys

用于终结点身份验证的密钥。

Name Type Description
primaryKey
  • string

主键。

secondaryKey
  • string

辅助键。

EndpointAuthMode

用于确定终结点身份验证模式的枚举。

Name Type Description
AADToken
  • string
AMLToken
  • string
Key
  • 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

错误对象。

ResourceIdentity

与资源关联的服务标识。

Name Type Description
principalId
  • string

进行身份验证时使用的客户端 ID。

tenantId
  • string

此标识的 AAD 租户。

type

定义 ResourceIdentity 类型的值。

userAssignedIdentities

用户分配的标识字典,密钥是 UAI 的 ARM 资源 ID。

ResourceIdentityAssignment

定义 ResourceIdentity 类型的值。

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

systemData

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

Name Type Description
createdAt
  • string

UTC (资源创建) 。

createdBy
  • string

创建资源的标识。

createdByType

创建资源的标识类型。

lastModifiedAt
  • string

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

lastModifiedBy
  • string

上次修改资源的标识。

lastModifiedByType

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

UserAssignedIdentityMeta

与资源关联的用户分配的标识。

Name Type Description
clientId
  • string

又称应用程序 ID,它是应用程序主体Azure AD预配期间绑定到应用程序和服务主体的唯一标识符。

principalId
  • string

托管标识的服务主体对象的对象 ID,用于授予对 Azure 资源的基于角色的访问权限。