{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Use the CDAP Profile Microservices to create profiles, list available profiles, and retrieve information about profiles","type":"text"}]},{"type":"paragraph","content":[{"text":"All methods or endpoints described in this API have a base URL (typically ","type":"text"},{"text":"http://:11015","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"https://:10443","type":"text","marks":[{"type":"code"}]},{"text":") that precedes the resource identifier, as described in the ","type":"text"},{"text":"Microservices Conventions","type":"text","marks":[{"type":"link","attrs":{"href":"https://cdap.atlassian.net/wiki/spaces/DOCS/pages/477692124/API+Introduction"}}]},{"text":". These methods return a status code, as listed in the Microservices Status Codes.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Write a Profile","type":"text"}]},{"type":"paragraph","content":[{"text":"A system profile can be created or updated with an HTTP PUT method to the URL:","type":"text"}]},{"type":"codeBlock","content":[{"text":"PUT /v3/profiles/","type":"text"}]},{"type":"paragraph","content":[{"text":"A user profile can be created or updated with an HTTP PUT method to the URL:","type":"text"}]},{"type":"codeBlock","content":[{"text":"PUT /v3/namespaces//profiles/","type":"text"}]},{"type":"paragraph","content":[{"text":"The request body must be a JSON object that specifies the profile details.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ PUT /v3/namespace/default/profiles/dataproc -d\n{\n \"label\": \"Dataproc\",\n \"description\": \"My Dataproc profile\",\n \"provisioner\": {\n \"name\": \"gcp-dataproc\",\n \"properties\": [\n {\n \"name\": \"projectId\",\n \"value\": \"my project id\",\n \"isEditable\": false\n },\n ...\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"List Profiles","type":"text"}]},{"type":"paragraph","content":[{"text":"To list all system profiles, submit an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/profiles","type":"text"}]},{"type":"paragraph","content":[{"text":"To list all user profiles, submit an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//profiles[?includeSystem=true]","type":"text"}]},{"type":"paragraph","content":[{"text":"This will return a JSON array that lists each profile. For the user profiles endpoint, if the includeSystem query param is set to true, all system profiles will also be returned in the response.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ GET /v3/namespaces/default/profiles\n[\n {\n \"name\": \"dataproc\",\n \"label\": \"Dataproc\",\n \"description\": \"My Dataproc Profile\",\n \"scope\": \"SYSTEM\",\n \"status\": \"ENABLED\",\n \"created\": 1234567890,\n \"provisioner\": {\n \"name\": \"gcp-dataproc\",\n \"properties\": [\n {\n \"name\": \"projectId\",\n \"value\": \"my project id\",\n \"isEditable\": false\n },\n ...\n ]\n }\n },\n ...\n]","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Retrieve Profile Details","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve details about a system profile, submit an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/profiles/","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve details about a user profile, submit an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//profiles/","type":"text"}]},{"type":"paragraph","content":[{"text":"This will return a JSON object that contains details about the profile.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ GET /v3/namespaces/default/profiles/dataproc\n{\n \"name\": \"dataproc\",\n \"label\": \"Dataproc\",\n \"description\": \"My Dataproc Profile\",\n \"scope\": \"SYSTEM\",\n \"status\": \"ENABLED\",\n \"created\": 1234567890,\n \"provisioner\": {\n \"name\": \"gcp-dataproc\",\n \"properties\": [\n {\n \"name\": \"projectId\",\n \"value\": \"my project id\",\n \"isEditable\": false\n },\n ...\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Disable Profile","type":"text"}]},{"type":"paragraph","content":[{"text":"To disable a system profile, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/profiles//disable","type":"text"}]},{"type":"paragraph","content":[{"text":"To disable a user profile, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//profiles//disable","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Enable Profile","type":"text"}]},{"type":"paragraph","content":[{"text":"To enable a system profile, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/profiles//enable","type":"text"}]},{"type":"paragraph","content":[{"text":"To enable a user profile, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//profiles//enable","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Delete Profile","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete a system profile, submit an HTTP DELETE request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/profiles/","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete a user profile, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/namespaces//profiles/","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to delete a profile, the profile must be disabled, it must not be assigned to any entity, and it must not be in use by any active program runs. If any of these conditions is not met, a 409 will be returned.","type":"text"}]}],"version":1}

Browser not supported