- Richiesta HTTP
- Parametri di percorso
- Parametri di query
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Autorizzazioni IAM
- BlameRange
- Fai una prova!
Recupera le informazioni di attribuzione per un file o un intervallo di righe in un file.
Richiesta HTTP
GET https://developerconnect.googleapis.com/v1/{name=projects/*/locations/*/connections/*/gitRepositoryLinks/*}:fetchFileBlame
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di percorso
| Parametri | |
|---|---|
name |
Obbligatorio. Il nome risorsa di GitRepositoryLink nel formato |
Parametri di query
| Parametri | |
|---|---|
ref |
Obbligatorio. Lo SHA del commit SCM o la revisione simbolica (ad esempio, nome del branch, tag) da cui recuperare l'attribuzione. |
path |
Obbligatorio. Il percorso del file all'interno del repository. |
firstLine |
Facoltativo. Il numero di riga iniziale indicizzato a partire da 1 dell'intervallo da attribuire (incluso). Se non specificato, l'attribuzione inizia dalla riga 1. |
lastLine |
Facoltativo. Il numero di riga finale indicizzato a partire da 1 dell'intervallo da attribuire (incluso). Se non specificato, l'attribuzione si estende fino alla fine del file. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per gitRepositoryLinks.fetchFileBlame.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
|---|
{
"ranges": [
{
object ( |
| Campi | |
|---|---|
ranges[] |
L'elenco degli intervalli di attribuzione per il file. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per saperne di più, consulta la Authentication Overview.
Autorizzazioni IAM
Richiede la seguente autorizzazione IAM per la risorsa name:
developerconnect.gitRepositoryLinks.fetchFileBlame
Per saperne di più, consulta la documentazione di IAM.
BlameRange
BlameRange rappresenta le informazioni di attribuzione per un intervallo di righe.
| Rappresentazione JSON |
|---|
{
"firstLine": integer,
"lastLine": integer,
"commit": {
object ( |
| Campi | |
|---|---|
firstLine |
Il numero di riga iniziale dell'intervallo (incluso), indicizzato a partire da 1. |
lastLine |
Il numero di riga finale dell'intervallo (incluso), indicizzato a partire da 1. |
commit |
I metadati del commit per questo intervallo di righe. |