선택한 규정 준수 제어 세부 정보 및 상태
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/regulatoryComplianceStandards/{regulatoryComplianceStandardName}/regulatoryComplianceControls/{regulatoryComplianceControlName}?api-version=2019-01-01-preview
URI 매개 변수
Name |
In(다음 안에) |
필수 |
형식 |
Description |
regulatoryComplianceControlName
|
path |
True
|
string
|
규정 준수 제어 개체의 이름
|
regulatoryComplianceStandardName
|
path |
True
|
string
|
규정 준수 표준 개체의 이름
|
subscriptionId
|
path |
True
|
string
|
Azure 구독 ID
regex 패턴: ^[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
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name |
Description |
user_impersonation
|
사용자 계정 가장
|
예제
Get selected regulatory compliance control details and state
샘플 요청
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/regulatoryComplianceStandards/PCI-DSS-3.2/regulatoryComplianceControls/1.1?api-version=2019-01-01-preview
/**
* Samples for RegulatoryComplianceControls Get.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/
* RegulatoryCompliance/getRegulatoryComplianceControl_example.json
*/
/**
* Sample code: Get selected regulatory compliance control details and state.
*
* @param manager Entry point to SecurityManager.
*/
public static void getSelectedRegulatoryComplianceControlDetailsAndState(
com.azure.resourcemanager.security.SecurityManager manager) {
manager.regulatoryComplianceControls().getWithResponse("PCI-DSS-3.2", "1.1", 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/preview/2019-01-01-preview/examples/RegulatoryCompliance/getRegulatoryComplianceControl_example.json
func ExampleRegulatoryComplianceControlsClient_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.NewRegulatoryComplianceControlsClient().Get(ctx, "PCI-DSS-3.2", "1.1", 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.RegulatoryComplianceControl = armsecurity.RegulatoryComplianceControl{
// Name: to.Ptr("1.1"),
// Type: to.Ptr("Microsoft.Security/regulatoryComplianceControl"),
// ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/regulatoryComplianceStandards/PCI-DSS-3.2/regulatoryComplianceControls/1.1"),
// Properties: &armsecurity.RegulatoryComplianceControlProperties{
// Description: to.Ptr("Common Criteria Related to Organization and Management"),
// FailedAssessments: to.Ptr[int32](4),
// PassedAssessments: to.Ptr[int32](7),
// SkippedAssessments: to.Ptr[int32](0),
// State: to.Ptr(armsecurity.StateFailed),
// },
// }
}
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 Selected regulatory compliance control details and state
*
* @summary Selected regulatory compliance control details and state
* x-ms-original-file: specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/RegulatoryCompliance/getRegulatoryComplianceControl_example.json
*/
async function getSelectedRegulatoryComplianceControlDetailsAndState() {
const subscriptionId =
process.env["SECURITY_SUBSCRIPTION_ID"] || "20ff7fc3-e762-44dd-bd96-b71116dcdc23";
const regulatoryComplianceStandardName = "PCI-DSS-3.2";
const regulatoryComplianceControlName = "1.1";
const credential = new DefaultAzureCredential();
const client = new SecurityCenter(credential, subscriptionId);
const result = await client.regulatoryComplianceControls.get(
regulatoryComplianceStandardName,
regulatoryComplianceControlName,
);
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;
// Generated from example definition: specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/RegulatoryCompliance/getRegulatoryComplianceControl_example.json
// this example is just showing the usage of "RegulatoryComplianceControls_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 RegulatoryComplianceStandardResource created on azure
// for more information of creating RegulatoryComplianceStandardResource, please refer to the document of RegulatoryComplianceStandardResource
string subscriptionId = "20ff7fc3-e762-44dd-bd96-b71116dcdc23";
string regulatoryComplianceStandardName = "PCI-DSS-3.2";
ResourceIdentifier regulatoryComplianceStandardResourceId = RegulatoryComplianceStandardResource.CreateResourceIdentifier(subscriptionId, regulatoryComplianceStandardName);
RegulatoryComplianceStandardResource regulatoryComplianceStandard = client.GetRegulatoryComplianceStandardResource(regulatoryComplianceStandardResourceId);
// get the collection of this RegulatoryComplianceControlResource
RegulatoryComplianceControlCollection collection = regulatoryComplianceStandard.GetRegulatoryComplianceControls();
// invoke the operation
string regulatoryComplianceControlName = "1.1";
NullableResponse<RegulatoryComplianceControlResource> response = await collection.GetIfExistsAsync(regulatoryComplianceControlName);
RegulatoryComplianceControlResource result = response.HasValue ? response.Value : null;
if (result == null)
{
Console.WriteLine($"Succeeded with null as result");
}
else
{
// 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
RegulatoryComplianceControlData 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
샘플 응답
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/regulatoryComplianceStandards/PCI-DSS-3.2/regulatoryComplianceControls/1.1",
"name": "1.1",
"type": "Microsoft.Security/regulatoryComplianceControl",
"properties": {
"description": "Common Criteria Related to Organization and Management",
"state": "Failed",
"passedAssessments": 7,
"failedAssessments": 4,
"skippedAssessments": 0
}
}
정의
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
|
오류 대상입니다.
|
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name |
형식 |
Description |
info
|
object
|
추가 정보입니다.
|
type
|
string
|
추가 정보 유형입니다.
|
RegulatoryComplianceControl
규정 준수 제어 세부 정보 및 상태
Name |
형식 |
Description |
id
|
string
|
리소스 ID
|
name
|
string
|
리소스 이름
|
properties.description
|
string
|
규정 준수 제어에 대한 설명
|
properties.failedAssessments
|
integer
|
실패한 상태의 지정된 컨트롤에 대해 지원되는 규정 준수 평가 수
|
properties.passedAssessments
|
integer
|
통과된 상태의 지정된 컨트롤에 대해 지원되는 규정 준수 평가 수
|
properties.skippedAssessments
|
integer
|
건너뛴 상태로 지정된 컨트롤의 지원되는 규정 준수 평가 수
|
properties.state
|
state
|
컨트롤의 지원되는 평가 상태를 기반으로 하는 집계 상태
|
type
|
string
|
리소스 종류
|
state
표준의 지원되는 컨트롤 상태를 기반으로 하는 집계 상태
Name |
형식 |
Description |
Failed
|
string
|
지정된 표준에서 지원되는 하나 이상의 규정 준수 제어에 실패한 상태가 있습니다.
|
Passed
|
string
|
지정된 표준에서 지원되는 모든 규정 준수 컨트롤에는 통과된 상태가 있습니다.
|
Skipped
|
string
|
지정된 표준에서 지원되는 모든 규정 준수 컨트롤은 건너뛴 상태입니다.
|
Unsupported
|
string
|
지정된 표준에 대해 지원되는 규정 준수 데이터가 없음
|