AWS App Runner non sarà più aperto a nuovi clienti a partire dal 30 aprile 2026. Se desideri utilizzare App Runner, registrati prima di tale data. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [AWS App Runner la pagina Modifica della disponibilità](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.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à.
# L'API App Runner
L'interfaccia di programmazione dell' AWS App Runner applicazione (API) è un' RESTful API per effettuare richieste al servizio App Runner. Puoi utilizzare l'API per creare, elencare, descrivere, aggiornare ed eliminare le risorse App Runner presenti nel tuo. Account AWS
Puoi chiamare l'API direttamente nel codice dell'applicazione oppure puoi utilizzare uno dei AWS SDKs.
Per informazioni complete di riferimento sull'API, consulta l'[AWS App Runner API Reference](https://docs.aws.amazon.com/apprunner/latest/api/).
Per ulteriori informazioni sugli strumenti per AWS sviluppatori, consulta [Tools to Build on AWS](https://aws.amazon.com/tools/).
**Topics**
+ [Utilizzo di AWS CLI per lavorare con App Runner](#api.cli)
+ [Utilizzo AWS CloudShell per lavorare con AWS App Runner](api-cshell.md)
## Utilizzo di AWS CLI per lavorare con App Runner
Per gli script da riga di comando, utilizzare [AWS CLI](https://docs.aws.amazon.com/cli/)per effettuare chiamate al servizio App Runner. *Per informazioni AWS CLI di riferimento complete, consulta l'[apprunner](https://docs.aws.amazon.com/cli/latest/reference/apprunner/) nel Command Reference.AWS CLI *
AWS CloudShell consente di saltare l'installazione di tale file AWS CLI nel proprio ambiente di sviluppo e di utilizzarlo invece in. Console di gestione AWS Oltre a evitare l'installazione, non è necessario configurare le credenziali e non è necessario specificare la regione. La tua Console di gestione AWS sessione fornisce questo contesto a. AWS CLI Per ulteriori informazioni CloudShell e per un esempio di utilizzo, vedere[Utilizzo AWS CloudShell per lavorare con AWS App Runner](api-cshell.md).
# Utilizzo AWS CloudShell per lavorare con AWS App Runner
AWS CloudShell è una shell preautenticata basata su browser che puoi avviare direttamente da. Console di gestione AWSÈ possibile eseguire AWS CLI comandi contro i AWS servizi (incluso AWS App Runner) utilizzando la shell preferita (Bash o Z shell). PowerShell E puoi farlo senza dover scaricare o installare strumenti da riga di comando.
Si [avvia AWS CloudShell da e Console di gestione AWS le](https://docs.aws.amazon.com/cloudshell/latest/userguide/working-with-cloudshell.html#launch-options) AWS credenziali utilizzate per accedere alla console sono automaticamente disponibili in una nuova sessione di shell. Questa preautenticazione AWS CloudShell degli utenti consente di saltare la configurazione delle credenziali quando si interagisce con AWS servizi come App Runner utilizzando la AWS CLI versione 2 (preinstallata nell'ambiente di calcolo della shell).
**Topics**
+ [Ottenere le autorizzazioni IAM per AWS CloudShell](#api-cshell.permissions)
+ [Interagire con App Runner utilizzando AWS CloudShell](#api-cshell.call-apprunner)
+ [Verifica del servizio App Runner utilizzando AWS CloudShell](#api-cshell.call-your-service)
## Ottenere le autorizzazioni IAM per AWS CloudShell
Utilizzando le risorse di gestione degli accessi fornite da AWS Identity and Access Management, gli amministratori possono concedere le autorizzazioni agli utenti IAM in modo che possano accedere AWS CloudShell e utilizzare le funzionalità dell'ambiente.
Il modo più rapido per un amministratore di concedere l'accesso agli utenti è tramite una AWS policy gestita. Una [policy gestita da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) è una policy autonoma che viene creata e amministrata da AWS. La seguente policy AWS gestita per CloudShell può essere allegata alle identità IAM:
+ `AWSCloudShellFullAccess`: concede l'autorizzazione all'uso AWS CloudShell con accesso completo a tutte le funzionalità.
Se desideri limitare l'ambito di azioni che un utente IAM può eseguire AWS CloudShell, puoi creare una policy personalizzata che utilizzi la policy `AWSCloudShellFullAccess` gestita come modello. Per ulteriori informazioni sulla limitazione delle azioni disponibili per gli utenti in CloudShell, consulta [Gestire AWS CloudShell l'accesso e l'utilizzo con le politiche IAM](https://docs.aws.amazon.com/cloudshell/latest/userguide/sec-auth-with-identities.html) nella *Guida per l'AWS CloudShell utente*.
**Nota**
La tua identità IAM richiede anche una policy che conceda l'autorizzazione a effettuare chiamate ad App Runner. Per ulteriori informazioni, consulta [Come funziona App Runner con IAM](security_iam_service-with-iam.md).
## Interagire con App Runner utilizzando AWS CloudShell
Dopo l'avvio AWS CloudShell da Console di gestione AWS, puoi iniziare immediatamente a interagire con App Runner utilizzando l'interfaccia a riga di comando.
Nell'esempio seguente, recuperi informazioni su uno dei tuoi servizi App Runner utilizzando in. AWS CLI CloudShell
**Nota**
Quando si utilizza AWS CLI in AWS CloudShell, non è necessario scaricare o installare risorse aggiuntive. Inoltre, poiché hai già eseguito l'autenticazione alla shell, non è necessario configurare le credenziali prima di effettuare chiamate.
**Example Recupero delle informazioni sul servizio App Runner utilizzando AWS CloudShell**
1. Da Console di gestione AWS, puoi avviarlo CloudShell scegliendo le seguenti opzioni disponibili nella barra di navigazione:
+ Scegli l' CloudShell icona.
+ Inizia a digitare **cloudshell** nella casella di ricerca, quindi scegli l'**CloudShell**opzione quando la vedi nei risultati della ricerca.
1. Per elencare tutti i servizi App Runner correnti nel tuo AWS account nella AWS regione della sessione della console, inserisci il seguente comando nella riga di CloudShell comando:
```
$ aws apprunner list-services
```
L'output elenca le informazioni di riepilogo per i tuoi servizi.
```
{
"ServiceSummaryList": [
{
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING"
},
{
"ServiceName": "my-app-2",
"ServiceId": "ab8f94cfe29a460fb8760afd2ee87555",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-2/ab8f94cfe29a460fb8760afd2ee87555",
"ServiceUrl": "e2m8rrrx33.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-06T23:15:30Z",
"UpdatedAt": "2020-11-23T13:21:22Z",
"Status": "RUNNING"
}
]
}
```
1. Per ottenere una descrizione dettagliata di un particolare servizio App Runner, inserisci il seguente comando nella CloudShell riga di comando, utilizzando uno dei ARNs recuperati nel passaggio precedente:
```
$ aws apprunner describe-service --service-arn arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa
```
L'output elenca una descrizione dettagliata del servizio specificato.
```
{
"Service": {
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING",
"SourceConfiguration": {
"CodeRepository": {
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "[pip install -r requirements.txt]",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "API"
}
},
"AutoDeploymentsEnabled": true,
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-2:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
},
"HealthCheckConfiguration": {
"Protocol": "TCP",
"Path": "/",
"Interval": 10,
"Timeout": 5,
"HealthyThreshold": 1,
"UnhealthyThreshold": 5
},
"AutoScalingConfigurationSummary": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001",
"AutoScalingConfigurationName": "DefaultConfiguration",
"AutoScalingConfigurationRevision": 1
}
}
}
```
## Verifica del servizio App Runner utilizzando AWS CloudShell
Quando [crei un servizio App Runner](manage-create.md), App Runner crea un dominio predefinito per il sito Web del servizio e lo mostra nella console (o lo restituisce nel risultato della chiamata API). Puoi utilizzarlo CloudShell per effettuare chiamate al tuo sito Web e verificare che funzioni correttamente.
Ad esempio, dopo aver creato un servizio App Runner come descritto in[Guida introduttiva a App Runner](getting-started.md), esegui il seguente comando in CloudShell:
```
$ curl https://qxuadi4qwp.us-east-2.awsapprunner.com/; echo
```
L'output dovrebbe mostrare il contenuto della pagina previsto.
![\[Visualizzazione della finestra del browser AWS CloudShell con un comando per visualizzare il contenuto di una pagina di servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/api-cshell-curl.png)