GetPasswordPolicy - - Alibaba Cloud Dokümantasyon Merkezi

CloudSSO kullanıcılarının parola politikasını sorgular.

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:GetPasswordPolicy

get

*Directory

acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}

None

Request parameters

Parameter	Type	Required	Description	Example
DirectoryId	string	Yes	Dizin kimliği.	d-00fc2p61****

Response elements

Element	Type	Description	Example
	object	Döndürülen sonuç.
RequestId	string	İstek kimliği.	B7C6E839-FB65-59BE-B753-003AA8AF7DF7
PasswordPolicy	object	Parola politikası.
MinPasswordLength	integer	Minimum parola uzunluğu.\n\nGeçerli değerler: 8 ila 32 karakter.	8
MinPasswordDifferentChars	integer	Bir paroladaki minimum farklı karakter sayısı.\n\nMinimum değer 0'dır ve bu değer, paroladaki minimum farklı karakter sayısının sınırlı olmadığını gösterir. Maksimum değer, MinPasswordLength parametresinin değeridir.	8
PasswordNotContainUsername	boolean	Kullanıcı adının paroladan hariç tutulup tutulmayacağını gösterir. Geçerli değerler:\n- true: Parola kullanıcı adını içeremez.\n- false: Parola kullanıcı adını içerebilir.	true
MaxPasswordAge	integer	Bir parolanın geçerlilik süresi.\n\nGeçerli değerler: 1 ila 120. Birim: gün.	90
PasswordReusePrevention	integer	Parola geçmişi kontrolü politikası.\n\nÖnceki N parola yeniden kullanılamaz. N için geçerli değerler: 0 ila 24. 0 değeri, tüm geçmiş parolaların yeniden kullanılabileceğini gösterir.\n\n> 5 Ocak 2024 tarihinden önce oluşturulan parolalar geçmiş parola olarak sayılmaz.	1
MaxLoginAttempts	integer	Parola yeniden deneme sayısı.\n\nBelirtilen ardışık kez yanlış parola girilirse hesap 1 saat süreyle kilitlenir.\n\nGeçerli değerler: 0 ila 32. 0 değeri, parola yeniden deneme sayısının sınırlı olmadığını gösterir.	5
RequireNumbers	boolean	Parolada rakam bulunmasının zorunlu olup olmadığını gösterir. Geçerli değerler:\n- true: Parolada rakam bulunması zorunludur.\n- false: Parolada rakam bulunması zorunlu değildir.	true
RequireLowerCaseChars	boolean	Parolada küçük harf bulunmasının zorunlu olup olmadığını gösterir. Geçerli değerler:\n- true: Parolada küçük harf bulunması zorunludur.\n- false: Parolada küçük harf bulunması zorunlu değildir.	true
MaxPasswordLength	integer	Maksimum parola uzunluğu.	32
RequireUpperCaseChars	boolean	Parolada büyük harf bulunmasının zorunlu olup olmadığını gösterir. Geçerli değerler:\n- true: Parolada büyük harf bulunması zorunludur.\n- false: Parolada büyük harf bulunması zorunlu değildir.	true
RequireSymbols	boolean	Parolada özel karakter bulunmasının zorunlu olup olmadığını gösterir. Geçerli değerler:\n- true: Parolada özel karakter bulunması zorunludur.\n- false: Parolada özel karakter bulunması zorunlu değildir.	true
HardExpire	boolean	Parola süresi dolduktan sonra oturum açmanın devre dışı bırakılıp bırakılmayacağını gösterir. Geçerli değerler:\n- true: Parola süresi dolduktan sonra oturum açmayı devre dışı bırakır.\n- false: Parola süresi dolduktan sonra oturum açmayı devre dışı bırakmaz.	true

Examples

Success response

JSON format

{
  "RequestId": "B7C6E839-FB65-59BE-B753-003AA8AF7DF7",
  "PasswordPolicy": {
    "MinPasswordLength": 8,
    "MinPasswordDifferentChars": 8,
    "PasswordNotContainUsername": true,
    "MaxPasswordAge": 90,
    "PasswordReusePrevention": 1,
    "MaxLoginAttempts": 5,
    "RequireNumbers": true,
    "RequireLowerCaseChars": true,
    "MaxPasswordLength": 32,
    "RequireUpperCaseChars": true,
    "RequireSymbols": true,
    "HardExpire": true
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.