List Custom DLP Classifications - Cloud Security API

{"type":"api","title":"List Custom DLP Classifications","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/83e8a10367d157243cd1c3e478b807cb81262a3d/8d86edee-12fb-373d-b1e1-d0caf3a16e2d","info":{"title":"Data Loss Prevention Policy Rules API","description":"Manage the Data Loss Prevention (DLP) rules, classifications, and data identifiers.","version":"1.0.0","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"DataIdentifiers","description":"Operations related to DLP data identifiers."},{"name":"Classifications","description":"Operations related to DLP classifications."},{"name":"Rules","description":"Operations related to DLP rules."},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/policies/dlp-rules-overview.md","uri":"secure-access-api-reference-dlp-policy-rules-overview"}},"openapi":"3.0.3","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"policies/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"The client credential flow.","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"policies.dlp:read":"Read dlp classifications, data identifiers, and rules","policies.dlp:write":"Write dlp classifications, data identifiers, and rules"}}}}}},"spec":{"tags":["Classifications","Secure Access"],"operationId":"getAllCustomDlpClassifications","security":[{"oauthFlow":["policies.dlp:read"]}],"summary":"List Custom DLP Classifications","description":"List the custom DLP classifications. You can query the data identifiers using the `name` parameter. Use the `fields` query parameter to include additional fields in the response.\n","parameters":[{"name":"name","in":"query","required":false,"description":"The name of the custom classification. The value of `name` is case insensitive and the system allows partial matches.","schema":{"type":"string","example":"custom"},"$$ref":"#/components/parameters/nameCustomClassifications"},{"name":"limit","in":"query","description":"The number of records returned by the system in the response. The maximum number of items that are allowed in the response is 100.\nThe default number of items returned in the response is 50.","required":false,"schema":{"type":"integer","default":50,"format":"int32","minimum":1,"maximum":100},"example":20,"$$ref":"#/components/parameters/limit"},{"name":"offset","in":"query","required":false,"description":"The numeric offset into the collection used for pagination. Set the `offset` to skip the number of records from the collection in the response. The default value is `0`.\n","schema":{"type":"integer","format":"int32","default":0},"$$ref":"#/components/parameters/offset"},{"name":"fields","in":"query","required":false,"description":"A comma-separated list of fields to include in the response.\n","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["id","name","type","description","classifierEvaluationStrategy","dataIdentifiers","excludedDataIdentifiers","creationTime","modificationTime"]},"default":["id","name"],"example":["id","name"]},"$$ref":"#/components/parameters/classificationFields"}],"responses":{"200":{"description":"OK","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"array","description":"The list of custom DLP classifications.","items":{"type":"object","description":"Details of a data classification.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the classification.","example":"12345678-abcd-4ef0-9123-456789abcdef","$$ref":"#/components/schemas/idDataClassification"},"name":{"type":"string","minLength":6,"maxLength":255,"description":"The name of the classification.","example":"Classification Name","$$ref":"#/components/schemas/nameDataClassification"}},"$$ref":"#/components/schemas/DataClassificationListItem"}},"examples":{"example-success":{"summary":"Example Response","value":[{"id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","name":"Built-in Privacy Data Classification (US)"},{"id":"b1c2d3e4-f5a6-7890-bcde-fa2345678901","name":"Custom Financial Data Classification"}],"$$ref":"#/components/examples/DataClassificationListExample"}}}}},"400":{"description":"Bad Request","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response format","properties":{"error":{"type":"string","description":"Error description","example":"Something went wrong please"},"statusCode":{"type":"integer","description":"HTTP status code","example":400},"txId":{"type":"string","description":"Unique transaction ID for tracing the request","example":"a82ddc7e-cd7e-4c2a-ab80-76577085fbc9"}},"$$ref":"#/components/schemas/ApiErrorResponse"}}},"$$ref":"#/components/responses/BadRequestError"},"404":{"description":"Not Found","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response format","properties":{"error":{"type":"string","description":"Error description","example":"Something went wrong please"},"statusCode":{"type":"integer","description":"HTTP status code","example":400},"txId":{"type":"string","description":"Unique transaction ID for tracing the request","example":"a82ddc7e-cd7e-4c2a-ab80-76577085fbc9"}},"$$ref":"#/components/schemas/ApiErrorResponse"}}},"$$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal Server Error","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response format","properties":{"error":{"type":"string","description":"Error description","example":"Something went wrong please"},"statusCode":{"type":"integer","description":"HTTP status code","example":400},"txId":{"type":"string","description":"Unique transaction ID for tracing the request","example":"a82ddc7e-cd7e-4c2a-ab80-76577085fbc9"}},"$$ref":"#/components/schemas/ApiErrorResponse"}}},"$$ref":"#/components/responses/InternalServerError"}},"__originalOperationId":"getAllCustomDlpClassifications","method":"get","path":"/dlp/custom/classifications"}}