Audience

This article is to support customers of Runner, a product that enables teams, developers, and engineers to quickly provision, interact, and modify their environments anywhere - CenturyLink Cloud, third-party cloud providers, and on-premises. Additionally, the responses in this FAQ document are specific to using the service through the Control Portal.

Service Account Overview

The Service Account alias is a secure store of a users credentials. These credentials are associated with a Job and a Schedule. When the schedule fires these credentials will be used to authenticate to CenturyLink Cloud to retrieve the necessary tokens to execute the job. The credentials are stored in a secure format separate from the job definition and other account identifying elements.

• Create Service Account Via Runner UI
• Create Service Account Via Runner API
• Get Service Account Via Runner API
• Update Service Account Via Runner API

CREATE SERVICE ACCOUNT VIA RUNNER UI

CREATE SERVICE ACCOUNT

The Service Account alias is a secure store of a user's credentials. These credentials are associated with a Job and a Schedule. The credentials are stored in a secure format separate from the job definition and other account identifying elements. Calls to this operation must include a token acquired from the authentication endpoint. See the Login API for information on acquiring this token.

When to use it

Use this API to create Service Account alias under your CenturyLink Cloud account and use this alias for executing scheduled jobs.

URL

Structure

POST https://api.runner.ctl.io/serviceAccounts/{accountAlias}

Example

POST https://api.runner.ctl.io/serviceAccounts/XXXX

Request

URI Parameters

Entity Definition

Response

The response will list the details of the new Service Account alias created.

Entity Definition

Example

{
  "id": "729e3136-c474-42fb-976e-53786f5fb000",
  "accountAlias": "XXXX",
  "alias": demo-account-service-account1,
  "username": "your-username",
  "password": "your-password"
}

GET SERVICE ACCOUNT

The Service Account alias is a secure store of a users credentials. These credentials are associated with a Job and a Schedule. The credentials are stored in a secure format separate from the job definition and other account identifying elements. See the Login API for information on acquiring this token.

When to use it

Use this API to view all the Service Account alias under your CenturyLink Cloud account alias.

URL

Structure

GET https://api.runner.ctl.io/serviceAccounts/{accountAlias}

Example

GET https://api.runner.ctl.io/serviceAccounts/XXXX

Request

URI Parameters

Response

The response will provide an array of all Service Account alias created under your CenturyLink Cloud Account.

Entity Definition

Example

{
    "accounts": [
        "demo-account-service-account1",
        "demo-account-service-account2",
        "demo-account-service-account3",
        "demo-account-service-account4"
  ]
}

UPDATE SERVICE ACCOUNT

The Service Account alias is a secure store of a users credentials. These credentials are associated with a Job and a Schedule. The credentials are stored in a secure format separate from the job definition and other account identifying elements. See the Login API for information on acquiring this token.

When to use it

Use this API to update your existing Service Account alias credentials under your CenturyLink Cloud account.

URL

Structure

PUT https://api.runner.ctl.io/serviceAccounts/{accountAlias}/{serviceAccountAlias}

Example

PUT https://api.runner.ctl.io/serviceAccounts/XXXX/demo-account-service-account1

Request

URI Parameters

Entity Definition

Response

The response will contain the updated Service Account alias details.

Entity Definition

Example

{
  "id": "729e3136-c474-42fb-976e-53786f5fb000",
  "accountAlias": "XXXX",
  "alias": demo-account-service-account1,
  "username": "Updated - username",
  "password": "Updated - password"
}