Create Network Policy Rule (v2.3)

POST 
/sdwan/v2.3/api/networkpolicysets/:policy_set_id/networkpolicyrules

Create a new network policy rule.

Request

Path Parameters

policy_set_id stringrequired

The network policy set ID.

application/json

Body

Details of the network policy to be created

app_def_ids string[]

The app definition IDs that have applied network policy rules. The number of applications for a policy rule is limited to 256.

best_path_config BestPathConfig

Information on the best path configuration values.

metric stringrequired

Possible values: [LATENCY, JITTER, PACKET_LOSS, INIT_FAILURE_PCT, DNS_TXN_FAILURE_PCT]

Metric: Required(error = METRIC_PARAMETER_MISSING: Metric parameter is required) ValidateEnum(enumClass = classOf[LQMMetricType], error = NETWORK_POLICY_INVALID_PROBE_METRIC: Probe metric is invalid. It should be latency, jitter, packet_loss, init_failure_pct or dns_txn_failure_pct, nullAllowed = false)

metric_type stringrequired

Possible values: [PROBE, LQM]

Metric Type: Required(error = METRIC_TYPE_MISSING: Metric type is required) ValidateEnum(enumClass = classOf[ProbeMetricType], error = NETWORK_POLICY_INVALID_PROBE_METRIC_TYPE: Probe metric type is invalid. It should be lqm or probe, nullAllowed = false)

probe_config_id string

Probe Config Id

description

The description of the network policy rule. Max size = 256.

destination_prefixes_id string

The destination prefix ID.

enabled boolean

The network policy rule based on rules that are enabled.

id string

The network policy rule ID.

name stringrequired

The name of the network policy rule. Max size = 128.

network_context_id string

The network context applied to the network policy rule. Network context segments network traffic for the purpose of applying different network policy rules for the same application.

order_number integer

The network policy rule order number. The default order number for a policy rule is 1024.

paths_allowed PathsAllowedV2N1required
The paths allowed for the application.
active_paths WANPath[]
The configured active path for the rule.
Array [
label string
The label to identify the path.
path_type stringrequired
Possible values: [vpn, direct, servicelink]
The path type.
]
backup_paths WANPath[]
The configured backup path for the rule.
Array [
label string
The label to identify the path.
path_type stringrequired
Possible values: [vpn, direct, servicelink]
The path type.
]
l3_failure_paths WANPath[]
The configured l3 failure path for the rule.
Array [
label string
The label to identify the path.
path_type stringrequired
Possible values: [vpn, direct, servicelink]
The path type.
]
service_context ServiceContext

Information on the service context.

active_service_label_id stringrequired

The configured active service label ID.

active_service_label_type string

Possible values: [CG_TRANSIT, NON_CG_TRANSIT, SASE]

The configured active service label type.

backup_service_label_id string

The configured backup service label ID.

backup_service_label_type string

Possible values: [CG_TRANSIT, NON_CG_TRANSIT, SASE]

The configured backup service label type.

type stringrequired

Possible values: [ALLOWED_TRANSIT, REQUIRED_TRANSIT]

The type of service context.

source_prefixes_id string

The ID of the source prefixes.

tags string[]

A information field that can be added to identify the network policy rule. Maximum 10 unique tags of length 1024 each are allowed.

user_or_group UserGroup

The details of the user or group.

user_group_ids string[]

The user group IDs.

user_ids string[]

The user IDs.

Responses

200

Successful Operation

application/json

Schema

Schema

app_def_ids string[]

The app definition IDs that have applied network policy rules. The number of applications for a policy rule is limited to 256.

best_path_config ProbeMetricInfo

Information on the best path configuration values.

metric string

Possible values: [LATENCY, JITTER, PACKET_LOSS, INIT_FAILURE_PCT, DNS_TXN_FAILURE_PCT]

The metric values.

metric_type string

Possible values: [PROBE, LQM]

The metric type.

probe_config_id string

The probe configuration ID.

description

The description of the network policy rule. Max size = 256.

destination_prefixes_id string

The destination prefix ID.

enabled boolean

The network policy rule based on rules that are enabled.

id string

The network policy rule ID.

name stringrequired

The name of the network policy rule. Max size = 128.

network_context_id string

The network context applied to the network policy rule. Network context segments network traffic for the purpose of applying different network policy rules for the same application.

order_number integer

The network policy rule order number. The default order number for a policy rule is 1024.

paths_allowed PathsAllowedV2N1required
The paths allowed for the application.
active_paths WANPath[]
The configured active path for the rule.
Array [
label string
The label to identify the path.
path_type stringrequired
Possible values: [vpn, direct, servicelink]
The path type.
]
backup_paths WANPath[]
The configured backup path for the rule.
Array [
label string
The label to identify the path.
path_type stringrequired
Possible values: [vpn, direct, servicelink]
The path type.
]
l3_failure_paths WANPath[]
The configured l3 failure path for the rule.
Array [
label string
The label to identify the path.
path_type stringrequired
Possible values: [vpn, direct, servicelink]
The path type.
]
service_context ServiceContext

Information on the service context.

active_service_label_id stringrequired

The configured active service label ID.

active_service_label_type string

Possible values: [CG_TRANSIT, NON_CG_TRANSIT, SASE]

The configured active service label type.

backup_service_label_id string

The configured backup service label ID.

backup_service_label_type string

Possible values: [CG_TRANSIT, NON_CG_TRANSIT, SASE]

The configured backup service label type.

type stringrequired

Possible values: [ALLOWED_TRANSIT, REQUIRED_TRANSIT]

The type of service context.

source_prefixes_id string

The ID of the source prefixes.

tags string[]

A information field that can be added to identify the network policy rule. Maximum 10 unique tags of length 1024 each are allowed.

user_or_group UserGroup

The details of the user or group.

user_group_ids string[]

The user group IDs.

user_ids string[]

The user IDs.

Example (from schema)

{
  "app_def_ids": [
    "string"
  ],
  "best_path_config": {
    "metric": "LATENCY",
    "metric_type": "PROBE",
    "probe_config_id": "string"
  },
  "destination_prefixes_id": "string",
  "enabled": true,
  "id": "string",
  "name": "string",
  "network_context_id": "string",
  "order_number": 0,
  "paths_allowed": {
    "active_paths": [
      {
        "label": "string",
        "path_type": "vpn"
      }
    ],
    "backup_paths": [
      {
        "label": "string",
        "path_type": "vpn"
      }
    ],
    "l3_failure_paths": [
      {
        "label": "string",
        "path_type": "vpn"
      }
    ]
  },
  "service_context": {
    "active_service_label_id": "string",
    "active_service_label_type": "CG_TRANSIT",
    "backup_service_label_id": "string",
    "backup_service_label_type": "CG_TRANSIT",
    "type": "ALLOWED_TRANSIT"
  },
  "source_prefixes_id": "string",
  "tags": [
    "string"
  ],
  "user_or_group": {
    "user_group_ids": [
      "string"
    ],
    "user_ids": [
      "string"
    ]
  }
}

400

Bad Request

application/json

Schema

Schema

_error ErrorResponse[]
Array [
code string
The error code.
message string
The error message.
]

Example (from schema)

{
  "_error": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "value": {
    "_error": [
      {
        "code": "DUPLICATE_APP_DEF_IDS"
      },
      {
        "code": "APP_DEF_ID_LIST_SIZE_EXCEEDED"
      },
      {
        "code": "INVALID_NETWORK_CONTEXT_ID"
      },
      {
        "code": "INVALID_ORDER_NUMBER_MINIMUM_VAL"
      },
      {
        "code": "INVALID_ORDER_NUMBER_MAXIMUM_VAL"
      },
      {
        "code": "INVALID_SOURCE_PREFIXES_ID"
      },
      {
        "code": "INVALID_DESTINATION_PREFIXES_ID"
      },
      {
        "code": "PATHS_ALLOWED_REQUIRED"
      },
      {
        "code": "INVALID_JSON_EXTRA_ATTRIBUTE"
      },
      {
        "code": "NETWORKPOLICYSET_NOT_PRESENT"
      },
      {
        "code": "POLICYRULE_CREATION_NOT_ALLOWED"
      },
      {
        "code": "INVALID_POLICYSET_STATE"
      },
      {
        "code": "INVALID_DEFAULT_RULE_FLAG"
      },
      {
        "code": "POLICYRULE_CONFIG_DEFAULT_RULE_NAME"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_APPDEF_IDS"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_NETWORK_CONTEXT"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_SOURCE_PREFIX"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_DESTINATION_PREFIX"
      },
      {
        "code": "POLICYRULE_CONFIG_ACTIVE_BACKUP_SERVICELABELS_SAME"
      },
      {
        "code": "POLICYRULE_CONFIG_SERVICELABEL_DOES_NOT_EXIST"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_SERVICE_LABEL_ALLOWED_TRANSIT"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_SERVICE_LABEL_REQUIRED_TRANSIT"
      },
      {
        "code": "POLICYRULE_CONFIG_INVALID_CGTRANSIT_VPNPATH_MISSING"
      },
      {
        "code": "POLICYRULE_CONFIG_DUPLICATE_PATHS_SPECIFIED"
      },
      {
        "code": "POLICYRULE_CONFIG_ALREADY_EXISTS_FOR_THE_APPS"
      },
      {
        "code": "METRIC_PROBE_CONFIG_ID_REQUIRED_FOR_TYPE_PROBE"
      },
      {
        "code": "METRIC_PROBE_CONFIG_ID_INVALID"
      },
      {
        "code": "BACKUP_PATHS_NOT_ALLOWED_FOR_BEST_PATH_SELECTION"
      },
      {
        "code": "NETWORKPOLICY_RULE_CONFIG_INVALID_ACTIVE_PATHS"
      },
      {
        "code": "PROBE_CONFIG_APPLICABLE_ONLY_FOR_PROBE"
      },
      {
        "code": "INVALID_CONFIG_PROTOCOL_FOR_BEST_PATH_SELECTION"
      },
      {
        "code": "METRIC_PARAMETER_MISSING"
      },
      {
        "code": "METRIC_TYPE_MISSING"
      },
      {
        "code": "INVALID_METRIC_FOR_LQM_METRIC_TYPE"
      }
    ]
  }
}

Loading...