Der angeforderte Artikel ist nicht verfügbar. Er gilt entweder nicht für diese Version des Produkts oder die relevanten Informationen sind in dieser Version der Dokumentation anders organisiert. Sie können nach ihm suchen oder zur anderen Version zurückgehen.

Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Ändern einer Hook-Quelle

05/23/2026

PDFs

PUT /accounts/{account_id}/core/v1/hookSources/{hookSource_id}

Ersetzt die gesamte gespeicherte Ressource durch den bereitgestellten JSON-Anfragetext, wobei Schlüsselwerte erhalten bleiben, die vom Benutzer nicht geändert werden können.

Nebenwirkungen

Die Aktualisierung eines bestehenden Quell-Hooks wirkt sich unmittelbar auf alle zukünftigen Snapshots von Anwendungen aus, die über entsprechende Ausführungs-Hooks verfügen, welche die aktualisierte Quell-Hook-Ressource verwenden.
Die MD5-Prüfsumme wird anhand des Werts des Feldes „source“ berechnet und als Wert des Feldes „sourceMD5Checksum“ festgelegt.

Parameter

Name	Typ	In	Erforderlich	Beschreibung
Konto-ID	Zeichenkette	Pfad	True	ID der übergeordneten Kontoressource Beispiel: {{.Account}}
hookSource_id	Zeichenkette	Pfad	True	ID der hookSource Sammlung, die aufgelistet werden soll

Name

Typ

Erforderlich

Beschreibung

Konto-ID

Zeichenkette

Pfad

True

ID der übergeordneten Kontoressource

Beispiel: {{.Account}}

hookSource_id

Zeichenkette

Pfad

True

ID der hookSource Sammlung, die aufgelistet werden soll

Anfragetext

Ersetzt die gesamte gespeicherte Ressource durch den bereitgestellten JSON-Anfragetext, wobei Schlüsselwerte erhalten bleiben, die vom Benutzer nicht geändert werden können.

Nebenwirkungen

Die Aktualisierung eines bestehenden Quell-Hooks wirkt sich unmittelbar auf alle zukünftigen Snapshots von Anwendungen aus, die über entsprechende Ausführungs-Hooks verfügen, welche die aktualisierte Quell-Hook-Ressource verwenden.
Die MD5-Prüfsumme wird anhand des Werts des Feldes „source“ berechnet und als Wert des Feldes „sourceMD5Checksum“ festgelegt.

Name	Typ	Erforderlich	Beschreibung
Typ	Zeichenkette	True	Medientyp der Ressource. Definierte Werte sind: "application/astra-hookSource"
Version	Zeichenkette	True	Version der Ressource. Definierte Werte sind: "1,0"
id	Zeichenkette	Falsch	Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind: Entspricht dem UUIDv4-Schema
Name	Zeichenkette	Falsch	JSON-Zeichenkette mit einem benutzerdefinierten Namen für die Ressource. Definierte Werte sind: Mindestlänge: 1 Maximale Länge: 63 Der Name muss innerhalb aller Hook-Quellressourcen eindeutig sein.
Privat	Zeichenkette	Falsch	JSON-Zeichenkette, die angibt, ob das Quellfeld in APIs verfügbar gemacht oder absichtlich leer gelassen wird. Folgende Werte sind definiert: "true" - Der Quellwert ist privat und wird nicht über die API offengelegt. "false" - Der Quellwert ist nicht privat und wird über die API offengelegt.
vorinstalliert	Zeichenkette	Falsch	JSON-Zeichenkette, die angibt, ob die Quelle vorgeladen wurde. Definierte Werte sind: "true" - Die Quelle wurde vorgeladen. "false" - Die Quelle wurde nicht vorgeladen. Vorgeladene Hook-Quellressourcen sind schreibgeschützt.
sourceType	Zeichenkette	Falsch	JSON-Zeichenkette, die den Hook-Quelltyp definiert. Definierte Werte sind: „Skript“ – Shell-Skript. Der Klartextquelltext darf keine Binärdaten oder Wagenrücklaufzeichen enthalten, andernfalls wird ein Fehler zurückgegeben.
Quelle	Zeichenkette	Falsch	JSON-Zeichenkette mit dem auszuführenden Skript im Base64-Format. Definierte Werte sind: Mindestlänge: 0 Maximale Länge: 131072 Entspricht dem Base64-kodierten Datenschema. Die maximale Größe eines Quellwerts beträgt 128 KiB bei der Base64-Kodierung.
sourceMD5Checksum	Zeichenkette	Falsch	JSON-Zeichenkette mit der MD5-Prüfsumme des Werts des Schlüssels „source“. Definierte Werte sind: Der definierte reguläre Ausdruck lautet: "^([0-9a-fA-F]){32}$"
description	Zeichenkette	Falsch	JSON-Zeichenkette mit einer benutzerdefinierten Beschreibung der Hook-Quelle. Definierte Werte sind: Mindestlänge: 0 Maximale Länge: 511
Metadaten	"type_astra_metadata_update"	Falsch	Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind: Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

True

Medientyp der Ressource. Definierte Werte sind:

"application/astra-hookSource"

Version

Zeichenkette

True

Version der Ressource. Definierte Werte sind:

"1,0"

Zeichenkette

Falsch

Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind:

Entspricht dem UUIDv4-Schema

Name

Zeichenkette

Falsch

JSON-Zeichenkette mit einem benutzerdefinierten Namen für die Ressource. Definierte Werte sind:

Mindestlänge: 1
Maximale Länge: 63 Der Name muss innerhalb aller Hook-Quellressourcen eindeutig sein.

Privat

Zeichenkette

Falsch

JSON-Zeichenkette, die angibt, ob das Quellfeld in APIs verfügbar gemacht oder absichtlich leer gelassen wird. Folgende Werte sind definiert:

"true" - Der Quellwert ist privat und wird nicht über die API offengelegt.
"false" - Der Quellwert ist nicht privat und wird über die API offengelegt.

vorinstalliert

Zeichenkette

Falsch

JSON-Zeichenkette, die angibt, ob die Quelle vorgeladen wurde. Definierte Werte sind:

"true" - Die Quelle wurde vorgeladen.
"false" - Die Quelle wurde nicht vorgeladen. Vorgeladene Hook-Quellressourcen sind schreibgeschützt.

sourceType

Zeichenkette

Falsch

JSON-Zeichenkette, die den Hook-Quelltyp definiert. Definierte Werte sind:

„Skript“ – Shell-Skript. Der Klartextquelltext darf keine Binärdaten oder Wagenrücklaufzeichen enthalten, andernfalls wird ein Fehler zurückgegeben.

Quelle

Zeichenkette

Falsch

JSON-Zeichenkette mit dem auszuführenden Skript im Base64-Format. Definierte Werte sind:

Mindestlänge: 0
Maximale Länge: 131072
Entspricht dem Base64-kodierten Datenschema. Die maximale Größe eines Quellwerts beträgt 128 KiB bei der Base64-Kodierung.

sourceMD5Checksum

Zeichenkette

Falsch

JSON-Zeichenkette mit der MD5-Prüfsumme des Werts des Schlüssels „source“. Definierte Werte sind:

Der definierte reguläre Ausdruck lautet: "^([0-9a-fA-F]){32}$"

description

Zeichenkette

Falsch

JSON-Zeichenkette mit einer benutzerdefinierten Beschreibung der Hook-Quelle. Definierte Werte sind:

Mindestlänge: 0
Maximale Länge: 511

Metadaten

"type_astra_metadata_update"

Falsch

Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind:

Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Beispielanfrage

{
  "type": "application/astra-hookSource",
  "version": "1.0",
  "source": "ZWNobyAiVkhKaGJuTWdVbWxuYUhSeklRPT0iIHwgYmFzZTY0IC1k",
  "description": "Pre and post hook script for order processing v2"
}

Antwort

Status: 204, Indicates if the hookSource resource was updated.

Antwort

Status: 401, Unauthorized

Name	Typ	Erforderlich
Typ	Zeichenkette	True
Titel	Zeichenkette	True
Detail	Zeichenkette	True
Status	Zeichenkette	True
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

Korrelations-ID

Zeichenkette

Falsch

Beispielantwort

{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Antwort

Status: 400, Bad request

Name	Typ	Erforderlich	Beschreibung
Typ	Zeichenkette	True
Titel	Zeichenkette	True
Detail	Zeichenkette	True
Status	Zeichenkette	True
Korrelations-ID	Zeichenkette	Falsch
invalidFields	Array["invalidFields"]	Falsch	Liste ungültiger Anfragetextfelder

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

Korrelations-ID

Zeichenkette

Falsch

invalidFields

Array["invalidFields"]

Falsch

Liste ungültiger Anfragetextfelder

Beispielantwort

{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Antwort

Status: 409, Conflict

Name	Typ	Erforderlich	Beschreibung
Typ	Zeichenkette	True
Titel	Zeichenkette	True
Detail	Zeichenkette	True
Status	Zeichenkette	True
Korrelations-ID	Zeichenkette	Falsch
invalidFields	Array["invalidFields"]	Falsch	Liste ungültiger Anfragetextfelder

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

Korrelations-ID

Zeichenkette

Falsch

invalidFields

Array["invalidFields"]

Falsch

Liste ungültiger Anfragetextfelder

Beispielantwort

{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Antwort

Status: 403, Forbidden

Name	Typ	Erforderlich
Typ	Zeichenkette	True
Titel	Zeichenkette	True
Detail	Zeichenkette	True
Status	Zeichenkette	True
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

Korrelations-ID

Zeichenkette

Falsch

Beispielantwort

{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Fehler

Status: 404, Not found

Name	Typ	Erforderlich
Typ	Zeichenkette	True
Titel	Zeichenkette	True
Detail	Zeichenkette	True
Status	Zeichenkette	True
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

Korrelations-ID

Zeichenkette

Falsch

Beispiel-Fehlermeldung

{
  "type": "https://astra.netapp.io/problems/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

Definitionen

Siehe Definitionen

Typ_Astra_Label

Name	Typ	Erforderlich	Beschreibung
Name	Zeichenkette	True
Wert	Zeichenkette	True

Name

Typ

Erforderlich

Beschreibung

Name

Zeichenkette

True

Wert

Zeichenkette

True

type_astra_metadata_update

Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind:

Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Name	Typ	Erforderlich
Etiketten	Array["Typ_Astra_Label"]	Falsch
CreationZeitstempel	Zeichenkette	Falsch
Änderungszeitstempel	Zeichenkette	Falsch
Erstellt von	Zeichenkette	Falsch
modifiedBy	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Etiketten

Array["Typ_Astra_Label"]

Falsch

CreationZeitstempel

Zeichenkette

Falsch

Änderungszeitstempel

Zeichenkette

Falsch

Erstellt von

Zeichenkette

Falsch

modifiedBy

Zeichenkette

Falsch

invalidParams

Name	Typ	Erforderlich	Beschreibung
Name	Zeichenkette	True	Name des ungültigen Abfrageparameters
Grund	Zeichenkette	True	Grund, warum der Abfrageparameter ungültig ist

Name

Typ

Erforderlich

Beschreibung

Name

Zeichenkette

True

Name des ungültigen Abfrageparameters

Grund

Zeichenkette

True

Grund, warum der Abfrageparameter ungültig ist

invalidFields

Name	Typ	Erforderlich	Beschreibung
Name	Zeichenkette	True	Name des ungültigen Anfragetextfelds
Grund	Zeichenkette	True	Grund, warum das Anfragekörperfeld ungültig ist

Name

Typ

Erforderlich

Beschreibung

Name

Zeichenkette

True

Name des ungültigen Anfragetextfelds

Grund

Zeichenkette

True

Grund, warum das Anfragekörperfeld ungültig ist

Ändern einer Hook-Quelle

Creating your file...

Parameter

Anfragetext

Antwort

Antwort

Antwort

Antwort

Antwort

Fehler

Definitionen