All Products
Search
Document Center

CloudOps Orchestration Service:StartExecution

Last Updated:Sep 21, 2026

Memulai eksekusi tugas.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

oos:StartExecution

update

*Execution.

acs:oos:{#regionId}:{#accountId}:execution/*

  • oos:tag
  • oos:IsOOSAssumeRole
  • oos:TLSVersion
None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

No

ID wilayah.

cn-hangzhou

TemplateName

string

No

Nama templat. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_), serta dapat memiliki panjang hingga 200 karakter.

vmeixme

TemplateVersion

string

No

Nomor versi. Jika Anda tidak menentukan parameter ini, nomor versi terbaru akan digunakan secara default.

v1

Mode

string

No

Mode eksekusi. Nilai valid:

  • Automatic (default): eksekusi otomatis

  • FailurePause: berhenti saat terjadi kegagalan

  • Debug: eksekusi langkah demi langkah

Otomatis

LoopMode

string

No

Mode loop. Nilai valid:

  • Otomatis (default): tidak ada jeda

  • FirstBatchPause: berhenti setelah Batch pertama

  • EveryBatchPause: berhenti setelah setiap Batch

Otomatis

ParentExecutionId deprecated

string

No

ID eksekusi induk.

exec-xxx

SafetyCheck

string

No

Mode pemeriksaan keamanan. Nilai valid:

  • Skip (default): Opsi ini menunjukkan bahwa pelanggan menyadari risiko dan aksi apa pun dapat dieksekusi tanpa konfirmasi, terlepas dari tingkat risikonya. Opsi ini hanya valid ketika Mode=Otomatis.

  • ConfirmEveryHighRiskAction: Opsi ini mengharuskan pelanggan mengonfirmasi setiap aksi berisiko tinggi. Pelanggan dapat mengonfirmasi atau membatalkan dengan memanggil operasi NotifyExecution.

Skip

Parameters

string

No

String JSON yang terdiri dari sekumpulan parameter. Nilai default: {}.

{"Status":"Running"}

ClientToken

string

No

Token akses.

123e56767-e89b-12d3-a456-426655440000

Tags

object

No

Tag yang akan ditambahkan ke eksekusi tugas.

{ "k1": "v1", "k2": "v2" }

Description

string

No

Deskripsi yang akan ditambahkan ke eksekusi tugas.

test execution

TemplateContent

string

No

Konten templat dalam format JSON atau YAML. Ini sama dengan bidang Content di parameter permintaan CreateTemplate. Jika Anda menentukan parameter ini, tugas di TemplateContent akan langsung dieksekusi tanpa perlu membuat templat terlebih dahulu. Anda tidak perlu menentukan parameter ini jika menggunakan templat yang ada untuk membuat eksekusi tugas.

{ "Description": "Example template, describe instances in some status", "FormatVersion": "OOS-2019-06-01", "Parameters": {}, "Tasks": [ { "Name": "describeInstances", "Action": "ACS::ExecuteAPI", "Description": "desc-en", "Properties": { "Service": "ECS", "API": "DescribeInstances", "Parameters": { "Status": "Running" } } } ] }

ResourceGroupId

string

No

ID kelompok sumber daya.

rg-acfmxsn4m4******

TemplateURL

string

No

URL konten templat OOS yang disimpan di Alibaba Cloud Object Storage Service (OSS). Hanya URL yang dapat dibaca secara publik yang didukung. Jika Anda menentukan parameter ini, eksekusi tugas akan dibuat berdasarkan konten templat yang disimpan di TemplateURL tanpa perlu membuat templat terlebih dahulu. Anda tidak perlu menentukan parameter ini jika menggunakan templat yang ada untuk membuat eksekusi tugas.

http://oos-template.cn-hangzhou.oss.aliyun-inc.com/oos-test-template.json

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

14A07460-EBE7-47CA-9757-12CC4761D47A

Execution

object

Data eksekusi tugas.

Outputs

string

Output eksekusi tugas.

{ "InstanceId":"i-xxx" }

Status

string

Status eksekusi tugas.

Success

EndDate

string

Pengatur waktu berakhir dalam format ISO 8601 (UTC).

2019-05-16T10:26:14Z

ExecutedBy

string

Pengguna yang mengeksekusi templat.

root(13092080xx12344)

IsParent

boolean

Apakah eksekusi tugas berisi tugas turunan.

false

Tags

object

Tag eksekusi tugas.

{"k1":"v2","k2":"v2"}

StartDate

string

Pengatur waktu mulai dalam format ISO 8601 (UTC).

2019-05-16T10:26:14Z

SafetyCheck

string

Mode pemeriksaan keamanan.

Skip

Mode

string

Mode eksekusi.

Otomatis

TemplateName

string

Nama templat.

MyTemplate

CreateDate

string

Pengatur waktu pembuatan eksekusi tugas dalam format ISO 8601 (UTC).

2019-05-16T10:26:14Z

TemplateVersion

string

Nomor versi templat.

v1

ExecutionId

string

Pengidentifikasi unik eksekusi tugas.

exec-xxxyyy

Parameters

string

Parameter input eksekusi tugas.

{ "Status":"Running" }

Description

string

Deskripsi eksekusi tugas.

test execution

Counters

object

Jumlah eksekusi.

1

UpdateDate

string

Pengatur waktu pembaruan dalam format ISO 8601 (UTC).

2019-05-16T10:26:14Z

ResourceGroupId

string

ID kelompok sumber daya.

rg-acfmxsn4m4******

ParentExecutionId

string

ID eksekusi induk.

exec-xxxx

RamRole

string

Peran RAM yang digunakan untuk mengeksekusi templat.

OOSServiceRole

TemplateId

string

ID templat.

t-1bd341007f

StatusMessage

string

Paket status.

""

LoopMode

string

Mode loop.

Otomatis

CurrentTasks

array<object>

Tugas yang sedang berjalan.

object

TaskExecutionId

string

ID eksekusi tugas.

exec-dsadasdawq

TaskName

string

Nama tugas.

testTask

TaskAction

string

Aksi tugas.

ACS::TimerTrigger

Contoh

Respons sukses

JSONformat

{
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "Execution": {
    "Outputs": "{ \"InstanceId\":\"i-xxx\" }",
    "Status": "Success",
    "EndDate": "2019-05-16T10:26:14Z",
    "ExecutedBy": "root(13092080xx12344)",
    "IsParent": false,
    "Tags": {
      "k1": "v2",
      "k2": "v2"
    },
    "StartDate": "2019-05-16T10:26:14Z",
    "SafetyCheck": "Skip",
    "Mode": "Otomatis",
    "TemplateName": "MyTemplate",
    "CreateDate": "2019-05-16T10:26:14Z",
    "TemplateVersion": "v1",
    "ExecutionId": "exec-xxxyyy",
    "Parameters": "{ \"Status\":\"Running\" }",
    "Description": "test execution",
    "Counters": 1,
    "UpdateDate": "2019-05-16T10:26:14Z",
    "ResourceGroupId": "rg-acfmxsn4m4******",
    "ParentExecutionId": "exec-xxxx",
    "RamRole": "OOSServiceRole",
    "TemplateId": "t-1bd341007f",
    "StatusMessage": "\"\"",
    "LoopMode": "Otomatis",
    "CurrentTasks": [
      {
        "TaskExecutionId": "exec-dsadasdawq",
        "TaskName": "testTask",
        "TaskAction": "ACS::TimerTrigger"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.