API standard and pre-built SDKs in multi-language
The OpenAPI specification of this product (oos/2019-06-01) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.
Custom signature
If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).
Before you begin
An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. To call APIs securely, create a Resource Access Management (RAM) user with API access only, configure its AccessKey pairs, and implement the principle of least privilege (PoLP) through RAM policies. Use the Alibaba Cloud account only when its permissions are explicitly required for specific scenarios.
Template
|
API |
Title |
Description |
| DeleteTemplates | DeleteTemplates | Deletes multiple templates. |
| DeleteTemplate | DeleteTemplate | Deletes a template. |
| ListTemplateVersions | ListTemplateVersions | Lists the versions of a specified template. |
| 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. |
Execution
|
API |
Title |
Description |
| StartExecution | StartExecution | Starts an execution. |
| GenerateExecutionPolicy | GenerateExecutionPolicy | Queries the RAM policy required to execute a template. |
Parameter
|
API |
Title |
Description |
| Common Parameter | Common Parameter | |
| DeleteParameter | DeleteParameter | Deletes common parameter. |
| GetParameter | GetParameter | Queries a standard or common parameter and its value. |
| 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. |
| Secret Parameter | Secret Parameter | |
| DeleteSecretParameter | DeleteSecretParameter | Deletes an encrypted parameter. This operation requires permission to call the Key Management Service (KMS) DeleteSecret API. |
| 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). |
| 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 | |
| DeletePatchBaseline | DeletePatchBaseline | Deletes a patch baseline. |
| GetPatchBaseline | GetPatchBaseline | Queries the details of a patch baseline. |
Inventory
|
API |
Title |
Description |
| SearchInventory | SearchInventory | Queries for detailed or aggregated information about inventory. |
Application Management
|
API |
Title |
Description |
| Application Group | Application Group | |
| 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. |
Tag
|
API |
Title |
Description |
| ListTagValues | ListTagValues | Lists the values of created tags. |
Extentions
|
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. |
Other
|
API |
Title |
Description |
| GetTemplateParameterConstraints | GetTemplateParameterConstraints | Retrieves the allowed values for parameters. |
Others
|
API |
Title |
Description |
| CancelExecution | CancelExecution | Cancels an execution. |
| ChangeResourceGroup | ChangeResourceGroup | Modifies the resource group to which a cloud resource belongs. |
| CheckGitRepoFileExists | CheckGitRepoFileExists | Checks whether a file exists in a repository. |
| CheckGitRepositoryExists | CheckGitRepositoryExists | Checks whether a repository exists. |
| 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. |
| 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. |
| 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. |
| CreateGitRepository | CreateGitRepository | Creates a Git repository. |
| CreateOpsItem | CreateOpsItem | Creates an O\\\\\\\\\\&M Item. |
| CreateParameter | CreateParameter | Creates a common parameter. |
| CreatePatchBaseline | CreatePatchBaseline | Creates a patch baseline. |
| 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. |
| CreateStateConfiguration | CreateStateConfiguration | Creates a desired-state configuration. |
| CreateTemplate | CreateTemplate | Creates a template. |
| 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. |
| 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. |
| DeleteExecutions | DeleteExecutions | Deletes executions. |
| DeleteOpsItems | DeleteOpsItems | Deletes O\\\&M Items. |
| DeleteStateConfigurations | DeleteStateConfigurations | Deletes multiple desired-state configurations at a time. |
| DescribeApplicationGroupBill | DescribeApplicationGroupBill | Queries the resource costs of an application group. |
| DescribeRegions | DescribeRegions | Queries supported regions. |
| GenerateOpsItem | GenerateOpsItem | Generates an O\\\&M item. |
| 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. |
| GetChatConfiguration | GetChatConfiguration | Creates, updates, retrieves, and deletes chat configurations for platforms such as DingTalk. |
| GetExecutionTemplate | GetExecutionTemplate | Queries the information about the template of an execution, including the content of the template. |
| GetGitBranch | GetGitBranch | Queries the details of a Git branch. You can query public repositories without authorization. |
| GetGitRepository | GetGitRepository | Queries the details of a Git repository. |
| GetInventorySchema | GetInventorySchema | Queries the properties of a configuration list. |
| GetOpsItem | GetOpsItem | Queries the details of an O\\\\\\\\\\&M item. |
| GetServiceSettings | GetServiceSettings | Queries the service settings, including the configuration of delivering template execution records and the associated organization ID. |
| ListActions | ListActions | Queries the available actions, including atomic actions and cloud product actions. |
| 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. |
| ListChatConfigurations | ListChatConfigurations | Creates, updates, retrieves, and deletes chat configurations for platforms such as DingTalk. |
| ListExecutionLogs | ListExecutionLogs | Queries the logs of an execution. |
| ListExecutions | ListExecutions | Queries executions. Multiple methods are supported to filter executions. |
| 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. |
| ListGitOrganizations | ListGitOrganizations | Retrieves the Git organizations for an authorized user. |
| ListGitRepositories | ListGitRepositories | Lists Git repositories. |
| ListGitRepositoryContents | ListGitRepositoryContents | Lists the files and directories in a repository. |
| ListInstancePatchStates | ListInstancePatchStates | Queries the information about the patches of an instance. |
| ListInstancePatches | ListInstancePatches | Queries the patches of an instance. |
| ListInventoryEntries | ListInventoryEntries | Queries the configurations of an Elastic Compute Service (ECS) instance. |
| ListOpsItems | ListOpsItems | Queries O\\\&M items. |
| ListParameters | ListParameters | Queries common parameters. Multiple methods are supported to filter common parameters. |
| ListPatchBaselines | ListPatchBaselines | Queries a list of patch baselines. |
| ListResourceExecutionStatus | ListResourceExecutionStatus | Queries the information about a scheduled execution that involves O\&M operations on Elastic Compute Service (ECS) instances. |
| ListSecretParameters | ListSecretParameters | Queries common parameters. Multiple types of queries are supported. |
| ListStateConfigurations | ListStateConfigurations | Queries desired-state configurations. |
| ListTagKeys | ListTagKeys | Queries the tags. |
| ListTagResources | ListTagResources | Queries the tags that are added to one or more resources. |
| ListTaskExecutionInvocations | ListTaskExecutionInvocations | Retrieves the execution IDs of Cloud Assistant commands for a task execution. |
| ListTaskExecutions | ListTaskExecutions | Queries task executions. Multiple methods are supported to filter task executions. |
| ListTemplates | ListTemplates | Queries templates. Multiple methods are supported to filter templates. |
| NotifyExecution | NotifyExecution | Notifies an execution in the Waiting state of the subsequent operations. |
| RegisterDefaultPatchBaseline | RegisterDefaultPatchBaseline | Registers the default patch baseline. |
| SetServiceSettings | SetServiceSettings | Enables or disables the feature of delivering template execution records and sets the storage location and organization ID. |
| StartDebugExecution | StartDebugExecution | Starts a debug execution. |
| TagResources | TagResources | Adds tags to one or more resources. |
| 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. |
| UntagResources | UntagResources | Removes tags from one or more resources. |
| 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. |
| UpdateChatConfiguration | UpdateChatConfiguration | Creates, updates, queries, and deletes chat configurations for platforms such as DingTalk. |
| UpdateExecution | UpdateExecution | Updates an execution in the Running or Waiting state. |
| UpdateOpsItem | UpdateOpsItem | Modifies an O\\\\\\\\\\&M item. |
| UpdateParameter | UpdateParameter | Updates a common parameter. |
| UpdatePatchBaseline | UpdatePatchBaseline | Updates a patch baseline. |
| 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. |
| UpdateStateConfiguration | UpdateStateConfiguration | Updates a desired-state configuration. |
| UpdateTemplate | UpdateTemplate | Updates the information about an existing template. |
| UpdateTemplateAttributes | UpdateTemplateAttributes | Updates the attributes of a template. |