DescribeSendFileResults - : Central de Documentação do Alibaba Cloud

Observações de uso

O envio de um arquivo pode falhar em instâncias específicas do Elastic Compute Service (ECS). Chame esta operação para verificar os resultados do envio.
Esta operação permite consultar registros de envio de arquivos das últimas seis semanas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeSendFileResults	Operação a ser executada. Defina o valor como DescribeSendFileResults.
RegionId	String	Sim	cn-hangzhou	ID da região da instância ECS. Chame a operação DescribeRegions para obter a lista de regiões mais recente.
ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	ID do grupo de recursos. Se definido, a consulta retorna apenas os resultados de envio de arquivos do grupo especificado.
InvokeId	String	Não	f-hz0jdfwd9f****	ID da tarefa de envio de arquivo.
Name	String	Não	test.txt	Nome do arquivo cujos registros de envio serão consultados.
InstanceId	String	Não	i-hz0jdfwd9f****	ID da instância cujos registros de envio de arquivos serão consultados.
PageNumber	Long	Não	1	Número da página. A numeração começa na página 1. Valor padrão: 1.
PageSize	Long	Não	10	Número de entradas por página. Valores válidos: 1 a 50. Valor padrão: 10.
InvocationStatus	String	Não	Success	Status geral de envio do arquivo. Este status varia conforme o estado do envio em cada instância de destino. Valores válidos: Pending: O arquivo está em verificação ou sendo enviado. Se o status de envio em uma ou mais instâncias for Pending, o status geral será Pending. Running: O envio do arquivo está em andamento. Se o status em uma ou mais instâncias for Running, o status geral será Running. Success: O arquivo foi enviado com êxito. Se todas as instâncias apresentarem o status Success, o status geral será Success. Failed: Falha no envio do arquivo. Se todas as instâncias retornarem Failed, o status geral será Failed. PartialFailed: O envio foi bem-sucedido em algumas instâncias, mas falhou em outras. Se houver combinação de status Success e Failed entre as instâncias, o status geral será PartialFailed.
Tag.N.Key	String	Não	TestKey	Chave da tag N da tarefa de envio de arquivo. Valores válidos para N: 1 a 20. A chave da tag não pode ser uma string vazia. Se você especificar uma única tag para consultar recursos, a resposta poderá exibir até 1.000 recursos associados a essa tag. Ao especificar múltiplas tags, a resposta listará até 1.000 recursos que possuam todas as tags indicadas. Para consultar mais de 1.000 recursos com tags específicas, chame a operação ListTagResources. A chave da tag pode ter até 64 caracteres e não pode começar com `acs:` ou `aliyun`. Também não deve conter `http://` ou `https://`.
Tag.N.Value	String	Não	TestValue	Valor da tag N da tarefa de envio de arquivo. Valores válidos para N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 128 caracteres e não deve conter `http://` ou `https://`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Long	10	Número de entradas por página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
PageNumber	Long	1	Número da página.
TotalCount	Long	2	Total de tarefas de envio de arquivos retornadas.
Invocations	Array of Invocation		Registros de envio de arquivos.
Invocation
CreationTime	String	2019-12-20T06:15:54Z	Horário de criação da tarefa de envio de arquivo.
InvocationStatus	String	Success	Status geral de envio do arquivo. Este status varia conforme o estado do envio em cada instância de destino. Valores válidos: Pending: O arquivo estava em verificação ou sendo enviado. Se o status de envio em uma ou mais instâncias for Pending, o status geral será Pending. Running: O envio do arquivo estava em andamento. Se o status em uma ou mais instâncias for Running, o status geral será Running. Success: O arquivo foi enviado. Se todas as instâncias apresentarem o status Success, o status geral será Success. Failed: Falha no envio do arquivo. Se todas as instâncias retornarem Failed, o status geral será Failed. O status geral também será Failed se uma ou mais instâncias apresentarem qualquer um dos seguintes estados: Invalid: O arquivo é inválido. Aborted: Falha ao enviar o arquivo para as instâncias. Failed: Falha ao criar o arquivo nas instâncias. Timeout: A tarefa de envio de arquivo expirou. Error: Um erro interrompeu a tarefa de envio de arquivo. PartialFailed: O envio foi bem-sucedido em algumas instâncias, mas falhou em outras. Se houver combinação de status Success e Failed entre as instâncias, o status geral será PartialFailed.
ContentType	String	PlainText	Tipo de conteúdo do arquivo. Valores válidos: PlainText: O conteúdo do arquivo é texto simples. Base64: O conteúdo do arquivo está codificado em Base64.
TargetDir	String	/home/user	Diretório de destino.
FileOwner	String	test	Proprietário do arquivo.
Description	String	This is a test file.	Descrição do arquivo.
VmCount	Integer	1	Número de instâncias de destino.
FileMode	String	777	Permissões do arquivo.
FileGroup	String	test	Grupo de usuários do arquivo.
InvokeId	String	f-hz0jdfwd9f****	ID da tarefa de envio de arquivo.
Name	String	test.txt	Nome do arquivo.
Content	String	#!/bin/bash echo "Current User is :" echo $(ps \| grep "$$" \| awk '{print $2}')	Conteúdo do arquivo.
Overwrite	String	false	Indica se um arquivo existente no diretório de destino será sobrescrito caso tenha o mesmo nome do arquivo enviado.
InvokeInstances	Array of InvokeInstance		Instâncias de destino.
InvokeInstance
CreationTime	String	2019-12-20T06:15:54Z	Horário de criação da tarefa de envio de arquivo.
StartTime	String	2019-12-20T06:15:54Z	Momento em que a execução da tarefa de envio de arquivo começou na instância.
InvocationStatus	String	Success	Status da tarefa de envio de arquivo. Valores válidos: Pending: O arquivo estava em verificação ou sendo enviado. Invalid: O arquivo era inválido. Running: O envio do arquivo estava em andamento. Aborted: Falha ao enviar o arquivo. Success: O arquivo foi enviado. Failed: Falha ao criar o arquivo na instância. Error: Um erro interrompeu a tarefa de envio de arquivo. Timeout: A tarefa de envio de arquivo expirou.
FinishTime	String	2019-12-20T06:15:54Z	Horário de conclusão da tarefa de envio de arquivo.
UpdateTime	String	2019-12-20T06:15:54Z	Última atualização do status da tarefa de envio de arquivo.
ErrorInfo	String	the instance is not running when create task	Mensagem de erro retornada quando há falha no envio do arquivo ou na execução da tarefa. Valores válidos: Null: o arquivo foi enviado para a instância. the specified instance does not exists the specified instance has been released the instance is not running when create task the specified account does not exist the aliyun service is not running on the instance the aliyun service in the instance does not response the aliyun service in the instance is upgrading now the aliyun service in the instance need upgrade the command delivery has been timeout the file creation is failed due to unknown error the authority of file is invalid File content is empty the content of file is invalid File already exists File name is invalid File path is invalid Owner not exists Group not exists Mode is invalid
ErrorCode	String	InstanceNotExists	Código de erro retornado quando o envio do arquivo para a instância falha. Valores válidos: Null: O arquivo foi enviado para a instância. InstanceNotExists: A instância não existia ou foi liberada. InstanceReleased: A instância foi liberada durante o envio do arquivo. InstanceNotRunning: A instância não estava em execução no momento da criação da tarefa de envio. AccountNotExists: A conta especificada não existia. ClientNotRunning: O Cloud Assistant Agent não estava em execução. ClientNotResponse: O Cloud Assistant Agent não respondeu. ClientIsUpgrading: O Cloud Assistant Agent estava sendo atualizado. ClientNeedUpgrade: O Cloud Assistant Agent precisava ser atualizado. DeliveryTimeout: A tarefa de envio de arquivo expirou. FileCreateFail: Falha ao criar o arquivo. FileAlreadyExists: Já existia um arquivo com o mesmo nome no diretório especificado. FileContentInvalid: O conteúdo do arquivo era inválido. FileNameInvalid: O nome do arquivo era inválido. FilePathInvalid: O diretório especificado era inválido. FileAuthorityInvalid: As permissões especificadas para o arquivo eram inválidas. UserGroupNotExists: O grupo de usuários especificado não existia.
InstanceId	String	i-uf614fhehhz****	ID da instância.
Tags	Array of Tag		Tags da tarefa de envio de arquivo.
Tag
TagKey	String	owner	Chave da tag da tarefa de envio de arquivo.
TagValue	String	zhangsan	Valor da tag da tarefa de envio de arquivo.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeSendFileResults
&RegionId=cn-hangzhou
&InvokeId=f-hz0vk9****
&Name=test.txt
&InstanceId=i-bp1hsglsw****
&PageNumber=1
&PageSize=10
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSendFileResultsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <Invocations>
        <Invocation>
            <FileMode>0644</FileMode>
            <Overwrite>false</Overwrite>
            <InvocationStatus>Success</InvocationStatus>
            <Description>This is a test file.</Description>
            <ContentType>PlainText</ContentType>
            <VmCount>1</VmCount>
            <TargetDir>/home/user</TargetDir>
            <FileGroup>test</FileGroup>
            <FileOwner>test</FileOwner>
            <InvokeInstances>
                <InvokeInstance>
                    <InvocationStatus>Success</InvocationStatus>
                    <FinishTime>2020-09-11T08:30:55Z</FinishTime>
                    <InstanceId>i-bp1hsglsw****</InstanceId>
                    <ErrorInfo/>
                    <CreationTime>2020-09-11T08:30:55Z</CreationTime>
                    <StartTime>2020-09-11T08:30:55Z</StartTime>
                    <UpdateTime>2020-09-11T08:30:55Z</UpdateTime>
                    <ErrorCode/>
                </InvokeInstance>
            </InvokeInstances>
            <Name>test.txt</Name>
            <Content>ZWNobyBoZWxsbw==</Content>
            <CreationTime>2020-09-11T08:30:55Z</CreationTime>
            <InvokeId>f-hz0vk9****</InvokeId>
        </Invocation>
    </Invocations>
</DescribeSendFileResultsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 10,
  "PageNumber" : 1,
  "Invocations" : {
    "Invocation" : [ {
      "FileMode" : "0644",
      "Overwrite" : false,
      "InvocationStatus" : "Success",
      "Description" : "This is a test file.",
      "ContentType" : "PlainText",
      "VmCount" : 1,
      "TargetDir" : "/home/user",
      "FileGroup" : "test",
      "FileOwner" : "test",
      "InvokeInstances" : {
        "InvokeInstance" : [ {
          "InvocationStatus" : "Success",
          "FinishTime" : "2020-09-11T08:30:55Z",
          "InstanceId" : "i-bp1hsglsw****",
          "ErrorInfo" : "",
          "CreationTime" : "2020-09-11T08:30:55Z",
          "StartTime" : "2020-09-11T08:30:55Z",
          "UpdateTime" : "2020-09-11T08:30:55Z",
          "ErrorCode" : ""
        } ]
      },
      "Name" : "test.txt",
      "Content" : "ZWNobyBoZWxsbw==",
      "CreationTime" : "2020-09-11T08:30:55Z",
      "InvokeId" : "f-hz0vk9****"
    } ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	RegionId.ApiNotSupported	The api is not supported in this region.	Esta operação não pode ser executada na região especificada. Verifique se o ID da região é válido.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	O parâmetro Tag.N.Key é obrigatório.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves de tag devem ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value inválido.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Valor de PageNumber inválido.
400	InvalidParam.PageSize	The specified parameter is invalid.	Valor de PageSize inválido.
403	Operation.Forbidden	The operation is not permitted.	A operação não é suportada.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.