[![Version](https://img.shields.io/npm/v/@adobe/aio-lib-cloudmanager.svg)](https://npmjs.org/package/@adobe/aio-lib-cloudmanager) [![Downloads/week](https://img.shields.io/npm/dw/@adobe/aio-lib-cloudmanager.svg)](https://npmjs.org/package/@adobe/aio-lib-cloudmanager) [![Build Status](https://github.com/adobe/aio-lib-cloudmanager/workflows/CI%20Build/badge.svg?branch=main)](https://github.com/adobe/aio-lib-cloudmanager/actions?query=workflow%3A%22CI+Build%22) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Codecov Coverage](https://img.shields.io/codecov/c/github/adobe/aio-lib-cloudmanager/master.svg?style=flat-square)](https://codecov.io/gh/adobe/aio-lib-cloudmanager/) # Adobe I/O Cloud Manager Library JavaScript SDK wrapping the [Adobe Cloud Manager API](https://www.adobe.io/experience-cloud/cloud-manager/). ### Installing ```bash $ npm install @adobe/aio-lib-cloudmanager ``` ### Usage 1) Initialize the SDK ```javascript const sdk = require('@adobe/aio-lib-cloudmanager') async function sdkTest() { //initialize sdk const client = await sdk.init('', 'x-api-key', '') } ``` 2) Call methods using the initialized SDK ```javascript const sdk = require('@adobe/aio-lib-cloudmanager') async function sdkTest() { // initialize sdk const client = await sdk.init('', 'x-api-key', '') // call methods try { // get... something const result = await client.listPrograms() console.log(result) } catch (e) { console.error(e) } } ``` ## Classes

CloudManagerAPI: This class provides methods to call your Cloud Manager APIs. Before calling any method initialize the instance by calling the init method on it with valid values for orgId, apiKey and accessToken

## Functions

getCurrentStep(execution) ⇒ PipelineExecutionStepState: Find the first non-finished step in a pipeline execution
getWaitingStep(execution) ⇒ PipelineExecutionStepState: Find the first waiting step in a pipeline execution
init(orgId, apiKey, accessToken, baseUrl) ⇒ Promise.<CloudManagerAPI>: Returns a Promise that resolves with a new CloudManagerAPI object.

## Typedefs

EmbeddedProgram : object: A lightweight representation of a Program
Pipeline : object: A representation of a CI/CD Pipeline
PipelinePhase : object: Describes a phase of a pipeline
PipelineExecution : object: A representation of an execution of a CI/CD Pipeline.
PipelineExecutionStepState : object: Describes the status of a particular pipeline execution step for display purposes
PipelineStepMetrics : object
Metric : object: A representation of a specific metric generated by a CI/CD Pipeline step.
Environment : object: A representation of an Environment known to Cloud Manager.
Variable : object: A named value than can be set on an Environment or Pipeline
ContentSet : object: A representation of a ContentSet custom
ContentFlow : object: The Content Flow Execution
LogOptionRepresentation : object
IPAllowedListBinding : object: Describes an IP Allowed List Binding
IPAllowedList : object: Describes an IP Allowed List
ListPipelineOptions : object: Options to the listPipeline function
DownloadedLog : object
PipelineUpdate : object

## CloudManagerAPI This class provides methods to call your Cloud Manager APIs. Before calling any method initialize the instance by calling the `init` method on it with valid values for orgId, apiKey and accessToken **Kind**: global class * [CloudManagerAPI](#CloudManagerAPI) * [.orgId](#CloudManagerAPI+orgId) : string * [.apiKey](#CloudManagerAPI+apiKey) : string * [.accessToken](#CloudManagerAPI+accessToken) : string * [.baseUrl](#CloudManagerAPI+baseUrl) : string * [.addIpAllowlistBinding(programId, ipAllowlistId, environmentId, service)](#CloudManagerAPI+addIpAllowlistBinding) ⇒ Promise.<object> * [.advanceCurrentExecution(programId, pipelineId)](#CloudManagerAPI+advanceCurrentExecution) ⇒ Promise.<object> * [.cancelContentFlow(programId, contentFlowId)](#CloudManagerAPI+cancelContentFlow) ⇒ Promise.<object> * [.cancelCurrentExecution(programId, pipelineId)](#CloudManagerAPI+cancelCurrentExecution) ⇒ Promise.<object> * [.createContentFlow(programId, environmentId, contentFlow)](#CloudManagerAPI+createContentFlow) ⇒ [Promise.<ContentFlow>](#ContentFlow) * [.createContentSet(programId, contentSet)](#CloudManagerAPI+createContentSet) ⇒ [Promise.<ContentSet>](#ContentSet) * [.createExecution(programId, pipelineId, mode)](#CloudManagerAPI+createExecution) ⇒ [Promise.<PipelineExecution>](#PipelineExecution) * [.createIpAllowlist(programId, name, cidrBlocks)](#CloudManagerAPI+createIpAllowlist) ⇒ [Promise.<IPAllowedList>](#IPAllowedList) * [.deleteContentSet(programId, contentSetId)](#CloudManagerAPI+deleteContentSet) ⇒ Promise.<object> * [.deleteEnvironment(programId, environmentId)](#CloudManagerAPI+deleteEnvironment) ⇒ Promise.<object> * [.deleteIpAllowlist(programId, ipAllowlistId)](#CloudManagerAPI+deleteIpAllowlist) ⇒ Promise.<object> * [.deletePipeline(programId, pipelineId)](#CloudManagerAPI+deletePipeline) ⇒ Promise.<object> * [.deleteProgram(programId)](#CloudManagerAPI+deleteProgram) ⇒ Promise.<object> * [.downloadLogs(programId, environmentId, service, name, days, outputDirectory)](#CloudManagerAPI+downloadLogs) ⇒ Promise.<Array.<DownloadedLog>> * [.getContentFlow(programId, contentFlowId)](#CloudManagerAPI+getContentFlow) ⇒ [Promise.<ContentFlow>](#ContentFlow) * [.getContentSet(programId, contentSetId)](#CloudManagerAPI+getContentSet) ⇒ [Promise.<ContentSet>](#ContentSet) * [.getCurrentExecution(programId, pipelineId)](#CloudManagerAPI+getCurrentExecution) ⇒ [Promise.<PipelineExecution>](#PipelineExecution) * [.getDeveloperConsoleUrl(programId, environmentId)](#CloudManagerAPI+getDeveloperConsoleUrl) ⇒ Promise.<string> * [.getEnvironmentVariables(programId, environmentId)](#CloudManagerAPI+getEnvironmentVariables) ⇒ Promise.<Array.<Variable>> * [.getExecution(programId, pipelineId, executionId)](#CloudManagerAPI+getExecution) ⇒ [Promise.<PipelineExecution>](#PipelineExecution) * [.getExecutionStepLog(programId, pipelineId, executionId, action, logFile, outputStream)](#CloudManagerAPI+getExecutionStepLog) ⇒ Promise.<object> * [.getPipelineVariables(programId, pipelineId)](#CloudManagerAPI+getPipelineVariables) ⇒ Promise.<Array.<Variable>> * [.getQualityGateResults(programId, pipelineId, executionId, action)](#CloudManagerAPI+getQualityGateResults) ⇒ [Promise.<PipelineStepMetrics>](#PipelineStepMetrics) * [.init(orgId, apiKey, accessToken, baseUrl)](#CloudManagerAPI+init) ⇒ [Promise.<CloudManagerAPI>](#CloudManagerAPI) * [.invalidatePipelineCache(programId, pipelineId)](#CloudManagerAPI+invalidatePipelineCache) ⇒ Promise.<object> * [.listAvailableLogOptions(programId, environmentId)](#CloudManagerAPI+listAvailableLogOptions) ⇒ Promise.<Array.<LogOptionRepresentation>> * [.listContentFlows(programId)](#CloudManagerAPI+listContentFlows) ⇒ Promise.<Array.<ContentFlow>> * [.listContentSets(programId)](#CloudManagerAPI+listContentSets) ⇒ Promise.<Array.<ContentSet>> * [.listEnvironments(programId)](#CloudManagerAPI+listEnvironments) ⇒ Promise.<Array.<Environment>> * [.listExecutions(programId, pipelineId, limit)](#CloudManagerAPI+listExecutions) ⇒ Promise.<Array.<PipelineExecution>> * [.listIpAllowlists(programId)](#CloudManagerAPI+listIpAllowlists) ⇒ [Promise.<IPAllowedList>](#IPAllowedList) * [.listPipelines(programId, options)](#CloudManagerAPI+listPipelines) ⇒ Promise.<Array.<Pipeline>> * [.listPrograms()](#CloudManagerAPI+listPrograms) ⇒ Promise.<Array.<EmbeddedProgram>> * [.removeIpAllowlistBinding(programId, ipAllowlistId, environmentId, service)](#CloudManagerAPI+removeIpAllowlistBinding) ⇒ Promise.<object> * [.setEnvironmentVariables(programId, environmentId, variables)](#CloudManagerAPI+setEnvironmentVariables) ⇒ Promise.<object> * [.setPipelineVariables(programId, pipelineId, variables)](#CloudManagerAPI+setPipelineVariables) ⇒ Promise.<object> * ~~[.startExecution(programId, pipelineId, mode)](#CloudManagerAPI+startExecution) ⇒ Promise.<string>~~ * [.tailExecutionStepLog(programId, pipelineId, action, logFile, outputStream)](#CloudManagerAPI+tailExecutionStepLog) ⇒ [Promise.<PipelineExecutionStepState>](#PipelineExecutionStepState) * [.updateContentSet(programId, contentSetId, updatedContentSet)](#CloudManagerAPI+updateContentSet) ⇒ [Promise.<ContentSet>](#ContentSet) * [.updateIpAllowlist(programId, ipAllowlistId, cidrBlocks)](#CloudManagerAPI+updateIpAllowlist) ⇒ Promise.<object> * [.updatePipeline(programId, pipelineId, changes)](#CloudManagerAPI+updatePipeline) ⇒ [Promise.<Pipeline>](#Pipeline) ### cloudManagerAPI.orgId : string The organization id **Kind**: instance property of [CloudManagerAPI](#CloudManagerAPI) ### cloudManagerAPI.apiKey : string The api key from your integration **Kind**: instance property of [CloudManagerAPI](#CloudManagerAPI) ### cloudManagerAPI.accessToken : string The access token from your integration **Kind**: instance property of [CloudManagerAPI](#CloudManagerAPI) ### cloudManagerAPI.baseUrl : string The base URL for the API endpoint **Kind**: instance property of [CloudManagerAPI](#CloudManagerAPI) ### cloudManagerAPI.addIpAllowlistBinding(programId, ipAllowlistId, environmentId, service) ⇒ Promise.<object> Bind an IP Allow List to an environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | ipAllowlistId | string | the allow list id | | environmentId | string | the environment id | | service | string | the service name | ### cloudManagerAPI.advanceCurrentExecution(programId, pipelineId) ⇒ Promise.<object> Advance current execution **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | ### cloudManagerAPI.cancelContentFlow(programId, contentFlowId) ⇒ Promise.<object> Cancel a content flow Cancels an in progress flow **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | contentFlowId | string | the flow id | ### cloudManagerAPI.cancelCurrentExecution(programId, pipelineId) ⇒ Promise.<object> Cancel current execution **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | ### cloudManagerAPI.createContentFlow(programId, environmentId, contentFlow) ⇒ [Promise.<ContentFlow>](#ContentFlow) Create content Set Flow for environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<ContentFlow>](#ContentFlow) - the created content flow representation | Param | Type | Description | | --- | --- | --- | | programId | string | The program id | | environmentId | string | The environment id | | contentFlow | [ContentFlow](#ContentFlow) | The body of the contentFlow | ### cloudManagerAPI.createContentSet(programId, contentSet) ⇒ [Promise.<ContentSet>](#ContentSet) Create a Content set **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<ContentSet>](#ContentSet) - the created content set | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | contentSet | string | the body of the content set. | ### cloudManagerAPI.createExecution(programId, pipelineId, mode) ⇒ [Promise.<PipelineExecution>](#PipelineExecution) Create a new execution for a pipeline, returning the execution. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<PipelineExecution>](#PipelineExecution) - the new execution | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | mode | string | the pipeline execution mode | ### cloudManagerAPI.createIpAllowlist(programId, name, cidrBlocks) ⇒ [Promise.<IPAllowedList>](#IPAllowedList) Create IP Allow List **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<IPAllowedList>](#IPAllowedList) - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | name | string | the name | | cidrBlocks | Array.<string> | the CIDR blocks | ### cloudManagerAPI.deleteContentSet(programId, contentSetId) ⇒ Promise.<object> Delete Content Set **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | contentSetId | string | the content set id | ### cloudManagerAPI.deleteEnvironment(programId, environmentId) ⇒ Promise.<object> Delete an environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | environmentId | string | the environment id | ### cloudManagerAPI.deleteIpAllowlist(programId, ipAllowlistId) ⇒ Promise.<object> Update the CIDR blocks of an IP Allow List **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | ipAllowlistId | string | the allow list id | ### cloudManagerAPI.deletePipeline(programId, pipelineId) ⇒ Promise.<object> Delete a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy object | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | ### cloudManagerAPI.deleteProgram(programId) ⇒ Promise.<object> Delete a program **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | ### cloudManagerAPI.downloadLogs(programId, environmentId, service, name, days, outputDirectory) ⇒ Promise.<Array.<DownloadedLog>> Download log files from the environment to a specified directory. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<DownloadedLog>> - the list of downloaded logs | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | environmentId | string | the environment id | | service | string | the service specification | | name | string | the log name | | days | number | the number of days | | outputDirectory | string | the output directory | ### cloudManagerAPI.getContentFlow(programId, contentFlowId) ⇒ [Promise.<ContentFlow>](#ContentFlow) Get Content Flow **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<ContentFlow>](#ContentFlow) - the Content Flow | Param | Type | Description | | --- | --- | --- | | programId | string | The program id | | contentFlowId | string | the content flow id | ### cloudManagerAPI.getContentSet(programId, contentSetId) ⇒ [Promise.<ContentSet>](#ContentSet) Get Content Set **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<ContentSet>](#ContentSet) - the content set | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | contentSetId | string | the content set id | ### cloudManagerAPI.getCurrentExecution(programId, pipelineId) ⇒ [Promise.<PipelineExecution>](#PipelineExecution) Get the current execution for a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<PipelineExecution>](#PipelineExecution) - the execution | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | ### cloudManagerAPI.getDeveloperConsoleUrl(programId, environmentId) ⇒ Promise.<string> Get the link to the developer console **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<string> - the console url | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | environmentId | string | the environment id | ### cloudManagerAPI.getEnvironmentVariables(programId, environmentId) ⇒ Promise.<Array.<Variable>> Get the list of variables for an environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<Variable>> - the variables | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | environmentId | string | the environment id | ### cloudManagerAPI.getExecution(programId, pipelineId, executionId) ⇒ [Promise.<PipelineExecution>](#PipelineExecution) Get an execution for a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<PipelineExecution>](#PipelineExecution) - the execution | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | executionId | string | the execution id | ### cloudManagerAPI.getExecutionStepLog(programId, pipelineId, executionId, action, logFile, outputStream) ⇒ Promise.<object> Write step log to an output stream. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | executionId | string | the execution id | | action | string | the action | | logFile | string | the log file to select a non-default value | | outputStream | object | the output stream to write to | ### cloudManagerAPI.getPipelineVariables(programId, pipelineId) ⇒ Promise.<Array.<Variable>> Get the list of variables for a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<Variable>> - the variables | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | ### cloudManagerAPI.getQualityGateResults(programId, pipelineId, executionId, action) ⇒ [Promise.<PipelineStepMetrics>](#PipelineStepMetrics) Get the quality gate results for a pipeline step **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<PipelineStepMetrics>](#PipelineStepMetrics) - the execution | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | executionId | string | the execution id | | action | string | the action name | ### cloudManagerAPI.init(orgId, apiKey, accessToken, baseUrl) ⇒ [Promise.<CloudManagerAPI>](#CloudManagerAPI) Initializes a CloudManagerAPI object and returns it. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<CloudManagerAPI>](#CloudManagerAPI) - a CloudManagerAPI object | Param | Type | Description | | --- | --- | --- | | orgId | string | the organization id | | apiKey | string | the API key for your integration | | accessToken | string | the access token for your integration | | baseUrl | string | the base URL to access the API (defaults to https://cloudmanager.adobe.io) | ### cloudManagerAPI.invalidatePipelineCache(programId, pipelineId) ⇒ Promise.<object> Invalidate the cache for a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy object | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | ### cloudManagerAPI.listAvailableLogOptions(programId, environmentId) ⇒ Promise.<Array.<LogOptionRepresentation>> List the log options available for an environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<LogOptionRepresentation>> - the log options for the environment | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | environmentId | string | the environment id | ### cloudManagerAPI.listContentFlows(programId) ⇒ Promise.<Array.<ContentFlow>> List content flows for program **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<ContentFlow>> - an array of content flows | Param | Type | Description | | --- | --- | --- | | programId | string | The program id | ### cloudManagerAPI.listContentSets(programId) ⇒ Promise.<Array.<ContentSet>> List Content Sets for program **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<ContentSet>> - list of the content sets for the program | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | ### cloudManagerAPI.listEnvironments(programId) ⇒ Promise.<Array.<Environment>> List environments for a program **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<Environment>> - a list of environments | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | ### cloudManagerAPI.listExecutions(programId, pipelineId, limit) ⇒ Promise.<Array.<PipelineExecution>> List the most recent executions for a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<PipelineExecution>> - the list of executions | Param | Type | Default | Description | | --- | --- | --- | --- | | programId | string | | the program id | | pipelineId | string | | the pipeline id | | limit | number | 20 | the maximum number of executions to return (defaults to 20) | ### cloudManagerAPI.listIpAllowlists(programId) ⇒ [Promise.<IPAllowedList>](#IPAllowedList) List the program's defined IP Allow Lists **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<IPAllowedList>](#IPAllowedList) - - the IP Allow Lists | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | ### cloudManagerAPI.listPipelines(programId, options) ⇒ Promise.<Array.<Pipeline>> Obtain a list of pipelines for the target program. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<Pipeline>> - an array of Pipelines | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | options | [ListPipelineOptions](#ListPipelineOptions) | options | ### cloudManagerAPI.listPrograms() ⇒ Promise.<Array.<EmbeddedProgram>> Obtain a list of programs for the target organization. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<Array.<EmbeddedProgram>> - an array of Programs ### cloudManagerAPI.removeIpAllowlistBinding(programId, ipAllowlistId, environmentId, service) ⇒ Promise.<object> Unbind an IP Allow List from an environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | ipAllowlistId | string | the allow list id | | environmentId | string | the environment id | | service | string | the service name | ### cloudManagerAPI.setEnvironmentVariables(programId, environmentId, variables) ⇒ Promise.<object> Set the variables for an environment **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | environmentId | string | the environment id | | variables | [Array.<Variable>](#Variable) | the variables | ### cloudManagerAPI.setPipelineVariables(programId, pipelineId, variables) ⇒ Promise.<object> Set the variables for a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | variables | [Array.<Variable>](#Variable) | the variables | ### ~~cloudManagerAPI.startExecution(programId, pipelineId, mode) ⇒ Promise.<string>~~ ***Deprecated*** Start an execution for a pipeline, returning the url of the new execution **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<string> - the execution url | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | mode | string | the pipeline execution mode | ### cloudManagerAPI.tailExecutionStepLog(programId, pipelineId, action, logFile, outputStream) ⇒ [Promise.<PipelineExecutionStepState>](#PipelineExecutionStepState) Tail step log to an output stream. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<PipelineExecutionStepState>](#PipelineExecutionStepState) - the completed step state | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | action | string | the action | | logFile | string | the log file to select a non-default value | | outputStream | object | the output stream to write to | ### cloudManagerAPI.updateContentSet(programId, contentSetId, updatedContentSet) ⇒ [Promise.<ContentSet>](#ContentSet) Update the content set definition. The operation is a PUT, so the entire body has to be provided. **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<ContentSet>](#ContentSet) - the updated content set | Param | Type | Description | | --- | --- | --- | | programId | string | The program id | | contentSetId | string | The content set id | | updatedContentSet | string | the body (JSON format) | ### cloudManagerAPI.updateIpAllowlist(programId, ipAllowlistId, cidrBlocks) ⇒ Promise.<object> Update the CIDR blocks of an IP Allow List **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: Promise.<object> - a truthy value | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | ipAllowlistId | string | the allow list id | | cidrBlocks | Array.<string> | the replacement CIDR blocks | ### cloudManagerAPI.updatePipeline(programId, pipelineId, changes) ⇒ [Promise.<Pipeline>](#Pipeline) Update a pipeline **Kind**: instance method of [CloudManagerAPI](#CloudManagerAPI) **Returns**: [Promise.<Pipeline>](#Pipeline) - the new pipeline definition | Param | Type | Description | | --- | --- | --- | | programId | string | the program id | | pipelineId | string | the pipeline id | | changes | [PipelineUpdate](#PipelineUpdate) | the changes | ## getCurrentStep(execution) ⇒ [PipelineExecutionStepState](#PipelineExecutionStepState) Find the first non-finished step in a pipeline execution **Kind**: global function **Returns**: [PipelineExecutionStepState](#PipelineExecutionStepState) - the step state or a falsy object if all steps are finished | Param | Type | Description | | --- | --- | --- | | execution | [PipelineExecution](#PipelineExecution) | the execution | ## getWaitingStep(execution) ⇒ [PipelineExecutionStepState](#PipelineExecutionStepState) Find the first waiting step in a pipeline execution **Kind**: global function **Returns**: [PipelineExecutionStepState](#PipelineExecutionStepState) - the step state or a falsy object if no step is waiting | Param | Type | Description | | --- | --- | --- | | execution | [PipelineExecution](#PipelineExecution) | the execution | ## init(orgId, apiKey, accessToken, baseUrl) ⇒ [Promise.<CloudManagerAPI>](#CloudManagerAPI) Returns a Promise that resolves with a new CloudManagerAPI object. **Kind**: global function **Returns**: [Promise.<CloudManagerAPI>](#CloudManagerAPI) - a Promise with a CloudManagerAPI object | Param | Type | Description | | --- | --- | --- | | orgId | string | the organization id | | apiKey | string | the API key for your integration | | accessToken | string | the access token for your integration | | baseUrl | string | the base URL to access the API (defaults to https://cloudmanager.adobe.io) | ## EmbeddedProgram : object A lightweight representation of a Program **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | Identifier of the program. Unique within the space. | | name | string | Name of the program | | enabled | boolean | Whether this Program has been enabled for Cloud Manager usage | | tenantId | string | Tenant Id | | status | string | Status of the program | | createdAt | string | Created time | | updatedAt | string | Date of last change | ## Pipeline : object A representation of a CI/CD Pipeline **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | Identifier of the pipeline. Unique within the program. | | programId | string | Identifier of the program. Unique within the space. | | name | string | Name of the pipeline | | trigger | string | How should the execution be triggered. ON_COMMIT: each time one or more commits are pushed and the Pipeline is idle then a execution is triggered. MANUAL: triggerd through UI or API. | | status | string | Pipeline status | | createdAt | string | Create date | | updatedAt | string | Update date | | lastStartedAt | string | Last pipeline execution start | | lastFinishedAt | string | Last pipeline execution end | | phases | [Array.<PipelinePhase>](#PipelinePhase) | Pipeline phases in execution order | | type | string | Pipeline type | ## PipelinePhase : object Describes a phase of a pipeline **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | name | string | Name of the phase | | type | string | Type of the phase | | repositoryId | string | Identifier of the source repository. The code from this repository will be build at the start of this phase. Mandatory if type=BUILD | | branch | string | Name of the tracked branch or a fully qualified git tag (e.g. refs/tags/v1). Assumed to be `master` if missing. | | environmentId | string | Identifier of the target environment. Mandatory if type=DEPLOY | | environmentType | string | Type of environment (for example stage or prod, readOnly = true) | | steps | Array.<PipelineStep> | Steps to be included in the phase in execution order. Might be added or not, depending on permissions or configuration | ## PipelineExecution : object A representation of an execution of a CI/CD Pipeline. **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | Pipeline execution identifier | | programId | string | Identifier of the program. Unique within the space. | | pipelineId | string | Identifier of the pipeline. Unique within the space. | | artifactsVersion | string | Version of the artifacts generated during this execution | | user | string | AdobeID who started the pipeline. Empty for auto triggered builds | | status | string | Status of the execution | | trigger | string | How the execution was triggered. | | pipelineExecutionMode | string | The mode in which the execution occurred. EMERGENCY mode will skip certain steps and is only available to select AMS customers | | createdAt | string | Timestamp at which the execution was created | | updatedAt | string | Timestamp at which the status of the execution last changed | | finishedAt | string | Timestamp at which the execution completed | | pipelineType | string | Pipeline type | ## PipelineExecutionStepState : object Describes the status of a particular pipeline execution step for display purposes **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | | | stepId | string | | | phaseId | string | | | action | string | Name of the action | | repository | string | Target repository | | branch | string | Target branch | | environment | string | Target environment | | environmentId | string | Target environment id | | environmentType | string | Target environment type | | startedAt | string | Timestamp at which the step state started running | | finishedAt | string | Timestamp at which the step completed | | commitId | string | Target commit id | | details | object | Additional details of the step | | status | string | Action status | ## PipelineStepMetrics : object **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | metrics | [Array.<Metric>](#Metric) | metrics | ## Metric : object A representation of a specific metric generated by a CI/CD Pipeline step. **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | KPI result identifier | | severity | string | Severity of the metric | | passed | boolean | Whether metric is considered passed | | override | boolean | Whether user override the failed metric | | actualValue | string | Expected value for the metric | | expectedValue | string | Expected value for the metric | | comparator | string | Comparator used for the metric | | kpi | string | KPI identifier | ## Environment : object A representation of an Environment known to Cloud Manager. **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | id | | programId | string | Identifier of the program. Unique within the space. | | name | string | Name of the environment | | description | string | Description of the environment | | type | string | Type of the environment | | status | string | Status of the environment | | region | string | Region of the environment | | availableLogOptions | [Array.<LogOptionRepresentation>](#LogOptionRepresentation) | List of logs available in the environment | ## Variable : object A named value than can be set on an Environment or Pipeline **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | name | string | Name of the variable. Can only consist of a-z, A-Z, _ and 0-9 and cannot begin with a number. | | value | string | Value of the variable. Read-Write for non-secrets, write-only for secrets. The length of `secretString` values must be less than 500 characters. An empty value causes a variable to be deleted. | | type | string | Type of the variable. Default `string` if missing. `secretString` variables are encrypted at rest. The type of a variable be changed after creation; the variable must be deleted and recreated. | | service | string | Service of the variable. When not provided, the variable applies to all services. Currently the values 'author', 'publish', and 'preview' are supported. Note - this value is case-sensitive. | | status | string | Status of the variable | ## ContentSet : object A representation of a ContentSet custom **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | string | Identifier of the Content Set | | name | string | The name of the content set | | paths | Array.<ContentSetPath> | Included asset paths | | programId | string | Identifier of the program. Unique within the space. | | createdAt | string | Create date | | updatedAt | string | Update date | ## ContentFlow : object The Content Flow Execution **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | contentSetId | string | The content set id | | contentSetName | string | The content set name | | srcEnvironmentId | string | Source environment id | | srcEnvironmentName | string | Source environment name | | destEnvironmentId | string | Destination environment id | | destEnvironmentName | string | Destination environment name | | tier | string | The tier, for example author | | status | string | Status of the flows | | destProgramId | string | Destination program id | | resultDetails | undefined | Details of this content flow result | ## LogOptionRepresentation : object **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | service | string | Name of the service in environment. Example: author | | name | string | Name of the log for service in environment. Example: aemerror | ## IPAllowedListBinding : object Describes an __IP Allowed List Binding__ **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | integer | Identifier of the IP Allowed List Binding to an Environment | | tier | string | Tier of the environment. | | status | string | Status of the binding. | | programId | integer | Identifier of the program. | | ipAllowListId | integer | Identifier of the IP allow list. | | environmentId | integer | Identifier of the environment. | ## IPAllowedList : object Describes an __IP Allowed List__ **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | id | integer | Identifier of the IP Allowed List | | name | string | Name of the IP Allowed List | | programId | integer | Identifier of the program. | | ipCidrSet | Array.<string> | IP CIDR Set | | bindings | [Array.<IPAllowedListBinding>](#IPAllowedListBinding) | IP Allowlist bindings | ## ListPipelineOptions : object Options to the listPipeline function **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | busy | boolean | if true, only busy pipelines will be returned | ## DownloadedLog : object **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | path | string | the path where the log was stored | | url | string | the url of the log that was downloaded | ## PipelineUpdate : object **Kind**: global typedef **Properties** | Name | Type | Description | | --- | --- | --- | | branch | string | the new branch | | repositoryId | string | the new repository id | | devEnvironmentId | string | the new dev environment id | | stageEnvironmentId | string | the new stage environment id | | prodEnvironmentId | string | the new prod environment id | ### Debug Logs ```bash LOG_LEVEL=debug ``` Prepend the `LOG_LEVEL` environment variable and `debug` value to the call that invokes your function, on the command line. This should output a lot of debug data for your SDK calls. ### Contributing Contributions are welcome! Read the [Contributing Guide](./.github/CONTRIBUTING.md) for more information. ### Licensing This project is licensed under the Apache V2 License. See [LICENSE](LICENSE) for more information.