CreateFlowLog - Virtual Private Cloud - Alibaba Cloud Documentation Center

Membuat Log aliran.

Deskripsi operasi

CreateFlowLog adalah operasi asinkron. Setelah Anda memanggil operasi ini, sistem akan mengembalikan ID instans, tetapi Log aliran belum dibuat. Tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil DescribeFlowLogs untuk mengkueri status pembuatan Log aliran:

Jika Log aliran berada dalam status Activating, Log aliran sedang dibuat.
Jika Log aliran berada dalam status Active, Log aliran telah dibuat dan diaktifkan.

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

vpc:CreateFlowLog

create

VSwitch.

acs:vpc:{#regionid}:{#accountId}:vswitch/{#VSwitchId}

*FlowLog.

acs:vpc:{#regionId}:{#accountId}:flowlog/*

VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah Log aliran. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-qingdao
FlowLogName	string	No	Nama Log aliran. Panjang nama harus 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	myFlowlog
Description	string	No	Deskripsi Log aliran. Panjang deskripsi harus 1 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	Ini adalah Flowlog saya
ResourceType	string	Yes	Tipe Sumber daya yang trafiknya ingin Anda tangkap. Nilai valid: NetworkInterface: antarmuka jaringan (NIC). VSwitch: semua antarmuka jaringan (NIC) di vSwitch. VPC: semua antarmuka jaringan (NIC) di virtual private cloud (VPC).	NetworkInterface
ResourceId	string	Yes	ID Sumber daya yang trafiknya ingin Anda tangkap.	eni-askldfas****
TrafficType	string	Yes	Tipe trafik yang akan dikumpulkan. Nilai valid: All: semua trafik. Allow: trafik yang diizinkan oleh kontrol akses. Drop: trafik yang ditolak oleh kontrol akses.	All
ProjectName	string	No	Nama proyek yang mengelola trafik yang ditangkap. Nama proyek hanya dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama harus diawali dan diakhiri dengan huruf kecil atau angka. Panjang nama harus 3 hingga 63 karakter.	FlowLogProject
LogStoreName	string	No	Nama penyimpanan log yang menyimpan trafik yang ditangkap. Nama penyimpanan log hanya dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Nama harus diawali dan diakhiri dengan huruf kecil atau angka. Panjang nama harus 3 hingga 63 karakter.	FlowLogStore
AggregationInterval	integer	No	Interval pengambilan sampel Log aliran. Unit: minutes. Nilai valid: 1, 5, dan 10 (default).	10
TrafficPath	array	No	Jalur trafik yang akan dikumpulkan. Nilai valid: all (default): semua skenario. internetGateway: trafik untuk mengakses Internet. natGateway: trafik melalui NAT gerbang. vpnGateway: trafik melalui VPN gerbang. transitRouter: trafik melalui TR. gatewayEndpoint: trafik melalui Titik akhir gerbang untuk mengakses layanan Alibaba Cloud. vbr: trafik melalui Virtual Border Router (VBR) untuk mengakses sirkuit Express Connect. ecr: trafik melalui Express Connect Router (ECR). ipv4Gateway: trafik melalui IPv4 gerbang untuk mengakses Internet. gatewayLoadBalancerEndpoint: trafik melalui Titik akhir gerbang Load Balancer (GWLBe).
	string	No	Jalur trafik yang akan dikumpulkan. Nilai valid: all (default): semua skenario. internetGateway: trafik untuk mengakses Internet. natGateway: trafik melalui NAT gerbang. vpnGateway: trafik melalui VPN gerbang. transitRouter: trafik melalui TR. gatewayEndpoint: trafik melalui Titik akhir gerbang untuk mengakses layanan Alibaba Cloud. vbr: trafik melalui Virtual Border Router (VBR) untuk mengakses sirkuit Express Connect. ecr: trafik melalui Express Connect Router (ECR). ipv4Gateway: trafik melalui IPv4 gerbang untuk mengakses Internet. gatewayLoadBalancerEndpoint: trafik melalui Titik akhir gerbang Load Balancer (GWLBe).	all
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-acfmxazdjdhd****
Tag	array<object>	No	Tag Sumber daya.
	object	No	Tag.
Key	string	No	Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Jangan tentukan string kosong untuk parameter ini. Panjang kunci tag dapat mencapai 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Nilai tag tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
IpVersion	string	No	Versi IP trafik yang ditangkap oleh Log aliran.	IPv4
LogFormat	string	No

Elemen respons

Element	Type	Description	Example
	object	ID permintaan.
RequestId	string	ID permintaan.	54B48E3D-DF70-471B-AA93-08E683A1B457
Success	string	Apakah panggilan berhasil. Nilai valid: true: Panggilan berhasil. false: Panggilan gagal.	true
FlowLogId	string	ID Log aliran.	fl-m5e8vhz2t21sel1nq****
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfmxazdjdhd****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B457",
  "Success": "true.",
  "FlowLogId": "fl-m5e8vhz2t21sel1nq****",
  "ResourceGroupId": "rg-acfmxazdjdhd****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IncorrectBusinessStatus.FlowLog	The business status of flowLog is incorrect.	Status layanan saat ini tidak mendukung pembuatan instans log aliran.
400	OptInRequired.FlowLog	You are not authorized to use the requested service of flowLog. Ensure that you have subscribed to the service you are trying to use.	Anda tidak diotorisasi untuk menggunakan layanan flowLog yang diminta. Pastikan Anda telah berlangganan layanan yang ingin digunakan.
400	OperationUnsupported.AdvancedFeature	Advanced features of the vpc is unsupported.	Fitur lanjutan tidak didukung.
400	InvalidInstanceId	vswitch does not exist.	Instans vSwitch tidak ada.
400	ProjectOrLogstoreNotExist	The specified project or logstore does not exist.	Proyek atau penyimpanan log yang ditentukan tidak ada.
400	SourceProjectNotExist	The Source Project or logstore does not exist.	Proyek sumber SLS atau penyimpanan log tidak ada.
400	Unauthorized	This api does not support sub user or role.	Operasi API ini tidak mendukung pengguna RAM atau peran.
400	OperationUnsupported.action	This action is not support.	Operasi ini tidak didukung.
400	ParameterInvalid	Invalid parameter.	Parameter input tidak valid.
400	RuleExist	The rule has already existed.
400	InvalidHdMonitorStatus	Current instance status is not valid for this action.
400	QuotaExceeded.FlowlogCount	This user has reached the maximum instance number of flowlog.	Jumlah maksimum instans log aliran telah tercapai.
400	InvalidResourceId.NotFound	This resourceId already has flowlog instance existed.	Instans log aliran sudah ada untuk Sumber daya yang ditentukan.
400	INVALID_PARAMETER	The parameter invalid.
400	MissingParameter	Missing mandatory parameter
400	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	RegionId yang ditentukan tidak ada. Periksa apakah produk ini tersedia di wilayah yang ditentukan.
400	InvalidResourceType.NotFound	Resource type no the same.
400	OperationUnsupported.ResourceType	This resource type is not supported.
400	IllegalParam.AggregationInterval	The param of aggregationInterval is illegal.	Parameter interval pengambilan sampel tidak valid.
400	UnsupportedFeature.UserDefinedTrafficPath	The feature of UserDefinedTrafficPath is not supported.	Fitur trafik trafficPath log aliran kustom tidak didukung untuk pengguna ini.
400	IllegalParam.TrafficPath	The param of trafficPath is illegal.	Parameter Trafik trafficPath yang ditentukan tidak valid.
400	DuplicatedParam.TrafficPath	The param of trafficPath is duplicated.	Parameter Trafik trafficPath yang ditentukan berisi nilai duplikat.
400	IllegalParam.ResourceGroupId	Invalid ResourceGroupld value.	Kelompok sumber daya yang ditentukan tidak valid atau tidak ada.
400	OperationDenied.OperateShareResource	The operation is not allowed because of OperateShareResource.	Operasi gagal karena melibatkan Resource yang dibagikan.
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.	Nilai ipVersion yang ditentukan tidak didukung.
400	UnsupportedFeature.VpcAdvancedFeature	The VPC does not support some advanced features.	VPC tempat vSwitch yang ditentukan berada tidak mendukung fitur lanjutan. Gunakan vSwitch lain dan coba lagi.
400	OperationFailed.EniTypeNotSupport	Operation failed because the ENI type is not supported.	Tipe ENI sekunder tidak mendukung operasi saat ini.
400	IllegalParam.IpVersion	The parameter of IpVersion is illegal.
400	OperationDenied.NisTrafficAnalyzerAggregationIntervalMismatch	The sampling interval of the FlowLog is greater than the sampling interval of the NIS Traffic Analyzer.	Interval pengambilan sampel log aliran lebih besar daripada interval pengambilan sampel NIS Traffic Analyzer.
400	OperationDenied.NisTrafficAnalyzerNotFound	The specified NIS Traffic Analyzer does not exist.	NIS Traffic Analyzer yang ditentukan tidak ada.
400	OperationDenied.NisTrafficAnalyzerNotActive	The specified NIS Traffic Analyzer is not enabled.	NIS Traffic Analyzer yang ditentukan tidak dalam status aktif.
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	Terjadi kesalahan yang tidak diketahui. Coba lagi operasi tersebut. Jika kesalahan tetap terjadi, kirimkan tiket.
400	MissingParam.TrafficAnalyzerIdOrLogProjectOrLogStore	TrafficAnalyzerId and ProjectName and LogStoreName parameters are not passed in.	Baik TrafficAnalyzerId maupun parameter ProjectName dan LogStoreName tidak disediakan.
400	OperationDenied.AllTrafficPathOfManagedExist	The resource you specified has created a flow log instance that collects the traffic of all scenarios. You cannot create a flow log instance that collects only some scenarios.	Instans log aliran yang mengumpulkan Trafik untuk semua skenario sudah dibuat untuk Sumber daya yang ditentukan. Anda tidak dapat membuat instans log aliran lain yang hanya mengumpulkan Trafik untuk beberapa skenario.
400	UnsupportedFeature.UserDefinedTrafficPathIpv6	Dual-stack flow log instances do not support custom trafficPath.	Instans log aliran dual-stack tidak mendukung fitur TrafikPath kustom.
400	IllegalParam.LogFormat	The specified parameter of LogFormat is invalid.	Parameter LogFormat yang ditentukan tidak valid.
400	OperationDenied.UnsupportedField	LogFormat contains unsupported fields.	LogFormat berisi bidang yang tidak didukung.
400	UnsupportedFeature.LogFormat	The ability to customize subscription fields for flow logs is not yet available, so stay tuned.	Fitur bidang langganan kustom untuk log aliran belum tersedia.
400	UnsupportedFeature.LogFormatNisTrafficAnalyze	The flow log for which NIS traffic analysis is enabled does not support custom subscription fields.	Log aliran dengan NIS Traffic Analyzer yang diaktifkan tidak mendukung bidang Port langganan kustom.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.