ApplyResourceAccessPermission - DataWorks - Centro de documentación de Alibaba Cloud

Envía una solicitud de permisos de acceso para recursos específicos.

Descripción de la operación

Reason: El motivo de la solicitud. Este parámetro es obligatorio.
ApplyContents: Contiene múltiples entradas de solicitud de permisos de recursos. Cada entrada incluye una descripción del recurso (Resource), una descripción del beneficiario (Grantee), tipos de acceso (AccessTypes) y una hora de vencimiento del permiso (ExpirationTime). Se pueden enviar un máximo de 400 entradas en una sola solicitud.
Resource: La descripción del recurso. Debe especificar ResourceSchema.name y la versión de la que depende el análisis del recurso, así como los metadatos del recurso (MetaData).
Grantee: La descripción del beneficiario. Debe especificar el tipo de entidad de seguridad (PrincipalType) y el ID de la entidad de seguridad (PrincipalId).
AccessTypes: La lista de tipos de acceso. Se admiten combinaciones de múltiples tipos de acceso.
ExpirationTime: La hora de vencimiento del permiso, proporcionada como una marca de tiempo en milisegundos.
AuthMethod: Opcional. Especifica el método de autorización. El sistema utiliza el método de autorización predeterminado integrado si no se especifica este parámetro.
ClientToken: El token de cliente utilizado para evitar solicitudes duplicadas. Este parámetro es opcional.

Asegúrese de que todos los campos obligatorios estén especificados correctamente y cumplan con las restricciones correspondientes. Por ejemplo, DefVersion y MetaData en Resource deben coincidir con el DefSchema seleccionado.

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

dataworks:ApplyResourceAccessPermission

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Reason	string	Sí	El motivo de la solicitud.	Necesidades de desarrollo de negocios
ApplyContents	array<object>	Sí	La lista de entradas de solicitud de permisos de recursos.
	array<object>	No
Resource	object	No	La descripción del recurso.
DefSchema	string	Sí	El tipo de recurso. Nota: Los tipos de recursos que se pueden solicitar están restringidos por ResourceSchema.name. Consulte también: Documentación de ResourceSchema (chino) Valores válidos: MaxCompute : MaxCompute. LINDORM : LINDORM. EMR_ON_ECS_HIVE : EMR_ON_ECS_HIVE. DLF_V1 : DLF_V1 HOLOGRES : HOLOGRES. SEVERLESS_STARROCKS : SEVERLESS_STARROCKS. DATAWORKS_ENTITY : DATAWORKS_ENTITY. DLF_NEXT : DLF_NEXT.	MaxCompute
DefVersion	string	No	La versión de análisis del recurso, restringida por ResourceSchema.version. Documentación de ResourceSchema (chino)	v1.0.0
MetaData	object	No	La declaración de metadatos del recurso. Nota: Los metadatos están restringidos por ResourceSchema.resources. Una declaración de recurso válida debe incluir la declaración de metadatos de ruta completa desde el nivel 0 hasta el nivel validLeaf. Consulte también: Documentación de ResourceSchema (chino)
	any	No	Declara recursos específicos en formato Map<String,Object>. La declaración debe cumplir con las restricciones de recursos para el tipo de recurso específico definido en ResourceSchema. Nota: Al solicitar permisos a nivel de columna para MaxCompute, también debe declarar el nivel de seguridad de la columna (columnSensibleLevel) para que la autorización basada en etiquetas surta efecto. Para solicitudes de permisos de MaxCompute con Schema habilitado, pase el parámetro threeTierModel y establézcalo en true.	{ "workspace": "449656", "project": "sync_destination", "table": "order_table", "threeTierModel": false }
Grantee	object	Sí	La descripción del beneficiario. Nota: Los tipos de entidad de seguridad admitidos están restringidos por ResourceSchema.authPrincipal. Consulte también: Documentación de ResourceSchema (chino)
PrincipalType	string	Sí	El tipo de entidad de seguridad. Valores válidos: RamRole RamUser DlfRole Valores válidos: DlfRole : DlfRole. RamUser : RamUser. RamRole : RamRole.	RamRole
PrincipalId	string	Sí	El ID de la entidad de seguridad. El ID tiene diferentes significados según el tipo de entidad de seguridad: RamUser: UserId de DataWorks RamRole: UserId de DataWorks con el prefijo "ROLE_" DlfRole: Nombre del rol de DlfNext	ROLE_32237475848545
AccessTypes	array	Sí	La lista de tipos de acceso solicitados. Nota: Los diferentes niveles de recursos admiten distintos tipos de acceso. Todos los tipos de acceso están restringidos por ResourceSchema.isValidLeaf, accessTypeRestrictions y authMethodAccessTypes. Consulte también: Documentación de ResourceSchema (chino)
	string	No	El tipo de acceso al recurso.	select
ExpirationTime	integer	No	La hora de vencimiento del permiso, en formato de marca de tiempo en milisegundos.	1785835708000
AuthMethod	string	No	El método de autorización. Actualmente, solo SEVERLESS_STARROCKS admite especificar un método de autorización: ranger o starrocksManager. Nota: Los diferentes recursos admiten distintos métodos de autorización. Todos los métodos de autorización están restringidos por ResourceSchema.authMethods. Consulte también: Documentación de ResourceSchema (chino) Valores válidos: starrocksManager : Starrocks Manager. ranger : Ranger.	ranger
ClientToken	string	No	El token de idempotencia. Se utiliza para evitar operaciones duplicadas causadas por múltiples llamadas.	ABFUOEUOTRTRJKE

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud. Se utiliza para la identificación de registros y la solución de problemas.	0bc5df3a17***903790e8e8a
Data	array	La lista de ID de órdenes de solicitud.
	string	El ID de la orden de solicitud o del proceso de aprobación.	332066440109224007

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc5df3a17***903790e8e8a",
  "Data": [
    "332066440109224007"
  ]
}

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.