Hi, At my customer's site we're going to implement Atlas (HDP 2.6.3) and I am preparing for that by finding out what Atlas REST API calls I can use to quickly label HDFS paths and Hive tables. I'm trying them out on a HDP 2.6.3 Sandbox (Atlas 1.0.0, I think). Atlas is running without problems. I can use the GUI, create tags and add tags. I've tried using the examples from the Swagger site (http://atlas.apache.org/api/v2/ui/index.html#/), but often I can't get them to work.
I've found other REST API calls that do work, so it's not a big problem. I found these others with a lot of trial and error. But I would like to know if I'm doing something wrong or if there actually is a problem with the Swagger "prescribed" URLs. Example 1: Showing available tags This is what I derived from the Swagger UI (http://atlas.apache.org/api/v2/ui/index.html#!/TypesREST/resource_TypesREST_getAllTypeDefs_GET<http://atlas.apache.org/api/v2/ui/index.html%23!/TypesREST/resource_TypesREST_getAllTypeDefs_GET>). I've changed the address and added the username/password combination (only for testing purposes). curl -X GET --header "Accept: text/html" "http://sandbox.hortonworks.com:21000/v2/types/typedefs" -u holger_gov:holger_gov The response: <body><h2>HTTP ERROR 404</h2> <p>Problem accessing /v2/types/typedefs. Reason: <pre> Not Found</pre></p><hr><i><small>Powered by Jetty://</small></i><hr/> </body> Because some other working calls I've found use "api/atlas" before the /v2 part, I've also tried that: curl -X GET --header "Accept: text/html" "http://sandbox.hortonworks.com:21000/api/atlas/v2/types/typedefs" -u holger_gov:holger_gov But that results in an internal error: HTTP/1.1 500 Internal Server Error Date: Sun, 10 Dec 2017 14:55:11 GMT Set-Cookie: ATLASSESSIONID=19x0czac5yij91r7g6am2fhjs0;Path=/;HttpOnly Expires: Thu, 01 Jan 1970 00:00:00 GMT X-Frame-Options: DENY Content-Type: text/html Transfer-Encoding: chunked Server: Jetty(9.2.12.v20150709) There was an error processing your request. It has been logged (ID 9ebdadb08c253b4a). I can't find any logs on this in /var/log/atlas. Here is a working Atlas REST API call for this: curl -i -X GET http://sandbox.hortonworks.com:21000/api/atlas/types?type=TRAIT -u holger_gov:holger_gov The response: {"results":["Order management","Standaard","Vertrouwelijk","Intern","PII3","Openbaar","Belangrijk","Persoonlijk herleidbaar","Persoonlijk_herleidbaar","Kritisch"],"count":10,"requestId":"pool-2-thread-8 - 49bf8f8f-e384-42cb-be78-daede0f9228d"} See, it definitely is possible to retrieve this information. Show information on one tag Here I'm trying to get information on a tag type called Vertrouwelijk (English: confidential). >From the Swagger UI >(http://atlas.apache.org/api/v2/ui/index.html#!/TypesREST/resource_TypesREST_getTypeDefByName_GET<http://atlas.apache.org/api/v2/ui/index.html%23!/TypesREST/resource_TypesREST_getTypeDefByName_GET>): curl -X GET --header 'Accept: text/html' 'http://sandbox.hortonworks.com:21000/v2/types/typedef/name/Vertrouwelijk' -u holger_gov:holger_gov The response: <body><h2>HTTP ERROR 404</h2> <p>Problem accessing /v2/types/typedef/name/Vertrouwelijk. Reason: <pre> Not Found</pre></p><hr><i><small>Powered by Jetty://</small></i><hr/> </body> So there's that again. But now try this: curl -i -X GET 'http://sandbox.hortonworks.com:21000/api/atlas/v2/types/typedef/name/Vertrouwelijk' -u holger_gov:holger_gov The response: {"category":"CLASSIFICATION","guid":"6ab9e4fb-a507-4cf9-b9e9-1d288f651b92","createTime":1511362880157,"updateTime":1511362880157,"version":1,"name":"Vertrouwelijk","description":"Informatie classificatie: vertrouwelijk","typeVersion":"1.0","attributeDefs":[],"superTypes":[]} Or this one: curl -i -X GET -u holger_gov:holger_gov 'http://sandbox.hortonworks.com:21000/api/atlas/types/Vertrouwelijk' The response: {"typeName":"Vertrouwelijk","definition":{"enumTypes":[],"structTypes":[],"traitTypes":[{"superTypes":[],"hierarchicalMetaTypeName":"org.apache.atlas.typesystem.types.TraitType","typeName":"Vertrouwelijk","typeDescription":"Informatie classificatie: vertrouwelijk","typeVersion":"1.0","attributeDefinitions":[]}],"classTypes":[]},"requestId":"pool-2-thread-8 - 4603fe6a-8c1a-48ea-8cf8-ab20f647c30b"} Am I missing some crucial point? [X]<http://www.opencirclesolutions.nl/> Met vriendelijke groeten / Best regards, Marcel-Jan Krijgsman Data Engineer Daalakkersweg 16-6 5641 JA | Eindhoven mobile 06 21 626 420<tel:+31621626420> tel 040 304 1330<tel:+31403041330> www.opencirclesolutions.nl<http://www.opencirclesolutions.nl/> | [email protected]<mailto:[email protected]>
