Risorsa: HttpBody
Messaggio che rappresenta un corpo HTTP arbitrario. Deve essere utilizzato solo per i formati di payload che non possono essere rappresentati come JSON, ad esempio file binari non elaborati o una pagina HTML.
Questo messaggio può essere utilizzato sia nei metodi API di streaming che in quelli non di streaming nella richiesta e nella risposta.
Può essere utilizzato come campo di richiesta di primo livello, il che è utile se si vogliono estrarre i parametri dall'URL o dal modello HTTP nei campi di richiesta e si vuole anche accedere al corpo HTTP non elaborato.
Esempio:
message GetResourceRequest {
// A unique request id.
string requestId = 1;
// The raw HTTP body is bound to this field.
google.api.HttpBody httpBody = 2;
}
service ResourceService {
rpc GetResource(GetResourceRequest)
returns (google.api.HttpBody);
rpc UpdateResource(google.api.HttpBody)
returns (google.protobuf.Empty);
}
Esempio con metodi di streaming:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
L'utilizzo di questo tipo modifica solo il modo in cui vengono gestiti i corpi della richiesta e della risposta, mentre tutte le altre funzionalità continueranno a funzionare invariate.
| Rappresentazione JSON |
|---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
| Campi | |
|---|---|
contentType |
Il valore dell'intestazione Content-Type HTTP che specifica il tipo di contenuto del corpo. |
data |
Il corpo della richiesta/risposta HTTP come file binario non elaborato. Una stringa con codifica in base64. |
extensions[] |
Metadati di risposta specifici dell'applicazione. Deve essere impostato nella prima risposta per le API di streaming. Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo |
Metodi |
|
|---|---|
|
Crea una vista Iceberg nello spazio dei nomi. |
|
Elimina una vista nello spazio dei nomi. |
|
Recupera una vista nello spazio dei nomi. |
|
Restituisce 204 se la visualizzazione esiste, altrimenti 404. |
|
Elenca gli identificatori delle visualizzazioni elenco (non le visualizzazioni) nello spazio dei nomi. |
|
Aggiorna una visualizzazione nello spazio dei nomi. |