Bandwidth Schedules - Create Or Update

服务:

Data Box Edge/Data Box Gateway

API 版本:

2023-12-01

创建或更新带宽计划。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/bandwidthSchedules/{name}?api-version=2023-12-01

URI 参数

名称	在	必需	类型	说明
deviceName	path	True	string	设备名称。
name	path	True	string	带宽计划名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
subscriptionId	path	True	string minLength: 1	目标订阅的 ID。
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
properties.days	True	DayOfWeek[]	此计划适用的星期几。
properties.rateInMbps	True	integer (int32)	带宽速率（以 Mbps 为单位）。
properties.start	True	string	计划的开始时间（UTC）。
properties.stop	True	string	计划的停止时间（UTC）。

响应

名称	类型	说明
200 OK	BandwidthSchedule	资源“BandwidthSchedule”更新作成功
202 Accepted		已接受资源操作。 标头 Location: string Retry-After: integer
Other Status Codes	CloudError	意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

BandwidthSchedulePut

示例请求

HTTP

PUT https://management.azure.com/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/bandwidthSchedules/bandwidth-1?api-version=2023-12-01

{
  "properties": {
    "days": [
      "Sunday",
      "Monday"
    ],
    "rateInMbps": 100,
    "start": "0:0:0",
    "stop": "13:59:0"
  }
}

示例响应

状态代码:

200

{
  "name": "bandwidth-1",
  "type": "dataBoxEdgeDevices/bandwidthSchedules",
  "id": "/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/bandwidthSchedules/bandwidth-1",
  "properties": {
    "days": [
      "Sunday",
      "Monday"
    ],
    "rateInMbps": 100,
    "start": "00:00:00",
    "stop": "13:59:00"
  }
}

状态代码:

202

定义

名称	说明
BandwidthSchedule	带宽计划详细信息。
CloudError	服务的错误响应。
CloudErrorBody	服务的错误响应。
createdByType	创建资源的标识的类型。
DayOfWeek
systemData	与创建和上次修改资源相关的元数据。

BandwidthSchedule

Object

带宽计划详细信息。

名称	类型	说明
id	string	资源的完全限定资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	资源的名称
properties.days	DayOfWeek[]	此计划适用的星期几。
properties.rateInMbps	integer (int32)	带宽速率（以 Mbps 为单位）。
properties.start	string	计划的开始时间（UTC）。
properties.stop	string	计划的停止时间（UTC）。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。 例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

CloudError

Object

服务的错误响应。

名称	类型	说明
error	CloudErrorBody	错误详细信息。

CloudErrorBody

Object

服务的错误响应。

名称	类型	说明
code	string	错误的标识符。 代码是固定的，旨在以编程方式使用。
details	CloudErrorBody[]	有关错误的其他详细信息的列表。
message	string	描述错误的消息，旨在适合在用户界面中显示。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

DayOfWeek

枚举

值	说明
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

systemData

Object

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

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。