Security Standards - Get

サービス:

Defender for Cloud

API バージョン:

2024-08-01

要求されたスコープの特定のセキュリティ標準を standardId で取得する

GET https://management.azure.com/{scope}/providers/Microsoft.Security/securityStandards/{standardId}?api-version=2024-08-01

URI パラメーター

名前	/	必須	型	説明
scope	path	True	string	セキュリティ標準のスコープ。 有効なスコープは、管理グループ (形式: 'providers/Microsoft.Management/managementGroups/{managementGroup}')、サブスクリプション (形式: 'subscriptions/{subscriptionId}'))、またはセキュリティ コネクタ (形式: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName})' です。
standardId	path	True	string	セキュリティ標準キー - 標準の種類の一意のキー 正規表現パターン: [{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$
api-version	query	True	string	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	SecurityStandard	セキュリティ標準が正常に作成されました
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 a security standard over management group scope

Get a security standard over security connector scope

Get a security standard over subscription scope

Get a security standard over management group scope

要求のサンプル

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * GetByManagementGroupSecurityStandard_example.json
     */
    /**
     * Sample code: Get a security standard over management group scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        getASecurityStandardOverManagementGroupScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().getWithResponse("providers/Microsoft.Management/managementGroups/contoso",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", 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

応答のサンプル

状態コード:

200

{
  "id": "/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/securityStandards",
  "properties": {
    "displayName": "Cross cloud standard 1",
    "standardType": "Custom",
    "description": "Controls and security data implementing security recommendations defined in Azure Security",
    "assessments": [
      {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      },
      {
        "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
      }
    ],
    "cloudProviders": [
      "GCP"
    ],
    "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Get a security standard over security connector scope

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * GetBySecurityConnectorSecurityStandard_example.json
     */
    /**
     * Sample code: Get a security standard over security connector scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        getASecurityStandardOverSecurityConnectorScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().getWithResponse(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", 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

応答のサンプル

状態コード:

200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/securityStandards",
  "properties": {
    "displayName": "Cross cloud standard 1",
    "standardType": "Custom",
    "description": "Controls and security data implementing security recommendations defined in Azure Security",
    "assessments": [
      {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      },
      {
        "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
      }
    ],
    "cloudProviders": [
      "GCP"
    ],
    "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Get a security standard over subscription scope

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * GetBySubscriptionSecurityStandard_example.json
     */
    /**
     * Sample code: Get a security standard over subscription scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        getASecurityStandardOverSubscriptionScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().getWithResponse("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", 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

応答のサンプル

状態コード:

200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/securityStandards",
  "properties": {
    "displayName": "Cross cloud standard 1",
    "standardType": "Custom",
    "description": "Controls and security data implementing security recommendations defined in Azure Security",
    "assessments": [
      {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      },
      {
        "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
      }
    ],
    "cloudProviders": [
      "GCP"
    ],
    "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
PartialAssessmentProperties	標準に関連する評価のプロパティについて説明します
SecurityStandard	リソースのセキュリティ標準
StandardMetadata	標準メタデータ
StandardSupportedCloud	標準がサポートされているクラウド。
standardType	標準の種類 (現在はカスタムまたは既定またはコンプライアンスのみ)

ErrorAdditionalInfo

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

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

ErrorDetail

エラーの詳細。

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

ErrorResponse

エラー応答

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

PartialAssessmentProperties

標準に関連する評価のプロパティについて説明します

名前	型	説明
assessmentKey	string	評価キー

SecurityStandard

リソースのセキュリティ標準

名前	型	説明
id	string	リソース ID
name	string	リソース名
properties.assessments	PartialAssessmentProperties[]	標準スコープに適用する評価キーの一覧。
properties.cloudProviders	StandardSupportedCloud[]	サポートされているすべての標準クラウドの一覧。
properties.description	string	標準の説明
properties.displayName	string	standardId と同等の標準の表示名
properties.metadata	StandardMetadata	セキュリティ標準メタデータ。
properties.policySetDefinitionId	string	標準に関連付けられているポリシー セット定義 ID。
properties.standardType	standardType	標準の種類 (現在はカスタムまたは既定またはコンプライアンスのみ)
type	string	リソースの種類

StandardMetadata

標準メタデータ

名前	型	説明
createdBy	string	オブジェクト ID (GUID) によって作成された標準
createdOn	string	標準作成日
lastUpdatedBy	string	オブジェクト ID (GUID) によって最後に更新された標準
lastUpdatedOn	string	標準の最終更新日

StandardSupportedCloud

標準がサポートされているクラウド。

名前	型	説明
AWS	string
Azure	string
GCP	string

standardType

標準の種類 (現在はカスタムまたは既定またはコンプライアンスのみ)

名前	型	説明
Compliance	string
Custom	string
Default	string