Tüm Ürünler
Search
Belge Merkezi

:GetAccessConfiguration

Son Güncelleme:Sep 30, 2026

Bir erişim yapılandırması hakkındaki bilgileri sorgular.

Operation description

Bu konu, kimliği ac-00ccule7tadaijxc**** olan erişim yapılandırması bilgilerinin nasıl sorgulanacağına dair bir örnek sunar.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

cloudsso:GetAccessConfiguration

get

*AccessConfiguration

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

None None

Request parameters

Parameter

Type

Required

Description

Example

AccessConfigurationId

string

Yes

Erişim yapılandırması kimliği.

ac-00ccule7tadaijxc****

DirectoryId

string

Yes

Dizin kimliği.

d-00fc2p61****

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

RequestId

string

İstek kimliği.

D5E40508-483B-52F6-993C-D880B0F87591

AccessConfiguration

object

Erişim yapılandırması bilgileri.

AccessConfigurationName

string

Erişim yapılandırmasının adı.

VPC-Admin

SessionDuration

integer

Oturum süresi.

Bir CloudSSO kullanıcısının, erişim yapılandırmasını kullanarak bir kaynak dizinindeki bir hesaba erişmesi sırasındaki maksimum oturum süresi.

Birim: saniye.

3600

Description

string

Erişim yapılandırmasının açıklaması.

This is an access configuration.

RelayState

string

İlk erişim sayfası.

Bir CloudSSO kullanıcısının, erişim yapılandırmasını kullanarak bir kaynak dizinindeki bir hesaba erişmesi sırasında görüntülenen ilk sayfanın URL'si.

https://cloudsso.console.alibabacloud.com

CreateTime

string

Erişim yapılandırmasının oluşturulduğu zaman.

2021-06-30T09:39:44Z

UpdateTime

string

Erişim yapılandırmasının en son değiştirildiği zaman.

2021-07-26T03:02:11Z

StatusNotifications

array

Durum bildirimi bilgileri.

string

Durum bildirimi bilgileri. Geçerli değerler:

  • Empty: Durum bildirimi yoktur.

  • ReprovisionRequired: Erişim yapılandırmasının yeniden sağlanması gerekir.

ReprovisionRequired

AccessConfigurationId

string

Erişim yapılandırması kimliği.

ac-00ccule7tadaijxc****

Tags

array<object>

Etiketler.

object

Key

string

Etiket anahtarı.

TestKey

Value

string

Etiket değeri.

TestValue

Examples

Success response

JSON format

{
  "RequestId": "D5E40508-483B-52F6-993C-D880B0F87591",
  "AccessConfiguration": {
    "AccessConfigurationName": "VPC-Admin",
    "SessionDuration": 3600,
    "Description": "This is an access configuration.",
    "RelayState": "https://cloudsso.console.alibabacloud.com",
    "CreateTime": "2021-06-30T09:39:44Z",
    "UpdateTime": "2021-07-26T03:02:11Z",
    "StatusNotifications": [
      "ReprovisionRequired"
    ],
    "AccessConfigurationId": "ac-00ccule7tadaijxc****",
    "Tags": [
      {
        "Key": "TestKey",
        "Value": "TestValue"
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.