Gunakan CreateFlow API untuk membuat alur-CloudFlow-Alibaba Cloud

Membuat flow.

Deskripsi operasi

Description

Jumlah flow yang dapat dibuat oleh setiap pengguna dibatasi oleh kuota sumber daya. Untuk informasi selengkapnya, lihat Limits. Jika Anda memiliki kebutuhan khusus, ajukan tiket untuk meminta penyesuaian batas.
Setiap flow diidentifikasi secara unik berdasarkan nama dalam satu akun. Oleh karena itu, Anda tidak dapat membuat beberapa flow 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 flow. Nama harus unik dalam wilayah yang sama dan tidak dapat diubah setelah flow 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 dimulai dengan huruf atau garis bawah (_). Bersifat case-sensitive. Panjangnya antara 1 hingga 128 karakter.	my_flow_name
Definition	string	Yes	Definisi flow. Harus mematuhi sintaks Flow Definition Language (FDL). Untuk kompatibilitas maju, sistem mendukung dua versi spesifikasi definisi flow. Catatan Pada contoh definisi flow, Name: my_flow_name mengacu pada nama flow 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 flow.	my test flow
Type	string	Yes	Tipe flow. Nilainya harus FDL. Valid values: FDL : Flow Definition Language	FDL
RoleArn	string	No	Deskriptor sumber daya untuk role yang digunakan flow selama eksekusi. Saat flow dijalankan, Serverless Workflow mengasumsikan role ini (AssumeRole) untuk mengoperasikan sumber daya flow terkait.	acs:ram:${region}:${accountID}:${role}
ExternalStorageLocation	string	No	Lokasi penyimpanan eksternal.	/path
ExecutionMode	string	No	Mode eksekusi. Ini merupakan tipe enumerasi. Nilai yang valid adalah Express dan Standard. Untuk kompatibilitas maju, string kosong dianggap sebagai mode eksekusi Standard. Valid values: Express : Mode eksekusi express Standard : Mode eksekusi standard	Standard
Environment	object	No	Konteks lingkungan yang dapat diakses flow selama eksekusi.
Variables	array<object>	No	Daftar variabel lingkungan yang dapat diakses flow selama eksekusi.
	object	No	Daftar variabel yang dapat diakses flow selama eksekusi.
Name	string	No	Nama variabel.	key
Value	string	No	Nilai variabel.	value
Description	string	No	Deskripsi variabel.	description

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
Type	string	Tipe flow. Valid values: FDL : Flow Definition Language	FDL
Definition	string	Definisi flow. Untuk kompatibilitas maju, sistem mendukung dua versi spesifikasi definisi flow.	旧版： "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 flow selama eksekusi. Saat flow dijalankan, Serverless Workflow mengasumsikan role ini (AssumeRole) untuk mengoperasikan sumber daya flow 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 flow.	my test flow
Name	string	Nama flow.	my_flow_name
CreatedTime	string	Waktu saat flow dibuat.	2019-01-01T01:01:01.001Z
LastModifiedTime	string	Waktu saat flow terakhir dimodifikasi.	2019-01-01T01:01:01.001Z
Id	string	ID unik flow.	e589e092-e2c0-4dee-b306-3574ddfdddf5****
ExecutionMode	string	Mode eksekusi. Ini merupakan tipe enumerasi. Nilai yang valid adalah Express dan Standard. Untuk kompatibilitas maju, field ini dapat berupa string kosong, yang dianggap sebagai mode Standard.	Standard
Environment	object	Daftar variabel yang dapat diakses flow selama eksekusi.
Variables	array<object>	Daftar variabel yang dapat diakses flow selama eksekusi.
	object	Daftar variabel yang dapat diakses flow selama eksekusi.
Name	string	Nama variabel.	key
Value	string	Nilai variabel.	value
Description	string	Deskripsi variabel.	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.