Gunakan CreateFlow API untuk membuat alur-CloudFlow-Alibaba Cloud - CloudFlow

Membuat alur.

Deskripsi operasi

Deskripsi

Jumlah alur yang dapat dibuat setiap pengguna tunduk pada batas sumber daya. Untuk informasi lebih lanjut, lihat Batas. Jika Anda memiliki persyaratan khusus, ajukan tiket untuk meminta penyesuaian batas.
Alur diidentifikasi secara unik berdasarkan nama dalam satu akun. Oleh karena itu, Anda tidak dapat membuat beberapa alur dengan nama yang sama dalam satu akun.

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

fnf:CreateFlow

create

*Flow

acs:fnf:{#regionId}:{#accountId}:flow/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Name	string	Yes	Nama alur. Nama harus unik dalam region yang sama dan tidak dapat diubah setelah alur dibuat. Nama harus memenuhi persyaratan berikut: Dapat berisi huruf (a hingga z dan A hingga Z), angka (0 hingga 9), garis bawah (_), dan tanda hubung (-). Harus diawali dengan huruf atau garis bawah (_). Bersifat case-sensitive. Panjangnya harus antara 1 hingga 128 karakter.	my_flow_name
Definition	string	Yes	Definisi alur. Harus sesuai dengan sintaks Flow Definition Language (FDL). Untuk kompatibilitas ke depan, sistem mendukung dua versi spesifikasi definisi alur. Catatan Dalam contoh definisi alur, Name: my_flow_name mengacu pada nama alur dan harus sama dengan parameter input Name.	旧版： " type: flow version: v1 name: my_flow_name steps: - type: pass name: mypass " 新版： " Type: StateMachine SpecVersion: v1 Name: my_flow_name StartAt: my_state States: - Type: Pass Name: my_state End: true "
Description	string	Yes	Deskripsi alur.	my test flow
Type	string	Yes	Tipe alur. Nilainya harus FDL. Valid values: FDL : Flow Definition Language	FDL
RoleArn	string	No	Deskriptor sumber daya untuk role yang digunakan alur saat eksekusi. Ketika alur berjalan, Serverless Workflow mengasumsikan role ini (AssumeRole) untuk mengoperasikan sumber daya alur terkait.	acs:ram:${region}:${accountID}:${role}
ExternalStorageLocation	string	No	Lokasi penyimpanan eksternal.	/path
ExecutionMode	string	No	Mode eksekusi. Ini adalah tipe enumerasi. Nilai yang valid adalah Express dan Standard. Untuk kompatibilitas ke depan, string kosong diperlakukan sebagai mode eksekusi Standard. Valid values: Express : Mode eksekusi express Standard : Mode eksekusi standard	Standard
Environment	object	No	Konteks lingkungan yang dapat diakses alur selama eksekusi.
Variables	array<object>	No	Daftar variabel lingkungan yang dapat diakses alur selama eksekusi.
	object	No	Daftar variabel yang dapat diakses alur selama eksekusi.
Name	string	No	Nama variabel.	key
Value	string	No	Nilai variabel.	value
Description	string	No	Deskripsi variabel.	description
ResourceGroupId	string	No

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
Type	string	Tipe alur. Valid values: FDL : Flow Definition Language	FDL
Definition	string	Definisi alur. Untuk kompatibilitas ke depan, sistem mendukung dua versi spesifikasi definisi alur.	旧版： "type: flow\nversion: v1\nname: my_flow_name\nsteps:\n - type: pass\n name: mypass" 新版： "Type: StateMachine\nSpecVersion: v1\nName: my_flow_name\nStartAt: my_state\nStates:\n - Type: Pass\n Name: my_state\n End: true"
RoleArn	string	Deskriptor sumber daya untuk role yang digunakan alur saat eksekusi. Ketika alur berjalan, Serverless Workflow mengasumsikan role ini (AssumeRole) untuk mengoperasikan sumber daya alur terkait.	acs:ram:${region}:${accountID}:${role}
RequestId	string	ID permintaan. Serverless Workflow mengembalikan ID permintaan untuk setiap permintaan yang menerima `http status code`.	testRequestID
Description	string	Deskripsi alur.	my test flow
Name	string	Nama alur.	my_flow_name
CreatedTime	string	Waktu saat alur dibuat.	2019-01-01T01:01:01.001Z
LastModifiedTime	string	Waktu saat alur terakhir kali dimodifikasi.	2019-01-01T01:01:01.001Z
Id	string	ID unik alur.	e589e092-e2c0-4dee-b306-3574ddfdddf5****
ExecutionMode	string	Mode eksekusi. Ini adalah tipe enumerasi. Nilai yang valid adalah Express dan Standard. Untuk kompatibilitas ke depan, field ini dapat berupa string kosong, yang diperlakukan sebagai mode Standard.	Standard
Environment	object	Daftar variabel yang dapat diakses alur selama eksekusi.
Variables	array<object>	Daftar variabel yang dapat diakses alur selama eksekusi.
	object	Daftar variabel yang dapat diakses alur selama eksekusi.
Name	string	The name of the variable.	key
Value	string	The value of the variable.	value
Description	string	The description of the variable.	description
ResourceGroupId	string		rg-xxx

Contoh

Respons sukses

JSONformat

{
  "Type": "FDL",
  "Definition": "旧版：\n\"type: flow\\nversion: v1\\nname: my_flow_name\\nsteps:\\n  - type: pass\\n    name: mypass\"\n\n新版：\n\"Type: StateMachine\\nSpecVersion: v1\\nName: my_flow_name\\nStartAt: my_state\\nStates:\\n  - Type: Pass\\n    Name: my_state\\n    End: true\"",
  "RoleArn": "acs:ram:${region}:${accountID}:${role}",
  "RequestId": "testRequestID",
  "Description": "my test flow",
  "Name": "my_flow_name",
  "CreatedTime": "2019-01-01T01:01:01.001Z",
  "LastModifiedTime": "2019-01-01T01:01:01.001Z",
  "Id": "e589e092-e2c0-4dee-b306-3574ddfdddf5****",
  "ExecutionMode": "Standard",
  "Environment": {
    "Variables": [
      {
        "Name": "key",
        "Value": "value",
        "Description": "description"
      }
    ]
  },
  "ResourceGroupId": "rg-xxx"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	ActionNotSupported	The requested API operation '%s' is incorrect. Please check.
400	APIVersionNotSupported	The requested API version '%s' is not supported yet. Please check.
400	EntityTooLarge	The payload size exceeds maximum allowed size (%s bytes).
400	InvalidArgument	Parameter error.
400	MissingRequiredHeader	The HTTP header '%s' must be specified.
400	MissingRequiredParams	The HTTP query '%s' must be specified.
500	InternalServerError	An internal error has occurred. Please retry.
403	AccessDenied	The resources doesn't belong to you.
403	InvalidAccessKeyID	The AccessKey ID %s is invalid.
403	RequestTimeTooSkewed	The difference between the request time %s and the current time %s is too large.
403	SignatureNotMatch	The request signature we calculated does not match the signature you provided. Check your access key and signing method.
415	UnsupportedMediaType	The content type must be "application/json".
429	ResourceThrottled	The request is throttled. Please try again later.
409	FlowAlreadyExists	Flow %s already exists.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.