Questa pagina descrive come configurare l'ambiente di sviluppo per utilizzare l'API Service Management. L'approccio più semplice per utilizzare l'API Service Management (diverso dall'utilizzo dell'interfaccia utente web della consoleGoogle Cloud ) e il nostro consiglio per la maggior parte dei casi d'uso operativi è tramite l'interfaccia a riga di comando di gcloud. Se
devi programmare in base all'API Service Management, ti consigliamo di utilizzare una delle nostre
librerie client fornite.
Per sperimentare l'API, puoi seguire le istruzioni di configurazione alternative riportate di seguito e utilizzare il comando curl per interagire con l'API senza configurare un ambiente di sviluppo di applicazioni completo.
Configurazione tramite gcloud
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Enable the Service Management API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles. -
Install the Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per ulteriori informazioni, vedi Accedi a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud initConfigurazione per chiamare direttamente l'API
Questa sezione descrive i passaggi di base necessari per configurare l'ambiente locale per sperimentare l'API Service Management utilizzando il comando
curl. È rivolta agli sviluppatori che devono programmare in base all'API Service Management.Configurazione iniziale
-
Install the Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per ulteriori informazioni, vedi Accedi a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Create or select a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_IDwith a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_IDwith your Google Cloud project name.
-
Enable the Service Management API:
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.gcloud services enable servicemanagement.googleapis.com
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/servicemanagement.admingcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
PROJECT_ID: Your project ID.USER_IDENTIFIER: The identifier for your user account. For examples, see Represent workforce pool users in IAM policies.ROLE: The IAM role that you grant to your user account.
Definisci un alias shell pratico per chiamare le API REST di Google:
$ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'Prova a elencare i servizi accessibili pubblicamente:
$ gcurl https://servicemanagement.googleapis.com/v1/servicesSe vedi un elenco di servizi, la configurazione è riuscita.
- Segui la procedura descritta in Creazione ed eliminazione di servizi per creare servizi gestiti. Verrà creata una risorsa di servizio gestito di primo livello.
Segui le istruzioni riportate in Gestione delle configurazioni dei servizi per inviare le configurazioni dei servizi per descrivere le funzionalità utilizzate dal servizio.
Segui la procedura descritta in Implementazione delle configurazioni dei servizi per implementare le configurazioni dei servizi.
Testare con curl
Passaggi successivi
Se stai creando un servizio gestito e non utilizzi Cloud Endpoints:
-