Get Affinity Group Properties
Atualizado: julho de 2011
The Get Affinity Group Properties operation returns the system properties associated with the specified affinity group.
The Get Affinity Group Properties request may be specified as follows. Replace <subscription-id> with your subscription ID, and <affinity-group-name> with the name of the desired affinity group:
| Method | Request URI | HTTP Version |
|---|---|---|
|
GET |
|
HTTP/1.1 |
None.
The following table describes required and optional 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 2009-10-01 or later. For more information about versioning headers, see Service Management Versioning. |
None.
The response includes an HTTP status code, a set of response headers, and a response body.
A successful operation returns status code 200 (OK).
For information about status codes, see Service Management Status and Error Codes.
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. |
The format of the response body is as follows:
<?xml version="1.0" encoding="utf-8"?>
<AffinityGroup xmlns="http://schemas.microsoft.com/windowsazure">
<Label>base64-encoded-label</Label>
<Description>description</Description>
<Location>location</Location>
<HostedServices>
<HostedService>
<Url>hosted-service-address</Url>
<ServiceName>hosted-service-name</ServiceName>
</HostedService>
</HostedServices>
<StorageServices>
<StorageService>
<Url>storage-account-address</Url>
<ServiceName>storage-account-name</ServiceName>
</StorageService>
</StorageServices>
</AffinityGroup>
The following table describes the key elements of the response body:
| Element name | Description |
|---|---|
|
Label |
The base-64 encoded label of the affinity group. |
|
Description |
The user supplied description of this affinity group. |
|
Location |
The location of the data center that the affinity group is associated with. |
|
HostedServices |
Encapsulates a list of hosted services associated with the specified affinity group. |
|
HostedService |
Encapsulates the properties of a specific hosted service associated with the affinity group. |
|
Url |
The URL used to make service management API calls against the hosted service. |
|
ServiceName |
The name of the hosted service. |
|
StorageServices |
Encapsulates a list of storage accounts associated with the specified affinity group. |
|
StorageService |
Encapsulates the properties of a specific hosted service associated with the affinity group. |
|
Url |
The URL used to make service management API calls against the storage account. |
|
ServiceName |
The name of the storage account. |
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.
None.