List Network Security Groups
The List Network Security Groups operation returns a list of the network security groups in the specified subscription.
Request
The List Network Security Groups request may be specified as follows. Replace <subscription-id> with the subscription ID.
Method |
Request URI |
---|---|
GET |
https://management.core.windows.net/<subscription-id>/services/networking/networksecuritygroups |
URI Parameters
None.
Request Headers
The following table describes the request headers.
Request Header |
Description |
---|---|
Content-Type |
Required. Specifies that the the type of the request content. The value should be set to application/xml. |
x-ms-version |
Required. Specifies the version of the operation to use for this request. The value for this header should be set to 2014-10-01 or higher. |
Request Body
None.
Response
The response includes an HTTP status code, a response body, and a set of response headers.
Status Code
A successful operation returns status code 200 (OK).
Response Headers
The response for this operation includes the following headers. The response may also include additional standard HTTP headers.
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:
<NetworkSecurityGroups xmlns="https://schemas.microsoft.com/windowsazure"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<NetworkSecurityGroup>
<Name>network-security-group-name</Name>
<Label>label-of-network-security-group</Label>
<Location>location-of-network-security-group</Location>
<State>network-security-group-state</State>
</NetworkSecurityGroup>
</NetworkSecurityGroups>
The following table describes the elements in the response body.
Element name |
Description |
---|---|
Name |
Specifies the name of the security group. |
Label |
Specifies an identifier for the network security group. |
Location |
Specifies the location of the network security group. |
State |
Specifies the state of the network security group. Possible values are:
|