REST Resource: files

Risorsa: file

Un file caricato nell'API.

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "mimeType": string,
  "sizeBytes": string,
  "createTime": string,
  "updateTime": string,
  "expirationTime": string,
  "sha256Hash": string,
  "uri": string
}
Campi
name

string

Immutabile. Identificatore. Il nome della risorsa File. L'ID (nome senza il prefisso "files/") può contenere fino a 40 caratteri alfanumerici minuscoli o trattini (-). L'ID non può iniziare o terminare con un trattino. Se al momento della creazione il nome risulta vuoto, ne verrà generato un nome univoco. Esempio: files/123-456

displayName

string

Campo facoltativo. Il nome visualizzato leggibile per File. Il nome visualizzato non deve superare i 512 caratteri, spazi inclusi. Esempio: "Immagine di benvenuto"

mimeType

string

Solo output. Tipo MIME del file.

sizeBytes

string (int64 format)

Solo output. Dimensioni del file in byte.

createTime

string (Timestamp format)

Solo output. Il timestamp della creazione di File.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento di File.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

expirationTime

string (Timestamp format)

Solo output. Il timestamp di quando File verrà eliminato. Da impostare solo se la scadenza di File è programmata.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

sha256Hash

string (bytes format)

Solo output. Hash SHA-256 dei byte caricati.

Una stringa con codifica Base64.

uri

string

Solo output. L'URI di File.

Metodi

delete

Elimina File.

get

Recupera i metadati per l'elemento File specificato.

list

Elenca i metadati per i File di proprietà del progetto richiedente.