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

Consulta os parâmetros necessários para fazer upload de um arquivo para detecção.

Descrição da operação

Você pode chamar esta operação para consultar os parâmetros necessários para fazer upload de um arquivo para detecção. Se o valor do parâmetro de resposta FileExist for true, o arquivo que você deseja enviar para detecção já existe na nuvem. Nesse caso, você pode enviar diretamente o arquivo para detecção. Se o valor do parâmetro de resposta FileExist for false, você deve usar o método de upload de formulário para fazer upload do arquivo no bucket do Object Storage Service (OSS) especificado com base nos parâmetros de resposta desta operação.

O método de upload de formulário é fornecido pelo OSS. Para mais informações, consulte Upload de formulário.

O parâmetro HashKey está incluído em todas as operações de API relacionadas ao recurso de detecção de arquivos. O parâmetro especifica o identificador exclusivo de um arquivo. Apenas valores de hash MD5 são suportados. Antes de chamar esta operação, calcule o valor de hash MD5 do arquivo.

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:CreateFileDetectUploadUrl

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
HashKeyList	array	Não	Os identificadores dos arquivos. Apenas valores de hash MD5 são suportados. Nota Você deve especificar pelo menos um dos parâmetros HashKeyList e HashKeyContextList.	CreateFileDetectUploadUrl
	string	Não	O identificador do arquivo. Apenas valores de hash MD5 são suportados.	0a212417e65c26ff133cfff28f6c****
Type	integer	Sim	O tipo do arquivo. Valores válidos: 0: arquivo desconhecido 1: arquivo binário 2: arquivo webshell 4: arquivo de script Nota Se você não souber o tipo do arquivo, defina este parâmetro como 0.	0
HashKeyContextList	array<object>	Não	Os valores de hash dos arquivos. Nota Você deve especificar pelo menos um dos parâmetros HashKeyList e HashKeyContextList.
	object	Não
HashKey	string	Não	O valor de hash do arquivo.	30319dd5cee8f894766e479cac170da0
FileSize	integer	Não	O tamanho do arquivo. Unidade: bytes.	2698557

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação, que é usado para localizar e solucionar problemas.	09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F
UploadUrlList	array<object>	Uma matriz composta pelos parâmetros necessários para fazer upload de um arquivo.
	array<object>
PublicUrl	string	O endpoint público da URL para a qual o arquivo é enviado.	http://example.com
InternalUrl	string	O endpoint interno da URL para a qual o arquivo é enviado.	http://example.com
Expire	string	O timestamp em que os valores dos parâmetros expiram. Unidade: milissegundos.	1658562101370
Context	object	As informações de assinatura.
AccessId	string	The AccessKey ID that is used to access the OSS bucket.	yourAccessKeyID
Policy	string	The policy that poses limits on file upload. For example, the policy can limit the size of the file.	eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****
Signature	string	The signature that is used to upload the file.	wDhPgVdnY/bkKFYcYFl+4crl****
OssKey	string	The key of the file that is used after the file is uploaded to the OSS bucket.	1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****
FileExist	boolean	Indica se o arquivo existe na nuvem. Valores válidos: true: O arquivo existe na nuvem. Você não precisa fazer upload do arquivo. false: O arquivo não existe na nuvem. Você deve fazer upload do arquivo.	false
HashKey	string	O identificador do arquivo.	0a212417e65c26ff133cfff28f6c****
Code	string	O código de status retornado. O código de status 200 indica que a solicitação foi bem-sucedida. Outros códigos de status indicam que a solicitação falhou. Você pode identificar a causa da falha com base no código de status.	200
Message	string	A mensagem de erro retornada.	successful

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F",
  "UploadUrlList": [
    {
      "PublicUrl": "http://example.com",
      "InternalUrl": "http://example.com",
      "Expire": "1658562101370",
      "Context": {
        "AccessId": "yourAccessKeyID",
        "Policy": "eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****",
        "Signature": "wDhPgVdnY/bkKFYcYFl+4crl****",
        "OssKey": "1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****"
      },
      "FileExist": false,
      "HashKey": "0a212417e65c26ff133cfff28f6c****",
      "Code": "200",
      "Message": "successful"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	RequestTooFrequently	Request too frequently, please try again later
400	InvalidApiDetectType	Unsupported Api Detect Type.	The file type is not supported.
500	ServerError	ServerError
500	SystemBusy	System busy, please try again later.
403	NoPermission	caller has no permission	You are not authorized to do this operation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.