REST API - get

vapi metadata privilege service operation: get

Retrieves the privilege information about an operation element corresponding to operation_id contained in the service element corresponding to service_id.

Request:

HTTP request

POST https://{server}/rest/com/vmware/vapi/metadata/privilege/service/operation/id:{service_id}?~action=get

Path Parameters

Name Type Description
Required
service_id string Identifier of the service element.

Request Body Structure:

{
    "operation_id""obj-103"
}

Request Body Parameters:

Name Type Description
bold = required
operation_id string Identifier of the operation element.

Response:

HTTP Status Code: 200

Representation:

{
    "value"{
        "privileges"[
            "string",
            "string"
        ],
        "privilege_info"[
            {
                "privileges"[
                    "string",
                    "string"
                ],
                "property_path""string"
            },
            {
                "privileges"[
                    "string",
                    "string"
                ],
                "property_path""string"
            }
        ]
    }
}

Response Type:

Name Type Description
bold = required
value operation_info The vapi.metadata.privilege.operation_info instance that corresponds to operation_id.
value.privileges string[] List of all privileges assigned to the operation element.

value.privilege_info privilege_info[] Privilege information of all the parameter elements of the operation element. For an explanation of containment of privilege information within parameter elements, see vapi.metadata.privilege.privilege_info.

value.privilege_info[].property_path string The property_path points to an entity that is used in the operation element. An entity can either be present in one of the parameter elements or if a parameter is a structure element, it could also be present in one of the field elements.

If the privilege is assigned to an entity used in the parameter, property_path will just contain the name of the parameter field. If the privilege is assigned to an entity in one of the field elements of a parameter element that is a structure element, then property_path will contain a path to the field element starting from the parameter name.

value.privilege_info[].privileges string[] List of privileges assigned to the entity that is being referred by vapi.metadata.privilege.privilege_info.property_path.

Errors:

HTTP Status Code Type Description
404 not_found if the service element associated with service_id does not exist.