すべてのプロダクト
Search

このプロダクト

    CloudSSO:ListAccessConfigurations

    ドキュメントセンター

    CloudSSO:ListAccessConfigurations

    最終更新日:Aug 12, 2026

    アクセス構成のリストを照会します。

    操作説明

    この Topic では、ディレクトリ d-00fc2p61**** 内のアクセス構成をクエリする方法の例を示します。応答には、VPC-Admin と ECS-Admin の 2 つのアクセス構成が存在することが示されています。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cloudsso:ListAccessConfigurations

    list

    *AccessConfiguration

    acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DirectoryId

    string

    必須

    ディレクトリの ID。

    d-00fc2p61****
    NextToken

    string

    任意

    結果の次のページのトークン。最初の API 呼び出しでは NextToken を指定する必要はありません。

    この API オペレーションを初めて呼び出す際、結果の総数が MaxResults の制限を超える場合、結果は切り捨てられ、MaxResults で指定された数のエントリのみが返されます。この場合、IsTruncated パラメーターは true にセットされ、NextToken が返されます。前回呼び出し時に返された NextToken を使用し、他のリクエストパラメーターを変更せずにこの API オペレーションの呼び出しを継続することで、切り捨てられた結果をクエリできます。すべてのデータが取得されたことを示す IsTruncated が false になるまで、この操作を繰り返すことができます。

    K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
    MaxResults

    integer

    任意

    ページあたりのエントリの最大値。

    有効な値: 1～100。

    デフォルト値: 10。

    10
    Filter

    string

    任意

    フィルター条件。

    フォーマット: 。フィルターは大文字と小文字を区別しません。現在、 は AccessConfigurationName のみをサポートし、 は eq (Equals) および sw (Start With) のみをサポートします。

    例: Filter = "AccessConfigurationName sw test" は、名前が test で始まるすべてのアクセス構成を照会します。Filter = "AccessConfigurationName eq TestAccessConfiguration" は、TestAccessConfiguration という名前のアクセス構成を照会します。

    AccessConfigurationName sw test
    StatusNotifications

    string

    任意

    ステータス通知情報。クエリのフィルター条件として使用されます。

    有効な値: ReprovisionRequired。再プロビジョニングが必要なアクセス構成をクエリします。

    ReprovisionRequired
    Tags

    array<object>

    任意

    タグのリスト。

    object

    任意

    Key

    string

    任意

    タグキー。

    TestKey
    Value

    string

    任意

    タグ値。

    TestValue

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答。

    AccessConfigurations

    array<object>

    アクセス構成のリスト。

    array<object>

    アクセス構成のリスト。

    AccessConfigurationName

    string

    アクセス構成の名前。

    ECS-Admin
    SessionDuration

    integer

    セッション期間。

    CloudSSO ユーザーがアクセス構成を使用してリソースディレクトリ内のアカウントにアクセスする際のセッションの最大持続時間。

    単位: 秒。

    900
    Description

    string

    アクセス構成の説明。

    これはアクセス構成です。
    RelayState

    string

    初期アクセスページ。

    CloudSSO ユーザーがアクセス構成を使用してリソースディレクトリ内のアカウントにアクセスする際に表示される初期ページの URL。

    https://cloudsso.console.alibabacloud.com
    CreateTime

    string

    アクセス構成が作成された時間。

    2021-11-02T08:44:23Z
    UpdateTime

    string

    アクセス構成が最後に変更済みの時間。

    2021-11-02T08:44:23Z
    StatusNotifications

    array

    ステータス通知情報。

    string

    ステータス通知情報。有効な値:

    • Empty: ステータス通知情報が存在しません。

    • ReprovisionRequired: アクセス構成の再プロビジョニングが必要です。

    ReprovisionRequired
    AccessConfigurationId

    string

    アクセス構成の ID。

    ac-00jhtfl8thteu6uj****
    Tags

    array<object>

    タグのリスト。

    object

    Key

    string

    TestKey
    Value

    string

    TestValue
    NextToken

    string

    結果の次のページのトークン。

    説明

    このパラメーターは、IsTruncated が true の場合にのみ返されます。

    K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
    RequestId

    string

    リクエスト ID。

    2BC0CBAC-45E1-5BD3-BF6E-F69D1D5391C2
    MaxResults

    integer

    ページあたりのエントリの最大値。

    10
    TotalCounts

    integer

    リクエストパラメーターに一致するエントリの総数。

    2
    IsTruncated

    boolean

    結果が切り捨てられているかどうかを示します。有効な値:

    • true: 結果が切り捨てられています。

    • false: 結果は切り捨てられていません。

    false

    例

    成功レスポンス

    JSONJSON

    {
  "AccessConfigurations": [
    {
      "AccessConfigurationName": "ECS-Admin",
      "SessionDuration": 900,
      "Description": "This is an access configuration.",
      "RelayState": "https://cloudsso.console.alibabacloud.com",
      "CreateTime": "2021-11-02T08:44:23Z",
      "UpdateTime": "2021-11-02T08:44:23Z",
      "StatusNotifications": [
        "ReprovisionRequired"
      ],
      "AccessConfigurationId": "ac-00jhtfl8thteu6uj****",
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ]
    }
  ],
  "NextToken": "K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****",
  "RequestId": "2BC0CBAC-45E1-5BD3-BF6E-F69D1D5391C2",
  "MaxResults": 10,
  "TotalCounts": 2,
  "IsTruncated": false
}

    エラーコード

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

    変更履歴

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