Captive-Portal-Policy - Flexible Secure Gateway API References (1.10.0)
Download OpenAPI specification:Download
Captive-Portal-Policy resource.
Get Captive-Portal-Policies
Get Captive-Portal-Policy resources.
Authorizations:
query Parameters
| id | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ The ID of the resource. |
| name | string ^[a-zA-Z]{1}[a-zA-Z0-9-\_\.]{0,30}$ A name of the resource. |
| cellGroupId | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ The Cell-Group ID which the resource belongs. |
| action | string Enum: "none" "captive-portal" The action of the policy. |
| _limit | integer >= 1 The maximum number of items to return. |
| _offset | integer >= 0 The number of items to skip before starting to return results. |
| _order_by | Array of strings Items Enum: "id" "name" "action" "cellGroupId" "tenantId" "createdAt" "updatedAt" Sort keys. |
header Parameters
| X-Auth-Token required | string The keystone token. |
Responses
OK
Bad Request
Unauthorized
Internal Server Error
Response samples
- 200
- 400
- 401
- 500
{- "captivePortalPolicies": [
- {
- "id": "2944a32f-3fb7-430e-9134-5eb611be23f6",
- "name": "test",
- "cellGroupId": "047ae2a5-c763-4bea-9171-e178d08951ca",
- "sourceAddresses": [
- "microsoft365WorldwideAnyIpv4"
], - "destinationAddresses": [
- "192.168.0.0/24",
- "192.168.1.0-192.168.1.100",
- "f027cbbc-fc0b-4b92-b76f-fa6cf8413a8e"
], - "tcpPorts": [
- "any"
], - "customUrlCategoryIds": [
- "d7e30854-c38e-4836-b17a-0e95d3d80997"
], - "urlCategoryNames": [
- "shopping",
- "microsoft365WorldwideAnyUrl"
], - "action": "none",
- "tenantId": "12345678abcdabcdabcd1234567890ab",
- "createdAt": "2020-08-27T10:04:04Z",
- "updatedAt": "2020-08-27T10:04:04Z"
}
]
}Create Captive-Portal-Policy
Create a Captive-Portal-Policy resource.
Authorizations:
header Parameters
| X-Auth-Token | string The keystone token. |
Request Body schema: application/json
| captivePortalPolicy required | object (CaptivePortalPolicyCreateRequest) Captive-Portal-Policy create request schema. Either customUrlCategoryIds or urlCategoryNames is required. |
Responses
OK
Bad Request
Unauthorized
Internal Server Error
Request samples
- Payload
{- "captivePortalPolicy": {
- "name": "test",
- "cellGroupId": "047ae2a5-c763-4bea-9171-e178d08951ca",
- "sourceAddresses": [
- "microsoft365WorldwideAnyIpv4"
], - "destinationAddresses": [
- "192.168.0.0/24",
- "192.168.1.0-192.168.1.100",
- "f027cbbc-fc0b-4b92-b76f-fa6cf8413a8e"
], - "tcpPorts": [
- "any"
], - "customUrlCategoryIds": [
- "d7e30854-c38e-4836-b17a-0e95d3d80997"
], - "urlCategoryNames": [
- "shopping",
- "microsoft365WorldwideAnyUrl"
], - "action": "none"
}
}Response samples
- 200
- 400
- 401
- 500
{- "captivePortalPolicy": {
- "id": "2944a32f-3fb7-430e-9134-5eb611be23f6",
- "name": "test",
- "cellGroupId": "047ae2a5-c763-4bea-9171-e178d08951ca",
- "sourceAddresses": [
- "any"
], - "destinationAddresses": [
- "192.168.0.0/24",
- "192.168.1.0-192.168.1.100",
- "f027cbbc-fc0b-4b92-b76f-fa6cf8413a8e"
], - "tcpPorts": [
- "any"
], - "customUrlCategoryIds": [
- "d7e30854-c38e-4836-b17a-0e95d3d80997"
], - "urlCategoryNames": [
- "shopping",
- "microsoft365WorldwideAnyUrl"
], - "action": "none",
- "tenantId": "12345678abcdabcdabcd1234567890ab",
- "operationId": "f2393b68-12b0-4ad6-8c3c-012f0a4136d7",
- "createdAt": "2020-08-27T10:04:04Z",
- "updatedAt": "2020-08-27T10:04:04Z"
}
}Get Captive-Portal-Policy Details
Get a Captive-Portal-Policy resource.
Authorizations:
path Parameters
| captive_portal_policy_id required | string The ID of the Captive-Portal-Policy resource. |
header Parameters
| X-Auth-Token | string The keystone token. |
Responses
OK
Bad Request
Unauthorized
Not Found
Internal Server Error
Response samples
- 200
- 400
- 401
- 404
- 500
{- "captivePortalPolicy": {
- "id": "2944a32f-3fb7-430e-9134-5eb611be23f6",
- "name": "test",
- "cellGroupId": "047ae2a5-c763-4bea-9171-e178d08951ca",
- "sourceAddresses": [
- "any"
], - "destinationAddresses": [
- "192.168.0.0/24",
- "192.168.1.0-192.168.1.100",
- "f027cbbc-fc0b-4b92-b76f-fa6cf8413a8e"
], - "tcpPorts": [
- "80",
- "443",
- "8080-8088"
], - "customUrlCategoryIds": [
- "d7e30854-c38e-4836-b17a-0e95d3d80997"
], - "urlCategoryNames": [
- "shopping",
- "microsoft365WorldwideAnyUrl"
], - "action": "none",
- "tenantId": "12345678abcdabcdabcd1234567890ab",
- "createdAt": "2020-08-27T10:04:04Z",
- "updatedAt": "2020-08-27T10:04:04Z"
}
}Update Captive-Portal-Policy
Update a Captive-Portal-Policy resource.
Authorizations:
path Parameters
| captive_portal_policy_id required | string The ID of the Captive-Portal-Policy resource. |
header Parameters
| X-Auth-Token | string The keystone token. |
Request Body schema: application/json
| captivePortalPolicy required | object (CaptivePortalPolicyUpdateRequest) Captive-Portal-Policy update request schema. |
Responses
OK
Bad Request
Unauthorized
Not Found
Internal Server Error
Request samples
- Payload
{- "captivePortalPolicy": {
- "name": "test_updated"
}
}Response samples
- 200
- 400
- 401
- 404
- 500
{- "captivePortalPolicy": {
- "id": "2944a32f-3fb7-430e-9134-5eb611be23f6",
- "name": "test_updated",
- "cellGroupId": "047ae2a5-c763-4bea-9171-e178d08951ca",
- "sourceAddresses": [
- "any"
], - "destinationAddresses": [
- "192.168.0.0/24",
- "192.168.1.0-192.168.1.100",
- "f027cbbc-fc0b-4b92-b76f-fa6cf8413a8e"
], - "tcpPorts": [
- "any"
], - "customUrlCategoryIds": [
- "d7e30854-c38e-4836-b17a-0e95d3d80997"
], - "urlCategoryNames": [
- "shopping",
- "microsoft365WorldwideAnyUrl"
], - "action": "none",
- "tenantId": "12345678abcdabcdabcd1234567890ab",
- "operationId": "f7e966a2-9460-4907-9710-776e95cd0724",
- "createdAt": "2020-08-27T10:04:04Z",
- "updatedAt": "2020-08-27T10:32:35Z"
}
}Delete Captive-Portal-Policy
Delete a Captive-Portal-Policy resource.
Authorizations:
path Parameters
| captive_portal_policy_id required | string The ID of the Captive-Portal-Policy resource. |
header Parameters
| X-Auth-Token | string The keystone token. |
Responses
OK
Bad Request
Unauthorized
Not Found
Internal Server Error
Response samples
- 400
- 401
- 404
- 500
{- "errorCode": 400,
- "errorMessage": "Invalid request",
- "moreInfo": "{{moreInfo}}"
}