Megaport::Ports

DESCRIPTION

This provide a simple read-only list of Megaport "partner ports". Details about the objects returned by the API can be found here.

Partner Ports

In Megaport terminology, a partner port is a Megaport service that is active on the network which is a valid target for VXC orders. Not all Megaport POPs are interconnected, there is the concept of networkRegion which defines which locations are accessible to each other.

This endpoint provides a locationId for each service but doesn't indicate the networkRegion. For now, this will need to be handled in application code.

METHODS

list

    # Optional array or arrayref
    my @list = $ports->list;
    my $list = $ports->list;

    # Use search terms to find a partial list
    my @telx_nyc2 = $ports->list(locationId => 78);
    my @google_cloud = $ports->list(companyUid => '29ba879b-45c8-48eb-bd97-618d0f20ea04');

    # Or use a regexp to get a bit fancy
    my @amsix = $ports->list(companyName => qr/^AMS-IX/);

Returns a list or allows searching based on any field present in the object.

get

    # id is an alias for productUid
    my $azure_wash_dc = $ports->get(id => '4695b867-84ad-48b4-bf25-fca26c443f2c');

Best used to search by id but as with "list" in list, any field can be used. This method uses "first" in List::Util to return the first matching entry. The data is stored in a hash internally so the keys are unordered. Using this method with a search term like companyUid will yield unexpected results.

AUTHOR

Cameron Daniel <cdaniel@cpan.org>