All Products
Search

This Product

    :ModifySecurityGroupRule

    Document Center

    :ModifySecurityGroupRule

    Last Updated:May 22, 2026

    Memodifikasi deskripsi aturan inbound dalam security group.

    Description

    Saat memodifikasi aturan security group dengan menentukan ID aturan, 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.
    • Famili 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 famili alamat IPv4, Anda tidak dapat mengubahnya menjadi daftar prefiks dengan famili 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 agar Anda membuat aturan baru dan menghapus aturan asli.

    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

    ParameterTypeRequiredExampleDescription
    ActionStringYesModifySecurityGroupRule

    Operasi yang ingin Anda lakukan. Tetapkan nilai ke ModifySecurityGroupRule.

    RegionIdStringYescn-hangzhou

    ID Wilayah dari security group tujuan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar Wilayah terbaru.

    ClientTokenStringNo123e4567-e89b-12d3-a456-426655440000

    Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token client. Pastikan token client yang unik digunakan untuk setiap permintaan. Nilai ClientToken hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat How to ensure idempotence.

    SecurityGroupIdStringYessg-bp67acfmxazb4p****

    ID dari security group.

    SecurityGroupRuleIdStringNosgr-bp67acfmxa123b***

    ID aturan security group.

    Parameter ini diperlukan saat Anda perlu mengubah aturan dengan menentukan ID-nya.

    PolicyStringNoaccept

    Kebijakan otorisasi. Nilai yang valid:

    • accept: mengizinkan akses.
    • drop: menolak akses dan tidak mengembalikan tanggapan apa pun.

    Nilai default: accept.

    PriorityStringNo1

    Prioritas aturan security group N. Nilai yang valid: 1 hingga 100.

    Nilai default: 1.

    IpProtocolStringNoall

    Protokol lapisan transport. Nilai parameter ini tidak peka huruf besar/kecil. Nilai yang valid:

    • ICMP
    • GRE
    • TCP
    • UDP
    • ALL: semua protokol didukung.
    SourceCidrIpStringNo10.0.0.0/8

    Blok CIDR IPv4 sumber yang ingin Anda kendalikan aksesnya. Blok CIDR dan alamat IPv4 didukung.

    Parameter ini kosong secara default.

    Ipv6SourceCidrIpStringNo2001:db8:1233:1a00::***

    Blok CIDR IPv6 sumber. Blok CIDR dan alamat IPv6 didukung.

    Catatan Hanya alamat IP dari instans di virtual private cloud (VPC) yang didukung. Anda tidak dapat menentukan parameter Ipv6SourceCidrIp dan parameter SourceCidrIp secara bersamaan.

    Parameter ini kosong secara default.

    SourceGroupIdStringNosg-bp67acfmxa123b****

    ID security group sumber. Setidaknya salah satu dari SourceGroupId dan SourceCidrIp harus ditentukan.

    • Jika SourceGroupId ditentukan tetapi SourceCidrIp tidak ditentukan, parameter NicType harus diatur ke intranet.
    • Jika SourceGroupId dan SourceCidrIp keduanya ditentukan, SourceCidrIp memiliki prioritas lebih tinggi.
    SourcePrefixListIdStringNopl-x1j1k5ykzqlixdcy****

    ID daftar prefiks sumber yang ingin Anda kendalikan aksesnya. Anda dapat memanggil operasi DescribePrefixLists untuk mengkueri ID daftar prefiks yang tersedia.

    Jika Anda menentukan parameter SourceCidrIp, Ipv6SourceCidrIp, atau SourceGroupId, parameter ini akan diabaikan.

    PortRangeStringNo80/80

    Kisaran port tujuan yang sesuai dengan protokol lapisan transport untuk aturan security group N. Nilai yang valid:

    • Jika parameter IpProtocol diatur ke tcp atau udp, kisaran 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, kisaran nomor port adalah -1/-1, yang menunjukkan semua port.
    • Jika parameter IpProtocol diatur ke gre, kisaran nomor port adalah -1/-1, yang menunjukkan semua port.
    • Jika parameter IpProtocol diatur ke all, kisaran nomor port adalah -1/-1, yang menunjukkan semua port.
    DestCidrIpStringNo10.0.0.0/8

    Blok CIDR IPv4 tujuan. Blok CIDR dan alamat IPv4 didukung.

    Parameter ini kosong secara default.

    Ipv6DestCidrIpStringNo2001:db8:1234:1a00::***

    Blok CIDR IPv6 tujuan. Blok CIDR dan alamat IPv6 didukung.

    Catatan Hanya alamat IP dari instans dalam VPC yang didukung. Anda tidak dapat menentukan parameter Ipv6DestCidrIp dan parameter DestCidrIp secara bersamaan.

    Parameter ini kosong secara default.

    SourcePortRangeStringNo80/80

    Kisaran source ports yang sesuai dengan protokol lapisan transport. Nilai yang valid:

    • Jika parameter IpProtocol diatur ke tcp atau udp, kisaran 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, kisaran nomor port adalah -1/-1, yang menunjukkan semua port.
    • Jika parameter IpProtocol diatur ke gre, kisaran nomor port adalah -1/-1, yang menunjukkan semua port.
    • Jika parameter IpProtocol diatur ke all, kisaran nomor port adalah -1/-1, yang menunjukkan semua port.
    SourceGroupOwnerAccountStringNoEcsforCloud@Alibaba.com

    Akun Alibaba Cloud yang mengelola security group sumber saat Anda menetapkan aturan security group N lintas akun.

    • Jika SourceGroupOwnerId dan SourceGroupOwnerAccount keduanya kosong, izin akses dikonfigurasi untuk security group lain yang dikelola oleh akun Anda.
    • Jika SourceCidrIp ditentukan, parameter SourceGroupOwnerAccount diabaikan.
    SourceGroupOwnerIdLongNo12345678910

    Akun Alibaba Cloud yang mengelola security group sumber saat Anda menetapkan aturan security group N lintas akun.

    • Jika SourceGroupOwnerId dan SourceGroupOwnerAccount keduanya kosong, izin akses dikonfigurasi untuk security group lain yang dikelola oleh akun Anda.
    • Jika SourceCidrIp ditentukan, parameter SourceGroupOwnerId diabaikan.
    NicTypeStringNointranet

    Anda tidak dapat mengubah 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 aslinya.

    DeskripsiStringNoThis is a new security group rule.

    Deskripsi aturan security group. Panjang deskripsi harus antara 1 hingga 512 karakter.

    Response parameters

    ParameterTypeExampleDescription
    RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID dari permintaan tersebut.

    Examples

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=ModifySecurityGroupRule
&SecurityGroupId=sg-bp67acfmxazb4p****
&SecurityGroupRuleId=sgr-dcd43das****
&SourceCidrIp=10.0.0.0/8
&<Common request parameters>

    Contoh respons sukses

    XML format

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

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

    JSON format

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

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

    Error codes

    HttpCodeError codeError messageDescription
    400OperationDeniedThe 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 cocok dengan parameter PortRange yang ditentukan.
    400InvalidIpProtocol.MalformedThe specified parameter PortRange is not valid.Pesan kesalahan yang dikembalikan karena parameter IpProtocol atau PortRange yang ditentukan tidak valid.
    400InvalidSourceCidrIp.MalformedThe specified parameter SourceCidrIp is not valid.Pesan kesalahan yang dikembalikan karena blok CIDR sumber yang ditentukan tidak valid.
    400InvalidPolicy.MalformedThe specified parameter Policy is not valid.Pesan kesalahan yang dikembalikan karena parameter Policy yang ditentukan tidak valid.
    400InvalidNicType.ValueNotSupportedThe specified NicType does not exist.Pesan kesalahan yang dikembalikan karena parameter NicType yang ditentukan tidak ada.
    400InvalidSourceGroupId.MismatchSpecified security group and source group are not in the same VPC.Pesan kesalahan yang dikembalikan karena grup keamanan yang ditentukan dan grup keamanan sumber tidak berada dalam VPC yang sama.
    400InvalidSourceGroup.NotFoundSpecified source security group does not exist.Pesan kesalahan yang dikembalikan karena aturan grup keamanan masuk yang ditentukan tidak ada atau karena parameter terkait tidak ditentukan.
    400InvalidPriority.MalformedThe parameter Priority is invalid.Pesan kesalahan yang dikembalikan karena parameter Priority yang ditentukan tidak valid.
    400InvalidPriority.ValueNotSupportedThe parameter Priority is invalid.Pesan kesalahan yang dikembalikan karena parameter Priority yang ditentukan tidak valid.
    400InvalidSecurityGroupDiscription.MalformedThe specified security group rule description is not valid.Pesan kesalahan yang dikembalikan karena parameter Description yang ditentukan tidak valid.
    400MissingParameter.SourceOne of the parameters SourceCidrIp, SourceGroupId or SourcePrefixListId must be specified.Pesan kesalahan yang dikembalikan karena parameter SourceCidrIp, SourceGroupId, dan SourcePrefixListId semuanya kosong. Setidaknya satu parameter harus ditentukan.
    400InvalidIpProtocol.ValueNotSupportedThe parameter IpProtocol must be specified with case insensitive TCP, UDP, ICMP, GRE or All.Pesan kesalahan yang dikembalikan karena parameter IpProtocol yang ditentukan tidak valid. Nilai valid untuk parameter ini adalah tcp, udp, icmp, gre, dan all.
    400InvalidSourcePortRange.MalformedThe specified parameter SourcePortRange is not valid.Pesan kesalahan yang dikembalikan karena parameter SourcePortRange yang ditentukan tidak valid.
    400InvalidSecurityGroupId.MalformedThe specified parameter SecurityGroupId is not valid.Pesan kesalahan yang dikembalikan karena parameter SecurityGroupId yang ditentukan tidak valid.
    400InvalidParam.SourceCidrIpThe specified param SourceCidrIp is not valid.Pesan kesalahan yang dikembalikan karena parameter SourceCidrIp yang ditentukan tidak valid.
    400InvalidParam.DestCidrIpThe specified param DestCidrIp is not valid.Pesan kesalahan yang dikembalikan karena parameter DestCidrIp yang ditentukan tidak valid.
    400InvalidParameter.ConflictIPv6 and IPv4 addresses cannot exist at the same time.Pesan kesalahan yang dikembalikan karena alamat IPv6 dan alamat IPv4 keduanya ditentukan.
    403InvalidSourceGroupId.MismatchNicType is required or NicType expects intrnet.Pesan kesalahan yang dikembalikan karena parameter NicType tidak ditentukan atau tidak diatur ke intranet.
    403MissingParameterThe input parameter SourceGroupId or SourceCidrIp cannot be both blank.Pesan kesalahan yang dikembalikan karena parameter SourceGroupId dan SourceCidrIp keduanya kosong. Setidaknya satu dari parameter tersebut harus ditentukan.
    403AuthorizationLimitExceedThe limit of authorization records in the security group reaches.Pesan kesalahan yang dikembalikan karena jumlah maksimum aturan dalam grup keamanan telah tercapai.
    403InvalidParamter.ConflictThe specified SecurityGroupId should be different from the SourceGroupId.Pesan kesalahan yang dikembalikan karena grup keamanan tujuan sama dengan grup keamanan sumber.
    403InvalidNetworkType.MismatchThe specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).Pesan kesalahan yang dikembalikan karena jenis jaringan grup keamanan yang ditentukan berbeda dari jenis jaringan grup keamanan sumber.
    403InvalidOperation.ResourceManagedByCloudProduct%sPesan kesalahan yang dikembalikan karena grup keamanan yang dikelola oleh layanan cloud tidak dapat dimodifikasi.
    404InvalidSecurityGroupId.NotFoundThe specified SecurityGroupId does not exist.Pesan kesalahan yang dikembalikan karena grup keamanan yang ditentukan tidak ada dalam akun ini. Periksa apakah ID grup keamanan sudah benar.
    404InvalidSourceGroupId.NotFoundThe SourceGroupId provided does not exist in our records.Pesan kesalahan yang dikembalikan karena parameter SourceGroupId yang ditentukan tidak ada.
    404SecurityGroupRule.NotFoundThe target security group rule not exist.Pesan kesalahan yang dikembalikan karena aturan grup keamanan yang ditentukan tidak ada.
    404InvalidPrefixListId.NotFoundThe specified prefix list was not found.Pesan kesalahan yang dikembalikan karena daftar awalan yang ditentukan tidak ada.
    500InternalErrorThe 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.