Skip to content

Latest commit

 

History

History
925 lines (556 loc) · 26.1 KB

AppApi.md

File metadata and controls

925 lines (556 loc) · 26.1 KB

\AppApi

All URIs are relative to http://localhost

Method HTTP request Description
AppCnameAdd Post /1.0/apps/{app}/cname
AppCnameDelete Delete /1.0/apps/{app}/cname
AppCreate Post /1.0/apps
AppDelete Delete /1.0/apps/{app}
AppDeploy Post /1.0/apps/{app}/deploy
AppGet Get /1.0/apps/{app}
AppList Get /1.0/apps
AppQuotaChange Put /1.0/apps/{app}/quota
AppQuotaGet Get /1.0/apps/{app}/quota
AppRestart Post /1.0/apps/{app}/restart
AppRouterAdd Post /1.5/apps/{app}/routers
AppRouterDelete Delete /1.5/apps/{app}/routers/{router}
AppRouterList Get /1.5/apps/{app}/routers
AppRouterUpdate Put /1.5/apps/{app}/routers/{router}
AppSetRoutable Post /1.8/apps/{app}/routable
AppStart Post /1.0/apps/{app}/start
AppStop Post /1.0/apps/{app}/stop
AppTeamGrant Put /1.0/apps/{app}/teams/{team}
AppTeamRevoke Delete /1.0/apps/{app}/teams/{team}
AppUpdate Put /1.0/apps/{app}
AutoScaleAdd Post /1.9/apps/{app}/units/autoscale
AutoScaleInfo Get /1.9/apps/{app}/units/autoscale
AutoScaleRemove Delete /1.9/apps/{app}/units/autoscale
CertificatUnset Delete /1.0/apps/{app}/certificate
CertificateSet Put /1.0/apps/{app}/certificate
EnvGet Get /1.0/apps/{app}/env
EnvSet Post /1.0/apps/{app}/env
EnvUnset Delete /1.0/apps/{app}/env
UnitsAdd Put /1.0/apps/{app}/units
UnitsRemove Delete /1.0/apps/{app}/units

AppCnameAdd

AppCnameAdd(ctx, app, appCName)

adds a cname to app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appCName AppCName

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppCnameDelete

AppCnameDelete(ctx, app, appCName)

remove cname from app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appCName AppCName

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppCreate

AppCreateResponse AppCreate(ctx, inputApp)

Create a new app.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
inputApp InputApp

Return type

AppCreateResponse

Authorization

Bearer

HTTP request headers

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

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

AppDelete

AppDelete(ctx, app)

Delete a tsuru app.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/x-json-stream

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

AppDeploy

AppDeploy(ctx, app, appDeployOptions)

deploy a app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appDeployOptions AppDeployOptions

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppGet

App AppGet(ctx, app)

Get info about a tsuru app.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.

Return type

App

Authorization

Bearer

HTTP request headers

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

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

AppList

[]MiniApp AppList(ctx, optional)

List apps.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *AppListOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a AppListOpts struct

Name Type Description Notes
locked optional.Bool Filter applications by lock status.
name optional.String Filter applications by name.
owner optional.String Filter applications by owner.
platform optional.String Filter applications by platform.
pool optional.String Filter applications by pool.
status optional.String Filter applications by unit status.
tag optional.Interface of []string Filter applications by tag.
teamOwner optional.String Filter applications by team owner.
simplified optional.Bool Returns applications without units list.

Return type

[]MiniApp

Authorization

Bearer

HTTP request headers

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

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

AppQuotaChange

AppQuotaChange(ctx, app, limit)

Changes the maximum limit of units allowed for use.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
limit float32 Number of units allowed for use by the current app. Negative number indicates unlimited.

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded
  • Accept: application/json

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

AppQuotaGet

Quota AppQuotaGet(ctx, app)

Shows app usage info and its quota limit.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.

Return type

Quota

Authorization

Bearer

HTTP request headers

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

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

AppRestart

AppRestart(ctx, app, appStartStop)

Restart App.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appStartStop AppStartStop

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppRouterAdd

AppRouterAdd(ctx, app, appRouter)

adds a router to app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appRouter AppRouter

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppRouterDelete

AppRouterDelete(ctx, app, router)

Delete a tsuru app.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
router string Router name

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppRouterList

[]AppRouter AppRouterList(ctx, app)

list routers from an app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.

Return type

[]AppRouter

Authorization

Bearer

HTTP request headers

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

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

AppRouterUpdate

AppRouterUpdate(ctx, app, router, appRouter)

update a router

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
router string Router name
appRouter AppRouter

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppSetRoutable

AppSetRoutable(ctx, app, setRoutableArgs)

Sets a version as routable.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
setRoutableArgs SetRoutableArgs

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppStart

AppStart(ctx, app, appStartStop)

Start App.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appStartStop AppStartStop

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppStop

AppStop(ctx, app, appStartStop)

Stop App.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
appStartStop AppStartStop

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppTeamGrant

AppTeamGrant(ctx, app, team)

grant access to a team

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
team string Team name

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppTeamRevoke

AppTeamRevoke(ctx, app, team)

grant access to a team

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
team string Team name

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AppUpdate

AppUpdate(ctx, app, updateApp)

Update a tsuru app.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
updateApp UpdateApp

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AutoScaleAdd

AutoScaleAdd(ctx, app, autoScaleSpec)

Add new unit autoscale spec.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
autoScaleSpec AutoScaleSpec

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

AutoScaleInfo

[]AutoScaleSpec AutoScaleInfo(ctx, app)

List autoscales for app.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.

Return type

[]AutoScaleSpec

Authorization

Bearer

HTTP request headers

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

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

AutoScaleRemove

AutoScaleRemove(ctx, app, process)

Remove unit autoscale spec.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
process string

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

  • Content-Type: Not defined
  • Accept: /

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

CertificatUnset

CertificatUnset(ctx, app)

Unset app certificate.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

  • Content-Type: Not defined
  • Accept: /

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

CertificateSet

CertificateSet(ctx, app, certificateSetData)

Create a certificate

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
certificateSetData CertificateSetData

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

EnvGet

[]EnvVar EnvGet(ctx, app, optional)

Get app environment variables.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
optional *EnvGetOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a EnvGetOpts struct

Name Type Description Notes

env | optional.String| Environment variable name. |

Return type

[]EnvVar

Authorization

Bearer

HTTP request headers

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

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

EnvSet

EnvSet(ctx, app, envSetData)

Set new environment variable.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
envSetData EnvSetData Environment variables.

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

EnvUnset

EnvUnset(ctx, app, env, norestart)

Unset app environment variables.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
env []string
norestart bool

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/x-json-stream

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

UnitsAdd

UnitsAdd(ctx, app, unitsDelta)

Add units to app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
unitsDelta UnitsDelta number of units to add

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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

UnitsRemove

UnitsRemove(ctx, app, unitsDelta)

Remove units from app

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
app string App name.
unitsDelta UnitsDelta number of units to remove

Return type

(empty response body)

Authorization

Bearer

HTTP request headers

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

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