Merge pull request #504 from PaloAltoNetworks/23.10.1

23.10.1 changes
PaloAltoNetworks · Oct 6, 2023 · ee7de1f · ee7de1f
2 parents 83301c1 + 248642d
commit ee7de1f
Show file tree

Hide file tree

Showing 6 changed files with 2,102 additions and 1,530 deletions.
diff --git a/openapi-specs/cspm/AssetExplorer.json b/openapi-specs/cspm/AssetExplorer.json
@@ -645,7 +645,7 @@
           }
         },
         "type": "object"
-      },
+},
       "Problem": {
         "type": "object",
         "properties": {
@@ -1642,6 +1642,7 @@
     },
     "/resource/scan_info": {
       "get": {
+        "deprecated": true,
         "description": "Returns a full breakdown of passed/failed statistics and associated policies for resources.  \r\n\r\nThe query parameters enable you to add filters to your request to narrow your results.\n### Filter by Time\nThe following table has examples of common filters by time. The time filter narrows the\nresponse to resources from account onboarding until the point in time of interest.\n\nPoint in time of interest | timeAmount | timeType | timeUnit \n-------------| ---- | ----------- | -------------\n24 hours ago | 24 | **relative** | hour      \n1 week ago |  1 | **relative** | week\n1 month ago | 1 | **relative** | month        \n1 year ago | 1 | **relative** | year                \nLatest | Not required with **to_now** | **to_now** | Defaults to **epoch**\n\n### How Current is the Returned Data?\nSince Prisma Cloud relies on snapshots of data, there can be an hour or two delay between the \ntime a resource passes or fails a policy check and the reporting of that result through this method.\n\n### Filter by Cloud Type\nYou can specify more than one cloud type to request a combination of data. For \nexample **cloud.type=gcp&cloud.type=azure** returns data for both **gcp** and **azure**.\n\n### Filter by Compliance Standard, Requirement, and/or Section \nYou can also broaden your filter by specifying any of the following query parameters more than once:\n* **policy.complianceStandard**\n* **policy.complianceRequirement**\n* **policy.complianceSection**\n",
         "operationId": "get-resource-scan-info",
         "parameters": [
@@ -1843,6 +1844,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns a full breakdown of passed/failed statistics and associated policies for resources.  \r\n\r\nYou can get a list of the valid names and values for the filters body parameter through \n[List Inventory Filters V2](/prisma-cloud/api/cspm/get-asset-inventory-v-2-dashboard-filter-options).\n\n### Filter by Time\nThe time filter narrows the response to resources from account onboarding until the point in time of interest.\n\n#### Time Types\n\nTime Type | Required **timeRange.value** Parameters\n----------|-----------------\n**to_now** | No **timeRange.value** parameter required\n**relative** | **timeRange.value.amount**, **timeRange.value.unit** \n**absolute** | **timeRange.value.endTime** (**timeRange.value.startTime** is ignored)\n\n### How Current is the Returned Data?\nSince Prisma Cloud relies on snapshots of data, there can be an hour or two delay between the \ntime a resource passes or fails a policy check and the reporting of that result through this method.\n",
         "operationId": "post-resource-scan-info",
         "requestBody": {
@@ -1885,7 +1887,7 @@
           "Asset Explorer"
         ]
       }
-    },
+},
     "/uai/v1/asset": {
       "post": {
         "tags": [

diff --git a/openapi-specs/cspm/AssetInventory.json b/openapi-specs/cspm/AssetInventory.json
@@ -914,6 +914,7 @@
     },
     "/v2/inventory": {
       "get": {
+        "deprecated": true,
         "description": "Returns asset inventory pass/fail data for the specified time period.  \r\n\r\nThe response includes an attribute **groupedAggregates**, whose content depends on the **groupBy** query parameter.\nThe following table shows the attributes that **groupedAggregates** will include for the specified **groupBy** query parameter:\n\n**groupBy**  | **groupedAggregates** Includes\n-------------| ------------------------------\nnot specified | **cloudTypeName**\n**cloudType** | **cloudTypeName**\n**cloud.account** | **accountName**\n**cloud.region** | **regionName**, **cloudTypeName**\n**cloud.service** | **serviceName**, **cloudTypeName**\n**resource.type** | **resourceTypeName**, **cloudTypeName**\n\n\nIf you specify **groupBy** multiple times in a single request, then **groupedAggregates** will include multiple attributes.\nFor example, you can set the following in the URL: **groupBy=cloud.account&groupBy=cloud.service**. Doing so will have the same effect\nas specifying a comma-separated list of values for **groupBy**.\n",
         "operationId": "asset-inventory-v2",
         "parameters": [
@@ -1101,6 +1102,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns asset inventory pass/fail data for the specified time period.  \r\n\r\nYou can get a list of the valid names and values for the filters body parameter \nthrough [List Inventory Filters V2](/prisma-cloud/api/cspm/get-asset-inventory-v-2-dashboard-filter-options).\n\nThe response includes an attribute **groupedAggregates**, whose content depends on the **groupBy** request body parameter.\nThe following table shows the attributes that **groupedAggregates** will include for the specified **groupBy** value:\n\n**groupBy**  | **groupedAggregates** Includes \n-------------| ------------------------------\n_not specified_ | **cloudTypeName**\n**cloudType** | **cloudTypeName**\n**cloud.account** | **accountName**\n**cloud.region** | **regionName**, **cloudTypeName**\n**cloud.service** | **serviceName**, **cloudTypeName**\n**resource.type** | **resourceTypeName**, **cloudTypeName**\n\n\nIf **groupBy** includes multiple values, then **groupedAggregates** will include multiple attributes. \n",
         "operationId": "post-method-for-asset-inventory-v2",
         "requestBody": {
@@ -1143,6 +1145,7 @@
     },
     "/v2/inventory/trend": {
       "get": {
+        "deprecated": true,
         "description": "Returns asset inventory pass/fail trends for the specified time period.",
         "operationId": "asset-inventory-trend-v2",
         "parameters": [
@@ -1328,6 +1331,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns asset inventory pass/fail trends for the specified time period.  \r\n\r\nYou can get a list of the valid names and values for the filters body parameter \nthrough [List Inventory Filters V2](/prisma-cloud/api/cspm/get-asset-inventory-v-2-dashboard-filter-options).\n",
         "operationId": "post-method-asset-inventory-trend-v2",
         "requestBody": {

diff --git a/openapi-specs/cspm/CompliancePosture.json b/openapi-specs/cspm/CompliancePosture.json
@@ -670,6 +670,7 @@
   "paths": {
     "/compliance/posture": {
       "get": {
+        "deprecated": true,
         "description": "Returns a breakdown of the passed/failed statistics and associated policies for compliance standards, requirements, and sections. Also returns a summary for all compliance standards.",
         "operationId": "get-compliance-posture",
         "parameters": [
@@ -795,6 +796,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns a breakdown of the passed/failed statistics and associated policies for compliance standards, requirements, and sections. Also returns a summary for all compliance standards.",
         "operationId": "post-compliance-posture",
         "requestBody": {
@@ -837,6 +839,7 @@
     },
     "/compliance/posture/{complianceId}": {
       "get": {
+        "deprecated": true,
         "description": "Returns a breakdown of the passed/failed statistics and associated policies for compliance standards, requirements, and sections for the given compliance standard ID.",
         "operationId": "get-compliance-posture-for-standard",
         "parameters": [
@@ -963,6 +966,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns a breakdown of the passed/failed statistics and associated policies for compliance standards, requirements, and sections for the given compliance standard ID.",
         "operationId": "post-compliance-posture-for-standard",
         "parameters": [
@@ -1017,6 +1021,7 @@
     },
     "/compliance/posture/{complianceId}/{requirementId}": {
       "get": {
+        "deprecated": true,
         "description": "Returns a breakdown of the passed/failed statistics and associated policies for compliance sections for the specified compliance standard ID and compliance requirement ID.",
         "operationId": "get-compliance-posture-for-requirement",
         "parameters": [
@@ -1144,6 +1149,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns a breakdown of the passed/failed statistics and associated policies for compliance sections for the specified compliance standard ID and compliance requirement ID.  \r\n\r\nThe **fields** body parameter allows you to request specific fields. These fields are separate \nfrom the filters you specify. The following are valid **fields** items.\n\n* cloud.account\n* account.group\n* cloud.region\n* cloud.type\n* policy.complianceStandard\n* policy.complianceRequirement\n* policy.complianceSection\n\nThe **filters** body parameter enables you to narrow your request for alerts. \nSee [Get Compliance Overview Filters and Options](/prisma-cloud/api/cspm/get-compliance-posture-filters-and-options) \nfor for an API request to list all the valid filters.\n",
         "operationId": "post-compliance-posture-for-requirement",
         "parameters": [
@@ -1208,6 +1214,7 @@
     },
     "/compliance/posture/trend": {
       "get": {
+        "deprecated": true,
         "description": "Returns a compliance posture summary that describes the passed/failed statistics trend.",
         "operationId": "get-compliance-posture-trend",
         "parameters": [
@@ -1336,6 +1343,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns a compliance posture summary that describes the passed/failed statistics trend.  \r\n\r\nThe **fields** body parameter allows you to request specific fields. These fields are separate \nfrom the filters you specify. The following are valid **fields** items.\n\n* cloud.account\n* account.group\n* cloud.region\n* cloud.type\n* policy.complianceStandard\n* policy.complianceRequirement\n* policy.complianceSection\n\nThe **filters** body parameter enables you to narrow your request for alerts. \nSee [Get Compliance Overview Filters and Options](/prisma-cloud/api/cspm/get-compliance-posture-filters-and-options) \nfor the API request to list all valid filters.\n",
         "operationId": "post-compliance-posture-trend",
         "requestBody": {
@@ -1381,6 +1389,7 @@
     },
     "/compliance/posture/trend/{complianceId}": {
       "get": {
+        "deprecated": true,
         "description": "Returns a compliance posture summary that describes the passed/failed statistics trend for the specified compliance standard ID.",
         "operationId": "get-compliance-posture-trend-for-standard",
         "parameters": [
@@ -1510,6 +1519,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns a compliance posture summary that describes the passed/failed statistics trend for the specified compliance standard ID.  \r\n\r\nThe **fields** request body parameter allows you to request specific fields. These fields are separate \nfrom the filters you specify. The following are valid **fields** items.\n\n* cloud.account\n* account.group\n* cloud.region\n* cloud.type\n* policy.complianceStandard\n* policy.complianceRequirement\n* policy.complianceSection\n\nThe **filters** request body parameter enables you to narrow your request for alerts. \nSee [Get Compliance Overview Filters and Options](/prisma-cloud/api/cspm/get-compliance-posture-filters-and-options) \nfor for an API request to list all the valid filters.\n",
         "operationId": "post-compliance-posture-trend-for-standard",
         "parameters": [
@@ -1567,6 +1577,7 @@
     },
     "/compliance/posture/trend/{complianceId}/{requirementId}": {
       "get": {
+        "deprecated": true,
         "description": "Returns the compliance posture summary that describes the passed/failed statistics trend for the given compliance standard ID and compliance requirement ID.",
         "operationId": "get-compliance-posture-trend-for-requirement",
         "parameters": [
@@ -1697,6 +1708,7 @@
         ]
       },
       "post": {
+        "deprecated": true,
         "description": "Returns the compliance posture summary that describes the passed/failed statistics trend for the given compliance standard ID and compliance requirement ID.  \r\n\r\nThe **fields** body parameter allows you to request specific fields. These fields are separate \nfrom the filters you specify. The following are valid **fields** items.\n\n* cloud.account\n* account.group\n* cloud.region\n* cloud.type\n* policy.complianceStandard\n* policy.complianceRequirement\n* policy.complianceSection\n\nThe **filters** body parameter enables you to narrow your request for alerts. \nSee [Get Compliance Overview Filters and Options](/prisma-cloud/api/cspm/get-compliance-posture-filters-and-options)\nfor the API request to list all valid filters.                                \n",
         "operationId": "post-compliance-posture-trend-for-requirement",
         "parameters": [