Get Package
Updated: November 29, 2012
The Get Package operation retrieves a cloud service package for a deployment and stores the package files in Windows Azure Blob storage.
The following package files are placed in storage:
-
Service configuration file - The cloud service configuration file (.cscfg) provides configuration settings for the cloud service and individual roles, including the number of role instances.
-
Service package - The service package (.cspkg) contains the application code and the service definition file.
For more information about using the cloud service package, see How to Create and Deploy a Cloud Service.
For more information about using Blob Storage, see How to use the Windows Azure Blob Storage Service in .NET and Naming and Referencing Containers, Blobs, and Metadata.
Request
The Get Package request may be specified as follows. Replace <subscription-id> with your subscription ID, <cloudservice-name> with the name of your cloud service, <deployment-name> with the name of your deployment, and <container-uri> with the URI of the container to store the package information.
| POST Method Request URI | HTTP Version |
|---|---|
|
|
HTTP/1.1 |
|
|
HTTP/1.1 |
URI Parameters
| URI Parameter | Description |
|---|---|
|
containerUri=<container-uri> |
Required. Specifies the URI of the container to which the packages will be saved. |
|
overwriteExisting=<overwriteExisting> |
Optional. Specifies whether an existing package in the storage container should be overwritten. If true the packages with the same names under the specified storage container will be overwritten; otherwise false. |
Request Headers
The following table describes the request headers.
| Request Header | Description |
|---|---|
|
x-ms-version |
Required. Specifies the version of the operation to use for this request. This header should be set to 2012-03-01 or later. For more information about versioning headers, see Service Management Versioning. |
Request Body
None.
Response
The response includes an HTTP status code and a set of response headers.
Status Code
A successful operation returns status code 202 (Accepted). For information about status codes, see Service Management Status and Error Codes.
Response Headers
The response for this operation includes the following headers. The response may also include additional standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.
| Response Header | Description |
|---|---|
|
x-ms-request-id |
A value that uniquely identifies a request made against the management service. |
Response Body
None.
Authorization
Any management certificate associated with the subscription specified by <subscription-id> can be used to authenticate this operation. For additional details, see Authenticating Service Management Requests.
Remarks
None.