

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `aws:executeAwsApi`— Chiama ed esegui operazioni AWS API
<a name="automation-action-executeAwsApi"></a>

Chiama ed esegue operazioni AWS API. È supportata la maggior parte delle operazioni API, sebbene non tutte le operazioni API siano state sottoposte a test. Le operazioni API di streaming, come l'[GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html)operazione, non sono supportate. Se non hai la certezza che un'operazione API che desideri utilizzare sia un'operazione di streaming, consulta la documentazione [Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html) del servizio per stabilire se un'API richiede input o output di streaming. Aggiorniamo regolarmente la versione Boto3 utilizzata da questa operazione. Tuttavia, dopo il rilascio di una nuova versione di Boto3, possono essere necessarie alcune settimane prima che le modifiche vengano applicate in questa operazione. Ogni operazione `aws:executeAwsApi` può durare al massimo 25 secondi. Per ulteriori esempi di utilizzo di questa operazione, consulta [Ulteriori esempi di runbook](automation-document-examples.md).

**Nota**  
L'azione `aws:executeAwsApi` supporta un nuovo tentativo di limitazione (della larghezza di banda della rete) automatico. Per ulteriori informazioni, consulta [Configurazione della ripetizione dei tentativi automatica per le operazioni di limitazione (della larghezza di banda della rete)](automation-throttling-retry.md).

**Input**  
Gli input vengono definiti dall'operazione API selezionata. 

------
#### [ YAML ]

```
action: aws:executeAwsApi
inputs:
  Service: {{The official namespace of the service}}
  Api: {{The API operation or method name}}
  {{API operation inputs or parameters}}: {{A value}}
outputs: # {{These are user-specified outputs}}
- Name: {{The name for a user-specified output key}}
  Selector: {{A response object specified by using jsonpath format}}
  Type: {{The data type}}
```

------
#### [ JSON ]

```
{
   "action":"aws:executeAwsApi",
   "inputs":{
      "Service":"{{The official namespace of the service}}",
      "Api":"{{The API operation or method name}}",
      "{{API operation inputs or parameters}}":"{{A value}}"
   },
   "outputs":[ {{These are user-specified outputs}}
      {
         "Name":"{{The name for a user-specified output key}}",
         "Selector":"{{A response object specified by using JSONPath format}}",
         "Type":"{{The data type}}"
      }
   ]
}
```

------

Servizio  
Lo spazio dei Servizio AWS nomi che contiene l'operazione API che desideri eseguire. [È possibile visualizzare un elenco di Servizio AWS namespace supportati in Servizi disponibili di.](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html) AWS SDK per Python (Boto3) Il namespace è disponibile nella sezione **Client**. Ad esempio, il namespace per Systems Manager è `ssm`. Il namespace per Amazon Elastic Compute Cloud (Amazon EC2) è `ec2`.  
Tipo: stringa  
Obbligatorio: sì

Api  
Nome dell'operazione API da eseguire. Puoi visualizzare le operazioni API (definite anche metodi) scegliendo un servizio nel pannello di navigazione a sinistra nella pagina [Documentazione di riferimento ai servizi](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html). Scegliere un metodo nella sezione **Client** del servizio che si desidera chiamare. Ad esempio, tutte le operazioni API (metodi) per Amazon Relational Database Service (Amazon RDS) sono elencate nella seguente pagina: [Amazon RDS methods](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html) (Metodi Amazon RDS).  
Tipo: stringa  
Campo obbligatorio: sì

Input dell'operazione API  
Uno o più input dell'operazione API. Puoi visualizzare gli input disponibili (definiti anche parametri) scegliendo un servizio nel pannello di navigazione a sinistra nella pagina [Documentazione di riferimento ai servizi](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html). Scegliere un metodo nella sezione **Client** del servizio che si desidera chiamare. Ad esempio, tutti i metodi per Amazon RDS sono elencati nella pagina: [metodi di Amazon RDS](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html). ****Scegliete il metodo [describe\_db\_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_instances) e scorrete verso il basso per visualizzare i parametri disponibili, ad esempio Nome e Valori. **DBInstanceIdentifier******  

```
inputs:
  Service: {{The official namespace of the service}}
  Api: {{The API operation name}}
  {{API input 1}}: {{A value}}
  {{API Input 2}}: {{A value}}
 {{ API Input 3}}: {{A value}}
```

```
"inputs":{
      "Service":"{{The official namespace of the service}}",
      "Api":"{{The API operation name}}",
      "{{API input 1}}":"{{A value}}",
      "{{API Input 2}}":"{{A value}}",
      "{{API Input 3}}":"{{A value}}"
}
```
Tipo: determinato dall'operazione API selezionata  
Obbligatorio: sì

**Output**  
Gli output sono specificati dall'utente in base alla risposta dell'operazione API scelta.

Nome  
Nome dell'output.  
Tipo: stringa  
Obbligatorio: sì

Selector  
Elemento JSONPath di un attributo specifico nell'oggetto di risposta. Puoi visualizzare gli oggetti di risposta scegliendo un servizio nel pannello di navigazione a sinistra nella pagina [Documentazione di riferimento ai servizi](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html). Scegliere un metodo nella sezione **Client** del servizio che si desidera chiamare. Ad esempio, tutti i metodi per Amazon RDS sono elencati nella pagina: [metodi di Amazon RDS](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html). Scegliere il metodo [describe\_db\_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_instances) e scorrere fino alla sezione **Struttura risposta**. **DBInstances** è presente nell'elenco come oggetto di risposta.  
Digitate: Integer, Boolean, String,, o StringList StringMap MapList  
Obbligatorio: sì

Tipo  
Tipo di dati dell'elemento di risposta.  
Tipo: vario  
Obbligatorio: sì