GetServiceProvisions - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Consulta el estado de activación de un servicio de Alibaba Cloud y la información sobre sus roles vinculados al servicio.

Descripción de la operación

Notas de uso

Este tema proporciona un ejemplo de cómo consultar el estado de activación de Elastic High Performance Computing (EHPC) y la información sobre los roles vinculados al servicio para EHPC en la región China (Hangzhou).

Nota

Asegúrese de tener los permisos necesarios para llamar a la operación GetRole.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ros:GetServiceProvisions

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
TemplateBody	string	No	La estructura del cuerpo de la plantilla. El cuerpo de la plantilla debe tener una longitud de 1 a 524,288 bytes. Si la longitud del cuerpo de la plantilla supera el límite superior, se recomienda utilizar el método HTTP POST + Body Param para pasar el parámetro en el cuerpo de la solicitud y evitar fallos en la solicitud causados por una URL excesivamente larga. Nota Solo puede especificar uno de los siguientes parámetros: TemplateBody, TemplateURL, TemplateId o 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	No	La URL del archivo que contiene el cuerpo de la plantilla. La URL debe apuntar a una plantilla ubicada en un servidor web HTTP o HTTPS, o en un bucket de Object Storage Service (OSS). El cuerpo de la plantilla debe tener una longitud de 1 a 524,288 bytes. Ejemplos de URL de OSS: oss://ros/template/demo y oss://ros/template/demo?RegionId=cn-hangzhou. Si no especifica el ID de región del bucket de OSS, se utiliza el valor del parámetro RegionId. Solo puede especificar uno de los siguientes parámetros: TemplateBody, TemplateURL, TemplateId o Services.	oss://ros-template/demo
TemplateId	string	No	El ID de la plantilla. Este parámetro aplica a plantillas compartidas y privadas. Solo puede especificar uno de los siguientes parámetros: TemplateBody, TemplateURL, TemplateId o Services.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	No	La versión de la plantilla. Si no especifica este parámetro, se utiliza la versión más reciente. Este parámetro solo surte efecto cuando especifica TemplateId.	v1
Parameters	array<object>	No	Los parámetros.
	object	No
ParameterKey	string	Sí	El nombre del parámetro. Si no especifica el nombre y el valor de un parámetro, Resource Orchestration Service (ROS) utiliza el nombre y el valor predeterminados especificados en la plantilla. Nota Parameters es opcional. Si especifica Parameters, debe especificar ParameterKey.	Amount
ParameterValue	string	Sí	El valor del parámetro. Nota Parameters es opcional. Si especifica Parameters, debe especificar ParameterValue.	12
Services	array<object>	No	La lista de servicios de Alibaba Cloud.
	object	No
ServiceName	string	Sí	El nombre del servicio de Alibaba Cloud. Valores válidos: 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 (anteriormente 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

Para obtener información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	A9938C04-26AD-5EFA-B394-EA7866842DFF
ServiceProvisions	array<object>	Los detalles de los servicios de Alibaba Cloud.
	array<object>
ServiceName	string	El nombre del servicio de Alibaba Cloud.	EHPC
Status	string	El estado de activación del servicio de Alibaba Cloud. Valores válidos: Enabled: El servicio está activado. Disabled: El servicio no está activado. Unknown: El estado de activación es desconocido.	Enabled
StatusReason	string	El motivo por el cual el servicio de Alibaba Cloud no está activado o el estado de activación es desconocido. Nota Este parámetro se devuelve únicamente cuando el valor de Status es Disabled o Unknown.	No permission
AutoEnableService	boolean	Indica si el servicio se activa automáticamente cuando se utiliza la plantilla para crear una pila. Valores válidos: true: El servicio se activa automáticamente. false: El servicio no se activa automáticamente.	false
EnableURL	string	La URL que puede utilizar para activar el servicio de Alibaba Cloud. Nota Este parámetro se devuelve únicamente cuando el valor de Status es Disabled.	https://common-buy-intl.alibabacloud.com/?commodityCode=nas
RoleProvision	object	La información sobre los roles vinculados al servicio del servicio de Alibaba Cloud. Si este parámetro está vacío, no hay ningún rol vinculado al servicio asociado con el servicio.
AuthorizationURL	string	La URL que puede utilizar para otorgar permisos al rol vinculado al servicio. Nota Este parámetro se devuelve únicamente cuando el valor de Created es false.	https://ehpc.console.alibabacloud.com/
Roles	array<object>	Los roles vinculados al servicio.
	array<object>
RoleName	string	El nombre del rol vinculado al servicio.	AliyunServiceRoleForEHPC
Created	boolean	Indica si el rol vinculado al servicio ha sido creado. Valores válidos: true: El rol vinculado al servicio está creado. false: El rol vinculado al servicio no está creado.	true
Function	string	El propósito del rol. Valor predeterminado: Default. Este valor indica que el rol es el rol predeterminado del servicio.	Default
ApiForCreation	object	La información sobre la operación de API utilizada para crear el rol.
ApiProductId	string	El ID del servicio de Alibaba Cloud al que pertenece la operación de API.	rds
ApiName	string	El nombre de la operación de API.	CreateServiceLinkedRole
ApiType	string	El tipo de la operación de API. Valores válidos: Open: una operación de API de Alibaba Cloud. Inner: una operación de API interna.	Open
Parameters	object	Los parámetros de la operación de API. El valor de un parámetro es un valor dinámico. Se admite el siguiente valor dinámico: ${RegionId}, que indica el ID de la región.	{ "ServiceLinkedRole": "AliyunServiceRoleForRdsPgsqlOnEcs", "RegionId": "${RegionId}" }
DependentServiceNames	array	Los servicios de los cuales depende el servicio que desea consultar.
	string	El nombre del servicio del cual depende el servicio que desea consultar.	NAS
CommodityProvisions	array<object>	Los detalles del commodity. Algunos servicios, como Container Compute Service (ACS), requieren que active múltiples commodities.
	object
CommodityCode	string	El código del commodity.	acs_postpaid_public_cn
Status	string	El estado de activación del servicio de Alibaba Cloud. Valores válidos: Enabled: El servicio está activado. Disabled: El servicio no está activado.	Disabled
EnableURL	string	La URL para activar el commodity.	https://common-buy-intl.alibabacloud.com/?commodityCode=acs_postpaid_public_cn

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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"
        }
      ]
    }
  ]
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.