すべてのプロダクト
Search

このプロダクト

    Identity as a Service:CreateConditionalAccessPolicy

    ドキュメントセンター

    Identity as a Service:CreateConditionalAccessPolicy

    最終更新日:Jun 24, 2026

    条件付きのアクセスポリシーを作成します。

    操作説明

    条件付きのアクセスポリシーを作成します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eiam:CreateConditionalAccessPolicy

    create

    *ConditionalAccessPolicy

    acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/conditionalaccesspolicy/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    インスタンス ID。

    idaas_ue2jvisn35ea5lmthk267xxxxx
    ConditionalAccessPolicyName

    string

    必須

    条件付きのアクセスポリシー名。

    My conditional access policy
    Description

    string

    任意

    条件付きのアクセスポリシーの説明。

    Test description
    ConditionalAccessPolicyType

    string

    必須

    条件付きのアクセスポリシータイプ。有効な値:

    arn:alibaba:idaas:authn:access:policy:system: システムポリシー。

    列挙値:

    • arn:alibaba:idaas:authn:access:policy:system :

      arn:alibaba:idaas:authn:access:policy:system: システムアクセスポリシー。

    arn:alibaba:idaas:authn:access:policy:system
    DecisionType

    string

    必須

    条件付きのアクセスポリシー実行タイプ。有効な値:

    enforcement: 強制ポリシー。

    列挙値:

    • enforcement :

      enforcement。

    enforcement
    EvaluateAt

    string

    必須

    条件付きのアクセスポリシー評価ポイント。有効な値:

    • arn:alibaba:idaas:authn:access:rule:eval_at:after_step1: 許可。

    列挙値:

    • arn:alibaba:idaas:authn:access:rule:eval_at:after_step1 :

      arn:alibaba:idaas:authn:access:rule:eval_at:after_step1: アクセスルール評価ポイント。

    arn:alibaba:idaas:authn:access:rule:eval_at:after_step1
    DecisionConfig

    object

    任意

    条件付きのアクセスポリシー操作構成。

    Effect

    string

    任意

    条件付きアクセスポリシー決定操作。有効な値:

    • allow: 許可。

    • deny: 拒否。

    列挙値:

    • allow :

      allow。

    • deny :

      拒否。

    allow or deny
    MfaType

    string

    任意

    条件付きアクセスポリシー多要素認証 (MFA) タイプ。有効な値:

    • directly_access: 直接アクセス。

    • mfa_required: 多要素認証 (MFA) 必須。

    列挙値:

    • directly_access :

      直接アクセス。

    • mfa_required :

      多要素認証 (MFA) 必須。

    directly_access
    MfaAuthenticationIntervalSeconds

    integer

    任意

    条件付きアクセスポリシー再認証間隔（秒）。

    • 最大値の多要素認証 (MFA) 認証間隔: 86400。

    • 最小値の多要素認証 (MFA) 認証間隔: 300。

    500
    MfaAuthenticationMethods

    array

    任意

    条件付きのアクセスポリシーで許可される多要素認証 (MFA) タイプ。有効な値:

    • ia_otp_sms: SMS 検証コード。

    • ia_otp_email: メール検証コード。

    • ia_totp: OTP 動的パスワード。

    • ia_webauthn: WebAuthn。

    列挙値:

    • ia_otp_email :

      ia_otp_email。

    • ia_otp_sms :

      ia_otp_sms。

    • ia_webauthn :

      ia_webauthn。

    • ia_totp :

      ia_totp。

    string

    任意

    多要素認証 (MFA) タイプ。

    ia_totp
    ActiveSessionReuseStatus

    string

    任意

    会話の再利用を有効にするかどうかを指定します。

    列挙値:

    • disabled :

      disabled。

    • enabled :

      有効。

    enabled
    ConditionsConfig

    object

    任意

    条件付きのアクセスポリシー条件構成。

    Applications

    object

    任意

    条件付きアクセスポリシーの対象アプリケーション。

    IncludeApplications

    array

    任意

    含まれるアプリケーション。

    string

    任意

    アプリケーション ID。

    app_xxxx
    ExcludeApplications

    array

    任意

    除外されるアプリケーション。

    string

    任意

    アプリケーション ID。

    app_xxxx
    Users

    object

    任意

    条件付きアクセスポリシーの対象ユーザー。

    IncludeUsers

    array

    任意

    含まれるユーザー。

    string

    任意

    ユーザー ID。

    user_xxxx
    ExcludeUsers

    array

    任意

    除外されるユーザー。

    string

    任意

    ユーザー ID。

    user_xxxx
    IncludeGroups

    array

    任意

    含まれるユーザーグループ。

    string

    任意

    グループ ID。

    group_xxxxx
    ExcludeGroups

    array

    任意

    除外されるユーザーグループ。

    string

    任意

    グループ ID。

    group_xxxxx
    IncludeOrganizationalUnits

    array

    任意

    含まれる組織単位。

    string

    任意

    組織単位 ID。

    ou_sdfnbsxxxx
    ExcludeOrganizationalUnits

    array

    任意

    除外される組織単位。

    string

    任意

    組織単位 ID。

    ou_xxxxx
    NetworkZones

    object

    任意

    条件付きアクセスポリシーのネットワークゾーン。

    IncludeNetworkZones

    array

    任意

    含まれるネットワークゾーン。

    string

    任意

    ネットワークゾーン ID。

    network_xxxxx
    ExcludeNetworkZones

    array

    任意

    除外されるネットワークゾーン。

    string

    任意

    ネットワークゾーン ID。

    network_xxxxx
    Priority

    integer

    任意

    条件付きのアクセスポリシー優先度。値が小さいほど優先度が高くなります。 最小値: 1。 最大値: 100。

    1
    ClientToken

    string

    任意

    冪等性トークン。

    client-token-example

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

    0441BD79-92F3-53AA-8657-F8CE4A2B912A
    ConditionalAccessPolicyId

    string

    条件付きアクセスポリシー ID。

    cp_xxxxx

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "ConditionalAccessPolicyId": "cp_xxxxx"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。