AWS solutions documentation change
Summary
Added new API endpoint GET '/iam/libraries/{libraryId}/projects/{projectId}/assets/{assetId}/asset-templates/{templateId}/connectors/{connectorId}/resources' for retrieving connector resources with asset context. Extended data models (FileDetail, AssetDetail, etc.) with connectorInvocationSummary, connectorInvocations, and recentInvocations fields. Added new ConnectorInvocationDetail and ConnectorInvocationSummary model definitions. Introduced optional 'params' query parameter for proxy resource requests.
Security assessment
Changes focus on API functionality extensions and data model enhancements for connector operations. No evidence of security vulnerability fixes, security incident references, or new security features. Added parameters like 'params' enable dynamic behavior but lack security-specific documentation or safeguards.
Diff
diff --git a/solutions/latest/spatial-data-management-on-aws/api-reference.md b/solutions/latest/spatial-data-management-on-aws/api-reference.md index b98912acc..87a55b1b0 100644 --- a//solutions/latest/spatial-data-management-on-aws/api-reference.md +++ b//solutions/latest/spatial-data-management-on-aws/api-reference.md @@ -84,0 +85 @@ Property | Type | Description +`solutionVersion` | String | — @@ -670,0 +672,41 @@ Property | Type | Description +Bad request. The request was invalid or cannot be served. + +Property | Type | Description +---|---|--- +`message` | String | — + +### GET `/iam/libraries/{libraryId}/projects/{projectId}/assets/{assetId}/asset-templates/{templateId}/connectors/{connectorId}/resources` + +**Operation ID:** `GetConnectorResourcesViaAsset` + +Retrieves connector resources in the context of an asset, enabling server-side resolution of asset and file metadata for variable substitution. + +**Parameters** + +Name | In | Type | Required | Description +---|---|---|---|--- +`libraryId` | path | String | Yes | Pattern: `^library-[a-fA-F0-9]{32}$` +`projectId` | path | String | Yes | Pattern: `^project-[a-fA-F0-9]{32}(-[a-fA-F0-9]{32})?$` +`assetId` | path | String | Yes | Pattern: `^asset-[a-fA-F0-9]{32}$` +`templateId` | path | String | Yes | Pattern: `^template-[a-fA-F0-9]{32}$` +`connectorId` | path | String | Yes | Pattern: `^connector-[a-fA-F0-9]{32}$` +`resourceType` | query | String | Yes | — +`fileId` | query | String | No | Pattern: `^file-[a-fA-F0-9]{32}$` +`fileIds` | query | String | No | Comma-separated list of file IDs. When provided, metadata from all files is merged (e.g. lumidb_id values combined for multi-file queries). +`aabb` | query | String | No | JSON-encoded axis-aligned bounding box for spatial filtering. Passed through to the connector as a boundary parameter. +`params` | query | String | No | Optional JSON-encoded parameters for truly dynamic values (e.g., tile URI) that cannot be resolved from metadata. + +**Responses** + +`200` + + +Success + +Property | Type | Description +---|---|--- +`resources` | Object | — + +`400` + + @@ -933,0 +976,9 @@ Property | Type | Description +`connectorInvocationSummary` | Object | Summary of connector invocation states for a resource. Cached on the resource record for efficient list-view rendering. Extensible: future releases may add byDirection or byConnectorId breakdowns. +`connectorInvocationSummary.total` | Number | — +`connectorInvocationSummary.succeeded` | Number | — +`connectorInvocationSummary.failed` | Number | — +`connectorInvocationSummary.inProgress` | Number | — +`connectorInvocationSummary.queued` | Number | — +`connectorInvocationSummary.waiting` | Number | — +`connectorInvocationSummary.blocked` | Number | — +`connectorInvocationSummary.notApplicable` | Number | — @@ -945,0 +997 @@ Property | Type | Description +`connectorInvocations` | Array of ConnectorInvocationDetail | — @@ -1057,0 +1110,9 @@ Property | Type | Description +`connectorInvocationSummary` | Object | Summary of connector invocation states for a resource. Cached on the resource record for efficient list-view rendering. Extensible: future releases may add byDirection or byConnectorId breakdowns. +`connectorInvocationSummary.total` | Number | — +`connectorInvocationSummary.succeeded` | Number | — +`connectorInvocationSummary.failed` | Number | — +`connectorInvocationSummary.inProgress` | Number | — +`connectorInvocationSummary.queued` | Number | — +`connectorInvocationSummary.waiting` | Number | — +`connectorInvocationSummary.blocked` | Number | — +`connectorInvocationSummary.notApplicable` | Number | — @@ -1069,0 +1131 @@ Property | Type | Description +`connectorInvocations` | Array of ConnectorInvocationDetail | — @@ -2253,0 +2316 @@ Property | Type | Description +`recentInvocations` | Array of ConnectorInvocationDetail | — @@ -2297,0 +2361 @@ Property | Type | Description +`recentInvocations` | Array of ConnectorInvocationDetail | — @@ -2351,0 +2416 @@ Property | Type | Description +`recentInvocations` | Array of ConnectorInvocationDetail | — @@ -2738,0 +2804 @@ Name | In | Type | Required | Description +`params` | query | String | No | Optional JSON-encoded parameters passed through to the connector for proxy resource requests (e.g., tileset/tile fetching). @@ -3388,0 +3455,2 @@ Allowed values: + * `exchange` + @@ -3421,0 +3490,2 @@ Allowed values: + * `deadlineJob` + @@ -3546,2 +3615,0 @@ Type: `string` -A unique identifier for a resource. The format is a UUID. - @@ -3771,0 +3840 @@ Property | Type | Required | Description +`eventCorrelationId` | String | No | — @@ -3805,0 +3875,35 @@ Property | Type | Required | Description +### ConnectorInvocationDetail + +A single connector invocation record returned in GetFile / GetFileVersion responses. + +Property | Type | Required | Description +---|---|---|--- +`connectorInvocationId` | String | Yes | — +`connectorId` | String | Yes | Unique identifier for the connector +`resourceId` | String | Yes | — +`status` | String | Yes | — +`createdAt` | Number | No | — +`lastStatusChangeAt` | Number | No | — +`eventCorrelationId` | String | No | — +`eventTriggeredBy` | String | No | — +`eventType` | String | No | — +`triggerResourceType` | String | No | — +`dependsOn` | Array of String | No | — +`waitingOn` | Array of String | No | — +`blockedBy` | Array of String | No | — + +### ConnectorInvocationSummary + +Summary of connector invocation states for a resource. Cached on the resource record for efficient list-view rendering. Extensible: future releases may add byDirection or byConnectorId breakdowns. + +Property | Type | Required | Description +---|---|---|--- +`total` | Number | Yes | — +`succeeded` | Number | Yes | — +`failed` | Number | Yes | — +`inProgress` | Number | Yes | — +`queued` | Number | Yes | — +`waiting` | Number | Yes | — +`blocked` | Number | Yes | — +`notApplicable` | Number | Yes | — + @@ -3902,0 +4007 @@ Property | Type | Required | Description +`recentInvocations` | Array of ConnectorInvocationDetail | No | — @@ -3961 +4066,2 @@ Property | Type | Required | Description -`analysisState` | AnalysisState | Yes | — +`analysisState` | AnalysisState | No | — +`connectorInvocationSummary` | ConnectorInvocationSummary | No | — @@ -3968,0 +4075 @@ Property | Type | Required | Description +`connectorInvocations` | Array of ConnectorInvocationDetail | No | — @@ -4093,0 +4201,8 @@ Property | Type | Required | Description +### GetConnectorResourcesViaAssetResponseContent + +Response data for GetConnectorResourcesViaAsset operation. + +Property | Type | Required | Description +---|---|---|--- +`resources` | Object | Yes | — + @@ -4125,0 +4241 @@ Property | Type | Required | Description +`recentInvocations` | Array of ConnectorInvocationDetail | No | — @@ -4141 +4257,2 @@ Property | Type | Required | Description -`analysisState` | AnalysisState | Yes | — +`analysisState` | AnalysisState | No | — +`connectorInvocationSummary` | ConnectorInvocationSummary | No | — @@ -4148,0 +4266 @@ Property | Type | Required | Description +`connectorInvocations` | Array of ConnectorInvocationDetail | No | — @@ -4164 +4282,2 @@ Property | Type | Required | Description -`analysisState` | AnalysisState | Yes | — +`analysisState` | AnalysisState | No | — +`connectorInvocationSummary` | ConnectorInvocationSummary | No | — @@ -4171,0 +4291 @@ Property | Type | Required | Description +`connectorInvocations` | Array of ConnectorInvocationDetail | No | — @@ -4202,0 +4323 @@ Property | Type | Required | Description +`solutionVersion` | String | No | — @@ -4833,0 +4955 @@ Property | Type | Required | Description +`recentInvocations` | Array of ConnectorInvocationDetail | No | —