Edit Pinboard

Edit Pinboard

Edit pinboard. Only admin and member users can perform this action.

Request
URI
PUT
https://www.mgmt.cloud.vmware.com/ni/api/ni/pinboards/{id}
COPY
Path Parameters
string
id
Required

The Entity ID of object requestion information on

Request Body

Pinboard details to be updated

PinboardRequest of type(s) application/json
Required 
{
    "name": "Pinboard Name",
    "description": "This is a pinboard"
}
string
name
Optional

Name of the pinboard

string
description
Optional

Description of the pinboard

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns PinboardResponse of type(s) application/json 
{
    "id": "18799:10002:211561153588",
    "name": "Pinboard Name",
    "description": "This is the pinboard description",
    "create_timestamp": 156789876,
    "last_updated_timestamp": 156789876,
    "owner": "admin@local",
    "users_read_access": [
        "[email protected]",
        "[email protected]"
    ],
    "users_write_access": [
        "[email protected]",
        "[email protected]"
    ],
    "pins": [
        {
            "id": "1000:10001:78690089",
            "name": "Pin Name",
            "query": "Alert where Severity = 'Critical'"
        }
    ],
    "groups_write_access": [
        "CN=HR,CN=Users"
    ],
    "groups_read_access": [
        "cn=administrators"
    ]
}
string
id
Optional

Entity Identifier for a pinboard

string
name
Optional

Descriptor or identifier for particular pinboard.

string
description
Optional

Description of the pinboard

string
create_timestamp
Optional

Create timestamp for pinboard

string
last_updated_timestamp
Optional

Last update timestamp for pinboard

string
owner
Optional

User email of the pinboard owner

array of string
users_read_access
Optional

List of users with read privilege for the pinboard

array of string
users_write_access
Optional

List of users with read and write privilege for the pinboard

array of PinAssociation
pins
Optional

Pins associated with Pinboard

array of string
groups_write_access
Optional

LDAP/VIDM groups with read and write privilege of the pinboard

array of string
groups_read_access
Optional

LDAP/VIDM groups with read privilege of the pinboard


400

Bad Request

Returns ApiError of type(s) application/json 
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


401

Unauthorized

Returns ApiError of type(s) application/json 
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


403

Forbidden

Returns ApiError of type(s) application/json 
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


404

Not Found

Returns ApiError of type(s) application/json 
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


500

Internal Error

Returns ApiError of type(s) application/json 
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of ErrorDetail
details
Optional

details


On This Page
Pinboards Operations
POST
Create Pin
POST
Create Pinboard
DELETE
Delete Pin
DELETE
Delete Pinboard
POST
Duplicate Pinboard
PUT
Edit Pinboard
GET
Get All Pinboards
GET
Get Pinboard
PUT
Remove Share Pinboard
POST
Set Pinboard As Homepage
PUT
Share Pinboard
PUT
Update Pin