openapi-directory/api/azure.com/machinelearningservices-modelManagement.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"description":"These APIs allow end users to manage Azure Machine Learning Models, Images, Profiles, and Services.","title":"Azure Machine Learning Model Management Service","version":"2019-09-30","x-apisguru-categories":["cloud"],"x-logo":{"url":"https://assets.onestore.ms/cdnfiles/onestorerolling-1606-01000/shell/v3/images/logo/microsoft.png"},"x-origin":[{"format":"swagger","url":"https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/specification/machinelearningservices/data-plane/Microsoft.MachineLearningServices/preview/2019-09-30/modelManagement.json","version":"2.0"}],"x-preferred":true,"x-providerName":"azure.com","x-serviceName":"machinelearningservices-modelManagement","x-tags":["Azure","Microsoft"]},"security":[{"azure_auth":["user_impersonation"]}],"tags":[],"paths":{"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets":{"get":{"description":"If no filter is passed, the query lists all the Assets in the given workspace. The returned list is paginated and the count of items in each page is an optional parameter.","operationId":"Assets_ListQuery","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The run Id associated with the Assets.","in":"query","name":"runId","required":false,"schema":{"type":"string"}},{"description":"The object name.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"The number of items to retrieve in a page.","in":"query","name":"count","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"The continuation token to retrieve the next page.","in":"query","name":"$skipToken","required":false,"schema":{"type":"string"}},{"description":"A set of tags with which to filter the returned models.\r\n            It is a comma separated string of tags key or tags key=value\r\n            Example: tagKey1,tagKey2,tagKey3=value3","in":"query","name":"tags","required":false,"schema":{"type":"string"}},{"description":"A set of properties with which to filter the returned models.\r\n            It is a comma separated string of properties key and/or properties key=value\r\n            Example: propKey1,propKey2,propKey3=value3","in":"query","name":"properties","required":false,"schema":{"type":"string"}},{"description":"An option for specifying how to order the list.","in":"query","name":"orderby","required":false,"schema":{"type":"string","enum":["CreatedAtDesc","CreatedAtAsc","UpdatedAtDesc","UpdatedAtAsc"],"default":"CreatedAtDesc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAssetList"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Query the list of Assets in a workspace.","tags":["Asset"],"x-ms-pageable":{"nextLinkName":"nextLink"}},"post":{"description":"Create an Asset from the provided payload.","operationId":"Assets_Create","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":"The Asset to be created."},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Create an Asset.","tags":["Asset"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/assets/{id}":{"delete":{"description":"Delete the specified Asset.","operationId":"Assets_Delete","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Id of the Asset to delete.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The resource exists and was deleted successfully."},"204":{"description":"The resource does not exist and the request was well formed."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Delete an Asset.","tags":["Asset"]},"get":{"description":"Get an Asset by Id.","operationId":"Assets_QueryById","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Asset Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Get an Asset.","tags":["Asset"]},"patch":{"description":"Patch a specific Asset.","operationId":"Assets_Patch","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Id of the Asset to patch.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json-patch+json":{"schema":{"items":{"$ref":"#/components/schemas/JsonPatchOperation"},"type":"array","uniqueItems":false}}},"description":"The payload that is used to patch an Asset.","required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Update an Asset.","tags":["Asset"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/images/{imageId}/profiles":{"get":{"description":"If no filter is passed, the query lists all Profiles for the Image. The returned list is paginated and the count of items in each page is an optional parameter.","operationId":"Profiles_ListQuery","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Image Id.","in":"path","name":"imageId","required":true,"schema":{"type":"string"}},{"description":"The Profile name.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"The Profile description.","in":"query","name":"description","required":false,"schema":{"type":"string"}},{"description":"A set of tags with which to filter the returned models.\r\n            It is a comma separated string of tags key or tags key=value\r\n            Example: tagKey1,tagKey2,tagKey3=value3","in":"query","name":"tags","required":false,"schema":{"type":"string"}},{"description":"A set of properties with which to filter the returned models.\r\n            It is a comma separated string of properties key and/or properties key=value\r\n            Example: propKey1,propKey2,propKey3=value3","in":"query","name":"properties","required":false,"schema":{"type":"string"}},{"description":"The number of items to retrieve in a page.","in":"query","name":"count","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"The continuation token to retrieve the next page.","in":"query","name":"$skipToken","required":false,"schema":{"type":"string"}},{"description":"The option to order the response.","in":"query","name":"orderBy","required":false,"schema":{"type":"string","enum":["CreatedAtDesc","CreatedAtAsc","UpdatedAtDesc","UpdatedAtAsc"],"default":"CreatedAtDesc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedProfileResponseList"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Get a list of Image Profiles.","tags":["Profile"],"x-ms-pageable":{"nextLinkName":"nextLink"}},"post":{"description":"Create a Profile for an Image.","operationId":"Profiles_Create","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Image Id.","in":"path","name":"imageId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileRequestBase"}}},"description":"The payload that is used to create the Profile.","required":true},"responses":{"202":{"description":"The request was accepted. The header 'Operation-Location' contains the async operation location URL. Accessing this URL with a GET call will return the status of the background task."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Create a Profile.","tags":["Profile"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/images/{imageId}/profiles/{id}":{"get":{"description":"Get the Profile for an Image.","operationId":"Profiles_QueryById","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Image Id.","in":"path","name":"imageId","required":true,"schema":{"type":"string"}},{"description":"The Profile Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Get a Profile.","tags":["Profile"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/models":{"get":{"description":"The result list can be filtered using tag and name. If no filter is passed, the query lists all the Models in the given workspace. The returned list is paginated and the count of items in each page is an optional parameter.","operationId":"MLModels_ListQuery","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The object name.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"The framework.","in":"query","name":"framework","required":false,"schema":{"type":"string"}},{"description":"The object description.","in":"query","name":"description","required":false,"schema":{"type":"string"}},{"description":"The number of items to retrieve in a page.","in":"query","name":"count","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"The continuation token to retrieve the next page.","in":"query","name":"$skipToken","required":false,"schema":{"type":"string"}},{"description":"A set of tags with which to filter the returned models.\r\n            It is a comma separated string of tags key or tags key=value\r\n            Example: tagKey1,tagKey2,tagKey3=value3","in":"query","name":"tags","required":false,"schema":{"type":"string"}},{"description":"A set of properties with which to filter the returned models.\r\n            It is a comma separated string of properties key and/or properties key=value\r\n            Example: propKey1,propKey2,propKey3=value3","in":"query","name":"properties","required":false,"schema":{"type":"string"}},{"description":"The runId which created the model.","in":"query","name":"runId","required":false,"schema":{"type":"string"}},{"description":"An option to specify how the models are ordered in the response.","in":"query","name":"orderBy","required":false,"schema":{"type":"string","enum":["CreatedAtDesc","CreatedAtAsc","UpdatedAtDesc","UpdatedAtAsc"],"default":"CreatedAtDesc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedModelList"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Query the list of Models in a workspace.","tags":["Model"],"x-ms-pageable":{"nextLinkName":"nextLink"}},"post":{"description":"Register the model provided.","operationId":"MLModels_Register","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model"}}},"description":"The payload that is used to register the model.","required":true},"responses":{"200":{"description":"The model registration was successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Register a model.","tags":["Model"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/models/{id}":{"delete":{"description":"Deletes a model if it exists.","operationId":"MLModels_Delete","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The model id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The resource exists and was deleted successfully."},"204":{"description":"The resource does not exist and the request was well formed."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Delete the specified Model.","tags":["Model"]},"get":{"description":"Gets a model by model id.","operationId":"MLModels_QueryById","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The model id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Gets a model.","tags":["Model"]},"patch":{"description":"Updates an existing model with the specified patch.","operationId":"MLModels_Patch","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The model id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json-patch+json":{"schema":{"items":{"$ref":"#/components/schemas/JsonPatchOperation"},"type":"array","uniqueItems":false}}},"description":"The payload that is used to patch the model.","required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Patch a specific model.","tags":["Model"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/models/{id}/metrics":{"get":{"description":"The operational events collected for the Model are returned.","operationId":"MLModels_GetMetrics","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Model Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"The start date from which to retrieve metrics, ISO 8601 literal format.","in":"query","name":"startDate","required":false,"schema":{"type":"string"}},{"description":"The end date from which to retrieve metrics, ISO 8601 literal format.","in":"query","name":"endDate","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelOperationalState"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Retrieve the metrics for a Model.","tags":["Model"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/operations/{id}":{"get":{"description":"Get the status of an async operation by operation id.","operationId":"Operations_Get","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The operation id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncOperationStatus"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Get the status of an async operation.","tags":["Operations"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/services":{"get":{"description":"If no filter is passed, the query lists all Services in the Workspace. The returned list is paginated and the count of item in each page is an optional parameter.","operationId":"Services_ListQuery","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Image Id.","in":"query","name":"imageId","required":false,"schema":{"type":"string"}},{"description":"The Image name.","in":"query","name":"imageName","required":false,"schema":{"type":"string"}},{"description":"The Model Id.","in":"query","name":"modelId","required":false,"schema":{"type":"string"}},{"description":"The Model name.","in":"query","name":"modelName","required":false,"schema":{"type":"string"}},{"description":"The object name.","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"The number of items to retrieve in a page.","in":"query","name":"count","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"The compute environment type.","in":"query","name":"computeType","required":false,"schema":{"type":"string"}},{"description":"The continuation token to retrieve the next page.","in":"query","name":"$skipToken","required":false,"schema":{"type":"string"}},{"description":"A set of tags with which to filter the returned models.\r\n            It is a comma separated string of tags key or tags key=value\r\n            Example: tagKey1,tagKey2,tagKey3=value3","in":"query","name":"tags","required":false,"schema":{"type":"string"}},{"description":"A set of properties with which to filter the returned models.\r\n            It is a comma separated string of properties key and/or properties key=value\r\n            Example: propKey1,propKey2,propKey3=value3","in":"query","name":"properties","required":false,"schema":{"type":"string"}},{"description":"Set to True to include Model details.","in":"query","name":"expand","required":false,"schema":{"type":"boolean","default":false}},{"description":"The option to order the response.","in":"query","name":"orderby","required":false,"schema":{"type":"string","enum":["CreatedAtDesc","CreatedAtAsc","UpdatedAtDesc","UpdatedAtAsc"],"default":"UpdatedAtDesc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedServiceList"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Query the list of Services in a Workspace.","tags":["Service"],"x-ms-pageable":{"nextLinkName":"nextLink"}},"post":{"description":"Create a Service with the specified payload.","operationId":"Services_Create","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateServiceRequest"}}},"description":"The payload that is used to create the Service.","required":true},"responses":{"202":{"description":"The request was accepted.  The header 'Operation-Location' contains the async operation location URL.  Accessing this URL with a GET call will return the status of the background task."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Create a Service.","tags":["Service"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/services/{id}":{"delete":{"description":"Delete a specific Service.","operationId":"Services_Delete","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Service Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The resource exists and was deleted successfully."},"202":{"description":"Success"},"204":{"description":"The resource does not exist and the request was well formed."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Delete a Service.","tags":["Service"]},"get":{"description":"Get a Service by Id.","operationId":"Services_QueryById","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Service Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Set to True to include Model details.","in":"query","name":"expand","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceResponseBase"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Get a Service.","tags":["Service"]},"patch":{"description":"Patch a specific Service.","operationId":"Services_Patch","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Service Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json-patch+json":{"schema":{"items":{"$ref":"#/components/schemas/JsonPatchOperation"},"type":"array","uniqueItems":false}}},"description":"The payload that is used to patch the Service.","required":true},"responses":{"200":{"description":"Success"},"202":{"description":"The request was accepted.  The header 'Operation-Location' contains the async operation location URL.  Accessing this URL with a GET call will return the status of the background task."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Patch a Service.","tags":["Service"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/services/{id}/listkeys":{"post":{"description":"Gets a list of Service keys.","operationId":"Services_ListServiceKeys","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Service Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthKeys"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Lists Service keys.","tags":["Service","Keys"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/services/{id}/regenerateKeys":{"post":{"description":"Regenerate and return the Service keys.","operationId":"Services_RegenerateServiceKeys","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Service Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateServiceKeysRequest"}}},"description":"The payload that is used to regenerate keys.","required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthKeys"}}}},"202":{"description":"The request was accepted. The header 'Operation-Location' contains the async operation location URL.  Accessing this URL with a GET call will return the status of the background task."},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Regenerate Service Keys.","tags":["Service","Keys"]}},"/modelmanagement/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.MachineLearningServices/workspaces/{workspace}/services/{id}/token":{"post":{"description":"Gets access token that can be used for calling service.","operationId":"Services_GetServiceToken","parameters":[{"$ref":"#/components/parameters/subscriptionIdParameter"},{"$ref":"#/components/parameters/resourceGroupParameter"},{"$ref":"#/components/parameters/workspaceParameter"},{"description":"The Service Id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthToken"}}}},"default":{"description":"Error response describing why the operation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelErrorResponse"}}}}},"summary":"Generate Service Access Token.","tags":["Service","Token"]}}},"servers":[{"url":"https://azure.local"}],"components":{"parameters":{"resourceGroupParameter":{"description":"The Name of the resource group in which the workspace is located.","in":"path","name":"resourceGroup","required":true,"x-ms-parameter-location":"method","schema":{"type":"string"}},"subscriptionIdParameter":{"description":"The Azure Subscription ID.","in":"path","name":"subscriptionId","required":true,"x-ms-parameter-location":"method","schema":{"type":"string","format":"uuid"}},"workspaceParameter":{"description":"The name of the workspace.","in":"path","name":"workspace","required":true,"x-ms-parameter-location":"method","schema":{"type":"string"}}},"securitySchemes":{"azure_auth":{"type":"oauth2","flows":{"implicit":{"authorizationUrl":"https://login.microsoftonline.com/common/oauth2/authorize","scopes":{"user_impersonation":"impersonate your user account"}}}}},"schemas":{"ACIServiceCreateRequest":{"allOf":[{"$ref":"#/components/schemas/CreateServiceRequest"},{"properties":{"appInsightsEnabled":{"default":false,"description":"Whether or not Application Insights is enabled.","type":"boolean"},"authEnabled":{"default":false,"description":"Whether or not authentication is enabled on the service.","type":"boolean"},"cname":{"description":"The CName for the service.","type":"string"},"containerResourceRequirements":{"$ref":"#/components/schemas/ContainerResourceRequirements"},"dataCollection":{"$ref":"#/components/schemas/ModelDataCollection"},"dnsNameLabel":{"description":"The Dns label for the service.","type":"string"},"sslCertificate":{"description":"The SSL certificate to use if SSL is enabled.","type":"string"},"sslEnabled":{"default":false,"description":"Whether or not SSL is enabled.","type":"boolean"},"sslKey":{"description":"The SSL key for the certificate.","type":"string"}},"type":"object"}],"properties":{},"required":["name"],"type":"object","x-ms-discriminator-value":"ACI"},"ACIServiceResponse":{"allOf":[{"$ref":"#/components/schemas/ServiceResponseBase"},{"properties":{"appInsightsEnabled":{"description":"Whether or not Application Insights is enabled.","type":"boolean"},"authEnabled":{"description":"Whether or not authentication is enabled on the service.","type":"boolean"},"cname":{"description":"The CName for the service.","type":"string"},"containerResourceRequirements":{"$ref":"#/components/schemas/ContainerResourceRequirements"},"dataCollection":{"$ref":"#/components/schemas/ModelDataCollection"},"environment":{"$ref":"#/components/schemas/ModelEnvironmentDefinition"},"imageDetails":{"$ref":"#/components/schemas/DockerImageResponse"},"imageId":{"description":"The Id of the Image.","type":"string"},"location":{"description":"The location of the service.","type":"string"},"modelConfigMap":{"additionalProperties":{"type":"object"},"description":"Details on the models and configurations.","type":"object"},"models":{"description":"The list of models.","items":{"$ref":"#/components/schemas/Model"},"type":"array","uniqueItems":false},"publicFqdn":{"description":"The public Fqdn for the service.","type":"string"},"publicIp":{"description":"The public IP address for the service.","type":"string"},"scoringUri":{"description":"The Uri for sending scoring requests.","type":"string"},"sslCertificate":{"description":"The SSL certificate to use if SSL is enabled.","type":"string"},"sslEnabled":{"description":"Whether or not SSL is enabled.","type":"boolean"},"sslKey":{"description":"The SSL key for the certificate.","type":"string"},"swaggerUri":{"description":"The Uri for sending swagger requests.","type":"string"}},"type":"object"}],"description":"The response for an ACI service.","properties":{},"type":"object","x-ms-discriminator-value":"ACI"},"AKSEndpointResponse":{"allOf":[{"$ref":"#/components/schemas/ServiceResponseBase"},{"properties":{"aadAuthEnabled":{"description":"Whether or not AAD authentication is enabled.","type":"boolean"},"appInsightsEnabled":{"description":"Whether or not Application Insights is enabled.","type":"boolean"},"authEnabled":{"description":"Whether or not authentication is enabled.","type":"boolean"},"computeName":{"description":"The name of the compute resource.","type":"string"},"namespace":{"description":"The Kubernetes namespace of the deployment.","type":"string"},"scoringUri":{"description":"The Uri for sending scoring requests.","type":"string"},"swaggerUri":{"description":"The Uri for sending swagger requests.","type":"string"},"variants":{"description":"All the variants that belongs to this endpoint.","items":{"$ref":"#/components/schemas/AKSServiceResponse"},"type":"array","uniqueItems":false}},"type":"object"}],"description":"The response for an AKS Endpoint.","properties":{},"type":"object","x-ms-discriminator-value":"AKSENDPOINT"},"AKSReplicaStatus":{"properties":{"availableReplicas":{"description":"The number of available replicas.","example":"1","format":"int32","type":"integer"},"desiredReplicas":{"description":"The desired number of replicas.","example":"2","format":"int32","type":"integer"},"error":{"$ref":"#/components/schemas/ModelErrorResponse"},"updatedReplicas":{"description":"The number of updated replicas.","example":"1","format":"int32","type":"integer"}},"type":"object"},"AKSServiceCreateRequest":{"allOf":[{"$ref":"#/components/schemas/CreateEndpointVariantRequest"},{"properties":{"aadAuthEnabled":{"description":"Whether or not AAD authentication is enabled.","type":"boolean"},"appInsightsEnabled":{"description":"Whether or not Application Insights is enabled.","type":"boolean"},"authEnabled":{"description":"Whether or not authentication is enabled.","type":"boolean"},"autoScaler":{"$ref":"#/components/schemas/AutoScaler"},"computeName":{"description":"The name of the compute resource.","type":"string"},"containerResourceRequirements":{"$ref":"#/components/schemas/ContainerResourceRequirements"},"dataCollection":{"$ref":"#/components/schemas/ModelDataCollection"},"livenessProbeRequirements":{"$ref":"#/components/schemas/LivenessProbeRequirements"},"maxConcurrentRequestsPerContainer":{"description":"The maximum number of concurrent requests per container.","format":"int32","type":"integer"},"maxQueueWaitMs":{"description":"Maximum time a request will wait in the queue (in milliseconds). After this time, the service will return 503 (Service Unavailable)","format":"int32","type":"integer"},"namespace":{"description":"Kubernetes namespace for the service.","type":"string"},"numReplicas":{"description":"The number of replicas on the cluster.","format":"int32","type":"integer"},"scoringTimeoutMs":{"description":"The scoring timeout in milliseconds.","format":"int32","type":"integer"}},"type":"object"}],"description":"The request to create an AKS service.","properties":{},"required":["name"],"type":"object","x-ms-discriminator-value":"AKS"},"AKSServiceResponse":{"allOf":[{"$ref":"#/components/schemas/AKSVariantResponse"},{"properties":{"aadAuthEnabled":{"description":"Whether or not AAD authentication is enabled.","type":"boolean"},"appInsightsEnabled":{"description":"Whether or not Application Insights is enabled.","type":"boolean"},"authEnabled":{"description":"Whether or not authentication is enabled.","type":"boolean"},"autoScaler":{"$ref":"#/components/schemas/AutoScaler"},"computeName":{"description":"The name of the compute resource.","type":"string"},"containerResourceRequirements":{"$ref":"#/components/schemas/ContainerResourceRequirements"},"dataCollection":{"$ref":"#/components/schemas/ModelDataCollection"},"deploymentStatus":{"$ref":"#/components/schemas/AKSReplicaStatus"},"environment":{"$ref":"#/components/schemas/ModelEnvironmentDefinition"},"imageDetails":{"$ref":"#/components/schemas/ImageResponseBase"},"imageId":{"description":"The Id of the Image.","type":"string"},"livenessProbeRequirements":{"$ref":"#/components/schemas/LivenessProbeRequirements"},"maxConcurrentRequestsPerContainer":{"description":"The maximum number of concurrent requests per container.","format":"int32","type":"integer"},"maxQueueWaitMs":{"description":"Maximum time a request will wait in the queue (in milliseconds). After this time, the service will return 503 (Service Unavailable)","format":"int32","type":"integer"},"modelConfigMap":{"additionalProperties":{"type":"object"},"description":"Details on the models and configurations.","type":"object"},"models":{"description":"The list of models.","items":{"$ref":"#/components/schemas/Model"},"type":"array","uniqueItems":false},"namespace":{"description":"The Kubernetes namespace of the deployment.","type":"string"},"numReplicas":{"description":"The number of replicas on the cluster.","format":"int32","type":"integer"},"scoringTimeoutMs":{"description":"The scoring timeout in milliseconds.","format":"int32","type":"integer"},"scoringUri":{"description":"The Uri for sending scoring requests.","type":"string"},"swaggerUri":{"description":"The Uri for sending swagger requests.","type":"string"}},"type":"object"}],"description":"The response for an AKS service.","properties":{},"type":"object","x-ms-discriminator-value":"AKS"},"AKSVariantResponse":{"allOf":[{"$ref":"#/components/schemas/ServiceResponseBase"},{"properties":{"isDefault":{"description":"Is this the default variant.","type":"boolean"},"trafficPercentile":{"description":"The amount of traffic variant receives.","format":"float","type":"number"},"type":{"description":"The type of the variant.","enum":["Control","Treatment"],"type":"string","x-ms-enum":{"modelAsString":false,"name":"VariantType"}}},"type":"object"}],"description":"The response for an AKS variant.","properties":{},"type":"object"},"ArtifactDetails":{"properties":{"id":{"type":"string"},"prefix":{"type":"string"}},"type":"object"},"Asset":{"description":"The Asset definition.","properties":{"artifacts":{"description":"A list of child artifacts.","items":{"$ref":"#/components/schemas/ArtifactDetails"},"type":"array","uniqueItems":false},"createdTime":{"description":"The time the Asset was created in UTC.","format":"date-time","readOnly":true,"type":"string"},"description":{"description":"The Asset description.","type":"string"},"id":{"description":"The Asset Id.","type":"string"},"kvTags":{"additionalProperties":{"type":"string"},"description":"The Asset tag dictionary. Tags are mutable.","type":"object"},"meta":{"additionalProperties":{"type":"string"},"description":"A dictionary containing metadata about the Asset.","type":"object"},"name":{"description":"The name of the Asset.","type":"string"},"properties":{"additionalProperties":{"type":"string"},"description":"The Asset property dictionary. Properties are immutable.","type":"object"},"runid":{"description":"The RunId associated with this Asset.","type":"string"}},"required":["name"],"type":"object"},"AsyncOperationDetails":{"description":"The async operation details.","properties":{"subOperationState":{"description":"The suboperation state.","type":"string"},"subOperationType":{"description":"The suboperation type.","type":"string"}},"type":"object"},"AsyncOperationStatus":{"description":"The async operation status.","properties":{"createdTime":{"description":"The async operation creation time (UTC).","format":"date-time","type":"string"},"endTime":{"description":"The async operation end time (UTC)l","format":"date-time","type":"string"},"error":{"$ref":"#/components/schemas/ModelErrorResponse"},"id":{"description":"The async operation id.","type":"string"},"operationDetails":{"$ref":"#/components/schemas/AsyncOperationDetails"},"operationLog":{"description":"The async operation log.","type":"string"},"operationType":{"description":"The async operation type.","type":"string"},"parentRequestId":{"description":"The request id that created this operation","type":"string"},"resourceLocation":{"description":"The resource created/updated by the async operation.","type":"string"},"state":{"description":"The async operation state.","enum":["NotStarted","Running","Cancelled","Succeeded","Failed","TimedOut"],"type":"string","x-ms-enum":{"modelAsString":false,"name":"AsyncOperationState"}}},"type":"object"},"AuthKeys":{"properties":{"primaryKey":{"description":"The primary key.","type":"string"},"secondaryKey":{"description":"The secondary key.","type":"string"}},"type":"object"},"AuthToken":{"description":"Service Token","properties":{"accessToken":{"description":"Access token.","type":"string"},"expiryOn":{"description":"Access token expiry time (UTC).","format":"int64","type":"integer"},"refreshAfter":{"description":"Refresh access token after time (UTC).","format":"int64","type":"integer"},"tokenType":{"description":"Access token type.","type":"string"}},"type":"object"},"AutoScaler":{"description":"The Auto Scaler properties.","properties":{"autoscaleEnabled":{"description":"Option to enable/disable auto scaling.","type":"boolean"},"maxReplicas":{"description":"The maximum number of replicas in the cluster.","example":"3","format":"int32","type":"integer"},"minReplicas":{"description":"The minimum number of replicas to scale down to.","example":"1","format":"int32","type":"integer"},"refreshPeriodInSeconds":{"description":"The amount of seconds to wait between auto scale updates.","example":"120","format":"int32","type":"integer"},"targetUtilization":{"description":"The target utilization percentage to use for determining whether to scale the cluster.","example":"70","format":"int32","type":"integer"}},"type":"object"},"BatchServiceResponse":{"allOf":[{"$ref":"#/components/schemas/ServiceResponseBase"},{"properties":{"appInsightsEnabled":{"type":"boolean"},"computeName":{"type":"string"},"entryScript":{"type":"string"},"environmentName":{"type":"string"},"environmentVersion":{"type":"string"},"errorThreshold":{"format":"double","type":"number"},"inputFormat":{"type":"string"},"miniBatchSize":{"format":"int32","type":"integer"},"modelDataCollection":{"$ref":"#/components/schemas/ModelDataCollection"},"modelIds":{"items":{"type":"string"},"type":"array","uniqueItems":false},"nodeCount":{"format":"int32","type":"integer"},"outputAction":{"type":"string"},"processCountPerNode":{"format":"int32","type":"integer"},"scoringUri":{"type":"string"}},"type":"object"}],"properties":{},"type":"object","x-ms-discriminator-value":"AMLCOMPUTE"},"ContainerRegistry":{"properties":{"address":{"type":"string"},"password":{"type":"string"},"username":{"type":"string"}},"type":"object"},"ContainerResourceRequirements":{"description":"The resource requirements for the container (cpu and memory).","properties":{"cpu":{"description":"The number of CPU cores on the container.","example":"4","format":"double","type":"number"},"fpga":{"description":"The number of FPGA PCIE devices exposed to the container. Must be multiple of 2.","format":"int32","type":"integer"},"gpu":{"description":"The number of GPU cores in the container.","format":"int32","type":"integer"},"memoryInGB":{"description":"The amount of memory on the container in GB.","example":"64","format":"double","type":"number"}},"type":"object"},"CreateEndpointRequest":{"allOf":[{"$ref":"#/components/schemas/CreateServiceRequest"},{"properties":{"aadAuthEnabled":{"description":"Whether or not AAD authentication is enabled.","type":"boolean"},"appInsightsEnabled":{"description":"Whether or not Application Insights is enabled.","type":"boolean"},"authEnabled":{"description":"Whether or not authentication is enabled.","type":"boolean"},"computeName":{"description":"The name of the compute resource.","type":"string"},"namespace":{"description":"Kubernetes namespace for the service.","type":"string"},"variants":{"description":"The service tag list.","items":{"$ref":"#/components/schemas/AKSServiceCreateRequest"},"type":"array","uniqueItems":false}},"type":"object"}],"description":"The request to create an Endpoint in the AKS.","properties":{},"required":["name"],"type":"object","x-ms-discriminator-value":"AKSENDPOINT"},"CreateEndpointVariantRequest":{"allOf":[{"$ref":"#/components/schemas/CreateServiceRequest"},{"properties":{"isDefault":{"description":"Is this the default variant.","type":"boolean"},"trafficPercentile":{"description":"The amount of traffic variant receives.","format":"float","type":"number"},"type":{"description":"The type of the variant.","enum":["Control","Treatment"],"type":"string","x-ms-enum":{"modelAsString":false,"name":"VariantType"}}},"type":"object"}],"description":"The Variant properties.","properties":{},"required":["name"],"type":"object"},"CreateIotServiceRequest":{"allOf":[{"$ref":"#/components/schemas/CreateServiceRequest"},{"properties":{"acrCredentials":{"items":{"$ref":"#/components/schemas/RegistryInfo"},"type":"array","uniqueItems":false},"authEnabled":{"type":"boolean"},"computeName":{"type":"string"},"iotDeviceId":{"type":"string"},"iotEdgeModule":{"$ref":"#/components/schemas/IotBaseModuleSettings"},"iotEdgeUserModule":{"items":{"$ref":"#/components/schemas/IotModuleSettings"},"type":"array","uniqueItems":false},"routes":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}],"properties":{},"required":["name"],"type":"object","x-ms-discriminator-value":"IOT"},"CreateServiceRequest":{"description":"The base class for creating a service.","discriminator":{"propertyName":"computeType"},"properties":{"computeType":{"description":"The compute environment type for the service.","enum":["ACI","AKS","AMLCOMPUTE","IOT","AKSENDPOINT","UNKNOWN"],"example":"AKS","type":"string","x-ms-enum":{"modelAsString":false,"name":"ComputeEnvironmentType"}},"deploymentType":{"description":"The deployment type for the service.","enum":["GRPCRealtimeEndpoint","HttpRealtimeEndpoint","Batch"],"example":"HttpRealtimeEndpoint","type":"string","x-ms-enum":{"modelAsString":false,"name":"DeploymentType"}},"description":{"description":"The description of the service.","type":"string"},"environmentImageRequest":{"$ref":"#/components/schemas/EnvironmentImageRequest"},"imageId":{"description":"The Image Id.","type":"string"},"keys":{"$ref":"#/components/schemas/AuthKeys"},"kvTags":{"additionalProperties":{"type":"string"},"description":"The service tag dictionary. Tags are mutable.","type":"object"},"location":{"description":"The location of the service.","type":"string"},"name":{"description":"The service name.","type":"string"},"properties":{"additionalProperties":{"type":"string"},"description":"The service properties dictionary. Properties are immutable.","type":"object"}},"required":["name","computeType"],"type":"object"},"DatasetReference":{"description":"The dataset reference object.","properties":{"id":{"description":"The id of the dataset reference.","type":"string"},"name":{"description":"The name of the dataset reference.","type":"string"}},"type":"object"},"DeploymentSummary":{"description":"The deployment summary.","properties":{"successfulDeployments":{"description":"The number of successful deployments.","format":"int32","type":"integer"},"unsuccessfulDeployments":{"description":"The number of unsuccessful deployments.","format":"int32","type":"integer"}},"type":"object"},"DockerImageResponse":{"allOf":[{"$ref":"#/components/schemas/ImageResponseBase"},{"properties":{"assets":{"description":"The list of assets.","items":{"$ref":"#/components/schemas/EnvironmentImageAsset"},"type":"array","uniqueItems":false},"dockerFileUri":{"description":"The Uri to the docker file.","type":"string"},"driverProgram":{"description":"The name of the driver file.","type":"string"},"generatedDockerFileUri":{"description":"The Uri to the generated docker file.","type":"string"},"targetRuntime":{"$ref":"#/components/schemas/TargetRuntime"}},"type":"object"}],"properties":{},"type":"object","x-ms-discriminator-value":"WEBAPICONTAINER"},"EnvironmentImageAsset":{"description":"An Image asset.","properties":{"id":{"description":"The Asset Id.","type":"string"},"mimeType":{"description":"The mime type.","type":"string"},"unpack":{"description":"Whether the Asset is unpacked.","type":"boolean"},"url":{"description":"The Url of the Asset.","type":"string"}},"type":"object"},"EnvironmentImageRequest":{"description":"Request to create a Docker image based on Environment.","properties":{"assets":{"description":"The list of assets.","items":{"$ref":"#/components/schemas/EnvironmentImageAsset"},"type":"array","uniqueItems":false},"driverProgram":{"description":"The name of the driver file.","type":"string"},"environment":{"$ref":"#/components/schemas/ModelEnvironmentDefinition"},"modelIds":{"description":"The list of model Ids.","example":"[mymodel:1, mymodel:2]","items":{"type":"string"