Pub/Sub 소스(Beta)

개요

Pub/Sub Sources API 엔드포인트는 Panther 버전 1.121부터 오픈 베타로 제공되며, 모든 고객이 사용할 수 있습니다. 버그 보고와 기능 요청은 Panther 지원 팀에 공유해 주세요.

다음 API 작업을 사용하여 상호 작용하세요 Pub/Sub Sources Panther에서.

필수 권한

• 에 대해 GET 작업을 수행하려면 API 토큰에 다음 권한이 있어야 합니다. 로그 소스 보기 권한.

• 에 대해 POST, PUT및 DELETE 작업을 수행하려면 API 토큰에 다음 권한이 있어야 합니다. 로그 소스 관리 권한.

작업

put pub/sub source

put

put updates a pubsub source

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Path parameters

idstringRequired

ID of the pubsub source to update

Body

application/json

credentialsstringOptional

The GCP credentials JSON content (service account key or WIF config). Required on create, optional on update.

credentialsTypestring · enumRequired

The type of credentials being used: service_account or wif (Workload Identity Federation).

Possible values:

integrationLabelstringRequired

The integration label (name)

logStreamTypestring · enumRequired

The log stream type. Supported log stream types: Auto, JSON, JsonArray, Lines, XML

Possible values:

logTypesstring[]Required

The log types for parsing ingested data

projectIdstringOptional

The GCP project ID. Optional for service_account credentials (derived from the keyfile). Required for WIF.

regionalEndpointstringOptional

Optional regional endpoint override (e.g. europe-west3). If not set, the global endpoint is used.

subscriptionIdstringRequired

The GCP Pub/Sub subscription ID

Responses

200

OK response.

application/json

400

bad_request: Bad Request response.

application/json

404

not_found: Not Found response.

application/json

409

exists: Conflict response.

application/json

500

service: Internal Server Error response.

application/json

put

/log-sources/pubsub/{id}

HTTPcURLJavaScriptPython

PUT /log-sources/pubsub/{id} HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 277

{
  "credentials": "text",
  "credentialsType": "service_account",
  "integrationLabel": "text",
  "logStreamType": "Auto",
  "logStreamTypeOptions": {
    "jsonArrayEnvelopeField": "text",
    "xmlRootElement": "text"
  },
  "logTypes": [
    "text"
  ],
  "projectId": "text",
  "regionalEndpoint": "text",
  "subscriptionId": "text"
}

{
  "credentials": "text",
  "credentialsType": "service_account",
  "integrationId": "text",
  "integrationLabel": "text",
  "logStreamType": "Auto",
  "logStreamTypeOptions": {
    "jsonArrayEnvelopeField": "text",
    "xmlRootElement": "text"
  },
  "logTypes": [
    "text"
  ],
  "projectId": "text",
  "regionalEndpoint": "text",
  "subscriptionId": "text"
}

create pub/sub source

post

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Body

application/json

credentialsstringOptional

The GCP credentials JSON content (service account key or WIF config). Required on create, optional on update.

credentialsTypestring · enumRequired

The type of credentials being used: service_account or wif (Workload Identity Federation).

Possible values:

integrationLabelstringRequired

The integration label (name)

logStreamTypestring · enumRequired

The log stream type. Supported log stream types: Auto, JSON, JsonArray, Lines, XML

Possible values:

logTypesstring[]Required

The log types for parsing ingested data

projectIdstringOptional

The GCP project ID. Optional for service_account credentials (derived from the keyfile). Required for WIF.

regionalEndpointstringOptional

Optional regional endpoint override (e.g. europe-west3). If not set, the global endpoint is used.

subscriptionIdstringRequired

The GCP Pub/Sub subscription ID

Responses

201

Created response.

application/json

credentialsstringOptional

The GCP credentials JSON content (service account key or WIF config). Required on create, optional on update.

credentialsTypestring · enumOptional

The type of credentials being used: service_account or wif (Workload Identity Federation).

Possible values:

integrationIdstringOptional

The id of the pubsub source

integrationLabelstringOptional

The integration label (name)

logStreamTypestring · enumOptional

The log stream type. Supported log stream types: Auto, JSON, JsonArray, Lines, XML

Possible values:

logTypesstring[]Optional

The log types for parsing ingested data

projectIdstringOptional

The GCP project ID. Optional for service_account credentials (derived from the keyfile). Required for WIF.

regionalEndpointstringOptional

Optional regional endpoint override (e.g. europe-west3). If not set, the global endpoint is used.

subscriptionIdstringOptional

The GCP Pub/Sub subscription ID

400

bad_request: Bad Request response.

application/json

409

exists: Conflict response.

application/json

500

service: Internal Server Error response.

application/json

post

/log-sources/pubsub

HTTPcURLJavaScriptPython

POST /log-sources/pubsub HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 277

{
  "credentials": "text",
  "credentialsType": "service_account",
  "integrationLabel": "text",
  "logStreamType": "Auto",
  "logStreamTypeOptions": {
    "jsonArrayEnvelopeField": "text",
    "xmlRootElement": "text"
  },
  "logTypes": [
    "text"
  ],
  "projectId": "text",
  "regionalEndpoint": "text",
  "subscriptionId": "text"
}

{
  "credentials": "text",
  "credentialsType": "service_account",
  "integrationId": "text",
  "integrationLabel": "text",
  "logStreamType": "Auto",
  "logStreamTypeOptions": {
    "jsonArrayEnvelopeField": "text",
    "xmlRootElement": "text"
  },
  "logTypes": [
    "text"
  ],
  "projectId": "text",
  "regionalEndpoint": "text",
  "subscriptionId": "text"
}

get pub/sub source

get

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Path parameters

idstringRequired

ID of the pubsub source to fetch

Responses

200

OK response.

application/json

400

bad_request: Bad Request response.

application/json

404

not_found: Not Found response.

application/json

500

service: Internal Server Error response.

application/json

get

/log-sources/pubsub/{id}

HTTPcURLJavaScriptPython

GET /log-sources/pubsub/{id} HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "credentials": "text",
  "credentialsType": "service_account",
  "integrationId": "text",
  "integrationLabel": "text",
  "logStreamType": "Auto",
  "logStreamTypeOptions": {
    "jsonArrayEnvelopeField": "text",
    "xmlRootElement": "text"
  },
  "logTypes": [
    "text"
  ],
  "projectId": "text",
  "regionalEndpoint": "text",
  "subscriptionId": "text"
}

delete pub/sub source

delete

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Path parameters

idstringRequired

ID of the pubsub source to delete

Responses

204

No Content response.

400

bad_request: Bad Request response.

application/json

500

service: Internal Server Error response.

application/json

delete

/log-sources/pubsub/{id}

HTTPcURLJavaScriptPython

DELETE /log-sources/pubsub/{id} HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Accept: */*

No content