Get AI Guardrails DLP Rule - Cloud Security API

{"type":"api","title":"Get AI Guardrails DLP Rule","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":["Rules","Secure Access"],"operationId":"getAiGuardrailsDlpRuleById","summary":"Get AI Guardrails DLP Rule","description":"Get the properties of the AI Guardrails DLP rule.","security":[{"oauthFlow":["policies.dlp:read"]}],"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier of the AI Guardrails DLP rule.","schema":{"type":"string","format":"uuid"},"example":"d2ff7f03-e713-454c-8726-b63859800c5d","$$ref":"#/components/parameters/idAiGuardrailsDlpRule"}],"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":"object","description":"The properties of a DLP rule.","properties":{"id":{"type":"string","description":"The unique identifier of the DLP rule.","example":"a861476c-f6a7-4d15-bf59-07aff51fc807","$$ref":"#/components/schemas/idDlpRule"},"name":{"type":"string","minLength":6,"maxLength":255,"description":"The name of the DLP rule.","example":"new SaaS API rule one","$$ref":"#/components/schemas/nameDlpRule"},"description":{"type":"string","description":"The description of the DLP rule.","example":"This rule is used for sensitive data.","$$ref":"#/components/schemas/descriptionDlpRule"},"enabled":{"type":"boolean","description":"Specifies whether the system enabled the DLP rule.","example":true,"$$ref":"#/components/schemas/enabled"},"action":{"type":"string","format":"enum","default":"MONITOR","enum":["BLOCK","DELETE","MONITOR","QUARANTINE","REVOKE_SHARING"],"description":"Action to take when the rule matches.","example":"BLOCK","$$ref":"#/components/schemas/Action"},"severity":{"type":"string","format":"enum","enum":["INFO","WARNING","ALERT","CRITICAL"],"description":"Severity of the rule.","example":"INFO","$$ref":"#/components/schemas/Severity"},"secureIcapEnabled":{"type":"boolean","description":"Indicates whether Secure ICAP is enabled.","example":true},"identities":{"type":"array","description":"List of identities associated with the rule. This field is only included if `includeDetails` contains `identities`.\n","items":{"type":"object","description":"The properties of the identity.","properties":{"originId":{"type":"integer","description":"The unique identifier of the identity.","example":1339712162},"originTypeId":{"type":"integer","description":"The type of the identity either directory_user or directory_group.","example":7},"details":{"type":"string","description":"The additonal details about the identity described in the JSON format.","example":"{\n \"originId\": 1339712162,\n \"label\": \"Kit Kit\",\n \"originTypeId\": 7,\n \"type\": \"directory_user\"\n}"}},"$$ref":"#/components/schemas/Identity"}},"applications":{"type":"array","description":"List of applications associated with the rule. This field is only included if `includeDetails` contains `applications`.\n","items":{"type":"object","required":["id"],"description":"Details of an application.","properties":{"id":{"type":"integer","format":"int64","description":"Unique application identifier.","example":75},"trafficDirection":{"type":"string","format":"enum","enum":["BOTH","REQUEST","RESPONSE","INTERNAL"],"description":"Traffic direction for the application or resource.","$$ref":"#/components/schemas/TrafficDirectionType"}},"$$ref":"#/components/schemas/Application"}},"classifications":{"type":"array","description":"The list of data classifications associated with the rule. \nThis field is only included if `includeDetails` contains `classifications`.","items":{"type":"object","required":["id"],"description":"The ID and name of the Reference object.","properties":{"id":{"type":"string","format":"uuid","example":"4dad81be-cc99-47ef-922b-cc882da5b885","description":"The unique identifier of the Reference object."},"name":{"type":"string","description":"The name of the Reference object.","example":"Credit Card Number"}},"$$ref":"#/components/schemas/IdNameRef"},"$$ref":"#/components/schemas/DLPRuleClassifications"}},"$$ref":"#/components/schemas/DLPRule"},"examples":{"example-success":{"summary":"Example Response","value":{"id":"d1e2f3a4-b5c6-7890-abcd-ef1234567890","name":"Default DLP Rule","description":"A default DLP rule for data protection.","enabled":true,"action":"MONITOR","severity":"ALERT","type":"INLINE","secureIcapEnabled":true,"identities":[{"originId":0,"originTypeId":9,"details":"{\"id\":9,\"name\":\"roaming\"}"}],"applications":[{"id":1,"trafficDirection":"REQUEST"}],"classifications":[{"id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","name":"Built-in Privacy Data Classification (US)"}],"scannableContexts":["CONTENT"],"mipTags":[]},"$$ref":"#/components/examples/DLPRuleExample"}}}}},"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":"getAiGuardrailsDlpRuleById","method":"get","path":"/dlp/aiGuardrails/rules/{id}"}}