Gestire le risorse API con Apigee Spaces

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questo argomento descrive come creare e gestire le risorse API in uno spazio. Puoi creare proxy API, flussi condivisi e prodotti API in uno spazio. Le risorse create nello spazio ereditano le stesse autorizzazioni dello spazio.

La creazione di risorse in uno spazio è la stessa di quella in un'organizzazione Apigee, tranne per il fatto che puoi selezionare uno spazio quando crei la risorsa. Puoi creare risorse API dalla riga di comando utilizzando le API Apigee o Apigee in Cloud Console.

Questa guida illustra i passaggi necessari per:

• Creare proxy API in uno spazio
• Creare flussi condivisi in uno spazio
• Creare prodotti API in uno spazio
• Elenca tutte le risorse API in uno spazio

Per una panoramica di Apigee Spaces, consulta Apigee Spaces.

Per ulteriori informazioni sui tipi di risorse dell'API Apigee, consulta:

• Creazione di un proxy API
• Creare flussi condivisi riutilizzabili
• Introduzione ai prodotti API

Prima di iniziare

Prima di iniziare a creare risorse API in Apigee Spaces, assicurati di completare le seguenti attività:

• Esegui il provisioning dell'organizzazione Apigee con abbonamento o con pagamento a consumo. Per ulteriori informazioni sulla procedura di provisioning di Apigee, consulta Configurare Apigee.
• Crea uno spazio nella tua organizzazione Apigee. Per ulteriori informazioni, vedi Creare spazi Apigee.
• Assegnare membri a uno spazio. Per saperne di più, vedi Gestire membri e ruoli in uno spazio.

Ruoli e autorizzazioni richiesti

Con l'introduzione di Apigee Spaces, il modo in cui IAM controlla le autorizzazioni necessarie per eseguire alcune operazioni sulle risorse API è cambiato. Se la risorsa API esiste in uno spazio, IAM verificherà le autorizzazioni appropriate a livello di spazio per il membro dello spazio che esegue l'operazione. Per ulteriori informazioni, consulta Ruoli e autorizzazioni di Apigee Spaces e Gerarchia delle autorizzazioni IAM per Apigee Spaces.

Assegnare ruoli e autorizzazioni ai membri dello spazio

Per i membri dello spazio sono disponibili tre ruoli personalizzati:

• apigee.spaceContentEditor: fornisce l'accesso completo alle risorse che possono essere associate a uno spazio. Questo ruolo deve essere concesso a livello di spazio.
• apigee.spaceContentViewer: fornisce l'accesso di sola lettura alle risorse che possono essere associate a uno spazio. Questo ruolo deve essere concesso a livello di spazio.
• apigee.spaceConsoleUser: fornisce le autorizzazioni minime necessarie per gestire le risorse in uno spazio utilizzando la console Google Cloud. Questo ruolo deve essere concesso a Google Cloud livello di progetto agli utenti con accesso alle risorse nello spazio.

I ruoli personalizzati descritti in questa sezione non consentono ai membri dello spazio di eseguire o annullare il deployment di proxy API o flussi condivisi. Se vuoi consentire a un membro dello spazio di gestire i deployment, imposta un criterio IAM a livello di progetto o dell'ambiente Apigee concedendo il ruolo apigee.environment.admin al membro dello spazio. Google Cloud

Puoi assegnare uno o più ruoli a un membro di uno spazio utilizzando uno dei seguenti metodi:

• Aggiungi il ruolo apigee.spaceContentEditor allo spazio utilizzando l'API e il ruolo apigee.environmentAdmin all'ambiente di destinazione utilizzando l'API.
• Aggiungi i ruoli al progetto utilizzando l'interfaccia utente di IAM.

Per verificare le norme IAM applicate a livello di spazio, consulta Gestire membri e ruoli in uno spazio.

Gestire i proxy API in uno spazio

I membri dell'organizzazione Apigee assegnati a uno spazio possono creare proxy API come risorse dello spazio. I membri assegnati solo ad altri spazi non potranno accedere o gestire questi proxy.

Crea un proxy API come risorsa Space utilizzando Apigee nella console Cloud o l'API, come descritto nelle sezioni seguenti.

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apis?name=PROXY_NAME&space=SPACE_NAME&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data" \
    -F "file=@PROXY_BUNDLE"

curl "https://apigee.googleapis.com/v1/organizations/acme/apis?name=proxy-1&space=red&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data \
    -F "file=@proxy-bundle.zip"

{
  "basepaths": ["/proxy-1"],
  "revision": 1,
  "apiProxyId": "proxy-1",
  "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
  "space": "red",
  "createTime": ...,
  "updateTime": ...
}

Gestire i flussi condivisi come risorse di Space

I membri assegnati a uno spazio possono anche creare flussi condivisi come risorse dello spazio. I membri di altri spazi non potranno accedere o gestire questi flussi condivisi.

Crea un flusso condiviso come risorsa Space utilizzando la console Apigee in Cloud o l'API, come descritto nelle sezioni seguenti.

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/sharedflows?name=FLOW_NAME&space=SPACE_NAME&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data" \
    -F "file=@SHARED_FLOW_BUNDLE"

curl "https://apigee.googleapis.com/v1/organizations/acme/sharedflows?name=flow-1&space=red&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data" \
    -F "file=@sharedflow-bundle.zip"

{
  "name": "organizations/acme/sharedflows/flow-1",
  "revision": 1,
  "sharedFlowId": "flow-1",
  "space": "red",
  "createTime": ...,
  "updateTime": ...
}

Gestire un prodotto API come risorsa Space

I membri assegnati a uno spazio possono creare un prodotto API per raggruppare i proxy API. Quando creano prodotti API, i membri dello spazio possono selezionare tutti i proxy API a loro accessibili, inclusi i proxy creati direttamente nell'organizzazione e i proxy API creati come risorse negli spazi a cui hanno accesso. I membri di altri spazi non potranno accedere o gestire questi prodotti API.

Crea un prodotto API come risorsa Space utilizzando Apigee nella console Cloud o l'API, come descritto nelle sezioni seguenti.

curl -X POST "https://apigee.googleapis.com/v1/organizations/acme/apiproducts" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: application/json" -d \
      `{
        "name": "product-1",
        "displayName": "product-1",
        "approvalType": "auto",
        "attributes": [
          {
            "name": "access",
            "value": "internal"
          }
        ],
        "environments": [
          "test"
        ],
        "operationGroup": {
          "operationConfigs": [
            {
              "apiSource": "proxy-1",
              "operations": [
                {
                  "resource": "/",
                  "methods": [
                    "GET"
                  ]
                }
              ]
            }
          ],
          "operationConfigType": "proxy"
        },
        "space": "red"
      }'

{
  "name": "product-1",
  "displayName": "product-1",
  "approvalType": "auto",
    "attributes": [
      {
        "name": "access",
        "value": "internal"
      }
    ],
    "environments": [
    "test"
  ],
  "createdAt": "1741977778448",
  "lastModifiedAt": "1741977778448",
  "operationGroup": {
    "operationConfigs": [
      {
        "apiSource": "proxy-1",
        "operations": [
          {
            "resource": "/",
            "methods": [
              "GET"
            ]
          }
        ]
      }
    ],
    "operationConfigType": "proxy"
  },
  "space": "red"
}

Elenca tutte le risorse API associate a uno spazio

Per tutte le operazioni di elenco, tra cui ListApiProxies, ListSharedFlows e ListApiProducts, puoi specificare il nome di uno spazio per elencare tutte le risorse associate a quello spazio. Se non specifichi un nome di spazio, l'operazione di elenco restituirà tutte le risorse dell'organizzazione a cui hai l'autorizzazione di accesso, indipendentemente dal fatto che siano associate o meno a uno spazio.

È importante notare che, quando utilizzi la funzionalità Apigee Spaces, i risultati delle operazioni list per le risorse API assegnate a un spazio saranno limitati ai risultati per gli spazi a cui il principale può accedere. Ad esempio, se a acme-team@acme.com viene assegnato il ruolo apigee.spaceContentEditor per lo spazio rosso, i membri del team acme-team che utilizzano l'operazione list vedranno solo i proxy API associati allo spazio rosso e non tutti i proxy API dell'organizzazione.

Per eseguire questa operazione, devi disporre dell'autorizzazione apigee.apiResources.list. Questa autorizzazione è inclusa nel ruolo Apigee > Apigee Organization Admin.

Elenca le risorse API associate a uno spazio specifico

Elenca tutte le risorse API associate a uno spazio specifico in Apigee in Cloud Console o utilizzando l'API, come descritto nelle sezioni seguenti.

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE?space=SPACE_NAME"

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis?space=red"

{
  "proxies": [
    {
      "basepaths": "/proxy-1",
      "revision": "1",
      "apiProxyId": "proxy-1",
      "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
      "space": "red",
      "createTime": ...,
      ....
    }
  ]
}

Elenca le risorse API senza specificare uno spazio

Elenca tutte le risorse API senza specificare uno spazio in Apigee nella console Cloud o utilizzando l'API, come descritto nelle sezioni seguenti.

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE"

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis"

{
  "proxies": [
    {
      "basepaths": "/proxy-1",
      "revision": "1",
      "apiProxyId": "proxy-1",
      "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
      "space": "red",
      "createTime": ...,
      ....
    },
    {
      "basepaths": "/proxy-2",
      "revision": "1",
      "apiProxyId": "proxy-2",
      "resourceName": "organizations/acme/apis/proxy-2/revisions/1",
      "space": "blue",
      "createTime": ...,
      ....
    },
    {
      "basepaths": "/proxy-3",
      "revision": "1",
      "apiProxyId": "proxy-3",
      "resourceName": "organizations/acme/apis/proxy-3/revisions/1",
      "space": "green",
      "createTime": ...,
      ....
    }
  ]
}

{
  "proxies": [
    {
      "basepaths": "/proxy-1",
      "revision": "1",
      "apiProxyId": "proxy-1",
      "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
      "space": "red",
      "createTime": ...,
      ....
    }
  ]
}

Passaggi successivi

• Scopri di più su Apigee Spaces.
• Scopri come creare e gestire gli spazi Apigee.
• Consulta la documentazione di Identity and Access Management (IAM).