你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az networkfabric externalnetwork
注意
此参考是 Azure CLI 的 managednetworkfabric 扩展(版本 2.67.0 或更高版本)的一部分。 该扩展将在首次运行 az networkfabric externalnetwork 命令时自动安装。 详细了解扩展。
管理外部网络资源。
命令
名称 | 说明 | 类型 | Status |
---|---|---|---|
az networkfabric externalnetwork create |
创建外部网络资源。 |
外延 | 加语 |
az networkfabric externalnetwork delete |
删除外部网络资源。 |
外延 | 加语 |
az networkfabric externalnetwork list |
列出提供资源组中的所有外部网络。 |
外延 | 加语 |
az networkfabric externalnetwork show |
显示提供的外部网络资源的详细信息。 |
外延 | 加语 |
az networkfabric externalnetwork update |
更新外部网络资源。 |
外延 | 加语 |
az networkfabric externalnetwork update-bfd-administrative-state |
internalNetwork 的静态或 bgp 的 BFD 管理状态。 |
外延 | 加语 |
az networkfabric externalnetwork wait |
将 CLI 置于等待状态,直到满足条件。 |
外延 | 加语 |
az networkfabric externalnetwork create
创建外部网络资源。
az networkfabric externalnetwork create --l3-isolation-domain-name
--peering-option {OptionA, OptionB}
--resource-group
--resource-name
[--annotation]
[--export-route-policy]
[--import-route-policy]
[--network-to-network-interconnect-id]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--option-a-properties]
[--option-b-properties]
[--static-route-configuration]
示例
使用选项 B 属性创建外部网络
az networkfabric externalnetwork create --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalNetwork" --peering-option "OptionB" --option-b-properties "{routeTargets:{exportIpv4RouteTargets:['65046:10039'],exportIpv6RouteTargets:['65046:10039'],importIpv4RouteTargets:['65046:10039'],importIpv6RouteTargets:['65046:10039']}}" --import-route-policy "{importIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',importIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}" --export-route-policy "{exportIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',exportIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}"
使用选项 A 属性创建外部网络
az networkfabric externalnetwork create --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalNetwork" --peering-option "OptionA" --option-a-properties "{peerASN:65234,vlanId:501,mtu:1500,primaryIpv4Prefix:'172.23.1.0/31',secondaryIpv4Prefix:'172.23.1.2/31',bfdConfiguration:{multiplier:5,intervalInMilliSeconds:300}}" --import-route-policy "{importIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',importIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}" --export-route-policy "{exportIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',exportIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}"
可以使用速记语法“??”查看特定父级下子参数的帮助文本。 有关速记语法的详细信息,请参阅 https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md。
az networkfabric externalnetwork create --option-a-properties "??"
必需参数
L3 隔离域的名称。
对等互连选项列表。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
外部网络的名称。
可选参数
切换配置说明。
导出路由策略(IPv4 或 IPv6)。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
导入路由策略(IPv4 或 IPv6)。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
ExternalNetwork 资源的 networkToNetworkInterconnectId 的 ARM 资源 ID。
不要等待长时间运行的作完成。
选项 A 属性对象支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
Option B properties 对象支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
静态路由配置。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az networkfabric externalnetwork delete
删除外部网络资源。
az networkfabric externalnetwork delete [--ids]
[--l3-isolation-domain-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
示例
删除外部网络
az networkfabric externalnetwork delete --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalnetwork"
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
L3 隔离域的名称。
不要等待长时间运行的作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
外部网络的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az networkfabric externalnetwork list
列出提供资源组中的所有外部网络。
az networkfabric externalnetwork list --l3-isolation-domain-name
--resource-group
[--max-items]
[--next-token]
示例
列出资源组的外部网络
az networkfabric externalnetwork list --resource-group "example-rg" --l3domain "example-l3domain"
必需参数
L3 隔离域的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的 --next-token
参数中提供令牌值。
用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az networkfabric externalnetwork show
显示提供的外部网络资源的详细信息。
az networkfabric externalnetwork show [--ids]
[--l3-isolation-domain-name]
[--resource-group]
[--resource-name]
[--subscription]
示例
显示外部网络
az networkfabric externalnetwork show --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalnetwork"
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
L3 隔离域的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
外部网络的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az networkfabric externalnetwork update
更新外部网络资源。
az networkfabric externalnetwork update [--annotation]
[--export-route-policy]
[--ids]
[--import-route-policy]
[--l3-isolation-domain-name]
[--network-to-network-interconnect-id]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--option-a-properties]
[--option-b-properties]
[--peering-option {OptionA, OptionB}]
[--resource-group]
[--resource-name]
[--static-route-configuration]
[--subscription]
示例
使用选项 B 属性更新外部网络
az networkfabric externalnetwork update --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalNetwork" --peering-option "OptionB" --option-b-properties "{routeTargets:{exportIpv4RouteTargets:['65046:10039'],exportIpv6RouteTargets:['65046:10039'],importIpv4RouteTargets:['65046:10039'],importIpv6RouteTargets:['65046:10039']}}" --import-route-policy "{importIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',importIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}" --export-route-policy "{exportIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',exportIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}"
使用选项 A 属性更新外部网络
az networkfabric externalnetwork update --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalNetwork" --peering-option "OptionA" --nni-id "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourcegroups/example-rg/providers/microsoft.managednetworkfabric/networkfabrics/example-fabric/networkToNetworkInterconnects/example-nni" --option-a-properties "{peerASN:65234,vlanId:501,mtu:1500,primaryIpv4Prefix:'172.23.1.0/31',secondaryIpv4Prefix:'172.23.1.2/31',bfdConfiguration:{multiplier:5,intervalInMilliSeconds:300}}" --import-route-policy "{importIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',importIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}" --export-route-policy "{exportIpv4RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy',exportIpv6RoutePolicyId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/microsoft.managednetworkfabric/routePolicies/example-routepolicy'}"
可以使用速记语法“??”查看特定父级下子参数的帮助文本。 有关速记语法的详细信息,请参阅 https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md。
az networkfabric externalnetwork update --option-a-properties "??"
可选参数
切换配置说明。
导出路由策略(IPv4 或 IPv6)。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
导入路由策略(IPv4 或 IPv6)。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
L3 隔离域的名称。
ExternalNetwork 资源的 networkToNetworkInterconnectId 的 ARM 资源 ID。
不要等待长时间运行的作完成。
选项 A 属性对象支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
Option B properties 对象支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
对等互连选项列表。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
外部网络的名称。
静态路由配置。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az networkfabric externalnetwork update-bfd-administrative-state
internalNetwork 的静态或 bgp 的 BFD 管理状态。
az networkfabric externalnetwork update-bfd-administrative-state [--administrative-state {Disabled, Enabled, MAT, RMA}]
[--external-network-name]
[--ids]
[--l3-isolation-domain-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--route-type {OptionA, Static}]
[--subscription]
可选参数
管理状态。
外部网络的名称。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
L3 隔离域的名称。
不要等待长时间运行的作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
有助于了解要更新的 bfd 的路由类型。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az networkfabric externalnetwork wait
将 CLI 置于等待状态,直到满足条件。
az networkfabric externalnetwork wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--l3-isolation-domain-name]
[--resource-group]
[--resource-name]
[--subscription]
[--timeout]
[--updated]
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到删除为止。
等待资源存在。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔(以秒为单位)。
L3 隔离域的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
外部网络的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
最大等待(以秒为单位)。
等到 provisioningState 更新为“Succeeded”。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。