Partilhar via

az networkfabric externalnetwork

  • Referência

Nota

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.

Gerencie recursos de rede externa.

Comandos

Name Description Tipo Estado
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 da 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 as 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 saber mais sobre sintaxe taquigráfica.

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

Parâmetros Obrigatórios

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

Nome do domínio de isolamento L3.

--peering-option

Lista de opções de emparelhamento.

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

o 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

Exportar Política de Rota IPv4 ou IPv6. Suporta sintaxe taquigráfica, 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

Importe a Política de Rota IPv4 ou IPv6. Suporta sintaxe taquigráfica, 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 recurso networkToNetworkInterconnectId do recurso ExternalNetwork.

--no-wait

Não espere que a operação de longa duração termine.

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

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

--option-b-properties

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Nome do domínio de isolamento L3.

--no-wait

Não espere que a operação de longa duração termine.

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

o 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

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

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

Nome do domínio de isolamento L3.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Nome do domínio de isolamento L3.

--resource-group -g

o 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

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 saber mais sobre sintaxe taquigráfica.

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

Parâmetros Opcionais

--annotation

Descrição do recurso subjacente.

--export-route-policy

Exportar Política de Rota IPv4 ou IPv6. Suporta sintaxe taquigráfica, 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--import-route-policy

Importe a Política de Rota IPv4 ou IPv6. Suporta sintaxe taquigráfica, 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 recurso networkToNetworkInterconnectId do recurso ExternalNetwork.

--no-wait

Não espere que a operação de longa duração termine.

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

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

--option-b-properties

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

--peering-option

Lista de opções de emparelhamento.

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

o 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

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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é ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: 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 predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--l3-isolation-domain-name --l3domain

Nome do domínio de isolamento L3.

--resource-group -g

o 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

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.