[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen

Get Marker By ID

Description

Get Marker by image id and marker id.

Request

Request

URL

URL


get
https://cloud.vmwarehorizon.com/imagemgmt/v1/images/{imageId}/markers/{markerId}
Copy

Path Parameters

Path Parameters

string
imageId Required

imageId


string
markerId Required

markerId


Query Parameters

Query Parameters

string
org_id Optional

org_id


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns MarkerTO of type application/json

Successfully retrieved marker

{
    "errorCode": "UPDATES_FAILED",
    "id": "0123456789",
    "imageId": "0123456789",
    "name": "HRLite,HRPro",
    "nextVersionId": "0123456789",
    "orgId": "0123456789",
    "status": "IN_PROGRESS",
    "versionId": "0123456789"
}
string as date-time
createdAt Optional

Timestamp of record creation


string
errorCode Optional

Error code for failed Asset

Possible values are: ADMIN_TEMPLATE_CREATION_CALL_FAILEDADMIN_TEMPLATE_DELETION_CALL_FAILEDAGENT_DETAILS_FETCH_FAILEDAGENT_FEATURES_VERIFICATION_FAILEDAGENT_INSTALL_TYPE_NOT_FOUNDAIMS_CLONE_CALL_FAILEDAIMS_COPY_CALL_FAILEDAIMS_DELETE_ASSET_CALL_FAILEDAIMS_DELETE_ASSET_FAILEDAIMS_IMPORT_CALL_FAILEDAIMS_POST_VALIDATION_CLEANUP_CALL_FAILEDAIMS_PUBLISH_CALL_FAILEDAIMS_REPUBLISH_CALL_FAILEDAPPLICATION_SCAN_DETAILS_MISSINGAPPLICATION_SCAN_IS_NOT_APPLICABLEAZURE_CONNECTION_FAILEDAZURE_FAILED_TO_ALLOW_RDP_AND_ENABLE_RDSAZURE_FAILED_TO_AllOW_RDPAZURE_FAILED_TO_COPY_SIG_IMAGE_VERSIONAZURE_FAILED_TO_CREATE_IMAGE_IN_SIGAZURE_FAILED_TO_CREATE_MANAGED_DISKAZURE_FAILED_TO_CREATE_NETWORK_SECURITY_GROUPAZURE_FAILED_TO_CREATE_PUBLIC_IPAZURE_FAILED_TO_CREATE_RESOURCE_GROUPAZURE_FAILED_TO_CREATE_SIGAZURE_FAILED_TO_CREATE_SNAPSHOTAZURE_FAILED_TO_DEALLOCATE_VMAZURE_FAILED_TO_DELETE_CUSTOM_SCRIPT_EXTENSIONAZURE_FAILED_TO_DELETE_SIG_IMAGE_VERSIONAZURE_FAILED_TO_DELETE_SNAPSHOTAZURE_FAILED_TO_DELETE_VMAZURE_FAILED_TO_FETCH_SIG_IMAGE_DETAILSAZURE_FAILED_TO_FETCH_SIG_IMAGE_VERSIONAZURE_FAILED_TO_GENERALIZE_VMAZURE_FAILED_TO_GET_AGENT_STATUSAZURE_FAILED_TO_GET_NSGAZURE_FAILED_TO_INITIATE_SIG_REPLICATIONAZURE_FAILED_TO_PROVISION_VMAZURE_FAILED_TO_REPLICATION_IMAGEAZURE_FAILED_TO_RESTART_VMAZURE_FAILED_TO_RUN_SYSPREP_ON_VMAZURE_INVALID_SIG_ID_FORMATAZURE_NETWORK_NOT_FOUNDAZURE_RESOURCE_NOT_FOUNDAZURE_SUBNET_NOT_FOUNDAZURE_VM_GENERATION_NOT_SUPPORTEDAZURE_VM_INVALID_AGENT_STATEAZURE_VM_INVALID_POWER_STATEAZURE_VM_NOT_FOUNDBAD_REQUESTCREDENTIALS_DELETE_FAILEDCREDENTIALS_FETCH_FAILEDCREDENTIALS_NOT_FOUNDCREDENTIAL_CREATION_FAILEDCREDENTIAL_ID_MISSINGDELETE_STREAM_NOT_SUPPORTEDEDGE_DEPLOYMENT_NOT_FOUNDFAILED_TIME_OUTFAILED_TO_FETCH_LOCATIONFAILED_TO_INSTALL_AGENTFORBIDDENGOLDPATTERN_INVALID_DATAGOLDPATTERN_MISSING_FIELDSHOC_EVENT_FAILUREHORIZON_AGENT_FEATURES_MISSINGILLEGAL_SOURCE_TYPE_FOR_GIVEN_PROVIDERIMAGE_ALREADY_EXISTSIMAGE_DISCOVERY_FAILEDIMAGE_DISCOVERY_TIME_OUTIMAGE_EVENT_VALIDATION_FAILEDINFRASTRUCTURE_DETAILS_MISSINGINITATE_IMAGE_IMPORT_FAILEDINITIATE_ADD_VERSION_FAILEDINITIATE_VALIDATE_VERSION_FAILEDINITIATE_VERSION_PUBLISH_FAILEDINITIATE_VERSION_REPUBLISH_FAILEDINVALID_GPU_TYPEINVALID_ORG_IDINVALID_OS_CUSTOMIZATION_OPTIONINVALID_OS_TYPEINVALID_PUBLISH_FLOW_STEPINVALID_REQUEST_FORMATINVALID_RESOURCE_STATEINVALID_SEARCH_USAGEINVALID_TASK_STATUSINVALID_VERSION_TYPEMARKER_DELETION_VALIDATION_FAILEDMARKER_MOVEMENT_CALL_FAILEDMARKER_MOVEMENT_PARTIALLY_SUCCEEDEDMARKER_UPDATION_NOT_SUPPORTEDPERMISSION_MISSINGPROVIDER_INSTANCE_FETCH_FAILEDPROVIDER_INSTANCE_NOT_OF_SAME_ORGPROVIDER_LABEL_MISSINGPUBLISH_WITH_RESILIENCY_NOT_ENABLEDPUBLISH_WITH_RESILIENCY_SHOULD_BE_ENABLEDRBAC_ACCESS_REQUIREDREQUEST_REJECTEDRESOURCE_ALREADY_EXISTSRESOURCE_CLEANUP_FROM_PROVIDER_FAILEDRESOURCE_DELETE_FROM_DB_FAILEDRESOURCE_FETCH_FROM_DB_FAILEDRESOURCE_FETCH_FROM_UPSTREAM_FAILEDRESOURCE_NOT_FOUNDRESOURCE_SAVE_TO_DB_FAILEDRETRY_AGENT_INSTALLSIMULATED_EXCEPTIONSOURCE_TARGET_REGION_MISMATCHTEMPLATE_ERROR_EVENTTEMPLATE_FAILED_TO_FETCH_VMTEMPLATE_ID_NOT_FOUNDTEMPLATE_NO_VM_EXISTSTEMPLATE_PROVIDER_LABEL_NOT_FOUNDTEMPLATE_STATUS_NOT_FOUNDUNKNOWN_EXCEPTIONUNSUPPORTED_COLLECTION_FOR_LOCATIONUNSUPPORTED_EXCEPTIONUNSUPPORTED_METHODUNSUPPORTED_OPERATIONUNSUPPORTED_PROVIDERVALIDATION_FAILEDVERSION_IN_USEVERSION_IN_USE_AS_CLONE_SOURCEVERSION_PATCHING_FAILEDVM_COMPUTE_SKUS_FETCH_FAILED


string
errorDetails Optional

Specific error details based on the failure


map of string
errorDetailsParameters Optional

The parameters for the error detail.


string
id Optional

Unique record ID


string
imageId Optional

Image ID this marker is associated with


string as ^[A-Za-z0-9_-]*$
name Optional

Name of this marker


string
nextVersionId Optional

The next Version ID this marker is being moved to


string
orgId Optional

Org ID that owns this record


string
status Optional

Indicates the status of the marker based on its stage during marker movement workflow

Possible values are: IN_PROGRESSUPDATES_COMPLETEDUPDATES_FAILEDUPDATES_INITIATEDUPDATES_PARTIALLY_COMPLETEDVALIDATION_COMPLETEDVALIDATION_FAILED


integer as int64
templateCount Optional

Number of templates this marker associated with this marker.


string as date-time
updatedAt Optional

Timestamp of last record modification


string
versionId Optional

Version ID this marker is associated with

Errors

Errors

ErrorResponse
401

Unauthorized


ErrorResponse
403

Forbidden


ErrorResponse
404

Unable to find marker for given imageId and markerId

Code Samples

Code Samples

cURL Command

curl https://cloud.vmwarehorizon.com/imagemgmt/v1/images/{imageId}/markers/{markerId}


[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen
Feedback

Was this page helpful?