Skip to content

Latest commit

 

History

History
217 lines (138 loc) · 9.6 KB

Robotv1Api.md

File metadata and controls

217 lines (138 loc) · 9.6 KB

\Robotv1Api

All URIs are relative to http://localhost/api/v2.0

Method HTTP request Description
CreateRobotV1 Post /projects/{project_name_or_id}/robots Create a robot account
DeleteRobotV1 Delete /projects/{project_name_or_id}/robots/{robot_id} Delete a robot account
GetRobotByIDV1 Get /projects/{project_name_or_id}/robots/{robot_id} Get a robot account
ListRobotV1 Get /projects/{project_name_or_id}/robots Get all robot accounts of specified project
UpdateRobotV1 Put /projects/{project_name_or_id}/robots/{robot_id} Update status of robot account.

CreateRobotV1

RobotCreated CreateRobotV1(ctx, projectNameOrId, robot, optional) Create a robot account

Create a robot account

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
projectNameOrId string The name or id of the project
robot RobotCreateV1 The JSON object of a robot account.
optional *Robotv1ApiCreateRobotV1Opts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a Robotv1ApiCreateRobotV1Opts struct

Name Type Description Notes

xRequestId | optional.String| An unique ID for the request | xIsResourceName | optional.Bool| The flag to indicate whether the parameter which supports both name and id in the path is the name of the resource. When the X-Is-Resource-Name is false and the parameter can be converted to an integer, the parameter will be as an id, otherwise, it will be as a name. | [default to false]

Return type

RobotCreated

Authorization

basic

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteRobotV1

DeleteRobotV1(ctx, projectNameOrId, robotId, optional) Delete a robot account

This endpoint deletes specific robot account information by robot ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
projectNameOrId string The name or id of the project
robotId int32 Robot ID
optional *Robotv1ApiDeleteRobotV1Opts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a Robotv1ApiDeleteRobotV1Opts struct

Name Type Description Notes

xRequestId | optional.String| An unique ID for the request | xIsResourceName | optional.Bool| The flag to indicate whether the parameter which supports both name and id in the path is the name of the resource. When the X-Is-Resource-Name is false and the parameter can be converted to an integer, the parameter will be as an id, otherwise, it will be as a name. | [default to false]

Return type

(empty response body)

Authorization

basic

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetRobotByIDV1

Robot GetRobotByIDV1(ctx, projectNameOrId, robotId, optional) Get a robot account

This endpoint returns specific robot account information by robot ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
projectNameOrId string The name or id of the project
robotId int32 Robot ID
optional *Robotv1ApiGetRobotByIDV1Opts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a Robotv1ApiGetRobotByIDV1Opts struct

Name Type Description Notes

xRequestId | optional.String| An unique ID for the request | xIsResourceName | optional.Bool| The flag to indicate whether the parameter which supports both name and id in the path is the name of the resource. When the X-Is-Resource-Name is false and the parameter can be converted to an integer, the parameter will be as an id, otherwise, it will be as a name. | [default to false]

Return type

Robot

Authorization

basic

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListRobotV1

[]Robot ListRobotV1(ctx, projectNameOrId, optional) Get all robot accounts of specified project

Get all robot accounts of specified project

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
projectNameOrId string The name or id of the project
optional *Robotv1ApiListRobotV1Opts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a Robotv1ApiListRobotV1Opts struct

Name Type Description Notes

xRequestId | optional.String| An unique ID for the request | xIsResourceName | optional.Bool| The flag to indicate whether the parameter which supports both name and id in the path is the name of the resource. When the X-Is-Resource-Name is false and the parameter can be converted to an integer, the parameter will be as an id, otherwise, it will be as a name. | [default to false] page | optional.Int64| The page number | [default to 1] pageSize | optional.Int64| The size of per page | [default to 10] q | optional.String| Query string to query resources. Supported query patterns are "exact match(k=v)", "fuzzy match(k=v)", "range(k=[minmax])", "list with union releationship(k={v1 v2 v3})" and "list with intersetion relationship(k=(v1 v2 v3))". The value of range and list can be string(enclosed by " or '), integer or time(in format "2020-04-09 02:36:00"). All of these query patterns should be put in the query string "q=xxx" and splitted by ",". e.g. q=k1=v1,k2=v2,k3=[minmax] | sort | optional.String| Sort the resource list in ascending or descending order. e.g. sort by field1 in ascending orderr and field2 in descending order with "sort=field1,-field2" |

Return type

[]Robot

Authorization

basic

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateRobotV1

UpdateRobotV1(ctx, projectNameOrId, robotId, robot, optional) Update status of robot account.

Used to disable/enable a specified robot account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
projectNameOrId string The name or id of the project
robotId int32 Robot ID
robot Robot The JSON object of a robot account.
optional *Robotv1ApiUpdateRobotV1Opts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a Robotv1ApiUpdateRobotV1Opts struct

Name Type Description Notes

xRequestId | optional.String| An unique ID for the request | xIsResourceName | optional.Bool| The flag to indicate whether the parameter which supports both name and id in the path is the name of the resource. When the X-Is-Resource-Name is false and the parameter can be converted to an integer, the parameter will be as an id, otherwise, it will be as a name. | [default to false]

Return type

(empty response body)

Authorization

basic

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]