Workspaces - Get NSP

サービス:: Log Analytics

API バージョン:: 2025-02-01

ネットワークセキュリティ境界構成を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/networkSecurityPerimeterConfigurations/{networkSecurityPerimeterConfigurationName}?api-version=2025-02-01

URI パラメーター

名前	/	必須	型	説明
networkSecurityPerimeterConfigurationName	path	True	string minLength: 1 maxLength: 512 pattern: ^.*$	ネットワークセキュリティ境界構成の名前
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字が区別されます。
subscriptionId	path	True	string minLength: 1	ターゲットサブスクリプションの ID。
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	ワークスペースの名前。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	NetworkSecurityPerimeterConfiguration	構成が正常に取得されました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Get NSP config by name for Scheduled Query Rule

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/exampleRG/providers/Microsoft.OperationalInsights/workspaces/someWorkspace/networkSecurityPerimeterConfigurations/somePerimeterConfiguration?api-version=2025-02-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/exampleRG/providers/Microsoft.OperationalInsights/workspaces/someWorkspace/networkSecurityPerimeterConfigurations/somePerimeterConfiguration",
  "name": "somePerimeterConfiguration",
  "type": "Microsoft.OperationalInsights/workspaces/networkSecurityPerimeterConfigurations",
  "properties": {
    "provisioningState": "Accepted",
    "networkSecurityPerimeter": {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/networkRG/providers/Microsoft.Network/networkSecurityPerimeters/perimeter1",
      "location": "japaneast"
    },
    "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"
            ]
          }
        }
      ]
    }
  }
}

定義

名前	説明
AccessRule	ネットワークセキュリティ境界構成プロファイルのアクセス規則
AccessRuleDirection	アクセス規則の方向
AccessRuleProperties	アクセス規則のプロパティ
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IssueType	問題の種類
NetworkSecurityPerimeter	ネットワークセキュリティ境界 (NSP) に関する情報
NetworkSecurityPerimeterConfiguration	ネットワークセキュリティ境界 (NSP) 構成リソース
NetworkSecurityPerimeterConfigurationProperties	ネットワークセキュリティ構成プロパティ。
NetworkSecurityPerimeterConfigurationProvisioningState	作成または更新されるネットワークセキュリティ境界構成のプロビジョニング状態。
NetworkSecurityProfile	ネットワークセキュリティ境界構成プロファイル
ProvisioningIssue	ネットワークセキュリティ境界構成のプロビジョニングの問題について説明します
ProvisioningIssueProperties	ネットワークセキュリティ境界 (NSP) 構成のプロビジョニングの問題の詳細。リソースプロバイダーは、検出された個別の問題ごとに個別のプロビジョニングの問題要素を生成し、意味のある独特の説明と、適切な suggestedResourceIds と suggestedAccessRules を含める必要があります
ResourceAssociation	リソースの関連付けに関する情報
ResourceAssociationAccessMode	リソース関連付けのアクセスモード
Severity	問題の重大度。
Subscriptions	受信規則のサブスクリプション

AccessRule

Object

ネットワークセキュリティ境界構成プロファイルのアクセス規則

名前	型	説明
name	string	アクセス規則の名前
properties	AccessRuleProperties	アクセス規則のプロパティ

AccessRuleDirection

列挙

アクセス規則の方向

値	説明
Inbound	セキュリティで保護されたリソースへの受信ネットワークトラフィックに適用されます。
Outbound	セキュリティで保護されたリソースからの送信ネットワークトラフィックに適用されます

AccessRuleProperties

Object

アクセス規則のプロパティ

名前	型	説明
addressPrefixes	string[]	受信規則の CIDR 形式のアドレスプレフィックス
direction	AccessRuleDirection	アクセス規則の方向
emailAddresses	string[]	送信規則の電子メールアドレス
fullyQualifiedDomainNames	string[]	送信規則の完全修飾ドメイン名 (FQDN)
networkSecurityPerimeters	NetworkSecurityPerimeter[]	受信規則のネットワークセキュリティ境界
phoneNumbers	string[]	送信ルールの電話番号
subscriptions	Subscriptions[]	受信規則のサブスクリプション

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

IssueType

列挙

問題の種類

値	説明
ConfigurationPropagationFailure	ネットワークセキュリティ境界 (NSP) 構成の適用中にエラーが発生しました。
MissingIdentityConfiguration	マネージド ID がリソースに関連付けされていません。リソースは引き続き、ネットワークセキュリティ境界 (NSP) からの受信トラフィックまたは受信アクセス規則に一致することを検証できますが、NSP のメンバーとして送信アクセスを実行することはできません。
MissingPerimeterConfiguration	ネットワーク接続の問題は、ネットワークセキュリティ境界 (NSP) に新しいリソースを追加するか、アクセス規則を変更することによって対処できるリソースで発生しています。
Unknown	不明な問題の種類

NetworkSecurityPerimeter

Object

ネットワークセキュリティ境界 (NSP) に関する情報

名前	型	説明
id	string (arm-id)	NSP リソースの完全修飾 Azure リソース ID
location	string	ネットワークセキュリティ境界の場所
perimeterGuid	string (uuid)	ネットワークセキュリティ境界のユニバーサル一意 ID (UUID)

NetworkSecurityPerimeterConfiguration

Object

ネットワークセキュリティ境界 (NSP) 構成リソース

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties	NetworkSecurityPerimeterConfigurationProperties	ネットワークセキュリティ構成プロパティ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

NetworkSecurityPerimeterConfigurationProperties

Object

ネットワークセキュリティ構成プロパティ。

名前	型	説明
networkSecurityPerimeter	NetworkSecurityPerimeter	ネットワークセキュリティ境界 (NSP) に関する情報
profile	NetworkSecurityProfile	ネットワークセキュリティ境界構成プロファイル
provisioningIssues	ProvisioningIssue[]	プロビジョニングの問題の一覧 (存在する場合)
provisioningState	NetworkSecurityPerimeterConfigurationProvisioningState	作成または更新されるネットワークセキュリティ境界構成のプロビジョニング状態。
resourceAssociation	ResourceAssociation	リソースの関連付けに関する情報

NetworkSecurityPerimeterConfigurationProvisioningState

列挙

作成または更新されるネットワークセキュリティ境界構成のプロビジョニング状態。

値	説明
Accepted
Canceled
Creating
Deleting
Failed
Succeeded
Updating

NetworkSecurityProfile

Object

ネットワークセキュリティ境界構成プロファイル

名前	型	説明
accessRules	AccessRule[]	アクセス規則の一覧
accessRulesVersion	integer (int32)	現在のアクセス規則のバージョン
diagnosticSettingsVersion	integer (int32)	現在の診断設定のバージョン
enabledLogCategories	string[]	有効になっているログカテゴリの一覧
name	string	プロファイルの名前

ProvisioningIssue

Object

ネットワークセキュリティ境界構成のプロビジョニングの問題について説明します

名前	型	説明
name	string	問題の名前
properties	ProvisioningIssueProperties	ネットワークセキュリティ境界 (NSP) 構成のプロビジョニングの問題の詳細。リソースプロバイダーは、検出された個別の問題ごとに個別のプロビジョニングの問題要素を生成し、意味のある独特の説明と、適切な suggestedResourceIds と suggestedAccessRules を含める必要があります

ProvisioningIssueProperties

Object

ネットワークセキュリティ境界 (NSP) 構成のプロビジョニングの問題の詳細。リソースプロバイダーは、検出された個別の問題ごとに個別のプロビジョニングの問題要素を生成し、意味のある独特の説明と、適切な suggestedResourceIds と suggestedAccessRules を含める必要があります

名前	型	説明
description	string	問題の説明
issueType	IssueType	問題の種類
severity	Severity	問題の重大度。
suggestedAccessRules	AccessRule[]	ネットワークセキュリティプロファイル (NSP) に追加して問題を修復できるアクセス規則。
suggestedResourceIds	string[] (arm-id)	問題を修復するためにネットワークセキュリティ境界 (NSP) に関連付けることができる、推奨されるリソースの完全修飾リソース ID。

ResourceAssociation

Object

リソースの関連付けに関する情報

名前	型	説明
accessMode	ResourceAssociationAccessMode	リソース関連付けのアクセスモード
name	string	リソースの関連付けの名前

ResourceAssociationAccessMode

列挙

リソース関連付けのアクセスモード

値	説明
Audit	アクセスモードの監査 - アクセスチェックに失敗したリソースへのトラフィックはログに記録されますが、ブロックされません
Enforced	強制アクセスモード - アクセスチェックに失敗したリソースへのトラフィックがブロックされる
Learning	学習アクセスモード - リソースへのトラフィックは分析に対して有効になっていますが、ブロックされません

Severity

列挙

問題の重大度。

値	説明
Error
Warning

Subscriptions

Object

受信規則のサブスクリプション

名前	型	説明
id	string (arm-id)	サブスクリプションの完全修飾 Azure リソース ID ('/subscriptions/00000000-0000-0000-0000-0000000000000')

次の方法で共有

Workspaces - Get NSP

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

Get NSP config by name for Scheduled Query Rule

要求のサンプル

応答のサンプル

定義

AccessRule

AccessRuleDirection

AccessRuleProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IssueType

NetworkSecurityPerimeter

NetworkSecurityPerimeterConfiguration

NetworkSecurityPerimeterConfigurationProperties

NetworkSecurityPerimeterConfigurationProvisioningState

NetworkSecurityProfile

ProvisioningIssue

ProvisioningIssueProperties

ResourceAssociation

ResourceAssociationAccessMode

Severity

Subscriptions