2022-07-31
▼ ▲ beyondcorp.organizations.locations.insights.get
Path : v1alpha/{+name}
Flat Path : v1alpha/organizations/{organizationsId}/locations/{locationsId}/insights/{insightsId}
HTTP Method : GET
Parameters :
name
Location : path
Description : Required. The resource name of the insight using the form: `organizations/{organization_id}/locations/{location_id}/insights/{insight_id}` `projects/{project_id}/locations/{location_id}/insights/{insight_id}`
Pattern : ^organizations/[^/]+/locations/[^/]+/insights/[^/]+$
Type : string
Required : Yes
view
Type : string
Location : query
Enum :
Enum Descriptions :
Description : Required. Metadata only or full data view.
Parameter Order : name
Description : Gets the value for a selected particular insight with default configuration. The default aggregation level is 'DAILY' and no grouping will be applied or default grouping if applicable. The data will be returned for recent 7 days. Use the organization level path for fetching at org level and project level path for fetching the insight value specific to a particular project. Setting the `view` to `BASIC` will only return the metadata for the insight.
▼ ▲ beyondcorp.organizations.locations.insights.configuredInsight
Scopes : https://www.googleapis.com/auth/cloud-platform
HTTP Method : GET
Description : Gets the value for a selected particular insight based on the provided filters. Use the organization level path for fetching at org level and project level path for fetching the insight value specific to a particular project.
Flat Path : v1alpha/organizations/{organizationsId}/locations/{locationsId}/insights/{insightsId}:configuredInsight
Path : v1alpha/{+insight}:configuredInsight
Parameter Order : insight
Parameters :
group
Description : Optional. Group id of the available groupings for the insight. Available groupings could be fetched by calling insight list and get APIs in `BASIC` view.
Type : string
Location : query
pageSize
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
Type : integer
Location : query
Format : int32
endTime
Description : Required. Ending time for the duration for which insight is to be pulled.
Format : google-datetime
Location : query
Type : string
pageToken
Location : query
Description : Optional. Used to fetch the page represented by the token. Fetches the first page when not set.
Type : string
startTime
Type : string
Description : Required. Starting time for the duration for which insight is to be pulled.
Format : google-datetime
Location : query
aggregation
Enum Descriptions :
Location : query
Type : string
Enum :
Description : Optional. Aggregation type. Available aggregation could be fetched by calling insight list and get APIs in `BASIC` view.
customGrouping.groupFields
Location : query
Repeated : Yes
Type : string
Description : Required. Fields to be used for grouping. NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for declaring the fields to be grouped-by here.
insight
Location : path
Description : Required. The resource name of the insight using the form: `organizations/{organization_id}/locations/{location_id}/insights/{insight_id}` `projects/{project_id}/locations/{location_id}/insights/{insight_id}`.
Pattern : ^organizations/[^/]+/locations/[^/]+/insights/[^/]+$
Required : Yes
Type : string
fieldFilter
Description : Optional. Other filterable/configurable parameters as applicable to the selected insight. Available fields could be fetched by calling insight list and get APIs in `BASIC` view. `=` is the only comparison operator supported. `AND` is the only logical operator supported. Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for the filtering the corresponding fields in this filter field. (These expressions are based on the filter language described at https://google.aip.dev/160).
Location : query
Type : string
customGrouping.fieldFilter
Location : query
Description : Optional. Filterable parameters to be added to the grouping clause. Available fields could be fetched by calling insight list and get APIs in `BASIC` view. `=` is the only comparison operator supported. `AND` is the only logical operator supported. Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for the filtering the corresponding fields in this filter field. (These expressions are based on the filter language described at https://google.aip.dev/160).
Type : string
▼ ▲ beyondcorp.organizations.locations.insights.list
HTTP Method : GET
Parameter Order : parent
Flat Path : v1alpha/organizations/{organizationsId}/locations/{locationsId}/insights
Path : v1alpha/{+parent}/insights
Description : Lists for all the available insights that could be fetched from the system. Allows to filter using category. Setting the `view` to `BASIC` will let you iterate over the list of insight metadatas.
Scopes : https://www.googleapis.com/auth/cloud-platform
Parameters :
view
Enum Descriptions :
Type : string
Location : query
Enum :
Description : Required. List only metadata or full data.
orderBy
Description : Optional. Hint for how to order the results. This is currently ignored.
Location : query
Type : string
filter
Type : string
Location : query
Description : Optional. Filter expression to restrict the insights returned. Supported filter fields: * `type` * `category` * `subCategory` Examples: * "category = application AND type = count" * "category = application AND subCategory = iap" * "type = status" Allowed values: * type: [count, latency, status, list] * category: [application, device, request, security] * subCategory: [iap, webprotect] NOTE: Only equality based comparison is allowed. Only `AND` conjunction is allowed. NOTE: The 'AND' in the filter field needs to be in capital letters only. NOTE: Just filtering on `subCategory` is not allowed. It should be passed in with the parent `category` too. (These expressions are based on the filter language described at https://google.aip.dev/160).
pageSize
Location : query
Format : int32
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. NOTE: Default page size is 50.
Type : integer
parent
Required : Yes
Pattern : ^organizations/[^/]+/locations/[^/]+$
Description : Required. The resource name of InsightMetadata using the form: `organizations/{organization_id}/locations/{location}` `projects/{project_id}/locations/{location_id}`
Location : path
Type : string
pageToken
Description : Optional. A token identifying a page of results the server should return.
Location : query
Type : string
▼ ▲ beyondcorp.projects.locations.insights.list
Scopes : https://www.googleapis.com/auth/cloud-platform
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/insights
Description : Lists for all the available insights that could be fetched from the system. Allows to filter using category. Setting the `view` to `BASIC` will let you iterate over the list of insight metadatas.
Parameter Order : parent
Parameters :
pageSize
Type : integer
Location : query
Format : int32
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. NOTE: Default page size is 50.
parent
Pattern : ^projects/[^/]+/locations/[^/]+$
Description : Required. The resource name of InsightMetadata using the form: `organizations/{organization_id}/locations/{location}` `projects/{project_id}/locations/{location_id}`
Location : path
Type : string
Required : Yes
filter
Type : string
Location : query
Description : Optional. Filter expression to restrict the insights returned. Supported filter fields: * `type` * `category` * `subCategory` Examples: * "category = application AND type = count" * "category = application AND subCategory = iap" * "type = status" Allowed values: * type: [count, latency, status, list] * category: [application, device, request, security] * subCategory: [iap, webprotect] NOTE: Only equality based comparison is allowed. Only `AND` conjunction is allowed. NOTE: The 'AND' in the filter field needs to be in capital letters only. NOTE: Just filtering on `subCategory` is not allowed. It should be passed in with the parent `category` too. (These expressions are based on the filter language described at https://google.aip.dev/160).
orderBy
Location : query
Type : string
Description : Optional. Hint for how to order the results. This is currently ignored.
pageToken
Location : query
Type : string
Description : Optional. A token identifying a page of results the server should return.
view
Enum Descriptions :
Enum :
Location : query
Type : string
Description : Required. List only metadata or full data.
Path : v1alpha/{+parent}/insights
HTTP Method : GET
▼ ▲ beyondcorp.projects.locations.insights.configuredInsight
Description : Gets the value for a selected particular insight based on the provided filters. Use the organization level path for fetching at org level and project level path for fetching the insight value specific to a particular project.
HTTP Method : GET
Path : v1alpha/{+insight}:configuredInsight
Parameters :
pageSize
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
Type : integer
Location : query
Format : int32
endTime
Format : google-datetime
Description : Required. Ending time for the duration for which insight is to be pulled.
Location : query
Type : string
aggregation
Location : query
Description : Optional. Aggregation type. Available aggregation could be fetched by calling insight list and get APIs in `BASIC` view.
Enum :
Type : string
Enum Descriptions :
insight
Description : Required. The resource name of the insight using the form: `organizations/{organization_id}/locations/{location_id}/insights/{insight_id}` `projects/{project_id}/locations/{location_id}/insights/{insight_id}`.
Required : Yes
Pattern : ^projects/[^/]+/locations/[^/]+/insights/[^/]+$
Type : string
Location : path
group
Location : query
Description : Optional. Group id of the available groupings for the insight. Available groupings could be fetched by calling insight list and get APIs in `BASIC` view.
Type : string
pageToken
Type : string
Description : Optional. Used to fetch the page represented by the token. Fetches the first page when not set.
Location : query
customGrouping.fieldFilter
Type : string
Location : query
Description : Optional. Filterable parameters to be added to the grouping clause. Available fields could be fetched by calling insight list and get APIs in `BASIC` view. `=` is the only comparison operator supported. `AND` is the only logical operator supported. Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for the filtering the corresponding fields in this filter field. (These expressions are based on the filter language described at https://google.aip.dev/160).
startTime
Type : string
Format : google-datetime
Location : query
Description : Required. Starting time for the duration for which insight is to be pulled.
customGrouping.groupFields
Type : string
Description : Required. Fields to be used for grouping. NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for declaring the fields to be grouped-by here.
Location : query
Repeated : Yes
fieldFilter
Type : string
Description : Optional. Other filterable/configurable parameters as applicable to the selected insight. Available fields could be fetched by calling insight list and get APIs in `BASIC` view. `=` is the only comparison operator supported. `AND` is the only logical operator supported. Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for the filtering the corresponding fields in this filter field. (These expressions are based on the filter language described at https://google.aip.dev/160).
Location : query
Scopes : https://www.googleapis.com/auth/cloud-platform
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/insights/{insightsId}:configuredInsight
Parameter Order : insight
▼ ▲ beyondcorp.projects.locations.insights.get
Parameters :
name
Location : path
Pattern : ^projects/[^/]+/locations/[^/]+/insights/[^/]+$
Type : string
Required : Yes
Description : Required. The resource name of the insight using the form: `organizations/{organization_id}/locations/{location_id}/insights/{insight_id}` `projects/{project_id}/locations/{location_id}/insights/{insight_id}`
view
Enum Descriptions :
Enum :
Description : Required. Metadata only or full data view.
Location : query
Type : string
Scopes : https://www.googleapis.com/auth/cloud-platform
Path : v1alpha/{+name}
HTTP Method : GET
Parameter Order : name
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/insights/{insightsId}
Description : Gets the value for a selected particular insight with default configuration. The default aggregation level is 'DAILY' and no grouping will be applied or default grouping if applicable. The data will be returned for recent 7 days. Use the organization level path for fetching at org level and project level path for fetching the insight value specific to a particular project. Setting the `view` to `BASIC` will only return the metadata for the insight.