MCP Tools Reference: dataform.googleapis.com

Tool: list_repositories

Dataform-Repositories in einem bestimmten Google Cloud-Projekt und an einem bestimmten Standort auflisten.

Der Parameterwert parent muss das Format projects/{project_id}/locations/{location} haben.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_repositories aufrufen.

Curl-Anfrage 
                  
curl --location 'https://dataform.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_repositories",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

ListRepositories-Anfragenachricht.

ListRepositoriesRequest

JSON-Darstellung 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "filter": string
}
Felder
parent

string

Erforderlich. Der Ort, an dem Repositories aufgelistet werden sollen. Muss das Format projects/*/locations/* aufweisen.
pageSize

integer

Optional. Maximale Anzahl der zurückzugebenden Repositories. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server ein geeignetes Standardmodell aus.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen ListRepositories-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListRepositories bereitgestellten Parameter mit Ausnahme von page_size mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
orderBy

string

Optional. In diesem Feld wird nur die Sortierung nach name unterstützt. Wenn nichts angegeben ist, wählt der Server die Reihenfolge aus. Wenn angegeben, ist die Standardreihenfolge für das Feld name aufsteigend.
filter

string

Optional. Filter für die zurückgegebene Liste.

Ausgabeschema

ListRepositories-Antwortnachricht.

ListRepositoriesResponse

JSON-Darstellung 
{
  "repositories": [
    {
      object (Repository)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
repositories[]

object (Repository)

Liste der Repositories.
nextPageToken

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

Repository

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "displayName": string,
  "gitRemoteSettings": {
    object (GitRemoteSettings)
  },
  "npmrcEnvironmentVariablesSecretVersion": string,
  "workspaceCompilationOverrides": {
    object (WorkspaceCompilationOverrides)
  },
  "labels": {
    string: string,
    ...
  },
  "setAuthenticatedUserAdmin": boolean,
  "serviceAccount": string,
  "kmsKeyName": string,
  "dataEncryptionState": {
    object (DataEncryptionState)
  },

  // Union field _containing_folder can be only one of the following:
  "containingFolder": string
  // End of list of possible types for union field _containing_folder.

  // Union field _team_folder_name can be only one of the following:
  "teamFolderName": string
  // End of list of possible types for union field _team_folder_name.

  // Union field _internal_metadata can be only one of the following:
  "internalMetadata": string
  // End of list of possible types for union field _internal_metadata.
}
Felder
name

string

ID. Der Name des Repositorys.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für den Zeitpunkt, zu dem das Repository erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
displayName

string

Optional. Der nutzerfreundliche Name des Repositorys.
gitRemoteSettings

object (GitRemoteSettings)

Optional. Wenn diese Option festgelegt ist, wird dieses Repository so konfiguriert, dass es mit einem Git-Remote-Repository verknüpft wird.
npmrcEnvironmentVariablesSecretVersion

string

Optional. Der Name der Secret Manager-Secret-Version, die zum Einfügen von Variablen in die .npmrc-Datei für die Paketinstallation verwendet werden soll. Muss das Format projects/*/secrets/*/versions/* aufweisen. Die Datei selbst muss im JSON-Format vorliegen.
workspaceCompilationOverrides

object (WorkspaceCompilationOverrides)

Optional. Wenn festgelegt, überschreiben Felder von workspace_compilation_overrides die Standardeinstellungen für die Kompilierung, die in „dataform.json“ angegeben sind, wenn Kompilierungsergebnisse auf Arbeitsbereichsebene erstellt werden. Weitere Informationen finden Sie in der Dokumentation zu WorkspaceCompilationOverrides.
labels

map (key: string, value: string)

Optional. Nutzerlabels für Repositorys.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
setAuthenticatedUserAdmin

boolean

Optional. Nur Eingabe. Wenn dieser Wert auf „true“ gesetzt ist, erhält der authentifizierte Nutzer die Rolle „roles/dataform.admin“ für das erstellte Repository. Wenn Sie den Zugriff auf das erstellte Repository später ändern möchten, wenden Sie „setIamPolicy“ aus https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories an.
serviceAccount

string

Optional. Das Dienstkonto, unter dem Workflow-Aufrufe ausgeführt werden.
kmsKeyName

string

Optional. Der Verweis auf einen KMS-Verschlüsselungsschlüssel. Falls angegeben, wird sie zum Verschlüsseln von Nutzerdaten im Repository und allen untergeordneten Ressourcen verwendet. Der Verschlüsselungsschlüssel kann nach dem Erstellen des Repositorys nicht mehr hinzugefügt oder aktualisiert werden. Beispiel: projects/{kms_project}/locations/{location}/keyRings/{key_location}/cryptoKeys/{key}
dataEncryptionState

object (DataEncryptionState)

Nur Ausgabe. Der Datenverschlüsselungsstatus eines Git-Repositorys, wenn dieses Repository durch einen KMS-Schlüssel geschützt ist.

Union-Feld _containing_folder.

Für _containing_folder ist nur einer der folgenden Werte zulässig:
containingFolder

string

Optional. Der Name des übergeordneten Ordners des Repositorys. Das Feld ist unveränderlich und kann über den Vorgang „MoveRepository“ geändert werden. Format: projects/*/locations/*/folders/*. oder projects/*/locations/*/teamFolders/*.

Union-Feld _team_folder_name.

Für _team_folder_name ist nur einer der folgenden Werte zulässig:
teamFolderName

string

Nur Ausgabe. Der Ressourcenname des Teamordners, dem dieses Repository zugeordnet ist. Das Format muss „projects/{project}/locations/{location}/teamFolders/{teamFolder}“ sein. Wenn dies nicht festgelegt ist, ist das Repository nicht mit einem Teamordner verknüpft.

Union-Feld _internal_metadata.

Für _internal_metadata ist nur einer der folgenden Werte zulässig:
internalMetadata

string

Nur Ausgabe. Alle Metadateninformationen, die intern zum Bereitstellen der Ressource verwendet werden. Beispiele: Zeitstempel, Flags, Statusfelder usw. Das Format dieses Felds ist ein JSON-String.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

GitRemoteSettings

JSON-Darstellung 
{
  "url": string,
  "defaultBranch": string,
  "effectiveDefaultBranch": string,
  "authenticationTokenSecretVersion": string,
  "sshAuthenticationConfig": {
    object (SshAuthenticationConfig)
  },
  "tokenStatus": enum (TokenStatus),

  // Union field _git_repository_link can be only one of the following:
  "gitRepositoryLink": string
  // End of list of possible types for union field _git_repository_link.
}
Felder
url

string

Erforderlich. Die URL des Git-Remotes.
defaultBranch

string

Optional. Der Standardzweigname des Git-Remote-Repositorys. Wenn nicht festgelegt, wird main verwendet.
effectiveDefaultBranch

string

Nur Ausgabe. Der effektive Standardzweigname des Git-Remote-Repositorys. Dies ist der Standardzweigname des Git-Remote-Repositorys, sofern er festgelegt ist. Andernfalls ist es main.
authenticationTokenSecretVersion

string

Optional. Der Name der Secret Manager-Secret-Version, die als Authentifizierungstoken für Git-Vorgänge verwendet werden soll. Muss das Format projects/*/secrets/*/versions/* aufweisen.
sshAuthenticationConfig

object (SshAuthenticationConfig)

Optional. Authentifizierungsfelder für Remote-URIs mit dem SSH-Protokoll.
tokenStatus
(deprecated)

enum (TokenStatus)

Nur Ausgabe. Veraltet: Das Feld enthält keine Informationen zum Tokenstatus. Verwenden Sie stattdessen https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus.

Union-Feld _git_repository_link.

Für _git_repository_link ist nur einer der folgenden Werte zulässig:
gitRepositoryLink

string

Optional. Ressourcenname für die GitRepositoryLink, die für Computeranmeldedaten verwendet wird. Muss im Format projects/*/locations/*/connections/*/gitRepositoryLinks/* vorliegen.

SshAuthenticationConfig

JSON-Darstellung 
{
  "userPrivateKeySecretVersion": string,
  "hostPublicKey": string
}
Felder
userPrivateKeySecretVersion

string

Erforderlich. Der Name der Secret Manager-Secret-Version, die als privater SSH-Schlüssel für Git-Vorgänge verwendet werden soll. Muss das Format projects/*/secrets/*/versions/* aufweisen.
hostPublicKey

string

Erforderlich. Inhalt eines öffentlichen SSH-Schlüssels zum Bestätigen der Identität eines Remote-Git-Hosts.

WorkspaceCompilationOverrides

JSON-Darstellung 
{
  "defaultDatabase": string,
  "schemaSuffix": string,
  "tablePrefix": string
}
Felder
defaultDatabase

string

Optional. Die Standarddatenbank (Google Cloud-Projekt-ID).
schemaSuffix

string

Optional. Das Suffix, das an alle Schemanamen (BigQuery-Dataset-ID) angehängt werden soll.
tablePrefix

string

Optional. Das Präfix, das allen Tabellennamen vorangestellt werden soll.

LabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

DataEncryptionState

JSON-Darstellung 
{
  "kmsKeyVersionName": string
}
Felder
kmsKeyVersionName

string

Erforderlich. Der Name der KMS-Schlüsselversion, mit der die Daten einer Ressource verschlüsselt werden.

TokenStatus

Der Status des Authentifizierungstokens.

Enums
TOKEN_STATUS_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
NOT_FOUND Das Token konnte in Secret Manager nicht gefunden werden oder das Dataform-Dienstkonto hatte keine Berechtigung für den Zugriff darauf.
INVALID Das Token konnte nicht zur Authentifizierung beim Git-Remote verwendet werden.
VALID Das Token wurde erfolgreich zur Authentifizierung beim Git-Remote verwendet.

Tool-Annotationen

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌