Creazione di applicazioni App Engine con l'API Admin

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata al momento della creazione dell'app. Il codice non corrispondono a un paese o a una provincia, anche se potrebbero essere visualizzati alcuni ID regione in modo simile ai codici paese e provincia 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.

Scopri di più sugli ID regione.

Utilizza 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 una risorsa Application per un progetto Google Cloud di destinazione nella posizione specificata.

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

Devi soddisfare i seguenti prerequisiti prima di poter creare un Applicazione App Engine che utilizza l'API Admin:

  • 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'applicazione App Engine, il proprietario del progetto Google Cloud deve prima creare la risorsa Application. Ad esempio, devi creare App Engine prima che un account utente con il ruolo di Deployer App Engine possa eseguire il deployment un'app utilizzando un servizio Google Cloud.

Per creare un progetto Google Cloud:

API

Per creare in modo programmatico un progetto Google Cloud, puoi utilizzare API Cloud Resource Manager, consulta Creazione di una nuova Project per maggiori dettagli. Guarda un breve esempio.

Console

Per creare un progetto Google Cloud utilizzando Console Google Cloud:

Vai alla pagina Progetti

gcloud

Dopo aver installato Google Cloud CLI, puoi eseguire il seguente comando di gcloud CLI per creare un progetto Google Cloud:

gcloud projects create

Se scegli di utilizzare un progetto Google Cloud esistente, devi assicurarti che il progetto non contenga già la risorsa Application perché i progetti supportano solo una singola 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 dell'accesso all'API Admin può essere eseguita con OAuth a seconda delle esigenze della tua app con API. Per ulteriori informazioni, vedi Accesso all'API.

  2. Invia una richiesta HTTP POST 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 l'applicazione App Engine si trova come elencato in Località di App Engine, ad esempio us-east1.

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

      Esempio: autorizza ed esegui questo di esempio in Explorer API per visualizzare un elenco corrente 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 la tua 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 la tua 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 il nome dell'operazione nel campo name, che viene utilizzato con il metodo GET della raccolta apps.operations 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 GET HTTP:

      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.

      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",
    "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.

      Esempio di risposta:

      {
  "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 al momento della creazione dell'app. Il codice non corrispondono a un paese o a una provincia, anche se potrebbero essere visualizzati alcuni ID regione in modo simile ai codici paese e provincia 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