Bir güvenlik grubunda bir veya daha fazla giden kural oluşturur. Oluşturulan kuralları, güvenlik grubundaki örneklerden diğer nesnelere yönelik giden trafiğe izin vermek veya bu trafiği reddetmek için kullanabilirsiniz.
Açıklama
Bu işlemi çağırırken aşağıdaki hususları dikkate alın:
Her bir güvenlik grubundaki toplam giden ve gelen güvenlik grubu kuralı sayısı 200'ü aşamaz. Daha fazla bilgi için bkz. Sınırlar içindeki "Güvenlik grubu sınırları" bölümü.
Her bir güvenlik grubu kuralı için erişime izin vermek veya erişimi reddetmek amacıyla Policy parametresini accept veya drop olarak ayarlayabilirsiniz.
Priority parametresi için geçerli değer aralığı 1 ile 100 arasındadır. Daha küçük bir değer, daha yüksek öncelik anlamına gelir.
Birden çok güvenlik grubu kuralının aynı önceliğe sahip olması durumunda drop (reddet) kuralları önceliklidir.
Hedef; DestCidrIp, Ipv6DestCidrIp veya DestPrefixListId tarafından belirtilen bir CIDR bloğu ya da DestGroupId tarafından belirtilen bir güvenlik grubundaki Elastic Compute Service (ECS) örnekleri olabilir.
Gelişmiş güvenlik grupları için güvenlik grupları yetkilendirme nesnesi olarak kullanılamaz.
Her bir temel güvenlik grubu için en fazla 20 güvenlik grubu yetkilendirme nesnesi olarak kullanılabilir.
Belirtilen güvenlik grubu kuralı güvenlik grubunda zaten varsa AuthorizeSecurityGroupEgress çağrısı başarılı olur ancak yeni bir güvenlik grubu kuralı oluşturulmaz.
Bazı parametrelerin başına
Permissions.Nöneki eklenerek yeni parametreler oluşturulur. Orijinal parametreler ilePermissions.Nönekli karşılıkları birlikte 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ğuna erişimi kontrol eden bir giden güvenlik grubu kuralını belirtmek için kullanılan parametreler: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy ve Permissions.N.DestCidrIp. Permissions.N.SourcePortRange parametresi isteğe bağlıdır. Örnek istek:
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress &SecurityGroupId=sg-bp67acfmxazb4ph*** &Permissions.1.IpProtocol=ICMP &Permissions.1.DestCidrIp=10.0.0.0/8 &Permissions.1.PortRange=-1/-1 &Permissions.1.NicType=intranet &Permissions.1.Policy=Accept &<Common request parameters> -
Bir güvenlik grubuna erişimi kontrol eden bir giden güvenlik grubu kuralını belirtmek için kullanılan parametreler: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, Permissions.N.DestGroupOwnerAccount ve Permissions.N.DestGroupId. Permissions.N.SourcePortRange parametresi isteğe bağlıdır. Örnek istek:
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress &SecurityGroupId=sg-bp67acfmxazb4ph*** &Permissions.1.DestGroupId=sg-bp67acfmxazb4pi*** &Permissions.1.DestGroupOwnerAccount=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 listesine erişimi kontrol eden bir giden güvenlik grubu kuralını belirtmek için kullanılan parametreler: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy ve Permissions.N.DestPrefixListId. Permissions.N.SourcePortRange parametresi isteğe bağlıdır. Bu durumda ön ek listeleri yalnızca sanal özel bulutlardaki (VPC'ler) güvenlik gruplarını destekler. NicType parametresi intranet olarak ayarlanmalıdır. Örnek istek:
http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress &SecurityGroupId=sg-bp67acfmxazb4ph*** &Permissions.1.DestPrefixListId=pl-x1j1k5ykzqlixdcy**** &Permissions.1.DestGroupOwnerAccount=Test@aliyun.com &Permissions.1.IpProtocol=TCP &Permissions.1.PortRange=22/22 &Permissions.1.NicType=intranet &Permissions.1.Policy=Drop &<Common request parameters>
-
Hata Ayıklama
İstek parametreleri
| Parametre | Tür | Zorunlu | Örnek | Açıklama |
| Action | String | Evet | AuthorizeSecurityGroupEgress | Gerçekleştirmek istediğiniz işlem. Değeri AuthorizeSecurityGroupEgress olarak ayarlayın. |
| RegionId | String | Evet | cn-hangzhou | Kaynak 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 yinelenebilirliğini sağlamak için kullanılan istemci belirteci. Değeri istemci üzerinden üretebilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. ClientToken değeri yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için bkz. Yinelenebilirliğin nasıl sağlanacağı. |
| SecurityGroupId | String | Evet | sg-bp67acfmxazb4p**** | Güvenlik grubunun kimliği. |
| Permissions.N.Policy | String | Hayır | accept | N. güvenlik grubu kuralının giden erişime izin verilip verilmeyeceğini belirleyen eylemi. Geçerli değerler:
Varsayılan değer: accept. N için geçerli değerler: 1 ile 100 arası. |
| 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 öncelik anlamına gelir. Geçerli değerler: 1 ile 100 arası. Varsayılan değer: 1. N için geçerli değerler: 1 ile 100 arası. |
| Permissions.N.IpProtocol | String | Hayır | ALL | N. güvenlik grubu kuralının aktarım katmanı protokolü. Değerler büyük/küçük harfe duyarlı değildir. Geçerli değerler:
N için geçerli değerler: 1 ile 100 arası. |
| 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. N için geçerli değerler: 1 ile 100 arası. |
| Permissions.N.Ipv6DestCidrIp | String | Hayır | 2001:db8:1233:1a00::*** | N. güvenlik grubu kuralı için hedef IPv6 CIDR bloğu. CIDR blokları ve IPv6 adresleri desteklenir. N için geçerli değerler: 1 ile 100 arası. Not Permissions.N.Ipv6DestCidrIp parametresi yalnızca hedef, VPC'lerde bulunan ve IPv6 CIDR bloklarını destekleyen ECS örnekleri olduğunda geçerlidir. Bu parametre ile DestCidrIp parametresi birlikte belirtilemez. |
| Permissions.N.DestGroupId | String | Hayır | sg-bp67acfmxazb4p**** | N. güvenlik grubu kuralında referans verilecek hedef güvenlik grubunun kimliği.
N için geçerli değerler: 1 ile 100 arası. Aşağıdaki hususları dikkate alın:
|
| Permissions.N.DestPrefixListId | String | Hayır | pl-x1j1k5ykzqlixdcy**** | N. güvenlik grubu kuralında referans verilecek hedef ön ek listesinin kimliği. Kullanılabilir ön ek listelerinin kimliklerini sorgulamak için DescribePrefixLists işlemini çağırabilirsiniz. Aşağıdaki hususları dikkate alın:
N için geçerli değerler: 1 ile 100 arası. |
| 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:
N için geçerli değerler: 1 ile 100 arası. |
| 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. Bu parametre beşli kurallar tarafından desteklenir. Daha fazla bilgi için bkz. Güvenlik grubu beşli kuralları. N için geçerli değerler: 1 ile 100 arası. |
| Permissions.N.Ipv6SourceCidrIp | String | Hayır | 2001:db8:1234:1a00::*** | N. güvenlik grubu kuralı için kaynak 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 kuralları. N için geçerli değerler: 1 ile 100 arası. Not Permissions.N.Ipv6SourceCidrIp parametresi yalnızca kaynak, VPC'lerde bulunan ve IPv6 CIDR bloklarını destekleyen ECS örnekleri olduğunda geçerlidir. Bu parametre ile DestCidrIp parametresi birlikte belirtilemez. |
| Permissions.N.SourcePortRange | String | Hayır | 80/80 | 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ı karşılamak üzere belirtilir. Daha fazla bilgi için bkz. Güvenlik grubu beşli kuralları. N için geçerli değerler: 1 ile 100 arası. |
| Permissions.N.DestGroupOwnerAccount | String | Hayır | Test@aliyun.com | N. güvenlik grubu kuralını hesaplar arası yapılandırdığınızda hedef güvenlik grubunu yöneten Alibaba Cloud hesabı.
N için geçerli değerler: 1 ile 100 arası. |
| Permissions.N.DestGroupOwnerId | Long | Hayır | 12345678910 | N. güvenlik grubu kuralını hesaplar arası yapılandırdığınızda hedef güvenlik grubunu yöneten Alibaba Cloud hesabının kimliği.
N için geçerli değerler: 1 ile 100 arası. |
| Permissions.N.NicType | String | Hayır | intranet | Güvenlik grubu klasik ağdayken N. güvenlik grubu kuralının ağ arabirimi denetleyicisi (NIC) türü. Geçerli değerler:
Varsayılan değer: internet. N için geçerli değerler: 1 ile 100 arası. |
| 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 arası. |
| Policy | String | Hayır | accept | Bu parametre kullanımdan kaldırılmıştır. Giden 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 |
| 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:db8:1233:1a00::*** | Bu parametre kullanımdan kaldırılmıştır. Hedef IPv6 CIDR bloğunu belirtmek için |
| DestGroupId | String | Hayır | sg-bp67acfmxazb4p**** | Bu parametre kullanımdan kaldırılmıştır. Hedef güvenlik grubunun kimliğini belirtmek için |
| DestPrefixListId | String | Hayır | pl-x1j1k5ykzqlixdcy**** | Bu parametre kullanımdan kaldırılmıştır. Hedef ön ek listesinin kimliğini belirtmek için |
| PortRange | String | Hayır | 80/80 | Bu parametre kullanımdan kaldırılmıştır. Hedef bağlantı noktası aralığı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:db8:1234:1a00::*** | Bu parametre kullanımdan kaldırılmıştır. Kaynak IPv6 CIDR bloğunu belirtmek için |
| SourcePortRange | String | Hayır | 80/80 | Bu parametre kullanımdan kaldırılmıştır. Kaynak bağlantı noktası aralığını belirtmek için |
| DestGroupOwnerAccount | String | Hayır | Test@aliyun.com | Bu parametre kullanımdan kaldırılmıştır. Hedef güvenlik grubunu yöneten Alibaba Cloud hesabını belirtmek için |
| DestGroupOwnerId | Long | Hayır | 12345678910 | Bu parametre kullanımdan kaldırılmıştır. Hedef 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=AuthorizeSecurityGroupEgress
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&SecurityGroupId=sg-bp67acfmxazb4p****
&Permissions.1.DestGroupId=sg-bp67acfmxazb4p****
&Permissions.1.DestGroupOwnerAccount=Test@aliyun.com
&Permissions.1.IpProtocol=ALL
&Permissions.1.PortRange=22/22
&Permissions.1.NicType=intranet
&Permissions.1.Policy=Drop
&Common request parameters
Örnek başarılı yanıt
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<AuthorizeSecurityGroupEgressResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AuthorizeSecurityGroupEgressResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
Hata kodları
| HTTP durum kodu | Hata kodu | Hata iletisi | Açıklama |
| 400 | OperationDenied | The specified IpProtocol does not exist or IpProtocol and PortRange do not match. | Belirtilen IpProtocol parametresi mevcut olmadığından veya belirtilen PortRange parametresiyle eşleşmediğinden dönen hata iletisi. |
| 400 | InvalidIpProtocol.Malformed | The specified parameter PortRange is not valid. | Belirtilen aktarım katmanı protokolü veya PortRange parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidDestCidrIp.Malformed | The specified parameter DestCidrIp is not valid. | Belirtilen DestCidrIp parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidPolicy.Malformed | The specified parameter Policy is not valid. | Belirtilen Policy parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidNicType.ValueNotSupported | The specified NicType does not exist. | Belirtilen NicType parametresi mevcut olmadığından dönen hata iletisi. |
| 400 | InvalidDestGroupId.Mismatch | Specified security group and destination group are not in the same VPC. | Belirtilen güvenlik grubu ile hedef güvenlik grubu aynı VPC'ye ait olmadığından dönen hata iletisi. |
| 400 | InvalidDestGroup.NotFound | Specified destination security group does not exist. | Belirtilen hedef güvenlik grubu mevcut olmadığından dönen hata iletisi. |
| 400 | InvalidPriority.Malformed | The parameter Priority is invalid. | Belirtilen Priority parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidDestCidrIp.Malformed | The parameter DestCidrIp is not valid. | Belirtilen DestCidrIp parametresi geçersiz olduğundan dönen hata iletisi. |
| 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. | İşlem güvenlik grubunun mevcut ağ türünde desteklenmediğinden dönen hata iletisi. VPC'lerdeki güvenlik grupları için ClassicLink'in etkinleştirilmesi gerektiğinden dönen hata iletisi. |
| 400 | InvalidSecurityGroupId.Malformed | The specified parameter SecurityGroupId is not valid. | Belirtilen SecurityGroupId parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidParamter.Conflict | The specified SourceCidrIp should be different from the DestCidrIp. | SourceCidrIp değeri DestCidrIp değeriyle aynı olduğundan dönen hata iletisi. |
| 400 | InvalidSourcePortRange.Malformed | The specified parameter SourcePortRange is not valid. | Belirtilen SourcePortRange parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidParameter.Conflict | IPv6 and IPv4 addresses cannot exist at the same time. | Hem IPv6 hem de IPv4 adresleri belirtildiğinden dönen hata iletisi. |
| 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ğununkiyle eşleşmediğinden dönen hata iletisi. |
| 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 desteklemediğinden dönen hata iletisi. |
| 400 | InvalidParam.DestCidrIp | The specified parameter DestCidrIp is invalid. | Belirtilen DestCidrIp parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidParam.SourceCidrIp | The specified param SourceCidrIp is not valid. | Belirtilen SourceCidrIp parametresi geçersiz olduğundan dönen hata iletisi. |
| 400 | InvalidParam.Permissions | The specified parameter Permissions cannot coexist with other parameters. | Permissions önekli bir parametre, Permissions öneki olmayan karşılığıyla aynı anda belirtilemediğinden dönen hata iletisi. |
| 400 | InvalidParam.DuplicatePermissions | There are duplicate permissions in the specified parameter Permissions. | Permissions önekli parametrelerle belirtilen güvenlik grubu kuralları yineleniyor olduğundan dönen hata iletisi. |
| 403 | InvalidDestGroupId.Mismatch | NicType is required or NicType expects intranet. | NicType parametresi belirtilmediğinden veya intranet olarak ayarlanmadığından dönen hata iletisi. |
| 403 | MissingParameter | The input parameter DestGroupId or DestCidrIp cannot be both blank. | DestGroupId ve DestCidrIp parametrelerinin her ikisi aynı anda boş bırakılamayacağından dönen hata iletisi. |
| 403 | AuthorizationLimitExceed | The limit of authorization records in the security group reaches. | Güvenlik grubundaki maksimum kural sayısına ulaşıldığından dönen hata iletisi. |
| 403 | InvalidParamter.Conflict | The specified SecurityGroupId should be different from the SourceGroupId. | Hedef güvenlik grubu kaynak güvenlik grubuyla aynı olduğundan dönen hata iletisi. |
| 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ı olduğundan dönen hata iletisi. |
| 403 | InvalidSecurityGroup.IsSame | The authorized SecurityGroupId should be different from the DestGroupId. | Yetkilendirilen güvenlik grubu mevcut hedef güvenlik grubuyla aynı olamayacağından dönen hata iletisi. |
| 403 | InvalidNetworkType.Conflict | The parameter SecurityGroup network type should be same with SourceGroup network type (vpc or classic). | Belirtilen güvenlik grubunun ağ türü kaynak grubun ağ türünden farklı olduğundan dönen hata iletisi. |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | Cloud hizmetleri tarafından yönetilen güvenlik grupları değiştirilemediğinden dönen hata iletisi. |
| 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ığından dönen hata iletisi. |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | Belirtilen güvenlik grubu bu hesapta mevcut olmadığından dönen hata iletisi. Güvenlik grubu kimliğinin doğru olup olmadığını kontrol edin. |
| 404 | InvalidDestGroupId.NotFound | The DestGroupId provided does not exist in our records. | Belirtilen DestGroupId parametresi mevcut olmadığından dönen hata iletisi. |
| 404 | InvalidPrefixListId.NotFound | The specified prefix list was not found. | Belirtilen ön ek listesi mevcut olmadığından dönen hata iletisi. |
| 404 | InvalidSecurityGroupId.NotFound | %s | Belirtilen güvenlik grubu kimliği mevcut olmadığından dönen hata iletisi. |
| 500 | InternalError | The request processing has failed due to some unknown error. | Dahili bir hata oluştuğundan dönen hata iletisi. Daha sonra tekrar deneyin. |
Hata kodlarının listesi için bkz. Hizmet hata kodları.