此主题尚未评级 - 评价此主题

Addressing Service Management Resources

更新时间: 2010年11月

The Service Management API exposes the following resources for managing your services and deployments:

  • Subscription. A subscription is an account on the Management Portal.

  • Storage Account. An account for accessing the Windows Azure storage services, unique to this subscription. A subscription may have zero or more storage accounts.

  • Hosted Service. A container for service deployments in Windows Azure. A subscription may have zero or more hosted services.

  • Deployment. A service that is running on Windows Azure. A deployment may be running in either the staging or production deployment environment. It may be managed either by referencing its deployment ID, or by referencing the deployment environment in which it's running.

  • Deployment Environment. A named environment to which a deployment can be made. The available deployment environments are staging and production.

  • Certificate. A certificate within the Windows Azure certificate store for a subscription.

  • Location. A geographical region in which a service or storage account will be hosted.

  • Affinity Group. A grouping of services and storage accounts within a subscription according to geo-location, for performance benefits.

  • Operation. A request submitted to the Service Management API. For operations that are asynchronous, this resource can be used to track operation status.

  • Operating Systems. The set of guest operating system versions currently supported in Windows Azure.

The base URI for the management service is:

https://management.core.windows.net

Note that all operations in the Service Management API are made over SSL and so must use the HTTPS protocol.

Every call to the Service Management API must include the subscription ID for your subscription. The subscription ID is appended to the base URI, as follows:

https://management.core.windows.net/<subscriptionId>
note说明
The Service Management API does not include any operations that act on the subscription resource directly.

The URI for the collection of storage accounts beneath a subscription is:

https://management.core.windows.net/<subscriptionId>/services/storageservices

The URI for a specific storage account is:

https://management.core.windows.net/<subscriptionId>/services/storageservices/<storageservice>

The API operations shown in the following table are performed against a storage account or the collection of storage accounts:

 

Operation Description

List Storage Accounts

Lists the storage accounts available under the current subscription.

Get Storage Account Properties

Returns the system properties for the specified storage account.

Get Storage Account Keys

Returns the primary and secondary access keys for the specified storage account.

Regenerate Storage Account Keys

Regenerates the primary or secondary access key for the specified storage account.

The URI for the collection of hosted services beneath a subscription is:

https://management.core.windows.net/<subscriptionId>/services/hostedservices

The URI for a specific hosted service is:

https://management.core.windows.net/<subscriptionId>/services/hostedservices/<serviceName>

The API operations shown in the following table are performed against a hosted service or the collection of hosted services:

 

Operation Description

List Hosted Services

Lists the hosted services available under the current subscription.

Create Hosted Service

Creates a new hosted service within the subscription.

Update Hosted Service

Updates the label and/or description for a hosted service.

Delete Hosted Service

Deletes a hosted service from this subscription.

Get Hosted Service Properties

Returns system properties for the specified hosted service.

Swap Deployment

Initiates a virtual IP swap between the staging and production deployment environments for a service.

The URI for a specific deployment is:

https://management.core.windows.net/<subscriptionId>/services/hostedservices/<serviceName>/deployments/<deploymentname>

The API operations shown in the following table may be performed against a deployment resource:

 

Operation Description

Get Deployment

Returns configuration information, status, and system properties for the specified deployment.

Delete Deployment

Deletes the specified deployment

Change Deployment Configuration

Initiates a change to the deployment configuration.

Update Deployment Status

Initiates a change in deployment status.

Upgrade Deployment

Initiates an upgrade.

Walk Upgrade Domain

Specifies the next upgrade domain to be walked

Reboot Role Instance

Requests a reboot of a role instance that is running in a deployment.

Reimage Role Instance

Requests a reimage of a role instance that is running in a deployment.

The URI for the staging deployment environment is:

https://management.core.windows.net/<subscriptionId>/services/hostedservices/<serviceName>/deploymentslots/staging

The URI for the production deployment environment is:

https://management.core.windows.net/<subscriptionId>/services/hostedservices/<serviceName>/deploymentslots/production

The API operations shown in the following table may be performed against a deployment environment resource:

 

Operation Description

Create Deployment

Uploads a new service package to staging or to production.

Get Deployment

Returns configuration information, status, and system properties for the specified deployment.

Delete Deployment

Deletes the specified deployment

Change Deployment Configuration

Initiates a change to the deployment configuration.

Update Deployment Status

Initiates a change in deployment status.

Upgrade Deployment

Initiates an upgrade.

Walk Upgrade Domain

Specifies the next upgrade domain to be walked.

Reboot Role Instance

Requests a reboot of a role instance that is running in a deployment.

Reimage Role Instance

Requests a reimage of a role instance that is running in a deployment.

The URI for the collection of certificates associated with a subscription is:

https://admin.core.windows.net/<subscription-id>/services/hostedservices/<service-name>/certificates

The URI for a specific certificate is:

https://admin.core.windows.net/<subscription-id>/services/hostedservices/<service-name>/certificates/<thumbprint-algorithm>-<thumbprint-in-hex>

The API operations shown in the following table are performed against a certificate or the collection of certificates:

 

Operation Description

List Certificates

Lists the certificates associated with the specified subscription.

Get Certificate

Returns the public data for the specified certificate.

Add Certificate

Adds a certificate to the subscription.

Delete Certificate

Deletes a certificate from the subscription.

The URI for the collection of affinity groups associated with a subscription is:

https://management.core.windows.net/<subscriptionId>/affinitygroups

The URI for a specific affinity group is:

https://management.core.windows.net/<subscriptionId>/affinitygroups/<affinitygroupname>

The API operations shown in the following table are performed against an affinity group or the collection of affinity groups:

 

Operation Description

List Affinity Groups

Lists the affinity groups associated with the specified subscription.

Get Affinity Group Properties

Returns the system properties associated with the specified affinity group.

The URI for the collection of data center locations associated with a subscription is:

https://management.core.windows.net/<subscriptionId>/locations

The API operations shown in the following table are performed against the collection of locations:

 

Operation Description

List Locations

Lists the data center locations associated with the specified subscription.

The URI for referencing a request that has been made against the management service is:

https://management.core.windows.net/<subscriptionId>/operations/<operationId>

The API operation shown in the following table is performed against an operation resource:

 

Operation Description

Get Operation Status

Returns the status of the specified operation. Use to determine whether an asynchronous operation has succeed, failed, or is still in progress.

The URI for listing the set of guest operating system versions available in Windows Azure is:

https://management.core.windows.net/<subscriptionId>/operatingsystems

The URI for listing the set of operating system families available in Windows Azure is:

https://management.core.windows.net/<subscriptionId>/operatingsystemfamilies

The related API operations are shown in the following table:

 

Operation Description

List Operating Systems

Returns the set of guest operating system versions currently supported in Windows Azure.

List Operating System Families

Returns the set of operating system families supported in Windows Azure, and the available operating system versions for each family.

请参见

本文是否对您有所帮助?
(1500 个剩余字符)

社区附加资源

© 2013 Microsoft. 版权所有。
facebook page visit twitter rss feed newsletter