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

Attached Data Networks - Create Or Update

创建或更新附加的数据网络。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/{packetCoreControlPlaneName}/packetCoreDataPlanes/{packetCoreDataPlaneName}/attachedDataNetworks/{attachedDataNetworkName}?api-version=2022-03-01-preview

URI 参数

Name In Required Type Description
attachedDataNetworkName
path True
  • string

附加数据网络的名称。

Regex pattern: ^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])*(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])*)*$

packetCoreControlPlaneName
path True
  • string

数据包核心控制平面的名称。

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

packetCoreDataPlaneName
path True
  • string

数据包核心数据平面的名称。

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

目标订阅的 ID。

api-version
query True
  • string

要用于此操作的 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源所在的地理位置

properties.userPlaneDataInterface True

数据网络上的用户界面。 在 5G 网络中,这称为 N6 接口,而在 4G 网络中,这称为 SGi 接口。

properties.naptConfiguration

网络地址和端口转换配置。 如果未指定附加数据网络,则使用启用了 NAPT 的默认 NAPT 配置。

properties.userEquipmentAddressPoolPrefix
  • string[]

在设置 PDU 会话时,由核心动态分配给 UE 的附加数据网络的用户设备地址池前缀。 必须定义至少一个 userEquipmentAddressPoolPrefix 和 userEquipmentStaticAddressPoolPrefix。 如果两者都定义,则它们的大小必须相同。

properties.userEquipmentStaticAddressPoolPrefix
  • string[]

在设置 PDU 会话时,由核心静态分配给 UE 的附加数据网络的用户设备地址池前缀。 静态 IP 到 sim 的映射在 sim 资源的 staticIpConfiguration 中配置。 必须定义至少一个 userEquipmentAddressPoolPrefix 和 userEquipmentStaticAddressPoolPrefix。 如果两者都定义,则它们的大小必须相同。

systemData.createdAt
  • string

资源创建时间戳 (UTC) 。

systemData.createdBy
  • string

创建资源的标识。

systemData.createdByType

创建资源的标识的类型。

systemData.lastModifiedAt
  • string

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

systemData.lastModifiedBy
  • string

上次修改资源的标识。

systemData.lastModifiedByType

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

tags
  • object

资源标记。

响应

Name Type Description
200 OK

更新成功。 该操作返回生成的附加数据网络资源。

201 Created

创建成功。 该操作返回生成的附加数据网络资源。

Other Status Codes

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

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

Create attached data network

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork?api-version=2022-03-01-preview

{
  "location": "eastus",
  "properties": {
    "userPlaneDataInterface": {
      "name": "N6"
    },
    "naptConfiguration": {
      "enabled": "Enabled",
      "portRange": {
        "minPort": 1024,
        "maxPort": 65535
      },
      "portReuseHoldTime": {
        "tcp": 120,
        "udp": 60
      },
      "pinholeLimits": 65536,
      "pinholeTimeouts": {
        "tcp": 7440,
        "udp": 300,
        "icmp": 60
      }
    },
    "userEquipmentAddressPoolPrefix": [
      "2.2.0.0/16"
    ],
    "userEquipmentStaticAddressPoolPrefix": [
      "2.4.0.0/16"
    ]
  }
}

Sample Response

{
  "name": "TestAttachedDataNetwork",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoresControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork",
  "type": "Microsoft.MobileNetwork/attachedDataNetwork",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "userPlaneDataInterface": {
      "name": "N6"
    },
    "naptConfiguration": {
      "enabled": "Enabled",
      "portRange": {
        "minPort": 1024,
        "maxPort": 65535
      },
      "portReuseHoldTime": {
        "tcp": 120,
        "udp": 60
      },
      "pinholeLimits": 65536,
      "pinholeTimeouts": {
        "tcp": 7440,
        "udp": 300,
        "icmp": 60
      }
    },
    "userEquipmentAddressPoolPrefix": [
      "2.2.0.0/16"
    ],
    "userEquipmentStaticAddressPoolPrefix": [
      "2.4.0.0/16"
    ]
  }
}
{
  "name": "TestAttachedDataNetwork",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoresControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork",
  "type": "Microsoft.MobileNetwork/attachedDataNetwork",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "userPlaneDataInterface": {
      "name": "N6"
    },
    "naptConfiguration": {
      "enabled": "Enabled",
      "portRange": {
        "minPort": 1024,
        "maxPort": 65535
      },
      "portReuseHoldTime": {
        "tcp": 120,
        "udp": 60
      },
      "pinholeLimits": 65536,
      "pinholeTimeouts": {
        "tcp": 7440,
        "udp": 300,
        "icmp": 60
      }
    },
    "userEquipmentAddressPoolPrefix": [
      "2.2.0.0/16"
    ],
    "userEquipmentStaticAddressPoolPrefix": [
      "2.4.0.0/16"
    ]
  }
}

定义

AttachedDataNetwork

附加的数据网络资源。

createdByType

创建资源的标识的类型。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

InterfaceProperties

接口属性

NaptConfiguration

用于附加数据网络的网络地址和端口转换设置。

NaptEnabled

是否启用网络地址和端口转换。

PinholeTimeouts

非活动 NAPT 针孔的到期时间(以秒为单位)。 所有计时器必须至少为 1 秒。

PortRange

要用作每个已转换地址上的已翻译端口的端口号范围。 如果未指定并且 NAPT 已启用,则此范围默认为 1,024 - 65,535。 不应使用 1,024 以下 (端口,因为这些端口是 IANA.) 保留的特殊用途端口

PortReuseHoldTimes

在关闭的针孔使用的端口之前, (以秒为单位的最短时间) 可以回收供另一个针孔使用。 所有保留时间都必须至少为 1 秒。

ProvisioningState

当前预配状态。

systemData

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

AttachedDataNetwork

附加的数据网络资源。

Name Type Description
id
  • string

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

location
  • string

资源所在的地理位置

name
  • string

资源的名称

properties.naptConfiguration

网络地址和端口转换配置。 如果未指定附加数据网络,则使用启用了 NAPT 的默认 NAPT 配置。

properties.provisioningState

附加数据网络资源的预配状态。

properties.userEquipmentAddressPoolPrefix
  • string[]

在设置 PDU 会话时,由核心动态分配给 UE 的附加数据网络的用户设备地址池前缀。 必须定义至少一个 userEquipmentAddressPoolPrefix 和 userEquipmentStaticAddressPoolPrefix。 如果两者都定义,则它们的大小必须相同。

properties.userEquipmentStaticAddressPoolPrefix
  • string[]

在设置 PDU 会话时,由核心静态分配给 UE 的附加数据网络的用户设备地址池前缀。 静态 IP 到 sim 的映射在 sim 资源的 staticIpConfiguration 中配置。 必须定义至少一个 userEquipmentAddressPoolPrefix 和 userEquipmentStaticAddressPoolPrefix。 如果两者都定义,则它们的大小必须相同。

properties.userPlaneDataInterface

数据网络上的用户界面。 在 5G 网络中,这称为 N6 接口,而在 4G 网络中,这称为 SGi 接口。

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

systemData.createdAt
  • string

资源创建时间戳 (UTC) 。

systemData.createdBy
  • string

创建资源的标识。

systemData.createdByType

创建资源的标识的类型。

systemData.lastModifiedAt
  • string

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

systemData.lastModifiedBy
  • string

上次修改资源的标识。

systemData.lastModifiedByType

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

tags
  • object

资源标记。

type
  • string

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

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

错误对象。

InterfaceProperties

接口属性

Name Type Description
ipv4Address
  • string

IPv4 地址。

ipv4Gateway
  • string

默认 IPv4 网关 (路由器) 。

ipv4Subnet
  • string

IPv4 子网。

name
  • string

此接口的逻辑名称。 这应与 Azure Stack Edge 计算机上配置的其中一个接口匹配。

NaptConfiguration

用于附加数据网络的网络地址和端口转换设置。

Name Type Default Value Description
enabled Enabled

是否启用 NAPT 以连接到此 attachedDataNetwork。

pinholeLimits
  • integer
65536

可在核心接口上同时打开的最大 UDP 和 TCP 针孔数。

pinholeTimeouts

非活动 NAPT 针孔的到期时间(以秒为单位)。 所有计时器必须至少为 1 秒。

portRange

要用作每个已转换地址上的已翻译端口的端口号范围。 如果未指定并且 NAPT 已启用,则此范围默认为 1,024 - 65,535。 不应使用 1,024 以下 (端口,因为这些端口是 IANA.) 保留的特殊用途端口

portReuseHoldTime

在关闭的针孔使用的端口之前, (以秒为单位的最短时间) 可以回收供另一个针孔使用。 所有保留时间都必须至少为 1 秒。

NaptEnabled

是否启用网络地址和端口转换。

Name Type Description
Disabled
  • string

NAPT 已禁用

Enabled
  • string

已启用 NAPT

PinholeTimeouts

非活动 NAPT 针孔的到期时间(以秒为单位)。 所有计时器必须至少为 1 秒。

Name Type Default Value Description
icmp
  • integer
60

ICMP 针孔的针孔超时(以秒为单位)。 ICMP Echo 的默认值为每 RFC 5508 节 3.2 60 秒。

tcp
  • integer
7440

TCP 针孔的针孔超时(以秒为单位)。 每个 RFC 5382 节 5 的 TCP 默认值为 2 小时 4 分钟。

udp
  • integer
300

UDP 针孔的针孔超时(以秒为单位)。 每个 RFC 4787 节 4.3 的默认 UDP 为 5 分钟。

PortRange

要用作每个已转换地址上的已翻译端口的端口号范围。 如果未指定并且 NAPT 已启用,则此范围默认为 1,024 - 65,535。 不应使用 1,024 以下 (端口,因为这些端口是 IANA.) 保留的特殊用途端口

Name Type Default Value Description
maxPort
  • integer
65535

最大端口号

minPort
  • integer
1024

最小端口号

PortReuseHoldTimes

在关闭的针孔使用的端口之前, (以秒为单位的最短时间) 可以回收供另一个针孔使用。 所有保留时间都必须至少为 1 秒。

Name Type Default Value Description
tcp
  • integer
120

可以重复使用闭合针孔使用的 TCP 端口之前传递的最短时间(以秒为单位)。 TCP 的默认值为 2 分钟。

udp
  • integer
60

可以重复使用闭合针孔使用的 UDP 端口之前传递的最短时间(以秒为单位)。 UDP 的默认值为 1 分钟。

ProvisioningState

当前预配状态。

Name Type Description
Accepted
  • string
Canceled
  • string
Deleted
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Unknown
  • string

systemData

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

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC) 。

createdBy
  • string

创建资源的标识。

createdByType

创建资源的标识的类型。

lastModifiedAt
  • string

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

lastModifiedBy
  • string

上次修改资源的标识。

lastModifiedByType

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