Panoramica dell'API Storage

L'API Object Storage utilizza risorse personalizzate di Kubernetes e si basa sul modello di risorse Kubernetes. Le API vengono utilizzate per il provisioning e l'amministrazione delle risorse di archiviazione di oggetti. Vengono utilizzate per gestire il ciclo di vita delle risorse di archiviazione degli oggetti in una determinata organizzazione, inclusi la creazione, la lettura, l'aggiornamento e l'eliminazione dei bucket. Le API vengono utilizzate anche per elencare i bucket, impostare i criteri di conservazione dei bucket e impostare la classe di archiviazione dei bucket. L'archiviazione a blocchi viene gestita con le API Kubernetes standard.

Endpoint di servizio e documento di rilevamento

Le API KRM di Storage sono fornite in tre pacchetti a seconda del deployment zonale o globale.

Gli endpoint API per le API Storage globali e zonali sono i seguenti, rispettivamente:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.global.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/storage.global.gdc.goog/v1

La variabile MANAGEMENT_API_SERVER_ENDPOINT è l'endpoint del server API Management.

Utilizzando il comando kubectl proxy, puoi accedere a questo URL nel browser o con uno strumento come curl per ottenere il documento di rilevamento per l'API Object Storage. Il comando kubectl proxy apre un proxy al server API Kubernetes sulla tua macchina locale. Una volta eseguito il comando, puoi accedere al documento ai seguenti URL:

  • http://127.0.0.1:8001/apis/object.gdc.goog/v1
  • http://127.0.0.1:8001/apis/object.global.gdc.goog/v1
  • http://127.0.0.1:8001/apis/storage.global.gdc.goog/v1

Panoramica dell'API REST S3

L'API XML di Google Distributed Cloud (GDC) air-gapped Object Storage è un'interfaccia RESTful che consente di gestire i dati di archiviazione degli oggetti in modo programmatico. In quanto API RESTful, si basa su informazioni su metodi e ambito per definire le operazioni da eseguire:

  • Informazioni sul metodo. Specifichi le informazioni sul metodo con i metodi HTTP standard, ad esempio DELETE, GET, HEAD e PUT.
  • Informazioni sull'ambito. Specifichi le informazioni sull'ambito con un endpoint (URI) accessibile e vari parametri di definizione dell'ambito. Per l'API XML, i parametri di ambito principali sono i nomi del bucket e dell'oggetto. Limita ulteriormente l'ambito delle operazioni utilizzando intestazioni HTTP e parametri della stringa di query.

Panoramica dell'API Volume Storage

Per creare volumi permanenti, segui i passaggi descritti nella documentazione di Kubernetes all'indirizzo https://kubernetes.io/docs/concepts/storage/persistent-volumes/. L'interazione con l'archiviazione dei volumi all'interno di GDC avviene interamente tramite le primitive di archiviazione di Kubernetes. Il driver Volume Storage implementa il protocollo Container Storage Interface (CSI) e esegue il provisioning e l'orchestrazione dei volumi nel sistema di archiviazione, opaco per l'utente finale del volume permanente.

GDC supporta una singola classe di archiviazione di tipo standard-rwo. Per ulteriori informazioni sulle classi di archiviazione, consulta https://kubernetes.io/docs/concepts/storage/storage-classes/.