Esta página se ha traducido con Cloud Translation API.

Crear y gestionar instancias

En esta página se explica cómo crear y gestionar instancias de IA de AML, y se puede usar como guía de referencia rápida.

Antes de empezar

Para obtener los permisos que necesitas para crear y gestionar instancias, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de servicios financieros (financialservices.admin) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Crea una clave de cifrado y concede acceso a ella

Crear una instancia

Algunos métodos de la API devuelven una operación de larga duración (LRO). Estos métodos son asíncronos y devuelven un objeto Operation. Para obtener más información, consulta la referencia de REST. Es posible que la operación no se haya completado cuando el método devuelva una respuesta. Para usar estos métodos, envía la solicitud y, a continuación, comprueba el resultado. En general, todas las operaciones POST, PUT, UPDATE y DELETE son de larga duración.

Enviar la solicitud

Para crear una instancia, usa el método projects.locations.instances.create.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.create

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación del conjunto de claves y de la instancia. Usa una de las regiones admitidas.
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: identificador definido por el usuario de la instancia
KMS_PROJECT_ID: el ID del proyecto que contiene el conjunto de claves. Google Cloud
KEY_RING_ID: identificador definido por el usuario del conjunto de claves
KEY_ID: identificador definido por el usuario de la clave.
Nota: No puedes cambiar a otra clave CMEK después de crear la instancia.

Cuerpo JSON de la solicitud:

{
  "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID"
}
EOF

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

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

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

@'
{
  "kmsKey": "projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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
}

Comprobar el resultado

Usa el método projects.locations.operations.get para comprobar si se ha creado la instancia. Si la respuesta contiene "done": false, repite el comando hasta que la respuesta contenga "done": true. Esta operación puede tardar unos minutos.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.operations.get

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la sección Configuración de gestión de identidades y accesos.
LOCATION: la ubicación de la instancia. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
OPERATION_ID: el identificador de la operación

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el comando siguiente:

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

Ejecuta el comando siguiente:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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"
  }
}

Obtener una instancia

Para obtener una instancia, utiliza el método projects.locations.instances.get.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.get

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación de la instancia. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: identificador definido por el usuario de la instancia

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el comando siguiente:

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

Ejecuta el comando siguiente:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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"
}

Actualizar una instancia

Para actualizar una instancia, usa el método projects.locations.instances.patch.

No se pueden actualizar todos los campos de una instancia. En el siguiente ejemplo se actualiza el par clave-valor etiquetas de usuario asociado a la instancia.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.update

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación de la instancia. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: identificador definido por el usuario de la instancia
KEY: la clave de un par clave-valor que se usa para organizar instancias. Consulta más información en labels.
VALUE: valor de un par clave-valor que se usa para organizar instancias. Consulta más información en labels.

Cuerpo JSON de la solicitud:

{
  "labels": {
    "KEY": "VALUE"
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "labels": {
    "KEY": "VALUE"
  }
}
EOF

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

@'
{
  "labels": {
    "KEY": "VALUE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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
}

Para obtener más información sobre cómo obtener el resultado de la operación de larga duración, consulta Comprobar el resultado.

Mostrar las instancias

Para enumerar las instancias de una instancia determinada, usa el método projects.locations.instances.list.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.list

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación de las instancias. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el comando siguiente:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances"

PowerShell

Ejecuta el comando siguiente:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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"
    }
  ]
}

Importar terceros registrados

Para importar las partes registradas, primero debe preparar una tabla de BigQuery para la línea de negocio en la que quiera registrar las partes. Para obtener más información, consulta Registrar clientes. Usa uno de los siguientes esquemas:

Esquema de participantes de Retail

Columna	Tipo	Descripción
`party_id`	`STRING`	Identificador único de la parte en los conjuntos de datos de la instancia.
`party_size`	`STRING`	NULL; el contenido se ignora en los registros de terceros

Esquema de partes comerciales

Columna Tipo Descripción

party_id STRING Identificador único de la parte en los conjuntos de datos de la instancia.

party_size

STRING

Tamaño del grupo solicitado. El nivel se basa en el número medio de transacciones mensuales de la parte durante los 365 días anteriores:

SMALL para pequeñas empresas comerciales con menos de 500 transacciones mensuales de media
LARGE para grandes empresas comerciales con una media mensual de 500 transacciones o más

Todos los valores distinguen entre mayúsculas y minúsculas.

Para importar terceros registrados, utiliza el método projects.locations.instances.importRegisteredParties.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.importRegisteredParties

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación de la instancia. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: identificador definido por el usuario de la instancia
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: a Conjunto de datos de BigQuery que contiene una tabla que describe las partes registradas.
PARTY_REGISTRATION_TABLE: la tabla que enumera las partes registradas
Nota: Puede proporcionar varias tablas que enumeren las partes registradas. Usa el formato "bq://{project}.{bqDatasetID}.{bqTableID}" para cada tabla de la matriz partyTables.
UPDATE_MODE: usa REPLACE para sustituir las partes que se pueden quitar de la tabla de partes registradas por partes nuevas o usa APPEND para añadir partes nuevas a la tabla de partes registradas.
LINE_OF_BUSINESS: este campo debe coincidir con el valor de lineOfBusiness en la versión del motor que usa la configuración del motor. Usa COMMERCIAL para los clientes de banca comercial (entidades jurídicas y físicas) o RETAIL para los clientes de banca minorista.

Cuerpo JSON de la solicitud:

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

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

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

@'
{
  "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

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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
}

Para obtener más información sobre cómo obtener el resultado de la operación de larga duración, consulta Comprobar el resultado.

Cuando se completa la operación LRO, la respuesta indica el número de participantes que se han añadido, eliminado o actualizado.

Campo de respuesta	Tipo	Descripción
`partiesAdded`	`integer`	Número de participantes añadidos por esta operación.
`partiesRemoved`	`integer`	Número de participantes eliminados por esta operación.
`partiesTotal`	`integer`	Número total de participantes registrados en esta instancia después de que se haya completado la operación de actualización.
`partiesUptiered`	`integer`	Número total de partes comerciales que han pasado de pequeñas a grandes
`partiesDowntiered`	`integer`	Número total de partes comerciales que han pasado de grandes a pequeñas
`partiesFailedToDowntier`	`integer`	Número total de terceros comerciales que no han podido cambiar de un nivel grande a uno pequeño
`partiesFailedToRemove`	`integer`	Número de participantes que no se han podido quitar con esta operación.

Exportar participantes registrados

Para exportar las partes registradas, utiliza el método projects.locations.instances.exportRegisteredParties.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.exportRegisteredParties

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación de la instancia. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: identificador definido por el usuario de la instancia
BQ_OUTPUT_DATASET_NAME: a Conjunto de datos de BigQuery en el que se exportará una tabla que describa las partes registradas.
PARTY_REGISTRATION_TABLE: la tabla en la que se escribirán las partes registradas.
WRITE_DISPOSITION: la acción que se lleva a cabo si la tabla de destino ya existe. Usa uno de los siguientes valores:
- WRITE_EMPTY: solo exporta datos si la tabla de BigQuery está vacía.
- WRITE_TRUNCATE: borra todos los datos de la tabla de BigQuery antes de escribir en ella.
LINE_OF_BUSINESS: usa COMMERCIAL para clientes de banca comercial (entidades jurídicas y físicas) o RETAIL para clientes de banca minorista.

Cuerpo JSON de la solicitud:

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

@'
{
  "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

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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
}

Para obtener más información sobre cómo obtener el resultado de la operación de larga duración, consulta Comprobar el resultado.

Este método genera una tabla de BigQuery con el siguiente esquema:

Columna	Tipo	Descripción
`party_id`	`STRING`	Identificador único de la parte en los conjuntos de datos de la instancia.
`party_size`	`STRING`	Especifica el nivel de los clientes comerciales (grandes o pequeños). Este campo no se aplica a los clientes minoristas. `NULL` para todos los clientes minoristas `SMALL` para pequeñas empresas comerciales con menos de 500 transacciones mensuales de media `LARGE` para grandes empresas comerciales con una media mensual de 500 transacciones o más Todos los valores distinguen entre mayúsculas y minúsculas.
`earliest_remove_time`	`STRING`	La hora más temprana a la que se puede eliminar la parte
`party_with_prediction_intent`	`STRING`	El indicador que sugiere si se ha predicho un partido desde el registro
`registration_or_uptier_time`	`STRING`	La hora a la que se registró o se cambió de nivel el partido

Para obtener más información, consulta Registrar clientes.

Eliminar una instancia

Para eliminar una instancia, utiliza el método projects.locations.instances.delete.

Permisos que se necesitan para completar esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

Permisos

financialservices.v1instances.delete

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID de tu proyecto Google Cloud aparece en la configuración de gestión de identidades y accesos.
LOCATION: la ubicación de la instancia. Usa una de las regiones admitidas
Mostrar ubicaciones
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
- australia-southeast1
INSTANCE_ID: identificador definido por el usuario de la instancia

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el comando siguiente:

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

Ejecuta el comando siguiente:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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
}

Para obtener más información sobre cómo obtener el resultado de la operación de larga duración, consulta Comprobar el resultado.

Crear y gestionar instancias Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

Crear una instancia

Enviar la solicitud

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Comprobar el resultado

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Obtener una instancia

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Actualizar una instancia

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Mostrar las instancias

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Importar terceros registrados

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Exportar participantes registrados

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Eliminar una instancia

Permisos que se necesitan para completar esta tarea

curl

PowerShell

Crear y gestionar instancias