ModifySecurityGroupEgressRule - - Alibaba Cloud Documentation Center

Memodifikasi deskripsi aturan outbound dalam security group.

Description

Saat memodifikasi aturan security group dengan menentukan ID aturannya, perhatikan batasan berikut:

Objek otorisasi security group dapat berupa salah satu dari jenis berikut: alamat IP atau Blok CIDR, security group, atau daftar prefiks (prefix list). Jenis objek otorisasi yang sudah ada tidak dapat diubah. Misalnya, jika objek otorisasi asli berupa alamat IP, Anda dapat menggantinya dengan alamat IP lain atau Blok CIDR, tetapi tidak dapat diubah menjadi security group atau daftar prefiks.
Family alamat IP dari objek otorisasi tidak dapat diubah. Contohnya, jika objek otorisasi asli berupa Blok CIDR IPv4, Anda tidak dapat mengubahnya menjadi Blok CIDR IPv6. Demikian pula, jika objek otorisasi asli berupa daftar prefiks dengan family alamat IPv4, Anda tidak dapat mengubahnya menjadi daftar prefiks dengan family alamat IPv6.
Aturan security group yang dimodifikasi tidak boleh identik dengan aturan lain yang sudah ada.
Anda tidak dapat menghapus nilai parameter yang telah diisi. Sebagai gantinya, kami menyarankan untuk membuat aturan baru dan menghapus aturan aslinya.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifySecurityGroupEgressRule	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifySecurityGroupEgressRule.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari security group sumber. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token client. Pastikan setiap permintaan menggunakan token client yang unik. Nilai ClientToken hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.
SecurityGroupId	String	Yes	sg-bp67acfmxazb4p****	ID security group.
SecurityGroupRuleId	String	No	sgr-bp67acfmxazb4q****	ID aturan security group. Parameter ini wajib ditentukan saat Anda perlu memodifikasi aturan dengan menentukan ID-nya.
Policy	String	No	accept	Kebijakan otorisasi. Nilai yang valid: accept: mengizinkan akses. drop: menolak akses dan tidak mengembalikan respons apa pun. Nilai default: accept.
Priority	String	No	1	Prioritas aturan security group N. Nilai yang valid: 1 hingga 100. Nilai default: 1.
IpProtocol	String	Yes	tcp	Protokol lapisan transport. Nilai parameter ini tidak peka huruf besar/kecil. Nilai yang valid: ICMP GRE TCP UDP ALL: semua protokol didukung.
DestCidrIp	String	No	10.0.0.0/8	Blok CIDR IPv4 tujuan. Blok CIDR dan alamat IPv4 didukung. Parameter ini kosong secara default.
Ipv6DestCidrIp	String	No	2001:db8:1233:1a00::***	Blok CIDR IPv6 tujuan. Blok CIDR dan alamat IPv6 didukung. Catatan Hanya alamat IP instans dalam virtual private cloud (VPC) yang didukung. Anda tidak dapat menentukan parameter Ipv6DestCidrIp dan parameter `DestCidrIp` secara bersamaan. Parameter ini kosong secara default.
DestGroupId	String	No	sg-bp67acfmxa123b****	ID security group tujuan. Anda harus menentukan minimal salah satu dari parameter `DestGroupId` dan `DestCidrIp`. Minimal salah satu dari DestGroupId, DestCidrIp, Ipv6DestCidrIp, dan DestPrefixListId harus ditentukan. Jika DestGroupId ditentukan tetapi DestCidrIp tidak, parameter NicType hanya dapat diatur ke intranet. Jika DestGroupId dan DestCidrIp keduanya ditentukan, DestCidrIp memiliki prioritas lebih tinggi.
DestPrefixListId	String	No	pl-x1j1k5ykzqlixdcy****	ID daftar prefiks tujuan. Anda dapat memanggil operasi DescribePrefixLists untuk mengambil ID daftar prefiks yang tersedia. Jika Anda menentukan `DestCidrIp`, `Ipv6DestCidrIp`, atau `DestGroupId`, parameter ini akan diabaikan.
PortRange	String	Yes	80/80	Rentang port tujuan yang sesuai dengan protokol lapisan transport untuk aturan security group N. Nilai yang valid: Jika parameter IpProtocol diatur ke tcp atau udp, rentang nomor port adalah 1 hingga 65535. Nomor port awal dan nomor port akhir dipisahkan oleh garis miring (/). Contoh: 1/200. Jika parameter IpProtocol diatur ke icmp, rentang nomor port adalah -1/-1, yang menunjukkan semua port. Jika parameter IpProtocol diatur ke gre, rentang nomor port adalah -1/-1, yang menunjukkan semua port. Jika parameter IpProtocol diatur ke all, rentang nomor port adalah -1/-1, yang menunjukkan semua port.
SourceCidrIp	String	No	10.0.0.0/8	Blok CIDR IPv4 sumber. Blok CIDR dan alamat IPv4 didukung. Parameter ini kosong secara default.
Ipv6SourceCidrIp	String	No	2001:db8:1234:1a00::***	Blok CIDR IPv6 sumber. Blok CIDR dan alamat IPv6 didukung. Catatan Hanya alamat IP instans dalam VPC yang didukung. Anda tidak dapat menentukan parameter Ipv6SourceCidrIp dan parameter `SourceCidrIp` secara bersamaan. Parameter ini kosong secara default.
SourcePortRange	String	No	80/80	Rentang port sumber yang sesuai dengan protokol lapisan transport. Nilai yang valid: Jika parameter IpProtocol diatur ke tcp atau udp, rentang nomor port adalah 1 hingga 65535. Nomor port awal dan nomor port akhir dipisahkan oleh garis miring (/). Contoh: 1/200. Jika parameter IpProtocol diatur ke icmp, rentang nomor port adalah -1/-1, yang menunjukkan semua port. Jika parameter IpProtocol diatur ke gre, rentang nomor port adalah -1/-1, yang menunjukkan semua port. Jika parameter IpProtocol diatur ke all, rentang nomor port adalah -1/-1, yang menunjukkan semua port.
DestGroupOwnerAccount	String	No	EcsforCloud@Alibaba.com	Akun Alibaba Cloud yang mengelola security group tujuan saat Anda menetapkan aturan security group N lintas akun.
DestGroupOwnerId	Long	No	1234567890	ID Akun Alibaba Cloud yang mengelola security group tujuan saat Anda menetapkan aturan security group N lintas akun.
NicType	String	No	intranet	Anda tidak dapat memodifikasi parameter ini saat memodifikasi aturan security group dengan menentukan ID-nya. Sebagai gantinya, Anda dapat menambahkan aturan baru yang memenuhi kebutuhan Anda dan menghapus aturan asli.
Description	String	No	This is a new securitygroup rule.	Deskripsi aturan security group. Panjang deskripsi harus antara 1 hingga 512 karakter.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=ModifySecurityGroupEgressRule
&SecurityGroupId=sg-bp67acfmxazb4p****
&SecurityGroupRuleId=sgr-dcd43def****
&SourcePrefixListId=pl-x1j1k5ykzqlixdew****
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifySecurityGroupEgressRuleResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</ModifySecurityGroupEgressRuleResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-7AE8-B225-F876FF7BA984"
}

Error codes

HttpCode	Error code	Error message	Description
400	OperationDenied	The specified IpProtocol does not exist or IpProtocol and PortRange do not match.	Pesan kesalahan yang dikembalikan karena parameter IpProtocol yang ditentukan tidak ada atau tidak sesuai dengan parameter PortRange yang ditentukan.
400	InvalidIpProtocol.Malformed	The specified parameter PortRange is not valid.	Pesan kesalahan yang dikembalikan karena parameter IpProtocol atau PortRange yang ditentukan tidak valid.
400	InvalidDestCidrIp.Malformed	The specified parameter DestCidrIp is not valid.	Pesan kesalahan yang dikembalikan karena parameter DestCidrIp yang ditentukan tidak valid.
400	InvalidPolicy.Malformed	The specified parameter Policy is not valid.	Pesan kesalahan yang dikembalikan karena parameter Policy yang ditentukan tidak valid.
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	Pesan kesalahan yang dikembalikan karena parameter NicType yang ditentukan tidak ada.
400	InvalidDestGroupId.Mismatch	Specified security group and destination group are not in the same VPC.	Pesan kesalahan yang dikembalikan karena security group yang ditentukan dan security group tujuan tidak berada dalam VPC yang sama.
400	InvalidDestGroup.NotFound	Specified destination security group does not exist.	Pesan kesalahan yang dikembalikan karena security group tujuan yang ditentukan tidak ada.
400	InvalidPriority.Malformed	The specified parameter Priority is not valid.	Pesan kesalahan yang dikembalikan karena prioritas aturan security group yang ditentukan tidak valid. Masukkan nilai prioritas dalam rentang 1 hingga 100.
400	InvalidPriority.ValueNotSupported	The specified Priority is invalid.	Pesan kesalahan yang dikembalikan karena parameter Priority yang ditentukan tidak valid.
400	InvalidNicType.ValueNotSupported	The specified NicType is not valid.	Pesan kesalahan yang dikembalikan karena parameter NicType yang ditentukan tidak ada.
400	InvalidSecurityGroupDiscription.Malformed	The specified security group rule description is not valid.	Pesan kesalahan yang dikembalikan karena parameter Description yang ditentukan tidak valid.
400	InvalidSecurityGroup.InvalidNetworkType	The specified security group network type is not support this operation, please check the security group network types. For VPC security groups, ClassicLink must be enabled.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung pada jenis jaringan security group saat ini. Anda harus mengaktifkan ClassicLink untuk security group dalam VPC.
400	MissingParameter.Dest	One of the parameters DestCidrIp, DestGroupId or DestPrefixListId must be specified.	Pesan kesalahan yang dikembalikan karena parameter DestCidrIp, DestGroupId, dan DestPrefixListId semuanya kosong. Minimal salah satu parameter harus ditentukan.
400	InvalidIpProtocol.ValueNotSupported	The specified parameter IpProtocol should not be null and only tcp, udp, icmp, gre or all is supported. Ignore case.	Pesan kesalahan yang dikembalikan karena parameter IpProtocol yang ditentukan tidak valid. Nilai yang valid untuk parameter ini adalah tcp, udp, icmp, gre, dan all.
400	InvalidPriority.ValueNotSupported	The parameter Priority is invalid.	Pesan kesalahan yang dikembalikan karena parameter Priority yang ditentukan tidak valid.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	Pesan kesalahan yang dikembalikan karena parameter SourcePortRange yang ditentukan tidak valid.
400	InvalidParam.SourceCidrIp	The specified param SourceCidrIp is not valid.	Pesan kesalahan yang dikembalikan karena parameter SourceCidrIp yang ditentukan tidak valid.
400	InvalidParam.DestCidrIp	The specified param DestCidrIp is not valid.	Pesan kesalahan yang dikembalikan karena parameter DestCidrIp yang ditentukan tidak valid.
400	InvalidParameter.Conflict	IPv6 and IPv4 addresses cannot exist at the same time.	Pesan kesalahan yang dikembalikan karena alamat IPv6 dan alamat IPv4 keduanya ditentukan.
403	InvalidDestGroupId.Mismatch	NicType is required or NicType expects intranet.	Pesan kesalahan yang dikembalikan karena parameter NicType tidak ditentukan atau tidak diatur ke intranet.
403	MissingParameter	The input parameter DestGroupId or DestCidrIp cannot be both blank.	Pesan kesalahan yang dikembalikan karena parameter DestGroupId dan DestCidrIp tidak boleh kosong secara bersamaan.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.	Pesan kesalahan yang dikembalikan karena jumlah maksimum aturan dalam security group telah tercapai.
403	InvalidParamter.Conflict	The specified SecurityGroupId should be different from the SourceGroupId.	Pesan kesalahan yang dikembalikan karena security group tujuan sama dengan security group sumber.
403	InvalidNetworkType.Conflict	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	Pesan kesalahan yang dikembalikan karena jenis jaringan security group yang ditentukan berbeda dengan jenis jaringan security group sumber.
403	InvalidSecurityGroup.IsSame	The authorized SecurityGroupId should be different from the DestGroupId.	Pesan kesalahan yang dikembalikan karena security group yang diberi otorisasi tidak boleh sama dengan security group tujuan saat ini.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Pesan kesalahan yang dikembalikan karena security group yang dikelola oleh layanan cloud tidak dapat dimodifikasi.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	Pesan kesalahan yang dikembalikan karena security group yang ditentukan tidak ada dalam akun ini. Periksa apakah ID security group sudah benar.
404	InvalidDestGroupId.NotFound	The DestGroupId provided does not exist in our records.	Pesan kesalahan yang dikembalikan karena parameter DestGroupId yang ditentukan tidak ada.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	Pesan kesalahan yang dikembalikan karena daftar prefiks yang ditentukan tidak ada.
500	InternalError	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.