Utilisation de UpdateSecurityGroupRuleDescriptionsIngress avec une CLI

Les exemples de code suivants illustrent comment utiliser UpdateSecurityGroupRuleDescriptionsIngress.

CLI

AWS CLI

Exemple 1 : pour mettre à jour la description d’une règle de groupe de sécurité entrant avec une source CIDR

L’exemple update-security-group-rule-descriptions-ingress suivant met à jour la description de la règle du groupe de sécurité pour le port et la plage d’adresses IPv4 spécifiés. La description « SSH access from ABC office » remplace toute description existante de la règle.

aws ec2 update-security-group-rule-descriptions-ingress \
    --group-id sg-02f0d35a850ba727f \
    --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,IpRanges='[{CidrIp=203.0.113.0/16,Description="SSH access from corpnet"}]'

Sortie :

{
    "Return": true
}

Pour plus d’informations, consultez Règles des groupes de sécurité dans le Guide de l’utilisateur Amazon EC2.

Exemple 2 : pour mettre à jour la description d’une règle de groupe de sécurité entrant avec une source de liste de préfixes

L’exemple update-security-group-rule-descriptions-ingress suivant met à jour la description de la règle du groupe de sécurité pour le port et la liste de préfixes spécifiés. La description « SSH access from ABC office » remplace toute description existante de la règle.

aws ec2 update-security-group-rule-descriptions-ingress \
    --group-id sg-02f0d35a850ba727f \
    --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,PrefixListIds='[{PrefixListId=pl-12345678,Description="SSH access from corpnet"}]'

Sortie :

{
    "Return": true
}

Pour plus d’informations, consultez Règles des groupes de sécurité dans le Guide de l’utilisateur Amazon EC2.

• Pour plus de détails sur l’API, consultez UpdateSecurityGroupRuleDescriptionsIngress dans la Référence des commandes de l’AWS CLI.

PowerShell

Outils pour PowerShell V4

Exemple 1 : cet exemple met à jour la description d’une règle de trafic entrant pour le groupe de sécurité.

$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithUpdatedDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
  "SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
  "Description" = "Updated rule description"
}

Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithUpdatedDescription

Exemple 2 : supprime la description d’une règle de groupe de sécurité d’entrée (entrante) existante (en omettant le paramètre dans la demande).

$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithoutDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
  "SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
}

Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithoutDescription

• Pour plus de détails sur l’API, consultez UpdateSecurityGroupRuleDescriptionsIngress dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple met à jour la description d’une règle de trafic entrant pour le groupe de sécurité.

$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithUpdatedDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
  "SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
  "Description" = "Updated rule description"
}

Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithUpdatedDescription

Exemple 2 : supprime la description d’une règle de groupe de sécurité d’entrée (entrante) existante (en omettant le paramètre dans la demande).

$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithoutDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
  "SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
}

Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithoutDescription

• Pour plus de détails sur l’API, consultez UpdateSecurityGroupRuleDescriptionsIngress dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V5).