단일 적응형 네트워크 강화 리소스를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Security/adaptiveNetworkHardenings/{adaptiveNetworkHardeningResourceName}?api-version=2020-01-01
URI 매개 변수
| Name |
In(다음 안에) |
필수 |
형식 |
Description |
|
adaptiveNetworkHardeningResourceName
|
path |
True
|
string
|
적응형 네트워크 강화 리소스의 이름입니다.
|
|
resourceGroupName
|
path |
True
|
string
|
사용자의 구독 내에 있는 리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
Regex pattern: ^[-\w\._\(\)]+$
|
|
resourceName
|
path |
True
|
string
|
리소스의 이름입니다.
|
|
resourceNamespace
|
path |
True
|
string
|
리소스의 네임스페이스입니다.
|
|
resourceType
|
path |
True
|
string
|
리소스 형식입니다.
|
|
subscriptionId
|
path |
True
|
string
|
Azure 구독 ID입니다.
Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
|
|
api-version
|
query |
True
|
string
|
작업에 대한 API 버전
|
응답
보안
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Name |
Description |
|
user_impersonation
|
사용자 계정 가장
|
예제
Get a single Adaptive Network Hardening resource
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Security/adaptiveNetworkHardenings/default?api-version=2020-01-01
/** Samples for AdaptiveNetworkHardenings Get. */
public final class Main {
/*
* x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/AdaptiveNetworkHardenings/GetAdaptiveNetworkHardening_example.json
*/
/**
* Sample code: Get a single Adaptive Network Hardening resource.
*
* @param manager Entry point to SecurityManager.
*/
public static void getASingleAdaptiveNetworkHardeningResource(
com.azure.resourcemanager.security.SecurityManager manager) {
manager
.adaptiveNetworkHardenings()
.getWithResponse(
"rg1", "Microsoft.Compute", "virtualMachines", "vm1", "default", com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armsecurity_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/AdaptiveNetworkHardenings/GetAdaptiveNetworkHardening_example.json
func ExampleAdaptiveNetworkHardeningsClient_Get() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewAdaptiveNetworkHardeningsClient().Get(ctx, "rg1", "Microsoft.Compute", "virtualMachines", "vm1", "default", nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.AdaptiveNetworkHardening = armsecurity.AdaptiveNetworkHardening{
// Name: to.Ptr("default"),
// Type: to.Ptr("Microsoft.Security/adaptiveNetworkHardenings"),
// ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Security/adaptiveNetworkHardenings/default"),
// Properties: &armsecurity.AdaptiveNetworkHardeningProperties{
// EffectiveNetworkSecurityGroups: []*armsecurity.EffectiveNetworkSecurityGroups{
// {
// NetworkInterface: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1"),
// NetworkSecurityGroups: []*string{
// to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/nicNsg"),
// to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/subnetNsg")},
// },
// {
// NetworkInterface: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg2/providers/Microsoft.Network/networkInterfaces/nic2"),
// NetworkSecurityGroups: []*string{
// to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nicNsg")},
// }},
// Rules: []*armsecurity.Rule{
// {
// Name: to.Ptr("rule1"),
// DestinationPort: to.Ptr[int32](3389),
// Direction: to.Ptr(armsecurity.DirectionInbound),
// IPAddresses: []*string{
// to.Ptr("100.10.1.1"),
// to.Ptr("200.20.2.2"),
// to.Ptr("81.199.3.0/24")},
// Protocols: []*armsecurity.TransportProtocol{
// to.Ptr(armsecurity.TransportProtocolTCP)},
// },
// {
// Name: to.Ptr("rule2"),
// DestinationPort: to.Ptr[int32](22),
// Direction: to.Ptr(armsecurity.DirectionInbound),
// IPAddresses: []*string{
// },
// Protocols: []*armsecurity.TransportProtocol{
// to.Ptr(armsecurity.TransportProtocolTCP)},
// }},
// RulesCalculationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-15T00:00:00.000Z"); return t}()),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Gets a single Adaptive Network Hardening resource
*
* @summary Gets a single Adaptive Network Hardening resource
* x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/AdaptiveNetworkHardenings/GetAdaptiveNetworkHardening_example.json
*/
async function getASingleAdaptiveNetworkHardeningResource() {
const subscriptionId =
process.env["SECURITY_SUBSCRIPTION_ID"] || "20ff7fc3-e762-44dd-bd96-b71116dcdc23";
const resourceGroupName = process.env["SECURITY_RESOURCE_GROUP"] || "rg1";
const resourceNamespace = "Microsoft.Compute";
const resourceType = "virtualMachines";
const resourceName = "vm1";
const adaptiveNetworkHardeningResourceName = "default";
const credential = new DefaultAzureCredential();
const client = new SecurityCenter(credential, subscriptionId);
const result = await client.adaptiveNetworkHardenings.get(
resourceGroupName,
resourceNamespace,
resourceType,
resourceName,
adaptiveNetworkHardeningResourceName,
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.SecurityCenter;
using Azure.ResourceManager.SecurityCenter.Models;
// Generated from example definition: specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/AdaptiveNetworkHardenings/GetAdaptiveNetworkHardening_example.json
// this example is just showing the usage of "AdaptiveNetworkHardenings_Get" operation, for the dependent resources, they will have to be created separately.
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);
// this example assumes you already have this AdaptiveNetworkHardeningResource created on azure
// for more information of creating AdaptiveNetworkHardeningResource, please refer to the document of AdaptiveNetworkHardeningResource
string subscriptionId = "20ff7fc3-e762-44dd-bd96-b71116dcdc23";
string resourceGroupName = "rg1";
string resourceNamespace = "Microsoft.Compute";
string resourceType = "virtualMachines";
string resourceName = "vm1";
string adaptiveNetworkHardeningResourceName = "default";
ResourceIdentifier adaptiveNetworkHardeningResourceId = AdaptiveNetworkHardeningResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceNamespace, resourceType, resourceName, adaptiveNetworkHardeningResourceName);
AdaptiveNetworkHardeningResource adaptiveNetworkHardening = client.GetAdaptiveNetworkHardeningResource(adaptiveNetworkHardeningResourceId);
// invoke the operation
AdaptiveNetworkHardeningResource result = await adaptiveNetworkHardening.GetAsync();
// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
AdaptiveNetworkHardeningData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Security/adaptiveNetworkHardenings/default",
"name": "default",
"type": "Microsoft.Security/adaptiveNetworkHardenings",
"properties": {
"rulesCalculationTime": "2018-08-15T00:00:00.0000000Z",
"rules": [
{
"name": "rule1",
"direction": "Inbound",
"destinationPort": 3389,
"protocols": [
"TCP"
],
"ipAddresses": [
"100.10.1.1",
"200.20.2.2",
"81.199.3.0/24"
]
},
{
"name": "rule2",
"direction": "Inbound",
"destinationPort": 22,
"protocols": [
"TCP"
],
"ipAddresses": []
}
],
"effectiveNetworkSecurityGroups": [
{
"networkInterface": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1",
"networkSecurityGroups": [
"/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/nicNsg",
"/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/subnetNsg"
]
},
{
"networkInterface": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/rg2/providers/Microsoft.Network/networkInterfaces/nic2",
"networkSecurityGroups": [
"/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/rg2/providers/Microsoft.Network/networkSecurityGroups/nicNsg"
]
}
]
}
}
정의
AdaptiveNetworkHardening
속성이 일부 Azure 리소스에 대한 적응형 네트워크 강화 설정을 설명하는 리소스
| Name |
형식 |
Description |
|
id
|
string
|
리소스 ID
|
|
name
|
string
|
리소스 이름
|
|
properties.effectiveNetworkSecurityGroups
|
EffectiveNetworkSecurityGroups[]
|
보호된 리소스의 네트워크 인터페이스에 효과적인 네트워크 보안 그룹
|
|
properties.rules
|
Rule[]
|
VM에 적용되는 것이 좋습니다.
|
|
properties.rulesCalculationTime
|
string
|
규칙이 계산된 UTC 시간
|
|
type
|
string
|
리소스 유형
|
CloudError
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.
| Name |
형식 |
Description |
|
error.additionalInfo
|
ErrorAdditionalInfo[]
|
오류 추가 정보입니다.
|
|
error.code
|
string
|
오류 코드입니다.
|
|
error.details
|
CloudErrorBody[]
|
오류 세부 정보입니다.
|
|
error.message
|
string
|
오류 메시지입니다.
|
|
error.target
|
string
|
오류 대상입니다.
|
CloudErrorBody
오류 세부 정보입니다.
| Name |
형식 |
Description |
|
additionalInfo
|
ErrorAdditionalInfo[]
|
오류 추가 정보입니다.
|
|
code
|
string
|
오류 코드입니다.
|
|
details
|
CloudErrorBody[]
|
오류 세부 정보입니다.
|
|
message
|
string
|
오류 메시지입니다.
|
|
target
|
string
|
오류 대상입니다.
|
direction
규칙의 방향
| Name |
형식 |
Description |
|
Inbound
|
string
|
|
|
Outbound
|
string
|
|
EffectiveNetworkSecurityGroups
네트워크 인터페이스에서 효과적인 네트워크 보안 그룹에 대해 설명합니다.
| Name |
형식 |
Description |
|
networkInterface
|
string
|
네트워크 인터페이스의 Azure 리소스 ID
|
|
networkSecurityGroups
|
string[]
|
네트워크 인터페이스에서 유효한 네트워크 보안 그룹
|
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name |
형식 |
Description |
|
info
|
object
|
추가 정보입니다.
|
|
type
|
string
|
추가 정보 유형입니다.
|
Rule
일부(프로토콜, 포트, 방향)에서 Azure 리소스와 통신하는 데 권장되는 원격 주소를 설명합니다. 다른 모든 원격 주소는 차단하는 것이 좋습니다.
| Name |
형식 |
Description |
|
destinationPort
|
integer
|
규칙의 대상 포트
|
|
direction
|
direction
|
규칙의 방향
|
|
ipAddresses
|
string[]
|
규칙의 대상 포트 및 프로토콜에서 Azure 리소스와 통신할 수 있어야 하는 원격 IP 주소
|
|
name
|
string
|
규칙의 이름
|
|
protocols
|
transportProtocol[]
|
규칙의 전송 프로토콜
|
transportProtocol
규칙의 전송 프로토콜
| Name |
형식 |
Description |
|
TCP
|
string
|
|
|
UDP
|
string
|
|