diff --git a/docs/dyn/workloadmanager_v1.projects.locations.html b/docs/dyn/workloadmanager_v1.projects.locations.html index 25ebe4347e6..4a26f4cd563 100644 --- a/docs/dyn/workloadmanager_v1.projects.locations.html +++ b/docs/dyn/workloadmanager_v1.projects.locations.html @@ -79,6 +79,11 @@

Instance Methods

Returns the evaluations Resource.

+

+ insights() +

+

Returns the insights Resource.

+

operations()

diff --git a/docs/dyn/workloadmanager_v1.projects.locations.insights.html b/docs/dyn/workloadmanager_v1.projects.locations.insights.html new file mode 100644 index 00000000000..3509c266d1d --- /dev/null +++ b/docs/dyn/workloadmanager_v1.projects.locations.insights.html @@ -0,0 +1,171 @@ + + + +

Workload Manager API . projects . locations . insights

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ writeInsight(location, body=None, x__xgafv=None)

+

Write the data insights to workload manager data warehouse.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ writeInsight(location, body=None, x__xgafv=None) +
Write the data insights to workload manager data warehouse.
+
+Args:
+  location: string, Required. The GCP location. The format is: projects/{project}/locations/{location}. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request for sending the data insights.
+  "insight": { # A presentation of host resource usage where the workload runs. # Required. The metrics data details.
+    "sapDiscovery": { # The schema of SAP system discovery data. # The insights data for sap system discovery. This is a copy of SAP System proto and should get updated whenever that one changes.
+      "applicationLayer": { # Message describing the system component. # An SAP system may run without an application layer.
+        "applicationType": "A String", # The component is a SAP application.
+        "databaseType": "A String", # The component is a SAP database.
+        "hostProject": "A String", # Pantheon Project in which the resources reside.
+        "resources": [ # The resources in a component.
+          { # Message describing a resource.
+            "relatedResources": [ # A list of resource URIs related to this resource.
+              "A String",
+            ],
+            "resourceKind": "A String", # ComputeInstance, ComputeDisk, VPC, Bare Metal server, etc.
+            "resourceType": "A String", # The type of this resource.
+            "resourceUri": "A String", # URI of the resource, includes project, location, and name.
+            "updateTime": "A String", # Unix timestamp of when this resource last had its discovery data updated.
+          },
+        ],
+        "sid": "A String", # The sap identifier, used by the SAP software and helps differentiate systems for customers.
+      },
+      "databaseLayer": { # Message describing the system component. # An SAP System must have a database.
+        "applicationType": "A String", # The component is a SAP application.
+        "databaseType": "A String", # The component is a SAP database.
+        "hostProject": "A String", # Pantheon Project in which the resources reside.
+        "resources": [ # The resources in a component.
+          { # Message describing a resource.
+            "relatedResources": [ # A list of resource URIs related to this resource.
+              "A String",
+            ],
+            "resourceKind": "A String", # ComputeInstance, ComputeDisk, VPC, Bare Metal server, etc.
+            "resourceType": "A String", # The type of this resource.
+            "resourceUri": "A String", # URI of the resource, includes project, location, and name.
+            "updateTime": "A String", # Unix timestamp of when this resource last had its discovery data updated.
+          },
+        ],
+        "sid": "A String", # The sap identifier, used by the SAP software and helps differentiate systems for customers.
+      },
+      "metadata": { # Message describing SAP discovery system metadata # The metadata for SAP system discovery data.
+        "customerRegion": "A String", # Customer region string for customer's use. Does not represent GCP region.
+        "definedSystem": "A String", # Customer defined, something like "E-commerce pre prod"
+        "environmentType": "A String", # Should be "prod", "QA", "dev", "staging", etc.
+        "sapProduct": "A String", # This sap product name
+      },
+      "systemId": "A String", # A combination of database SID, database instance URI and tenant DB name to make a unique identifier per-system.
+      "updateTime": "A String", # Unix timestamp this system has been updated last.
+    },
+    "sapValidation": { # A presentation of SAP workload insight. The schema of SAP workloads validation related data. # The insights data for the sap workload validation.
+      "validationDetails": [ # A list of SAP validation metrics data.
+        { # Message describing the SAP validation metrics.
+          "details": { # The pairs of metrics data: field name & field value.
+            "a_key": "A String",
+          },
+          "sapValidationType": "A String", # The SAP system that the validation data is from.
+        },
+      ],
+    },
+    "sentTime": "A String", # Output only. [Output only] Create time stamp
+  },
+  "requestId": "A String", # Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The response for write insights request.
+}
+
+ + \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/workloadmanager.v1.json b/googleapiclient/discovery_cache/documents/workloadmanager.v1.json index 681a5b92965..fef16d2ccb9 100644 --- a/googleapiclient/discovery_cache/documents/workloadmanager.v1.json +++ b/googleapiclient/discovery_cache/documents/workloadmanager.v1.json @@ -14,7 +14,7 @@ "canonicalName": "Workload Manager", "description": "", "discoveryVersion": "v1", - "documentationLink": "https://g3doc.corp.google.com/company/teams/compute-fe/index.md?cl=head", + "documentationLink": "https://cloud.google.com/workload-manager/docs", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -290,6 +290,38 @@ } } }, + "insights": { + "methods": { + "writeInsight": { + "description": "Write the data insights to workload manager data warehouse.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insights:writeInsight", + "httpMethod": "POST", + "id": "workloadmanager.projects.locations.insights.writeInsight", + "parameterOrder": [ + "location" + ], + "parameters": { + "location": { + "description": "Required. The GCP location. The format is: projects/{project}/locations/{location}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+location}/insights:writeInsight", + "request": { + "$ref": "WriteInsightRequest" + }, + "response": { + "$ref": "WriteInsightResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "operations": { "methods": { "cancel": { @@ -418,7 +450,7 @@ } } }, - "revision": "20221123", + "revision": "20221213", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -505,6 +537,27 @@ }, "type": "object" }, + "Insight": { + "description": "A presentation of host resource usage where the workload runs.", + "id": "Insight", + "properties": { + "sapDiscovery": { + "$ref": "SapDiscovery", + "description": "The insights data for sap system discovery. This is a copy of SAP System proto and should get updated whenever that one changes." + }, + "sapValidation": { + "$ref": "SapValidation", + "description": "The insights data for the sap workload validation." + }, + "sentTime": { + "description": "Output only. [Output only] Create time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ListEvaluationsResponse": { "description": "Message for response to listing Evaluations", "id": "ListEvaluationsResponse", @@ -741,6 +794,178 @@ }, "type": "object" }, + "SapDiscovery": { + "description": "The schema of SAP system discovery data.", + "id": "SapDiscovery", + "properties": { + "applicationLayer": { + "$ref": "SapDiscoveryComponent", + "description": "An SAP system may run without an application layer." + }, + "databaseLayer": { + "$ref": "SapDiscoveryComponent", + "description": "An SAP System must have a database." + }, + "metadata": { + "$ref": "SapDiscoveryMetadata", + "description": "The metadata for SAP system discovery data." + }, + "systemId": { + "description": "A combination of database SID, database instance URI and tenant DB name to make a unique identifier per-system.", + "type": "string" + }, + "updateTime": { + "description": "Unix timestamp this system has been updated last.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "SapDiscoveryComponent": { + "description": "Message describing the system component.", + "id": "SapDiscoveryComponent", + "properties": { + "applicationType": { + "description": "The component is a SAP application.", + "type": "string" + }, + "databaseType": { + "description": "The component is a SAP database.", + "type": "string" + }, + "hostProject": { + "description": "Pantheon Project in which the resources reside.", + "type": "string" + }, + "resources": { + "description": "The resources in a component.", + "items": { + "$ref": "SapDiscoveryResource" + }, + "type": "array" + }, + "sid": { + "description": "The sap identifier, used by the SAP software and helps differentiate systems for customers.", + "type": "string" + } + }, + "type": "object" + }, + "SapDiscoveryMetadata": { + "description": "Message describing SAP discovery system metadata", + "id": "SapDiscoveryMetadata", + "properties": { + "customerRegion": { + "description": "Customer region string for customer's use. Does not represent GCP region.", + "type": "string" + }, + "definedSystem": { + "description": "Customer defined, something like \"E-commerce pre prod\"", + "type": "string" + }, + "environmentType": { + "description": "Should be \"prod\", \"QA\", \"dev\", \"staging\", etc.", + "type": "string" + }, + "sapProduct": { + "description": "This sap product name", + "type": "string" + } + }, + "type": "object" + }, + "SapDiscoveryResource": { + "description": "Message describing a resource.", + "id": "SapDiscoveryResource", + "properties": { + "relatedResources": { + "description": "A list of resource URIs related to this resource.", + "items": { + "type": "string" + }, + "type": "array" + }, + "resourceKind": { + "description": "ComputeInstance, ComputeDisk, VPC, Bare Metal server, etc.", + "type": "string" + }, + "resourceType": { + "description": "The type of this resource.", + "enum": [ + "RESOURCE_TYPE_UNSPECIFIED", + "COMPUTE", + "STORAGE", + "NETWORK" + ], + "enumDescriptions": [ + "Undefined resource type.", + "This is a compute resource.", + "This a storage resource.", + "This is a network resource." + ], + "type": "string" + }, + "resourceUri": { + "description": "URI of the resource, includes project, location, and name.", + "type": "string" + }, + "updateTime": { + "description": "Unix timestamp of when this resource last had its discovery data updated.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "SapValidation": { + "description": "A presentation of SAP workload insight. The schema of SAP workloads validation related data.", + "id": "SapValidation", + "properties": { + "validationDetails": { + "description": "A list of SAP validation metrics data.", + "items": { + "$ref": "SapValidationValidationDetail" + }, + "type": "array" + } + }, + "type": "object" + }, + "SapValidationValidationDetail": { + "description": "Message describing the SAP validation metrics.", + "id": "SapValidationValidationDetail", + "properties": { + "details": { + "additionalProperties": { + "type": "string" + }, + "description": "The pairs of metrics data: field name & field value.", + "type": "object" + }, + "sapValidationType": { + "description": "The SAP system that the validation data is from.", + "enum": [ + "SAP_VALIDATION_TYPE_UNSPECIFIED", + "SYSTEM", + "COROSYNC", + "PACEMAKER", + "HANA", + "NETWEAVER" + ], + "enumDescriptions": [ + "Unspecified type.", + "The SAP system named SYSTEM.", + "The SAP system named COROSYNC.", + "The SAP system named PACEMAKER.", + "The SAP system named HANA.", + "The SAP system named NETWEAVER." + ], + "type": "string" + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -767,6 +992,27 @@ } }, "type": "object" + }, + "WriteInsightRequest": { + "description": "Request for sending the data insights.", + "id": "WriteInsightRequest", + "properties": { + "insight": { + "$ref": "Insight", + "description": "Required. The metrics data details." + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + } + }, + "type": "object" + }, + "WriteInsightResponse": { + "description": "The response for write insights request.", + "id": "WriteInsightResponse", + "properties": {}, + "type": "object" } }, "servicePath": "",