Bir güvenlik grubunda bir veya daha fazla gelen kural oluşturur. Oluşturulan kuralları kullanarak, diğer ana bilgisayarlardan güvenlik grubundaki örneklere gelen trafiğe izin verebilir veya bu trafiği reddedebilirsiniz.
Açıklama
Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:
Her güvenlik grubundaki giden ve gelen kuralların toplam sayısı 200'ü aşamaz. Daha fazla bilgi için bkz. Sınırlar bölümündeki "Güvenlik grubu sınırları" kısmı.
Öncelik parametresinin geçerli değer aralığı 1 ile 100 arasındadır. Daha küçük bir değer, daha yüksek önceliği gösterir.
Birden çok güvenlik grubu kuralının aynı önceliğe sahip olması durumunda, reddetme (drop) kuralları önceliklidir.
Kaynak; SourceCidrIp, Ipv6SourceCidrIp veya SourcePrefixListId ile belirtilen bir CIDR bloğu ya da SourceGroupId ile belirtilen bir güvenlik grubundaki Elastic Compute Service (ECS) örnekleri olabilir.
Gelişmiş güvenlik gruplarının kurallarında, güvenlik grupları yetkilendirme nesnesi (hedef veya kaynak) olarak referans gösterilemez.
Temel güvenlik gruplarının her birindeki kurallarda, yetkilendirme nesnesi olarak en fazla 20 güvenlik grubu referans gösterilebilir.
Belirtilen güvenlik grubu kuralı zaten varsa, AuthorizeSecurityGroup çağrısı başarılı olur ancak yeni bir güvenlik grubu kuralı oluşturulmaz.
Parametreler ve bunların
Permissions.Nöneki içeren karşılıkları aynı anda belirtilemez.Permissions.Nönekli parametreleri kullanmanızı öneririz.-
Aşağıdaki parametre gruplarından birini belirterek bir güvenlik grubu kuralı tanımlayabilirsiniz. Bir güvenlik grubu kuralını yalnızca tek bir parametre belirterek tanımlayamazsınız.
-
Belirli bir CIDR bloğundan erişimi kontrol eden gelen bir güvenlik grubu kuralını tanımlamak için kullanılan parametreler: IpProtocol, PortRange, SourcePortRange (isteğe bağlı), NicType, Policy ve SourceCidrIp. Sanal Özel Cloud (VPC) türündeki bir güvenlik grubu için NicType parametresini intranet olarak ayarlamanız gerekir. Klasik ağ türündeki bir güvenlik grubu için NicType parametresini internet veya intranet olarak ayarlayabilirsiniz. Örnek istek:
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup &SecurityGroupId=sg-bp67acfmxazb4p**** &Permissions.1.SourceCidrIp=10.0.0.0/8 &Permissions.1.IpProtocol=TCP &Permissions.1.PortRange=22/22 &Permissions.1.NicType=intranet &Permissions.1.Policy=Accept &<Common request parameters> -
Bir güvenlik grubundan erişimi kontrol eden gelen bir güvenlik grubu kuralını tanımlamak için kullanılan parametreler: IpProtocol, PortRange, SourcePortRange (isteğe bağlı), NicType, Policy, SourceGroupOwnerAccount ve SourceGroupId. Bu durumda, NicType parametresini intranet olarak ayarlamanız gerekir. Klasik ağdaki güvenlik grupları arasında karşılıklı erişim için, aynı bölgedeki başka bir güvenlik grubunun sizin güvenlik grubunuza erişimine izin verebilir veya bu erişimi reddedebilirsiniz. Sizin güvenlik grubunuza erişmesine izin verilen güvenlik grubu, kendi Alibaba Cloud hesabınıza ait olabilir veya SourceGroupOwnerAccount parametresiyle belirtilen başka bir Alibaba Cloud hesabına ait olabilir. VPC'lerdeki güvenlik grupları arasında karşılıklı erişim için, aynı VPC içindeki başka bir güvenlik grubunun sizin güvenlik grubunuza erişimine izin verebilir veya bu erişimi reddedebilirsiniz. Örnek istek:
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup &SecurityGroupId=sg-bp67acfmxazb4p**** &Permissions.1.SourceGroupId=sg-1651FBB** &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com &Permissions.1.IpProtocol=TCP &Permissions.1.PortRange=22/22 &Permissions.1.NicType=intranet &Permissions.1.Policy=Drop &<Common request parameters> -
Bir ön ek listesinden erişimi kontrol eden gelen bir güvenlik grubu kuralını tanımlamak için kullanılan parametreler: IpProtocol, PortRange, SourcePortRange (isteğe bağlı), NicType, Policy ve SourcePrefixListId. Bu durumda, ön ek listeleri yalnızca VPC'lerdeki güvenlik gruplarını destekler. NicType parametresi intranet olarak ayarlanmalıdır. Örnek istek:
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup &SecurityGroupId=sg-bp67acfmxazb4p**** &Permissions.1.SourcePrefixListId=pl-x1j1k5ykzqlixdcy**** &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com &Permissions.1.IpProtocol=TCP &Permissions.1.PortRange=22/22 &Permissions.1.NicType=intranet &Permissions.1.Policy=Drop &<Common request parameters>
-
Güvenlik grubu kuralı ayarlarına ilişkin örnekler için bkz. Farklı kullanım durumları için güvenlik grupları ve Güvenlik grubu beşli kuralı.
Hata Ayıklama
İstek parametreleri
| Parametre | Tür | Gerekli | Örnek | Açıklama |
| Action | String | Evet | AuthorizeSecurityGroup | Gerçekleştirmek istediğiniz işlem. Değeri AuthorizeSecurityGroup olarak ayarlayın. |
| RegionId | String | Evet | cn-hangzhou | Güvenlik grubunun bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. |
| ClientToken | String | Hayır | 123e4567-e89b-12d3-a456-426655440000 | İsteğin tekilleğini (idempotence) sağlamak için kullanılan istemci belirteci. Değeri istemci aracılığıyla oluşturabilirsiniz ancak farklı istekler arasında değerin benzersiz olduğundan emin olmanız gerekir. ClientToken değeri yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için bkz. Tekillik nasıl sağlanır. |
| SecurityGroupId | String | Evet | sg-bp67acfmxazb4p**** | Güvenlik grubunun kimliği. |
| Permissions.N.Policy | String | Hayır | accept | N. güvenlik grubu kuralının gelen erişime izin verip vermeyeceğini belirleyen eylem. Geçerli değerler:
Varsayılan değer: accept. N için geçerli değerler: 1 ile 100. |
| Permissions.N.Priority | String | Hayır | 1 | N. güvenlik grubu kuralının önceliği. Daha küçük bir değer, daha yüksek önceliği gösterir. Geçerli değerler: 1 ile 100. Varsayılan değer: 1. N için geçerli değerler: 1 ile 100. |
| Permissions.N.IpProtocol | String | Hayır | ALL | N. güvenlik grubu kuralının aktarım katmanı protokolü. Bu parametrenin değeri büyük/küçük harfe duyarlı değildir. Geçerli değerler:
N için geçerli değerler: 1 ile 100. |
| Permissions.N.SourceCidrIp | String | Hayır | 10.0.0.0/8 | N. güvenlik grubu kuralı için kaynak IPv4 CIDR bloğu. CIDR blokları ve IPv4 adresleri desteklenir. N için geçerli değerler: 1 ile 100. |
| Permissions.N.Ipv6SourceCidrIp | String | Hayır | 2001:250:6000::*** | N. güvenlik grubu kuralı için kaynak IPv6 CIDR bloğu. CIDR blokları ve IPv6 adresleri desteklenir. N için geçerli değerler: 1 ile 100. Not Permissions.N.Ipv6SourceCidrIp parametresi yalnızca kaynak, IPv6 CIDR bloklarını destekleyen ve VPC'lerde bulunan ECS örnekleri olduğunda geçerlidir. Bu parametre ile SourceCidrIp parametresini aynı anda belirtemezsiniz. |
| Permissions.N.SourceGroupId | String | Hayır | sg-bp67acfmxazb4p**** | N. güvenlik grubu kuralında referans gösterilecek kaynak güvenlik grubunun kimliği.
N için geçerli değerler: 1 ile 100. Aşağıdaki hususlara dikkat edin:
|
| Permissions.N.SourcePrefixListId | String | Hayır | pl-x1j1k5ykzqlixdcy**** | N. güvenlik grubu kuralında referans gösterilecek kaynak ön ek listesinin kimliği. Kullanılabilir ön ek listelerinin kimliklerini sorgulamak için DescribePrefixLists işlemini çağırabilirsiniz. N için geçerli değerler: 1 ile 100. Aşağıdaki hususlara dikkat edin:
|
| Permissions.N.PortRange | String | Hayır | 80/80 | N. güvenlik grubu kuralı için aktarım katmanı protokolüne karşılık gelen hedef bağlantı noktası aralığı. Geçerli değerler:
Daha fazla bilgi için bkz. Yaygın olarak kullanılan bağlantı noktalarının tipik uygulamaları. N için geçerli değerler: 1 ile 100. |
| Permissions.N.DestCidrIp | String | Hayır | 10.0.0.0/8 | N. güvenlik grubu kuralı için hedef IPv4 CIDR bloğu. CIDR blokları ve IPv4 adresleri desteklenir. Bu parametre, beşli kurallar tarafından desteklenir. Daha fazla bilgi için bkz. Güvenlik grubu beşli kuralı. N için geçerli değerler: 1 ile 100. |
| Permissions.N.Ipv6DestCidrIp | String | Hayır | 2001:250:6000::*** | N. güvenlik grubu kuralı için hedef IPv6 CIDR bloğu. CIDR blokları ve IPv6 adresleri desteklenir. Bu parametre, beşli kurallar tarafından desteklenir. Daha fazla bilgi için bkz. Güvenlik grubu beşli kuralı. N için geçerli değerler: 1 ile 100. Not Permissions.N.Ipv6DestCidrIp parametresi yalnızca hedef, IPv6 CIDR bloklarını destekleyen ve VPC'lerde bulunan ECS örnekleri olduğunda geçerlidir. Bu parametre ile DestCidrIp parametresini aynı anda belirtemezsiniz. |
| Permissions.N.SourcePortRange | String | Hayır | 7000/8000 | N. güvenlik grubu kuralı için aktarım katmanı protokolüne karşılık gelen kaynak bağlantı noktası aralığı. Geçerli değerler:
Bu parametre, beşli kurallar tarafından desteklenir. Daha fazla bilgi için bkz. Güvenlik grubu beşli kuralı. N için geçerli değerler: 1 ile 100. |
| Permissions.N.SourceGroupOwnerAccount | String | Hayır | test@aliyun.com | Hesaplar arası N. güvenlik grubu kuralını ayarlarken, kaynak güvenlik grubunu yöneten Alibaba Cloud hesabı.
N için geçerli değerler: 1 ile 100. |
| Permissions.N.SourceGroupOwnerId | Long | Hayır | 1234567890 | Hesaplar arası N. güvenlik grubu kuralını ayarlarken, kaynak güvenlik grubunu yöneten Alibaba Cloud hesabının kimliği.
N için geçerli değerler: 1 ile 100. |
| Permissions.N.NicType | String | Hayır | intranet | Güvenlik grubu klasik ağda bulunduğunda, güvenlik grubu kuralının ağ arayüz denetleyicisi (NIC) türü. Geçerli değerler:
Güvenlik grubu bir VPC'de bulunuyorsa, bu parametre varsayılan olarak intranet olarak ayarlanır ve değiştirilemez. Güvenlik grupları arasında erişimi yapılandırırken yalnızca DestGroupId belirtirseniz, bu parametre intranet olarak ayarlanmalıdır. Varsayılan değer: internet. N için geçerli değerler: 1 ile 100. |
| Permissions.N.Description | String | Hayır | This is description. | N. güvenlik grubu kuralının açıklaması. Açıklamanın uzunluğu 1 ile 512 karakter arasında olmalıdır. N için geçerli değerler: 1 ile 100. |
| Policy | String | Hayır | accept | Bu parametre kullanımdan kaldırılmıştır. Gelen erişime izin verilip verilmeyeceğini belirtmek için |
| Priority | String | Hayır | 1 | Bu parametre kullanımdan kaldırılmıştır. Kural önceliğini belirtmek için |
| IpProtocol | String | Hayır | ALL | Bu parametre kullanımdan kaldırılmıştır. Aktarım katmanı protokolünü belirtmek için |
| SourceCidrIp | String | Hayır | 10.0.0.0/8 | Bu parametre kullanımdan kaldırılmıştır. Kaynak IPv4 CIDR bloğunu belirtmek için |
| Ipv6SourceCidrIp | String | Hayır | 2001:250:6000::*** | Bu parametre kullanımdan kaldırılmıştır. Kaynak IPv6 CIDR bloğunu belirtmek için |
| SourceGroupId | String | Hayır | sg-bp67acfmxazb4p**** | Bu parametre kullanımdan kaldırılmıştır. Kaynak güvenlik grubunun kimliğini belirtmek için |
| SourcePrefixListId | String | Hayır | pl-x1j1k5ykzqlixdcy**** | Bu parametre kullanımdan kaldırılmıştır. Kaynak ön ek listesinin kimliğini belirtmek için |
| PortRange | String | Hayır | 22/22 | Bu parametre kullanımdan kaldırılmıştır. Hedef bağlantı noktası aralığını belirtmek için |
| DestCidrIp | String | Hayır | 10.0.0.0/8 | Bu parametre kullanımdan kaldırılmıştır. Hedef IPv4 CIDR bloğunu belirtmek için |
| Ipv6DestCidrIp | String | Hayır | 2001:250:6000::*** | Bu parametre kullanımdan kaldırılmıştır. Hedef IPv6 CIDR bloğunu belirtmek için |
| SourcePortRange | String | Hayır | 22/22 | Bu parametre kullanımdan kaldırılmıştır. Kaynak bağlantı noktası aralığını belirtmek için |
| SourceGroupOwnerAccount | String | Hayır | test@aliyun.com | Bu parametre kullanımdan kaldırılmıştır. Kaynak güvenlik grubunu yöneten Alibaba Cloud hesabını belirtmek için |
| SourceGroupOwnerId | Long | Hayır | 1234567890 | Bu parametre kullanımdan kaldırılmıştır. Kaynak güvenlik grubunu yöneten Alibaba Cloud hesabının kimliğini belirtmek için |
| NicType | String | Hayır | intranet | Bu parametre kullanımdan kaldırılmıştır. NIC türünü belirtmek için |
| Description | String | Hayır | This is description. | Bu parametre kullanımdan kaldırılmıştır. N. güvenlik grubu kuralının açıklamasını belirtmek için |
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
|
Örnekler
Örnek istekler
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&SecurityGroupId=sg-bp67acfmxazb4p****
&Permissions.1.SourceCidrIp=10.0.0.0/8
&Permissions.1.IpProtocol=TCP
&Permissions.1.PortRange=22/22
&Permissions.1.NicType=intranet
&Permissions.1.Policy=accept
&Common request parameters
Örnek başarılı yanıt
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<AuthorizeSecurityGroupResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AuthorizeSecurityGroupResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
Hata kodları
| HttpCode | Hata kodu | Hata mesajı | Açıklama |
| 400 | OperationDenied | The specified IpProtocol does not exist or IpProtocol and PortRange do not match. | Belirtilen IpProtocol parametresi mevcut değil veya belirtilen PortRange parametresiyle eşleşmiyor. |
| 400 | InvalidIpProtocol.Malformed | The specified parameter PortRange is not valid. | Belirtilen IpProtocol veya PortRange parametresi geçersiz. |
| 400 | InvalidSourceCidrIp.Malformed | The specified parameter SourceCidrIp is not valid. | Belirtilen kaynak CIDR bloğu geçersiz. |
| 400 | InvalidPolicy.Malformed | The specified parameter Policy is not valid. | Belirtilen Policy parametresi geçersiz. |
| 400 | InvalidNicType.ValueNotSupported | The specified NicType does not exist. | Belirtilen NicType parametresi mevcut değil. |
| 400 | InvalidSourceGroupId.Mismatch | Specified security group and source group are not in the same VPC. | Belirtilen güvenlik grubu ve kaynak güvenlik grubu aynı VPC'ye ait değil. |
| 400 | InvalidSourceGroup.NotFound | Specified source security group does not exist. | Belirtilen gelen güvenlik grubu kuralı mevcut değil veya ilgili parametreler belirtilmemiş. |
| 400 | InvalidPriority.Malformed | The parameter Priority is invalid. | Belirtilen Priority parametresi geçersiz. |
| 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. | Güvenlik grubu mevcut ağ türündeyken işlem desteklenmiyor. VPC'lerdeki güvenlik grupları için ClassicLink etkinleştirilmelidir. |
| 400 | InvalidSecurityGroupId.Malformed | The specified parameter SecurityGroupId is not valid. | Belirtilen SecurityGroupId parametresi geçersiz. |
| 400 | InvalidParamter.Conflict | The specified SourceCidrIp should be different from the DestCidrIp. | SourceCidrIp değeri DestCidrIp değeriyle aynı. |
| 400 | InvalidSourcePortRange.Malformed | The specified parameter SourcePortRange is not valid. | Belirtilen SourcePortRange parametresi geçersiz. |
| 400 | InvalidDestCidrIp.Malformed | The specified parameter DestCidrIp is not valid. | Belirtilen DestCidrIp parametresi geçersiz. |
| 400 | InvalidParameter.Conflict | IPv6 and IPv4 addresses cannot exist at the same time. | Hem IPv6 adresleri hem de IPv4 adresleri belirtilmiş. |
| 400 | InvalidParam.PrefixListAddressFamilyMismatch | The address family of the specified prefix list does not match the specified CidrIp. | Belirtilen ön ek listesinin adres ailesi, belirtilen CIDR bloğunun adres ailesiyle eşleşmiyor. |
| 400 | NotSupported.ClassicNetworkPrefixList | The prefix list is not supported when the network type of security group is classic. | Klasik ağdaki güvenlik grupları ön ek listelerini desteklemez. |
| 400 | InvalidParam.SourceCidrIp | The specified param SourceCidrIp is not valid. | Belirtilen SourceCidrIp parametresi geçersiz. |
| 400 | InvalidParam.DestCidrIp | The specified param DestCidrIp is not valid. | Belirtilen DestCidrIp parametresi geçersiz. |
| 400 | MissingParameter | %s | Gerekli bir parametre belirtilmemiş. |
| 400 | InvalidParam.Permissions | The specified parameter Permissions cannot coexist with other parameters. | Permissions önekli bir parametre, Permissions öneki olmayan karşılık gelen parametreyle aynı anda belirtilemez. |
| 400 | InvalidParam.DuplicatePermissions | There are duplicate permissions in the specified parameter Permissions. | Permissions önekli parametrelerle belirtilen güvenlik grubu kuralları yineleniyor. |
| 403 | InvalidSourceGroupId.Mismatch | NicType is required or NicType expects intranet. | NicType parametresi belirtilmemiş veya intranet olarak ayarlanmamış. |
| 403 | MissingParameter | The input parameter SourceGroupId or SourceCidrIp cannot be both blank. | SourceGroupId ve SourceCidrIp parametrelerinden en az biri belirtilmelidir. |
| 403 | AuthorizationLimitExceed | The limit of authorization records in the security group reaches. | Güvenlik grubundaki maksimum kural sayısına ulaşıldı. |
| 403 | InvalidParamter.Conflict | The specified SecurityGroupId should be different from the SourceGroupId. | Hedef güvenlik grubu, kaynak güvenlik grubuyla aynı. |
| 403 | InvalidNetworkType.Mismatch | The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic). | Belirtilen güvenlik grubunun ağ türü, kaynak güvenlik grubunun ağ türünden farklı. |
| 403 | InvalidNetworkType.Conflict | The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic). | Belirtilen güvenlik grubunun ağ türü, kaynak güvenlik grubunun ağ türünden farklı. |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | Cloud hizmetleri tarafından yönetilen güvenlik grupları değiştirilemez. |
| 403 | LimitExceed.PrefixListAssociationResource | The number of resources associated with the prefix list exceeds the limit. | Ön ek listesiyle ilişkilendirilebilecek maksimum kaynak sayısına ulaşıldı. |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | Belirtilen güvenlik grubu bu hesapta mevcut değil. Güvenlik grubu kimliğinin doğru olup olmadığını kontrol edin. |
| 404 | InvalidSourceGroupId.NotFound | The SourceGroupId provided does not exist in our records. | Belirtilen SourceGroupId parametresi mevcut değil. |
| 404 | InvalidPrefixListId.NotFound | The specified prefix list was not found. | Belirtilen ön ek listesi mevcut değil. |
| 404 | InvalidSecurityGroupId.NotFound | %s | Belirtilen güvenlik grubu kimliği mevcut değil. |
| 500 | InternalError | The request processing has failed due to some unknown error. | Dahili bir hata oluştu. Daha sonra tekrar deneyin. |
Hata kodlarının listesi için bkz. Hizmet hata kodları.