Network Security Perimeter Configurations - List By Service
Gets a list of network security perimeter configurations for a search service.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/networkSecurityPerimeterConfigurations?api-version=2024-03-01-preview
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group within the current subscription. You can obtain this value from the Azure Resource Manager API or the portal. |
search
|
path | True |
string |
The name of the Azure AI Search service associated with the specified resource group. Regex pattern: |
subscription
|
path | True |
string |
The unique identifier for a Microsoft Azure subscription. You can obtain this value from the Azure Resource Manager API or the portal. |
api-version
|
query | True |
string |
The API version to use for each request. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Successfully retrieved the list of configurations. |
|
Other Status Codes |
An unexpected error occurred during the operation. |
Security
azure_auth
Specifies an implicit grant flow, as supported on the Microsoft Identity platform.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
List NSP configs by search service
Sample request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/networkSecurityPerimeterConfigurations?api-version=2024-03-01-preview
Sample response
{
"value": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1",
"name": "00000001-2222-3333-4444-111144444444.assoc1",
"type": "Microsoft.Search/searchServices/networkSecurityPerimeterConfigurations",
"properties": {
"provisioningState": "Accepted",
"networkSecurityPerimeter": {
"id": "/subscriptions/subid/resourceGroups/networkRG/providers/Microsoft.Network/networkSecurityPerimeters/perimeter1",
"location": "westus"
},
"resourceAssociation": {
"name": "assoc1",
"accessMode": "Enforced"
},
"profile": {
"name": "profile1",
"accessRulesVersion": "0",
"accessRules": [
{
"name": "rule1",
"properties": {
"direction": "Inbound",
"addressPrefixes": [
"148.0.0.0/8",
"152.4.6.0/24"
]
}
}
]
}
}
}
]
}
Definitions
Name | Description |
---|---|
Cloud |
Contains information about an API error. |
Cloud |
Describes a particular API error with an error code and a message. |
Network |
Network security perimeter configuration for a server. |
Network |
A list of network security perimeter configurations for a server. |
NSPConfig |
An access rule for a network security perimeter configuration. |
NSPConfig |
The properties for the access rules in a network security perimeter configuration. |
NSPConfig |
The resource association for the network security perimeter. |
NSPConfig |
The network security perimeter properties present in a configuration rule. |
NSPConfig |
The perimeter for a network security perimeter configuration. |
NSPConfig |
The profile for a network security perimeter configuration. |
NSPProvisioning |
An object to describe any issues with provisioning network security perimeters to a search service. |
NSPProvisioning |
The properties to describe any issues with provisioning network security perimeters to a search service. |
CloudError
Contains information about an API error.
Name | Type | Description |
---|---|---|
error |
Describes a particular API error with an error code and a message. |
|
message |
string |
A brief description of the error that hints at what went wrong (for details/debugging information refer to the 'error.message' property). |
CloudErrorBody
Describes a particular API error with an error code and a message.
Name | Type | Description |
---|---|---|
code |
string |
An error code that describes the error condition more precisely than an HTTP status code. Can be used to programmatically handle specific error cases. |
details |
Contains nested errors that are related to this error. |
|
message |
string |
A message that describes the error in detail and provides debugging information. |
target |
string |
The target of the particular error (for example, the name of the property in error). |
NetworkSecurityPerimeterConfiguration
Network security perimeter configuration for a server.
Name | Type | Description |
---|---|---|
id |
string |
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
The name of the resource |
properties.networkSecurityPerimeter |
The perimeter for a network security perimeter configuration. |
|
properties.profile |
The profile for a network security perimeter configuration. |
|
properties.provisioningIssues |
An object to describe any issues with provisioning network security perimeters to a search service. |
|
properties.provisioningState |
string |
|
properties.resourceAssociation |
The resource association for the network security perimeter. |
|
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
NetworkSecurityPerimeterConfigurationListResult
A list of network security perimeter configurations for a server.
Name | Type | Description |
---|---|---|
nextLink |
string |
Link to retrieve next page of results. |
value |
Array of results. |
NSPConfigAccessRule
An access rule for a network security perimeter configuration.
Name | Type | Description |
---|---|---|
name |
string |
|
properties |
The properties for the access rules in a network security perimeter configuration. |
NSPConfigAccessRuleProperties
The properties for the access rules in a network security perimeter configuration.
Name | Type | Description |
---|---|---|
addressPrefixes |
string[] |
|
direction |
string |
|
fullyQualifiedDomainNames |
string[] |
|
networkSecurityPerimeters |
The network security perimeter properties present in a configuration rule. |
|
subscriptions |
string[] |
NSPConfigAssociation
The resource association for the network security perimeter.
Name | Type | Description |
---|---|---|
accessMode |
string |
|
name |
string |
NSPConfigNetworkSecurityPerimeterRule
The network security perimeter properties present in a configuration rule.
Name | Type | Description |
---|---|---|
id |
string |
|
location |
string |
|
perimeterGuid |
string |
NSPConfigPerimeter
The perimeter for a network security perimeter configuration.
Name | Type | Description |
---|---|---|
id |
string |
|
location |
string |
|
perimeterGuid |
string |
NSPConfigProfile
The profile for a network security perimeter configuration.
Name | Type | Description |
---|---|---|
accessRules |
An access rule for a network security perimeter configuration. |
|
accessRulesVersion |
string |
|
name |
string |
NSPProvisioningIssue
An object to describe any issues with provisioning network security perimeters to a search service.
Name | Type | Description |
---|---|---|
name |
string |
|
properties |
The properties to describe any issues with provisioning network security perimeters to a search service. |
NSPProvisioningIssueProperties
The properties to describe any issues with provisioning network security perimeters to a search service.
Name | Type | Description |
---|---|---|
description |
string |
|
issueType |
string |
|
severity |
string |
|
suggestedAccessRules |
string[] |
|
suggestedResourceIds |
string[] |