Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


ListAclsResponse (Version: 0) => error_code error_message [resource]
error_code => INT16
error_message => NULLABLE_STRING
resource => resource_type resource_name [acl]
resource_type => INT8
resource_name => STRING
acl => principal host operation permission_type
principal => STRING
host => STRING
operation => INT8
permission_type => INT8

...


CreateAclsRequest (Version: 0) => [resourcecreation_request]
resourcecreation_request => resource_type resource_name [acl_request] principal host operation permission_type
 resource_type => INT8
resource_name => STRING
 acl_request => principal host operation permission_type
principal => STRING
host => STRING
  operation => INT8
permission_type => INT8

...

CreateAclsRequest receives a list of resource requests.  Each resource request specifies a list of requests to add particular ACLs.CreateAclsRequest must be ACLs to add.  It must be sent to the controller broker.  The request is not transactional: if one addition fails, the others may proceed.  Errors are reported independently for each addition.

...

CreateAclsResponse (Version: 0) => error_code [additioncreation_response]
addition_response => error_code error_message
error error_code => INT16
error_message => NULLABLE_STRING

There will be a creation_response for each creation in the CreateAclsRequest.  The responses will be appear in the same order which the requests appeared.  If the request completed successfully, error_code field will be non-zero if the was an error that prevented processing any part of the request.  If the error_code field is non-zero, the addition_response array will be empty.  Otherwise, there will be an addition_response for each addition in the CreateAclsRequest.  These responses will be appear in the same order which the requests appeared.  If the request completed successfully, error_code will be 0 and error_message will be null.  If there was an error, the error_code will be non-zero and the error_message will give a detailed error message describing why the addition creation could not be performed.

DeleteAclsRequest and DeleteAclsResponse

...


DeleteAclsRequest (Version: 0) => [resource_requestfilter]
resource_requestfilter => resource_type resource_name [acl_request]principal host operation permission_type
 resource_type => INT8
resource_name => NULLABLE_STRING
 acl_request => principal host operation permission_type_name => NULLABLE_STRING
principal => NULLABLE_STRING
host => NULLABLE_STRING
  operation => INT8
permission_type => INT8

...

DeleteAclsResponse (Version: 0) => error_code [filter_response]
filter filter_response => error_code error_message [matching_acl]
 error_pair =>
 error_code => INT16
error_message => NULLABLE_STRING
matching_acl => error_code error_messagepair resource_type resource_name principal host operation permission_type
errorresource_codetype => INT16INT8
errorresource_messagename => NULLABLE_STRING
principal => STRING
host => STRING
operation => INT8
permission_type => INT8

 

...

 STRING
operation => INT8
permission_type => INT8

 

Filter responses will be appear in the same order which the filters appeared.  If the filter_response has a non-zero error_code, that means that the filter could not be applied by the server, and the matching_acl array will be empty.  Otherwise, the matching_acl array contains a list of all the ACLs that matched the filter.  Each matching_acl will have a non-zero error code and error message if it could not be removed.

...

Once AdminClient supports ACL operations, we can transition the command-line utilities to using it, instead of contacting ZooKeeper directly.