GetServiceProvisions - - Centre de documentation Alibaba Cloud

Consulte l'état d'activation d'un service Alibaba Cloud et les informations sur ses rôles liés au service.

Description de l'opération

Remarques sur l'utilisation

Cette rubrique fournit un exemple de requête pour consulter l'état d'activation d'Elastic High Performance Computing (EHPC) et les informations sur les rôles liés au service pour EHPC dans la région de Chine (Hangzhou).

Remarque

Assurez-vous de disposer des autorisations nécessaires pour appeler l'opération GetRole.

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.

ros:GetServiceProvisions

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Vous pouvez appeler l'opération DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
TemplateBody	string	Non	La structure du corps du modèle. Le corps du modèle doit avoir une longueur de 1 à 524 288 octets. Si la longueur du corps du modèle dépasse la limite supérieure, nous vous recommandons d'utiliser la méthode HTTP POST + Body Param pour transmettre le paramètre dans le corps de la requête afin d'éviter les échecs de requête causés par une URL excessivement longue. Remarque Vous ne pouvez spécifier qu'un seul des paramètres TemplateBody, TemplateURL, TemplateId et Services.	ROSTemplateFormatVersion: '2015-09-01'\r\nResources:\r\n Vpc:\r\n Type: ALIYUN::ECS::VPC\r\n Properties:\r\n CidrBlock: 192.168.0.0/24\r\n VpcName: TestVpc
TemplateURL	string	Non	L'URL du fichier qui contient le corps du modèle. L'URL doit pointer vers un modèle situé sur un serveur web HTTP ou HTTPS ou dans un compartiment Object Storage Service (OSS). Le corps du modèle doit avoir une longueur de 1 à 524 288 octets. Exemples d'URL OSS : oss://ros/template/demo et oss://ros/template/demo?RegionId=cn-hangzhou. Si vous ne spécifiez pas l'identifiant de région du compartiment OSS, la valeur du paramètre RegionId est utilisée. Vous ne pouvez spécifier qu'un seul des paramètres TemplateBody, TemplateURL, TemplateId et Services.	oss://ros-template/demo
TemplateId	string	Non	L'identifiant du modèle. Ce paramètre s'applique aux modèles partagés et privés. Vous ne pouvez spécifier qu'un seul des paramètres TemplateBody, TemplateURL, TemplateId et Services.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	Non	La version du modèle. Si vous ne spécifiez pas ce paramètre, la dernière version est utilisée. Ce paramètre prend effet uniquement lorsque vous spécifiez TemplateId.	v1
Parameters	array<object>	Non	Les paramètres.
	object	Non
ParameterKey	string	Oui	Le nom du paramètre. Si vous ne spécifiez pas le nom et la valeur d'un paramètre, Resource Orchestration Service (ROS) utilise le nom et la valeur par défaut spécifiés dans le modèle. Remarque Le paramètre Parameters est facultatif. Si vous spécifiez Parameters, vous devez spécifier ParameterKey.	Amount
ParameterValue	string	Oui	La valeur du paramètre. Remarque Le paramètre Parameters est facultatif. Si vous spécifiez Parameters, vous devez spécifier ParameterValue.	12
Services	array<object>	Non	La liste des services Alibaba Cloud.
	object	Non
ServiceName	string	Oui	Le nom du service Alibaba Cloud. Valeurs valides : AHAS : Application High Availability Service. ARMS : Application Real-Time Monitoring Service. ApiGateway : API Gateway. BatchCompute : Batch Compute. BrainIndustrial : Industrial Intelligence. CloudStorageGateway : Cloud Storage Gateway. CMS : Cloud Monitor. CR : Container Registry. CS : Container Service. DCDN : DCDN. DataHub : DataHub. DataWorks : DataWorks. EDAS : Enterprise Distributed Application Service. EHPC : Elastic High Performance Computing. EMAS : Enterprise Mobile Application Studio. FC : Function Compute. FNF : CloudFlow. MaxCompute : MaxCompute. SMQ : Simple Message Queue (anciennement MNS). HBR : Cloud Backup. IMM : Intelligent Media Management. IOT : IoT Platform. KMS : Key Management Service. NAS : File Storage NAS. NLP : Natural Language Processing. OSS : Object Storage Service. OTS : Tablestore. PrivateLink : PrivateLink. PrivateZone : PrivateZone. RocketMQ : Message Queue for Apache RocketMQ. SAE : Serverless App Engine. SLS : Simple Log Service. TrafficMirror : Traffic Mirroring. VS : Video Surveillance. Xtrace : Tracing Analysis.	EHPC

Pour plus d'informations sur les paramètres de requête courants, consultez Paramètres courants.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	A9938C04-26AD-5EFA-B394-EA7866842DFF
ServiceProvisions	array<object>	Les détails des services Alibaba Cloud.
	array<object>
ServiceName	string	Le nom du service Alibaba Cloud.	EHPC
Status	string	L'état d'activation du service Alibaba Cloud. Valeurs valides : Enabled : le service est activé. Disabled : le service n'est pas activé. Unknown : l'état d'activation est inconnu.	Enabled
StatusReason	string	La raison pour laquelle le service Alibaba Cloud n'est pas activé ou dont l'état d'activation est inconnu. Remarque Ce paramètre est renvoyé uniquement lorsque la valeur de Status est Disabled ou Unknown.	Aucune autorisation
AutoEnableService	boolean	Indique si le service est automatiquement activé lorsque le modèle est utilisé pour créer une pile. Valeurs valides : true : le service est automatiquement activé. false : le service n'est pas automatiquement activé.	false
EnableURL	string	L'URL que vous pouvez utiliser pour activer le service Alibaba Cloud. Remarque Ce paramètre est renvoyé uniquement lorsque la valeur de Status est Disabled.	https://common-buy-intl.alibabacloud.com/?commodityCode=nas
RoleProvision	object	Les informations sur les rôles liés au service du service Alibaba Cloud. Si ce paramètre est vide, aucun rôle lié au service n'est associé au service.
AuthorizationURL	string	The URL that you can use to grant permissions to the service-linked role. Remarque This parameter is returned only when the value of Created is false.	https://ehpc.console.alibabacloud.com/
Roles	array<object>	The service-linked roles.
	array<object>
RoleName	string	The name of the service-linked role.	AliyunServiceRoleForEHPC
Created	boolean	Indicates whether the service-linked role is created. Valid values: true: The service-linked role is created. false: The service-linked role is not created.	true
Function	string	The purpose of the role. Default value: Default. This value indicates that the role is the default role of the service.	Default
ApiForCreation	object	The information about the API operation that is used to create the role.
ApiProductId	string	The ID of the Alibaba Cloud service to which the API operation belongs.	rds
ApiName	string	The name of the API operation.	CreateServiceLinkedRole
ApiType	string	The type of the API operation. Valid values: Open: an Alibaba Cloud API operation. Inner: an internal API operation.	Open
Parameters	object	The parameters of the API operation. The value of a parameter is a dynamic value. The following dynamic value is supported: ${RegionId}, which indicates the region ID.	{ "ServiceLinkedRole": "AliyunServiceRoleForRdsPgsqlOnEcs", "RegionId": "${RegionId}" }
DependentServiceNames	array	Les services dont dépend le service que vous souhaitez interroger.
	string	Le nom du service dont dépend le service que vous souhaitez interroger.	NAS
CommodityProvisions	array<object>	Les détails du produit. Certains services, tels que Container Compute Service (ACS), nécessitent l'activation de plusieurs produits.
	object
CommodityCode	string	The commodity code.	acs_postpaid_public_cn
Status	string	The activation status of the Alibaba Cloud service. Valid values: Enabled: The service is activated. Disabled: The service is not activated.	Disabled
EnableURL	string	The URL for activating the commodity.	https://common-buy-intl.alibabacloud.com/?commodityCode=acs_postpaid_public_cn

Exemples

JSON format

{
  "RequestId": "A9938C04-26AD-5EFA-B394-EA7866842DFF",
  "ServiceProvisions": [
    {
      "ServiceName": "EHPC",
      "Status": "Enabled",
      "StatusReason": "No permission.",
      "AutoEnableService": false,
      "EnableURL": "https://common-buy-intl.alibabacloud.com/?commodityCode=nas",
      "RoleProvision": {
        "AuthorizationURL": "https://ehpc.console.alibabacloud.com/",
        "Roles": [
          {
            "RoleName": "AliyunServiceRoleForEHPC",
            "Created": true,
            "Function": "Default",
            "ApiForCreation": {
              "ApiProductId": "rds",
              "ApiName": "CreateServiceLinkedRole",
              "ApiType": "Open",
              "Parameters": {
                "ServiceLinkedRole": "AliyunServiceRoleForRdsPgsqlOnEcs",
                "RegionId": "${RegionId}"
              }
            }
          }
        ]
      },
      "DependentServiceNames": [
        "NAS"
      ],
      "CommodityProvisions": [
        {
          "CommodityCode": "acs_postpaid_public_cn",
          "Status": "Disabled",
          "EnableURL": "https://common-buy-intl.alibabacloud.com/?commodityCode=acs_postpaid_public_cn"
        }
      ]
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.