Creazione di applicazioni App Engine con l'API Admin

Utilizzare l'API App Engine Admin per creare applicazioni App Engine a livello di programmazione in nuovi progetti Google Cloud. Utilizzando sia l'API Admin sia l'API Cloud Resource Manager, puoi gestire a livello di programmazione progetti Google Cloud e applicazioni App Engine.

La creazione di un'applicazione App Engine crea Application risorsa per un progetto Google Cloud di destinazione località.

Per creare manualmente un'applicazione App Engine in un progetto Google Cloud, consulta l'argomento Gestire progetti, applicazioni e fatturazione nella tua lingua nell'ambiente standard o nell'ambiente flessibile.

Prima di iniziare

Per poter creare un'applicazione App Engine utilizzando l'API Admin, devi soddisfare i seguenti prerequisiti:

• Devi creare o disporre di un progetto Google Cloud esistente.
• Devi essere il proprietario del progetto Google Cloud di destinazione.
• Devi essere in grado di: accedere all'API Admin.

Prima che qualsiasi altro account utente possa eseguire attività su un App Engine dell'applicazione, il proprietario del progetto Google Cloud deve prima creare Application risorsa. Ad esempio, devi creare l'applicazione App Engine prima che un account utente con il ruolo App Engine Deployer possa eseguire il deployment di un'app utilizzando un account di servizio.

Per creare un progetto Google Cloud:

gcloud projects create

Se scegli di utilizzare un progetto Google Cloud esistente, devi assicurarti che il progetto non contiene già la risorsa Application perché i progetti supportano una sola applicazione App Engine. Per verificare se Il progetto Google Cloud contiene già la risorsa Application, puoi utilizzare o il apps.get o esegui il comando gcloud app describe.

Creazione di un'applicazione App Engine

Per creare un'applicazione App Engine con l'API Admin:

1. Autorizzare le richieste HTTP, ad esempio ottenere un token di accesso.

   L'autorizzazione di accesso all'API Admin può essere eseguita con diversi flussi OAuth, a seconda delle esigenze dell'app API. Per ulteriori informazioni, consulta Accedere all'API.

2. Invia una richiesta POST HTTP utilizzando il tuo token di accesso e l'API Admin per creare un'applicazione App Engine.

   Sei tu a definire Application risorsa e del progetto Google Cloud di destinazione nella richiesta POST HTTP, esempio:

   POST https://appengine.googleapis.com/v1/apps { "id": "[MY_PROJECT_ID]", "locationId": "[MY_APP_LOCATION]" }
   

   Campi di richiesta HTTP obbligatori:

   • id: l'ID del progetto Google Cloud di destinazione in cui vuoi creare un'applicazione App Engine.

   • locationId: il nome della regione geografica in cui si trova l'applicazione App Engine, come indicato in Località di App Engine, ad esempio us-east1.

     Per un elenco completo delle località supportate, puoi utilizzare apps.locations.list.

     Esempio: autorizza ed esegui questa richiesta di esempio in Explorer API per visualizzare un elenco aggiornato delle località supportate.

   Consulta la risorsa Application per l'elenco completo delle opzioni di campo.

   Comando cURL di esempio:

   curl -X POST -d "{ 'id': '[MY_PROJECT_ID]', 'locationId': '[MY_APP_LOCATION]' }" -H "Content-Type: application/json" -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps
   

   Dove:

   • [MY_PROJECT_ID] è l'ID del progetto di destinazione in cui vuoi creare dell'applicazione App Engine.
   • [MY_APP_LOCATION] è la posizione in cui vuoi creare il tuo nell'applicazione App Engine.
   • [MY_ACCESS_TOKEN] è il token di accesso che hai ottenuto per autorizzare le tue richieste HTTP.

   Risposta di esempio:

   {
     "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f",
     "metadata": {
       "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1",
       "method": "google.appengine.v1.Applications.CreateApplication",
       "insertTime": "2016-10-03T20:48:02.099Z",
       "user": "me@example.com",
       "target": "apps/[MY_PROJECT_ID]"
     }
   }
   

3. Verifica che l'applicazione App Engine sia stata creata:

   1. Visualizza lo stato dell'effettiva operazione di creazione:

      La richiesta HTTP POST utilizzata nel passaggio precedente ha restituito del nome dell'operazione nel campo name, che utilizzi con il metodo GET di apps.operations raccolta per controllare lo stato dell'operazione di creazione.

      Ad esempio, se il campo name della risposta è:

      "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f"
      

      Quindi invia la seguente richiesta HTTP GET:

      GET https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f
      

      Esempio di comando cURL:

      curl -X GET -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f
      

      Dove [MY_ACCESS_TOKEN] è il tuo token di accesso e [MY_PROJECT_ID] è l'ID del progetto di destinazione.

      Esempio di risposta:

      {
        "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f",
        "metadata": {
          "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1",
          "method": "google.appengine.v1.Applications.CreateApplication",
          "insertTime": "2016-10-03T20:48:02.099Z",
          "endTime": "2016-10-03T20:48:18.272Z",
          "user": "me@example.com",
          "target": "apps/[MY_PROJECT_ID]"
        },
        "done": true,
        "response": {
          "@type": "type.googleapis.com/google.appengine.v1.Application",
          "id": "[MY_PROJECT_ID]",
          "locationId": "[MY_APP_LOCATION]"
        }
      }
      

   2. Verifica che l'applicazione App Engine sia stata creata nel tuo progetto:

      Per visualizzare i dettagli della versione, utilizza il metodo GET della Raccolta apps. Devi specificare il progetto di cui hai eseguito il deployment nell'istanza HTTP GET richiesta, ad esempio:

      GET https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]
      

      Esempio di comando cURL:

      curl -X GET -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/
      

      Dove [MY_ACCESS_TOKEN] è il tuo token di accesso e [MY_PROJECT_ID] è l'ID del progetto di destinazione.

      Risposta di esempio:

      {
        "name": "apps/[MY_PROJECT_ID]",
        "id": "[MY_PROJECT_ID]",
        "authDomain": "gmail.com",
        "locationId": "us-central",
        "defaultHostname": "[MY_PROJECT_ID].[REGION_ID].r.appspot.com",
        "defaultBucket": "[MY_PROJECT_ID].[REGION_ID].r.appspot.com"
      }
      

      REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata quando crei l'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici di paesi e province di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Passaggi successivi

• Deployment dell'app