すべてのプロダクト
Search

このプロダクト

    CloudSSO:ListAccessConfigurations

    ドキュメントセンター

    CloudSSO:ListAccessConfigurations

    最終更新日:Dec 20, 2025

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

    操作説明

    このトピックでは、フォルダ 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

    任意

    次のページの結果を取得するためのトークン。最初のリクエストでは、このパラメーターを設定する必要はありません。

    結果の数が MaxResults の値を超えると、応答は切り捨てられます。IsTruncated パラメーターは true に設定され、NextToken が返されます。後続のリクエストで同じパラメーターを持つ NextToken を使用して、次のページの結果を取得できます。IsTruncated が false になるまでこのプロセスを繰り返し、すべての結果を照会します。

    K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
    MaxResults

    integer

    任意

    各ページで返すエントリの最大数。

    有効値：1～100。

    デフォルト値：10。

    10
    Filter

    string

    任意

    フィルター条件。

    フォーマットは です。フィルターでは大文字と小文字は区別されません。 は AccessConfigurationName のみをサポートします。 は eq (等しい) と sw (次で始まる) のみをサポートします。

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

    AccessConfigurationName sw test
    StatusNotifications

    string

    任意

    フィルター条件として使用されるステータス通知。

    値 ReprovisionRequired は、再プロビジョニングが必要なアクセス構成のみを返します。

    ReprovisionRequired
    Tags

    array<object>

    任意

    object

    任意

    Key

    string

    任意

    Value

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    AccessConfigurations

    array<object>

    アクセス構成のリスト。

    array<object>

    アクセス構成のリスト。

    AccessConfigurationName

    string

    アクセス構成の名前。

    ECS-Admin
    SessionDuration

    integer

    セッション期間。

    CloudSSO ユーザーがアクセス構成を使用してリソースディレクトリ (RD) 内のアカウントにアクセスする場合の最大セッション期間。

    単位：秒。

    900
    Description

    string

    アクセス構成の説明。

    This is an access configuration.
    RelayState

    string

    初期 Web ページ。

    CloudSSO ユーザーがアクセス構成を使用して RD 内のアカウントにアクセスした後にリダイレクトされる Web ページの URL。

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

    string

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

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

    string

    アクセス構成が最後に変更された時間。

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

    array

    ステータス通知。

    string

    ステータス通知。有効値：

    • 空：利用可能なステータス通知はありません。

    • ReprovisionRequired：アクセス構成を再プロビジョニングする必要があります。

    ReprovisionRequired
    AccessConfigurationId

    string

    アクセス構成の ID。

    ac-00jhtfl8thteu6uj****
    Tags

    array<object>

    object

    Key

    string

    Value

    string

    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": "",
          "Value": ""
        }
      ]
    }
  ],
  "NextToken": "K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****",
  "RequestId": "2BC0CBAC-45E1-5BD3-BF6E-F69D1D5391C2",
  "MaxResults": 10,
  "TotalCounts": 2,
  "IsTruncated": false
}

    エラーコード

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

    変更履歴

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