You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ambari.apache.org by "Robert Levas (JIRA)" <ji...@apache.org> on 2018/01/29 23:33:00 UTC

[jira] [Updated] (AMBARI-22418) Make Ambari configuration API consistent with existing API.

     [ https://issues.apache.org/jira/browse/AMBARI-22418?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Levas updated AMBARI-22418:
----------------------------------
    Affects Version/s:     (was: 3.0.0)
                       2.7.0
        Fix Version/s:     (was: 3.0.0)
                       2.7.0

> Make Ambari configuration API consistent with existing API.
> -----------------------------------------------------------
>
>                 Key: AMBARI-22418
>                 URL: https://issues.apache.org/jira/browse/AMBARI-22418
>             Project: Ambari
>          Issue Type: Bug
>          Components: ambari-server
>    Affects Versions: 2.7.0
>            Reporter: Robert Levas
>            Assignee: Robert Levas
>            Priority: Major
>             Fix For: 2.7.0
>
>         Attachments: AMBARI-22418_trunk_01.patch
>
>
> Make Ambari configuration API consistent with existing API. 
> The current API entry point (as of AMBARI-21307) is {{/api/v1/ambariconfigs}}. This should be more inline with the existing entry point for Ambari server related data...  {{/api/v1/services/AMBARI/components/AMBARI_SERVER}}.  
> The new API entry point for Ambari server related configuration data should be {{/api/v1/services/AMBARI/components/AMBARI_SERVER/configurations}}.
> Example Rest API calls:
> *Create/Set configuration*
> Used to create a new or explicitly set properties an existing Ambari Server configuration
> {noformat:title=URL}
> POST /api/v1/services/AMBARI/components/AMBARI_SERVER/configurations
> {noformat}
> {code:title=Payload}
> {
>   "Configuration": {    
>     "category" : "ldap-configuration",
>     "properties": {
>         "ambari.ldap.connectivity.server.host": "ldap.forumsys.com",
>         "ambari.ldap.connectivity.server.port": "389",
>         "ambari.ldap.connectivity.anonymous_bind": "true",
>         "ambari.ldap.attributes.user.search_base": "dc=example,dc=com",
>         "ambari.ldap.attributes.user.object_class": "person",
>         "ambari.ldap.attributes.user.name_attr": "uid",
>         "ambari.ldap.attributes.group.object_class": "groupOfUniqueNames",
>         "ambari.ldap.attributes.group.name_attr": "cn",
>         "ambari.ldap.attributes.group.member_attr": "uniqueMember",
>         "ambari.ldap.attributes.group.search_base": "dc=example,dc=com"
>       }
>   }
> }
> {code}
> *Update configuration*
> Used to update existing properties or add new properties to an existing Ambari Server configuration
> {noformat:title=URL}
> PUT /api/v1/services/AMBARI/components/AMBARI_SERVER/configurations/ldap-configuration
> {noformat}
> {code:title=Payload}
> {
>   "Configuration": {    
>     "properties": {
>         "ambari.ldap.connectivity.server.host": "ldap.forumsys.com",
>         "ambari.ldap.connectivity.server.port": "389",
>         "ambari.ldap.connectivity.anonymous_bind": "true",
>         "ambari.ldap.attributes.user.search_base": "dc=example,dc=com",
>         "ambari.ldap.attributes.user.object_class": "person",
>         "ambari.ldap.attributes.user.name_attr": "uid",
>         "ambari.ldap.attributes.group.object_class": "groupOfUniqueNames",
>         "ambari.ldap.attributes.group.name_attr": "cn",
>         "ambari.ldap.attributes.group.member_attr": "uniqueMember",
>         "ambari.ldap.attributes.group.search_base": "dc=example,dc=com"
>       }
>   }
> }
> {code}
> *Delete configuration*
> Deletes an existing Ambari Server configuration
> {noformat:title=URL}
> DELETE /api/v1/services/AMBARI/components/AMBARI_SERVER/configurations/ldap-configuration
> {noformat}
> *Get configurations*
> Used to retrieve a list of the existing Ambari Server configurations
> {noformat:title=URL}
> GET /api/v1/services/AMBARI/components/AMBARI_SERVER/configurations
> {noformat}
> {code:title=Response}
> {
>   "href" : "http://c6401.ambari.apache.org:8080/api/v1/services/AMBARI/components/AMBARI_SERVER/configurations",
>   "items" : [
>     {
>       "href" : "http://c6401.ambari.apache.org:8080/api/v1/services/AMBARI/components/AMBARI_SERVER/configurations/ldap-configuration",
>       "Configuration" : {
>         "category" : "ldap-configuration",
>         "component_name" : "AMBARI_SERVER",
>         "service_name" : "AMBARI"
>       }
>     }
>   ]
> }
> {code}
> *Get configuration*
> Used to retrieve a the details about an existing Ambari Server configuration
> {noformat:title=URL}
> GET /api/v1/services/AMBARI/components/AMBARI_SERVER/configurations/ldap-configuration
> {noformat}
> {code:title=Response}
> {
>   "href" : "http://c6401.ambari.apache.org:8080/api/v1/services/AMBARI/components/AMBARI_SERVER/configurations/ldap-configuration",
>   "Configuration" : {
>     "category" : "ldap-configuration",
>     "component_name" : "AMBARI_SERVER",
>     "service_name" : "AMBARI",
>     "properties" : {
>         "ambari.ldap.connectivity.server.host": "ldap.forumsys.com",
>         "ambari.ldap.connectivity.server.port": "389",
>         "ambari.ldap.connectivity.anonymous_bind": "true",
>         "ambari.ldap.attributes.user.search_base": "dc=example,dc=com",
>         "ambari.ldap.attributes.user.object_class": "person",
>         "ambari.ldap.attributes.user.name_attr": "uid",
>         "ambari.ldap.attributes.group.object_class": "groupOfUniqueNames",
>         "ambari.ldap.attributes.group.name_attr": "cn",
>         "ambari.ldap.attributes.group.member_attr": "uniqueMember",
>         "ambari.ldap.attributes.group.search_base": "dc=example,dc=com"
>     }
>   }
> }
> {code}



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)