Questa pagina è stata tradotta dall'API Cloud Translation.

Integra Amazon EC2 con Google SecOps

Questo documento descrive come integrare AWS Elastic Compute Cloud (Amazon EC2) con Google Security Operations (Google SecOps).

Versione integrazione: 7.0

Casi d'uso

Proteggere le istanze Amazon Elastic Compute Cloud (Amazon EC2)
1. Crea gruppi di sicurezza per limitare l'accesso a internet in entrata e in uscita ad Amazon EC2.
2. Alloca un nuovo indirizzo IP elastico
3. Associa un nuovo indirizzo IP elastico
Gestione delle risorse: utilizza i tag personalizzati delle istanze per monitorare e identificare le risorse AWS.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID chiave di accesso AWS	Stringa	N/D	Sì	ID chiave di accesso AWS da utilizzare nell'integrazione.
Chiave segreta AWS	Password	N/D	Sì	Chiave segreta AWS da utilizzare nell'integrazione.
Regione AWS predefinita	Stringa	N/D	Sì	Regione AWS predefinita da utilizzare nell'integrazione, ad esempio us-west-2.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configurare le integrazioni.

Se necessario, potrai apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supportare più istanze.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Autorizza l'uscita del gruppo di sicurezza

Aggiunge la regola di uscita specificata a un gruppo di sicurezza da utilizzare con un VPC. Una regola di uscita consente alle istanze di inviare traffico agli intervalli di indirizzi CIDR IPv4 o IPv6 specificati. Le modifiche alle regole vengono propagate alle istanze interessate il più rapidamente possibile. Tuttavia, potrebbe verificarsi un piccolo ritardo.

Per ulteriori informazioni sui limiti dei gruppi di sicurezza VPC, consulta Limiti di Amazon VPC.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID gruppo di sicurezza	Stringa	N/D	Sì	Uno o più ID gruppo di sicurezza. Separati da virgole. Nota per gli sviluppatori: ogni ID in una richiesta separata
Protocollo IP	DDL	tutti	No	Il nome del protocollo IP. Utilizza "all" per specificare tutti i protocolli. Se specifichi "all", il traffico è consentito su tutte le porte, indipendentemente dall'intervallo di porte specificato. Valori possibili: tcp , udp , icmp, all Nota per gli sviluppatori: "all" equivale a -1 dal codice
Da Port	Numero intero		No	L'inizio dell'intervallo di porte per i protocolli TCP e UDP o un numero di tipo ICMP.
A porta	Numero intero		No	La fine dell'intervallo di porte per i protocolli TCP e UDP consente il traffico su tutte le porte, indipendentemente dall'intervallo di porte specificato.
Intervalli IP - CidrIP	Stringa	N/D	No	L'intervallo CIDR IPv4. Per specificare un singolo indirizzo IPv4, utilizza la lunghezza del prefisso /32.
Intervalli IPv6 - CidrIP	Stringa	N/D	No	L'intervallo CIDR IPv6. Per specificare un singolo indirizzo IPv6, utilizza la lunghezza del prefisso /128.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: if successfully added the specified egress rules to at least one (or all) security groups: (is_success = true): "Successfully added the specified egress rule to the following security groups: {group_ids}" if failed to add the specified egress rules because of permissions rule error (invalid port,etc): (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log." if failed to add the specified egress rules because of invalid security group id: (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.`` If failed to add the specified egress rules to all groups: is_success=false L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Authorize Security Group Egress". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

if successfully added the specified egress rules to at least one (or all) security groups: (is_success = true): "Successfully added the specified egress rule to the following security groups: {group_ids}"

if failed to add the specified egress rules because of permissions rule error (invalid port,etc): (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log."

if failed to add the specified egress rules because of invalid security group id: (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.``

If failed to add the specified egress rules to all groups: is_success=false

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Authorize Security Group Egress". Motivo: {0}''.format(error.Stacktrace)

Generale

Autorizza l'ingresso del gruppo di sicurezza

Aggiunge la regola in entrata specificata a un gruppo di sicurezza. Una regola in entrata consente alle istanze di ricevere traffico dagli intervalli di indirizzi CIDR IPv4 o IPv6 specificati. Le modifiche alle regole vengono propagate alle istanze interessate il più rapidamente possibile. Tuttavia, potrebbe verificarsi un piccolo ritardo.

Per ulteriori informazioni sui limiti dei gruppi di sicurezza VPC, consulta Limiti di Amazon VPC.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID gruppo di sicurezza	Stringa	N/D	Sì	Uno o più ID gruppo di sicurezza. Separati da virgole. Nota per gli sviluppatori: ogni ID in una richiesta separata
Protocollo IP	DDL	tutti	No	Il nome del protocollo IP. Utilizza "all" per specificare tutti i protocolli. Se specifichi "all", il traffico è consentito su tutte le porte, indipendentemente dall'intervallo di porte specificato. Valori possibili: tcp , udp , icmp, all Nota per gli sviluppatori: "all" equivale a -1 dal codice
Da Port	Numero intero		No	L'inizio dell'intervallo di porte per i protocolli TCP e UDP o un numero di tipo ICMP.
A porta	Numero intero		No	La fine dell'intervallo di porte per i protocolli TCP e UDP consente il traffico su tutte le porte, indipendentemente dall'intervallo di porte specificato.
Intervalli IP - CidrIP	Stringa	N/D	No	L'indirizzo IPv4 in formato CIDR. Per specificare un singolo indirizzo IPv4, utilizza la lunghezza del prefisso /32.
Intervalli IPv6 - CidrIP	Stringa	N/D	No	L'intervallo CIDR IPv6. Per specificare un singolo indirizzo IPv6, utilizza la lunghezza del prefisso /128.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: se le regole di ingresso specificate sono state aggiunte correttamente ad almeno un gruppo di sicurezza (se tutti sono stati aggiornati correttamente, is_success = true): "Successfully added the specified ingress rule to the following security groups: {group_ids}" (La regola di ingresso specificata è stata aggiunta correttamente ai seguenti gruppi di sicurezza: {group_ids}) if failed to add the specified ingress rules because of permissions rule error (invalid port,etc): (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log." if failed to add the specified ingress rules because of invalid security group id: (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.`` L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Authorize Security Group Ingress". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

se le regole di ingresso specificate sono state aggiunte correttamente ad almeno un gruppo di sicurezza (se tutti sono stati aggiornati correttamente, is_success = true): "Successfully added the specified ingress rule to the following security groups: {group_ids}" (La regola di ingresso specificata è stata aggiunta correttamente ai seguenti gruppi di sicurezza: {group_ids})

if failed to add the specified ingress rules because of permissions rule error (invalid port,etc): (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log."

if failed to add the specified ingress rules because of invalid security group id: (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.``

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Authorize Security Group Ingress". Motivo: {0}''.format(error.Stacktrace)

Generale

Creare tag

Un tag è un'etichetta che assegni a una risorsa AWS. Ogni tag è composto da una chiave e da un valore facoltativo. Puoi utilizzare i tag per cercare e filtrare le risorse o monitorare i costi di AWS. Aggiunge o sovrascrive solo i tag specificati per la risorsa o le risorse Amazon EC2 specificate. Quando specifichi una chiave tag esistente, il valore viene sovrascritto con il nuovo valore. Ogni risorsa può avere un massimo di 50 tag. Le chiavi dei tag devono essere univoche per risorsa.

Per saperne di più sui tag, consulta la sezione Tagging Your Resources nella Guida per l'utente di Amazon Elastic Compute Cloud.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione

ID risorsa Stringa N/D Sì Uno o più ID risorsa. Separati da virgole.

Tag

Stringa

N/D

Sì

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID risorsa	Stringa	N/D	Sì	Uno o più ID risorsa. Separati da virgole.
Tag	Stringa	N/D	Sì	La combinazione chiave-valore di un tag da assegnare alla risorsa. Ad esempio, per aggiungere a tutte le risorse specificate un tag con la chiave `Owner` e il valore `TeamA`, specifica `Owner:TeamA`. Puoi specificare più combinazioni chiave-valore separandole con virgole. Puoi aggiungere o sovrascrivere i tag specificati. Le chiavi dei tag devono essere univoche per risorsa.

La combinazione chiave-valore di un tag da assegnare alla risorsa. Ad esempio, per aggiungere a tutte le risorse specificate un tag con la chiave Owner e il valore TeamA, specifica Owner:TeamA. Puoi specificare più combinazioni chiave-valore separandole con virgole.

Puoi aggiungere o sovrascrivere i tag specificati. Le chiavi dei tag devono essere univoche per risorsa.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: In caso di esito positivo: "Tag {tags_list} aggiunti correttamente alle seguenti risorse: "resource_ids" Per gli ID risorsa non validi (is_success = false): "Impossibile aggiungere i tag {tag_list} alle seguenti risorse: {resource_ids}. Motivo: ID risorsa non valido Se la risorsa ha più di 50 tag (is_success = false): "Impossibile aggiungere i tag {tag_list} alle seguenti risorse: {resource_ids}. Motivo: una risorsa può avere un massimo di 50 tag. Se la chiave del tag non è univoca: (is_success = false): "Impossibile aggiungere i tag {tag_list} alle seguenti risorse: {resource_ids}. Motivo: le chiavi dei tag devono essere univoche per risorsa. Se il tag specificato non è nel formato valido (ovvero solo chiave o solo valore senza la struttura completa di chiave:valore) (is_success = false): "Impossibile aggiungere i tag {invalid_tags} alle seguenti risorse: {ids}. Motivo: formato non valido. Il tag deve includere chiave e valore. L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Tags". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

In caso di esito positivo: "Tag {tags_list} aggiunti correttamente alle seguenti risorse: "resource_ids"

Per gli ID risorsa non validi (is_success = false): "Impossibile aggiungere i tag {tag_list} alle seguenti risorse: {resource_ids}. Motivo: ID risorsa non valido

Se la risorsa ha più di 50 tag (is_success = false): "Impossibile aggiungere i tag {tag_list} alle seguenti risorse: {resource_ids}. Motivo: una risorsa può avere un massimo di 50 tag.

Se la chiave del tag non è univoca: (is_success = false): "Impossibile aggiungere i tag {tag_list} alle seguenti risorse: {resource_ids}. Motivo: le chiavi dei tag devono essere univoche per risorsa.

Se il tag specificato non è nel formato valido (ovvero solo chiave o solo valore senza la struttura completa di chiave:valore) (is_success = false): "Impossibile aggiungere i tag {invalid_tags} alle seguenti risorse: {ids}. Motivo: formato non valido. Il tag deve includere chiave e valore.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Tags". Motivo: {0}''.format(error.Stacktrace)

Generale

Elenco istanze

Descrive le istanze specificate o tutte le istanze.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID istanza	Stringa	N/D	No	Uno o più ID istanza. Se specifichi gli ID istanza, l'output include informazioni solo per le istanze specificate. Questo parametro non può essere utilizzato con il parametro "Risultati massimi". "ID istanza" ha la priorità sul parametro "Risultato massimo".
Filtri dei tag	Stringa	N/D	No	La combinazione chiave/valore di un tag assegnato alla risorsa. Ad esempio, per trovare tutte le risorse che hanno un tag con la chiave Proprietario e il valore TeamA, specifica Proprietario:TeamA. Filtri dei tag separati da virgole. Esempio: Nome:Nome1,Proprietario:TeamA. Le istanze restituite corrisponderanno a tutti i filtri.
Risultati per pagina	Numero intero	50	No	Specifica il numero di istanze da restituire. Il valore predefinito è 50. Il valore massimo è 1000. Il parametro "ID istanza" non può essere utilizzato con il parametro "Risultati massimi". "ID istanza" ha la priorità sul parametro "Risultato massimo".

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

"EC2_Instances": [
    {
   "AmiLaunchIndex":0,
   "ImageId":"ami-047a51fa27710816e",
   "InstanceId":"i-044c08c5bfe1a7f98",
   "InstanceType":"t2.micro",
   "KeyName":"\"Key\": \"Test\", \"Value\":\"Test\"",
   "LaunchTime":"2021-1-30",
   "Monitoring":{
      "State":"disabled"
   },
   "Placement":{
      "AvailabilityZone":"us-east-1d",
      "GroupName":"",
      "Tenancy":"default"
   },
   "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
   "PrivateIpAddress":"192.0.2.220",
   "ProductCodes":[

   ],
   "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
   "PublicIpAddress":"192.0.2.218",
   "State":{
      "Code":16,
      "Name":"running"
   },
   "StateTransitionReason":"",
   "SubnetId":"subnet-1b1fda3a",
   "VpcId":"vpc-ID",
   "Architecture":"x86_64",
   "BlockDeviceMappings":[
      {
         "DeviceName":"/dev/xvda",
         "Ebs":{
            "AttachTime":"2021-1-30",
            "DeleteOnTermination":true,
            "Status":"attached",
            "VolumeId":"vol-00f70681a43e5d86e"
         }
      }
   ],
   "ClientToken":"",
   "EbsOptimized":false,
   "EnaSupport":true,
   "Hypervisor":"xen",
   "NetworkInterfaces":[
      {
         "Association":{
            "IpOwnerId":"amazon",
            "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
            "PublicIp":"192.0.2.218"
         },
         "Attachment":{
            "AttachTime":"",
            "AttachmentId":"eni-attach-06bc5e5901ce99ef2",
            "DeleteOnTermination":true,
            "DeviceIndex":0,
            "Status":"attached",
            "NetworkCardIndex":0
         },
         "Description":"",
         "Groups":[
            {
               "GroupName":"launch-wizard-2",
               "GroupId":"sg-001700ccddac4189a"
            }
         ],
         "Ipv6Addresses":[

         ],
         "MacAddress":"12:34:56:ab:cd:ef",
         "NetworkInterfaceId":"eni-020fa83efd417e32d",
         "OwnerId":"ID",
         "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
         "PrivateIpAddress":"192.0.2.220",
         "PrivateIpAddresses":[
            {
               "Association":{
                  "IpOwnerId":"amazon",
                  "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
                  "PublicIp":"192.0.2.218"
               },
               "Primary":true,
               "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
               "PrivateIpAddress":"192.0.2.220"
            }
         ],
         "SourceDestCheck":true,
         "Status":"in-use",
         "SubnetId":"subnet-1b1fda3a",
         "VpcId":"vpc-ID",
         "InterfaceType":"interface"
      }
   ],
   "RootDeviceName":"/dev/xvda",
   "RootDeviceType":"ebs",
   "SecurityGroups":[
      {
         "GroupName":"launch-wizard-2",
         "GroupId":"sg-001700ccddac4189a"
      }
   ],
   "SourceDestCheck":true,
   "Tags":[
      {
         "Key":"Owner",
         "Value":"Example"
      },
      {
         "Key":"Name",
         "Value":"Example test"
      }
   ],
   "VirtualizationType":"hvm",
   "CpuOptions":{
      "CoreCount":1,
      "ThreadsPerCore":1
   },
   "CapacityReservationSpecification":{
      "CapacityReservationPreference":"open"
   },
   "HibernationOptions":{
      "Configured":false
   },
   "MetadataOptions":{
      "State":"applied",
      "HttpTokens":"optional",
      "HttpPutResponseHopLimit":1,
      "HttpEndpoint":"enabled"
   },
   "EnclaveOptions":{
      "Enabled":false
   }
}
 ]

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se le istanze sono state elencate correttamente (is_success = true): "Successfully described Amazon EC2 instances." (Istanze Amazon EC2 descritte correttamente). Se non sono disponibili valori(is_success = false): "Non sono state trovate istanze in Amazon EC2" L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, invalid instance ID, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Instances". Motivo: {0}''.format(error.Stacktrace)	Generale
Tabella Bacheca casi	Nome tabella: istanze Amazon EC2 Colonne della tabella: ID Stato Tipo Zona di disponibilità DNS IPv4 pubblico Indirizzo IPv4 pubblico Monitoraggio Nome del gruppo di sicurezza Nome chiave Ora di avvio

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se le istanze sono state elencate correttamente (is_success = true): "Successfully described Amazon EC2 instances." (Istanze Amazon EC2 descritte correttamente).
Se non sono disponibili valori(is_success = false): "Non sono state trovate istanze in Amazon EC2"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, invalid instance ID, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Instances". Motivo: {0}''.format(error.Stacktrace)

Generale

Tabella Bacheca casi

Nome tabella: istanze Amazon EC2

Colonne della tabella:

Stato

Tipo

Zona di disponibilità

DNS IPv4 pubblico

Indirizzo IPv4 pubblico

Monitoraggio

Nome del gruppo di sicurezza

Nome chiave

Ora di avvio

Elenco gruppi di sicurezza

Descrive i gruppi di sicurezza specificati o tutti i tuoi gruppi di sicurezza. Un gruppo di sicurezza è da utilizzare con istanze nella piattaforma EC2-Classic o in un VPC specifico.

Per maggiori informazioni, vedi Amazon EC2 Security Groups.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
Nomi dei gruppi di sicurezza	Stringa	N/D	Falso	Uno o più nomi di gruppi di sicurezza [solo EC2-Classic e VPC predefinito]. Separati da virgole.Se specifichi i nomi dei gruppi di sicurezza, l'output include informazioni solo per i nomi specificati.
ID gruppo di sicurezza	Stringa	N/D	Falso	Uno o più ID gruppo di sicurezza. Separati da virgole.Se specifichi gli ID dei gruppi di sicurezza, l'output include informazioni solo per gli ID specificati. Obbligatorio per i gruppi di sicurezza in un VPC non predefinito.
Filtri dei tag	Stringa	N/D	Falso	La combinazione chiave-valore di un tag assegnato al gruppo di sicurezza. Ad esempio, per trovare tutti i gruppi con un tag che include la chiave `Owner` e il valore `TeamA`, inserisci `Owner:TeamA`. Puoi utilizzare filtri per tag separati da virgole, ad esempio `Name:Name1,Owner:TeamA`. I gruppi restituiti devono corrispondere a tutti i filtri.
Risultati per pagina	Numero intero	50	Falso	Il numero di gruppi di sicurezza da restituire. Il valore predefinito è `50`. Il valore massimo è `1000`. Nota: i parametri "ID gruppo di sicurezza" e "Nomi gruppi di sicurezza" non possono essere utilizzati con il parametro "Risultati massimi".

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

"EC2_Security_Groups": [
{
   "Description":"launch-wizard-2 created 2021-01-30T19:37:11.523+02:00",
   "GroupName":"launch-wizard-2",
   "IpPermissions":[
      {
         "FromPort":22,
         "IpProtocol":"tcp",
         "IpRanges":[
            {
               "CidrIp":"192.0.2.0/0"
            }
         ],
         "Ipv6Ranges":[

         ],
         "PrefixListIds":[

         ],
         "ToPort":22,
         "UserIdGroupPairs":[

         ]
      }
   ],
   "OwnerId":"582302349248",
   "GroupId":"sg-001700ccddac4189a",
   "IpPermissionsEgress":[
      {
         "IpProtocol":"-1",
         "IpRanges":[
            {
               "CidrIp":"192.0.2.0/0"
            }
         ],
         "Ipv6Ranges":[

         ],
         "PrefixListIds":[

         ],
         "UserIdGroupPairs":[

         ]
      }
   ],
   "Tags":[
      {
         "Key":"Team",
         "Value":"A-Team"
      },
      {
         "Key":"Owner",
         "Value":"Example"
      }
   ],
   "VpcId":"vpc-ID"
}
]

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se i gruppi sono stati elencati correttamente (is_success = true): "Successfully described Amazon EC2 security groups." (Gruppi di sicurezza Amazon EC2 descritti correttamente). Se non sono disponibili valori(is_success = false): "Nessun gruppo di sicurezza trovato in Amazon EC2" L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, invalid group ID/Name, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Security Groups". Motivo: {0}''.format(error.Stacktrace)	Generale
Tabella Bacheca casi	Nome tabella: istanze Amazon EC2 Colonne della tabella: ID gruppo di sicurezza Nome del gruppo di sicurezza ID VPC Descrizione ID proprietario

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i gruppi sono stati elencati correttamente (is_success = true): "Successfully described Amazon EC2 security groups." (Gruppi di sicurezza Amazon EC2 descritti correttamente).
Se non sono disponibili valori(is_success = false): "Nessun gruppo di sicurezza trovato in Amazon EC2"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, invalid group ID/Name, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Security Groups". Motivo: {0}''.format(error.Stacktrace)

Generale

Tabella Bacheca casi

Nome tabella: istanze Amazon EC2

Colonne della tabella:

ID gruppo di sicurezza

Nome del gruppo di sicurezza

ID VPC

Descrizione

ID proprietario

Dindin

Testa la connettività ad AWS EC2.

Parametri

N/D

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'operazione va a buon fine: "Connessione ad Amazon EC2 riuscita con i parametri di connessione forniti." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se l'operazione non va a buon fine: "Impossibile connettersi al server Amazon EC2. Error is {0}".format(exception.stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione va a buon fine: "Connessione ad Amazon EC2 riuscita con i parametri di connessione forniti."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se l'operazione non va a buon fine: "Impossibile connettersi al server Amazon EC2. Error is {0}".format(exception.stacktrace)

Generale

Revoca dell'uscita del gruppo di sicurezza

Rimuove le regole di uscita (regole in uscita) specificate da un gruppo di sicurezza per EC2-VPC. Questa azione non si applica ai gruppi di sicurezza da utilizzare in EC2-Classic. Per rimuovere una regola, i valori specificati (ad esempio le porte) devono corrispondere esattamente ai valori della regola esistente. Le modifiche alle regole vengono propagate alle istanze all'interno del gruppo di sicurezza il più rapidamente possibile. Tuttavia, potrebbe verificarsi un piccolo ritardo.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID gruppo di sicurezza	Stringa	N/D	Sì	Uno o più ID gruppo di sicurezza. Separati da virgole. Nota per gli sviluppatori: ogni ID in una richiesta separata
Protocollo IP	DDL	tutti	No	Il nome del protocollo IP. Utilizza "all" per specificare tutti i protocolli. Se specifichi "all", il traffico è consentito su tutte le porte, indipendentemente dall'intervallo di porte specificato. Valori possibili: tcp , udp , icmp, all Nota per gli sviluppatori: "all" equivale a -1 dal codice
Da Port	Numero intero		No	L'inizio dell'intervallo di porte per i protocolli TCP e UDP o un numero di tipo ICMP.
A porta	Numero intero		No	La fine dell'intervallo di porte per i protocolli TCP e UDP consente il traffico su tutte le porte, indipendentemente dall'intervallo di porte specificato.
Intervalli IP - CidrIP	Stringa	N/D	No	L'indirizzo IPv4 in formato CIDR. Per specificare un singolo indirizzo IPv4, utilizza la lunghezza del prefisso /32.
Intervalli IPv6 - CidrIP	Stringa	N/D	No	L'intervallo CIDR IPv6. Per specificare un singolo indirizzo IPv6, utilizza la lunghezza del prefisso /128.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: se le regole di uscita specificate sono state revocate correttamente da almeno uno (o tutti) i gruppi di sicurezza: (is_success = true): "Successfully revoked the specified egress rule from the following security groups: {group_ids}" (la regola di uscita specificata è stata revocata correttamente dai seguenti gruppi di sicurezza: {group_ids}) if failed to revoke the specified egress rules because of permissions rule error (invalid port as 205,etc): (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log." if failed to revoke the specified egress rules because of invalid security group id: (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.`` L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Revoke Security Group Egress". Motivo: {0}''.format(error.Stacktrace)	Gener

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

se le regole di uscita specificate sono state revocate correttamente da almeno uno (o tutti) i gruppi di sicurezza: (is_success = true): "Successfully revoked the specified egress rule from the following security groups: {group_ids}" (la regola di uscita specificata è stata revocata correttamente dai seguenti gruppi di sicurezza: {group_ids})

if failed to revoke the specified egress rules because of permissions rule error (invalid port as 205,etc): (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log."

if failed to revoke the specified egress rules because of invalid security group id: (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.``

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Revoke Security Group Egress". Motivo: {0}''.format(error.Stacktrace)

Gener

Revoca l'ingresso del gruppo di sicurezza

Rimuove le regole di ingresso (in entrata) specificate da un gruppo di sicurezza. Per rimuovere una regola, i valori specificati (ad esempio, le porte) devono corrispondere esattamente ai valori della regola esistente. Le modifiche alle regole vengono propagate alle istanze all'interno del gruppo di sicurezza il più rapidamente possibile. Tuttavia, potrebbe verificarsi un piccolo ritardo.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID gruppo di sicurezza	Stringa	N/D	Sì	Uno o più ID gruppo di sicurezza. Separati da virgole. Nota per gli sviluppatori: ogni ID in una richiesta separata
Protocollo IP	DDL	tutti	No	Il nome del protocollo IP. Utilizza "all" per specificare tutti i protocolli. Se specifichi "all", il traffico è consentito su tutte le porte, indipendentemente dall'intervallo di porte specificato. Valori possibili: tcp , udp , icmp, all Nota per gli sviluppatori: "all" equivale a -1 dal codice
Da Port	Numero intero		No	L'inizio dell'intervallo di porte per i protocolli TCP e UDP o un numero di tipo ICMP.
A porta	Numero intero		No	La fine dell'intervallo di porte per i protocolli TCP e UDP consente il traffico su tutte le porte, indipendentemente dall'intervallo di porte specificato.
Intervalli IP - CidrIP	Stringa	N/D	No	L'indirizzo IPv4 in formato CIDR. Per specificare un singolo indirizzo IPv4, utilizza la lunghezza del prefisso /32.
Intervalli IPv6 - CidrIP	Stringa	N/D	No	L'intervallo CIDR IPv6. Per specificare un singolo indirizzo IPv6, utilizza la lunghezza del prefisso /128.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: se le regole di ingresso specificate sono state revocate correttamente per almeno uno (o tutti) i gruppi di sicurezza: (is_success = true): "Successfully revoked the specified ingress rule from the following security groups: {group_ids}" (la regola di ingresso specificata è stata revocata correttamente dai seguenti gruppi di sicurezza: {group_ids}) if failed to revoke the specified ingress rules because of permissions rule error (invalid port as 205,etc): (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log." if failed to revoke the specified ingress rules because of invalid security group id: (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.`` L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Revoke Security Group Ingress". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

se le regole di ingresso specificate sono state revocate correttamente per almeno uno (o tutti) i gruppi di sicurezza: (is_success = true): "Successfully revoked the specified ingress rule from the following security groups: {group_ids}" (la regola di ingresso specificata è stata revocata correttamente dai seguenti gruppi di sicurezza: {group_ids})

if failed to revoke the specified ingress rules because of permissions rule error (invalid port as 205,etc): (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Motivo: autorizzazioni IP non valide impostate. Per maggiori dettagli, controlla i log."

if failed to revoke the specified ingress rules because of invalid security group id: (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Motivo: è stato fornito un ID gruppo di sicurezza non valido. Per ulteriori dettagli, controlla i log.``

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Revoke Security Group Ingress". Motivo: {0}''.format(error.Stacktrace)

Generale

Avvia istanza

Avvia un'istanza supportata da Amazon Elastic Block Store (Amazon EBS) che hai arrestato in precedenza. Possono essere necessari alcuni minuti prima che l'istanza entri nello stato di esecuzione. Tieni presente che non puoi avviare un'istanza supportata da un archivio istanze. Per saperne di più sulle istanze supportate da instance store, consulta Archiviazione per il dispositivo di root.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID istanza	Stringa	N/D	Sì	Uno o più ID istanza. Separati da virgole

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

[
  {
      "CurrentState": "pending",
        "InstanceId": "string",
        "PreviousState":"stopped"
    }
]

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se lo stato attuale di tutte/alcune istanze è diverso da: in attesa, in esecuzione: ( Is_success = false): Non è possibile avviare le seguenti istanze dal loro stato attuale: <failed_instance ids> Se lo stato attuale è in attesa → azione ancora in corso: continua… le istanze richieste sono ancora in attesa Se lo stato attuale è in esecuzione:(is_success=true: Stampa: Le seguenti istanze sono state avviate correttamente : <running_instance ids> Se una delle istanze non è valida (is_success =false): le seguenti istanze non sono valide: <not valid ids>. Riprova. L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Start Instance". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se lo stato attuale di tutte/alcune istanze è diverso da: in attesa, in esecuzione: ( Is_success = false): Non è possibile avviare le seguenti istanze dal loro stato attuale: <failed_instance ids>
Se lo stato attuale è in attesa → azione ancora in corso: continua… le istanze richieste sono ancora in attesa
Se lo stato attuale è in esecuzione:(is_success=true: Stampa: Le seguenti istanze sono state avviate correttamente : <running_instance ids>
Se una delle istanze non è valida (is_success =false): le seguenti istanze non sono valide: <not valid ids>. Riprova.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Start Instance". Motivo: {0}''.format(error.Stacktrace)

Generale

Scatta una foto

Scatta uno snapshot dell'istanza.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID istanza	Stringa	N/D	Sì	Specifica l'ID istanza.
Descrizione	Stringa	N/D	No	Specifica la descrizione dello snapshot.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "EC2_Snapshot": [
    {
      "Description": "",
      "Tags": [],
      "Encrypted": false,
      "VolumeId": "vol-ID",
      "State": "pending",
      "VolumeSize": 8,
      "StartTime": "2022-11-13 15:45:44.795000+00:00",
      "Progress": "",
      "OwnerId": "OWNER_ID",
      "SnapshotId": "snap-ID"
    }
  ]
}

Termina istanza

Termina un'istanza.

Le istanze terminate non possono essere riavviate. È possibile terminare solo le istanze basate su instance store. Per saperne di più sulle istanze supportate da instance store, vedi Archiviazione per il dispositivo di root.

Se termini un'istanza più di una volta, ogni chiamata va a buon fine. Se specifichi più istanze e la richiesta non va a buon fine (ad esempio a causa di un singolo ID istanza errato), nessuna delle istanze viene terminata.

Le istanze terminate rimangono visibili dopo la terminazione (per circa un'ora). Per impostazione predefinita, Amazon EC2 elimina tutti i volumi EBS collegati al momento dell'avvio dell'istanza. I volumi collegati dopo l'avvio dell'istanza continuano a essere eseguiti. Per ulteriori informazioni, consulta la guida per l'utente di Amazon.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	È obbligatorio	Descrizione
ID istanza	Stringa	N/D	Sì	Uno o più ID istanza. Separati da virgole.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

"StoppingInstances": [
      {
      "CurrentState": "shutting-down",
        "InstanceId": "string",
        "PreviousState":"running"
      }
   ]

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se lo stato attuale di tutte/alcune istanze è diverso da: arresto, terminato: ( Is_success = false): Non è possibile terminare le seguenti istanze dal loro stato attuale: <ID istanze non riuscite> If current state is shutting-down: (is_success=true) → action still in progress: Continuing….the requested instances are still shutting-down Se lo stato attuale è terminato (is_success=true): le seguenti istanze sono state terminate correttamente: <stopped_instance ids> Se una delle istanze non è valida (is_success =false): le seguenti istanze non sono valide: <not valid ids>. Riprova. L'azione deve non riuscire e interrompere l'esecuzione di un playbook: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Terminate Instance". Motivo: {0}''.format(error.Stacktrace)	Generale

Tipo di risultato

Valore / Descrizione

Tipo

Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se lo stato attuale di tutte/alcune istanze è diverso da: arresto, terminato: ( Is_success = false): Non è possibile terminare le seguenti istanze dal loro stato attuale: <ID istanze non riuscite>
If current state is shutting-down: (is_success=true) → action still in progress: Continuing….the requested instances are still shutting-down
Se lo stato attuale è terminato (is_success=true): le seguenti istanze sono state terminate correttamente: <stopped_instance ids>
Se una delle istanze non è valida (is_success =false): le seguenti istanze non sono valide: <not valid ids>. Riprova.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Terminate Instance". Motivo: {0}''.format(error.Stacktrace)

Generale

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.