CreateFileDetect - Security Center: Central de Documentação do Alibaba Cloud

Descrição da operação

Envia um arquivo para a nuvem para detecção.

Métodos de upload de arquivo

Dois métodos de upload de arquivo são suportados: pré-upload e URL de download.

Se você usar o método de pré-upload, confirme se o arquivo foi carregado antes de invocar esta operação. Para obter mais informações sobre como fazer upload de um arquivo, consulte a operação CreateFileDetectUploadUrl.

Se você usar o método de URL de download, passe uma URL de download que suporte acesso à rede pública usando o parâmetro DownloadUrl.

Identificador exclusivo de arquivo

Todas as operações de detecção de arquivo incluem o parâmetro HashKey, que especifica o identificador exclusivo do arquivo a ser detectado e é usado para consultar os resultados da detecção.

Calcule o HashKey antes de chamar esta operação. Apenas o hash MD5 ou SHA-256 do conteúdo completo do arquivo é suportado.

Para calcular o hash MD5 ou SHA-256 do conteúdo do arquivo, execute as seguintes etapas:

Use o algoritmo MD5 ou SHA-256 para calcular o hash dos dados e gerar um valor de hash de 128 bits ou 256 bits. As bibliotecas disponíveis incluem Java MessageDigest e Python hashlib.
Codifique o valor de hash gerado como uma string hexadecimal. As bibliotecas disponíveis incluem Java Codec e a função hex do Python. Certifique-se de que a string final seja uma combinação de dígitos e letras minúsculas. O hash MD5 tem 32 caracteres e o hash SHA-256 tem 64 caracteres.

As operações de envio e consulta para uma única detecção devem usar o mesmo HashKey. Caso contrário, a detecção não poderá ser enviada corretamente e os resultados não poderão ser consultados.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

yundun-sas:CreateFileDetect

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SourceIp	string	Não	O endereço IP da origem de acesso.	115.213.XX.XX
Type	integer	Sim	O tipo do arquivo a ser detectado. Valores válidos: 0: detecção de arquivo malicioso	0
HashKey	string	Não	O identificador exclusivo do arquivo. Este parâmetro é obrigatório e deve ser o hash MD5 ou SHA-256 do arquivo.	0a212417e65c26ff133cfff28f6c****
OssKey	string	Não	A chave de armazenamento do arquivo no bucket do OSS. Se você enviar o arquivo para detecção usando DownloadUrl, este parâmetro é opcional. Você pode obter este parâmetro chamando a operação CreateFileDetectUploadUrl. Nota: Se Type estiver definido como 0 e DownloadUrl não for fornecido, este parâmetro é obrigatório e deve ser obtido chamando a operação CreateFileDetectUploadUrl.	1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****
DownloadUrl	string	Não	A URL de download do arquivo. Você pode passar uma URL de download de arquivo (URL pública) para acionar diretamente a detecção de arquivo sem fazer upload do arquivo antecipadamente.	https://xxxxxxxx.oss-cn-hangzhou-1.aliyuncs.com/xxxxx/xxxxxxxxxxxxxx?Expires=1671448125&OSSAccessKeyId=xxx
Decompress	boolean	Não	Especifica se deve identificar e descompactar arquivos compactados. Valores válidos: true: Sim. false: Não.	false
DecompressMaxLayer	integer	Não	O número máximo de camadas de descompactação quando arquivos compactados estão aninhados dentro de um pacote compactado. Valor máximo: 5. Este parâmetro é obrigatório se Decompress estiver definido como true.	1
DecompressMaxFileCount	integer	Não	O número máximo de arquivos a serem descompactados. Valor máximo: 1000. Este parâmetro é obrigatório se Decompress estiver definido como true.	100

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação, que é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação. Você pode usar este ID para solucionar problemas.	7E0618A9-D5EF-4220-9471-C42B5E92719F
HashKey	string	O identificador do arquivo.	0a212417e65c26ff133cfff28f6c****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "7E0618A9-D5EF-4220-9471-C42B5E92719F",
  "HashKey": "0a212417e65c26ff133cfff28f6c****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	RequestTooFrequently	Request too frequently, please try again later
400	GetFileError	Get file error, please check input params and file size, and make sure upload file success.
400	InvalidDownloadUrl	Invalid file download URL.
400	FileSizeOverLimit	File size over limit.
500	ServerError	ServerError
500	SystemBusy	System busy, please try again later.
403	NoPermission	caller has no permission

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.