218 lines
6.2 KiB
JSON
218 lines
6.2 KiB
JSON
|
{
|
|||
|
"version":"2.0",
|
|||
|
"metadata":{
|
|||
|
"apiVersion":"2020-09-23",
|
|||
|
"endpointPrefix":"edge.sagemaker",
|
|||
|
"jsonVersion":"1.1",
|
|||
|
"protocol":"rest-json",
|
|||
|
"serviceFullName":"Amazon Sagemaker Edge Manager",
|
|||
|
"serviceId":"Sagemaker Edge",
|
|||
|
"signatureVersion":"v4",
|
|||
|
"signingName":"sagemaker",
|
|||
|
"uid":"sagemaker-edge-2020-09-23"
|
|||
|
},
|
|||
|
"operations":{
|
|||
|
"GetDeviceRegistration":{
|
|||
|
"name":"GetDeviceRegistration",
|
|||
|
"http":{
|
|||
|
"method":"POST",
|
|||
|
"requestUri":"/GetDeviceRegistration"
|
|||
|
},
|
|||
|
"input":{"shape":"GetDeviceRegistrationRequest"},
|
|||
|
"output":{"shape":"GetDeviceRegistrationResult"},
|
|||
|
"errors":[
|
|||
|
{"shape":"InternalServiceException"}
|
|||
|
],
|
|||
|
"documentation":"<p>Use to check if a device is registered with SageMaker Edge Manager.</p>"
|
|||
|
},
|
|||
|
"SendHeartbeat":{
|
|||
|
"name":"SendHeartbeat",
|
|||
|
"http":{
|
|||
|
"method":"POST",
|
|||
|
"requestUri":"/SendHeartbeat"
|
|||
|
},
|
|||
|
"input":{"shape":"SendHeartbeatRequest"},
|
|||
|
"errors":[
|
|||
|
{"shape":"InternalServiceException"}
|
|||
|
],
|
|||
|
"documentation":"<p>Use to get the current status of devices registered on SageMaker Edge Manager.</p>"
|
|||
|
}
|
|||
|
},
|
|||
|
"shapes":{
|
|||
|
"CacheTTLSeconds":{
|
|||
|
"type":"string",
|
|||
|
"max":1000,
|
|||
|
"min":1
|
|||
|
},
|
|||
|
"DeviceFleetName":{
|
|||
|
"type":"string",
|
|||
|
"max":63,
|
|||
|
"min":1,
|
|||
|
"pattern":"^[a-zA-Z0-9](-*_*[a-zA-Z0-9])*$"
|
|||
|
},
|
|||
|
"DeviceName":{
|
|||
|
"type":"string",
|
|||
|
"max":63,
|
|||
|
"min":1,
|
|||
|
"pattern":"^[a-zA-Z0-9](-*_*[a-zA-Z0-9])*$"
|
|||
|
},
|
|||
|
"DeviceRegistration":{
|
|||
|
"type":"string",
|
|||
|
"max":1000,
|
|||
|
"min":1
|
|||
|
},
|
|||
|
"Dimension":{
|
|||
|
"type":"string",
|
|||
|
"max":1000,
|
|||
|
"min":1,
|
|||
|
"pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9\\/])*$"
|
|||
|
},
|
|||
|
"EdgeMetric":{
|
|||
|
"type":"structure",
|
|||
|
"members":{
|
|||
|
"Dimension":{
|
|||
|
"shape":"Dimension",
|
|||
|
"documentation":"<p>The dimension of metrics published.</p>"
|
|||
|
},
|
|||
|
"MetricName":{
|
|||
|
"shape":"Metric",
|
|||
|
"documentation":"<p>Returns the name of the metric.</p>"
|
|||
|
},
|
|||
|
"Value":{
|
|||
|
"shape":"Value",
|
|||
|
"documentation":"<p>Returns the value of the metric.</p>"
|
|||
|
},
|
|||
|
"Timestamp":{
|
|||
|
"shape":"Timestamp",
|
|||
|
"documentation":"<p>Timestamp of when the metric was requested.</p>"
|
|||
|
}
|
|||
|
},
|
|||
|
"documentation":"<p>Information required for edge device metrics.</p>"
|
|||
|
},
|
|||
|
"EdgeMetrics":{
|
|||
|
"type":"list",
|
|||
|
"member":{"shape":"EdgeMetric"}
|
|||
|
},
|
|||
|
"ErrorMessage":{"type":"string"},
|
|||
|
"GetDeviceRegistrationRequest":{
|
|||
|
"type":"structure",
|
|||
|
"required":[
|
|||
|
"DeviceName",
|
|||
|
"DeviceFleetName"
|
|||
|
],
|
|||
|
"members":{
|
|||
|
"DeviceName":{
|
|||
|
"shape":"DeviceName",
|
|||
|
"documentation":"<p>The unique name of the device you want to get the registration status from.</p>"
|
|||
|
},
|
|||
|
"DeviceFleetName":{
|
|||
|
"shape":"DeviceFleetName",
|
|||
|
"documentation":"<p>The name of the fleet that the device belongs to.</p>"
|
|||
|
}
|
|||
|
}
|
|||
|
},
|
|||
|
"GetDeviceRegistrationResult":{
|
|||
|
"type":"structure",
|
|||
|
"members":{
|
|||
|
"DeviceRegistration":{
|
|||
|
"shape":"DeviceRegistration",
|
|||
|
"documentation":"<p>Describes if the device is currently registered with SageMaker Edge Manager.</p>"
|
|||
|
},
|
|||
|
"CacheTTL":{
|
|||
|
"shape":"CacheTTLSeconds",
|
|||
|
"documentation":"<p>The amount of time, in seconds, that the registration status is stored on the device’s cache before it is refreshed.</p>"
|
|||
|
}
|
|||
|
}
|
|||
|
},
|
|||
|
"InternalServiceException":{
|
|||
|
"type":"structure",
|
|||
|
"members":{
|
|||
|
"Message":{"shape":"ErrorMessage"}
|
|||
|
},
|
|||
|
"documentation":"<p>An internal failure occurred. Try your request again. If the problem persists, contact AWS customer support.</p>",
|
|||
|
"exception":true
|
|||
|
},
|
|||
|
"Metric":{
|
|||
|
"type":"string",
|
|||
|
"max":100,
|
|||
|
"min":4,
|
|||
|
"pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*$"
|
|||
|
},
|
|||
|
"Model":{
|
|||
|
"type":"structure",
|
|||
|
"members":{
|
|||
|
"ModelName":{
|
|||
|
"shape":"ModelName",
|
|||
|
"documentation":"<p>The name of the model.</p>"
|
|||
|
},
|
|||
|
"ModelVersion":{
|
|||
|
"shape":"Version",
|
|||
|
"documentation":"<p>The version of the model.</p>"
|
|||
|
},
|
|||
|
"LatestSampleTime":{
|
|||
|
"shape":"Timestamp",
|
|||
|
"documentation":"<p>The timestamp of the last data sample taken.</p>"
|
|||
|
},
|
|||
|
"LatestInference":{
|
|||
|
"shape":"Timestamp",
|
|||
|
"documentation":"<p>The timestamp of the last inference that was made.</p>"
|
|||
|
},
|
|||
|
"ModelMetrics":{
|
|||
|
"shape":"EdgeMetrics",
|
|||
|
"documentation":"<p>Information required for model metrics.</p>"
|
|||
|
}
|
|||
|
},
|
|||
|
"documentation":"<p>Information about a model deployed on an edge device that is registered with SageMaker Edge Manager.</p>"
|
|||
|
},
|
|||
|
"ModelName":{
|
|||
|
"type":"string",
|
|||
|
"max":255,
|
|||
|
"min":4,
|
|||
|
"pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9])*$"
|
|||
|
},
|
|||
|
"Models":{
|
|||
|
"type":"list",
|
|||
|
"member":{"shape":"Model"}
|
|||
|
},
|
|||
|
"SendHeartbeatRequest":{
|
|||
|
"type":"structure",
|
|||
|
"required":[
|
|||
|
"AgentVersion",
|
|||
|
"DeviceName",
|
|||
|
"DeviceFleetName"
|
|||
|
],
|
|||
|
"members":{
|
|||
|
"AgentMetrics":{
|
|||
|
"shape":"EdgeMetrics",
|
|||
|
"documentation":"<p>For internal use. Returns a list of SageMaker Edge Manager agent operating metrics.</p>"
|
|||
|
},
|
|||
|
"Models":{
|
|||
|
"shape":"Models",
|
|||
|
"documentation":"<p>Returns a list of models deployed on the the device.</p>"
|
|||
|
},
|
|||
|
"AgentVersion":{
|
|||
|
"shape":"Version",
|
|||
|
"documentation":"<p>Returns the version of the agent.</p>"
|
|||
|
},
|
|||
|
"DeviceName":{
|
|||
|
"shape":"DeviceName",
|
|||
|
"documentation":"<p>The unique name of the device.</p>"
|
|||
|
},
|
|||
|
"DeviceFleetName":{
|
|||
|
"shape":"DeviceFleetName",
|
|||
|
"documentation":"<p>The name of the fleet that the device belongs to.</p>"
|
|||
|
}
|
|||
|
}
|
|||
|
},
|
|||
|
"Timestamp":{"type":"timestamp"},
|
|||
|
"Value":{"type":"double"},
|
|||
|
"Version":{
|
|||
|
"type":"string",
|
|||
|
"max":64,
|
|||
|
"min":1,
|
|||
|
"pattern":"[a-zA-Z0-9\\ \\_\\.]+"
|
|||
|
}
|
|||
|
},
|
|||
|
"documentation":"<p>SageMaker Edge Manager dataplane service for communicating with active agents.</p>"
|
|||
|
}
|