Gestire le risorse API

Questa pagina si applica ad Apigee e Apigee hybrid.

Registra un'API

Quando registri un'API con l'hub API, crei e memorizzi un'entità che la rappresenta. Chiamiamo questa entità risorsa API. Le risorse API archiviate nell'hub API sono disponibili per la ricerca e forniscono informazioni operative e descrittive dettagliate sull'API. Al momento della registrazione di un'API o in un secondo momento, puoi aggiungere e modificare gli attributi delle risorse dell'API per creare una descrizione completa dell'API.

Console

Per registrare un'API:

  1. Nella console Google Cloud, vai alla pagina API in API Hub.

    Vai ad API Hub
  2. Fai clic su Registra API.

  3. In Dettagli generali, specifica facoltativamente un ID univoco per l'API. Se non fornisci un ID, il sistema ne genererà uno per te. Se vuoi inserire un ID, fai clic su Specifica ID univoco.

    L'ID deve essere composto da 4-500 caratteri e i caratteri validi sono /[A-Z][a-z][0-9]-/. L'ID è l'ultimo componente del nome della risorsa API univoco e completo, nel formato: projects/PROJECT/locations/LOCATION/apis/API_ID

  4. (Obbligatorio) Fornisci un nome visualizzato per la risorsa API.
  5. Se vuoi, aggiungi altri attributi che descrivono l'API. Puoi tornare all'API in qualsiasi momento per aggiungere o modificare gli attributi dell'API. Consulta Modificare una risorsa API.
    • Informazioni sul proprietario: (facoltativo) nome e indirizzo email del proprietario dell'API.
    • Dettagli aggiuntivi: (Facoltativo) specifica gli attributi per contribuire a definire l'API e renderla più facilmente ricercabile. Puoi definire valori predefinite per alcuni di questi attributi in Impostazioni. Per maggiori dettagli, vedi Gestire gli attributi.
    • Attributi definiti dall'utente: (Facoltativo) si tratta degli attributi che definisci in Impostazioni. Per maggiori dettagli, vedi Gestire gli attributi.
  6. Fai clic su Registrati.

REST

Per registrare un'API, utilizza l'API REST Crea API.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
    "display_name": "DISPLAY_NAME",            # Required attribute
    "description": "DESCRIPTION"               # description is an optional attribute
    }
    'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis?api_id=API_ID

Sostituisci quanto segue:

  • HUB_PROJECT: il nome del progetto host di API Hub. Il progetto host è stato selezionato durante il provisioning dell'hub API.
  • HUB_LOCATION: la posizione del progetto host. La località è stata scelta al momento del provisioning dell'hub API.
  • API_ID: (Facoltativo) inserisci un ID univoco per l'API. Se non fornisci questo parametro di query, il sistema genererà un ID univoco. L'ID deve essere composto da 4-500 caratteri e i caratteri validi sono /[A-Z][a-z][0-9]-/. L'ID è l'ultimo componente del nome della risorsa API univoco e completo, nel formato: projects/PROJECT/locations/LOCATION/apis/API_ID
  • DISPLAY_NAME: (obbligatorio) il nome visualizzato della risorsa API. Puoi utilizzare qualsiasi nome.
  • DESCRIPTION: (Facoltativo) puoi aggiungere una serie di attributi facoltativi per descrivere la risorsa API, tra cui una descrizione, un proprietario, un link alla documentazione dell'API e altro ancora. Questi attributi facoltativi sono elencati e descritti nella definizione della risorsa API.

Elenca le risorse API

Questa sezione spiega come elencare le risorse API nell'hub API. Aggiungendo un filtro, puoi limitare le API restituite nella risposta.

Console

Per elencare le risorse API:

  1. Nella console Google Cloud, vai alla pagina API in API Hub.

    Vai all'hub API

    Un elenco di tutte le API aggiunte all'hub API è disponibile nella home page delle API.

  2. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la ricerca per trovare un'API.

REST

Per elencare tutte le risorse API nel progetto dell'hub API, utilizza l'API List APIs:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis"
  -X GET -H "Authorization: Bearer: $(gcloud auth print-access-token)" -H "Content-Type: application/json"

Sostituisci quanto segue:

  • HUB_PROJECT: il nome del progetto host di API Hub. Il progetto host è stato selezionato durante il provisioning dell'hub API.
  • HUB_LOCATION: la posizione del progetto host. La località è stata scelta al momento del provisioning dell'hub API.

Esempio di output:

{
  "apis": [
    {
      "name": "projects/myproject/locations/us-central1/apis/a035eb3b-658e-467a-89d3-9cca2bbacd32-2",
      "displayName": "TestApi2",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/a035eb3b-658e-467a-89d3-9cca2bbacd32-1",
      "displayName": "TestApi1",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/foo9013cfev",
      "displayName": "sample",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/foo90121",
      "displayName": "sample",
      "documentation": {}
    },
    ...
    ],
    "nextPageToken": "f4f4d78b-a974-46db-a214-dc139f8e9c8a"
  }

Esempio REST con filtro

Puoi filtrare i risultati dell'elenco utilizzando l'API. In questo esempio, filtriamo le API in base a un attributo definito dal sistema: 

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis' \
  -d filter="owner.email=\"testowner3@gmail.com\"" -d page_size=10

Sostituisci quanto segue:

  • HUB_PROJECT: il nome del progetto host di API Hub. Il progetto host è stato selezionato durante il provisioning dell'hub API.
  • HUB_LOCATION: la posizione del progetto host. La località è stata scelta al momento del provisioning dell'hub API.

Esempio di output, filtrato per proprietario:

{
  "apis": [
    {
      "name": "projects/myproject/locations/us-central1/apis/theme-park-management-api",
      "displayName": "Theme Park Management API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/restaurant-api",
      "displayName": "Restaurant API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/casino-management-api",
      "displayName": "Casino Management API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/hotel-boooking-api",
      "displayName": "Hotel Booking API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/test-march-26-api3",
      "displayName": "Test Pets API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/test-march-26-api2",
      "displayName": "Test Pets API",
      "documentation": {}
    },
    {
      "name": "projects/myproject/locations/us-central1/apis/test-march-26-api1",
      "displayName": "Test Pets API",
      "documentation": {}
    }
  ]
}

Ottenere i dettagli della risorsa API

Questa sezione spiega come ottenere i dettagli di una risorsa API.

Console

Per visualizzare i dettagli di una risorsa API:

  1. Nella console Google Cloud, vai alla pagina API in API Hub.

    Vai all'hub API
  2. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la ricerca per trovare un'API.
  3. Fai clic su un'API per visualizzarne la pagina dei dettagli.

REST

Per visualizzare i dettagli di una risorsa API, utilizza l'API Get API resource details:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID"
  -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X GET -H "Content-Type: application/json"

Sostituisci quanto segue:

  • HUB_PROJECT: il nome del progetto host di API Hub. Il progetto host è stato selezionato durante il provisioning dell'hub API.
  • HUB_LOCATION: la posizione del progetto host. La località è stata scelta al momento del provisioning dell'hub API.
  • API_ID: l'ID univoco della risorsa API.

Esempio di output:

{
  "name": "projects/myproject/locations/us-central1/apis/myapi",
  "displayName": "My Test API",
  "description": "This is a test API.",
  "documentation": {},
  "owner": {
    "displayName": "Test API,
    "email": "testowner@gmail.com"
  },
  "versions": [
    "projects/myproject/locations/us-central1/apis/myapi/versions/myapi-version1"
  ],
  "createTime": "2024-03-26T10:13:15.668867002Z",
  "updateTime": "2024-03-26T10:13:16.700716401Z"
}

Eliminare una risorsa API

Questa sezione spiega come eliminare una risorsa API.

Console

Quando elimini un'API nell'interfaccia utente, vengono eliminate tutte le versioni sottostanti dell'API e le eventuali specifiche dell'API associate.

Per eliminare una risorsa API:

  1. Nella console Google Cloud, vai alla pagina API in API Hub.

    Vai all'hub API
  2. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la ricerca per trovare un'API da eliminare.
  3. Nel menu Azioni (lato destro della riga contenente l'API), fai clic su Elimina.

REST

Per eliminare un'API dall'hub API, utilizza l'API Delete API.

Per impostazione predefinita, un'API può essere eliminata solo se vengono eliminate tutte le versioni sottostanti. Se vuoi eliminare tutte le versioni di un'API in un solo passaggio, imposta il parametro di query force su true nell'API REST Delete.

curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID'

Sostituisci quanto segue:

  • HUB_PROJECT: il nome del progetto host di API Hub. Il progetto host è stato selezionato durante il provisioning dell'hub API.
  • HUB_LOCATION: la posizione del progetto host. La località è stata scelta al momento del provisioning dell'hub API.
  • API_ID: l'ID univoco della risorsa API da eliminare.

Per eliminare l'API e tutte le versioni sottostanti, imposta il parametro di query force su true. Ad esempio:

curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID?force=true'

Modificare una risorsa API

Questa sezione spiega come modificare una risorsa API. Non tutti gli attributi delle risorse dell'API sono modificabili. Per l'elenco degli attributi modificabili, consulta il documento di riferimento dell'API Patch.

Console

Per modificare un'API:

  1. Nella console Google Cloud, vai alla pagina API in API Hub.

    Vai all'hub API
  2. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la Ricerca per individuare un'API da modificare.
  3. Fai clic su un'API per visualizzarne la pagina dei dettagli.
  4. Fai clic su Modifica API.
  5. Nella pagina Modifica API, apporta le modifiche. Fai clic su Continua per passare al successivo insieme di attributi modificabili.
    • Dettagli generali: puoi modificare il nome visualizzato dell'API.
    • Informazioni sul proprietario: nome e indirizzo email del proprietario dell'API.
    • Dettagli aggiuntivi: sono gli attributi definiti dal sistema. Puoi specificare valori predefiniti personalizzati per questi attributi in Gestisci attributi.
    • Attributi definiti dall'utente: si tratta degli attributi personalizzati definiti dall'utente. Puoi specificare gli attributi personalizzati in Gestisci attributi.
  6. Fai clic su Salva.

REST

Per modificare una risorsa API, utilizza l'API Patch API resource.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
          "display_name": "Updated Test Docs API",        # Example request body with changes
          "description": "This is the updated test API.",
          "owner": {
            "display_name": "Updated Docs Owner",
            "email": "updateddocsowner@gmail.com"
            }
          }
          ' https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID

Sostituisci quanto segue:

  • HUB_PROJECT: il nome del progetto host di API Hub. Il progetto host è stato selezionato durante il provisioning dell'hub API.
  • HUB_LOCATION: la posizione del progetto host. La località è stata scelta al momento del provisioning dell'hub API.
  • API_ID: l'ID univoco dell'API da aggiornare.
  • Corpo della richiesta: utilizza il corpo della richiesta per specificare gli attributi che vuoi modificare. Consulta la descrizione del corpo della richiesta API.