1 つ以上の ECS インスタンスにリモートファイルを送信します。
操作説明
操作の説明
ターゲット ECS インスタンスは実行中である必要があります。
ターゲット ECS インスタンスにはクラウドアシスタントエージェントがインストールされている必要があります。詳細については、「クラウドアシスタントエージェント」を参照してください。
- ファイル送信をサポートするには、クラウドアシスタントエージェントのバージョンが以下のバージョンより新しい必要があります。
ClientNeedUpgradeエラーコードが発行された場合は、エージェントを最新バージョンに更新してください。Linux: 1.0.2.569
Windows: 1.0.0.149
Base64 エンコーディング後のファイルコンテンツは 32 KB を超えることはできません。
ターゲット ECS インスタンスのインスタンスステータス異常、ネットワークの問題、またはクラウドアシスタントエージェントの例外により、ファイル送信が失敗する場合があります。問題のトラブルシューティングを行うには、 DescribeSendFileResults を呼び出すか、「実行失敗の一般的なエラーと解決策」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:SendFile |
update |
*Instance。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
ターゲット ECS インスタンスのリージョン ID。最新のリージョンリストをクエリするには、 DescribeRegions を呼び出せます。 |
cn-hangzhou。 |
| ResourceGroupId |
string |
任意 |
ファイル送信用のリソースグループの ID。このパラメーターを指定した場合:
|
rg-bp67acfmxazb4p**** |
| Name |
string |
必須 |
ファイルの名前。フル文字セットがサポートされています。名前の長さは 255 文字を超えることはできません。 |
file.txt。 |
| Description |
string |
任意 |
ファイルの説明。フル文字セットがサポートされています。説明の長さは 512 文字を超えることはできません。 |
This is a test file. |
| Timeout |
integer |
任意 |
ファイル送信のタイムアウト期間。単位: 秒。
デフォルト値: 60。 |
60 |
| TargetDir |
string |
必須 |
ファイルが送信されるターゲット ECS インスタンス上の送信先ディレクトリ。ディレクトリが存在しない場合は自動的に作成されます。ディレクトリパスの長さは 255 文字を超えることはできません。 |
/home。 |
| ContentType |
string |
任意 |
ファイルのコンテンツタイプ。有効な値:
デフォルト値: PlainText。 |
PlainText。 |
| Content |
string |
必須 |
ファイルのコンテンツ。Base64 エンコーディング後のファイルコンテンツは 32 KB を超えることはできません。
|
#!/bin/bash echo "Current User is :" echo $(ps | grep "$$" | awk '{print $2}') -------- oss://bucketName/objectName。 |
| FileOwner |
string |
任意 |
ファイルのオーナー。このパラメーターは Linux インスタンスでのみ有効です。デフォルト値: ルート。値の長さは 64 文字を超えることはできません。 説明
別のユーザーを指定する場合は、そのユーザーがインスタンス上に存在することを確認してください。 |
test。 |
| FileGroup |
string |
任意 |
ファイルのグループ。このパラメーターは Linux インスタンスでのみ有効です。デフォルト値: ルート。値の長さは 64 文字を超えることはできません。 説明
別のユーザーグループを指定する場合は、そのユーザーグループがインスタンス上に存在することを確認してください。 |
test。 |
| FileMode |
string |
任意 |
ファイルの権限。このパラメーターは Linux インスタンスでのみ有効です。chmod コマンドを実行する場合と同じ方法でこのパラメーターを設定できます。 デフォルト値: 0644。これは、オーナーに読み取りおよび書き込み権限があり、グループおよびその他のユーザーに読み取り専用権限があることを示します。 |
0644 |
| Overwrite |
boolean |
任意 |
送信先ディレクトリ内の同名のファイルを上書きするかどうかを指定します。有効な値:
デフォルト値: false。 |
true。 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken は ASCII 文字のみをサポートし、長さは 64 文字を超えることはできません。詳細については、「冪等性を確保する方法」を参照してください。 |
123e4567-e89b-12d3-a456-426655440000 |
| InstanceId |
array |
必須 |
ファイルを送信する ECS インスタンスの ID。最大 50 個のインスタンス ID を指定できます。N の有効な値: 1〜50。 |
i-bp185dy2o3o6n**** |
|
string |
任意 |
ファイルを送信する ECS インスタンスの ID。最大 50 個のインスタンス ID を指定できます。N の有効な値: 1〜50。 |
i-bp185dy2o3o6n**** |
|
| Tag |
array<object> |
任意 |
タグ。 |
|
|
object |
任意 |
タグ。 |
||
| Key |
string |
任意 |
ファイル送信用のタグのキー。N の有効な値: 1〜20。タグキーを空文字列にすることはできません。 単一のタグを使用してリソースをフィルターする場合、このタグが付与されたリソース数は 1,000 を超えることはできません。複数のタグを使用してリソースをフィルターする場合、指定されたすべてのタグが付与されたリソース数は 1,000 を超えることはできません。リソース数が 1,000 を超える場合は、 ListTagResources を呼び出してリソースをクエリしてください。 タグキーの長さは最大 64 文字で、 |
TestKey。 |
| Value |
string |
任意 |
ファイル送信用のタグの値。N の有効な値: 1〜20。タグ値は空文字列にすることができます。 タグ値の長さは最大 128 文字で、 |
TestValue。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| InvokeId |
string |
実行 ID。 |
f-7d2a745b412b46**** |
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"InvokeId": "f-7d2a745b412b46****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | RegionId.ApiNotSupported | The api is not supported in this region. | この API は現在のリージョンではサポートされていません。 |
| 400 | MissingParam.InstanceId | The parameter instanceId is missing or empty. | インスタンス ID が空です。 |
| 400 | NumberExceed.Tags | The Tags parameter number is exceed. | 指定されたタグの数が制限を超えています。 |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | タグキーを指定してください。 |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | タグに重複キーが存在します。キーを一意にしてください。 |
| 400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | 指定されたタグキーが無効です。タグキーは空または null にできず、最大 128 文字まで指定可能で、"aliyun" または "acs:" で始まることはできず、"http://" または "https://" を含むことはできません。 |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | 指定されたタグ値が無効です。タグ値は最大 128 文字まで指定可能で、"http://" または "https://" を含むことはできません。 |
| 400 | FileTargetDir.Invalid | The target directory of file is invalid. | |
| 400 | FileMode.Invalid | The mode of file is invalid. | |
| 400 | FileContent.DecodeError | The Content can not be base64 decoded. | |
| 400 | FileContentType.Invalid | The ContentType of file is invalid. | |
| 400 | InvalidParameter.FileOwner | The specified parameter FileOwner is not valid. | 指定された FileOwner パラメーターが無効です。 |
| 400 | InvalidParameter.FileGroup | The specified parameter FileGroup is not valid. | 指定された FileGroup パラメーターが無効です。 |
| 400 | InvalidClientToken.Malformed | The specified parameter clientToken is not valid. | 指定された ClientToken パラメーターが形式要件を満たしていません。パラメーターには ASCII 文字のみを含める必要があり、長さは 64 文字を超えることはできません。 |
| 500 | InternalError.Dispatch | An error occurred when you dispatched the request. | リクエストの送信中にエラーが発生しました。後でもう一度お試しください。 |
| 403 | FileSize.ExceedLimit | The length of file content exceeds limit. | ファイルコンテンツの長さが上限を超えています。 |
| 403 | FileName.ExceedLimit | The length of file name exceeds limit. | ファイル名の長さが上限を超えています。 |
| 403 | FileDesc.ExceedLimit | The length of file description exceeds limit. | ファイルの説明の長さが上限を超えています。 |
| 403 | InstanceIds.ExceedLimit | The number of instance IDs exceeds the upper limit. | ターゲットインスタンスの数が上限を超えています。 |
| 403 | Operation.Forbidden | The operation is not permitted. | 現在の RAM ユーザーには、この操作を実行する権限がありません。 |
| 403 | InvalidTimeout.ExceedLimit | The specified parameter Timeout exceeds the upper limit. | |
| 403 | IdempotentParameterMismatch | The specified parameter has changed while using an already used clientToken. | 指定されたクライアントトークンはすでに使用されています。 |
| 403 | IdempotentProcessing | The previous idempotent request(s) is still processing. | 以前の冪等リクエストはまだ処理中です。後でもう一度お試しください。 |
| 404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | リージョン情報が無効です。 |
| 404 | InvalidInstance.NotFound | The specified instances not found. | 指定されたインスタンスが存在しません。 |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | 対応するリソースグループが見つかりません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。