F5 Distributed Cloud Services API for ves.io.schema.views.bigip_virtual_server
Download OpenAPI specification:Download
BIG-IP virtual server view repesents the internal virtual host corresponding to the virtual-servers discovered from BIG-IPs It exposes parameters to enable API discovery and other WAAP security features on the virtual server.
View will create following child objects.
- Virtual-host
- API-inventory
- App-type
- App-setting
Replace BIG-IP virtual server
Shape of the BIG-IP virtual server specification
path Parameters
metadata.namespace required | string namespace x-example: "staging" This defines the workspace within which each the configuration object is to be created. Must be a DNS_LABEL format. For a namespace object itself, namespace value will be "" |
metadata.name required | string name x-example: "acmecorp-web" The configuration object to be replaced will be looked up by name |
Request Body schema: application/jsonrequired
object (ObjectReplaceMetaType) ObjectReplaceMetaType is metadata that can be specified in Replace request of an object. | |
object (ReplaceSpecType) Shape of the BIG-IP virtual server specification |
Responses
Request samples
- Payload
{- "metadata": {
- "annotations": { },
- "description": "string",
- "disable": true,
- "labels": { },
- "name": "string",
- "namespace": "string"
}, - "spec": {
- "api_specification": {
- "api_definition": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "validation_all_spec_endpoints": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": { },
- "action_report": { },
- "action_skip": { },
- "api_endpoint": {
- "methods": [
- null
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}
}
]
}
}, - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}, - "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}
}
}, - "validation_custom_list": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": { },
- "action_report": { },
- "action_skip": { },
- "api_endpoint": {
- "methods": [
- null
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}
}
]
}
}, - "open_api_validation_rules": [
- {
- "any_domain": { },
- "api_endpoint": {
- "methods": [
- "ANY"
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}, - "specific_domain": "string",
- "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}
}
}
], - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}
}, - "validation_disabled": { }
}, - "default_sensitive_data_policy": { },
- "disable_api_definition": { },
- "disable_api_discovery": { },
- "enable_api_discovery": {
- "api_crawler": {
- "api_crawler_config": {
- "domains": [
- {
- "domain": "string",
- "simple_login": {
- "password": {
- "blindfold_secret_info": {
- "decryption_provider": null,
- "location": null,
- "store_provider": null
}, - "clear_secret_info": {
- "provider": null,
- "url": null
}
}, - "user": "string"
}
}
]
}, - "disable_api_crawler": { }
}, - "api_discovery_from_code_scan": {
- "code_base_integrations": [
- {
- "all_repos": { },
- "code_base_integration": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "selected_repos": {
- "api_code_repo": [
- "string"
]
}
}
]
}, - "custom_api_auth_discovery": {
- "api_discovery_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}, - "default_api_auth_discovery": { },
- "disable_learn_from_redirect_traffic": { },
- "discovered_api_settings": {
- "purge_duration_for_inactive_discovered_apis": 0
}, - "enable_learn_from_redirect_traffic": { }
}, - "sensitive_data_policy": {
- "sensitive_data_policy_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}
}
}
Response samples
- 200
- 401
- 403
- 404
- 409
- 429
- 500
- 503
- 504
{ }
List BIG-IP virtual server
List the set of bigip_virtual_server in a namespace
path Parameters
namespace required | string namespace x-example: "ns1" Namespace to scope the listing of bigip_virtual_server |
query Parameters
label_filter | string x-example: "env in (staging, testing), tier in (web, db)" A LabelSelectorType expression that every item in list response will satisfy |
report_fields | Array of strings x-example: "" Extra fields to return along with summary fields |
report_status_fields | Array of strings x-example: "" Extra status fields to return along with summary fields |
Responses
Response samples
- 200
- 401
- 403
- 404
- 409
- 429
- 500
- 503
- 504
{- "errors": [
- {
- "code": "EOK",
- "error_obj": {
- "type_url": "string",
- "value": "string"
}, - "message": "string"
}
], - "items": [
- {
- "annotations": { },
- "description": "string",
- "disabled": true,
- "get_spec": {
- "api_specification": {
- "api_definition": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "validation_all_spec_endpoints": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": null,
- "action_report": null,
- "action_skip": null,
- "api_endpoint": null,
- "api_group": null,
- "base_path": null,
- "metadata": null
}
]
}
}, - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}, - "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}
}
}, - "validation_custom_list": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": null,
- "action_report": null,
- "action_skip": null,
- "api_endpoint": null,
- "api_group": null,
- "base_path": null,
- "metadata": null
}
]
}
}, - "open_api_validation_rules": [
- {
- "any_domain": { },
- "api_endpoint": {
- "methods": [
- null
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}, - "specific_domain": "string",
- "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": null,
- "enforcement_report": null,
- "response_validation_properties": [ ]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": null,
- "enforcement_report": null,
- "request_validation_properties": [ ]
}
}
}
], - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}
}, - "validation_disabled": { }
}, - "bigip_version": "string",
- "default_sensitive_data_policy": { },
- "disable_api_definition": { },
- "disable_api_discovery": { },
- "enable_api_discovery": {
- "api_crawler": {
- "api_crawler_config": {
- "domains": [
- {
- "domain": "string",
- "simple_login": {
- "password": null,
- "user": null
}
}
]
}, - "disable_api_crawler": { }
}, - "api_discovery_from_code_scan": {
- "code_base_integrations": [
- {
- "all_repos": { },
- "code_base_integration": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "selected_repos": {
- "api_code_repo": [
- null
]
}
}
]
}, - "custom_api_auth_discovery": {
- "api_discovery_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}, - "default_api_auth_discovery": { },
- "disable_learn_from_redirect_traffic": { },
- "discovered_api_settings": {
- "purge_duration_for_inactive_discovered_apis": 0
}, - "enable_learn_from_redirect_traffic": { }
}, - "sensitive_data_policy": {
- "sensitive_data_policy_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}, - "service_discovery": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "type": "INVALID_VIRTUAL_SERVER"
}, - "labels": { },
- "metadata": {
- "annotations": { },
- "description": "string",
- "disable": true,
- "labels": { },
- "name": "string",
- "namespace": "string"
}, - "name": "string",
- "namespace": "string",
- "owner_view": {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "uid": "string"
}, - "status_set": [
- {
- "conditions": [
- {
- "hostname": "string",
- "last_update_time": "2019-08-24T14:15:22Z",
- "reason": "string",
- "service_name": "string",
- "status": "string",
- "type": "string"
}
], - "metadata": {
- "creation_timestamp": "2019-08-24T14:15:22Z",
- "creator_class": "string",
- "creator_id": "string",
- "publish": "STATUS_DO_NOT_PUBLISH",
- "status_id": "string",
- "uid": "string",
- "vtrp_id": "string",
- "vtrp_stale": true
}, - "object_refs": [
- {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "tenant": "string",
- "uid": "string"
}
]
}
], - "system_metadata": {
- "creation_timestamp": "2019-08-24T14:15:22Z",
- "creator_class": "string",
- "creator_id": "string",
- "deletion_timestamp": "2019-08-24T14:15:22Z",
- "finalizers": [
- "string"
], - "initializers": {
- "pending": [
- {
- "name": "string"
}
], - "result": {
- "code": 0,
- "reason": "string",
- "status": "string"
}
}, - "labels": { },
- "modification_timestamp": "2019-08-24T14:15:22Z",
- "object_index": 0,
- "owner_view": {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "uid": "string"
}, - "tenant": "string",
- "uid": "string"
}, - "tenant": "string",
- "uid": "string"
}
]
}
Get BIG-IP virtual server
Shape of the BIG-IP virtual server specification
path Parameters
namespace required | string namespace x-example: "ns1" The namespace in which the configuration object is present |
name required | string name x-example: "name" The name of the configuration object to be fetched |
query Parameters
response_format | string Default: "GET_RSP_FORMAT_DEFAULT" Enum: "GET_RSP_FORMAT_DEFAULT" "GET_RSP_FORMAT_FOR_REPLACE" "GET_RSP_FORMAT_STATUS" "GET_RSP_FORMAT_READ" "GET_RSP_FORMAT_REFERRING_OBJECTS" "GET_RSP_FORMAT_BROKEN_REFERENCES" The format in which the configuration object is to be fetched. This could be for example - in GetSpec form for the contents of object - in CreateRequest form to create a new similar object - to ReplaceRequest form to replace changeable values Default format of returned resource Response should be in ReplaceRequest format Response should be in StatusObject(s) format Response should be in format of GetSpecType Response should have other objects referring to this object Response should have deleted and disabled objects referrred by this object |
Responses
Response samples
- 200
- 401
- 403
- 404
- 409
- 429
- 500
- 503
- 504
{- "deleted_referred_objects": [
- {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "tenant": "string",
- "uid": "string"
}
], - "disabled_referred_objects": [
- {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "tenant": "string",
- "uid": "string"
}
], - "metadata": {
- "annotations": { },
- "description": "string",
- "disable": true,
- "labels": { },
- "name": "string",
- "namespace": "string"
}, - "referring_objects": [
- {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "tenant": "string",
- "uid": "string"
}
], - "replace_form": {
- "metadata": {
- "annotations": { },
- "description": "string",
- "disable": true,
- "labels": { },
- "name": "string",
- "namespace": "string"
}, - "spec": {
- "api_specification": {
- "api_definition": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "validation_all_spec_endpoints": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": { },
- "action_report": { },
- "action_skip": { },
- "api_endpoint": {
- "methods": [ ],
- "path": null
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": null,
- "name": null
}
}
]
}
}, - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}, - "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}
}
}, - "validation_custom_list": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": { },
- "action_report": { },
- "action_skip": { },
- "api_endpoint": {
- "methods": [ ],
- "path": null
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": null,
- "name": null
}
}
]
}
}, - "open_api_validation_rules": [
- {
- "any_domain": { },
- "api_endpoint": {
- "methods": [
- "ANY"
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}, - "specific_domain": "string",
- "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- null
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- null
]
}
}
}
], - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}
}, - "validation_disabled": { }
}, - "default_sensitive_data_policy": { },
- "disable_api_definition": { },
- "disable_api_discovery": { },
- "enable_api_discovery": {
- "api_crawler": {
- "api_crawler_config": {
- "domains": [
- {
- "domain": "string",
- "simple_login": {
- "password": {
- "blindfold_secret_info": null,
- "clear_secret_info": null
}, - "user": "string"
}
}
]
}, - "disable_api_crawler": { }
}, - "api_discovery_from_code_scan": {
- "code_base_integrations": [
- {
- "all_repos": { },
- "code_base_integration": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "selected_repos": {
- "api_code_repo": [
- "string"
]
}
}
]
}, - "custom_api_auth_discovery": {
- "api_discovery_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}, - "default_api_auth_discovery": { },
- "disable_learn_from_redirect_traffic": { },
- "discovered_api_settings": {
- "purge_duration_for_inactive_discovered_apis": 0
}, - "enable_learn_from_redirect_traffic": { }
}, - "sensitive_data_policy": {
- "sensitive_data_policy_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}
}
}, - "spec": {
- "api_specification": {
- "api_definition": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "validation_all_spec_endpoints": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": { },
- "action_report": { },
- "action_skip": { },
- "api_endpoint": {
- "methods": [
- null
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}
}
]
}
}, - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}, - "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}
}
}, - "validation_custom_list": {
- "fall_through_mode": {
- "fall_through_mode_allow": { },
- "fall_through_mode_custom": {
- "open_api_validation_rules": [
- {
- "action_block": { },
- "action_report": { },
- "action_skip": { },
- "api_endpoint": {
- "methods": [
- null
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}
}
]
}
}, - "open_api_validation_rules": [
- {
- "any_domain": { },
- "api_endpoint": {
- "methods": [
- "ANY"
], - "path": "string"
}, - "api_group": "string",
- "base_path": "string",
- "metadata": {
- "description": "string",
- "name": "string"
}, - "specific_domain": "string",
- "validation_mode": {
- "response_validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "response_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}, - "skip_response_validation": { },
- "skip_validation": { },
- "validation_mode_active": {
- "enforcement_block": { },
- "enforcement_report": { },
- "request_validation_properties": [
- "PROPERTY_QUERY_PARAMETERS"
]
}
}
}
], - "settings": {
- "oversized_body_fail_validation": { },
- "oversized_body_skip_validation": { },
- "property_validation_settings_custom": {
- "queryParameters": {
- "allow_additional_parameters": { },
- "disallow_additional_parameters": { }
}
}, - "property_validation_settings_default": { }
}
}, - "validation_disabled": { }
}, - "bigip_version": "string",
- "default_sensitive_data_policy": { },
- "disable_api_definition": { },
- "disable_api_discovery": { },
- "enable_api_discovery": {
- "api_crawler": {
- "api_crawler_config": {
- "domains": [
- {
- "domain": "string",
- "simple_login": {
- "password": {
- "blindfold_secret_info": {
- "decryption_provider": null,
- "location": null,
- "store_provider": null
}, - "clear_secret_info": {
- "provider": null,
- "url": null
}
}, - "user": "string"
}
}
]
}, - "disable_api_crawler": { }
}, - "api_discovery_from_code_scan": {
- "code_base_integrations": [
- {
- "all_repos": { },
- "code_base_integration": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "selected_repos": {
- "api_code_repo": [
- "string"
]
}
}
]
}, - "custom_api_auth_discovery": {
- "api_discovery_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}, - "default_api_auth_discovery": { },
- "disable_learn_from_redirect_traffic": { },
- "discovered_api_settings": {
- "purge_duration_for_inactive_discovered_apis": 0
}, - "enable_learn_from_redirect_traffic": { }
}, - "sensitive_data_policy": {
- "sensitive_data_policy_ref": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}
}, - "service_discovery": {
- "name": "string",
- "namespace": "string",
- "tenant": "string"
}, - "type": "INVALID_VIRTUAL_SERVER"
}, - "status": [
- {
- "conditions": [
- {
- "hostname": "string",
- "last_update_time": "2019-08-24T14:15:22Z",
- "reason": "string",
- "service_name": "string",
- "status": "string",
- "type": "string"
}
], - "metadata": {
- "creation_timestamp": "2019-08-24T14:15:22Z",
- "creator_class": "string",
- "creator_id": "string",
- "publish": "STATUS_DO_NOT_PUBLISH",
- "status_id": "string",
- "uid": "string",
- "vtrp_id": "string",
- "vtrp_stale": true
}, - "object_refs": [
- {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "tenant": "string",
- "uid": "string"
}
]
}
], - "system_metadata": {
- "creation_timestamp": "2019-08-24T14:15:22Z",
- "creator_class": "string",
- "creator_id": "string",
- "deletion_timestamp": "2019-08-24T14:15:22Z",
- "finalizers": [
- "string"
], - "initializers": {
- "pending": [
- {
- "name": "string"
}
], - "result": {
- "code": 0,
- "reason": "string",
- "status": "string"
}
}, - "labels": { },
- "modification_timestamp": "2019-08-24T14:15:22Z",
- "object_index": 0,
- "owner_view": {
- "kind": "string",
- "name": "string",
- "namespace": "string",
- "uid": "string"
}, - "tenant": "string",
- "uid": "string"
}
}