ModifyCloudVendorAccountAK - Security Center - Centre de documentation Alibaba Cloud

Modifie la configuration de l'autorisation et de l'authentification des ressources multi-cloud.

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.

yundun-sas:ModifyCloudVendorAccountAK

update

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
AuthIds	string	Oui	L'identifiant unique de la paire AccessKey. Remarque Appelez l'opération DescribeCloudVendorAccountAKList pour obtenir ce paramètre.	2832
SecretId	string	Non	L'identifiant du paramètre AccessKey. Valeurs valides : Si AkType est défini sur primary : Tencent : AccessKeyId du compte principal HUAWEICLOUD : AccessKeyId du compte principal Azure : ClientId AWS : AccessKeyId du compte principal VOLCENGINE : AccessKeyId du compte principal Si AkType est défini sur sub : Tencent : AccessKeyId de l'utilisateur RAM HUAWEICLOUD : AccessKeyId de l'utilisateur RAM Azure : ClientId AWS : AccessKeyId de l'utilisateur RAM VOLCENGINE : AccessKeyId de l'utilisateur RAM google : private_key_id Remarque Si AkType est défini sur primary, cette valeur correspond au SecretID du compte principal sur le cloud tiers. Si AkType est défini sur sub, cette valeur correspond à l'identifiant de clé d'accès (Access Key ID) de l'utilisateur RAM sur le cloud tiers. Pour Azure, aucune distinction n'est faite et cette valeur correspond à l'appId des informations d'authentification. Google Cloud est accessible via un compte de service. AkType est défini sur sub par défaut, et cette valeur correspond à la valeur de la propriété private_key_id du fichier de clé de service au format JSON.	S3D6c4O***
SecretKey	string	Non	Le secret du paramètre AccessKey. Remarque Si AkType est défini sur primary, cette valeur correspond à la clé d'accès secrète (Secret Access Key) du compte principal sur le cloud tiers. Si AkType est défini sur sub, cette valeur correspond à la clé d'accès secrète de l'utilisateur RAM sur le cloud tiers. Pour Azure, aucune distinction n'est faite et cette valeur correspond au password des informations d'authentification. Google Cloud est accessible via un compte de service. AkType est défini sur sub par défaut, et cette valeur correspond à la valeur de la propriété private_key du fichier de clé de service au format JSON.	AE6SLd****
Regions	array	Non	La liste des régions utilisées pour la vérification des informations AccessKey.
	string	Non	La région utilisée pour la vérification des informations AccessKey. Remarque Ce paramètre n'est valide que lorsque Vendor est défini sur AWS. Appelez l'opération ListCloudVendorRegions pour obtenir ce paramètre.	ap-south-1
Status	integer	Non	L'état d'utilisation de la paire AccessKey. Valeurs valides : 0 : activé 1 : désactivé.	0
TenantId	string	Non	L'identifiant du locataire. Remarque Ce paramètre n'est valide que lorsque Vendor est défini sur Azure.	95304a97-339b-4de5-9a7d-cdbffaf****
SubscriptionIds	array	Non	La liste des identifiants d'abonnement. Remarque Ce paramètre n'est plus valide.
	string	Non	L'identifiant d'abonnement. Remarque Ce paramètre n'est plus valide.	9b41e7ae-fcbf-4983-aa32-6fb2e*****
Domain	string	Non	Le domaine du compte connecté. Valeurs valides : china : Chine global : mondial europe : Huawei Cloud Europe Remarque Ce paramètre n'est valide que lorsque Vendor est défini sur HUAWEICLOUD, Azure, AWS ou VOLCENGINE, et il est obligatoire.	global.
AuthModules	array	Non	La liste des codes de module associés à la paire AccessKey. Valeurs valides : HOST : hôte CSPM : vérification de la configuration des produits cloud SIEM : détection et réponse aux menaces cloud (CTDR) TRIAL : audit des journaux Remarque Appelez l'opération GetSupportedModules pour obtenir les modules pris en charge.
	string	Non	Le code de module associé à la paire AccessKey. Valeurs valides : HOST : hôte CSPM : vérification de la configuration des produits cloud SIEM : détection et réponse aux menaces cloud (CTDR) TRIAL : audit des journaux Remarque Appelez l'opération GetSupportedModules pour obtenir les modules pris en charge.	HOST.
Lang	string	Non	Le type de langue pour la requête et la réponse. Valeur par défaut : zh. Valeurs valides : zh : chinois en : anglais.	zh
VendorAuthAlias	string	Non	Le nom du compte AccessKey. Remarque Utilisé pour identifier le compte auquel appartiennent les ressources d'hôtes tiers.	test.
ExtendInfo	string	Non	Les informations étendues. Remarque Utilisé pour stocker des informations étendues pour différents fournisseurs. Google Cloud est accessible via un compte de service. ExtendInfo stocke le fichier de clé de service au format JSON, à l'exclusion des champs private_key_id et zprivate_key. Le fichier contient les champs suivants : type, project_id, client_email, client_id, auth_uri, token_uri, auth_provider_x509_cert_url, client_x509_cert_url et universe_domain.	{\"product\":\"pare-feu web\",\"remark\":\"remarque\"}
CtdrCloudUserId	string	Non	L'identifiant du compte. Remarque L'identifiant du compte du fournisseur de cloud connecté. Ce paramètre est obligatoire lorsque la description des autorisations inclut la détection et réponse aux menaces cloud (CTDR).	azure_demo_1

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud pour cette requête. Vous pouvez l'utiliser pour résoudre les problèmes.	6635CED5-4B20-5D2D-94EC-A1C8F9C****
Data	object	Les informations d'autorisation et d'authentification ajoutées.
Status	integer	L'état d'utilisation de la paire AccessKey. Valeurs valides : 0 : activé 1 : désactivé.	0
AuthId	integer	L'identifiant unique de la paire AccessKey.	2158
AkType	string	Le type de compte AccessKey. Valeurs valides : primary : compte principal sub : utilisateur RAM.	sub.
SecretId	string	L'identifiant du paramètre AccessKey. Remarque Si AkType est défini sur primary, cette valeur correspond au SecretID du compte principal sur le cloud tiers. Si AkType est défini sur sub, cette valeur correspond à l'identifiant de clé d'accès de l'utilisateur RAM sur le cloud tiers. Pour Azure, aucune distinction n'est faite et cette valeur correspond à l'appId des informations d'authentification.	AE6SLd****
ServiceStatus	integer	L'état de disponibilité de la paire AccessKey. Valeurs valides : 0 : en cours d'utilisation 1 : anormal 2 : vérification de validité en cours 3 : délai de vérification de validité dépassé.	0
Vendor	string	Le fournisseur de ressources cloud. Valeurs valides : Tencent : Tencent Cloud HUAWEICLOUD : Huawei Cloud Azure : Azure AWS : AWS VOLCENGINE : Volcengine google : Google Cloud CHAITIN : Chaitin Tech FORTINET : Fortinet THREATBOOK : ThreatBook.	Tencent.
Message	string	Les informations d'exception de la paire AccessKey.	L'utilisateur IAM n'est pas autorisé dans la région actuellement sélectionnée.
AuthModules	array<object>	La liste des modules associés à la paire AccessKey.
	object	Les informations sur le module associé à l'autorisation et à l'authentification.
ModuleDisp	string	Le nom d'affichage du module.	Ressources hôtes.
ModuleStatement	string	La description des autorisations associées au module.	Autorisation de lecture du serveur cloud ou de la machine virtuelle.
Module	string	Le code du module. Valeurs valides : HOST : hôte CSPM : vérification de la configuration des produits cloud SIEM : détection et réponse aux menaces cloud (CTDR) TRIAL : audit des journaux.	HOST.
ModuleAssetType	string	La description des ressources cloud associées au module.	Serveur cloud ou machine virtuelle.
ModuleServiceStatus	integer	L'état du module. Valeurs valides : 0 : en cours d'utilisation 1 : anormal 2 : vérification de validité en cours 3 : délai de vérification de validité dépassé.	0
Message	string	Les informations d'exception du module.	ak_domain_error.
VendorAuthAlias	string	Le nom du compte AccessKey. Remarque Utilisé pour identifier le compte auquel appartiennent les ressources d'hôtes tiers.	test.
CtdrCloudUserId	string	L'identifiant du compte. Remarque L'identifiant du compte du fournisseur de cloud connecté.	azure_demo_1

Exemples

JSON format

{
  "RequestId": "6635CED5-4B20-5D2D-94EC-A1C8F9C****",
  "Data": {
    "Status": 0,
    "AuthId": 2158,
    "AkType": "sub",
    "SecretId": "AE6SLd****",
    "ServiceStatus": 0,
    "Vendor": "Tencent",
    "Message": "The IAM user is forbidden in the currently selected region",
    "AuthModules": [
      {
        "ModuleDisp": "Host Assets",
        "ModuleStatement": "Read permission of the cloud server or virtual machine",
        "Module": "HOST",
        "ModuleAssetType": "Cloud server or virtual machine",
        "ModuleServiceStatus": 0,
        "Message": "ak_domain_error"
      }
    ],
    "VendorAuthAlias": "test",
    "CtdrCloudUserId": "azure_demo_1"
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

Notes de version

Consultez Notes de version pour la liste complète.