Standard Assignments - Get

サービス:

Defender for Cloud

API バージョン:

2024-08-01

標準の割り当てを取得します。
この操作は、名前と作成されたスコープを指定して、1 つの標準割り当てを取得します。

GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/standardAssignments/{standardAssignmentName}?api-version=2024-08-01

URI パラメーター

名前	/	必須	型	説明
resourceId	path	True	string	リソースの識別子。
standardAssignmentName	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	StandardAssignment	標準割り当てに関する情報を返します。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

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

例

Retrieve a standard assignment

要求のサンプル

HTTP

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

Java

/**
 * Samples for StandardAssignments Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/StandardAssignments/
     * GetStandardAssignment.json
     */
    /**
     * Sample code: Retrieve a standard assignment.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void retrieveAStandardAssignment(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.standardAssignments().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/standardAssignments",
  "properties": {
    "displayName": "Test exemption",
    "description": "Exemption description",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Exempt",
    "expiresOn": "2022-05-01T19:50:47.083633Z",
    "exemptionData": {
      "exemptionCategory": "waiver",
      "assignedAssessment": {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      }
    },
    "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"
    }
  }
}

定義

名前	説明
AssignedAssessmentItem	セキュリティ評価オブジェクト参照のプロパティについて (キー別に) 説明する
AssignedStandardItem	標準割り当てオブジェクト参照のプロパティについて説明する
attestationComplianceState	この割り当ての構成証明カテゴリ
AttestationData	構成証明効果を持つ割り当てに関する追加データ
AttestationEvidence	割り当て構成証明のプロパティについて説明する
effect	この割り当ての予想される効果 (監査/除外/構成証明)
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
exemptionCategory	この割り当ての除外カテゴリ
ExemptionData	除外効果がある割り当てに関する追加データ
StandardAssignment	特定のスコープに対するリソース グループのセキュリティ割り当て
StandardAssignmentMetadata	標準の割り当てメタデータ

AssignedAssessmentItem

セキュリティ評価オブジェクト参照のプロパティについて (キー別に) 説明する

名前	型	説明
assessmentKey	string	セキュリティ評価オブジェクトの一意のキー

AssignedStandardItem

標準割り当てオブジェクト参照のプロパティについて説明する

名前	型	説明
id	string	Microsoft.Security/standard オブジェクトの完全な resourceId

attestationComplianceState

この割り当ての構成証明カテゴリ

名前	型	説明
compliant	string
nonCompliant	string
unknown	string

AttestationData

構成証明効果を持つ割り当てに関する追加データ

名前	型	説明
assignedAssessment	AssignedAssessmentItem	指定されたスコープに対するこの標準割り当てに適用されるキーを持つコンポーネント項目
complianceDate	string	構成証明コンプライアンスの日付
complianceState	attestationComplianceState	この割り当ての構成証明カテゴリ
evidence	AttestationEvidence[]	構成証明証拠へのリンクの配列

AttestationEvidence

割り当て構成証明のプロパティについて説明する

名前	型	説明
description	string	証拠の説明
sourceUrl	string	証拠のソース URL

effect

この割り当ての予想される効果 (監査/除外/構成証明)

名前	型	説明
Attest	string
Audit	string
Exempt	string

ErrorAdditionalInfo

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

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

ErrorDetail

エラーの詳細。

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

ErrorResponse

エラー応答

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

exemptionCategory

この割り当ての除外カテゴリ

名前	型	説明
mitigated	string
waiver	string

ExemptionData

除外効果がある割り当てに関する追加データ

名前	型	説明
assignedAssessment	AssignedAssessmentItem	指定されたスコープに対するこの標準割り当てに適用されるキーを持つコンポーネント項目
exemptionCategory	exemptionCategory	この割り当ての除外カテゴリ

StandardAssignment

特定のスコープに対するリソース グループのセキュリティ割り当て

名前	型	説明
id	string	リソース ID
name	string	リソース名
properties.assignedStandard	AssignedStandardItem	指定されたスコープに対するこの標準割り当てに適用されるキーを持つ標準項目
properties.attestationData	AttestationData	構成証明効果を持つ割り当てに関する追加データ
properties.description	string	standardAssignment の説明
properties.displayName	string	standardAssignment の表示名
properties.effect	effect	この割り当ての予想される効果 (監査/除外/構成証明)
properties.excludedScopes	string[]	除外されたスコープ、スコープの子孫を除外する (管理スコープの場合)
properties.exemptionData	ExemptionData	除外効果がある割り当てに関する追加データ
properties.expiresOn	string	完全な ISO 日付としてのこの割り当ての有効期限
properties.metadata	StandardAssignmentMetadata	標準の割り当てメタデータ。
type	string	リソースの種類

StandardAssignmentMetadata

標準の割り当てメタデータ

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