Delete ports from a group manually - Crosswork Network Controller 7.2 APIs

{"type":"api","title":"Delete ports from a group manually","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-2/76fd4bb9d069fd2530d7a02f0b3a4ca00eccfd35/7c48c18b-6630-3205-a601-ed557f355784","info":{"title":"APIs exposed by Grouping service","description":"Crosswork Grouping APIs allow the user to perform CRUD operations on grouping service.","contact":{"name":"Crosswork Team, Cisco","email":"support@cisco.com"},"license":{"name":"Cisco Software License Agreement","url":"http://www.cisco.com/public/sw-license-agreement.html"},"version":"7.2.0"},"x-parser-conf":{"overview":{"markdownPath":"reference/INFRA/GROUPING/grouping-service-overview.md"}},"openapi":"3.1.0","servers":[{"url":"http://localhost:8080/v1/grouping","description":"Generated server url"}]},"spec":{"tags":["Ports"],"summary":"Delete ports from a group manually","operationId":"manualDeletePorts","parameters":[{"name":"groupUuid","in":"path","description":"UUID of the group from which ports will be manually deleted.","required":true,"schema":{"type":"string"}},{"name":"selectAll","in":"query","description":"Flag to indicate if all ports should be selected for deletion. Default is false.","required":false,"schema":{"type":"boolean","default":false}}],"requestBody":{"description":"Details of the ports to be deleted.","content":{"application/json":{"schema":{"description":"Data Transfer Object for adding or deleting ports, containing a collection of PortDTO objects.","properties":{"ports":{"type":"array","description":"Collection of PortDTO objects representing the ports to be added or deleted, with a maximum size of 10,000.","items":{"description":"Data Transfer Object representing a port, including its attributes such as UUIDs, name, type, and more.","properties":{"portUuid":{"type":"string","description":"Unique identifier for the port."},"deviceUuid":{"type":"string","description":"UUID of the device to which the port belongs."},"node_ip":{"type":"string","description":"IP address of the node associated with the port."},"hostName":{"type":"string","description":"Host name associated with the port."},"portName":{"type":"string","description":"Name of the port."},"description":{"type":"string","description":"Description of the port."},"speed":{"type":"string","description":"Speed of the port."},"type":{"type":"string","description":"Type of the port, indicating its function or role."},"delete":{"type":"boolean","description":"Flag indicating whether the port is marked for deletion."},"discoveryType":{"type":"string","description":"Type of discovery mechanism used for the port."}},"$$ref":"#/components/schemas/PortDTO"},"maxItems":10000,"minItems":0}},"$$ref":"#/components/schemas/AddDeletePortDTO"},"examples":{"Delete Ports Request Example":{"summary":"Example of a delete ports request","description":"Delete Ports Request Example","value":{"ports":[{"portUuid":"portUuid1"},{"portUuid":"portUuid2"}]}}}}},"required":true},"responses":{"200":{"description":"Successfully deleted the ports.","content":{"application/json":{"schema":{"description":"Data Transfer Object representing the result of an operation, including status, related entities, and error details.","properties":{"status":{"type":"string","default":"Success","description":"Status of the operation result, indicating success, partial success, or error.","enum":["Success","Partial","Error"]},"group":{"description":"Data Transfer Object representing a group, including its properties and relationships.","properties":{"uuid":{"type":"string","description":"Unique identifier for the group, if available.","maxLength":255,"minLength":0},"name":{"type":"string","description":"Name of the group.","maxLength":255,"minLength":0},"description":{"type":"string","description":"Description of the group.","maxLength":255,"minLength":0},"discoveryType":{"type":"string","description":"Type of discovery used for the group, if applicable.","enum":["Static","Dynamic","StaticSystem","Unknown"]},"nodeType":{"type":"string","description":"Node type of the group, if applicable.","enum":["Group","Member"]},"classifier":{"type":"string","description":"Classifier associated with the group.","maxLength":255,"minLength":0},"referenceUuid":{"type":"string","description":"Reference UUID linked to the group, if applicable.","maxLength":255,"minLength":0},"children":{"type":"array","description":"List of child groups under this group.","items":{"$ref":"#/components/schemas/GroupDTO","$$ref":"#/components/schemas/GroupDTO"},"maxItems":100000,"minItems":0},"parentUuid":{"type":"string","description":"UUID of the parent group, if applicable."},"parentName":{"type":"string","description":"Name of the parent group, if applicable."},"childrenCount":{"type":"integer","format":"int32","description":"Number of members."}},"$$ref":"#/components/schemas/GroupDTO"},"rule":{"description":"Data Transfer Object representing a rule, including its attributes and conditions.","properties":{"uuid":{"type":"string","description":"Unique identifier for the rule, if available.","maxLength":255,"minLength":0},"classifier":{"type":"string","description":"Classifier type for the rule.","enum":["LocationDevices","UserDefinedPorts"],"maxLength":255,"minLength":0},"conditions":{"type":"string","format":"Stringify json of Java class","description":"See the rule/conditions API for details on supported condition properties and operators."},"targetGroupUuid":{"type":"string","description":"UUID of the target group associated with the rule, if applicable.","maxLength":255,"minLength":0}},"required":["classifier"],"$$ref":"#/components/schemas/RuleDTO"},"error":{"type":"string","description":"Error message, if any, associated with the result."},"details":{"type":"object","additionalProperties":{"type":"string","description":"Additional details related to the result, stored as key-value pairs."},"description":"Additional details related to the result, stored as key-value pairs."}},"$$ref":"#/components/schemas/ResultDTO"},"examples":{"Success Response Example":{"summary":"Example of a successful deletion response","description":"Success Response Example","value":{"status":"Success"}}}}}},"400":{"description":"Bad Request"},"500":{"description":"Internal Server Error"}},"method":"delete","path":"/port/{groupUuid}"}}