modelarts-umn/api-ref/source/service_management/querying_service_update_logs.rst

original_name

modelarts_03_0088.html

Querying Service Update Logs

Function

This API is used to query the update logs of a real-time service.

URI

GET /v1/{project_id}/services/{service_id}/logs

Table 1 <modelarts_03_0088__en-us_topic_0130234308_table10624434011> describes the required parameters.

Table 1 Parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID <modelarts_03_0147>.
service_id	Yes	String	Service ID
update_time	No	Number	Update time for filtering. This parameter can be used to obtain the update logs of a real-time service. By default, the filtering by update time is disabled.

Request Body

None

Response Body

Table 2 <modelarts_03_0088__en-us_topic_0130234308_table1869020408516> describes the response parameters.

Table 2 Parameters

Parameter	Type	Description
service_id	String	Service ID
service_name	String	Service name
logs	log array	Service update logs. For details, see Table 3 <modelarts_03_0088__en-us_topic_0130234308_table0745828125216>.

Table 3 log parameters

Parameter	Type	Description
update_time	Number	Time when a service is updated, in milliseconds calculated from 1970.1.1 0:0:0 UTC
result	String	Update result. The value can be SUCCESS, FAIL, or RUNNING.
config	config array	Updated service configurations. For details, see Table 4 <modelarts_03_0088__en-us_topic_0130234308_table1355535185314>.
success_num	Number	Number of nodes that are successfully operated. This parameter is returned when infer_type is set to edge.
failed_num	Number	Number of nodes that fail to be operated. This parameter is returned when infer_type is set to edge.
result_detail	result array	Operation result details. This parameter is returned when infer_type is set to edge. For details, see Table 5 <modelarts_03_0088__en-us_topic_0130234308_table44853072416>.
cluster_id	String	ID of a dedicated resource pool
extend_config	List	Personalized configuration

Table 4 config parameters

Parameter	Type	Description
model_id	String	Model ID
model_name	String	Model name
model_version	String	Model version
weight	Integer	Traffic weight allocated to a model. This parameter is returned when infer_type is set to real-time.
specification	String	Resource flavor.
custom_spec	Object	Custom specifications. For details, see Table 6 <modelarts_03_0088__en-us_topic_0130234308_table134334512416>.
instance_count	Integer	Number of instances deployed in a model.
envs	Map<String, String>	Environment variable key-value pair required for running a model To ensure data security, do not enter sensitive information, such as plaintext passwords, in environment variables.
cluster_id	String	ID of a dedicated resource pool

Table 5 result parameters

Parameter	Type	Description
node_id	String	Node ID
node_name	String	Node name
operation	String	Operation type. The value can be deploy or delete.
result	Boolean	Operation result. true indicates operation success, and false indicates operation failure.

Table 6 custom_spec parameters

Parameter	Type	Description
cpu	Float	Number of CPUs
memory	Integer	Memory capacity in MB
gpu_p4	Float	Number of GPUs

Samples

The following shows how to query the update logs of the real-time service whose ID is xxxxxx and name is mnist.

• Sample request

  GET    https://endpoint/v1/{project_id}/services/xxxxxx/logs

• Sample response

  {
      "service_id": "e2122bbd-f7c8-4bf8-bacc-59616276194b",
      "service_name": "service-demo",
      "logs": [{
          "config": [{
              "model_id": "f565ac47-6239-4e8c-b2dc-0665dc52e302",
              "model_name": "model-demo",
              "model_version": "0.0.1",
              "specification": "modelarts.vm.cpu.2u",
              "custom_spec": {},
              "weight": 100,
              "instance_count": 1,
              "scaling": false,
              "envs": {},
              "cluster_id": "2c9080f86d37da64016d381fe5940002"
          }],
          "extend_config": [],
          "update_time": 1586250930708,
          "result": "RUNNING",
          "cluster_id": "2c9080f86d37da64016d381fe5940002"
      }]
  }

Status Code

For details about the status code, see Table 1 <modelarts_03_0094__en-us_topic_0132773864_table1450010510213>.

Error Codes

See Error Codes <modelarts_03_0095>.