Add Group to Project

Add a pre-existing Advanced Server Access group to a project.

A group enables server access with either user or admin permissions and the option to sync an Advanced Server Access group to the servers in the project.

Options

Field Definition Type Required
Create Server Group Specify if you want the ASA server agent to create a corresponding local (Unix or Windows) group on servers in the Project. Dropdown TRUE
Server Access Specify if users that are members of the ASA Group will be granted access to servers in the Project. Dropdown TRUE
Server Admin Specify if users that are members of the ASA Group will be granted privileged (root/local Windows administrator) access to servers in the Project. Dropdown TRUE

Input

Field Definition Type Required
Group Name Name of the group to be added to a project. String TRUE
Project Name Name of the project to which a group is added. String TRUE
Server Group Name If “Create Server Group” is true, the name of the server group. String FALSE
Unix GID If “Create Server Group” is true, the GID of the server group created. Number FALSE
Server Selectors - Labels Kubernetes-style selector for servers in a Project. Format api.(key)=(value) String FALSE

Output

Field Definition Type
Status Code Result of the operation. The HTTP status code is returned by the connector and indicates whether the action taken by the card succeeded or failed. For example:
  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request was not processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Related topics

Advanced Server Access connector

Elements of Workflows

Advanced Server Access API documentation