Partilhar via


az network public-ip

Gerencie endereços IP públicos.

Para saber mais sobre endereços IP públicos, visite https://v4.hkg1.meaqua.org/azure/virtual-network/virtual-network-public-ip-address.

Comandos

Name Description Tipo Status
az network public-ip create

Crie um endereço IP público.

Core disponibilidade geral
az network public-ip ddos-protection

Gerencie a proteção contra DDoS de IP público.

Core disponibilidade geral
az network public-ip ddos-protection show

Obtenha o status de proteção contra DDoS de um endereço IP público.

Core disponibilidade geral
az network public-ip delete

Exclua um endereço IP público.

Core disponibilidade geral
az network public-ip list

Liste endereços IP públicos.

Core disponibilidade geral
az network public-ip prefix

Gerencie recursos de prefixo IP público.

Core disponibilidade geral
az network public-ip prefix create

Crie um recurso de prefixo IP público.

Core disponibilidade geral
az network public-ip prefix delete

Exclua um recurso de prefixo IP público.

Core disponibilidade geral
az network public-ip prefix list

Listar recursos de prefixo IP público.

Core disponibilidade geral
az network public-ip prefix show

Obtenha os detalhes de um recurso de prefixo IP público.

Core disponibilidade geral
az network public-ip prefix update

Atualize um recurso de prefixo IP público.

Core disponibilidade geral
az network public-ip prefix wait

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

Core disponibilidade geral
az network public-ip show

Obtenha os detalhes de um endereço IP público.

Core disponibilidade geral
az network public-ip update

Atualize um endereço IP público.

Core disponibilidade geral
az network public-ip wait

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

Core disponibilidade geral

az network public-ip create

Crie um endereço IP público.

az network public-ip create --name
                            --resource-group
                            [--allocation-method {Dynamic, Static}]
                            [--ddos-protection-mode --protection-mode {Disabled, Enabled, VirtualNetworkInherited}]
                            [--ddos-protection-plan]
                            [--dns-name]
                            [--dns-name-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse}]
                            [--edge-zone]
                            [--idle-timeout]
                            [--ip-address]
                            [--ip-tags]
                            [--location]
                            [--public-ip-prefix]
                            [--reverse-fqdn]
                            [--sku {Basic, Standard, StandardV2}]
                            [--tags]
                            [--tier {Global, Regional}]
                            [--version {IPv4, IPv6}]
                            [--zone]

Exemplos

Crie um recurso IP público básico.

az network public-ip create -g MyResourceGroup -n MyIp

Crie um recurso IP público estático para um rótulo de nome DNS.

az network public-ip create -g MyResourceGroup -n MyIp --dns-name MyLabel --allocation-method Static

Crie um recurso IP público em uma zona de disponibilidade na região atual do grupo de recursos.

az network public-ip create -g MyResourceGroup -n MyIp --zone 2

Parâmetros Obrigatórios

--name -n

O nome do endereço IP público.

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--allocation-method

Método de alocação de endereços IP.

Propriedade Valor
Valores aceites: Dynamic, Static
--ddos-protection-mode --protection-mode

O modo de proteção contra DDoS do IP público.

Propriedade Valor
Valores aceites: Disabled, Enabled, VirtualNetworkInherited
--ddos-protection-plan

Nome ou ID de um plano de proteção contra DDoS associado ao IP público. Só pode ser definido se --protection-mode estiver habilitado.

--dns-name

Entrada DNS globalmente exclusiva.

--dns-name-scope

O escopo do rótulo do nome de domínio. Se um rótulo de nome de domínio e um escopo de rótulo de nome de domínio forem especificados, um registro DNS A será criado para o IP público no sistema DNS do Microsoft Azure com um valor em hash incluído no FQDN.

Propriedade Valor
Valores aceites: NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse
--edge-zone

O nome da zona de borda.

--idle-timeout

Tempo limite ocioso em minutos.

Propriedade Valor
Default value: 4
--ip-address

O endereço IP associado ao recurso de endereço IP público.

--ip-tags

Lista separada por espaços de tags IP no formato 'TYPE=VAL'.

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--public-ip-prefix

Nome ou ID de um prefixo IP público.

--reverse-fqdn

FQDN reverso (nome de domínio totalmente qualificado).

--sku

Nome de um endereço IP público SKU.

Propriedade Valor
Default value: Standard
Valores aceites: Basic, Standard, StandardV2
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--tier

A camada de um endereço IP público SKU e a camada Global só são suportadas para endereços IP públicos SKU padrão.

Propriedade Valor
Valores aceites: Global, Regional
--version

Tipo de endereço IP.

Propriedade Valor
Valores aceites: IPv4, IPv6
--zone -z

Lista separada por espaço de zonas de disponibilidade nas quais provisionar o recurso.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az network public-ip delete

Exclua um endereço IP público.

az network public-ip delete [--ids]
                            [--name]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--resource-group]
                            [--subscription]

Exemplos

Exclua um endereço IP público.

az network public-ip delete -g MyResourceGroup -n MyIp

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--ids

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do endereço IP público.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
Valores aceites: 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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az network public-ip list

Liste endereços IP públicos.

az network public-ip list [--max-items]
                          [--next-token]
                          [--resource-group]

Exemplos

Listar todos os IPs públicos em uma assinatura.

az network public-ip list

Liste todos os IPs públicos em um grupo de recursos.

az network public-ip list -g MyResourceGroup

Liste todos os IPs públicos de um rótulo de nome de domínio.

az network public-ip list -g MyResourceGroup --query "[?dnsSettings.domainNameLabel=='MyLabel']"

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--resource-group -g

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az network public-ip show

Obtenha os detalhes de um endereço IP público.

az network public-ip show [--expand]
                          [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

Exemplos

Obtenha informações sobre um recurso IP público.

az network public-ip show -g MyResourceGroup -n MyIp

Obtenha o FQDN e o endereço IP de um recurso IP público.

az network public-ip show -g MyResourceGroup -n MyIp --query "{fqdn: dnsSettings.fqdn,address: ipAddress}"

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--expand

Expande os recursos referenciados.

--ids

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do endereço IP público.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az network public-ip update

Atualize um endereço IP público.

az network public-ip update [--add]
                            [--allocation-method {Dynamic, Static}]
                            [--ddos-protection-mode --protection-mode {Disabled, Enabled, VirtualNetworkInherited}]
                            [--ddos-protection-plan]
                            [--dns-name]
                            [--dns-name-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse}]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--idle-timeout]
                            [--ids]
                            [--ip-tags]
                            [--name]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--public-ip-prefix]
                            [--remove]
                            [--resource-group]
                            [--reverse-fqdn]
                            [--set]
                            [--sku {Basic, Standard, StandardV2}]
                            [--subscription]
                            [--tags]
                            [--version {IPv4, IPv6}]

Exemplos

Atualize um recurso IP público com um rótulo de nome DNS e alocação estática.

az network public-ip update -g MyResourceGroup -n MyIp --dns-name MyLabel --allocation-method Static

Desanexe um plano de proteção contra DDoS em um recurso IP público.

az network public-ip update -g MyResourceGroup -n MyIP --protection-mode Disabled --ddos-protection-plan null

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--allocation-method

Método de alocação de endereços IP.

Propriedade Valor
Valores aceites: Dynamic, Static
--ddos-protection-mode --protection-mode

O modo de proteção contra DDoS do IP público.

Propriedade Valor
Valores aceites: Disabled, Enabled, VirtualNetworkInherited
--ddos-protection-plan

Nome ou ID de um plano de proteção contra DDoS associado ao IP público. Só pode ser definido se --protection-mode estiver habilitado.

--dns-name

Entrada DNS globalmente exclusiva.

--dns-name-scope

O escopo do rótulo do nome de domínio. Se um rótulo de nome de domínio e um escopo de rótulo de nome de domínio forem especificados, um registro DNS A será criado para o IP público no sistema DNS do Microsoft Azure com um valor em hash incluído no FQDN.

Propriedade Valor
Valores aceites: NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse
--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--idle-timeout

Tempo limite ocioso em minutos.

--ids

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--ip-tags

Lista separada por espaço de tags IP em formato TYPE=VAL. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--name -n

O nome do endereço IP público.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--public-ip-prefix

Nome ou ID de um prefixo IP público.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--reverse-fqdn

FQDN reverso (nome de domínio totalmente qualificado).

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--sku

Nome de um endereço IP público SKU.

Propriedade Valor
Valores aceites: Basic, Standard, StandardV2
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--version

Tipo de endereço IP.

Propriedade Valor
Default value: IPv4
Valores aceites: IPv4, IPv6
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az network public-ip wait

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

az network public-ip wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--ids]
                          [--interval]
                          [--name]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--created

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
--custom

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
--expand

Expande os recursos referenciados.

--ids

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: 30
--name -n

O nome do endereço IP público.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: 3600
--updated

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False