CreateSecurityGroup - Elastic Compute Service - Alibaba Cloud Documentation Center

Membuat grup keamanan.

Deskripsi operasi

Kebijakan konektivitas internal default untuk grup keamanan dasar yang dibuat oleh operasi ini adalah konektivitas intra-grup. Anda dapat mengubah kebijakan ini dengan memanggil ModifySecurityGroupPolicy.
Kebijakan konektivitas internal default untuk grup keamanan lanjutan yang dibuat oleh operasi ini adalah isolasi internal, dan kebijakan ini tidak dapat diubah.
Jumlah grup keamanan dalam satu wilayah dibatasi. Anda dapat membuat minimal 100 grup keamanan. Untuk informasi selengkapnya, lihat Batas grup keamanan.
Untuk membuat grup keamanan tipe VPC, Anda harus menentukan parameter VpcId.

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

ecs:CreateSecurityGroup

create

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/*

*VPC

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah grup keamanan. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Description	string	No	Deskripsi grup keamanan. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`. Nilai default: kosong.	testDescription
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000
SecurityGroupName	string	No	Nama grup keamanan. Nama harus memiliki panjang 2 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama tidak boleh diawali dengan `http://` atau `https://`. Nama dapat berisi karakter yang dikategorikan sebagai huruf dalam Unicode, termasuk karakter Tionghoa dan huruf Inggris, serta angka. Nama juga dapat berisi titik dua (:), garis bawah (_), titik (.), atau tanda hubung (-).	testSecurityGroupName
VpcId	string	No	ID VPC tempat grup keamanan berada.	vpc-bp1opxu1zkhn00gzv****
SecurityGroupType	string	No	Tipe grup keamanan. Nilai valid: normal: grup keamanan dasar. enterprise: grup keamanan lanjutan. Untuk informasi selengkapnya, lihat Ikhtisar grup keamanan lanjutan. Nilai default: normal.	enterprise
ServiceManaged	boolean	No	Parameter ini tidak tersedia secara publik.	false
ResourceGroupId	string	No	ID kelompok sumber daya tempat grup keamanan berada.	rg-bp67acfmxazb4p****
Tag	array<object>	No	Tag yang akan diikat ke grup keamanan. Panjang array: 0 hingga 20.
	object	No	Tag yang akan diikat ke grup keamanan.
key	string	No	Kunci tag grup keamanan. Catatan Untuk meningkatkan kompatibilitas, gunakan parameter Tag.N.Key.	null
Key	string	No	Kunci tag grup keamanan. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag tidak boleh berisi `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag grup keamanan. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh berisi `http://` atau `https://`.	TestValue
value	string	No	Nilai tag grup keamanan. Catatan Untuk meningkatkan kompatibilitas, gunakan parameter Tag.N.Value.	null

Elemen respons

Element	Type	Description	Example
	object
SecurityGroupId	string	ID grup keamanan.	sg-bp1fg655nh68xyz9****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "SecurityGroupId": "sg-bp1fg655nh68xyz9****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.
400	InvalidSecurityGroupDiscription.Malformed	Specified security group description is not valid.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	InvalidTagKey.Malformed	Specified tag key is not valid.
400	InvalidTagValue.Malformed	Specified tag value is not valid.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	InvalidParams.GroupType	The specified security group type is not valid.
400	InvalidParams.VpcIdGroupType	Only VPC instance supports enterprise level security group.
400	InvalidSecurityGroupName.Malformed	The specified parameter SecurityGroupName is not valid.
500	InternalError	The request processing has failed due to some unknown error.
500	ServiceUnavailable	The service is unavailable, please try again later.
403	QuotaExceed.SecurityGroup	The maximum number of security groups is reached.
403	InvalidVpcId.NotFound	The VpcId must not empty when only support vpc vm.
403	IncorrectVpcStatus	Current VPC status does not support this operation.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.
403	QuotaExceed.Tags	%s
403	InvalidOperation.ResourceManagedByCloudProduct	%s
404	InvalidRegionId.NotFound	The specified region does not exist.
404	InvalidVpcId.NotFound	Specified VPC does not exist.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.