---
updatedAt: 2026-04-21T03:40:36.000Z
agentTools:
  projectIndex: https://docs.ternary.app/llms.txt
---

# Update Alibaba integration

Update an existing Alibaba Cloud data integration.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Core API",
    "description": "Ternary Resource Management API",
    "version": "1.0.0",
    "contact": {},
    "license": {
      "name": "MIT",
      "identifier": "MIT"
    }
  },
  "tags": [
    {
      "name": "Data Integration: Alibaba",
      "description": "Manage Alibaba Cloud data integrations."
    }
  ],
  "servers": [
    {
      "url": "https://core-api.ternary.app/api",
      "description": "Core API"
    },
    {
      "url": "https://core-api.eu.ternary.app/api",
      "description": "Core API (EU)"
    }
  ],
  "externalDocs": {
    "description": "Raw JSON",
    "url": "https://core-api.ternary.app/api/docs.json"
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "FailureResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP status code",
            "example": "400 - Bad Request"
          },
          "message": {
            "type": "string",
            "description": "Error message",
            "example": "ERROR_INVALID_PARAMS"
          },
          "reason": {
            "type": "string",
            "description": "Error reason code"
          }
        },
        "required": [
          "code",
          "message"
        ]
      },
      "UpdateDataIntegrationResponseBody": {
        "type": "object",
        "properties": {
          "integrationID": {
            "type": "string"
          }
        },
        "required": [
          "integrationID"
        ]
      },
      "UpdateAlibabaIntegrationRequestBody": {
        "type": "object",
        "properties": {
          "costAndUsageReports": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Cost and usage report name"
                },
                "region": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Cost and usage report region"
                },
                "reportPathPrefix": {
                  "type": "string",
                  "description": "Cost and usage report path prefix"
                },
                "s3BucketName": {
                  "type": "string",
                  "description": "Cost and usage reoprt s3 bucket name"
                }
              },
              "required": [
                "name",
                "region",
                "reportPathPrefix",
                "s3BucketName"
              ]
            }
          },
          "roleARN": {
            "type": "string",
            "description": "Role ARN"
          },
          "name": {
            "type": "string",
            "description": "Cloud integration name"
          }
        }
      }
    }
  },
  "paths": {
    "/data-integrations/alibaba/{integrationID}": {
      "patch": {
        "summary": "Update Alibaba integration",
        "tags": [
          "Data Integration: Alibaba"
        ],
        "operationId": "updateAlibabaIntegration",
        "description": "Update an existing Alibaba Cloud data integration.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "Unique integration ID",
              "example": "5urDCEWi8GDPPdqmLhUF"
            },
            "required": true,
            "description": "Unique integration ID",
            "name": "integrationID",
            "in": "path"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAlibabaIntegrationRequestBody"
              },
              "examples": {
                "updateAlibabaIntegration": {
                  "value": {
                    "costAndUsageReports": [
                      {
                        "name": "alibaba-cur",
                        "region": "cn-hangzhou",
                        "reportPathPrefix": "reports/cur",
                        "s3BucketName": "alibaba-billing"
                      }
                    ],
                    "roleARN": "acs:ram::536868854562:role/test-cmp-service-agent",
                    "name": "Updated Production Alibaba"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateDataIntegrationResponseBody"
                },
                "examples": {
                  "updateAlibabaIntegration": {
                    "value": {
                      "integrationID": "5urDCEWi8GDPPdqmLhUF"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "400Response": {
                    "value": {
                      "code": "400 - Bad Request",
                      "message": "ERROR_INVALID_PARAMS"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "401Response": {
                    "value": {
                      "code": "401 - Unauthorized",
                      "message": "ERROR_UNAUTHORIZED"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "403Response": {
                    "value": {
                      "code": "403 - Forbidden",
                      "message": "ERROR_PERMISSION_DENIED"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "The target integration or its tenant does not exist.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "404Response": {
                    "value": {
                      "code": "404 - Not Found",
                      "message": "HTTP/ERROR",
                      "reason": "UpdateAlibabaIntegrationCommandFailure/INTEGRATION_NOT_FOUND"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Core API",
      "tags": [
        "Alert Rule",
        "Alert Rule Events",
        "API Keys",
        "AWS Rate Recommendations",
        "Azure Rate Recommendations",
        "Billing Rules",
        "Budget",
        "Cases",
        "Cost Alerts",
        "Custom Label",
        "Custom Measures",
        "Data Integration",
        "Data Integration: Alibaba",
        "Data Integration: AWS",
        "Data Integration: Azure",
        "Data Integration: Custom Data",
        "Data Integration: Databricks",
        "Data Integration: GCP",
        "Data Integration: Oracle",
        "Data Integration: Snowflake",
        "Dimension Preferences",
        "GCP Rate Recommendations",
        "Integrations",
        "Label Map",
        "MCP Availability",
        "MCP Client Usage",
        "Measure Preferences",
        "MSP Billing Information",
        "MSP Child",
        "MSP Shared Payer Integrations",
        "MSP Tenant Settings",
        "Permissions",
        "Ramp Plans",
        "Report",
        "Resource Subscriptions",
        "Role",
        "Savings Opportunity Filter",
        "Scoped View",
        "Support Tickets",
        "Tenant",
        "Tenant SSO Config",
        "Usage Recommendations",
        "User",
        "User Group Config"
      ]
    }
  ]
}
```