;
};
export const Image = ({src, alt = '', caption, width, height, shadow}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
if (typeof src !== 'string') {
src = String(src);
}
if (!src || src === 'undefined') {
console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
return <>;
}
const img = ;
return caption ?
{img}
{caption} : img;
};
export const Gloss = ({term, anchor, langDir = 'en'}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Gloss -';
if (typeof term !== 'string') {
term = String(term);
}
if (typeof anchor !== 'string') {
anchor = String(anchor);
}
if (!term || term === 'undefined') {
console.error(`${errorPrefix} the \`term\` property is required — rendering an empty string instead`);
return <>;
}
if (!anchor || anchor === 'undefined') {
console.error(`${errorPrefix} the \`anchor\` property is required — rendering an empty string instead`);
return <>;
}
const lang = langDir === 'en' ? '/' : '/' + langDir + '/';
const glossaryPage = lang + 'glossary/#' + anchor;
return {term};
};
export const Link = ({href, children}) => {
const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Link -';
if (typeof href !== 'string') {
href = String(href);
}
if (!href || href === 'undefined') {
console.error(`${errorPrefix} the \`href\` property is required — rendering an empty string instead`);
return <>;
}
if (href.includes('{') || href.toUpperCase().includes('%7B')) {
console.error(`${errorPrefix} could not resolve a variable in href "${href}" — rendering an empty string instead`);
return <>;
}
const isExternal = (/^https?:\/\//).test(href);
return
{children ?? href}
{isExternal && (opens in a new tab)}
;
};
To deploy an AWS Hosted VIF, you need your
[AWS Account number](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html#FindingYourAccountIdentifiers) and the details of the VPC environment.
You can deploy multiple VXCs to the same VPC (for redundancy); however, you cannot deploy a single VXC to multiple VPCs. You need a separate VXC to connect to each AWS VPC.
AWS Hosted Virtual Interfaces (Hosted VIF) do not support diversity zones. To ensure connection diversity for Hosted VIFs, create VXCs to two destination ports in different data centers, instead of two ports in separate diversity zones.
**To create a Hosted VIF connection**
1. In the Megaport Portal, go to the **Services** page and select the Port you want to use.\
If you haven’t already created a Port, see [Creating a Port](/connections/creating-port).
2. Add an AWS connection for the Port.\
If this is the first connection for the Port, click the AWS tile. The tile is a shortcut to the configuration page. Alternatively, click **+Connection**, click **Cloud**, then click **AWS**.
3. Select AWS as the service provider, select Hosted VIF as the AWS Connection Type, select the destination port, then click **Next**.\
You can use the Select Destination Port search field to narrow the selection.
4. Specify the connection details:
* **Connection Name** -- The name of your VXC to be shown in the Megaport Portal.
Match this to the VXC name on the next screen for easy mapping.
* **Service Level Reference** (optional) -- Specify a unique identifying number for your Megaport service to be used for billing purposes, such as a cost center number, unique customer ID, or purchase order number. The service level reference number appears for each service under the Product section of the invoice. You can also edit this field for an existing service.
* **Rate Limit** -- The speed of your connection in Mbps. Accepted values start at 1 Mbps and scale in 1 Mbps increments. Maximum available speed depends on location and service availability. Note the sum of all hosted virtual VXCs to a service can exceed the Port capacity (for example, 10 Gbps, 100 Gbps, or higher) but the total aggregate will never burst beyond the Port capacity.
* **VXC State** -- Select **Enabled** or **Shut Down** to define the initial state of the connection. For more information, see [Shutting Down a VXC for Failover Testing](/connections/shut-down-vxc).
If you select **Shut Down**, traffic will not flow through this service and it will behave as if it was down on the Megaport network. Billing for this service will remain active and you will still be charged for this connection.
* **Preferred A-End VLAN** (optional) -- Specify an unused VLAN ID for this connection. This must be a unique VLAN ID on this Port and can range from 2 to 4093. If you specify a VLAN ID that is already in use, the system displays the next available VLAN number. The VLAN ID must be unique to proceed with the order. If you don't specify a value, Megaport will assign one.
Alternatively, you can select **Untagged** to remove the VLAN tagging for this connection. The untagged option limits you to only one VXC deployed on this Port. The VLAN for the AWS side termination will be automatically allocated and will not affect your Megaport details. You must use untagged VLANs if you are creating a MACsec connection.
* **Minimum Term** -- Select No Minimum Term, 12 Months, 24 Months, 36 Months, 48 Months, or 60 Months. Longer terms result in a lower monthly rate. *12 Months* is selected by default. Take note of the information on the screen to avoid early termination fees (ETF).
Enable the [Minimum Term Renewal](/portal-admin/auto-renew/#auto-renew) option for services with a 12, 24, 36, 48 or 60-month term to automatically renew the contract at the same discounted price and term length at the end of the contract. If you don't renew the contract, at the end of the term, the contract will automatically roll over to month-to-month contract for the following billing period, at the same price, without term discounts.
For more information, see [VXC Pricing and Contract Terms](/finance/vxc-pricing) and [VXC, Megaport Internet, and IX Billing](/finance/billing-details).
* **Resource Tags** -- You can use resource tags to add your own reference metadata to a Megaport service.\
To add a tag:
1. Click **Add Tags**.
2. Click **Add New Tag**.
3. Enter details into the fields:
* **Key** -- string maximum length 128. Valid values are a-z 0-9 \_ : . / \ -
* **Value** -- string maximum length 256. Valid values are a-z A-Z 0-9 \_ : . @ / + \ - (space)
4. Click **Save**.
If you already have resource tags for that service, you can manage them by clicking **Manage Tags**.
Never include sensitive information in a resource tag. Sensitive information includes commands that return existing tag definitions and information that will identify a person or company.
5. Click **Next**.
6. Specify the cloud details.
* Select **Public** or **Private**.
* **Private** -- Access private AWS services such as a VPC, EC2 instances, load balancers, RDS DB instances, on private IP address space.
* **Public** -- Access public AWS services such as Amazon Simple Storage Service (S3), DynamoDB, CloudFront, and Glacier. You will also receive [Amazon's global IP prefixes](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html) (approximately 2,000 prefixes).
Public VIFs require manual intervention from Amazon and could take up to 72 hours. For more information, see [Configuring Public AWS Connections with IP Addresses Provided by AWS](/cloud/megaport/aws/aws-public-ip).
* **AWS Connection Name** -- This is a text field and will be the name of your virtual interface that appears in the AWS console. For easy mapping, use the same name for this field as you did for the VXC name on the previous screen.
* **AWS Account ID** -- This is the ID of the account you want to connect. You can find this value in the management section of your AWS console.
* **Customer ASN** -- Your network's autonomous system number (ASN). For private Direct Connects, this must be a private ASN in the range 64512 - 65535. For public Direct Connects, this can be a private or public ASN in the range 2 - 4294967294. If using a public ASN, you must own it.
* **BGP Auth Key** (optional) -- Specify the BGP key. If you leave this blank, Megaport negotiates a key automatically for you with AWS which will be displayed in the Megaport Portal. The key is not displayed in the AWS console.
The BGP Auth Key is generated during the ordering process when this field is left blank. It will not be displayed on the Summary page when ordering. To see the key, view the Connection Settings after the service has been deployed and is live.
* **Customer IP Address** -- The IP Address space (in CIDR format) you will use on your network for peering. For private connections, this field is optional and if left blank, Megaport assigns a private /30 address. For public connections, this field is required and needs public IPs (/30) allocated by you for BGP connectivity. You must own the public IPs.
* **Amazon IP Address** -- The IP address space in CIDR format assigned in the AWS VPC network for peering. For private connections, this field is optional and if left blank, Megaport automatically assigns a private /30 address. For public connections, this field is required and needs public IPs (/30) allocated by you for BGP connectivity. You must own the public IPs.
* **Prefixes** -- For Public connections only - IP Prefixes to announce to AWS. RIR-assigned IPv4 addresses only. Specify the prefixes you will advertise when deploying a Public Direct Connect.
Once you configure Prefixes for a Public connection, you cannot change them and the field is grayed out. To change this value, create a support ticket with AWS so they can make this change a non-impacting way. Or you can cancel the Hosted VIF and reorder. In both cases, you need to wait for AWS to manually approve the request.
7. Click **Next**.\
A summary page appears that includes the monthly cost. Click **Back** to make changes or click **Add VXC** to move this configuration to your cart. Once you have finished this configuration, you can configure additional VXCs or proceed through the checkout process.
8. Click **Review Order** to proceed through the checkout process, or click **Save** to save the configured services before placing the order.
9. Review the Important Information section and confirm agreement with the Service Agreements.
If you do not have a promotion code, skip to the **Order Now** step. If you do have a promotion code, enter it into the **Enter discount code** field then click **Apply**. Alternatively, if a code already appears in the **Discounts** field, verify it is correct and click **Apply**.
The promotional discount appears below the Standard Term discount. This discount is not reflected in the Monthly Rate shown here, it is applied at the time of billing. If an invalid or expired code causes an error with your order, contact your Megaport Account Manager for a replacement code.
If you entered an incorrect promotion code, you can remove it by clicking **Remove**.
10. Click **Order Now**.
11. Accept the virtual interface in AWS.\
To review and accept in the AWS console, go to **Services** >
**AWS Direct Connect** for the Direct Connect dashboard. For a
private virtual interface, you must also have an existing virtual
private gateway or Direct Connect gateway. For more information, see the
[AWS documentation](https://docs.aws.amazon.com/directconnect/latest/UserGuide/accepthostedvirtualinterface.html).
Once you accept the hosted VIF in AWS, the VXC state changes to configured in the Megaport Portal. You can review the configuration details to get the A-End VLAN ID, BGP Auth Key, and IP addresses that you need to configure your router.
**To edit a Hosted Virtual Interface**
* Click the gear icon next to the connection in the Megaport Portal to make changes.
If you have permissions to edit VXCs, you can modify the details on
the Megaport side including the connection name, VLAN ID, Service Level Reference, and rate limit.\
If this is a termed connection, you cannot reduce the term.\
Once submitted, those changes take effect in a few minutes.
You can also make changes to the AWS details of a VXC. When you
change the AWS details, the service will be rebuilt and you need to
accept changes to the connection in AWS.
**To delete a Hosted Virtual Interface**
* Click the trash icon next to the connection in the Megaport Portal.
For more information, see [Terminating a VXC](/connections/terminating-vxc).