SalesBuy
1-855-856-7678
Technical SupportSupport
Get Profile
Updated: February 4, 2012
[This topic contains preliminary content for the current release of Windows Azure.]
The Get Profile operation returns profile details, including all definition versions and their statuses.
Request
Replace <subscription-id> with your subscription ID and <profile-name> with your profile name, for example myapp-trafficmanager-net is an example of <profile-name>. For more information on Windows Azure Traffic Manager, see Managing and Load Balancing Incoming Traffic with Windows Azure Traffic Manager.
| Method | Request URI | HTTP Version |
|---|---|---|
|
GET |
https://management.core.windows.net/<subscription-id>/services/WATM/profiles/<profile-name> |
HTTP/1.1 |
URI Parameters
None.
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 2011-10-01 or later. For more information about versioning headers, see Service Management Versioning. |
Request Body
None.
Response
The response includes an HTTP status code, a set of response headers, and a response body.
Status Code
HTTP 200 (OK), if successful. 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
The format of the response body is as follows:
<Profile xmlns="http://schemas.microsoft.com/windowsazure">
<DomainName>domain-name-for-the-profile</DomainName>
<Name>profile-name</Name>
<Status>Enabled|Disabled</Status>
<StatusDetails>
<EnabledVersion>enabled-definition-version-number</EnabledVersion>
</StatusDetails>
<Definitions>
<Definition>
<Status>Enabled|Disabled</Status>
<Version>definition-version-number</Version>
</Definition>
...
</Definitions>
</Profile>
| Element Name | Description |
|---|---|
|
Domain Name |
The domain name, as specified during the creation of the profile. |
|
Name |
The profile name, as specified during the creation of the profile. |
|
Status |
Indicates whether a definition of the specified profile is enabled or disabled in Windows Azure Traffic Manager. Possible values are:
|
|
EnabledVersion |
When defined as part of the StatusDetails, indicates the version of the policy definition that is enabled. When defined as part of a Definition, indicates the version of the policy definition. |
|
Definitions |
Encapsulates a list of all definition versions created for the specified profile, along with their statuses. Only one definition version can be enabled for a profile at a time. |
Sample Response
<?xml version="1.0" encoding="utf-8"?> <Profile xmlns="http://schemas.microsoft.com/windowsazure"> <DomainName>domain-name2.trafficmanager.net</DomainName> <Name>service-profile1</Name> <Status>Enabled</Status> <StatusDetails> <EnabledVersion>6</EnabledVersion> </StatusDetails> <Definitions> <Definition> <Status>Disabled</Status> <Version>1</Version> </Definition> <Definition> <Status>Disabled</Status> <Version>...</Version> </Definition> <Definition> <Status>Enabled</Status> <Version>6</Version> </Definition> <Definition> <Status>Disabled</Status> <Version>...</Version> </Definition> <Definition> <Status>Disabled</Status> <Version>N</Version> </Definition> </Definitions> </Profile>
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.
