Create a core network policy version
You can create a core network policy version at any time from the console, using visual editor mode or JSON mode. When you create a policy version, you can configure settings that determine how your network works. When you create a new policy version, a change set of the proposed core network changes is added. You can then review the changes and deploy the new core network and core network policy when you're ready.
When you create a new policy version, the policy version ID increments from the previous
LIVE version. For example, if the current policy version ID is 1, and you
create a new version of that policy, the new version is numbered 2. The latest
version is displayed on the Policy versions screen with a LATEST
status, indicating that the new policy is ready to deploy.
Change set states can be any of the following:
-
Ready to execute — A policy version change set and a new policy version have been created. This policy version was verified with no issues and is in a state where it can be deployed as the new LIVE policy. You can have multiple policy versions in this state, but you can only have one LIVE policy. When deployed, the policy change set state changes to Execution succeeded. For the steps to deploy a policy change set state, see Deploy a policy version.
-
Execution succeeded — The policy version was deployed as the new LIVE policy.
-
Out of date — If you have multiple policy version change sets, any policy version that's older than the current LIVE policy is set to out-of-date, indicating that it's older than the LIVE policy. You can restore an out-of-date policy. For instructions, see Restore an out-of-date policy version.
-
Failed generation — An error prevented the policy from generating. Choose the Failed generation link to see details about the failure.
-
Pending generation — A policy version was created and is waiting to be generated. When the version has been generated, the change set state changes to Ready to execute. If policy generation failed, this state changes to Failed generation.
You can create a core network policy version using either the AWS Cloud WAN console or by creating a JSON file.
Create a policy version using the AWS Cloud WAN console
Use the AWS Cloud WAN console to create a core network policy version following these tasks:
Create a policy version using the JSON editor
You can create a core network policy version by using the AWS Cloud WAN JSON editor. In the JSON editor, you add the parameters of your core network and policies. For a description of the required and optional parameters in the JSON file, see Core network policy parameters.
Note
Familiarity with creating JSON files is required.
To create a policy version using a JSON editor
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity choose Cloud WAN.
-
On the Global networks page, choose the global network ID that for the core network you want to create a policy version for, and then choose Core network.
-
In the navigation pane, choose Policy versions.
-
Choose Create policy version.
-
In Choose policy view mode, choose JSON.
-
In the JSON editor, create your new policy. You can create a new policy version using a blank form, or copy and modify the contents of a policy version that you've downloaded.
-
For the required and optional parameters in your JSON policy, see Core network policy parameters.
-
For the steps to download a previous policy version, see Download a policy
-
-
Choose Create policy.
A new policy version is generated.
The Change set state on the Policy version page displays Pending generation while the new policy generates. The state changes when the policy either generates successfully or fails to generate.
Next step: Optional: Register a transit gateway.
