DescribePolicyBindings - - Centre de documentation Alibaba Cloud

Consulte une ou plusieurs sources de données liées à une stratégie, ou consulte une ou plusieurs stratégies liées à une source de données.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

hbr:DescribePolicyBindings

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NextToken	string	Non	Le jeton requis pour obtenir la page suivante des associations stratégie-source de données.	caeba0bbb2be03f84eb48b699f0a
MaxResults	integer	Non	Le nombre de résultats pour chaque requête.	10
PolicyId	string	Non	L'identifiant de la stratégie.	po-000************hky
DataSourceIds	array	Non	La liste des identifiants des sources de données.
	string	Non	L'identifiant de la source de données.	i-uf6************68n
SourceType	string	Non	Le type de source de données. Valeurs valides :	UDM_ECS
Filters	array<object>	Non	Les filtres de requête.
	object	Non	Les filtres de requête.
Key	string	Non	La clé dans le filtre de requête. Valeurs valides :	DataSourceType
Operator	string	Non	La méthode de correspondance. Valeur par défaut : IN. L'opération de correspondance (Operator) prise en charge par la clé (Key) et la valeur (Value) dans le filtre. Valeurs valides :	IN
Values	array	Non	Les valeurs à faire correspondre dans le filtre de requête.
	string	Non	Les valeurs à faire correspondre dans le filtre de requête.	UDM_ECS

Éléments de réponse

Élément	Type	Description	Exemple
	object	DescribePolicyBindingsResponse.
PolicyBindings	array<object>	La liste des liaisons de stratégie.
	array<object>	Les détails d'une liaison de stratégie.
CreatedTime	integer	L'heure de création. Horodatage UNIX, en secondes.	1661399570
UpdatedTime	integer	L'heure de mise à jour. Horodatage UNIX, en secondes.	1653611573
PolicyBindingId	string	L'identifiant de la liaison de stratégie.	pd-000************slc
PolicyBindingDescription	string	La description de la liaison de stratégie.	po-000**********eslc-i-uf6**********y5g
PolicyId	string	L'identifiant de la stratégie.	po-000************56y
DataSourceId	string	L'identifiant de la source de données.	i-8vb************5ly
Disabled	boolean	Indique si la stratégie est effective pour la source de données.	true
Source	string	Si SourceType est défini sur OSS, ce paramètre spécifie le préfixe à sauvegarder. S'il n'est pas spécifié, l'intégralité du répertoire racine du compartiment est sauvegardée.	backup/
Include	string	Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE ou File. Spécifie les types de fichiers à sauvegarder. Tous les fichiers de ces types sont sauvegardés. Maximum de 255 caractères.	[".doc",".xltm"]
Exclude	string	Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE ou File. Spécifie les types de fichiers à exclure de la sauvegarde. Tous les fichiers de ces types ne sont pas sauvegardés. Maximum de 255 caractères.	[".doc",".xltm"]
SpeedLimit	string	Ce paramètre est requis uniquement lorsque SourceType est défini sur ECS_FILE ou File. Spécifie le contrôle du trafic de sauvegarde. Format : `{start}{end}{bandwidth}`. Plusieurs configurations de contrôle du trafic sont séparées par des délimiteurs, et les heures de configuration ne peuvent pas se chevaucher.	0:24:10240
AdvancedOptions	object	Les options avancées.
UdmDetail	object	The advanced options for ECS instance backup.
ExcludeDiskIdList	array	The list of disk IDs to exclude from the backup. This parameter is ignored if `DiskIdList` is not empty.
	string	The ID of the disk to exclude from the backup.	d-bp1************apo
DiskIdList	array	The list of disk IDs to back up. If you want to back up all disks, leave this parameter empty.
	string	The ID of the disk to back up.	d-bp1************apo
SnapshotGroup	boolean	Indicates whether to create a snapshot-consistent group. You can create a snapshot-consistent group only when all disks of the instance are Enhanced SSDs (ESSDs).	true
AppConsistent	boolean	Indicates whether to create an application-consistent snapshot. You can create an application-consistent snapshot only when all disks of the instance are ESSDs.	false
RamRoleName	string	This parameter is required only if AppConsistent is set to true. This parameter specifies the name of the RAM role that is required to create an application-consistent snapshot.	AliyunECSInstanceForHbrRole
PreScriptPath	string	This parameter is required only if AppConsistent is set to true. This parameter specifies the path of the pre-freeze script that is run before the application-consistent snapshot is created.	/tmp/prescript.sh
PostScriptPath	string	This parameter is required only if AppConsistent is set to true. This parameter specifies the path of the post-thaw script that is run after the application-consistent snapshot is created.	/tmp/postscript.sh
EnableFsFreeze	boolean	This parameter is required only if AppConsistent is set to true. This parameter indicates whether to use the `fsfreeze` command of the Linux operating system to put the file system in a read-only state before you create an application-consistent snapshot. The default value is true.	true
TimeoutInSeconds	integer	This parameter is required only if AppConsistent is set to true. This parameter specifies the timeout period for I/O freeze. The default value is 30 seconds.	30
EnableWriters	boolean	This parameter is required only if AppConsistent is set to true. Indicates whether to create an application-consistent snapshot: true: Create an application-consistent snapshot. false: Create a file system-consistent snapshot. Default value: true.	true
DestinationKmsKeyId	string	The ID of a customer managed key (CMK) in the destination region. If you enable cross-region replication and specify this parameter, the cross-region backup is encrypted using the specified key.	4ed37b1e-da51-4187-aceb-9db4f9b7148b
OssDetail	object	The advanced options for OSS backup.
InventoryId	string	The name of the OSS inventory. If you specify this parameter, an OSS inventory is used for performance optimization. The storage fees for inventory files are charged by OSS. It takes time to generate an OSS inventory file. The backup job may fail before the inventory file is generated. You can wait for the next backup cycle to run.	inventory_test
InventoryCleanupPolicy	string	Indicates whether to delete the inventory file after a backup. This parameter is valid only when an OSS inventory is used. Valid values: NO_CLEANUP: The inventory file is not deleted. DELETE_CURRENT: The current inventory file is deleted. DELETE_CURRENT_AND_PREVIOUS: All inventory files are deleted.	DELETE_CURRENT_AND_PREVIOUS
IgnoreArchiveObject	boolean	Indicates whether to exclude archive objects from the backup job statistics and the list of failed files.	true
FileDetail	object	The advanced options for file backup.
UseVSS	boolean	Indicates whether to enable the Volume Shadow Copy Service (VSS) feature. This feature is available only for Windows instances. Valid values: true: Enable the VSS feature. false: Disable the VSS feature.	false
AdvPolicy	boolean	Indicates whether to use an advanced policy. Valid values: true: Use an advanced policy. false: Do not use an advanced policy.	false
CommonNasDetail	object	The advanced options for on-premises NAS.
FullOnIncrementFail	boolean	Indicates whether to run a full backup if an incremental backup fails. Valid values: true: Run a full backup. false: Do not run a full backup.	true
FetchSliceSize	integer	The size of a backup shard, which is the number of files.	100000
ClientId	string	The backup client ID.	c-0001eg6mcvjs93f46s2d
ClusterId	string	The client group ID.	cl-000gkcofngi04j6k680a
CommonFileSystemDetail	object	The advanced options for large-scale file system backup.
FullOnIncrementFail	boolean	Indicates whether to run a full backup if an incremental backup fails. Valid values: true: Run a full backup. false: Do not run a full backup.	true
FetchSliceSize	integer	The size of a backup shard, which is the number of files.	100000
SourceType	string	Le type de source de données. Valeurs valides :	UDM_ECS
CrossAccountType	string	Le type de sauvegarde intercomptes. Valeurs valides :	CROSS_ACCOUNT
CrossAccountUserId	integer	L'identifiant du compte source pour la sauvegarde intercomptes.	1480************
CrossAccountRoleName	string	Le nom du rôle RAM créé dans le compte source pour la sauvegarde intercomptes.	hbrcrossrole
CreatedByTag	boolean	Indique si la ressource est automatiquement associée via une balise de ressource de stratégie de sauvegarde.	false
HitTags	array<object>	Les règles de balise correspondantes.
	object
Key	string	The tag key.	env
Value	string	The tag value.	prod
Operator	string	The tag matching rule. EQUAL: Matches the tag key and tag value. NOT: Matches the tag key but not the tag value.	EQUAL
NextToken	string	Le jeton requis pour obtenir la page suivante des liaisons stratégie-source de données.	caeba0bbb2be03f84eb48b699f0a
MaxResults	integer	Le nombre de résultats pour chaque requête.	10
TotalCount	integer	Le nombre total d'enregistrements.	38
Success	boolean	Indique si la requête a réussi.	true
Code	string	Le code de réponse. 200 indique un succès.	200
Message	string	Le message renvoyé. « successful » est renvoyé en cas de succès. Un message d'erreur est renvoyé en cas d'échec.	successful
RequestId	string	L'identifiant de la requête.	5225929A-4EBD-55EE-9FE1-4A130E582A76

Exemples

JSON format

{
  "PolicyBindings": [
    {
      "CreatedTime": 1661399570,
      "UpdatedTime": 1653611573,
      "PolicyBindingId": "pd-000************slc",
      "PolicyBindingDescription": "po-000************eslc-i-uf6************y5g",
      "PolicyId": "po-000************56y",
      "DataSourceId": "i-8vb************5ly",
      "Disabled": true,
      "Source": "backup/",
      "Include": "[\\\"*.doc\\\",\\\"*.xltm\\\"]",
      "Exclude": "[\\\"*.doc\\\",\\\"*.xltm\\\"]",
      "SpeedLimit": "0:24:10240",
      "AdvancedOptions": {
        "UdmDetail": {
          "ExcludeDiskIdList": [
            "d-bp1************apo\n"
          ],
          "DiskIdList": [
            "d-bp1************apo\n"
          ],
          "SnapshotGroup": true,
          "AppConsistent": false,
          "RamRoleName": "AliyunECSInstanceForHbrRole",
          "PreScriptPath": "/tmp/prescript.sh",
          "PostScriptPath": "/tmp/postscript.sh",
          "EnableFsFreeze": true,
          "TimeoutInSeconds": 30,
          "EnableWriters": true,
          "DestinationKmsKeyId": "4ed37b1e-da51-4187-aceb-9db4f9b7148b"
        },
        "OssDetail": {
          "InventoryId": "inventory_test",
          "InventoryCleanupPolicy": "DELETE_CURRENT_AND_PREVIOUS",
          "IgnoreArchiveObject": true
        },
        "FileDetail": {
          "UseVSS": false,
          "AdvPolicy": false
        },
        "CommonNasDetail": {
          "FullOnIncrementFail": true,
          "FetchSliceSize": 100000,
          "ClientId": "c-0001eg6mcvjs93f46s2d",
          "ClusterId": "cl-000gkcofngi04j6k680a"
        },
        "CommonFileSystemDetail": {
          "FullOnIncrementFail": true,
          "FetchSliceSize": 100000
        }
      },
      "SourceType": "UDM_ECS",
      "CrossAccountType": "CROSS_ACCOUNT",
      "CrossAccountUserId": 0,
      "CrossAccountRoleName": "hbrcrossrole",
      "CreatedByTag": false,
      "HitTags": [
        {
          "Key": "env",
          "Value": "prod",
          "Operator": "EQUAL"
        }
      ]
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a",
  "MaxResults": 10,
  "TotalCount": 38,
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "5225929A-4EBD-55EE-9FE1-4A130E582A76"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.