API standards and multilingual preset SDKs
The OpenAPI of this product (oos/2019-06-01) uses the RPC signature style. We have encapsulated SDKs for common programming languages for developers. Developers can download the SDK to directly call this product's OpenAPI without worrying about technical details. If the existing SDK does not meet your needs, you can use the signature mechanism for self-signing integration. Since the details of self-signing are very complex, it may take around 5 business days. Therefore, we recommend joining our DingTalk service group (147535001692) and conducting signature integration under expert guidance.
Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (such as SDK and CLI). For details, see Obtain an AccessKey.
Custom signature scenarios
If your business scenario has special requirements and you need to integrate the API through self-signing, we recommend consulting our technical support team first (DingTalk service group: 147535001692) to obtain professional guidance and ensure efficient integration.
Account and security preparation
Alibaba Cloud accounts have full administrative permissions over all resources. Once an AccessKey is compromised, all associated resources will be at risk of unauthorized access. To ensure security, it is recommended to create a RAM user with only API access permissions and configure its AccessKey, while configuring RAM policies based on the principle of least privilege (PoLP). Use the Alibaba Cloud account only in specific scenarios where Alibaba Cloud account permissions are explicitly required.
Region
|
API |
Title |
Description |
| GetGitRepository | GetGitRepository | Queries the details of a Git repository. |
| DescribeRegions | DescribeRegions | Queries supported regions. |
Template
|
API |
Title |
Description |
| CreateTemplate | CreateTemplate | Creates a template. |
| DeleteTemplates | DeleteTemplates | Deletes multiple templates. |
| DeleteTemplate | DeleteTemplate | Deletes a template. |
| UpdateTemplate | UpdateTemplate | Updates the information about an existing template. |
| ListTemplateVersions | ListTemplateVersions | Lists the versions of a specified template. |
| ListTemplates | ListTemplates | Queries templates. Multiple methods are supported to filter templates. |
| GetTemplate | GetTemplate | Retrieves a template, including its content. |
| ListExecutionRiskyTasks | ListExecutionRiskyTasks | Lists the high-risk tasks in a template. |
| ValidateTemplateContent | ValidateTemplateContent | Validates the syntax of a template. |
| UpdateTemplateAttributes | UpdateTemplateAttributes | Updates the attributes of a template. |
| GetTemplateParameterConstraints | GetTemplateParameterConstraints | Retrieves the allowed values for parameters. |
Execution
|
API |
Title |
Description |
| DeleteExecutions | DeleteExecutions | Deletes executions. |
| StartExecution | StartExecution | Starts an execution. |
| UpdateExecution | UpdateExecution | Updates an execution in the Running or Waiting state. |
| GetExecutionTemplate | GetExecutionTemplate | Queries the information about the template of an execution, including the content of the template. |
| ListExecutions | ListExecutions | Lists query executions and supports multiple filters. |
| ListExecutionLogs | ListExecutionLogs | Returns the logs for an execution. |
| ListTaskExecutions | ListTaskExecutions | Queries task executions using multiple filters. |
| ListResourceExecutionStatus | ListResourceExecutionStatus | Queries the information about a scheduled execution that involves O\&M operations on Elastic Compute Service (ECS) instances. |
| CancelExecution | CancelExecution | Cancels an execution. |
| GenerateExecutionPolicy | GenerateExecutionPolicy | Queries the RAM policy required to execute a template. |
| NotifyExecution | NotifyExecution | Notifies an execution in the Waiting state of the subsequent operations. |
| TriggerExecution | TriggerExecution | Debugs a started execution that contains an event trigger task or alert trigger task. If the operation is called, a message body is sent to the event trigger task or alert trigger task. After the trigger task receives the message body, the trigger task generates a new child execution. |
| StartDebugExecution | StartDebugExecution | Starts a debug execution. |
Action
|
API |
Title |
Description |
| ListActions | ListActions | Queries the available actions, including atomic actions and cloud product actions. |
Parameter
|
API |
Title |
Description |
| Common parameter | Common parameter | |
| CreateParameter | CreateParameter | Creates a common parameter. |
| DeleteParameter | DeleteParameter | Deletes common parameter. |
| UpdateParameter | UpdateParameter | Updates a common parameter. |
| GetParameter | GetParameter | Queries a standard or common parameter and its value. |
| ListParameters | ListParameters | Queries common parameters. Multiple methods are supported to filter common parameters. |
| ListParameterVersions | ListParameterVersions | Lists the versions of a specified standard parameter. |
| GetParametersByPath | GetParametersByPath | Queries the parameters by path. |
| GetParameters | GetParameters | Queries the details of one or more parameters. |
| Encrypted parameter | Encrypted parameter | |
| CreateSecretParameter | CreateSecretParameter | Creates an encryption parameter. Make sure that you have the permissions to call the CreateSecret operation of Key Management Service (KMS) before you call this operation. |
| DeleteSecretParameter | DeleteSecretParameter | Deletes an encrypted parameter. This operation requires permission to call the Key Management Service (KMS) DeleteSecret API. |
| UpdateSecretParameter | UpdateSecretParameter | Updates an encryption parameter. Make sure that you have the permissions to call the UpdateSecretValue operation of Key Management Service (KMS) before you call this operation. |
| GetSecretParameter | GetSecretParameter | Queries an encrypted parameter, including its value. Before you call this operation, ensure that you have the permissions to call the GetSecretValue API operation of Key Management Service (KMS). |
| ListSecretParameters | ListSecretParameters | Queries common parameters. Multiple types of queries are supported. |
| ListSecretParameterVersions | ListSecretParameterVersions | Queries multiple versions of a encrypted parameter. |
| GetSecretParametersByPath | GetSecretParametersByPath | Retrieves encrypted parameters by path. Before you call this operation, ensure that you have permission to call the GetSecretValue operation of Key Management Service (KMS). |
| GetSecretParameters | GetSecretParameters | Queries the details of one or more encrypted parameters. You must have permission to call GetSecretValue API of Key Management Service (KMS) to use this operation. |
Patch management
|
API |
Title |
Description |
| Patch baseline | Patch baseline | |
| CreatePatchBaseline | CreatePatchBaseline | Creates a patch baseline. |
| DeletePatchBaseline | DeletePatchBaseline | Deletes a patch baseline. |
| UpdatePatchBaseline | UpdatePatchBaseline | Updates a patch baseline. |
| GetPatchBaseline | GetPatchBaseline | Queries the details of a patch baseline. |
| ListPatchBaselines | ListPatchBaselines | Queries a list of patch baselines. |
| RegisterDefaultPatchBaseline | RegisterDefaultPatchBaseline | Registers the default patch baseline. |
| Patch status | Patch status | |
| ListInstancePatchStates | ListInstancePatchStates | Retrieves the patch state of one or more instances. |
| ListInstancePatches | ListInstancePatches | Lists the patches for a specified instance. |
Configuration inventory
|
API |
Title |
Description |
| ListInventoryEntries | ListInventoryEntries | Queries the configurations of an Elastic Compute Service (ECS) instance. |
| GetInventorySchema | GetInventorySchema | Queries the properties of a configuration list. |
| SearchInventory | SearchInventory | Queries for detailed or aggregated information about inventory. |
Desired state configuration
|
API |
Title |
Description |
| CreateStateConfiguration | CreateStateConfiguration | Creates a desired-state configuration. |
| DeleteStateConfigurations | DeleteStateConfigurations | Deletes multiple desired-state configurations at a time. |
| UpdateStateConfiguration | UpdateStateConfiguration | Updates a desired-state configuration. |
| ListStateConfigurations | ListStateConfigurations | Queries desired-state configurations. |
O&M item
|
API |
Title |
Description |
| CreateOpsItem | CreateOpsItem | Creates an O\\\\\\\\\\&M Item. |
| GetOpsItem | GetOpsItem | Queries the details of an O\\\\\\\\\\&M item. |
| ListOpsItems | ListOpsItems | Queries O\\\&M items. |
| UpdateOpsItem | UpdateOpsItem | Modifies an O\\\\\\\\\\&M item. |
| DeleteOpsItems | DeleteOpsItems | Deletes O\\\&M Items. |
| GenerateOpsItem | GenerateOpsItem | Generates an O\\\&M item. |
Service configuration
|
API |
Title |
Description |
| SetServiceSettings | SetServiceSettings | Enables or disables template execution record delivery, configures delivery destinations, and associates an Apsara DevOps enterprise ID. |
| GetServiceSettings | GetServiceSettings | Retrieves the service's configuration settings, including the delivery configuration for executions and details about associated Apsara DevOps enterprises. |
Application management
|
API |
Title |
Description |
| Application | Application | |
| CreateApplication | CreateApplication | Creates an application. You can call this operation only for the applications that reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| DeleteApplication | DeleteApplication | Deletes an application. You can call this operation only for the applications that reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| UpdateApplication | UpdateApplication | Updates an application. You can call this operation only for the applications that reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| GetApplication | GetApplication | Queries the information of an application. You can call this operation only for the applications that reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| ListApplications | ListApplications | Queries a list of applications. You can call this operation only for the applications that reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| ListDeployRevisions | ListDeployRevisions | Lists the revisions for an application. |
| CreateDeployRevision | CreateDeployRevision | Creates a deployment revision. |
| GetDeployRevision | GetDeployRevision | Retrieves the details of an application revision. |
| Application group | Application group | |
| CreateApplicationGroup | CreateApplicationGroup | Creates an application group. You can call this operation only for the application groups that reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| DeleteApplicationGroup | DeleteApplicationGroup | Deletes an application group. You can call this operation only for the application groups which reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| UpdateApplicationGroup | UpdateApplicationGroup | Updates the information of an application group. The Application Management service is available only in the China (Hangzhou) region, and you must use the endpoint of this region. |
| GetApplicationGroup | GetApplicationGroup | Retrieves the details of an application group. Application Management is available only in the China (Hangzhou) region. You must use the endpoint for this region. |
| ListApplicationGroups | ListApplicationGroups | Queries a list of application groups. The Application Management feature is available only in the China (Hangzhou) region. Ensure that you use the endpoint for this region. |
| DeployApplicationGroup | DeployApplicationGroup | Deploys an application group. Application Management is available only in the China (Hangzhou) region. You must use the endpoint for the China (Hangzhou) region. |
| ContinueDeployApplicationGroup | ContinueDeployApplicationGroup | Continues deploying an application group when an error occurs for calling the DeployApplicationGroup operation. You can call this operation only for the applications which reside in the China (Hangzhou) region. Use an endpoint of the China (Hangzhou) region. |
| DescribeApplicationGroupBill | DescribeApplicationGroupBill | Queries the resource costs of an application group. |
Git
|
API |
Title |
Description |
| CheckGitRepoFileExists | CheckGitRepoFileExists | Checks whether a file exists in a repository. |
| ListGitOrganizations | ListGitOrganizations | Retrieves the Git organizations for an authorized user. |
| ListGitRepositories | ListGitRepositories | Lists Git repositories. |
| CreateGitRepository | CreateGitRepository | Creates a Git repository. |
| ListGitAccounts | ListGitAccounts | Lists the Git accounts authorized by the current Alibaba Cloud user for Application Management. |
| ListGitBranches | ListGitBranches | Lists all branches of a specified Git repository. |
| CheckGitRepositoryExists | CheckGitRepositoryExists | Checks whether a repository exists. |
| GetGitBranch | GetGitBranch | Queries the details of a Git branch. You can query public repositories without authorization. |
| ListGitRepositoryContents | ListGitRepositoryContents | Lists the files and directories in a repository. |
Tag
|
API |
Title |
Description |
| ListTagKeys | ListTagKeys | Queries the tags. |
| ListTagValues | ListTagValues | Lists the values of created tags. |
| ListTagResources | ListTagResources | Queries the tags that are added to one or more resources. |
| UntagResources | UntagResources | Removes tags from one or more resources. |
| TagResources | TagResources | Adds tags to one or more resources. |
Resource group
|
API |
Title |
Description |
| ChangeResourceGroup | ChangeResourceGroup | Modifies the resource group to which a cloud resource belongs. |
Extension
|
API |
Title |
Description |
| UpdateInstancePackageState | UpdateInstancePackageState | Updates the state of an extension installed on an instance. |
| ListInstancePackageStates | ListInstancePackageStates | Lists the status of each package on an instance. |
AI assistant configuration
|
API |
Title |
Description |
| CreateChatConfiguration | CreateChatConfiguration | You can create, update, query, and delete chat configurations for platforms such as DingTalk. |
| UpdateChatConfiguration | UpdateChatConfiguration | Creates, updates, queries, and deletes chat configurations for platforms such as DingTalk. |
| GetChatConfiguration | GetChatConfiguration | Creates, updates, retrieves, and deletes chat configurations for platforms such as DingTalk. |
| ListChatConfigurations | ListChatConfigurations | Creates, updates, retrieves, and deletes chat configurations for platforms such as DingTalk. |
| DeleteChatConfiguration | DeleteChatConfiguration | Use this operation to create, update, query, and delete chat configurations for platforms such as DingTalk. |
Other
|
API |
Title |
Description |
| ListTaskExecutionInvocations | ListTaskExecutionInvocations | Retrieves the execution IDs of Cloud Assistant commands for a task execution. |