SendFile - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Les instances cibles doivent être dans l'état En cours d'exécution (Running).
L'agent Cloud Assistant doit être installé sur les instances.
Seules les versions de l'agent Cloud Assistant postérieures aux versions indiquées ci-dessous prennent en charge l'envoi de fichiers. Si le code d'erreur ClientNeedUpgrade est renvoyé, mettez à jour l'agent Cloud Assistant vers la dernière version.
- Pour les instances Linux, la version de l'agent Cloud Assistant doit être supérieure à 1.0.2.569.
- Pour les instances Windows, la version de l'agent Cloud Assistant doit être supérieure à 1.0.0.149.
La taille du fichier à envoyer ne doit pas dépasser 32 Ko après encodage en Base64.
L'envoi du fichier peut échouer en raison d'anomalies au niveau des instances, du réseau ou de l'agent Cloud Assistant. Appelez l'opération DescribeSendFileResults ou consultez la rubrique Vérifier les résultats d'exécution et résoudre les problèmes courants pour le dépannage.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SendFile	Opération à effectuer. Définissez la valeur sur SendFile.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance vers laquelle envoyer le fichier. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	ID du groupe de ressources. Lorsque vous spécifiez ce paramètre, tenez compte des éléments suivants : L'instance ECS spécifiée par le paramètre InstanceId doit appartenir à ce groupe de ressources. Si vous spécifiez ce paramètre, vous pouvez appeler l'opération DescribeSendFileResults pour interroger les résultats d'envoi de fichiers dans le groupe de ressources spécifié.
Name	String	Yes	file.txt	Nom du fichier. Le nom prend en charge tous les jeux de caractères et peut comporter jusqu'à 255 caractères.
Description	String	No	This is a test file.	Description du fichier. La description prend en charge tous les jeux de caractères et peut comporter jusqu'à 512 caractères.
Timeout	Long	No	60	Délai d'expiration de la tâche d'envoi de fichier. Unité : secondes. Une erreur de délai d'expiration se produit lorsqu'un fichier ne peut pas être envoyé en raison d'un ralentissement du processus ou de l'absence d'un module spécifique ou de l'agent Cloud Assistant. Si le délai d'expiration spécifié est inférieur à 10 secondes, le système définit le délai d'expiration à 10 secondes afin de garantir que le fichier puisse être envoyé aux instances. Valeur par défaut : 60.
TargetDir	String	Yes	/home	Répertoire de destination sur l'instance vers laquelle envoyer le fichier. Si le répertoire spécifié n'existe pas, le système le crée sur l'instance. La valeur prend en charge tous les jeux de caractères et ne peut pas dépasser 255 caractères.
ContentType	String	No	PlainText	Type de contenu du fichier. Valeurs valides : PlainText : le contenu du fichier n'est pas encodé. Base64 : le contenu du fichier est encodé en Base64. Valeur par défaut : PlainText.
Content	String	Yes	#!/bin/bash echo "Current User is :" echo $(ps \| grep "$$" \| awk '{print $2}') -------- oss://bucketName/objectName	Contenu du fichier distant. La taille du contenu ne doit pas dépasser 32 Ko après encodage en Base64. Si `ContentType` est défini sur `PlainText`, la valeur Content est en texte brut. Si `ContentType` est défini sur `Base64`, la valeur Content est encodée en Base64.
FileOwner	String	No	test	Propriétaire du fichier. Ce paramètre s'applique uniquement aux instances Linux. Valeur par défaut : root. La valeur peut comporter jusqu'à 64 caractères. Remarque Si vous souhaitez utiliser un utilisateur autre que root, assurez-vous que cet utilisateur existe sur les instances.
FileGroup	String	No	test	Groupe d'utilisateurs du fichier. Ce paramètre s'applique uniquement aux instances Linux. Valeur par défaut : root. Le nom du groupe d'utilisateurs peut comporter jusqu'à 64 caractères. Remarque Si vous souhaitez utiliser un groupe d'utilisateurs autre que root, assurez-vous que ce groupe existe sur les instances.
FileMode	String	No	0644	Autorisations associées au fichier. Ce paramètre s'applique uniquement aux instances Linux. Vous pouvez configurer ce paramètre de la même manière que vous configurez la commande chmod. Valeur par défaut : 0644, ce qui indique que le propriétaire du fichier dispose des autorisations de lecture et d'écriture, tandis que le groupe d'utilisateurs du fichier et les autres utilisateurs disposent des autorisations de lecture seule.
Overwrite	Boolean	No	true	Indique s'il faut écraser un fichier situé dans le répertoire de destination si ce fichier porte le même nom que le fichier envoyé. true : écrase le fichier. false : n'écrase pas le fichier. Valeur par défaut : false.
InstanceId.N	String	Yes	i-bp185dy2o3o6n****	ID de l'instance N vers laquelle envoyer le fichier. Vous pouvez spécifier jusqu'à 50 ID d'instance par requête. Valeurs valides de N : 1 à 50.
Tag.N.Key	String	No	TestKey	Clé du tag N à ajouter à la tâche d'envoi de fichier. Valeurs valides de N : 1 à 20. La clé de tag ne peut pas être une chaîne vide. Si un seul tag est spécifié pour interroger des ressources, jusqu'à 1 000 ressources portant ce tag peuvent être affichées dans la réponse. Si plusieurs tags sont spécifiés pour interroger des ressources, jusqu'à 1 000 ressources portant tous ces tags peuvent être affichées dans la réponse. Pour interroger plus de 1 000 ressources portant des tags spécifiés, appelez l'opération ListTagResources. La clé de tag peut comporter jusqu'à 64 caractères et ne peut pas commencer par `acs:` ou `aliyun`. Elle ne peut pas contenir `http://` ni `https://`.
Tag.N.Value	String	No	TestValue	Valeur du tag N à ajouter à la tâche d'envoi de fichier. Valeurs valides de N : 1 à 20. La valeur de tag peut être une chaîne vide. La valeur de tag peut comporter jusqu'à 128 caractères et ne peut pas contenir `http://` ni `https://`.

Paramètres de réponse

Parameter

Type

Example

Description

InvokeId

String

f-7d2a745b412b46****

ID de la tâche d'envoi de fichier.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=SendFile
&Content='echo hello'
&InstanceId.1=i-bp185dy2o3o6n****
&Name=file.txt
&RegionId=cn-hangzhou
&TargetDir=/home
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<SendFileResponse>
        <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
        <InvokeId>f-7d2a745b412b46****</InvokeId>
</SendFileResponse>

Format JSON

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

{
  "RequestId" : "E69EF3CC-94CD-42E7-8926-F133B86387C0",
  "InvokeId" : "f-7d2a745b412b46****"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	Cette opération ne peut pas être effectuée dans la région spécifiée. Vérifiez si l'ID de région est valide.
400	MissingParam.InstanceId	The parameter instanceId is missing or empty.	Le paramètre InstanceId.N est requis.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Le paramètre Tag.N.Key est requis.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clé de tag spécifiée existe déjà. Les clés de tag doivent être uniques.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valeur Tag.N.Key non valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valeur Tag.N.Value non valide.
403	FileSize.ExceedLimit	The length of file content exceeds limit.	La longueur maximale du contenu du fichier est dépassée.
403	FileName.ExceedLimit	The length of file name exceeds limit.	La longueur maximale du nom de fichier est dépassée.
403	FileDesc.ExceedLimit	The length of file description exceeds limit.	La longueur maximale de la description du fichier est dépassée.
403	FileTargetDir.Invalid	The target directory of file is invalid.	Valeur TargetDir non valide.
403	InstanceIds.ExceedLimit	The number of instance IDs exceeds the upper limit.	Le nombre maximal d'ID d'instance est dépassé.
403	FileMode.Invalid	The mode of file is invalid.	Valeur FileMode non valide.
403	FileContent.DecodeError	The Content can not be base64 decoded.	Le contenu du fichier ne peut pas être décodé en Base64.
403	FileContentType.Invalid	The ContentType of file is invalid.	Valeur ContentType non valide.
403	Operation.Forbidden	The operation is not permitted.	L'opération n'est pas prise en charge.
404	InvalidInstance.NotFound	The specified instances not found.	Les instances spécifiées sont introuvables.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	L'ID du groupe de ressources est introuvable.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Une erreur s'est produite lors de l'envoi de la requête. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.