PATCH /vsvip/{uuid}

PATCH /vsvip/{uuid}

/vsvip/{uuid}

Request
URI
PATCH
https://api_host/api/vsvip/{uuid}
COPY
Path Parameters
string
uuid
Required

UUID of the object to fetch

Query Parameters
string
name
Optional

object name

Header Parameters
string
X-Avi-Tenant
Optional

Avi Tenant Header

string
X-Avi-Tenant-UUID
Optional

Avi Tenant Header UUID

string
X-Avi-Version
Required

The caller is required to set Avi Version Header to the expected version of configuration. The response from the controller will provide and accept data according to the specified version. The controller will reject POST and PUT requests where the data is not compatible with the specified version.

string
X-CSRFToken
Optional

Avi Controller may send back CSRF token in the response cookies. The caller should update the request headers with this token else controller will reject requests.


Request Body
VsVip of type(s) application/json
Optional
{
    "_last_modified": "string",
    "bgp_local_preference": 0,
    "bgp_num_as_path_prepend": 0,
    "bgp_peer_labels": [
        "string"
    ],
    "cloud_ref": "string",
    "configpb_attributes": {
        "version": 0
    },
    "dns_info": [
        {
            "algorithm": "string",
            "cname": {
                "cname": "string"
            },
            "fqdn": "string",
            "metadata": "string",
            "num_records_in_response": 0,
            "ttl": 0,
            "type": "string"
        }
    ],
    "east_west_placement": false,
    "ipam_selector": {
        "labels": [
            {
                "key": "string",
                "value": "string"
            }
        ],
        "type": "string"
    },
    "markers": [
        {
            "key": "string",
            "values": [
                "string"
            ]
        }
    ],
    "name": "string",
    "tenant_ref": "string",
    "tier1_lr": "string",
    "url": "string",
    "use_standard_alb": false,
    "uuid": "string",
    "vip": [
        {
            "auto_allocate_floating_ip": false,
            "auto_allocate_ip": false,
            "auto_allocate_ip_type": "string",
            "availability_zone": "string",
            "avi_allocated_fip": false,
            "avi_allocated_vip": false,
            "discovered_networks": [
                {
                    "network_ref": "string",
                    "subnet": [
                        {
                            "ip_addr": {
                                "addr": "string",
                                "type": "string"
                            },
                            "mask": 0
                        }
                    ],
                    "subnet6": [
                        {
                            "ip_addr": {
                                "addr": "string",
                                "type": "string"
                            },
                            "mask": 0
                        }
                    ]
                }
            ],
            "enabled": false,
            "floating_ip": {
                "addr": "string",
                "type": "string"
            },
            "floating_ip6": {
                "addr": "string",
                "type": "string"
            },
            "floating_subnet6_uuid": "string",
            "floating_subnet_uuid": "string",
            "ip6_address": {
                "addr": "string",
                "type": "string"
            },
            "ip_address": {
                "addr": "string",
                "type": "string"
            },
            "ipam_network_subnet": {
                "network_ref": "string",
                "subnet": {
                    "ip_addr": {
                        "addr": "string",
                        "type": "string"
                    },
                    "mask": 0
                },
                "subnet6": {
                    "ip_addr": {
                        "addr": "string",
                        "type": "string"
                    },
                    "mask": 0
                },
                "subnet6_uuid": "string",
                "subnet_uuid": "string"
            },
            "network_ref": "string",
            "placement_networks": [
                {
                    "network_ref": "string",
                    "subnet": {
                        "ip_addr": {
                            "addr": "string",
                            "type": "string"
                        },
                        "mask": 0
                    },
                    "subnet6": {
                        "ip_addr": {
                            "addr": "string",
                            "type": "string"
                        },
                        "mask": 0
                    }
                }
            ],
            "port_uuid": "string",
            "prefix_length": 0,
            "subnet": {
                "ip_addr": {
                    "addr": "string",
                    "type": "string"
                },
                "mask": 0
            },
            "subnet6": {
                "ip_addr": {
                    "addr": "string",
                    "type": "string"
                },
                "mask": 0
            },
            "subnet6_uuid": "string",
            "subnet_uuid": "string",
            "vip_id": "string"
        }
    ],
    "vrf_context_ref": "string",
    "vsvip_cloud_config_cksum": "string"
}
string
_last_modified
Optional

UNIX time since epoch in microseconds. Units(MICROSECONDS).

integer As uint32 As uint32
bgp_local_preference
Optional

LOCAL_PREF to be used for VsVip advertised. Applicable only over iBGP. Field introduced in 30.2.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

integer As uint32 As uint32
bgp_num_as_path_prepend
Optional

Number of times the local AS should be prepended additionally to VsVip. Applicable only over eBGP. Allowed values are 1-10. Field introduced in 30.2.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

array of string
bgp_peer_labels
Optional

Select BGP peers, using peer label, for VsVip advertisement. Field introduced in 20.1.5. Maximum of 128 items allowed. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

string
cloud_ref
Optional

It is a reference to an object of type Cloud. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

configpb_attributes
Optional

configpb_attributes

array of DnsInfo
dns_info
Optional

Service discovery specific data including fully qualified domain name, type and Time-To-Live of the DNS record. This takes effect only if dns profile isassociated with cloud. Field introduced in 17.1.1. Maximum of 1000 items allowed. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

boolean
east_west_placement
Optional

Force placement on all Service Engines in the Service Engine Group (Container clouds only). Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials edition(Allowed values- false), Basic edition(Allowed values- false), Enterprise with Cloud Services edition.

ipam_selector
Optional

ipam_selector

markers
Optional

List of labels to be used for granular RBAC. Field introduced in 20.1.5. Allowed in Enterprise edition with any value, Essentials edition with any value, Basic edition with any value, Enterprise with Cloud Services edition.

string
name
Required

Name for the VsVip object. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
tenant_ref
Optional

It is a reference to an object of type Tenant. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
tier1_lr
Optional

This sets the placement scope of virtualservice to given tier1 logical router in Nsx-t. Field introduced in 20.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
url
Optional

url

boolean
use_standard_alb
Optional

This overrides the cloud level default and needs to match the SE Group value in which it will be used if the SE Group use_standard_alb value is set. This is only used when FIP is used for VS on Azure Cloud. Field introduced in 18.2.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

string
uuid
Optional

UUID of the VsVip object. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

array of Vip
vip
Optional

List of Virtual Service IPs and other shareable entities. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
vrf_context_ref
Optional

Virtual Routing Context that the Virtual Service is bound to. This is used to provide the isolation of the set of networks the application is attached to. It is a reference to an object of type VrfContext. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
vsvip_cloud_config_cksum
Optional

Checksum of cloud configuration for VsVip. Internally set by cloud connector. Field introduced in 17.2.9, 18.1.2. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

Responses
200

OK

Returns VsVip of type(s) application/json
{
    "_last_modified": "string",
    "bgp_local_preference": 0,
    "bgp_num_as_path_prepend": 0,
    "bgp_peer_labels": [
        "string"
    ],
    "cloud_ref": "string",
    "configpb_attributes": {
        "version": 0
    },
    "dns_info": [
        {
            "algorithm": "string",
            "cname": {
                "cname": "string"
            },
            "fqdn": "string",
            "metadata": "string",
            "num_records_in_response": 0,
            "ttl": 0,
            "type": "string"
        }
    ],
    "east_west_placement": false,
    "ipam_selector": {
        "labels": [
            {
                "key": "string",
                "value": "string"
            }
        ],
        "type": "string"
    },
    "markers": [
        {
            "key": "string",
            "values": [
                "string"
            ]
        }
    ],
    "name": "string",
    "tenant_ref": "string",
    "tier1_lr": "string",
    "url": "string",
    "use_standard_alb": false,
    "uuid": "string",
    "vip": [
        {
            "auto_allocate_floating_ip": false,
            "auto_allocate_ip": false,
            "auto_allocate_ip_type": "string",
            "availability_zone": "string",
            "avi_allocated_fip": false,
            "avi_allocated_vip": false,
            "discovered_networks": [
                {
                    "network_ref": "string",
                    "subnet": [
                        {
                            "ip_addr": {
                                "addr": "string",
                                "type": "string"
                            },
                            "mask": 0
                        }
                    ],
                    "subnet6": [
                        {
                            "ip_addr": {
                                "addr": "string",
                                "type": "string"
                            },
                            "mask": 0
                        }
                    ]
                }
            ],
            "enabled": false,
            "floating_ip": {
                "addr": "string",
                "type": "string"
            },
            "floating_ip6": {
                "addr": "string",
                "type": "string"
            },
            "floating_subnet6_uuid": "string",
            "floating_subnet_uuid": "string",
            "ip6_address": {
                "addr": "string",
                "type": "string"
            },
            "ip_address": {
                "addr": "string",
                "type": "string"
            },
            "ipam_network_subnet": {
                "network_ref": "string",
                "subnet": {
                    "ip_addr": {
                        "addr": "string",
                        "type": "string"
                    },
                    "mask": 0
                },
                "subnet6": {
                    "ip_addr": {
                        "addr": "string",
                        "type": "string"
                    },
                    "mask": 0
                },
                "subnet6_uuid": "string",
                "subnet_uuid": "string"
            },
            "network_ref": "string",
            "placement_networks": [
                {
                    "network_ref": "string",
                    "subnet": {
                        "ip_addr": {
                            "addr": "string",
                            "type": "string"
                        },
                        "mask": 0
                    },
                    "subnet6": {
                        "ip_addr": {
                            "addr": "string",
                            "type": "string"
                        },
                        "mask": 0
                    }
                }
            ],
            "port_uuid": "string",
            "prefix_length": 0,
            "subnet": {
                "ip_addr": {
                    "addr": "string",
                    "type": "string"
                },
                "mask": 0
            },
            "subnet6": {
                "ip_addr": {
                    "addr": "string",
                    "type": "string"
                },
                "mask": 0
            },
            "subnet6_uuid": "string",
            "subnet_uuid": "string",
            "vip_id": "string"
        }
    ],
    "vrf_context_ref": "string",
    "vsvip_cloud_config_cksum": "string"
}
string
_last_modified
Optional

UNIX time since epoch in microseconds. Units(MICROSECONDS).

integer As uint32 As uint32
bgp_local_preference
Optional

LOCAL_PREF to be used for VsVip advertised. Applicable only over iBGP. Field introduced in 30.2.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

integer As uint32 As uint32
bgp_num_as_path_prepend
Optional

Number of times the local AS should be prepended additionally to VsVip. Applicable only over eBGP. Allowed values are 1-10. Field introduced in 30.2.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

array of string
bgp_peer_labels
Optional

Select BGP peers, using peer label, for VsVip advertisement. Field introduced in 20.1.5. Maximum of 128 items allowed. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

string
cloud_ref
Optional

It is a reference to an object of type Cloud. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

configpb_attributes
Optional

configpb_attributes

array of DnsInfo
dns_info
Optional

Service discovery specific data including fully qualified domain name, type and Time-To-Live of the DNS record. This takes effect only if dns profile isassociated with cloud. Field introduced in 17.1.1. Maximum of 1000 items allowed. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

boolean
east_west_placement
Optional

Force placement on all Service Engines in the Service Engine Group (Container clouds only). Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials edition(Allowed values- false), Basic edition(Allowed values- false), Enterprise with Cloud Services edition.

ipam_selector
Optional

ipam_selector

markers
Optional

List of labels to be used for granular RBAC. Field introduced in 20.1.5. Allowed in Enterprise edition with any value, Essentials edition with any value, Basic edition with any value, Enterprise with Cloud Services edition.

string
name
Required

Name for the VsVip object. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
tenant_ref
Optional

It is a reference to an object of type Tenant. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
tier1_lr
Optional

This sets the placement scope of virtualservice to given tier1 logical router in Nsx-t. Field introduced in 20.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
url
Optional

url

boolean
use_standard_alb
Optional

This overrides the cloud level default and needs to match the SE Group value in which it will be used if the SE Group use_standard_alb value is set. This is only used when FIP is used for VS on Azure Cloud. Field introduced in 18.2.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.

string
uuid
Optional

UUID of the VsVip object. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

array of Vip
vip
Optional

List of Virtual Service IPs and other shareable entities. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
vrf_context_ref
Optional

Virtual Routing Context that the Virtual Service is bound to. This is used to provide the isolation of the set of networks the application is attached to. It is a reference to an object of type VrfContext. Field introduced in 17.1.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
vsvip_cloud_config_cksum
Optional

Checksum of cloud configuration for VsVip. Internally set by cloud connector. Field introduced in 17.2.9, 18.1.2. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.


401

log in failed

Operation doesn't return any data structure