Required. The resource name of the Location from which to recommend specs. The users must have permission to make a call in the project. Format:projects/{project}/locations/{location}.
Request body
The request body contains data with the following structure:
Fields
gcsUristring
Required. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model).
checkMachineAvailabilityboolean
Optional. If true, check machine availability for the recommended regions. Only return the machine spec in regions where the machine is available.
checkUserQuotaboolean
Optional. If true, check user quota for the recommended regions. Returns all the machine spec in regions they are available, and also the user quota state for each machine type in each region.
Recommendation of one deployment option for the given custom weights model in one region. Contains the machine and container spec, and user accelerator quota state.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-21 UTC."],[],[],null,["# Method: locations.recommendSpec\n\n**Full name**: projects.locations.recommendSpec\n\nGets a Model's spec recommendations. This API is called by UI, SDK, and internal. \n\n### Endpoint\n\npost `https:``/``/{service-endpoint}``/v1beta1``/{parent}:recommendSpec` \nWhere `{service-endpoint}` is one of the [supported service endpoints](/vertex-ai/docs/reference/rest#rest_endpoints).\n\n### Path parameters\n\n`parent` `string` \nRequired. The resource name of the Location from which to recommend specs. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`.\n\n### Request body\n\nThe request body contains data with the following structure:\nFields `gcsUri` `string` \nRequired. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model).\n`checkMachineAvailability` `boolean` \nOptional. If true, check machine availability for the recommended regions. Only return the machine spec in regions where the machine is available.\n`checkUserQuota` `boolean` \nOptional. If true, check user quota for the recommended regions. Returns all the machine spec in regions they are available, and also the user quota state for each machine type in each region. \n\n### Response body\n\nResponse message for [ModelService.RecommendSpec](/vertex-ai/docs/reference/rest/v1beta1/projects.locations/recommendSpec#google.cloud.aiplatform.v1beta1.ModelService.RecommendSpec).\n\nIf successful, the response body contains data with the following structure:\nFields `baseModel` `string` \nOutput only. The base model used to finetune the custom model.\n`recommendations[]` `object (`[Recommendation](/vertex-ai/docs/reference/rest/v1beta1/projects.locations/recommendSpec#Recommendation)`)` \nOutput only. Recommendations of deployment options for the given custom weights model.\n`specs[]` `object (`[MachineAndModelContainerSpec](/vertex-ai/docs/reference/rest/v1beta1/projects.locations/recommendSpec#MachineAndModelContainerSpec)`)` \nOutput only. The machine and model container specs. \n\nRecommendation\n--------------\n\nRecommendation of one deployment option for the given custom weights model in one region. Contains the machine and container spec, and user accelerator quota state.\nFields `region` `string` \nThe region for the deployment spec (machine).\n`spec` `object (`[MachineAndModelContainerSpec](/vertex-ai/docs/reference/rest/v1beta1/projects.locations/recommendSpec#MachineAndModelContainerSpec)`)` \nOutput only. The machine and model container specs.\n`userQuotaState` `enum (`[QuotaState](/vertex-ai/docs/reference/rest/v1beta1/projects.locations/recommendSpec#QuotaState)`)` \nOutput only. The user accelerator quota state. \n\nMachineAndModelContainerSpec\n----------------------------\n\nA machine and model container spec.\nFields `machineSpec` `object (`[MachineSpec](/vertex-ai/docs/reference/rest/v1beta1/MachineSpec)`)` \nOutput only. The machine spec.\n`containerSpec` `object (`[ModelContainerSpec](/vertex-ai/docs/reference/rest/v1beta1/ModelContainerSpec)`)` \nOutput only. The model container spec. \n\nQuotaState\n----------\n\nThe user accelerator quota state."]]
