Update Publicips

Update Publicips

Attach or detach a public IP to workload VM for a SDDC

Request
URI
PATCH
https://vmc.vmware.com/vmc/api/orgs/{org}/sddcs/{sddc}/publicips/{id}
COPY
Path Parameters
string
org
Required

Organization identifier.

string
sddc
Required

Sddc Identifier.

string
id
Required

ip allocation id

Query Parameters
string
action
Required

Type of action as 'attach', 'detach', 'reattach', or 'rename'. For 'attch', the public IP must not be attached and 'associated_private_ip' in the payload needs to be set with a workload VM private IP. For 'detach', the public IP must be attached and 'associated_private_ip' in the payload should not be set with any value. For 'reattach', the public IP must be attached and 'associated_private_ip' in the payload needs to be set with a new workload VM private IP. For 'rename', the 'name' in the payload needs to have a new name string.

Request Body

SddcPublicIp object to update

SddcPublicIp of type(s) application/json
Required

Show optional properties

{
    "public_ip": "string"
}
{
    "public_ip": "string",
    "name": "string",
    "allocation_id": "string",
    "dnat_rule_id": "string",
    "associated_private_ip": "string",
    "snat_rule_id": "string"
}
string
public_ip
Required

public_ip

string
name
Optional

name

string
allocation_id
Optional

allocation_id

string
dnat_rule_id
Optional

dnat_rule_id

string
associated_private_ip
Optional

associated_private_ip

string
snat_rule_id
Optional

snat_rule_id

Authentication
This operation uses the following authentication methods.
Responses
202

Accepted

Returns Task of type(s) application/json
This response body class contains all of the following: AbstractEntity 
{
    "updated": "string",
    "user_id": "string",
    "updated_by_user_id": "string",
    "created": "string",
    "version": 5,
    "updated_by_user_name": "string",
    "user_name": "string",
    "id": "1d1c83ee-e0b7-4de9-b660-9a9ca1d22f32",
    "status": "string",
    "localized_error_message": "string",
    "resource_id": "string",
    "parent_task_id": "string",
    "task_version": "string",
    "correlation_id": "string",
    "start_resource_entity_version": 0,
    "sub_status": "string",
    "task_type": "string",
    "start_time": "string",
    "task_progress_phases": [
        {
            "id": "string",
            "name": "string",
            "progress_percent": 0
        }
    ],
    "error_message": "string",
    "org_id": "1d1c83ee-e0b7-4de9-b660-9a9ca1d22f32",
    "end_resource_entity_version": 5,
    "service_errors": [
        {
            "default_message": "string",
            "original_service": "string",
            "localized_message": "string",
            "original_service_error_code": "string"
        }
    ],
    "org_type": "string",
    "estimated_remaining_minutes": 4,
    "params": {},
    "progress_percent": 75,
    "phase_in_progress": "string",
    "resource_type": "string",
    "end_time": "string"
}

400

The sddc is not in a state that's valid for updates

Returns ErrorResponse of type(s) application/json 
{
    "status": 0,
    "path": "string",
    "retryable": false,
    "error_code": "string",
    "error_messages": [
        "string"
    ]
}
integer
status
Required

HTTP status code

string
path
Required

Originating request URI

boolean
retryable
Required

If true, client should retry operation

string
error_code
Required

unique error code

array of string
error_messages
Required

localized error messages


401

Unauthorized

Operation doesn't return any data structure

403

Access not allowed to the operation for the current user

Returns ErrorResponse of type(s) application/json 
{
    "status": 0,
    "path": "string",
    "retryable": false,
    "error_code": "string",
    "error_messages": [
        "string"
    ]
}
integer
status
Required

HTTP status code

string
path
Required

Originating request URI

boolean
retryable
Required

If true, client should retry operation

string
error_code
Required

unique error code

array of string
error_messages
Required

localized error messages


404

Cannot find the public IP with given IP address

Returns ErrorResponse of type(s) application/json 
{
    "status": 0,
    "path": "string",
    "retryable": false,
    "error_code": "string",
    "error_messages": [
        "string"
    ]
}
integer
status
Required

HTTP status code

string
path
Required

Originating request URI

boolean
retryable
Required

If true, client should retry operation

string
error_code
Required

unique error code

array of string
error_messages
Required

localized error messages


On This Page
Sddc Operations
POST
Create Publicips
DELETE
Delete Publicips
GET
Get Publicips
GET
List Publicips
PATCH
Update Publicips