Auf dieser Seite wird beschrieben, wie Sie AML AI-Instanzen erstellen und verwalten. und kann als Kurzanleitung verwendet werden.
Hinweise
-
Um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Instanzen benötigen, bitten Sie Ihren Administrator, Ihnen Administrator für Finanzdienstleistungen (
financialservices.admin
) IAM-Rolle für Ihr Projekt Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
- Verschlüsselungsschlüssel erstellen und Zugriff auf den Schlüssel gewähren
Instanz erstellen
Einige API-Methoden geben einen Fehler zurück: lang andauernden Vorgang ausführen. Diese Methoden sind asynchron und geben ein Vorgangsobjekt zurück. finden Sie unter REST-Referenz Die ist möglicherweise nicht abgeschlossen, wenn die Methode eine Antwort zurückgibt. Senden Sie für diese Methoden den und prüfen Sie dann das Ergebnis. Im Allgemeinen sind alle POST-, PUT-, UPDATE- und DELETE-Vorgänge langfristig anstreben.
Anfrage senden
Verwenden Sie zum Erstellen einer Instanz den
projects.locations.instances.create
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: der Speicherort des Schlüsselbunds und die Instanz. verwenden Sie eine der unterstützte RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: eine benutzerdefinierte Kennung für die InstanzKMS_PROJECT_ID
: das Google Cloud-Projekt ID für das Projekt, das den Schlüsselbund enthältKEY_RING_ID
: die benutzerdefinierte Kennung für den SchlüsselbundKEY_ID
: die benutzerdefinierte Kennung für den Schlüssel
JSON-Text der Anfrage:
{ "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID" } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?instance_id=INSTANCE_ID"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID" } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?instance_id=INSTANCE_ID" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": "2023-03-14T15:52:55.358979323Z", "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Ergebnis prüfen
Verwenden Sie die Methode
projects.locations.operations.get
, um zu prüfen, ob die Instanz erstellt wurde. Wenn die Antwort Folgendes enthält:
"done": false
, wiederholen Sie den Befehl, bis die Antwort "done": true
enthält.
Dieser Vorgang kann einige Minuten dauern.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID. in den IAM-EinstellungenLOCATION
: Der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
OPERATION_ID
: die Kennung für den Vorgang
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": "2023-03-14T15:52:55.358979323Z", "endTime": "2023-03-14T16:52:55.358979323Z", "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.Instance", "name": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "state": "ACTIVE", "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID" } }
Instanz abrufen
Verwenden Sie zum Abrufen einer Instanz den
projects.locations.instances.get
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: Der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: die benutzerdefinierte Kennung für die Instanz
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "createTime": "2023-03-14T15:52:55.358979323Z", "updateTime": "2023-03-15T15:52:55.358979323Z", "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID", "state": "ACTIVE" }
Instanz aktualisieren
Verwenden Sie zum Aktualisieren einer Instanz die Methode
projects.locations.instances.patch
.
Nicht alle Felder in einer Instanz können aktualisiert werden. Im folgenden Beispiel wird die Schlüssel/Wert-Paar Nutzerlabels die mit der Instanz verknüpft sind.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: Der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: die benutzerdefinierte Kennung für die InstanzKEY
: Der Schlüssel in einem Schlüssel/Wert-Paar, das zum Organisieren verwendet wird. Instanzen. Weitere Informationen finden Sie unterlabels
.VALUE
: Der Wert in einem Schlüssel/Wert-Paar, das zum Organisieren verwendet wird. Instanzen. Weitere Informationen finden Sie unterlabels
.
JSON-Text der Anfrage:
{ "labels": { "KEY": "VALUE" } }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "labels": { "KEY": "VALUE" } } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=labels"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "labels": { "KEY": "VALUE" } } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=labels" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": "2023-03-14T15:52:55.358979323Z", "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Weitere Informationen zum Abrufen des Ergebnisses eines Vorgangs mit langer Ausführungszeit finden Sie unter Prüfen Sie das Ergebnis.
Instanzen auflisten
Um die Instanzen für eine bestimmte Instanz aufzulisten, verwenden Sie die Methode
projects.locations.instances.list
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: durch den Standort der Instanzen; eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "instances": [ { "name": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "createTime": "2023-03-14T15:52:55.358979323Z", "updateTime": "2023-03-15T15:52:55.358979323Z", "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID", "state": "ACTIVE" } ] }
Registrierte Parteien importieren
Bereiten Sie zum Importieren registrierter Parteien zuerst eine BigQuery-Tabelle für den Geschäftsbereich, für den Sie Parteien registrieren möchten. Weitere Informationen finden Sie unter Registrieren Sie Ihre Kunden. Verwenden Sie eines der folgenden Schemas:
Schema für Einzelhändler
Spalte Typ Beschreibung party_id
STRING
Eindeutige Kennung der Partei in den Datasets der Instanz party_size
STRING
NULL; Der Inhalt wird bei Registrierungen von Einzelhandelsunternehmen ignoriert. Schema für kommerzielle Parteien
Spalte Typ Beschreibung party_id
STRING
Eindeutige Kennung der Partei in den Datasets der Instanz party_size
STRING
Angeforderte Gruppengröße. Die Stufe basiert auf der durchschnittlichen Anzahl monatlicher Transaktionen für der Partei in den letzten 365 Tagen: <ph type="x-smartling-placeholder"> - </ph>
SMALL
für kleine kommerzielle Partys mit weniger als 500 monatlichen TransaktionenLARGE
für große kommerzielle Unternehmen mit mindestens 500 monatlichen Transaktionen
Bei allen Werten wird die Groß- und Kleinschreibung berücksichtigt.
Verwenden Sie zum Importieren registrierter Parteien die
projects.locations.instances.importRegisteredParties
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: Der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: die benutzerdefinierte Kennung für die InstanzBQ_INPUT_REGISTERED_PARTIES_DATASET_NAME
: a BigQuery-Dataset, das eine Tabelle enthält, in der die registrierten Parteien beschrieben werdenPARTY_REGISTRATION_TABLE
: die Tabelle, die eine Liste der registrierten ParteienUPDATE_MODE
: Verwenden SieREPLACE
, um Parteien zu ersetzen, die können in der Tabelle der registrierten Parteien mit neuen Parteien entfernt werden oder verwenden SieAPPEND
, um neue Parteien zum Tabelle „Registrierte Parteien“LINE_OF_BUSINESS
: Dieses Feld muss mit demlineOfBusiness
-Wert im Engine-Version verwendet von engine config;COMMERCIAL
für Geschäftskunden (rechtliche und natürliche Rechtssubjekte) oderRETAIL
für Privatkundenbanken
JSON-Text der Anfrage:
{ "partyTables": [ "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE" ], "mode": "UPDATE_MODE", "lineOfBusiness": "LINE_OF_BUSINESS" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "partyTables": [ "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE" ], "mode": "UPDATE_MODE", "lineOfBusiness": "LINE_OF_BUSINESS" } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "partyTables": [ "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE" ], "mode": "UPDATE_MODE", "lineOfBusiness": "LINE_OF_BUSINESS" } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": "2023-03-14T15:52:55.358979323Z", "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "verb": "importRegisteredParties", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Weitere Informationen zum Abrufen des Ergebnisses eines Vorgangs mit langer Ausführungszeit finden Sie unter Prüfen Sie das Ergebnis.
Wenn der LRO abgeschlossen ist, gibt die Antwort die Anzahl der Parteien an, hinzugefügt, entfernt oder aktualisiert wurden.
Antwortfeld | Typ | Beschreibung |
---|---|---|
partiesAdded | integer |
Anzahl der durch diesen Vorgang hinzugefügten Parteien |
partiesRemoved | integer |
Anzahl der Personen, die durch diesen Vorgang entfernt wurden |
partiesTotal | integer |
Gesamtzahl der Parteien, die in dieser Instanz registriert sind, nachdem der Aktualisierungsvorgang abgeschlossen wurde abgeschlossen |
partiesUptiered | integer |
Gesamtzahl der kommerziellen Parteien, die von klein zu groß hochgestuft wurde |
partiesDowntiered | integer |
Gesamtzahl der kommerziellen Parteien, die von groß auf klein reduziert sind |
partiesFailedToDowntier | integer |
Gesamtzahl der kommerziellen Parteien, die nicht von groß auf klein heruntergestuft werden konnten |
partiesFailedToRemove | integer |
Anzahl der Parteien, die bei diesem Vorgang nicht entfernt werden konnten |
Registrierte Parteien exportieren
Exportieren Sie registrierte Parteien mit dem
projects.locations.instances.exportRegisteredParties
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: Der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: die benutzerdefinierte Kennung für die InstanzBQ_OUTPUT_DATASET_NAME
: a BigQuery-Dataset, in das eine Tabelle exportiert werden soll, die die registrierten Parteien beschreibtPARTY_REGISTRATION_TABLE
: die Tabelle für die registrierten Parteien anWRITE_DISPOSITION
: die erfolgte Aktion wenn die Zieltabelle bereits vorhanden ist; Verwenden Sie einen der folgenden Werte:-
WRITE_EMPTY
: Nur Daten exportieren, wenn die Zieltabelle leer ist. -
WRITE_TRUNCATE
: Alle vorhandenen Daten in der BigQuery-Tabelle löschen bevor Sie in die Tabelle schreiben.
-
LINE_OF_BUSINESS
:COMMERCIAL
verwenden für Kunden von gewerblichen Banken (rechtliche und natürliche Rechtssubjekte) oderRETAIL
für Privatkundenkonten verwenden Kunden
JSON-Text der Anfrage:
{ "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "dataset": { "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE", "writeDisposition": "WRITE_DISPOSITION" }, "lineOfBusiness": "LINE_OF_BUSINESS" } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": "2023-03-14T15:52:55.358979323Z", "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "verb": "exportRegisteredParties", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Weitere Informationen zum Abrufen des Ergebnisses eines Vorgangs mit langer Ausführungszeit finden Sie unter Prüfen Sie das Ergebnis.
Mit dieser Methode wird eine BigQuery-Tabelle mit dem folgenden Schema ausgegeben:
Spalte | Typ | Beschreibung |
---|---|---|
party_id | STRING | Eindeutige Kennung der Partei in den Datasets der Instanz |
party_size | STRING |
Gibt die Stufe für kommerzielle Kunden an (groß oder klein). Dieses Feld gilt nicht
für Einzelhandelskunden.
Bei allen Werten wird die Groß- und Kleinschreibung berücksichtigt. |
earliest_remove_time | STRING | Wann die Partei frühestens entfernt werden kann |
party_with_prediction_intent | STRING | Indikator, der darauf hinweist, ob eine Partei seit der Registrierung vorhergesagt wurde |
registration_or_uptier_time | STRING | Der Zeitpunkt, zu dem die Partei registriert oder hochgestuft wurde |
Weitere Informationen finden Sie unter Registrieren Sie Ihre Kunden.
Instanz löschen
Verwenden Sie zum Löschen einer Instanz den
projects.locations.instances.delete
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt istLOCATION
: Der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten RegionenStandorte anzeigenus-central1
us-east1
asia-south1
europe-west1
europe-west2
europe-west4
northamerica-northeast1
southamerica-east1
INSTANCE_ID
: die benutzerdefinierte Kennung für die Instanz
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata", "createTime": "2023-03-14T15:52:55.358979323Z", "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID", "verb": "delete", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Weitere Informationen zum Abrufen des Ergebnisses eines Vorgangs mit langer Ausführungszeit finden Sie unter Prüfen Sie das Ergebnis.