list
****


Description
===========

Lists either the ephemeral or reserved PublicIp objects in the
specified compartment.

To list your reserved public IPs, set *scope* = *REGION*, and leave
the *availabilityDomain* parameter empty.

To list your ephemeral public IPs, set *scope* =
*AVAILABILITY_DOMAIN*, and set the *availabilityDomain* parameter to
the desired Availability Domain. An ephemeral public IP is always in
the same Availability Domain and compartment as the private IP it's
assigned to.


Usage
=====

   oci network public-ip list [OPTIONS]


Options
=======


--scope [REGION|AVAILABILITY_DOMAIN]
------------------------------------

Whether the public IP is regional or specific to a particular
Availability Domain.

* *REGION*: The public IP exists within a region and can be assigned
  to a private IP in any Availability Domain in the region. Reserved
  public IPs have *scope* = *REGION*.

* *AVAILABILITY_DOMAIN*: The public IP exists within the
  Availability Domain of the private IP it's assigned to, which is
  specified by the *availabilityDomain* property of the public IP
  object. Ephemeral public IPs have *scope* = *AVAILABILITY_DOMAIN*.
  [required]


--compartment-id, -c [text]
---------------------------

The OCID of the compartment. [required]


--limit [integer]
-----------------

The maximum number of items to return in a paginated "List" call.

Example: *500*


--page [text]
-------------

The value of the *opc-next-page* response header from the previous
"List" call.


--availability-domain [text]
----------------------------

The name of the Availability Domain.

Example: *Uocm:PHX-AD-1*


--all
-----

Fetches all pages of results. If you provide this option, then you
cannot provide the --limit option.


--page-size [integer]
---------------------

When fetching results, the number of results to fetch per call. Only
valid when used with --all or --limit, and ignored otherwise.


--from-json [text]
------------------

Provide input to this command as a JSON document from a file.

Options can still be provided on the command line. If an option exists
in both the JSON document and the command line then the command line
specified value will be used


-?, -h, --help
--------------

Show this message and exit.
