인스턴스 만들기 및 관리

이 페이지는 AML AI 인스턴스를 만들고 관리하는 방법을 보여주며 빠른 참조 가이드로 활용될 수 있습니다.

시작하기 전에

인스턴스를 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 금융 서비스 관리자(financialservices.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
암호화 키를 만들고 키 액세스 권한 부여

인스턴스 만들기

일부 API 메서드는 장기 실행 작업(LRO)을 반환합니다. 이러한 메서드는 비동기적이며 작업 객체를 반환합니다. 자세한 내용은 REST 참조를 확인하세요. 메서드가 응답을 반환해도 작업이 완료되지 않았을 수 있습니다. 이러한 메서드의 경우 요청을 전송한 후 결과를 확인하세요. 일반적으로 모든 POST, PUT, UPDATE, DELETE 작업은 장기 실행됩니다.

요청 전송

인스턴스를 만들려면 projects.locations.instances.create 메서드를 사용합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.create

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 키링 및 인스턴스 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: 인스턴스의 사용자 정의 식별자
KMS_PROJECT_ID: 키링이 포함된 프로젝트의 Google Cloud 프로젝트 ID
KEY_RING_ID: 키링의 사용자 정의 식별자
KEY_ID: 키의 사용자 정의 식별자
참고: 인스턴스를 만든 후에는 다른 CMEK 키로 변경할 수 없습니다.

JSON 요청 본문:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

다음과 비슷한 JSON 응답이 표시됩니다.

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

결과 확인

인스턴스가 생성되었는지 확인하려면 projects.locations.operations.get 메서드를 사용합니다. 응답에 "done": false가 포함되어 있으면 응답에 "done": true가 포함될 때까지 명령어를 반복합니다. 이 작업은 완료하는 데 몇 분 정도 걸릴 수 있습니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.operations.get

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
OPERATION_ID: 작업의 식별자

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

다음과 비슷한 JSON 응답이 표시됩니다.

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

인스턴스 가져오기

인스턴스를 가져오려면 projects.locations.instances.get 메서드를 사용합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.get

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: 인스턴스의 사용자 정의 식별자

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

다음과 비슷한 JSON 응답이 표시됩니다.

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

인스턴스 업데이트

인스턴스를 업데이트하려면 projects.locations.instances.patch 메서드를 사용합니다.

인스턴스의 모든 필드를 업데이트할 수 있는 것은 아닙니다. 다음 예시에서는 인스턴스와 연결된 키-값 쌍 사용자 라벨을 업데이트합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.update

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: 인스턴스의 사용자 정의 식별자
KEY: 인스턴스를 구성하는 데 사용되는 키-값 쌍의 키. 자세한 내용은 labels를 참조하세요.
VALUE: 인스턴스를 구성하는 데 사용되는 키-값 쌍의 값. 자세한 내용은 labels를 참조하세요.

JSON 요청 본문:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

다음과 비슷한 JSON 응답이 표시됩니다.

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

장기 실행 작업(LRO)의 결과를 가져오는 방법에 대한 자세한 내용은 결과 확인을 참조하세요.

인스턴스 나열

특정 인스턴스의 인스턴스를 나열하려면 projects.locations.instances.list 메서드를 사용합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.list

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

PowerShell

다음 명령어를 실행합니다.

$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

다음과 비슷한 JSON 응답이 표시됩니다.

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

등록된 당사자 가져오기

등록된 당사자를 가져오려면 먼저 당사자를 등록하려는 비즈니스 라인에 대한 BigQuery 테이블을 준비합니다. 자세한 내용은 고객 등록을 참조하세요. 다음 스키마 중 하나를 사용합니다.

소매업 당사자 스키마

열	유형	설명
`party_id`	`STRING`	인스턴스의 데이터 세트에 있는 당사자의 고유한 식별자
`party_size`	`STRING`	NULL, 소매업 당사자 등록 시 콘텐츠가 무시됨

상업 당사자 스키마

열 유형 설명

party_id STRING 인스턴스의 데이터 세트에 있는 당사자의 고유한 식별자

party_size

STRING

요청한 당사자 크기. 등급은 이전 365일 동안 해당 당사자의 평균 월간 트랜잭션 수를 기준으로 합니다.

월간 평균 트랜잭션 수가 500회 미만인 소규모 상업 당사자의 경우 SMALL
월간 평균 트랜잭션 수가 500회 이상인 대규모 상업 당사자의 경우 LARGE

모든 값은 대소문자를 구분합니다.

등록된 당사자를 가져오려면 projects.locations.instances.importRegisteredParties 메서드를 사용합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.importRegisteredParties

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: 인스턴스의 사용자 정의 식별자
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: 등록된 당사자를 설명하는 테이블이 포함된 BigQuery 데이터 세트
PARTY_REGISTRATION_TABLE: 등록된 당사자를 나열하는 테이블
참고: 등록된 당사자를 나열하는 여러 테이블을 제공할 수 있습니다. partyTables 배열의 각 테이블에 "bq://{project}.{bqDatasetID}.{bqTableID}" 형식을 사용하세요.
UPDATE_MODE: REPLACE를 사용하여 등록된 당사자 테이블에서 삭제 가능한 당사자를 새 당사자로 바꾸거나 APPEND를 사용하여 새 당사자를 등록된 당사자 테이블에 추가합니다.
LINE_OF_BUSINESS: 이 필드는 엔진 구성에서 사용하는 엔진 버전의 lineOfBusiness 값과 일치해야 합니다. 상업 은행 고객(법인 및 자연인)의 경우 COMMERCIAL을 사용하고 소매 금융 고객에는 RETAIL을 사용합니다.

JSON 요청 본문:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

다음과 비슷한 JSON 응답이 표시됩니다.

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

장기 실행 작업(LRO)의 결과를 가져오는 방법에 대한 자세한 내용은 결과 확인을 참조하세요.

LRO가 완료되면 응답에 작업으로 추가, 삭제 또는 업데이트된 당사자 수가 표시됩니다.

응답 필드	유형	설명
`partiesAdded`	`integer`	이 작업으로 추가된 당사자 수
`partiesRemoved`	`integer`	이 작업으로 삭제된 당사자 수
`partiesTotal`	`integer`	업데이트 작업이 완료된 후 이 인스턴스에 등록된 총 당사자 수
`partiesUptiered`	`integer`	소규모에서 대규모로 확대된 총 상업 당사자 수
`partiesDowntiered`	`integer`	대규모에서 소규모로 축소된 총 상업 당사자 수
`partiesFailedToDowntier`	`integer`	대규모에서 소규모로 축소하지 못한 총 상업 당사자 수
`partiesFailedToRemove`	`integer`	이 작업으로 삭제하지 못한 당사자 수

등록된 당사자 내보내기

등록된 당사자를 내보내려면 projects.locations.instances.exportRegisteredParties 메서드를 사용합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.exportRegisteredParties

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: 인스턴스의 사용자 정의 식별자
BQ_OUTPUT_DATASET_NAME: 등록된 당사자를 설명하는 테이블을 내보낼 BigQuery 데이터 세트
PARTY_REGISTRATION_TABLE: 등록된 당사자를 기록할 테이블
WRITE_DISPOSITION: 대상 테이블이 이미 있으면 발생하는 작업으로 다음 값 중 하나를 사용합니다.
- WRITE_EMPTY: BigQuery 테이블이 비어 있는 경우에만 데이터를 내보냅니다.
- WRITE_TRUNCATE: 테이블에 쓰기 전에 BigQuery 테이블에서 기존 데이터를 모두 삭제합니다.
LINE_OF_BUSINESS: 상업 은행 고객(법인 및 자연인)의 경우 COMMERCIAL을 사용하고 소매 금융 고객에는 RETAIL을 사용합니다.

JSON 요청 본문:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

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

그런 후 다음 명령어를 실행하여 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

다음과 비슷한 JSON 응답이 표시됩니다.

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

장기 실행 작업(LRO)의 결과를 가져오는 방법에 대한 자세한 내용은 결과 확인을 참조하세요.

이 메서드는 다음 스키마가 있는 BigQuery 테이블을 출력합니다.

열	유형	설명
`party_id`	`STRING`	인스턴스의 데이터 세트에 있는 당사자의 고유한 식별자
`party_size`	`STRING`	상업 고객(대규모 및 소규모)의 등급을 지정합니다. 이 필드는 소매업 고객에게는 적용되지 않습니다. 모든 소매업 고객의 경우 `NULL` 월간 평균 트랜잭션 수가 500회 미만인 소규모 상업 당사자의 경우 `SMALL` 월간 평균 트랜잭션 수가 500회 이상인 대규모 상업 당사자의 경우 `LARGE` 모든 값은 대소문자를 구분합니다.
`earliest_remove_time`	`STRING`	당사자를 삭제할 수 있는 가장 이른 시간
`party_with_prediction_intent`	`STRING`	당사자가 등록한 이후에 당사자에 대한 예측이 이뤄졌는지를 부여주는 지표
`registration_or_uptier_time`	`STRING`	당사자가 등록되거나 확대된 시간

자세한 내용은 고객 등록을 참조하세요.

인스턴스 삭제

인스턴스를 삭제하려면 projects.locations.instances.delete 메서드를 사용합니다.

이 태스크에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

권한

financialservices.v1instances.delete

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID
LOCATION: 인스턴스의 위치. 지원되는 리전 중 하나를 사용합니다.
위치 표시
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: 인스턴스의 사용자 정의 식별자

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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

다음 명령어를 실행합니다.

$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

다음과 비슷한 JSON 응답이 표시됩니다.

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

장기 실행 작업(LRO)의 결과를 가져오는 방법에 대한 자세한 내용은 결과 확인을 참조하세요.