Method: organizations.locations.securityHealthAnalyticsCustomModules.create

指定された組織、フォルダ、またはプロジェクトのスコープに常駐 SecurityHealthAnalyticsCustomModule を作成し、指定された親の子孫であるすべてのフォルダとプロジェクトに継承された SecurityHealthAnalyticsCustomModule リソースを作成します。これらのモジュールはデフォルトで有効になっています。

HTTP リクエスト

POST https://securitycentermanagement.googleapis.com/v1/{parent=organizations/*/locations/*}/securityHealthAnalyticsCustomModules

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。モジュールの親の組織、フォルダ、プロジェクトの名前(次のいずれかの形式)。

  • organizations/{organization}/locations/{location}
  • folders/{folder}/locations/{location}
  • projects/{project}/locations/{location}

クエリ パラメータ

パラメータ
validateOnly

boolean

省略可。true に設定すると、リクエストは検証されます(IAM チェックを含む)が、モジュールは作成されません。OK レスポンスはリクエストが有効であることを示します。エラー レスポンスはリクエストが無効であることを示します。

リクエストが有効であっても、次のいずれかの理由で、モジュールの作成に関する後続のリクエストが失敗することがあります。

  • クラウド リソースの状態が変更された(必要な IAM 権限が失われたなど)
  • モジュールの作成中にエラーが発生しました

デフォルトは false です。

リクエストの本文

リクエストの本文には SecurityHealthAnalyticsCustomModule のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された SecurityHealthAnalyticsCustomModule のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。

IAM 権限

parent リソースに対する次の IAM 権限が必要です。

  • securitycentermanagement.securityHealthAnalyticsCustomModules.create

詳細については、IAM のドキュメントをご覧ください。