Publish a Staged Data Source

Article
06/14/2022

Use the following URL to publish a staged data source.

A job is created when you publish a staged a data source. Before using this API, review the job limits in Geocode and Data Source Limits.

Supported HTTP Methods

GET

URL Template

Note

This template supports both HTTP and HTTPS protocols. URLs in the response use HTTPS protocol.

Make sure you review the job limits defined in Geocode and Data Source Limits.

Publish a staged data source

This URL will publish a staged data source that was created by setting loadOperation=completeStaged or incrementalStaging when you created a Load Data Source Job.

http://spatial.virtualearth.net/REST/v1/data/accessId/dataSourceName/$commit?output=output&key=masterKey

Get status to determine when the publish is complete

After you start the publishing process, you can check status using the URL provided in the response to the publish request. When the staged data source is published and available to query, the Status field in the $getstatus response is set to Completed. The status URL has the following structure.

http://spatial.virtualearth.net/REST/v1/data/jobs/publishJobId/$getstatus?output=output&key=masterKey

Template Parameters

Note

Parameter names and values are not case-sensitive except for the key parameter value.

Parameter	Alias	Description	Values
accessId		Required. A unique ID for the data source.	You can retrieve the query URL that contains the accessId and dataSourceName values when you Get Data Source Information for all data sources or from you Get Load Data Source Status for the completed job that staged the data. Example: a92dcfac8a0894bc4921ad5c74022623.
dataSourceName		Required The name of the data source.	You can retrieve the query URL that contains the accessId and dataSourceName values when you Get Data Source Information for all data sources or from you Get Load Data Source Status for the completed job that staged the data. Example: MyDataSourceName
key		Required. The master key for the data source.	The Bing Maps Key that was specified as the master key for the data source. For more information, see Create a Load Data Source Job.
output	o	Optional. The output format for the response.	One of the following values: - json [default] - xml Example: o=xml

Response

This URL supports the following response formats.

JSON: application/json
XML: application/xml

Examples

EXAMPLE: Publish a staged data source.

http://spatial.virtualearth.net/REST/v1/data/12ccc26d9e9412345f94922212345/MyDataSourceName/$commit?o=xml&key=MyDataSourceMasterKey

XML Response

This URL will return a response similar to the following example.

<?xml version="1.0" encoding="UTF-8"?>  
<Response xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
  <Copyright>Copyright © 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.</Copyright>  
  <BrandLogoUri>http://spatial.virtualearth.net/Branding/logo_powered_by.png</BrandLogoUri>  
  <StatusCode>202</StatusCode>  
  <StatusDescription>Accepted</StatusDescription>  
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>  
  <TraceId>21db26ff791144738230a9cf2cc9ff6aTraceId>  
  <ResourceSets>  
    <ResourceSet>  
      <EstimatedTotal>1</EstimatedTotal>  
      <Resources>  
        <DataServiceJob>  
          <Id>3627f4ab4882498074e79cda29f3a</Id>  
          <Link role="self">https://spatial.virtualearth.net/REST/v1/data/jobs/3627f4ab4882498074e79cda29f3a/$getstatus</Link>  
          <Description>DataSourcePublishFromStaged</Description>  
          <Status>Accepted</Status>  
          <CreatedDate>2013-02-25T11:26:32.2843589-08:00</CreatedDate>  
          <CompletedDate xsi:nil="true"/>  
        </DataServiceJob>  
      </Resources>  
    </ResourceSet>  
  </ResourceSets>  
</Response>

JSON Response

If o=xml was not specified in the response, a JSON response similar to the following example is returned.

{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"http:\/\/spatial.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright 2013 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"DataServiceJob:http:\/\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "id":"3627f4ab4882498074e79cda29f3a",  
               "links":[  
                  {  
                     "role":"self",  
                     "url":"https:\/\/spatial.virtualearth.net\/REST\/v1\/data\/jobs\/3627f4ab4882498074e79cda29f3a\/$getstatus"  
                  }  
               ],  
               "createdDate":"Mon, 25 Feb 2013 19:27:54 GMT",  
               "description":"DataSourcePublishFromStaged",  
               "status":"Accepted"  
            }  
         ]  
      }  
   ],  
   "statusCode":202,  
   "statusDescription":"Accepted",  
   "traceId":"e60b410fdbe845f3a1337f4f54f16e98"  
}

Example: Get the status of the DataSourcePublishFromStaged data source job. When the Status is set to Completed, the staged data source is successfully published. Not that this URL is from the response in the previous example with the master key added.

https://spatial.virtualearth.net/REST/v1/data/jobs/3627f4ab4882498074e79cda29f3a/$getstatus?key=masterKey