GetTask - CloudSSO - Centro de documentación de Alibaba Cloud

Llama a GetTask para consultar la información de una tarea asíncrona.

Descripción de la operación

Este tema proporciona un ejemplo de cómo consultar la información de una tarea cuyo ID es t-shfqw1u1edszvxw5****.

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

cloudsso:GetTask

get

*Directorio.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DirectoryId	string	Sí	El ID del directorio CloudSSO.	d-00fc2p61****
TaskId	string	Sí	El ID de la tarea.	t-shfqw1u1edszvxw5****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La respuesta.
Task	object	La información de la tarea.
Status	string	El estado de la tarea. Valores válidos: InProgress: la tarea está en curso. Success: la tarea se completó correctamente. Failed: la tarea falló.	Success
TaskId	string	El ID de la tarea.	t-shfqw1u1edszvxw5****
EndTime	string	La hora en que finalizó la tarea.	2021-11-05T02:58:08Z
PrincipalId	string	El ID de la identidad CloudSSO.	u-00q8wbq42wiltcrk****
TargetPath	string	El ID de la ruta del destino de la tarea en el directorio de recursos.	rd-3G**/r-Wm/114240524784**
StartTime	string	La hora en que se inició la tarea.	2021-11-05T02:58:07Z
PrincipalName	string	El nombre de la identidad CloudSSO.	Alice
TargetName	string	El nombre del destino de la tarea.	dev-test
TargetId	string	El ID del destino de la tarea.	114240524784****
AccessConfigurationName	string	El nombre de la configuración de acceso.	ECS-Admin
TargetPathName	string	El nombre de la ruta del destino de la tarea en el directorio de recursos.	rd-3G****/root/dev-test
TaskType	string	El tipo de tarea. Valores válidos: ProvisionAccessConfiguration: despliegue de configuración de acceso. DeprovisionAccessConfiguration: elimina un despliegue de configuración de acceso. CreateAccessAssignment: concede autorización sobre una cuenta en un directorio de recursos. DeleteAccessAssignment: elimina la autorización de una cuenta en un directorio de recursos.	DeleteAccessAssignment
FailureReason	string	El motivo por el que falló la tarea. Nota Este parámetro se muestra solo cuando Status es Failed.	No Permission.
TargetType	string	El tipo de destino de la tarea. Valores válidos: RD-Account, que indica que el tipo de destino de la tarea es una cuenta en un directorio de recursos.	RD-Account
AccessConfigurationId	string	El ID de la configuración de acceso.	ac-00jhtfl8thteu6uj****
PrincipalType	string	El tipo de identidad CloudSSO. Valores válidos: User: usuario. Group: grupo.	User
OriginTargetId	string		17xxxxxxxxxxxx73
RequestId	string	El ID de la solicitud.	923CA5E8-57BF-5E15-8BA6-E75A966B7E3F

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Task": {
    "Status": "Success",
    "TaskId": "t-shfqw1u1edszvxw5****",
    "EndTime": "2021-11-05T02:58:08Z",
    "PrincipalId": "u-00q8wbq42wiltcrk****",
    "TargetPath": "rd-3G****/r-Wm****/114240524784****",
    "StartTime": "2021-11-05T02:58:07Z",
    "PrincipalName": "Alice",
    "TargetName": "dev-test",
    "TargetId": "114240524784****",
    "AccessConfigurationName": "ECS-Admin",
    "TargetPathName": "rd-3G****/root/dev-test",
    "TaskType": "DeleteAccessAssignment",
    "FailureReason": "Sin permiso",
    "TargetType": "RD-Account",
    "AccessConfigurationId": "ac-00jhtfl8thteu6uj****",
    "PrincipalType": "User",
    "OriginTargetId": "17xxxxxxxxxxxx73"
  },
  "RequestId": "923CA5E8-57BF-5E15-8BA6-E75A966B7E3F"
}

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.