全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::OOS::Execution

更新时间:Jul 06, 2025

ALIYUN::OOS::Execution digunakan untuk memulai eksekusi.

Sintaksis

{
  "Type": "ALIYUN::OOS::Execution",
  "Properties": {
    "ResourceOptions": Map,
    "Parameters": Map,
    "Tags": Map,
    "TemplateName": String,
    "ParentExecutionId": String,
    "SafetyCheck": String,
    "Mode": String,
    "TemplateVersion": String,
    "ResourceGroupId": String,
    "LoopMode": String,
    "Description": String,
    "TemplateContent": String,
    "TemplateURL": String
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

ResourceOptions

Map

Tidak

Tidak

Opsi sumber daya yang digunakan oleh Resource Orchestration Service (ROS).

Untuk informasi lebih lanjut, lihat Properti ResourceOptions.

Parameters

Map

Tidak

Tidak

String JSON yang terdiri dari parameter.

Contoh: {"Status": "Running"}.

Nilai default: {}.

Tags

Map

Tidak

Tidak

Tag. Tag adalah pasangan kunci-nilai. Contoh: {"k1":"v1", "k2":"v2"}.

Anda dapat menambahkan hingga 20 tag.

TemplateName

String

Tidak

Tidak

Nama template.

Nama dapat memiliki panjang hingga 200 karakter. Tidak boleh dimulai dengan ALIYUN, ACS, atau ALIBABA. Dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

ParentExecutionId

String

Tidak

Tidak

ID eksekusi induk.

Tidak ada.

SafetyCheck

String

Tidak

Tidak

Mode pemeriksaan keamanan.

Nilai valid:

  • Skip: melewati konfirmasi manual untuk semua tindakan, terlepas dari tingkat risiko. Nilai ini valid ketika Mode diatur ke Otomatis.

  • ConfirmEveryHighRiskAction (default): memerlukan konfirmasi manual untuk setiap tindakan berisiko tinggi. Anda dapat memanggil operasi NotifyExecution untuk mengonfirmasi atau membatalkan tindakan.

Mode

String

Tidak

Tidak

Mode eksekusi.

Nilai valid:

  • Debug

  • Otomatis (default)

TemplateVersion

String

Tidak

Tidak

Nomor versi.

Jika Anda meninggalkan properti ini kosong, sistem akan menggunakan versi terbaru.

ResourceGroupId

String

Tidak

Tidak

ID grup sumber daya.

Tidak ada.

LoopMode

String

Tidak

Tidak

Mode loop.

Tidak ada.

Description

String

Tidak

Tidak

Deskripsi eksekusi.

Tidak ada.

TemplateContent

String

Tidak

Tidak

Konten template.

Konten template dalam format JSON atau YAML. Properti ini memiliki efek yang sama dengan parameter Content dalam operasi CreateTemplate. Anda dapat menentukan properti ini untuk langsung mengeksekusi tugas yang didefinisikan dalam konten template. Dengan cara ini, Anda tidak perlu membuat template dan tugas secara terpisah. Jika Anda menggunakan TemplateName untuk menentukan template yang ada untuk membuat tugas, Anda dapat membiarkan TemplateContent kosong.

TemplateURL

String

Tidak

Tidak

URL sumber daya Object Storage Service (OSS) tempat konten template CloudOps Orchestration Service (OOS) disimpan. Hanya URL public-read yang didukung.

Anda dapat menentukan properti ini untuk langsung membuat tugas yang didefinisikan dalam konten template. Dengan cara ini, Anda tidak perlu membuat template dan tugas secara terpisah. Jika Anda menggunakan TemplateName untuk menentukan template yang ada untuk membuat tugas, Anda dapat membiarkan TemplateURL kosong.

Sintaksis ResourceOptions

"ResourceOptions": {
  "SuccessStatuses": List,
  "Timeout": Number,
  "CancelOnDelete": Boolean,
  "FailureStatuses": List
}

Properti ResourceOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

SuccessStatuses

List

Tidak

Tidak

Status yang menentukan apakah sumber daya dibuat.

Nilai valid:

  • Started

  • Queued

  • Running

  • Waiting

  • Success (default)

  • Failed

  • Cancelled

Jika status eksekusi termasuk dalam nilai properti FailureStatuses, sumber daya gagal dibuat. Jika status eksekusi termasuk dalam nilai properti SuccessStatuses, sumber daya berhasil dibuat. Jika kedua kondisi tersebut tidak terpenuhi, sistem akan menunggu hingga permintaan habis waktu.

Timeout

Number

Tidak

Tidak

Periode timeout.

Satuan: detik.

Nilai default: 1800.

CancelOnDelete

Boolean

Tidak

Tidak

Menentukan apakah akan membatalkan eksekusi yang belum selesai saat sumber daya sedang dihapus.

Nilai valid:

  • true

  • false (default)

FailureStatuses

List

Tidak

Tidak

Status yang menentukan apakah sumber daya gagal dibuat. Properti FailureStatuses memiliki prioritas lebih tinggi daripada properti SuccessStatuses.

Nilai valid:

  • Started

  • Queued

  • Running

  • Waiting

  • Success

  • Failed

  • Cancelled

Nilai default: ["Failed", "Cancelled"].

Nilai pengembalian

Fn::GetAtt

  • Status: Status eksekusi.

  • WindowsCurlCli: Perintah awalan CLI cURL yang disediakan untuk Windows. WindowsCurlCli dapat digunakan untuk mengirim sinyal yang menunjukkan apakah eksekusi selesai atau gagal. Untuk informasi lebih lanjut, lihat NotifyExecution.

  • PowerShellCurlCli: Perintah awalan CLI cURL yang disediakan untuk PowerShell. PowerShellCurlCli dapat digunakan untuk mengirim sinyal yang menunjukkan apakah eksekusi selesai atau gagal.

  • Outputs: Keluaran eksekusi.

  • ExecutionId: ID unik eksekusi.

  • CurlCli: Perintah cURL.

  • StatusMessage: Informasi status.

  • Counters: Jumlah eksekusi.

Contoh

YAML format

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  TemplateName:
    Type: String
    Description: Nama template. Konten dibatasi pada huruf, angka, garis bawah, panjang 200 karakter, dan tidak boleh dimulai dengan ALIYUN, ACS, ALIBABA.
    Label: Nama Template
    ConstraintDescription: '[2, 128] karakter Inggris atau Cina'
    MinLength: 2
    MaxLength: 128
    Default: mytest
Resources:
  Execution:
    Type: ALIYUN::OOS::Execution
    Properties:
      Parameters: {}
      TemplateName:
        Ref: TemplateName
      ResourceOptions:
        SuccessStatuses:
          - Running
          - Success
          - Queued
          - Waiting
        CancelOnDelete: true
Outputs:
  Status:
    Description: Status eksekusi.
    Value:
      Fn::GetAtt:
        - Execution
        - Status
  WindowsCurlCli:
    Description: 'Atribut kemudahan, menyediakan awalan perintah CLI curl untuk Windows, yang dapat digunakan untuk memberi tahu eksekusi oos alih-alih OOS API NotifyExecution. Anda dapat memberi tahu persetujuan ke eksekusi oos dengan menambahkan --data-binary "{\"data\": {\"NotifyType\": \"Approve\"}}" Anda juga dapat memberi tahu eksekusi melalui ROS API SignalResource. Parameter API Status dan UniqueId diabaikan. Gunakan parameter API Data untuk mengirim data.'
    Value:
      Fn::GetAtt:
        - Execution
        - WindowsCurlCli
  PowerShellCurlCli:
    Description: 'Atribut kemudahan, menyediakan awalan perintah CLI curl untuk PowerShell, yang dapat digunakan untuk memberi tahu eksekusi oos alih-alih OOS API NotifyExecution. Anda dapat memberi tahu persetujuan ke eksekusi oos dengan menambahkan -Body ''{"data": {"NotifyType": "Approve"}}'' Anda juga dapat memberi tahu eksekusi melalui ROS API SignalResource. Parameter API Status dan UniqueId diabaikan. Gunakan parameter API Data untuk mengirim data.'
    Value:
      Fn::GetAtt:
        - Execution
        - PowerShellCurlCli
  Outputs:
    Description: Keluaran eksekusi.
    Value:
      Fn::GetAtt:
        - Execution
        - Outputs
  ExecutionId:
    Description: ID Eksekusi.
    Value:
      Fn::GetAtt:
        - Execution
        - ExecutionId
  CurlCli:
    Description: 'Atribut kemudahan, menyediakan awalan perintah CLI curl, yang dapat digunakan untuk memberi tahu eksekusi oos alih-alih OOS API NotifyExecution. Anda dapat memberi tahu persetujuan ke eksekusi oos dengan menambahkan --data-binary ''{"data": {"NotifyType": "Approve"}}'' Anda juga dapat memberi tahu eksekusi melalui ROS API SignalResource. Parameter API Status dan UniqueId diabaikan. Gunakan parameter API Data untuk mengirim data.'
    Value:
      Fn::GetAtt:
        - Execution
        - CurlCli
  StatusMessage:
    Description: Informasi status eksekusi.
    Value:
      Fn::GetAtt:
        - Execution
        - StatusMessage
  Counters:
    Description: 'Statistik tugas: FailedTasks, SuccessTasks, TotalTasks.'
    Value:
      Fn::GetAtt:
        - Execution
        - Counters

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "TemplateName": {
      "Type": "String",
      "Description": "Nama template. Konten dibatasi pada huruf, angka, garis bawah, panjang 200 karakter, dan tidak boleh dimulai dengan ALIYUN, ACS, ALIBABA.",
      "Label": "Nama Template",
      "ConstraintDescription": "[2, 128] karakter Inggris atau Cina",
      "MinLength": 2,
      "MaxLength": 128,
      "Default": "mytest"
    }
  },
  "Resources": {
    "Execution": {
      "Type": "ALIYUN::OOS::Execution",
      "Properties": {
        "Parameters": {
        },
        "TemplateName": {
          "Ref": "TemplateName"
        },
        "ResourceOptions": {
          "SuccessStatuses": [
            "Running",
            "Success",
            "Queued",
            "Waiting"
          ],
          "CancelOnDelete": true
        }
      }
    }
  },
  "Outputs": {
    "Status": {
      "Description": "Status eksekusi.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "Status"
        ]
      }
    },
    "WindowsCurlCli": {
      "Description": "Atribut kemudahan, menyediakan awalan perintah CLI curl untuk Windows, yang dapat digunakan untuk memberi tahu eksekusi oos alih-alih OOS API NotifyExecution. Anda dapat memberi tahu persetujuan ke eksekusi oos dengan menambahkan --data-binary \"{\\\"data\\\": {\\\"NotifyType\\\": \\\"Approve\\\"}}\" Anda juga dapat memberi tahu eksekusi melalui ROS API SignalResource. Parameter API Status dan UniqueId diabaikan. Gunakan parameter API Data untuk mengirim data.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "WindowsCurlCli"
        ]
      }
    },
    "PowerShellCurlCli": {
      "Description": "Atribut kemudahan, menyediakan awalan perintah CLI curl untuk PowerShell, yang dapat digunakan untuk memberi tahu eksekusi oos alih-alih OOS API NotifyExecution. Anda dapat memberi tahu persetujuan ke eksekusi oos dengan menambahkan -Body '{\"data\": {\"NotifyType\": \"Approve\"}}' Anda juga dapat memberi tahu eksekusi melalui ROS API SignalResource. Parameter API Status dan UniqueId diabaikan. Gunakan parameter API Data untuk mengirim data.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "PowerShellCurlCli"
        ]
      }
    },
    "Outputs": {
      "Description": "Keluaran eksekusi.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "Outputs"
        ]
      }
    },
    "ExecutionId": {
      "Description": "ID Eksekusi.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "ExecutionId"
        ]
      }
    },
    "CurlCli": {
      "Description": "Atribut kemudahan, menyediakan awalan perintah CLI curl, yang dapat digunakan untuk memberi tahu eksekusi oos alih-alih OOS API NotifyExecution. Anda dapat memberi tahu persetujuan ke eksekusi oos dengan menambahkan --data-binary '{\"data\": {\"NotifyType\": \"Approve\"}}' Anda juga dapat memberi tahu eksekusi melalui ROS API SignalResource. Parameter API Status dan UniqueId diabaikan. Gunakan parameter API Data untuk mengirim data.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "CurlCli"
        ]
      }
    },
    "StatusMessage": {
      "Description": "Informasi status eksekusi.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "StatusMessage"
        ]
      }
    },
    "Counters": {
      "Description": "Statistik tugas: FailedTasks, SuccessTasks, TotalTasks.",
      "Value": {
        "Fn::GetAtt": [
          "Execution",
          "Counters"
        ]
      }
    }
  }
}