Compartilhar via

az networkfabric externalnetwork

  • Referência

Observação

Essa referência faz parte da extensão managednetworkfabric para a CLI do Azure (versão 2.49.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az networkfabric externalnetwork . Saiba mais sobre extensões.

Gerenciar recurso de rede externa.

Comandos

Nome Description Tipo Status
az networkfabric externalnetwork create

Crie um recurso de rede externa.

 Extensão GA
az networkfabric externalnetwork delete

Exclua o recurso Rede Externa.

 Extensão GA
az networkfabric externalnetwork list

Liste todas as Redes Externas no grupo de recursos fornecido.

 Extensão GA
az networkfabric externalnetwork show

Mostrar detalhes do recurso de rede externa fornecido.

 Extensão GA
az networkfabric externalnetwork update

Atualize o recurso Redes Externas.

 Extensão GA
az networkfabric externalnetwork wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão GA

az networkfabric externalnetwork create

Crie um recurso de rede externa.

az networkfabric externalnetwork create --l3-isolation-domain-name
                                        --peering-option {OptionA, OptionB}
                                        --resource-group
                                        --resource-name
                                        [--annotation]
                                        [--export-route-policy]
                                        [--export-route-policy-id]
                                        [--import-route-policy]
                                        [--import-route-policy-id]
                                        [--nni-id]
                                        [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                        [--option-a-properties]
                                        [--option-b-properties]

Exemplos

Criar uma rede externa com propriedades de opção 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'}"

Criar uma rede externa com propriedades da opção 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'}"

O texto de ajuda para subparâmetros sob o pai específico pode ser visualizado usando a sintaxe abreviada '??'. Consulte https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md para obter mais informações sobre sintaxe taquigráfica.

az networkfabric externalnetwork create --option-a-properties "??"

Parâmetros Exigidos

--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--peering-option

Lista de opções de emparelhamento.

valores aceitos: OptionA, OptionB
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-name

Nome da rede externa.

Parâmetros Opcionais

--annotation

Descrição do recurso subjacente.

--export-route-policy

Política de Rota de Exportação IPv4 ou IPv6. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--export-route-policy-id

ID do recurso ARM da RoutePolicy. Isso é usado para a compatibilidade com versões anteriores.

--import-route-policy

Política de Rota de Importação IPv4 ou IPv6. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--import-route-policy-id

ID do recurso ARM da RoutePolicy. Isso é usado para a compatibilidade com versões anteriores.

--nni-id

ID do recurso ARM do networkToNetworkInterconnectId do recurso ExternalNetwork.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--option-a-properties

Objeto de propriedades da opção A. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--option-b-properties

Objeto de propriedades da opção B. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az networkfabric externalnetwork delete

Exclua o recurso Rede Externa.

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]

Exemplos

Excluir a rede externa

az networkfabric externalnetwork delete --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalnetwork"

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-name

Nome da rede externa.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az networkfabric externalnetwork list

Liste todas as Redes Externas no grupo de recursos fornecido.

az networkfabric externalnetwork list --l3-isolation-domain-name
                                      --resource-group

Exemplos

Listar a rede externa para o grupo de recursos

az networkfabric externalnetwork list --resource-group "example-rg" --l3domain "example-l3domain"

Parâmetros Exigidos

--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az networkfabric externalnetwork show

Mostrar detalhes do recurso de rede externa fornecido.

az networkfabric externalnetwork show [--ids]
                                      [--l3-isolation-domain-name]
                                      [--resource-group]
                                      [--resource-name]
                                      [--subscription]

Exemplos

Mostrar a rede externa

az networkfabric externalnetwork show --resource-group "example-rg" --l3domain "example-l3domain" --resource-name "example-externalnetwork"

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-name

Nome da rede externa.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az networkfabric externalnetwork update

Atualize o recurso Redes Externas.

az networkfabric externalnetwork update [--annotation]
                                        [--export-route-policy]
                                        [--export-route-policy-id]
                                        [--ids]
                                        [--import-route-policy]
                                        [--import-route-policy-id]
                                        [--l3-isolation-domain-name]
                                        [--nni-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]
                                        [--subscription]

Exemplos

Atualizar a Rede Externa com as propriedades da opção 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'}"

Atualizar a Rede Externa com as propriedades da opção 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'}"

O texto de ajuda para subparâmetros sob o pai específico pode ser visualizado usando a sintaxe abreviada '??'. Consulte https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md para obter mais informações sobre sintaxe taquigráfica.

az networkfabric externalnetwork update --option-a-properties "??"

Parâmetros Opcionais

--annotation

Descrição do recurso subjacente.

--export-route-policy

Política de Rota de Exportação IPv4 ou IPv6. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--export-route-policy-id

ID do recurso ARM da RoutePolicy. Isso é usado para a compatibilidade com versões anteriores.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--import-route-policy

Política de Rota de Importação IPv4 ou IPv6. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--import-route-policy-id

ID do recurso ARM da RoutePolicy. Isso é usado para a compatibilidade com versões anteriores.

--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--nni-id

ID do recurso ARM do networkToNetworkInterconnectId do recurso ExternalNetwork.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--option-a-properties

Objeto de propriedades da opção A. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--option-b-properties

Objeto de propriedades da opção B. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--peering-option

Lista de opções de emparelhamento.

valores aceitos: OptionA, OptionB
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-name

Nome da rede externa.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az networkfabric externalnetwork wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az networkfabric externalnetwork wait [--created]
                                      [--custom]
                                      [--deleted]
                                      [--exists]
                                      [--ids]
                                      [--interval]
                                      [--l3-isolation-domain-name]
                                      [--resource-group]
                                      [--resource-name]
                                      [--subscription]
                                      [--timeout]
                                      [--updated]

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-name

Nome da rede externa.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.