DescribeInventoryFileUploadSignature - Data Management - Centro de documentación de Alibaba Cloud

Obtiene las credenciales de carga directa de OSS para archivos de inventario de activos.

Descripción de la operación

Genera una firma de carga directa PostObject V4 de OSS para la carga de documentos de inventario de activos. El cliente utiliza los valores devueltos uploadHost, uploadDir, policy, ossCredential, ossDate, ossSignature y ossSecurityToken para cargar archivos directamente. Después de una carga exitosa, pase la clave de OSS como el parámetro InputFiles de CreateInventoryJob.

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

dms:DescribeInventoryFileUploadSignature

none

*All Resource

*

Ninguna

Sintaxis de la solicitud

POST / HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
JobToken	string	No	El token de idempotencia para el directorio de carga. Puede pasar un ID de borrador de tarea de inventario o un UUID generado por el cliente. Si no se especifica, el servidor genera un directorio aleatorio.	inventory-draft-20260613

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El cuerpo de la respuesta.
RequestId	string	El ID de la solicitud.	0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931
ErrorCode	string	El código de error.	UnknownError
ErrorMessage	string	El mensaje de error.	UnknownError
Success	boolean	Indica si la solicitud se realizó correctamente.	true
Data	object	La información de firma de carga directa de OSS.
OssCredential	string	El conjunto de parámetros que especifica la clave derivada.	eyJleHBpcmFxxx
OssDate	string	La hora de la solicitud en formato ISO 8601.	20260617T093434Z
OssSignatureVersion	string	La versión de la firma y el algoritmo.	OSS4-HMAC-SHA256
OssSignature	string	La información de descripción utilizada para la autenticación de firma.	6475cdb70e1a5xxx
OssSecurityToken	string	El token de STS utilizado para cargar archivos en OSS. El token tiene una validez de 1 hora.	CAIS5QJ1q6Ft5xxx
Policy	string	El contenido de la política.	eyJleHBpcxxx
UploadHost	string	La dirección de destino para la carga de archivos.	https://dms-metaagentxxx
UploadDir	string	La ruta para la carga de archivos.	metaagent_inventory/xxx
MaxFileSizeBytes	integer	El tamaño máximo de archivo permitido para las cargas.	209715200

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": true,
  "Data": {
    "OssCredential": "eyJleHBpcmFxxx",
    "OssDate": "20260617T093434Z",
    "OssSignatureVersion": "OSS4-HMAC-SHA256",
    "OssSignature": "6475cdb70e1a5xxx",
    "OssSecurityToken": "CAIS5QJ1q6Ft5xxx",
    "Policy": "eyJleHBpcxxx",
    "UploadHost": "https://dms-metaagentxxx",
    "UploadDir": "metaagent_inventory/xxx",
    "MaxFileSizeBytes": 209715200
  }
}

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.