NAME
Paws::NetworkManager - Perl Interface to AWS AWS Network Manager
SYNOPSIS
use Paws;
my $obj = Paws->service('NetworkManager');
my $res = $obj->Method(
Arg1 => $val1,
Arg2 => [ 'V1', 'V2' ],
# if Arg3 is an object, the HashRef will be used as arguments to the constructor
# of the arguments type
Arg3 => { Att1 => 'Val1' },
# if Arg4 is an array of objects, the HashRefs will be passed as arguments to
# the constructor of the arguments type
Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
);
DESCRIPTION
Transit Gateway Network Manager (Network Manager) enables you to create a global network, in which you can monitor your AWS and on-premises networks that are built around transit gateways.
The Network Manager APIs are supported in the US West (Oregon) Region only. You must specify the us-west-2
Region in all requests made to Network Manager.
For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/networkmanager-2019-07-05
METHODS
AssociateCustomerGateway
Each argument is described in detail in: Paws::NetworkManager::AssociateCustomerGateway
Returns: a Paws::NetworkManager::AssociateCustomerGatewayResponse instance
Associates a customer gateway with a device and optionally, with a link. If you specify a link, it must be associated with the specified device.
You can only associate customer gateways that are connected to a VPN attachment on a transit gateway. The transit gateway must be registered in your global network. When you register a transit gateway, customer gateways that are connected to the transit gateway are automatically included in the global network. To list customer gateways that are connected to a transit gateway, use the DescribeVpnConnections (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpnConnections.html) EC2 API and filter by transit-gateway-id
.
You cannot associate a customer gateway with more than one device and link.
AssociateLink
Each argument is described in detail in: Paws::NetworkManager::AssociateLink
Returns: a Paws::NetworkManager::AssociateLinkResponse instance
Associates a link to a device. A device can be associated to multiple links and a link can be associated to multiple devices. The device and link must be in the same global network and the same site.
AssociateTransitGatewayConnectPeer
Each argument is described in detail in: Paws::NetworkManager::AssociateTransitGatewayConnectPeer
Returns: a Paws::NetworkManager::AssociateTransitGatewayConnectPeerResponse instance
Associates a transit gateway Connect peer with a device, and optionally, with a link. If you specify a link, it must be associated with the specified device.
You can only associate transit gateway Connect peers that have been created on a transit gateway that's registered in your global network.
You cannot associate a transit gateway Connect peer with more than one device and link.
CreateConnection
- ConnectedDeviceId => Str
- DeviceId => Str
- GlobalNetworkId => Str
- [ConnectedLinkId => Str]
- [Description => Str]
- [LinkId => Str]
- [Tags => ArrayRef[Paws::NetworkManager::Tag]]
Each argument is described in detail in: Paws::NetworkManager::CreateConnection
Returns: a Paws::NetworkManager::CreateConnectionResponse instance
Creates a connection between two devices. The devices can be a physical or virtual appliance that connects to a third-party appliance in a VPC, or a physical appliance that connects to another physical appliance in an on-premises network.
CreateDevice
- GlobalNetworkId => Str
- [AWSLocation => Paws::NetworkManager::AWSLocation]
- [Description => Str]
- [Location => Paws::NetworkManager::Location]
- [Model => Str]
- [SerialNumber => Str]
- [SiteId => Str]
- [Tags => ArrayRef[Paws::NetworkManager::Tag]]
- [Type => Str]
- [Vendor => Str]
Each argument is described in detail in: Paws::NetworkManager::CreateDevice
Returns: a Paws::NetworkManager::CreateDeviceResponse instance
Creates a new device in a global network. If you specify both a site ID and a location, the location of the site is used for visualization in the Network Manager console.
CreateGlobalNetwork
- [Description => Str]
- [Tags => ArrayRef[Paws::NetworkManager::Tag]]
Each argument is described in detail in: Paws::NetworkManager::CreateGlobalNetwork
Returns: a Paws::NetworkManager::CreateGlobalNetworkResponse instance
Creates a new, empty global network.
CreateLink
- Bandwidth => Paws::NetworkManager::Bandwidth
- GlobalNetworkId => Str
- SiteId => Str
- [Description => Str]
- [Provider => Str]
- [Tags => ArrayRef[Paws::NetworkManager::Tag]]
- [Type => Str]
Each argument is described in detail in: Paws::NetworkManager::CreateLink
Returns: a Paws::NetworkManager::CreateLinkResponse instance
Creates a new link for a specified site.
CreateSite
- GlobalNetworkId => Str
- [Description => Str]
- [Location => Paws::NetworkManager::Location]
- [Tags => ArrayRef[Paws::NetworkManager::Tag]]
Each argument is described in detail in: Paws::NetworkManager::CreateSite
Returns: a Paws::NetworkManager::CreateSiteResponse instance
Creates a new site in a global network.
DeleteConnection
Each argument is described in detail in: Paws::NetworkManager::DeleteConnection
Returns: a Paws::NetworkManager::DeleteConnectionResponse instance
Deletes the specified connection in your global network.
DeleteDevice
Each argument is described in detail in: Paws::NetworkManager::DeleteDevice
Returns: a Paws::NetworkManager::DeleteDeviceResponse instance
Deletes an existing device. You must first disassociate the device from any links and customer gateways.
DeleteGlobalNetwork
Each argument is described in detail in: Paws::NetworkManager::DeleteGlobalNetwork
Returns: a Paws::NetworkManager::DeleteGlobalNetworkResponse instance
Deletes an existing global network. You must first delete all global network objects (devices, links, and sites) and deregister all transit gateways.
DeleteLink
Each argument is described in detail in: Paws::NetworkManager::DeleteLink
Returns: a Paws::NetworkManager::DeleteLinkResponse instance
Deletes an existing link. You must first disassociate the link from any devices and customer gateways.
DeleteSite
Each argument is described in detail in: Paws::NetworkManager::DeleteSite
Returns: a Paws::NetworkManager::DeleteSiteResponse instance
Deletes an existing site. The site cannot be associated with any device or link.
DeregisterTransitGateway
Each argument is described in detail in: Paws::NetworkManager::DeregisterTransitGateway
Returns: a Paws::NetworkManager::DeregisterTransitGatewayResponse instance
Deregisters a transit gateway from your global network. This action does not delete your transit gateway, or modify any of its attachments. This action removes any customer gateway associations.
DescribeGlobalNetworks
Each argument is described in detail in: Paws::NetworkManager::DescribeGlobalNetworks
Returns: a Paws::NetworkManager::DescribeGlobalNetworksResponse instance
Describes one or more global networks. By default, all global networks are described. To describe the objects in your global network, you must use the appropriate Get*
action. For example, to list the transit gateways in your global network, use GetTransitGatewayRegistrations.
DisassociateCustomerGateway
Each argument is described in detail in: Paws::NetworkManager::DisassociateCustomerGateway
Returns: a Paws::NetworkManager::DisassociateCustomerGatewayResponse instance
Disassociates a customer gateway from a device and a link.
DisassociateLink
Each argument is described in detail in: Paws::NetworkManager::DisassociateLink
Returns: a Paws::NetworkManager::DisassociateLinkResponse instance
Disassociates an existing device from a link. You must first disassociate any customer gateways that are associated with the link.
DisassociateTransitGatewayConnectPeer
Each argument is described in detail in: Paws::NetworkManager::DisassociateTransitGatewayConnectPeer
Returns: a Paws::NetworkManager::DisassociateTransitGatewayConnectPeerResponse instance
Disassociates a transit gateway Connect peer from a device and link.
GetConnections
- GlobalNetworkId => Str
- [ConnectionIds => ArrayRef[Str|Undef]]
- [DeviceId => Str]
- [MaxResults => Int]
- [NextToken => Str]
Each argument is described in detail in: Paws::NetworkManager::GetConnections
Returns: a Paws::NetworkManager::GetConnectionsResponse instance
Gets information about one or more of your connections in a global network.
GetCustomerGatewayAssociations
- GlobalNetworkId => Str
- [CustomerGatewayArns => ArrayRef[Str|Undef]]
- [MaxResults => Int]
- [NextToken => Str]
Each argument is described in detail in: Paws::NetworkManager::GetCustomerGatewayAssociations
Returns: a Paws::NetworkManager::GetCustomerGatewayAssociationsResponse instance
Gets the association information for customer gateways that are associated with devices and links in your global network.
GetDevices
- GlobalNetworkId => Str
- [DeviceIds => ArrayRef[Str|Undef]]
- [MaxResults => Int]
- [NextToken => Str]
- [SiteId => Str]
Each argument is described in detail in: Paws::NetworkManager::GetDevices
Returns: a Paws::NetworkManager::GetDevicesResponse instance
Gets information about one or more of your devices in a global network.
GetLinkAssociations
Each argument is described in detail in: Paws::NetworkManager::GetLinkAssociations
Returns: a Paws::NetworkManager::GetLinkAssociationsResponse instance
Gets the link associations for a device or a link. Either the device ID or the link ID must be specified.
GetLinks
- GlobalNetworkId => Str
- [LinkIds => ArrayRef[Str|Undef]]
- [MaxResults => Int]
- [NextToken => Str]
- [Provider => Str]
- [SiteId => Str]
- [Type => Str]
Each argument is described in detail in: Paws::NetworkManager::GetLinks
Returns: a Paws::NetworkManager::GetLinksResponse instance
Gets information about one or more links in a specified global network.
If you specify the site ID, you cannot specify the type or provider in the same request. You can specify the type and provider in the same request.
GetSites
Each argument is described in detail in: Paws::NetworkManager::GetSites
Returns: a Paws::NetworkManager::GetSitesResponse instance
Gets information about one or more of your sites in a global network.
GetTransitGatewayConnectPeerAssociations
- GlobalNetworkId => Str
- [MaxResults => Int]
- [NextToken => Str]
- [TransitGatewayConnectPeerArns => ArrayRef[Str|Undef]]
Each argument is described in detail in: Paws::NetworkManager::GetTransitGatewayConnectPeerAssociations
Returns: a Paws::NetworkManager::GetTransitGatewayConnectPeerAssociationsResponse instance
Gets information about one or more of your transit gateway Connect peer associations in a global network.
GetTransitGatewayRegistrations
- GlobalNetworkId => Str
- [MaxResults => Int]
- [NextToken => Str]
- [TransitGatewayArns => ArrayRef[Str|Undef]]
Each argument is described in detail in: Paws::NetworkManager::GetTransitGatewayRegistrations
Returns: a Paws::NetworkManager::GetTransitGatewayRegistrationsResponse instance
Gets information about the transit gateway registrations in a specified global network.
ListTagsForResource
Each argument is described in detail in: Paws::NetworkManager::ListTagsForResource
Returns: a Paws::NetworkManager::ListTagsForResourceResponse instance
Lists the tags for a specified resource.
RegisterTransitGateway
Each argument is described in detail in: Paws::NetworkManager::RegisterTransitGateway
Returns: a Paws::NetworkManager::RegisterTransitGatewayResponse instance
Registers a transit gateway in your global network. The transit gateway can be in any AWS Region, but it must be owned by the same AWS account that owns the global network. You cannot register a transit gateway in more than one global network.
TagResource
- ResourceArn => Str
- Tags => ArrayRef[Paws::NetworkManager::Tag]
Each argument is described in detail in: Paws::NetworkManager::TagResource
Returns: a Paws::NetworkManager::TagResourceResponse instance
Tags a specified resource.
UntagResource
Each argument is described in detail in: Paws::NetworkManager::UntagResource
Returns: a Paws::NetworkManager::UntagResourceResponse instance
Removes tags from a specified resource.
UpdateConnection
- ConnectionId => Str
- GlobalNetworkId => Str
- [ConnectedLinkId => Str]
- [Description => Str]
- [LinkId => Str]
Each argument is described in detail in: Paws::NetworkManager::UpdateConnection
Returns: a Paws::NetworkManager::UpdateConnectionResponse instance
Updates the information for an existing connection. To remove information for any of the parameters, specify an empty string.
UpdateDevice
- DeviceId => Str
- GlobalNetworkId => Str
- [AWSLocation => Paws::NetworkManager::AWSLocation]
- [Description => Str]
- [Location => Paws::NetworkManager::Location]
- [Model => Str]
- [SerialNumber => Str]
- [SiteId => Str]
- [Type => Str]
- [Vendor => Str]
Each argument is described in detail in: Paws::NetworkManager::UpdateDevice
Returns: a Paws::NetworkManager::UpdateDeviceResponse instance
Updates the details for an existing device. To remove information for any of the parameters, specify an empty string.
UpdateGlobalNetwork
Each argument is described in detail in: Paws::NetworkManager::UpdateGlobalNetwork
Returns: a Paws::NetworkManager::UpdateGlobalNetworkResponse instance
Updates an existing global network. To remove information for any of the parameters, specify an empty string.
UpdateLink
- GlobalNetworkId => Str
- LinkId => Str
- [Bandwidth => Paws::NetworkManager::Bandwidth]
- [Description => Str]
- [Provider => Str]
- [Type => Str]
Each argument is described in detail in: Paws::NetworkManager::UpdateLink
Returns: a Paws::NetworkManager::UpdateLinkResponse instance
Updates the details for an existing link. To remove information for any of the parameters, specify an empty string.
UpdateSite
- GlobalNetworkId => Str
- SiteId => Str
- [Description => Str]
- [Location => Paws::NetworkManager::Location]
Each argument is described in detail in: Paws::NetworkManager::UpdateSite
Returns: a Paws::NetworkManager::UpdateSiteResponse instance
Updates the information for an existing site. To remove information for any of the parameters, specify an empty string.
PAGINATORS
Paginator methods are helpers that repetively call methods that return partial results
DescribeAllGlobalNetworks(sub { },[GlobalNetworkIds => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])
DescribeAllGlobalNetworks([GlobalNetworkIds => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- GlobalNetworks, passing the object as the first parameter, and the string 'GlobalNetworks' as the second parameter
If not, it will return a a Paws::NetworkManager::DescribeGlobalNetworksResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllConnections(sub { },GlobalNetworkId => Str, [ConnectionIds => ArrayRef[Str|Undef], DeviceId => Str, MaxResults => Int, NextToken => Str])
GetAllConnections(GlobalNetworkId => Str, [ConnectionIds => ArrayRef[Str|Undef], DeviceId => Str, MaxResults => Int, NextToken => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- Connections, passing the object as the first parameter, and the string 'Connections' as the second parameter
If not, it will return a a Paws::NetworkManager::GetConnectionsResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllCustomerGatewayAssociations(sub { },GlobalNetworkId => Str, [CustomerGatewayArns => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])
GetAllCustomerGatewayAssociations(GlobalNetworkId => Str, [CustomerGatewayArns => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- CustomerGatewayAssociations, passing the object as the first parameter, and the string 'CustomerGatewayAssociations' as the second parameter
If not, it will return a a Paws::NetworkManager::GetCustomerGatewayAssociationsResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllDevices(sub { },GlobalNetworkId => Str, [DeviceIds => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str, SiteId => Str])
GetAllDevices(GlobalNetworkId => Str, [DeviceIds => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str, SiteId => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- Devices, passing the object as the first parameter, and the string 'Devices' as the second parameter
If not, it will return a a Paws::NetworkManager::GetDevicesResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllLinkAssociations(sub { },GlobalNetworkId => Str, [DeviceId => Str, LinkId => Str, MaxResults => Int, NextToken => Str])
GetAllLinkAssociations(GlobalNetworkId => Str, [DeviceId => Str, LinkId => Str, MaxResults => Int, NextToken => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- LinkAssociations, passing the object as the first parameter, and the string 'LinkAssociations' as the second parameter
If not, it will return a a Paws::NetworkManager::GetLinkAssociationsResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllLinks(sub { },GlobalNetworkId => Str, [LinkIds => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str, Provider => Str, SiteId => Str, Type => Str])
GetAllLinks(GlobalNetworkId => Str, [LinkIds => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str, Provider => Str, SiteId => Str, Type => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- Links, passing the object as the first parameter, and the string 'Links' as the second parameter
If not, it will return a a Paws::NetworkManager::GetLinksResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllSites(sub { },GlobalNetworkId => Str, [MaxResults => Int, NextToken => Str, SiteIds => ArrayRef[Str|Undef]])
GetAllSites(GlobalNetworkId => Str, [MaxResults => Int, NextToken => Str, SiteIds => ArrayRef[Str|Undef]])
If passed a sub as first parameter, it will call the sub for each element found in :
- Sites, passing the object as the first parameter, and the string 'Sites' as the second parameter
If not, it will return a a Paws::NetworkManager::GetSitesResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllTransitGatewayConnectPeerAssociations(sub { },GlobalNetworkId => Str, [MaxResults => Int, NextToken => Str, TransitGatewayConnectPeerArns => ArrayRef[Str|Undef]])
GetAllTransitGatewayConnectPeerAssociations(GlobalNetworkId => Str, [MaxResults => Int, NextToken => Str, TransitGatewayConnectPeerArns => ArrayRef[Str|Undef]])
If passed a sub as first parameter, it will call the sub for each element found in :
- TransitGatewayConnectPeerAssociations, passing the object as the first parameter, and the string 'TransitGatewayConnectPeerAssociations' as the second parameter
If not, it will return a a Paws::NetworkManager::GetTransitGatewayConnectPeerAssociationsResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
GetAllTransitGatewayRegistrations(sub { },GlobalNetworkId => Str, [MaxResults => Int, NextToken => Str, TransitGatewayArns => ArrayRef[Str|Undef]])
GetAllTransitGatewayRegistrations(GlobalNetworkId => Str, [MaxResults => Int, NextToken => Str, TransitGatewayArns => ArrayRef[Str|Undef]])
If passed a sub as first parameter, it will call the sub for each element found in :
- TransitGatewayRegistrations, passing the object as the first parameter, and the string 'TransitGatewayRegistrations' as the second parameter
If not, it will return a a Paws::NetworkManager::GetTransitGatewayRegistrationsResponse instance with all the param
s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
SEE ALSO
This service class forms part of Paws
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues