Azure DevOps Projects - Create Or Update

リファレンス

サービス:: Defender for Cloud

API バージョン:: 2024-05-15-preview

監視対象の Azure DevOps プロジェクトリソースを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}?api-version=2024-05-15-preview

URI パラメーター

名前	/	必須	型	説明
orgName	path	True	string	Azure DevOps 組織名。
projectName	path	True	string	プロジェクト名。
resourceGroupName	path	True	string	リソースグループの名前。名前では大文字と小文字が区別されません。
securityConnectorName	path	True	string	セキュリティコネクタ名。
subscriptionId	path	True	string	ターゲットサブスクリプションの ID。
api-version	query	True	string	この操作に使用する API バージョン。

要求本文

名前	型	説明
properties	AzureDevOpsProjectProperties	Azure DevOps Project のプロパティ。

応答

名前	型	説明
200 OK	AzureDevOpsProject	監視対象の Azure DevOps プロジェクトリソースを作成または更新します
201 Created	AzureDevOpsProject	作成
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

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

例

CreateOrUpdate_AzureDevOpsProjects

PUT https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject?api-version=2024-05-15-preview

{
  "properties": {
    "onboardingState": "NotApplicable",
    "actionableRemediation": {
      "state": "Enabled"
    }
  }
}


import com.azure.resourcemanager.security.models.ActionableRemediation;
import com.azure.resourcemanager.security.models.ActionableRemediationState;
import com.azure.resourcemanager.security.models.AzureDevOpsProjectProperties;
import com.azure.resourcemanager.security.models.OnboardingState;

/**
 * Samples for AzureDevOpsProjects CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/CreateOrUpdateAzureDevOpsProjects_example.json
     */
    /**
     * Sample code: CreateOrUpdate_AzureDevOpsProjects.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void createOrUpdateAzureDevOpsProjects(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.azureDevOpsProjects().define("myAzDevOpsProject")
            .withExistingAzureDevOpsOrg("myRg", "mySecurityConnectorName", "myAzDevOpsOrg")
            .withProperties(new AzureDevOpsProjectProperties().withOnboardingState(OnboardingState.NOT_APPLICABLE)
                .withActionableRemediation(new ActionableRemediation().withState(ActionableRemediationState.ENABLED)))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "properties": {
    "parentOrgName": "myAzDevOpsOrg",
    "projectId": "9ebbed8f-a9cc-405f-a647-b235e22179de",
    "onboardingState": "Onboarded",
    "actionableRemediation": {
      "state": "Enabled"
    },
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject",
  "name": "myAzDevOpsProject",
  "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects"
}

状態コード:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2024-05-15-preview

{
  "properties": {
    "parentOrgName": "myAzDevOpsOrg",
    "projectId": "9ebbed8f-a9cc-405f-a647-b235e22179de",
    "onboardingState": "NotApplicable",
    "actionableRemediation": {
      "state": "None"
    },
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject",
  "name": "myAzDevOpsProject",
  "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects"
}

定義

名前	説明
ActionableRemediation	PR 注釈の構成ペイロード。
ActionableRemediationState	ActionableRemediation の設定。なし - 設定が設定されませんでした。有効 - ActionableRemediation が有効になっています。無効 - ActionableRemediation が無効です。
AnnotateDefaultBranchState	既定のブランチでの PR 注釈の構成。有効 - リソースの既定のブランチで PR 注釈が有効になります。無効 - リソースの既定のブランチで PR 注釈が無効になります。
AzureDevOpsProject	Azure DevOps Project リソース。
AzureDevOpsProjectProperties	Azure DevOps Project のプロパティ。
CategoryConfiguration	PR 注釈のカテゴリ構成ごとの重大度レベル。
createdByType	リソースを作成した ID の種類。
DevOpsProvisioningState	リソースのプロビジョニング状態。保留中 - プロビジョニングが保留中です。失敗 - プロビジョニングに失敗しました。成功 - プロビジョニングに成功しました。キャンセル済み - プロビジョニングが取り消されました。 PendingDeletion - 削除保留中。 DeletionSuccess - 削除に成功しました。 DeletionFailure - 削除エラー。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
InheritFromParentState	設定を更新します。有効 - リソースは親から構成を継承する必要があります。無効 - リソースは親から構成を継承しないでください。
OnboardingState	すべてのコネクタでのリソースオンボードの状態に関する詳細。 OnboardedByOtherConnector - このリソースは既に別のコネクタにオンボードされています。これは、最上位レベルのリソースにのみ適用されます。オンボード - このリソースは、指定されたコネクタによって既にオンボードされています。 NotOnboarded - このリソースはどのコネクタにもオンボードされていません。 NotApplicable - オンボード状態は現在のエンドポイントには適用されません。
RuleCategory	ルールカテゴリ。コード - コードスキャンの結果。成果物のスキャン結果。依存関係のスキャン結果。 IaC の結果。結果をスキャンするシークレット。コンテナーのスキャン結果。
systemData	リソースの作成と最後の変更に関連するメタデータ。
TargetBranchConfiguration	PR 注釈のリポジトリブランチの構成。

ActionableRemediation

PR 注釈の構成ペイロード。

名前	型	説明
branchConfiguration	TargetBranchConfiguration	PR 注釈のリポジトリブランチの構成。
categoryConfigurations	CategoryConfiguration[]	カテゴリと重大度レベルの一覧を取得または設定します。
inheritFromParentState	InheritFromParentState	設定を更新します。有効 - リソースは親から構成を継承する必要があります。無効 - リソースは親から構成を継承しないでください。
state	ActionableRemediationState	ActionableRemediation の設定。なし - 設定が設定されませんでした。有効 - ActionableRemediation が有効になっています。無効 - ActionableRemediation が無効です。

ActionableRemediationState

ActionableRemediation の設定。なし - 設定が設定されませんでした。有効 - ActionableRemediation が有効になっています。無効 - ActionableRemediation が無効です。

名前	型	説明
Disabled	string
Enabled	string
None	string

AnnotateDefaultBranchState

既定のブランチでの PR 注釈の構成。

有効 - リソースの既定のブランチで PR 注釈が有効になります。無効 - リソースの既定のブランチで PR 注釈が無効になります。

名前	型	説明
Disabled	string
Enabled	string

AzureDevOpsProject

Azure DevOps Project リソース。

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties	AzureDevOpsProjectProperties	Azure DevOps Project のプロパティ。
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
type	string	リソースの種類。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AzureDevOpsProjectProperties

Azure DevOps Project のプロパティ。

名前	型	説明
actionableRemediation	ActionableRemediation	PR 注釈の構成ペイロード。
onboardingState	OnboardingState	すべてのコネクタでのリソースオンボードの状態に関する詳細。 OnboardedByOtherConnector - このリソースは既に別のコネクタにオンボードされています。これは、最上位レベルのリソースにのみ適用されます。オンボード - このリソースは、指定されたコネクタによって既にオンボードされています。 NotOnboarded - このリソースはどのコネクタにもオンボードされていません。 NotApplicable - オンボード状態は現在のエンドポイントには適用されません。
parentOrgName	string	親 Azure DevOps 組織名を取得または設定します。
projectId	string	Azure DevOps プロジェクト ID を取得または設定します。
provisioningState	DevOpsProvisioningState	リソースのプロビジョニング状態。保留中 - プロビジョニングが保留中です。失敗 - プロビジョニングに失敗しました。成功 - プロビジョニングに成功しました。キャンセル済み - プロビジョニングが取り消されました。 PendingDeletion - 削除保留中。 DeletionSuccess - 削除に成功しました。 DeletionFailure - 削除エラー。
provisioningStatusMessage	string	リソースの状態メッセージを取得します。
provisioningStatusUpdateTimeUtc	string	リソースが最後にチェックされた時刻を取得します。

CategoryConfiguration

PR 注釈のカテゴリ構成ごとの重大度レベル。

名前	型	説明
category	RuleCategory	ルールカテゴリ。コード - コードスキャンの結果。成果物のスキャン結果。依存関係のスキャン結果。 IaC の結果。結果をスキャンするシークレット。コンテナーのスキャン結果。
minimumSeverityLevel	string	特定のカテゴリの最小重大度レベルを取得または設定します。

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

DevOpsProvisioningState

リソースのプロビジョニング状態。

保留中 - プロビジョニングが保留中です。失敗 - プロビジョニングに失敗しました。成功 - プロビジョニングに成功しました。キャンセル済み - プロビジョニングが取り消されました。 PendingDeletion - 削除保留中。 DeletionSuccess - 削除に成功しました。 DeletionFailure - 削除エラー。

名前	型	説明
Canceled	string
DeletionFailure	string
DeletionSuccess	string
Failed	string
Pending	string
PendingDeletion	string
Succeeded	string

ErrorAdditionalInfo

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

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

ErrorDetail

エラーの詳細。

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

ErrorResponse

エラー応答

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

InheritFromParentState

設定を更新します。

有効 - リソースは親から構成を継承する必要があります。無効 - リソースは親から構成を継承しないでください。

名前	型	説明
Disabled	string
Enabled	string

OnboardingState

すべてのコネクタでのリソースオンボードの状態に関する詳細。

OnboardedByOtherConnector - このリソースは既に別のコネクタにオンボードされています。これは、最上位レベルのリソースにのみ適用されます。オンボード - このリソースは、指定されたコネクタによって既にオンボードされています。 NotOnboarded - このリソースはどのコネクタにもオンボードされていません。 NotApplicable - オンボード状態は現在のエンドポイントには適用されません。

名前	型	説明
NotApplicable	string
NotOnboarded	string
Onboarded	string
OnboardedByOtherConnector	string

RuleCategory

ルールカテゴリ。コード - コードスキャンの結果。成果物のスキャン結果。依存関係のスキャン結果。 IaC の結果。結果をスキャンするシークレット。コンテナーのスキャン結果。

名前	型	説明
Artifacts	string
Code	string
Containers	string
Dependencies	string
IaC	string
Secrets	string

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

TargetBranchConfiguration

PR 注釈のリポジトリブランチの構成。

名前	型	説明
annotateDefaultBranch	AnnotateDefaultBranchState	既定のブランチでの PR 注釈の構成。有効 - リソースの既定のブランチで PR 注釈が有効になります。無効 - リソースの既定のブランチで PR 注釈が無効になります。
branchNames	string[]	注釈が必要な分岐を取得または設定します。

名前

型

説明

annotateDefaultBranch

AnnotateDefaultBranchState

既定のブランチでの PR 注釈の構成。

有効 - リソースの既定のブランチで PR 注釈が有効になります。無効 - リソースの既定のブランチで PR 注釈が無効になります。

branchNames

string[]

注釈が必要な分岐を取得または設定します。

次の方法で共有

Azure DevOps Projects - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

CreateOrUpdate_AzureDevOpsProjects

要求のサンプル

応答のサンプル

定義

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsProject

AzureDevOpsProjectProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration

その他のリソース